Release Notes for ZentriOS-WZ-3.4

A new update sub-command for the dms command simplifies performing combinations of dms and ota operations.

The DMS can now issue commands via secure websocket to a device. This is enabled by the dms.cmd.enabled variable. With this feature, Zentri customers can have centralized, complete control over their fleets of devices in the field, via a DMS control panel.

A new --long_url option for the http_post allows specifying an arbitrarily long URL.

A new network.dns.timeout variable allows specifying the maximum duration for DNS resolution.

A new websocket protocol is available with the /cmdstream route: ws://<host>/cmdstream. See Networking and Security, Websocket Command Stream.

The load command now takes the -v option before the filename, consistent with other commands.

A new softap.captive_portal_enabled variable enables redirect to the root HTTP server webpage.

ZentriOS TLS 1.2 support now incorporates the 'Signature Algorithms Extension'.

Updating from WiConnect

See Updating your WiConnect device to update a device running WiConnect version 2.4 or earlier.

For a version history, see ZentriOS Editions and Versions.


Known Issues (v3.4.0)

Last Updated : August, 2017

All known issues in v3.3 and earlier versions have been fixed.

DescriptionSolution or Workaround
The Captive Portal feature does not redirect correctly when connecting to the Soft AP from a Windows 10 system.Type in the required URL after joining the Soft AP network. For example, when using the setup web feature, type the URL setup.com

Changelog (v3.4.0)

Last Updated : August, 2017

Fixes and Improvements

TopicDescription
HTTP serverFixed a hardfault when http.server.api_enabled = 0
HTTP streamWith an HTTP stream, the command http_read_status returns the most recent response code, regardless of whether the status has already been read.
ThroughputFixed an issue of throughput degradation after updating from ZentriOS-3.2 to ZentriOS-3.3
FlashAdded wear levelling to ensure that extended and bulk flash sectors are evenly used, prolonging flash life.
TLSZentriOS now skips TLS client certificate exchange if the server does not require client certificates
Fixed an issue with calculating remaining RX data with stream_poll on TLS streams,
Fixed a memory link for TLS client using client certificates
Web setupThe web setup setup.web.idle_timeout is now disabled only when the root index of the webapp is requested
UARTFixed a problem where characters were lost when the device was rebooting
Watchdog FaultsFixed a problem where watchdog faults were not printed on startup
HTTPS uploadFixed a problem where http_upload failed with HTTPS
stream_writeThe stream_write command now always consumes the specified <size> of data, even if the command fails. This prevents buffer overflows.

Commands Changed

ChangeDescription
dms updatedms sub-command argument update simplifies performing combinations of dms and ota operations.
http_downloadThe command now accepts file type in hex format as well as decimal format.
http_host--long_url option allows specifying an arbitrarily long URL.
loadNow takes the -v option before the filename, consistent with other commands.

Variables Added

ChangeDescription
dms.cmd.enabled Enable issuing commands from DMS to device via secure websocket
network.dns.timeout Specify maximum duration for DNS resolution
softap.captive_portal_enabled Enable redirect to root HTTP server webpage

Known Issues (v3.4.1)

All known issues in v3.4.0 and earlier versions have been fixed except the following:

DescriptionSolution or Workaround
The Captive Portal feature does not redirect correctly when connecting to the Soft AP from a Windows 10 system.Type in the required URL after joining the Soft AP network. For example, when using the setup web feature, type the URL setup.com

Changelog (v3.4.1)

Last Updated : August, 2017

Fixes and Improvements

TopicDescription
UARTFixed an issue which stopped UART communication when system.print_level was set below 3.
system.activity.gpioFixed an issue that resulted in system.activity.gpio settings eventually failing when set via the gpio_config_init.csv file. See GPIO Configuration.
DMS tokenFixed an issue resulting in an invalid token error when a device attempted to connect to the DMS after an OTA from a version of ZentriOS prior to 3.4. Note that in ZentriOS 3.4.0 this problem could be fixed by issuing a further ota -f command.