|
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