Release Notes for ZentriOS-WZ-3.1
ZentriOS-WZ-3.1 provides fixes and improvements to version 3.0.
Security features include new user encryption options, and automatic encryption of certificates and configuration files. See new system.security_key encryption options for file_create, file_open, http_download, and http_upload commands, User Encrypted file flag and new automatic encryption for the save command. See also File System, Encrypting Files for use by ZentriOS.
You can also set a TLS certificate when using tcp.client.auto_start. See tcp.client.tls_enabled.
New features for stream writes and reads allows buffer sizes to be checked before network stream read/write operations are attempted. See the bus.command.write_check_enabled variable, the stream_write and stream_poll commands, and Serial Interface, Response Format, Bounds error.
A new OOB GPIO event allows checking for HTTP data ready, using a new option with the http_get and http_post commands. See system.oob.gpio.
A GPIO can be configured as an auxiliary factory reset GPIO. See system.factory_reset.aux_gpio and system.factory_reset.aux_level variables.
The log bus can be used as an auxiliary command console. See system.cmd.aux_bus.
You can determine Soft AP RSSI with softap_get_rssi and softap.rssi_average.
Other improvements allow:
- checking if an update is available for OTA without downloading - see ota
- checking the result of an OTA - see dms.ota_result
- provide an initial value when setting GPIO direction - see gpio_dir
- WebSocket keepalive with a WebSocket ping frame - see stream_write
-poption - arbitrary length URLs for http_get
- Setting variables unaffected by factory reset - see system.variable_lock
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.1.0)
Last Updated : June, 2016
All known issues in v3.0.0 and earlier versions have been fixed.
Changelog
Fixes and Improvements
| Topic | Description |
|---|---|
| Bulk Flash | Fixed a problem that prevented formatting of bulk flash. |
| Fixed a problem with http_upload from bulk flash | |
| http_get -o | Fixed a problem where the http_get -o flag caused a command failure |
| Fixed a problem where a hard fault occured on a delayed issue of poll all after http_get -o | |
| Machine Mode | ZentriOS no longer prints \r\n on buffer overflow in machine mode |
| The command response status is now no longer printed after the response header in machine mode | |
| NXP-SCCK | Fixed a problem where a GPIO interrupt callback was not called |
| TCP | Fixed a problem where data was lost when switching out of stream mode with a TCP stream |
| Fixed a problem where the ZentriOS device crashed if a large number of small TCP fragments were queued | |
| Fixed a problem where duplicate TCP packets appeared under certain conditions | |
| Websocket Client | Fixed a problem where websocket_client was not handling its binary and GPIO arguments properly |
| ZAP | An error message is displayed if insufficient contiguous memory is available to load a ZAP: Heap truncate error. System reboot required. |
Commands Added
| Change | Description |
|---|---|
| softap_get_rssi | Get RSSI of a SoftAP client |
Commands Changed
| Change | Description |
|---|---|
| file_create | New -s and -sy encryption options |
| file_open | New security key argument |
| gpio_dir | new optional initial value argument |
| http_download | New -s and -sy encryption options |
| http_get | New -g GPIO# argument to set data ready OOB GPIO, , new option for arbitrary length URLs |
| http_post | New -g GPIO# argument to set data ready OOB GPIO |
| http_upload | New -k option for specifying security key |
| network_up | network_up -s now saves credentials automatically. |
| ota | New -q option to query if new update available without downloading |
| save | Now encrypts automatically if system.security_key is set |
| stream_poll | New -r and -t arguments; -c argument deprecated |
| stream_read | Stream read now attempts to read more than a single packet, up to 1460 bytes. |
| stream_write | Added -p option to send a WebSocket ping frame from a websocket client or server stream |
| zap_run | New message if insufficient contiguous memory is available to load a ZAP |
Variables Added
| Change | Description |
|---|---|
| bus.command.write_check_enabled | Check if write buffer large enough when writing |
| dms.ota_result | Get result of most recent OTA |
| softap.dhcp_server.lease_time | Set Soft AP DHCP server lease time |
| softap.rssi_average | Manage Soft AP RSSI averaging |
| system.cmd.aux_bus | Use the log bus as an auxiliary command console |
| system.security_key | Specify a key for user encryption |
| system.factory_reset.aux_gpio | Auxiliary factory reset GPIO |
| system.factory_reset.aux_level | Auxiliary factory reset GPIO level |
| system.variable_lock | Set variables unaffected by factory reset |
| tcp.client.tls_enabled | Enable client TLS certificate for tcp.client.auto_start |
Variables Changed
| Change | Description |
|---|---|
| system.oob.gpio | New OOB event for http_get and http_post data ready |