EnOS MQTT SDK for Python
Project description
Using EnOS Device SDK for Python
Table of Contents
The EnOS Device SDK for Python allows developers to write Python scripts to use their devices to access EnOS IoT hub through MQTT.
Installation
Prerequisites
To use the EnOS Device SDK, you will need Python 3.5.3 or later, and pip
is required. Note that Python 2.x is not recommended as some functions might not be compatible with Python 2.x in future SDK versions.
If you are upgrading from an earlier version of EnOS Device SDK for Python, you need to change the path of the SDK package by adding enos
prefix in your "Import" statement in the existing Python codes to use the latest version.
You can install the SDK from pip, or build from source.
Installing from pip
The latest version of EnOS Device SDK for Python is available in the Python Package Index (PyPi) and can be installed using
pip install enos-mqtt-sdk-python
Update setuptools
if necessary:
pip install --upgrade setuptools
Building From Source
-
Obtain the source code of EnOS Device SDK for Python.
- From GitHub:
git clone https://github.com/EnvisionIot/enos-mqtt-sdk-python.git
- From EnOS SDK Center. Click SDK Center from the left navigation of EnOS Console, and obtain the SDK source code by clicking the GitHub icon in the Obtain column.
-
From the directory where the source code is stored, run the following command:
python setup.py install
Feature List
For the list of features supported by this SDK and the availability of EnOS device connectivity and management features in all SDKs we provide, see EnOS Device SDK.
Quick Start
- Create an MQTT client and connect it to EnOS Cloud using the secret-per-device authentication:
client = MqttClient(enos_mqtt_url, product_key, device_key, device_secret)
client.connect()
- Build a request to post a measurement point and publish the request using the connected client.
measure_point_post_request = MeasurepointPostRequest.builder()
.add_measurepoint('measurepoint_id', measurepoint_value)
.set_timestamp(timestamp)
.build()
# publish request and wait for the response
measure_point_response = client.publish(measure_point_post_request)
- Close the connection
client.close()
Sample Codes
- Establishing Connection with EnOS Cloud
- Device Tag Operations
- Device Attribute Operations
- Reporting Measurement Points
- Reporting Events
- Receiving Commands from Cloud
- Passing Through Device Information or Receiving Passed-through Information from Cloud
- Managing Sub-devices
- Over-the-air Firmware Upgrade
Related Information
- To learn more about EnOS IoT Hub, see EnOS IoT Hub Documentation.
- To learn more about how to develop your device for EnOS IoT Hub, see EnOS Device Development Guide (Python).
Release Notes
- 2019/11/15(0.1.0): Reconstruction and new functions added.
- 2021/07/23(0.1.1): Support specified encryption algorithms suite.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for enos-mqtt-sdk-python-0.1.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 671a0331456b95a4b786ae9dd2b37405f8e6cc245cd9c71d4d982ec62cfd7c38 |
|
MD5 | cb8df127bd0a111be767934c4df88748 |
|
BLAKE2b-256 | e1ad54c3d9c0ac3897fe66a8ab2a46592f9485d10747e0b646284ec34d38003e |
Hashes for enos_mqtt_sdk_python-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 44243a228a21b266abd3f94c2d7df7e2aced44bb141450c90147d375cbbee8dc |
|
MD5 | 509c09f6f4764c108ef73f6e51759c94 |
|
BLAKE2b-256 | 1387b1b66dc058aa4f9a2eed8b5b314bce369a7724d8e178bce45ec54f481995 |