Gecko OS is now in maintenance and is not recommended for new designs. Please see the Software Advisory for detailed information (registration required).

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

TopicDescription
ConsoleAdded support for command tab auto-completion
uart.flowEnabling uart flow will now fail if CTS and RTS pins are already in use as GPIO
wlan_scanAdded 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

TopicDescription
TCP server timeoutFixed 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_postCommands now do not hang if network is down
wlan.tx_powerThe command abbreviation for wlan.tx_power is now handled correctly
setup_webFixed an issue that caused a device reset in setup_web when softap.captive_portal_enabled was true
http_postCorrected the header name in http request for content type
stream_closeFixed an issue in the closing process by sending a [FIN] instead of [RST] flag in TLS stream
gpios_dirAdded a command for setting the direction of all general purpose I/O pins
WebappFixed the webapp to set wlan.auto_join.enabled = 1 before rebooting.

Commands Added

ChangeDescription
gpios_dirThe 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

TopicDescription
RTC is not properly updatedRTC is now updated properly when NTP is enabled. ntp.interval valid range is also documented
http_read_status freezes if remote closes streamhttp_read_status now returns gracefully if the remote server disconnects the stream
time.rtc can't be settime.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

TopicDescriptionSolution or Workaround
http_post data size 5000 byte limithttp_post data size is limited to 5000 bytes.Break the http_post activity into multiple requests with sizes smaller than 5000 bytes.
system.indicator.statesystem.indicator.state is read only. The variable cannot be set.There is no workaround.
softap.idle_timeoutThe variable softap.idle_timeout is listed in Gecko OS 2.2 but its function is not supported.There is no workaround.
Unexpected SoftAP startupA 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

TopicDescription
Security vulnerabilitiesFixes 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 supportJoining a Wi-Fi network using BSSID is now supported
HTTP clientHTTP client's field names are now case-insensitive
tcp_serverTCP server STREAM mode now handles reconnections properly
HTTP serverHTTP server now does not start unintentionally when http.server.enabled is 0
ICMP pingIf not connected, ping now brings the WLAN network up first before sending a ping request.
file_copyfile_copy command now executes successfully

Commands Added

None

Commands Changed

None

Commands Deprecated

None

Variables Added

None