- AWS IoT Getting Started
- AWS IoT X.509 Certificates
- Azure IoT Hub Getting Started
- Azure IoT Security
- MQTT
- Paho Python
In generic are 4 Paho MQTT examples that can be easily modified to work with a generic MQTT broker. paho_pub.py and paho_sub.py are straight forward examples of publishing and subscribing with Paho MQTT. paho_key publishes input taken from the keyboard, and paho_ser.py publishes input taken from the serial port.
In aws are skeletons for talking MQTT to AWS IoT. They are straightforward examples and should be easily adapted for your needs. To talk to AWS IoT over MQTT you first need to get your device configured in the AWS IoT Core and set up certs. See links above for how to do this.
In azure are skeletons for talking to Azure IoT Hub. They are straightforward examples and should be easily adapted for your needs. These skeletons are set up to talk to Azure IoT Hub using x509 certificates and will need to be modified if you wish to use SAS tokens. To talk to Azure IoT over MQTT you first need to get your device configured in the Azure IoT Hub and set up certs. See links above for how to do this.
After editing the files to work with your MQTT broker put, your target Python file, any needed cert or key files, and paho.zip onto the device. (paho.zip is simply a paho/ zipped) Remember to respect the device's 8.3 file format and flat file system. Add paho.zip to the device's Python path and run your target file with python file.py.
The target file can also be run locally with Python2.
It is useful being able to test the library via a local deployment so you may
have the necessity to install this library in the local setup. For this, a
slightly different
setup.py file from original repository is being employed.
To get the original file you could perfom the following command:
curl https://raw.githubusercontent.com/eclipse/paho.mqtt.python/master/setup.py -o setup.pyDon't forget that, to install the library you should use:
python setup.py install
To test the library without ssl, there is an example under /generic/no-ssl
which uses a local deployment or a public broker at eclipse.
You could use the following commands to launch a docker container with basic Thingsboard features:
mkdir -p ~/.mytb-data && sudo chown -R 799:799 ~/.mytb-data
mkdir -p ~/.mytb-logs && sudo chown -R 799:799 ~/.mytb-logs
docker run -d -p 9090:9090 -p 1883:1883 -p 5683:5683/udp -v ~/.mytb-data:/data \
-v ~/.mytb-logs:/var/log/thingsboard --name mytb --restart always thingsboard/tb-postgresThen you could use the test files located in the thingsboard folder.
The Paho library in this directory has been modified. The standard Paho library does not run on the Python implementation that ships with these devices. The standard Paho library as well as its documentation can be found here.
This Python implementation does not include support for non blocking sockets which are relied on by Paho for threading. So Paho's thread support has been removed.
This Python implementation has an older version of Python's SSL library that does not include SSLContext. ssl.wrap_socket() is called directly instead. However, the cipher argument for ssl.wrap_socket() is not included.
This Python implementation's SSL library does not have ssl.match_hostname, so Paho's client.tls_set_insecure method has been removed.
This modified Paho library has not been extensively tested.
This software is open-source. Copyright (c), Digi International Inc., 2018.
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, you can obtain one at http://mozilla.org/MPL/2.0/.
The Paho library code is subject to the terms of the Eclipse Public License 1.0 and the Eclipse Distribution License 1.0. These can be found under the paho/ directory. If they are not found there, they can be obtained at http://www.eclipse.org/org/documents/epl-1.0/EPL-1.0.txt and https://www.eclipse.org/org/documents/edl-v10.html respectively.
Digi, Digi International, the Digi logo, the Digi website, and Digi Device Cloud are trademarks or registered trademarks of Digi International, Inc. in the United States and other countries worldwide. All other trademarks are the property of their respective owners.
THE SOFTWARE AND RELATED TECHNICAL INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL DIGI OR ITS SUBSIDIARIES BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE AND TECHNICAL INFORMATION HEREIN, INCLUDING ALL SOURCE AND OBJECT CODES, IRRESPECTIVE OF HOW IT IS USED. YOU AGREE THAT YOU ARE NOT PROHIBITED FROM RECEIVING THIS SOFTWARE AND TECHNICAL INFORMATION UNDER UNITED STATES AND OTHER APPLICABLE COUNTRY EXPORT CONTROL LAWS AND REGULATIONS AND THAT YOU WILL COMPLY WITH ALL APPLICABLE UNITED STATES AND OTHER COUNTRY EXPORT LAWS AND REGULATIONS WITH REGARD TO USE AND EXPORT OR RE-EXPORT OF THE SOFTWARE AND TECHNICAL INFORMATION.