| CARVIEW |
Navigation Menu
-
Notifications
You must be signed in to change notification settings - Fork 18
Releases: espressif/esp-aws-expresslink-eval
ExpressLink Firmware v2.6.0
Compare
The v2.6.0 release conforms to the AWS IoT ExpressLink Technical Specification v1.2.
The TechSpec has been set to v1.3b denoting that this release includes preview features from the upcoming v1.3 specification (see details of the features below).
Important
Devices upgrading Over-the-Air (OTA) must first upgrade to v2.5.1 before upgrading to v2.6.0
Devices upgrading Over-the-Wire (OTW) may upgrade directly, from any previous version.
This release includes the base64 encoded signature along with the release binary and can be used at the time of the firmware OTA update.
[ Firmware OTA Console setup screen screenshot ]
New features in this release:
1. GPIO Control
Espressif AWS IoT ExpressLink can now act as a simple I/O expander for the host processor.
In the following commands, the {#} can be 4, 5, 6 or 7.
These GPIOs are available on the ESP32-C3-MINI-1-N4-A module.
Commands:-
AT+GPIO{#} SET
Description: Set the GPIO# pin to a logic high value.
Returns: Returns the new output register value. -
AT+GPIO{#} CLR
Description: Set the GPIO# pin to a logic low value.
Returns: Returns the new output register value. -
AT+GPIO{#} TOGGLE
Description: Invert the output logic value of the GPIO# pin.
Returns: Returns the new output register value. -
AT+GPIO{#} OUTPUT
Description: Enable the GPIO# pin digital output mode, publish the current output register value to the pin.
Returns: Returns the current output register value.
Example 1:
> AT+GPIO4 SET // Set the output register of pin 4 to high < OK 1 > AT+GPIO4 OUTPUT // Set pin 4 to output mode (i.e., to turn on an LED) < OK 1 > AT+SLEEP 1 // Wait for 1 second < OK > AT+GPIO4 TOGGLE // Toggle the pin (turn the LED off) < OK 0
-
AT+GPIO{#} INPUT
Description: Set the pin mode to digital input mode, release the pin output control.
Returns: Returns the current digital input value. -
AT+GPIO{#} READ
Description: Read the input value of the GPIO. This will return the current logic value present on the actual pin.
Returns: Return the current GPIO value.
Example 2:
> AT+GPIO5 INPUT // Make pin 5 an input (i.e., sensing a push button) < OK 1 // Returns current input value (push button not pressed) ... > AT+GPIO5 READ // Read the current value of pin 5 < OK 0 // Input is low (the push button is being pressed)
Note: GPIO Control over UART is best suited for low-frequency tasks, e.g. indicator LEDs.
2. MQTT Configuration Options
2a. MQTT LWT (Last Will and Testament) configuration
The MQTT LWT feature can now be configured, to be used at the time of establishing the MQTT connection.
Commands:
-
AT+CONFÂ LWTConfig
Description: The value is expected to be a JSON string describing the Will Topic, Will QoS and Will Retain flag.
Expected keys: "topic", "qos", and "retain"
Example:AT+CONFÂ LWTConfig={"topic": "abcde", "qos":0, "retain":0} -
AT+CONF LWTMessage
Description: This is the message to publish as Last Will and Testament, in case of unexpected connection loss. This can be any valid MQTT message.
Example:AT+CONF LWTMessage=this is a sample mqtt message
Notes: 1. The maximum supported size for the LWTMessage is 5K. 2.LWTConfigandLWTMessageare empty by default. 3.LWTConfigandLWTMessageare persistent keys and will not be changed to their default value even afterAT+FACTORY_RESET.
2b. MQTT KeepAlive configuration
The MQTT KeepAlive can now be configured, in seconds, to be used at the time of establishing the MQTT connection.
Commands:
AT+CONFÂ KeepAlive
Example: AT+CONF KeepAlive=45
Notes: 1. The default value is 60 seconds. 2.KeepAliveis a persistent key and will not be changed to default value even afterAT+FACTORY_RESET.
3. Get the OTA Job Document
EnhancedAT+OTA? [DOC] command If the device is in one of the OTA pending states, and the optional parameter "DOC" is provided, the entire Jobs OTA document is provided describing the incoming payload, to allow the host processor to determine if/when to accept or reject the operation.
Example:
> AT+OTA? // check the OTA status
< OK 3 HOTA PENDING // a Host OTA file download was proposed
> AT+OTA? DOC
< OK 1 OTA PENDING {"timestamp":1296000000,"execution":{ ... }}
4. Increased limits
- The BLE GATT characteristic max value length is now
256. - Maximum number of supported named shadow documents (
MaxShadow) is now set to8.
5. Miscellaneous
Newly added case-insensitive 'limit' keyword inAT+DIAG WIFI SCAN command.
Example:
AT+DIAG WIFI SCAN Rss MacAddress limit=2This will ensure that the response will contain the information for 2 APs at most.
Note
- This release overwrites the existing OTAcertificate to an Espressif-provided OTA certificate.
- If you had previously set your OTA certificate by typing
AT+CONF OTAcertificate=PEMand were unable to set a new OTAcertificate, upgrading to v2.6.0 using OTW will set the appropriate Espressif OTAcertificate for you.
Assets 4
ExpressLink Firmware v2.5.1
Compare
The v2.5.1 release conforms to the AWS IoT ExpressLink Technical Specification v1.2
Important
v2.5.1 is an intermediate update for all devices on versions ≤ v2.5.0
It introduces no functional changes but is required in the firmware OTA upgrade path to reach future releases.
This release includes the base64 encoded signature along with the release binary and can be used at the time of the firmware OTA update.
[ Firmware OTA Console setup screen screenshot ]
Note
- This release overwrites the existing OTAcertificate to an Espressif-provided OTA certificate.
- If you had previously set your OTA certificate by typing
AT+CONF OTAcertificate=PEMand were unable to set a new OTAcertificate, upgrading to v2.5.1 using OTW will set the appropriate Espressif OTAcertificate for you.
Assets 4
ExpressLink Firmware v2.5.0
Compare
The v2.5.0 release conforms to the AWS IoT ExpressLink Technical Specification v1.2.
Important
This release overwrites the existing OTAcertificate to an Espressif-provided OTA certificate.
This release includes the base64 encoded signature along with the release binary and can be used at the time of the firmware OTA update.
[ Firmware OTA Console setup screen screenshot ]
New features in this release:
-
Support for BLE commands
This release adds a new command set to allow host software applications to communicate wirelessly using Bluetooth Low Energy (BLE) technology. -
Support for deeper sleep modes.
This release adds support for light sleep (SLEEP1) and deep sleep (SLEEP2) on ExpressLink. -
AT+DIAG WIFI SCANnow also reports the Security mode of the Wi-Fi AP
Note
If you had previously set your OTA certificate by typing AT+CONF OTAcertificate=PEM and were unable to set a new OTAcertificate, upgrading to v2.5.0 using OTW will set the appropriate Espressif OTAcertificate for you.
Assets 4
ExpressLink Firmware v2.4.5
Compare
The v2.4.5 release conforms to the AWS IoT ExpressLink Technical Specification v1.1.2
Important
v1.1.2 of the specification requires the OTA Certificate to be vendor-provided and makes it WRITE-ONLY.
This release overwrites the existing OTAcertificate to an Espressif-provided OTA certificate.
From the next release onwards, the base64 encoded signature will be included along with the release binary and can be used at the time of the firmware OTA update.
New features in this release:
AT+DIAG WIFI SCAN
This command offers the ability to scan and retrieve information about Wi-Fi access points (APs) while allowing you to tailor the output to your specific needs and control the duration of the scan, using the TIMEOUT keyword.
Example usage:
> AT+DIAG WIFI SCAN
< OK {"WiFiAccessPoints":[{"SSID":"New_SSID_1","MacAddress":"11:22:33:44:55:66","Rss":-70},{"SSID":"New_SSID_2","MacAddress":"22:33:44:55:66:77","Rss":-65},{"SSID":"New_SSID_3","MacAddress":"55:66:77:88:99:00","Rss":-67}]}
> AT+DIAG WIFI SCAN TIMEOUT=1
< OK {"WiFiAccessPoints":[{"SSID":"New_SSID_1","MacAddress":"11:22:33:44:55:66","Rss":-70},{"SSID":"New_SSID_2","MacAddress":"22:33:44:55:66:77","Rss":-65}]}
> AT+DIAG WIFI SCAN SSID Rss TIMEOUT=1
< OK {"WiFiAccessPoints":[{"SSID":"New_SSID_1","Rss":-70},{"SSID":"New_SSID_2","Rss":-72},{"SSID":"New_SSID_3","Rss":-67}]}
> AT+DIAG WIFI SCAN MacAddress Rss
< OK {"WiFiAccessPoints":[{"MacAddress":"11:22:33:44:55:66","Rss":-37},{"MacAddress":"22:33:44:55:66:77","Rss":-38},{"MacAddress":"33:44:55:66:77:88","Rss":-42}]}
[!NOTE]
- The response of the
AT+DIAG WIFI SCAN MacAddress Rsscan directly be used as a payload for AWS IoT Core Device Location MQTT service.- If the ExpressLink device has NTP sync time available, the timestamp will be added to the output.
Example:
> AT+CONNECT
< OK 1 CONNECTED
> AT+DIAG WIFI SCAN MacAddress Rss
< OK {"Timestamp":"1694521990","WiFiAccessPoints":[{"MacAddress":"11:22:33:44:55:66","Rss":-37},{"MacAddress":"88:99:00:11:22:33","Rss":-48},{"MacAddress":"99:00:11:22:33:44","Rss":-40}]}
Fixes in this release:
The 'PEM' in the CONF command for setting certificates is now case-insensitive.
Note
If you had previously set your OTA certificate by typing AT+CONF OTAcertificate=PEM and were unable to set a new OTAcertificate, upgrading to v2.4.5 using OTW will set the appropriate Espressif OTAcertificate for you.
Assets 3
ExpressLink Firmware v2.4.1
Compare
New features in this release:
The v2.4.1 release conforms to the AWS IoT ExpressLink Technical Specification v1.1
- Non-blocking CONNECT! command.
- Support for AWS IoT Device Shadow.
- Support for AWS IoT Device Defender.
- Support for new onboarding by-claim mechanism.
Fixes in this release:
AT+TIME?was off-by-one month, this has been fixed and time-tenths calculation has been improved.- Fixes to logging.
- CONFMODE now allows re-provisioning if you enter incorrect Wi-Fi credentials and parsing of CONFMODE parameters has been improved.
- Support for unaligned (not aligned to 16B) HOTA.
- Fix while writing root certificate using
AT+CONF RootCA=. - The
CONLOSTevent is generated reliably and a complete disconnect (including disconnecting from the Wi-Fi) is carried out when connectivity is lost. The host needs to give theAT+CONNECTcommand again. - Wi-Fi passphrases are now masked in the UART0 logs.
AT+SLEEPtimeout is now reliably obeyed.
Assets 3
ExpressLink Firmware v1.0.20
Compare
This is the generally available (GA) launch firmware for Espressif AWS IoT ExpressLink.
Assets 3
ExpressLink Firmware v0.9.3
Compare
This is the (pre-release) firmware v0.9.3 for Espressif AWS IoT ExpressLink.