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.3The 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.2The 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.1Fixes 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.0Known 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