mbed-os-examples
AWS IoT SDK port for Mbed OS
Mbed client for AWS IoT Core
Summary
This is an Mbed client for AWS IoT Core, based on implementation contributed by Nantis GmbH (Nantis-GmbH/mbed-aws-client). It depends on coreMQTT, coreJSON and AWS IoT Device Shadow library. It can be used to connect devices running Mbed OS to the Azure IoT Hub service, send and receive MQTT messages and work with the Device Shadow service.
Note: This client is not compatible with the old client prior to 5f422c9. Existing users of the old client can continue to fetch that hash, but we strongly recommend migration to the new client.
To use this library, an Mbed OS application needs to
- connect to a network interface with Internet access
- get the singleton instance of the client:
AWSClient::getInstance() - call
init(),connect()with required parameters including cloud credentials, message handler and network interface - call
processResponses()periodically, e.g. using a thread - either: interact with an MQTT topic directly using
subscribe(),publish() - or: use the Device Shadow API:
downloadShadowDocument(),getShadowDesiredValue(),publishShadowReportedValue()
Configurations of this library are listed in mbed_lib.json and can be overriden by an application’s mbed_app.json.
An example demonstrating the use of this library has been provided as part of the official Mbed OS examples here.
Related links
License and contributions
The software is provided under Apache-2.0 license. Contributions to this project are accepted under the same license.
The following projects from Amazon (under MIT license) are externally fetched by the build tool:
* coreMQTT
* coreJSON
* AWS IoT Device Shadow library