|
1 | | -# Z/IP Gateway SDK 7.18.03 |
2 | | - |
3 | | -June 1, 2023 |
| 1 | +# Z/IP Gateway SDK 7.18.04 |
4 | 2 |
|
5 | 3 | The Z/IP Gateway emulates the behavior of IP-enabled Z-Wave devices so that IP |
6 | 4 | applications may interact with Z-Wave devices via normal IP routing principles. The Z/IP |
7 | 5 | Gateway decodes Z/IP Packet headers and forwards extracted Z-Wave commands to |
8 | 6 | the node identified by the given IPv6 or IPv4 address. |
9 | 7 |
|
10 | 8 | These release notes cover Z/IP Gateway SDK version(s): |
11 | | -7.18.03 |
| 9 | +7.18.04 |
12 | 10 |
|
13 | | -This file is a derivate of document |
| 11 | +For the record this file was a derivate of document |
14 | 12 | [SRN14932-1C.pdf](https://www.silabs.com/documents/public/release-notes/SRN14932-1C.pdf) |
15 | | -which can be downloaded using [simplicity studio](https://www.silabs.com/developers/simplicity-studio). |
| 13 | +which was downloaded using [simplicity studio](https://www.silabs.com/developers/simplicity-studio). |
16 | 14 |
|
17 | 15 | ## NEW FEATURES |
18 | 16 |
|
19 | | -Security hardening |
| 17 | +- Project relocated to github: |
| 18 | + - https://github.com/SiliconLabs/zipgateway |
| 19 | +- libzipgateway agregated into main package |
| 20 | +- Security hardening |
| 21 | +- More configuration |
20 | 22 |
|
21 | 23 | ## Compatibility and Use Notices |
22 | 24 |
|
@@ -63,121 +65,43 @@ many sections. Essentially, the key words “MUST”, “MUST NOT”, “REQUIRE |
63 | 65 |
|
64 | 66 | ## 1 Improvements |
65 | 67 |
|
66 | | -- Security hardening (Security Advisory A-00000457) |
67 | | -- Documentation to support docker for compilation |
68 | | -- Testing |
| 68 | +- Security hardening |
| 69 | +- [ZGW-3413: Improve keys randomization](https://github.com/SiliconLabs/zipgateway/pull/12) |
| 70 | +- More customization: Region, Association Limit (Virtualnodes) |
| 71 | +- Native building on device, docker or cloud |
69 | 72 |
|
70 | 73 | ## 2 Fixed Issues |
71 | 74 |
|
72 | | -Fixed in release 7.18.03 |
| 75 | +Fixed in release 7.18.04 |
73 | 76 |
|
74 | | -- ZWG: Fix Network management state machine for new add node mode |
75 | | -- SWPROT-7936: Filesystem conversion tool for migration steps for 700 series to 800 series |
76 | | -- SWPROT-8064: Fix missing nodes when exporting to filesystem |
77 | | -- ZSP-505: Generate random from host instead of NCP to improve reliability |
78 | | -- ZGW-3383: Only enable Skip FL nodes In Neighbor Discovery when supported (ADD_NODE_OPTION_SFLND on 7.19.0+) |
79 | | -- ZGW: Send AssignSUCReturn route with Assign return route to SUC |
80 | | -- ZGW-3389: Update List of supported devices classes from Z-Wave alliance (supported.csv) |
81 | | -- ZGW: Extra check in version handling to prevent segmentation faults with invalid inputs |
82 | | -- ZGW: Security fixes (drop invalid packets, input checks to avoid memory overrun exploits) |
83 | | -- ZGW-3399: Network management handles missing setdefault callback for NM_EV_TIMEOUT |
84 | | -- ZGW-3398: Avoid to create unneeded virtual nodes after enabling ZWLR by disabling soft reset after setting node id base type |
| 77 | +- [ZGW-3403: Support single temporal associations](https://github.com/SiliconLabs/zipgateway/pull/5) |
| 78 | +- [ZGW-3393: Check node id base type when wrong source node id is received](https://github.com/SiliconLabs/zipgateway/pull/20) |
85 | 79 |
|
86 | 80 | ## 3 Known Issues in the Current Release |
87 | 81 |
|
88 | 82 | Issues in bold were added since the previous release. |
89 | 83 |
|
90 | | -- ZGW-1035: Z/IP Gateway will queue and delay incoming DTLS Client |
91 | | - Hello requests while attempting to deliver a frame to a FliRS |
92 | | - device. Delay may be multiple seconds if the FliRS device is |
93 | | - not working. |
94 | | -- ZGW-633: In some situations, NACK Waiting is sent late. This occurs if |
95 | | - the internal queues are locked or are long. The queues are |
96 | | - locked when exercising the mailbox or performing network |
97 | | - management operations. A Z/IP client might time out on a |
98 | | - frame delivery even though the frame is in fact going to be |
99 | | - delivered. ACK/NACK will be received on delivery. |
100 | | - - Workaround: |
101 | | - Extend timers in the client or if possible be aware that |
102 | | - the queues are locked due to network management |
103 | | - operations. |
104 | | -- ZGW-2707: The Z/IP Gateway does not reply multichannel encapsulated |
105 | | - S2 secure command supported Get command. |
106 | | - - Workaround: Z/IP Client should not advertise multichannel as a |
107 | | - supported command class. |
108 | | -- ZGW-2948: LibZWaveIP transmits data over Ipv4 while connecting over Ipv6 |
109 | | -- ZGW-3025: Network keys are sent over UART in plaintext (see 5.3.1) |
110 | | - Workaround: |
111 | | - Secure GW product against physical tampering |
112 | | -- ZGW-3006: Dynamic TX Power is not forwarded via IMA. Z/IP Clients are |
113 | | - not informed of the dynamic TX power used to send a |
114 | | - particular frame. |
115 | | -- ZGW-3104: The Z/IP Gateway cannot supports network sizes exceeding |
116 | | - 750 nodes. The Long Range specification allows even larger |
117 | | - networks. |
118 | | -- ZGW-3153: Migration to Long Range (LR) Z/IP Gateway from a LR |
119 | | - gateway not based on Z/IP Gatway does not work. The |
120 | | - migrated LR Z/IP Gateway will not be operational. |
121 | | -- ZGW-3287: Z/IP Gateway backup restore functionality does not work for |
122 | | - 800 series chip |
123 | | -- ZGW-3393: Zipgateway logs report invalid node IDs above 4000 for ZWLR |
124 | | -- ZGW-3396: ZIP Gateway does not regain SUC/SIS state after Learn Mode time out |
125 | | -- ZGW-3390: Joining ZGW through S0 fails learn mode process |
126 | | - Workaround: Use s2 |
| 84 | +- [Debian 9 repository is no more supported (EoL) so we use archive](https://github.com/SiliconLabs/zipgateway/pull/3) |
127 | 85 |
|
128 | 86 | ## 4 Removed and Deprecated Items |
129 | 87 |
|
130 | 88 | ### 4.1 Firmware Update targets |
131 | 89 |
|
132 | | -All firmware targets except target 0 are deprecated in Firmware Update Command Class. |
133 | | -Target 0 (i.e. the Z-Wave chip Flash memory) has furthermore been marked not-upgradable |
134 | | -because the upgrade path via the backup/restore functionality should be used instead. |
135 | | -The other firmware targets have been deprecated |
136 | | -because it is unsafe to update them individually. |
137 | | -It is recommended to use the backup/restore functionality of the ZGW instead. |
138 | | -It will safely update the information previously exposed through the firmware targets. |
| 90 | +No changes since previous release, please refer to history of this file. |
139 | 91 |
|
140 | 92 | ### 4.2 Back-off during polling |
141 | 93 |
|
142 | | -The Z/IP Gateway no longer performs back off when Z/IP clients are polling Z-Wave devices. |
143 | | -This must be handled by the clients. The change improves scalability of large networks. |
144 | | -As mandated by SDS11846: Z-Wave Plus Role Type Specification section 3.7, |
145 | | -a ZWave controller must rate-limit polling of devices in the network. |
146 | | -Previously, the Z/IP Gateway would automatically apply rate limiting to |
147 | | -requests from Z/IP clients. |
148 | | -This functionality has now been removed |
149 | | -in order to improve large network scalability. |
150 | | -As a consequence, Z/IP clients must now adhere to the requirements |
151 | | -in SDS11846: Z-Wave Plus Role Type Specification. |
| 94 | +No changes since previous release, please refer to history of this file. |
152 | 95 |
|
153 | 96 | ## 5 Using This Release |
154 | 97 |
|
155 | 98 | The Z/IP Gateway Software Developers Kit contains the following components: |
156 | 99 |
|
157 | 100 | - Debian packages: |
158 | | - - Z/IP Gateway 7.18.03, for Raspberry Pi 3B+ |
159 | | - - Z/IP Gateway 7.18.03, for Linux i386 |
| 101 | + - Z/IP Gateway for Raspberry Pi 3B+ |
160 | 102 |
|
161 | 103 | - Source code: |
162 | | - - Z/IP Gateway 7.18.03 |
163 | | - |
164 | | -- libzwaveip 7.18.03 |
165 | | - |
166 | | -- Documentation: |
167 | | - - INS12503, Z/IP Gateway Porting Process |
168 | | - - SDS12938, Z/IP LAN Security |
169 | | - - SDS12089, Z/IP Gateway Bootstrapping |
170 | | - - SDS11756, Z/IP DNS Discovery support (DNS-SD, mDNS) |
171 | | - - SDS11633, Z/IP Resource Directory (RD, DNS-SD, mDNS) |
172 | | - - SDS11445, IP Architecture Framework for Z-Wave (Z/IP) |
173 | | - - SDS13944, Node Provisioning Information Type Registry (QR code, Z/IP Gateway, SmartStart) |
174 | | - - Z/IP Security 2 in Z/IP Gateway |
175 | | - - Z/IP Gateway Source Code Documentation |
176 | | - - Z/IP Gateway User Guide (Z-Wave & IP Basics, Compilation, Installation, Troubleshooting, Sample Code) |
177 | | - - libzwaveip documentation in the file libzwaveip-7.18.01.release-docs.zip |
178 | | - Additionally, the following documentation can be found in: |
179 | | - https://www.silabs.com/products/wireless/mesh-networking/z-wave/specification: |
180 | | - - Z-Wave Command Class specifications |
| 104 | + - Z/IP Gateway and libzwaveip |
181 | 105 |
|
182 | 106 | ### 5.1 Key Features of Z/IP Gateway SDK |
183 | 107 |
|
|
0 commit comments