Skip to content

Add SIMCOM 7000 to supported modems #113

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 21 commits into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Hologram/HologramCloud.py
Original file line number Diff line number Diff line change
Expand Up @@ -107,7 +107,7 @@ def sendMessage(self, message, topics=None, timeout=DEFAULT_SEND_MESSAGE_TIMEOUT
modem_id=modem_id,
version=self.version)

result = super().sendMessage(output, timeout)
result = super().sendMessage(output, timeout).strip('\r\n')
return self.__parse_result(result)

def __parse_result(self, result):
Expand Down
3 changes: 2 additions & 1 deletion Hologram/Network/Cellular.py
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
from Hologram.Event import Event
from Exceptions.HologramError import NetworkError
from Hologram.Network.Route import Route
from Hologram.Network.Modem import Modem, E303, MS2131, E372, BG96, Nova_U201, NovaM, DriverLoader
from Hologram.Network.Modem import Modem, E303, MS2131, E372, BG96, SIM7000, Nova_U201, NovaM, DriverLoader
from Hologram.Network import Network, NetworkScope
import time
from serial.tools import list_ports
Expand All @@ -32,6 +32,7 @@ class Cellular(Network):
'ms2131': MS2131.MS2131,
'e372': E372.E372,
'bg96': BG96.BG96,
'sim7000': SIM7000.SIM7000,
'nova': Nova_U201.Nova_U201,
'novam': NovaM.NovaM,
'': Modem
Expand Down
11 changes: 8 additions & 3 deletions Hologram/Network/Modem/BG96.py
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
#
import binascii
import time
import random

from serial.serialutil import Timeout

Expand Down Expand Up @@ -69,7 +70,7 @@ def create_socket(self):
self._set_up_pdp_context()

def connect_socket(self, host, port):
self.command('+QIOPEN', '1,0,\"TCP\",\"%s\",%d,0,1' % (host, port))
self.command('+QIOPEN', '1,%d,\"TCP\",\"%s\",%d,0,1' % (random.randint(0,11), host, port))
# According to the BG96 Docs
# Have to wait for URC response “+QIOPEN: <connectID>,<err>”

Expand Down Expand Up @@ -114,7 +115,7 @@ def read_socket(self, socket_identifier=None, payload_length=None):
return resp

def is_registered(self):
return self.check_registered('+CREG') or self.check_registered('+CGREG')
return self.check_registered('+CREG') or self.check_registered('+CEREG')

# EFFECTS: Handles URC related AT command responses.
def handleURC(self, urc):
Expand All @@ -125,6 +126,10 @@ def handleURC(self, urc):
if err == 0:
self.urc_state = Modem.SOCKET_WRITE_STATE
self.socket_identifier = socket_identifier
elif err == 563:
self.close_socket(socket_identifier)
self.logger.error('Failed to open socket, socket was already open')
raise NetworkError('Failed to open socket, socket was already open')
else:
self.logger.error('Failed to open socket')
raise NetworkError('Failed to open socket')
Expand Down Expand Up @@ -171,7 +176,7 @@ def init_serial_commands(self):

def set_network_registration_status(self):
self.command("+CREG", "2")
self.command("+CGREG", "2")
self.command("+CEREG", "2")

def _set_up_pdp_context(self):
if self._is_pdp_context_active(): return True
Expand Down
202 changes: 202 additions & 0 deletions Hologram/Network/Modem/SIM7000.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,202 @@
# SIM7000.py - Hologram Python SDK SIMCom SIM7000 modem interface
#
# Author: Hologram <[email protected]>
#
# Copyright 2016 - Hologram (Konekt, Inc.)
#
#
# LICENSE: Distributed under the terms of the MIT License
#
import binascii
import time
from enum import Enum

from serial.serialutil import Timeout

from Hologram.Network.Modem import Modem
from Hologram.Event import Event
from UtilClasses import ModemResult
from Exceptions.HologramError import SerialError, NetworkError

DEFAULT_SIM7000_TIMEOUT = 200

class NetworkState(Enum):
INITIAL = 'IP INITIAL'
START = 'IP START'
CONFIG = 'IP CONFIG'
GPRSACT = 'IP GPRSACT'
STATUS = 'IP STATUS'
TCPCONN = 'TCP CONNECTING'
UDPCONN = 'UDP CONNECTING'
LISTENING = 'SERVER LISTENING'
CONNECTED = 'CONNECT OK'
TCPCLOSING = 'TCP CLOSING'
UDPCLOSING = 'UDP CLOSING'
TCPCLOSED = 'TCP CLOSED'
UDPCLOSED = 'UDP CLOSED'
DISCONNECTED = 'PDP DEACT'


class SIM7000(Modem):
usb_ids = [('1e0e', '9001')]

def __init__(self, device_name=None, baud_rate='9600',
chatscript_file=None, event=Event()):

super().__init__(device_name=device_name, baud_rate=baud_rate,
chatscript_file=chatscript_file, event=event)
self._at_sockets_available = True
self.urc_response = ''
self.network_state = NetworkState.DISCONNECTED

def connect(self, timeout=DEFAULT_SIM7000_TIMEOUT):

success = super().connect(timeout)

