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

TopicDescriptionSolution or Workaround
PeripheralsGOS 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

TopicDescriptionSolution or Workaround
PeripheralsGOS 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

TopicDescriptionSolution or Workaround
PeripheralsGOS 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

ChangeDescription
dms.product_idRead the DMS Product ID

Variables Renamed

ChangeDescription
system.factory_reset.gpioSet factory reset GPIO. Renamed from system.factory_reset.aux_gpio
system.factory_reset.levelSet 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

TopicDescriptionSolution or Workaround
mDNSThe 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

ChangeDescription
setup_cmdExecutes a specified setup script
setup_webInvokes web setup mode
setup_deviceSetup device for development

Commands Removed

ChangeDescription
setupReplaced with setup_cmd, setup_web

Variables Added

ChangeDescription
ethernet.link_local.enabledEnable Ethernet link local IP

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

Known Issues

Last Updated : December 5, 2018

TopicDescriptionSolution or Workaround
mDNSNetwork 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.
PeripheralsGOS 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

ChangeDescription
dms_activateOptions added: update, generate request only in base64 or msgpack format
dfu_queryDefault response format is base64. Optionally print response in msgpack format
dfu_requestDefault response format is base64. Optionally print response in msgpack format
dfu_responseDefault response format is base64. Optionally print response in msgpack format

Variables Added

ChangeDescription
ethernet.link_local.enabledEnable Ethernet link local IP
ethernet.link_local.timeoutSet timeout for obtaining Ethernet link local IP address
system.bflash.portSet SPI port for bulk flash.
wlan.link_local.enabledEnable WLAN link local IP
wlan.link_local.timeoutSet timeout for obtaining WLAN link local IP address