Release Notes for Gecko OS Edition 2
Gecko OS 2 evolved from ZentriOS WL 1.5. To update from ZentriOS WL to Gecko OS, see Updating to Gecko OS. This page also lists differences between ZentriOS WL and Gecko OS 2.
We recommend upgrading to the latest version of Gecko OS 2. See release notes for the latest version of Gecko OS 2.
Version String
Note that the version string changes format in Gecko OS 2. The ZentriOS WL 1.5 version string is similar to:
ZENTRI-AMW007-1.5.0.13, 2018-09-03T06:06:14Z, ZentriOS-WL-1.5.0.13, Board:AMW007-E03.2
The Gecko OS 2 version string is similar to:
SILABS-AMW007-2.1.5, Gecko OS-2.1.5, AMW007-W00001
The version number in Gecko OS 2 contains major version, minor version, and patch version, e.g. 2.1.5
. It does not contain a release candidate version number.
Gecko OS 2.3.3 Release
Last Updated: Oct, 2020
This release contains the same set of features and fixes documented in Gecko OS 2.3.2 and 2.3.0 below.
To update to this release from a previous release, use the following command:
dfu_update -b 2.3.3
The following changes document the differences between Gecko OS 2.3 and Gecko OS 2.2.
Fixes and Improvements
Topic | Description |
---|---|
Console | Added support for command tab auto-completion |
uart.flow | Enabling uart flow will now fail if CTS and RTS pins are already in use as GPIO |
wlan_scan | Added support for passive/active scan types |
Commands Added
None
Commands Changed
None
Commands Deprecated
None
Variables Added
None
Gecko OS 2.3.2 Release
Last Updated: Aug, 2020
This release contains the same set of features and fixes documented in Gecko OS 2.3.1 and 2.3.0 below.
To update to this release from a previous release, use the following command:
dfu_update -b 2.3.2
The following changes document the differences between Gecko OS 2.3 and Gecko OS 2.2.
Fixes and Improvements
Topic | Description |
---|---|
TCP server timeout | Fixed an issue where if stream.auto_close was disabled and the TCP connection died on the remote end, the connection stayed half open indefinitely |
http_get, http_post | Commands now do not hang if network is down |
wlan.tx_power | The command abbreviation for wlan.tx_power is now handled correctly |
setup_web | Fixed an issue that caused a device reset in setup_web when softap.captive_portal_enabled was true |
http_post | Corrected the header name in http request for content type |
stream_close | Fixed an issue in the closing process by sending a [FIN] instead of [RST] flag in TLS stream |
gpios_dir | Added a command for setting the direction of all general purpose I/O pins |
Webapp | Fixed the webapp to set wlan.auto_join.enabled = 1 before rebooting. |
Commands Added
Change | Description |
---|---|
gpios_dir | The gpios_dir command is a new command setting the direction of all general purpose I/O pins |
Commands Changed
None
Commands Deprecated
None
Variables Added
None
Gecko OS 2.3.1 Release
Last Updated: June, 2020
This release contains the same set of features and fixes documented in Gecko OS 2.3.0 below.
To update to this release from a previous release, use the following command:
dfu_update -b 2.3.1
Fixes and Improvements
Topic | Description |
---|---|
RTC is not properly updated | RTC is now updated properly when NTP is enabled. ntp.interval valid range is also documented |
http_read_status freezes if remote closes stream | http_read_status now returns gracefully if the remote server disconnects the stream |
time.rtc can't be set | time.rtc variable can now be set |
Commands Added
None
Commands Changed
None
Commands Deprecated
None
Variables Added
None
Gecko OS 2.3.0 Release
Last Updated: April, 2020
This release contains a security update to the underlying Wi-Fi firmware/SDK as well as support for a new serial flash used in the AMW007 and AMW037.
To update to this release from a previous release, use the following command:
dfu_update -b 2.3.0
Known Issues
Last Updated : April, 2020
Topic | Description | Solution or Workaround |
---|---|---|
http_post data size 5000 byte limit | http_post data size is limited to 5000 bytes. | Break the http_post activity into multiple requests with sizes smaller than 5000 bytes. |
system.indicator.state | system.indicator.state is read only. The variable cannot be set. | There is no workaround. |
softap.idle_timeout | The variable softap.idle_timeout is listed in Gecko OS 2.2 but its function is not supported. | There is no workaround. |
Unexpected SoftAP startup | A bare AMW0x7 module, as used in custom PCB designs, may leave GPIO5 floating. Since setup.gpio.control_gpio defaults to GPIO5, setup_web mode may be invoked on boot or reset if the floating GPIO5 is pulled/drifts high. In this case, the SoftAP interface will be brought up. | Disable setup.gpio.control_gpio by setting it to -1 . Alternatively modify the hardware design to actively drive GPIO5 (low during PoR/boot-up). |
Fixes and Improvements
Topic | Description |
---|---|
Security vulnerabilities | Fixes for security vulnerabilities described in the link below are included. https://www.espressif.com/en/Security_advisories_about_Zero_PMK_installation_and_beacon_crash |
BSSID join support | Joining a Wi-Fi network using BSSID is now supported |
HTTP client | HTTP client's field names are now case-insensitive |
tcp_server | TCP server STREAM mode now handles reconnections properly |
HTTP server | HTTP server now does not start unintentionally when http.server.enabled is 0 |
ICMP ping | If not connected, ping now brings the WLAN network up first before sending a ping request. |
file_copy | file_copy command now executes successfully |
Commands Added
None
Commands Changed
None
Commands Deprecated
None
Variables Added
None