# put serial mode on other port
if success is True:
# detect another open serial port to use for PPP
devices = self.detect_usable_serial_port()
if not devices:
raise SerialError('Not enough serial ports detected for Nova')
self.logger.debug('Moving connection to port %s', devices[0])
self.device_name = devices[0]
super().initialize_serial_interface()

return success

def send_message(self, data, timeout=Modem.DEFAULT_SEND_TIMEOUT):
# Waiting for the open socket urc
while self.urc_state != Modem.SOCKET_WRITE_STATE:
self.checkURC()

self.write_socket(data)

loop_timeout = Timeout(timeout)
while self.urc_state != Modem.SOCKET_SEND_READ:
self.checkURC()
if self.urc_state != Modem.SOCKET_SEND_READ:
if loop_timeout.expired():
raise SerialError('Timeout occurred waiting for message status')
time.sleep(self._RETRY_DELAY)
elif self.urc_state == Modem.SOCKET_CLOSED:
return '[1,0]' #this is connection closed for hologram cloud response

return self.urc_response

def create_socket(self):
self._set_up_pdp_context()

def connect_socket(self, host, port):
self.command('+CIPSTART', '\"TCP\",\"%s\",%d' % (host, port))

def close_socket(self, socket_identifier=None):
ok, _ = self.command('+CIPCLOSE')
if ok != ModemResult.OK:
self.logger.error('Failed to close socket')
self.urc_state = Modem.SOCKET_CLOSED

def write_socket(self, data):
hexdata = binascii.hexlify(data)
# We have to do it in chunks of 510 since 512 is actually too long (CMEE error)
# and we need 2n chars for hexified data
for chunk in self._chunks(hexdata, 510):
value = '%d,\"%s\"' % (self.socket_identifier, chunk.decode())
ok, _ = self.command('+CIPSEND', len(value), timeout=10, expected="SEND OK", prompt=">", data=value)
if ok != ModemResult.OK:
self.logger.error('Failed to write to socket')
raise NetworkError('Failed to write to socket')

def read_socket(self, socket_identifier=None, payload_length=None):
if payload_length is None:
payload_length = self.last_read_payload_length

ok, resp = self.set('+CIPRXGET', '1,%d' % (payload_length))
if ok == ModemResult.OK:
if resp is not None:
resp = resp.strip('"')
try:
resp = resp.decode()
except:
# This is some sort of binary data that can't be decoded so just
# return the bytes. We might want to make this happen via parameter
# in the future so it is more deterministic
self.logger.debug('Could not decode recieved data')

return resp

def is_registered(self):
return self.check_registered('+CREG') or self.check_registered('+CEREG') or self.check_registered('+CGREG')

def checkURC(self, hide=False):
# Not all SIMCOM urcs have a + in front
while(True):
response = self._readline_from_serial_port(0, hide=hide)
if len(response) > 0 and (response.startswith('+') or response.startswith('STATE') or response in ['CONNECT', 'CONNECT OK', 'CONNECT FAIL', 'SEND OK', 'ALREADY CONNECT', 'CLOSED']):
urc = response.rstrip('\r\n')
self.handleURC(urc)
else:
return

def handleURC(self, urc):
if urc.startswith('STATE'):
urc = urc.lstrip('STATE: ')
self.network_state = NetworkState(urc)
return
elif urc == 'CONNECT OK':
self.urc_state = Modem.SOCKET_WRITE_STATE
elif urc == 'CLOSED':
self.urc_state = Modem.SOCKET_CLOSED
else:
super().handleURC(urc)

def _is_pdp_context_active(self):
if not self.is_registered():
return False

self.command('+CIPSTATUS')
# wait for the buffer to fill up
self.checkURC()
self.checkURC()
self.checkURC()
return self.network_state is NetworkState.GPRSACT

def init_serial_commands(self):
self.command("E0") #echo off
self.command("+CMEE", "2") #set verbose error codes
self.command("+CPIN?")
self.set_timezone_configs()
#self.command("+CPIN", "") #set SIM PIN
self.command("+CPMS", "\"ME\",\"ME\",\"ME\"")
self.command("+CNMP", "38")
self.command("+CMNB", "1")
self.set_sms_configs()
self.set_network_registration_status()
time.sleep(0.5)

def set_network_registration_status(self):
self.command("+CREG", "2")
self.command("+CGREG", "2")
self.command("+CEREG", "2")

def _set_up_pdp_context(self):
if self._is_pdp_context_active(): return True
self.command('+CIPSTATUS')
self.checkURC()
while self.network_state is not NetworkState.INITIAL:
self.command('+CIPSHUT')
self.command('+CIPSTATUS')
self.checkURC()

self.set('+CSTT', '\"hologram\"')
self.command('+CIICR', timeout=30)
time.sleep(1)
if not self._is_pdp_context_active():
self.logger.error('PDP Context setup failed')
raise NetworkError('Failed PDP context setup')
else:
self.logger.info('PDP context active')

@property
def description(self):
return 'SIMCom SIM7000'
2 changes: 1 addition & 1 deletion Hologram/Network/Modem/__init__.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
__all__ = ['Modem', 'MockModem', 'MS2131', 'Nova', 'E303', 'E372']
__all__ = ['Modem', 'MockModem', 'MS2131', 'Nova', 'E303', 'BG96', 'E372', 'SIM7000']

from .IModem import IModem
from .Modem import Modem