Framework for communicating and interacting with 2G/3G/4G usb modems
Modems usually offer an interface via AT commands. A serial protocol originally developed by Dennis Hayes. There's a basic set of AT commands almost all modems support, and an extended set only some support. Every single manufacturer adds their extended set of commands to provide with vendor specific functionallity.
This python library is aimed to encapsulate all complicated vendor specific logic of USB modems and serving a common library to perform typical operations like:
So far, the list of supported modems are:
Plese have a look the Contributing section to extend support for other modems. Let's join efforts!
You need the packages python-pip and git in order to install this library:
sudo apt install python-pip gitVerify that the user is part of the groups dialout and plugdev. If it's not yet the case:
sudo usermod -aG dialout,plugdev $USERYou can install via pip from our Github repository directly (pending to submit to pypi)
pip install git+https://github.com/IOTConnectivity/python-gsmmodem-manager.gitAs per the lack of dependencies, It has been succesfully tested on the following platforms:
# Lets use a generic modem and test some basic AT commands
from gsmmodem_manager import GSMModem, signal_quality
# The USB modem is attached to /dev/ttyUSB0. Let's communicate with 9600 baud.
modem = GSMModem("/dev/ttyUSB0", "9600")
modem.get_imei() # (True, 'AT+GSN', '{IMEI CODE GOES HERE}')
modem.get_imsi() # (True, 'AT+CIMI', '{IMSI CODE GOES HERE}')
modem.set_operator('21401') # (True, 'AT+COPS=1,2,"21401"', None)
sq = modem.get_signal_quality() # (True, 'AT+CSQ', '11,99')
signal_quality(sq[2]) # 'Excellent'
# Let's use a specific Huawei MS2131 modem now
from gsmmodem_manager import HuaweiMS2131
modem = GSMModem("/dev/ttyUSB0", "9600")
# The following snipped selects Spain Vodafone 4G, registers and acquire data.
# Please note this does not generate a PPP interface, but establish the session.
modem.set_operator('21401') # Selects Spain Vodafone
modem.set_access_technology(HuaweiMS2131.ACT_UMTS) # Choses 4G. Each modem has its own codes.
modem.register() # Registers in the network
modem.activate_pdp_context() # Acquires PDP Context (data session)
modem.deactivate_pdp_context() # Closes PDP Context (data session)Please contribute using Github Flow. Create a branch, add commits, and open a pull request.
Please note this source code has been released under the GPLv3 terms and all contributions will be considered under the same license. Have a look at the LICENSE file distributed with this code.
The following is a non-comprehensive list of pending developments to add. We're happy to accept any contribution :)