Release Notes for Gecko OS Edition 4

To install the latest version of Gecko OS on your device, use the DFU Update Command or Gecko OS Studio (GSS) .



Gecko OS 4.0.18 (April, 2019)

This is a patch release of Gecko OS.

This release fixes several minor issues and provides performance improvements. There are no changes to commands or variables.

The SDK MQTT example, cloud/mqtt_demo , has been updated. See Gecko OS Studio for access to SDK examples.

Known Issues

Last Updated : April, 2019

Topic Description Solution or Workaround
Peripherals GOS currently permits configuration of more than one function associated with a peripheral, such as enabling the UART log bus together with bulk serial flash. When configured like this, the peripheral will not function correctly. Take care not to configure multiple functions for a single peripheral.

Gecko OS 4.0.17 (March, 2019)

This is a patch release of Gecko OS.

This release adds improvements to power saving features. There are no changes to commands or variables.

Known Issues

Last Updated : March, 2019

Topic Description Solution or Workaround
Peripherals GOS currently permits configuration of more than one function associated with a peripheral, such as enabling the UART log bus together with bulk serial flash. When configured like this, the peripheral will not function correctly. Take care not to configure multiple functions for a single peripheral.

Gecko OS 4.0.16 (GA Release - Feb 28, 2019)

This is the first public release of Gecko OS. Changes described below are updates from previous beta releases.

A further Gecko OS release in April 2019 updates the SDK MQTT example cloud/mqtt-demo . To obtain this update, use GSS and choose the most recent Gecko OS release in the Software drop down list, in the New Project page or Clone Example page. The release should have a version number later than Gecko_OS-4.0.16-1298 .

Known Issues

Last Updated : February 28, 2019

Topic Description Solution or Workaround
Peripherals GOS permits configuration of more than one function associated with a peripheral, such as a USART. However the peripheral does not function correctly when this is done. Take care not to configure multiple functions for a single peripheral.

Changelog

Last Updated : February 28, 2019

This is the official GA release for Gecko OS Edition 4, version 4.0. The following changes were made in addition to earlier beta releases.

Variables Added

Change Description
dms.product_id Read the DMS Product ID

Variables Renamed

Change Description
system.factory_reset.gpio Set factory reset GPIO. Renamed from system.factory_reset.aux_gpio
system.factory_reset.level Set level for factory reset GPIO. Renamed from system.factory_reset.aux_level

NOTE: Beta releases are included in the release notes to provide continuity for customers that were involved in the Gecko OS Beta program.

Gecko OS 4.0.7 (Beta 2 Release - Jan 21, 2019)

Known Issues

Last Updated : January 21, 2019

Topic Description Solution or Workaround
mDNS The mdns_discover command is not included in this release. The mdns.* variables are included.

Changelog

Last Updated : January 21, 2019

This release contains a number of fixes and improvements.

The setup command has been replaced by a group of setup commands:

Commands Added

Change Description
setup_cmd Executes a specified setup script
setup_web Invokes web setup mode
setup_device Setup device for development

Commands Removed

Change Description
setup Replaced with setup_cmd , setup_web

Variables Added

Change Description
ethernet.link_local.enabled Enable Ethernet link local IP

Gecko OS 4.0.7 (Beta 1 Release - Dec 5, 2018)

Known Issues

Last Updated : December 5, 2018

Topic Description Solution or Workaround
mDNS Network discovery and mdns are not supported in the alpha release. The mdns_discover is not included in this release. The mdns.* variables are included but have no effect. Use the IPv4 address in place of an mdns name.
Peripherals GOS permits configuration of more than one function associated with a peripheral, such as a USART. However the peripheral does not function correctly when this is done. Take care not to configure multiple functions for a single peripheral.

Changelog

Last Updated : December 5, 2018

This beta release contains a number of fixes and improvements.

Obtaining link local IP addresses is supported for WLAN and Ethernet. See ethernet.link_local.* and wlan.link_local.* variables below.

The bulk flash SPI port can be set. See system.bflash.port .

Options are available to print responses in base64 format or msgpack format for:

Commands Added

Change Description
dms_activate Options added: update, generate request only in base64 or msgpack format
dfu_query Default response format is base64. Optionally print response in msgpack format
dfu_request Default response format is base64. Optionally print response in msgpack format
dfu_response Default response format is base64. Optionally print response in msgpack format

Variables Added

Change Description
ethernet.link_local.enabled Enable Ethernet link local IP
ethernet.link_local.timeout Set timeout for obtaining Ethernet link local IP address
system.bflash.port Set SPI port for bulk flash.
wlan.link_local.enabled Enable WLAN link local IP
wlan.link_local.timeout Set timeout for obtaining WLAN link local IP address