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.1.11 GA Release December 2019
This documents the changes between Gecko OS version 4.0 and Gecko OS version 4.1.
This Gecko OS release adds many new features and fixes.
This Gecko OS release adds a DMS provisioning feature .
New power management features have been added , including system shutdown .
A coredump facility has been added. See system.debug.coredump_enabled .
You can now specify a TLS client chain different to the server chain. See:
WLAN and SoftAP can now work concurrently, on different channels. The setup web command now works with WLAN/SoftAP concurrent mode. network_verify now works with WLAN/SoftAP concurrent on different channels. The Web app now supports password verification on the fly . See SoftAP Features and Variables .
SoftAP Wi-Fi RF transmit power can be managed independently from WLAN TX power. See softap.tx_power .
A Network Bridge Command API feature allows data streaming between an Ethernet connection and the device Soft Access Point. Inbound Ethernet packets become outbound Wi-Fi packets on the soft AP interface, and vice versa.
The softAP MAC filter allows MAC addresses to be whitelisted or blacklisted for connection to the softAP.
A new wlan.backoff variable allows specifying attenuation per Wi-Fi channel and modulation group.
A new wlan.cca_mode variable allows specifying the Clear Channel Assessment mode.
Wi-Fi PTA support is now provided. See wlan.coex.mode .
There is now a Native C API function to query Ethernet link speed: gos_ethernet_get_link_information() .
Timing with 31 microsecond resolution is now available.
GPS is now supported on the Hurricane Demo Platform. A Hurricane GPS SDK example has been added.
New and improved SDK app examples include:
Known Issues
Last Updated : December, 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. |
| mDNS | The mDNS service works with Bonjour, but not with LLMNR. See mdns.service . | Install Bonjour. |
| Channel 14 | Channel 14 is not supported by WGM160P. See wlan.scan.channel_mask | No workaround |
Changelog
Last Updated : December, 2019
The following changes were made.
Fixes and Improvements
| Topic | Description |
|---|---|
| BSSID | Gecko OS can now connect to a visible or hidden network using BSSID . |
| Fixed: Memory corruption when using wlan.bssid for a nup . | |
| Concurrent WLAN/SoftAP | WLAN and SoftAP can now operate concurrently on different channels. See SoftAP Features and Variables . |
| The setup_web command now works with WLAN/SoftAP concurrent mode. | |
| network_verify now works with WLAN/SoftAP concurrent on different channels | |
| Concurrency and Web App | The web app now calls the network_verify command to verify the password for the selected SSID. |
| Example Apps | ArduCam SDK example apps, hurricane/arducam and hurricane/security_camera have been added. |
| gos_settings_get_str fault | Fixed: Hard fault with calls to gos_settings_get_str . |
| HTTPS server | The HTTPS server no longer Hard Faults when simultaneously connecting 2 clients |
| PWMs | Fixed an issue where pwm_update did not work for GPIOs > 10 |
| Fixed an issue where GPIOs 2,3 and 20 output frequency was double the value set. | |
| Fixed a problem where GPIOs 16 and 18 could not be used independently. | |
| SDK GSS |
The GSS project
.launch
file now regenerates.
|
| SDK OSX | SDK Apps now build on OSX. |
| Debugging now works for the SDK on OSX High Sierra. | |
| Make login on OSX now calls GSS. | |
| Shutdown | System shutdown is available as a power saving option. |
| SPI | Fixed: SPI stream write hangs on buffer size smaller than 16. |
| Fixed: Hard fault on SPI stream_close . | |
| Timer | Timing with 31 microsecond resolution is now available. See gos_wait_microseconds . |
| WPA | WPA/WPA2 security has been added to the SoftAP. |
| WLAN |
Fixed: If
wlan.scan.channel_mask
is set to
0x1FFF
,
wlan.ssid
is overwritten.
|
| HFXO GPIOs |
Fixed: WGM160P HFXO GPIOs (
12
,
13
) are now correctly listed by
gpio.usage
|
| Concurrent WLAN and SoftAP | Fixed an issue where the system could crash if WLAN started on a different channel to SoftAP. See SoftAP Features and Variables |
| Network verification | The webapp now supports network verification, transparently to the user. |
| External Debugger | GSS now supports download, debug, and other functions using an external adapter, such as an SWD (Serial Wire Debug) or JTAG (Joint Test Action Group) debugger. |
| MQTT Example App | Many of the instabilities reported against the MQTT example app released in Gecko OS 4.0 have been fixed or reduced. |
| MQTT Keepalive |
The keep-alive feature in the MQTT stack is now fixed as per MQTT standard. Client waits for
mqtt.keep_alive_interval
since last ping request sent (PINGREQ), then force closes the connection. If ping response (PINGRESP) is received within this period, the timer is reset and connection is kept open.
|
| MQTT Secure Element TLS support |
In the MQTT library, the struct
tcp_client_config_t
now has a new
use_secure_element
entry
|
| gos_tcp_config_t | Assigning gos_tls_certificates_t to gos_tcp_config_t now successfully sets CA cert, client key and cert parameters. |
| DNS | WLAN DNS query no longer fails if Ethernet enabled but unavailable. |
Commands Changed
| Change | Description |
|---|---|
| faults_reset |
Added
--coredumps
option
|
Commands Added
| Change | Description |
|---|---|
| dms_provision | Initiate the DMS provisioning procedure. See DMS Provisioning . |
| network_bridge | The network bridge feature allows streaming from ethernet to SoftAP. |
| shutdown | See shutdown power saving . |
| softap_mac_filter_add | Add a MAC address to the soft AP MAC filter. |
| softap_mac_filter_clear | Clear all addresses from the soft AP MAC filter. |
| softap_mac_filter_remove | Remove a MAC address from the soft AP MAC filter. |
Variables Added
| Change | Description |
|---|---|
| dms.provision.status | Read the current status of DMS provisioning. See DMS Provisioning . |
| dms.provision.token | Set the DMS provisioning token. See DMS Provisioning . |
| http.server.tls_peer_cert | Specify TLS client chain different to server chain. |
| network.bridge.auto_start | See network bridge . |
| network.bridge.info | See network bridge . |
| network.bridge.interface_1 | Set first network bridge interface. |
| network.bridge.interface_2 | Set second network bridge interface. |
| softap.mac_filter.enabled | Enable/disabled softAP MAC filter. |
| softap.mac_filter.info | List the addresses in the softAP MAC filter. |
| softap.mac_filter.mode | Choose whitelist or blacklist mode for the softAP MAC filter. |
| softap.tx_power | Manage Wi-Fi RF transmit power independently for SoftAP interface. |
| system.debug.coredump_enabled | Enable/disable coredump feature. |
| system.powersave.idle_timeout | Set timeout before system sleeps according to system.powersave.mode setting |
| system.powersave.wakeup_gpio_level_mask | Specify GPIO levels for shutdown wakeup. |
| system.powersave.wakeup_gpio_mask | Specify GPIOs to enable for shutdown wakeup. |
| system.shutdown.wakeup_gpio_level_mask | See System Shutdown . |
| system.shutdown.wakeup_gpio_mask | See System Shutdown . |
| system.shutdown.wakeup_timeout | See System Shutdown . |
| tcp.server.tls_peer_cert | Specify TLS client chain different to server chain. |
| uart.powersave.mode | See power management features . |
| wlan.backoff | Specify attenuation per Wi-Fi channel and modulation group. |
| wlan.cca_mode | Determine WLAN clear channel assessment (CCA) mode. |
| wlan.coex.mode | Enable Wi-Fi PTA support. |
| wlan.powersave.listen_interval | Specify beacon or DTIM skip according to wlan.powersave.mode setting. |
| wlan.powersave.mode | Configure WLAN powersave. |
Variables Changed
| Change | Description |
|---|---|
| system.powersave.mode | Altered powersave settings. |
| system.uuid | The UUID is settable under specific circumstances. |