AWS IoT ExpressLink programmer's guide v1.0

This document defines the Application Programming Interface (API) that all AWS IoT ExpressLink compliant connectivity modules are required to implement to connect any host processor to the AWS cloud.

If you have questions or issues that are not answered here, please visit the AWS re:Post for AWS IoT ExpressLink page.

Topics

• 1 Hardware
• 2 Run states
• 3 ExpressLink commands
• 4 Messaging
• 5 Configuration Dictionary
• 6 Status dictionary
• 7 Event handling
• 8 ExpressLink module updates
• 9 Additional services
• 10 Provisioning

 

AWS IoT ExpressLink commands

• AT ⁞  Communication test

• CONF KEY={value} ⁞  Assignment

• CONF {certificate}=pem ⁞  Special certificate input formatting option

• CONF? key ⁞  Read the value of a configuration parameter

• CONF? {certificate} pem ⁞  Special certificate output formatting option

• CONFMODE [parameter] ⁞  Activate modal credential entry

• CONNECT ⁞  Explicitly request a module to connect to AWS IoT Core

• CONNECT? ⁞  Request the connection status

• DIAG {command} [optional parameters] ⁞  Perform a diagnostic command

• DISCONNECT ⁞  Leave the connected state and enter the active state

• EVENT? ⁞  Request the next event in the queue

• FACTORY RESET ⁞  Request a factory reset of the ExpressLink module

• GET ⁞  Request next message pending on any topic

• GET{#} ⁞  Request next message pending on the indicated topic

• GET0 ⁞  Request next message pending on an unassigned topic

• OTA ACCEPT ⁞  Allow the OTA operation to proceed

• OTA APPLY ⁞  Authorize the ExpressLink module to apply the new image.

• OTA CLOSE ⁞  The host OTA operation is completed

• OTA FLUSH ⁞  The contents of the OTA buffer are emptied

• OTA READ #bytes ⁞  Requests the next # bytes from the OTA buffer

• OTA SEEK {address} ⁞  Moves the read pointer to an absolute address

• OTA? ⁞  Fetches the current state of the OTA process

• OTW ⁞  Enter firmware update mode

• RESET ⁞  Request a full reset of the ExpressLink internal state

• SEND {topic} message ⁞  Publish msg on the specified topic

• SEND{#} message ⁞  Publish msg on a topic selected from topic list

• SLEEP{#} [duration] ⁞  Request to enter a low power mode

• SUBSCRIBE{#} ⁞  Subscribe to Topic#

• TIME? ⁞  Request current time information

• UNSUBSCRIBE{#} ⁞  Unsubscribe from Topic#

• WHERE? ⁞  Request location information

Tables

• Table 1 - Error codes

• Table 2 - Configuration dictionary persistent keys

• Table 3 - Configuration dictionary non-persistent keys

• Table 4 - ExpressLink event codes

• Table 5 - Reserved OTA file type codes (0-255)