@willieee802/zigbee-herdsman 0.19.21 → 0.34.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (522) hide show
  1. package/.babelrc.js +0 -4
  2. package/.release-please-manifest.json +1 -2
  3. package/CHANGELOG.md +376 -0
  4. package/README.md +1 -1
  5. package/dist/adapter/adapter.d.ts +61 -61
  6. package/dist/adapter/adapter.d.ts.map +1 -1
  7. package/dist/adapter/adapter.js +158 -153
  8. package/dist/adapter/adapter.js.map +1 -1
  9. package/dist/adapter/deconz/adapter/deconzAdapter.d.ts +68 -68
  10. package/dist/adapter/deconz/adapter/deconzAdapter.d.ts.map +1 -1
  11. package/dist/adapter/deconz/adapter/deconzAdapter.js +1081 -1060
  12. package/dist/adapter/deconz/adapter/deconzAdapter.js.map +1 -1
  13. package/dist/adapter/deconz/adapter/index.d.ts +2 -2
  14. package/dist/adapter/deconz/adapter/index.js +10 -10
  15. package/dist/adapter/deconz/driver/constants.d.ts +104 -104
  16. package/dist/adapter/deconz/driver/constants.js +55 -55
  17. package/dist/adapter/deconz/driver/driver.d.ts +81 -81
  18. package/dist/adapter/deconz/driver/driver.d.ts.map +1 -1
  19. package/dist/adapter/deconz/driver/driver.js +750 -732
  20. package/dist/adapter/deconz/driver/driver.js.map +1 -1
  21. package/dist/adapter/deconz/driver/frame.d.ts +6 -6
  22. package/dist/adapter/deconz/driver/frame.js +13 -13
  23. package/dist/adapter/deconz/driver/frameParser.d.ts +2 -2
  24. package/dist/adapter/deconz/driver/frameParser.js +443 -443
  25. package/dist/adapter/deconz/driver/frameParser.js.map +1 -1
  26. package/dist/adapter/deconz/driver/parser.d.ts +12 -12
  27. package/dist/adapter/deconz/driver/parser.js +63 -61
  28. package/dist/adapter/deconz/driver/parser.js.map +1 -1
  29. package/dist/adapter/deconz/driver/writer.d.ts +8 -8
  30. package/dist/adapter/deconz/driver/writer.js +44 -44
  31. package/dist/adapter/ember/adapter/emberAdapter.d.ts +817 -0
  32. package/dist/adapter/ember/adapter/emberAdapter.d.ts.map +1 -0
  33. package/dist/adapter/ember/adapter/emberAdapter.js +2981 -0
  34. package/dist/adapter/ember/adapter/emberAdapter.js.map +1 -0
  35. package/dist/adapter/ember/adapter/endpoints.d.ts +25 -0
  36. package/dist/adapter/ember/adapter/endpoints.d.ts.map +1 -0
  37. package/dist/adapter/ember/adapter/endpoints.js +66 -0
  38. package/dist/adapter/ember/adapter/endpoints.js.map +1 -0
  39. package/dist/adapter/ember/adapter/index.d.ts +3 -0
  40. package/dist/adapter/ember/adapter/index.d.ts.map +1 -0
  41. package/dist/adapter/ember/adapter/index.js +6 -0
  42. package/dist/adapter/ember/adapter/index.js.map +1 -0
  43. package/dist/adapter/ember/adapter/oneWaitress.d.ts +97 -0
  44. package/dist/adapter/ember/adapter/oneWaitress.d.ts.map +1 -0
  45. package/dist/adapter/ember/adapter/oneWaitress.js +226 -0
  46. package/dist/adapter/ember/adapter/oneWaitress.js.map +1 -0
  47. package/dist/adapter/ember/adapter/requestQueue.d.ts +59 -0
  48. package/dist/adapter/ember/adapter/requestQueue.d.ts.map +1 -0
  49. package/dist/adapter/ember/adapter/requestQueue.js +144 -0
  50. package/dist/adapter/ember/adapter/requestQueue.js.map +1 -0
  51. package/dist/adapter/ember/adapter/tokensManager.d.ts +69 -0
  52. package/dist/adapter/ember/adapter/tokensManager.d.ts.map +1 -0
  53. package/dist/adapter/ember/adapter/tokensManager.js +685 -0
  54. package/dist/adapter/ember/adapter/tokensManager.js.map +1 -0
  55. package/dist/adapter/ember/consts.d.ts +198 -0
  56. package/dist/adapter/ember/consts.d.ts.map +1 -0
  57. package/dist/adapter/ember/consts.js +253 -0
  58. package/dist/adapter/ember/consts.js.map +1 -0
  59. package/dist/adapter/ember/enums.d.ts +2184 -0
  60. package/dist/adapter/ember/enums.d.ts.map +1 -0
  61. package/dist/adapter/ember/enums.js +2391 -0
  62. package/dist/adapter/ember/enums.js.map +1 -0
  63. package/dist/adapter/ember/ezsp/buffalo.d.ts +156 -0
  64. package/dist/adapter/ember/ezsp/buffalo.d.ts.map +1 -0
  65. package/dist/adapter/ember/ezsp/buffalo.js +1033 -0
  66. package/dist/adapter/ember/ezsp/buffalo.js.map +1 -0
  67. package/dist/adapter/ember/ezsp/consts.d.ts +116 -0
  68. package/dist/adapter/ember/ezsp/consts.d.ts.map +1 -0
  69. package/dist/adapter/ember/ezsp/consts.js +128 -0
  70. package/dist/adapter/ember/ezsp/consts.js.map +1 -0
  71. package/dist/adapter/ember/ezsp/enums.d.ts +879 -0
  72. package/dist/adapter/ember/ezsp/enums.d.ts.map +1 -0
  73. package/dist/adapter/ember/ezsp/enums.js +948 -0
  74. package/dist/adapter/ember/ezsp/enums.js.map +1 -0
  75. package/dist/adapter/ember/ezsp/ezsp.d.ts +2664 -0
  76. package/dist/adapter/ember/ezsp/ezsp.d.ts.map +1 -0
  77. package/dist/adapter/ember/ezsp/ezsp.js +6438 -0
  78. package/dist/adapter/ember/ezsp/ezsp.js.map +1 -0
  79. package/dist/adapter/ember/types.d.ts +733 -0
  80. package/dist/adapter/ember/types.d.ts.map +1 -0
  81. package/dist/adapter/ember/types.js +3 -0
  82. package/dist/adapter/ember/types.js.map +1 -0
  83. package/dist/adapter/ember/uart/ash.d.ts +451 -0
  84. package/dist/adapter/ember/uart/ash.d.ts.map +1 -0
  85. package/dist/adapter/ember/uart/ash.js +1584 -0
  86. package/dist/adapter/ember/uart/ash.js.map +1 -0
  87. package/dist/adapter/ember/uart/consts.d.ts +91 -0
  88. package/dist/adapter/ember/uart/consts.d.ts.map +1 -0
  89. package/dist/adapter/ember/uart/consts.js +100 -0
  90. package/dist/adapter/ember/uart/consts.js.map +1 -0
  91. package/dist/adapter/ember/uart/enums.d.ts +191 -0
  92. package/dist/adapter/ember/uart/enums.d.ts.map +1 -0
  93. package/dist/adapter/ember/uart/enums.js +197 -0
  94. package/dist/adapter/ember/uart/enums.js.map +1 -0
  95. package/dist/adapter/ember/uart/parser.d.ts +10 -0
  96. package/dist/adapter/ember/uart/parser.d.ts.map +1 -0
  97. package/dist/adapter/ember/uart/parser.js +41 -0
  98. package/dist/adapter/ember/uart/parser.js.map +1 -0
  99. package/dist/adapter/ember/uart/queues.d.ts +85 -0
  100. package/dist/adapter/ember/uart/queues.d.ts.map +1 -0
  101. package/dist/adapter/ember/uart/queues.js +212 -0
  102. package/dist/adapter/ember/uart/queues.js.map +1 -0
  103. package/dist/adapter/ember/uart/writer.d.ts +15 -0
  104. package/dist/adapter/ember/uart/writer.d.ts.map +1 -0
  105. package/dist/adapter/ember/uart/writer.js +48 -0
  106. package/dist/adapter/ember/uart/writer.js.map +1 -0
  107. package/dist/adapter/ember/utils/initters.d.ts +20 -0
  108. package/dist/adapter/ember/utils/initters.d.ts.map +1 -0
  109. package/dist/adapter/ember/utils/initters.js +58 -0
  110. package/dist/adapter/ember/utils/initters.js.map +1 -0
  111. package/dist/adapter/ember/utils/math.d.ts +51 -0
  112. package/dist/adapter/ember/utils/math.d.ts.map +1 -0
  113. package/dist/adapter/ember/utils/math.js +102 -0
  114. package/dist/adapter/ember/utils/math.js.map +1 -0
  115. package/dist/adapter/ember/zdo.d.ts +921 -0
  116. package/dist/adapter/ember/zdo.d.ts.map +1 -0
  117. package/dist/adapter/ember/zdo.js +723 -0
  118. package/dist/adapter/ember/zdo.js.map +1 -0
  119. package/dist/adapter/events.d.ts +47 -47
  120. package/dist/adapter/events.js +13 -14
  121. package/dist/adapter/events.js.map +1 -1
  122. package/dist/adapter/ezsp/adapter/backup.d.ts +9 -9
  123. package/dist/adapter/ezsp/adapter/backup.d.ts.map +1 -1
  124. package/dist/adapter/ezsp/adapter/backup.js +72 -53
  125. package/dist/adapter/ezsp/adapter/backup.js.map +1 -1
  126. package/dist/adapter/ezsp/adapter/ezspAdapter.d.ts +61 -60
  127. package/dist/adapter/ezsp/adapter/ezspAdapter.d.ts.map +1 -1
  128. package/dist/adapter/ezsp/adapter/ezspAdapter.js +629 -608
  129. package/dist/adapter/ezsp/adapter/ezspAdapter.js.map +1 -1
  130. package/dist/adapter/ezsp/adapter/index.d.ts +2 -2
  131. package/dist/adapter/ezsp/adapter/index.js +10 -10
  132. package/dist/adapter/ezsp/driver/commands.d.ts +36 -36
  133. package/dist/adapter/ezsp/driver/commands.d.ts.map +1 -1
  134. package/dist/adapter/ezsp/driver/commands.js +2388 -2359
  135. package/dist/adapter/ezsp/driver/commands.js.map +1 -1
  136. package/dist/adapter/ezsp/driver/consts.d.ts +10 -10
  137. package/dist/adapter/ezsp/driver/consts.js +13 -13
  138. package/dist/adapter/ezsp/driver/driver.d.ts +106 -101
  139. package/dist/adapter/ezsp/driver/driver.d.ts.map +1 -1
  140. package/dist/adapter/ezsp/driver/driver.js +731 -638
  141. package/dist/adapter/ezsp/driver/driver.js.map +1 -1
  142. package/dist/adapter/ezsp/driver/ezsp.d.ts +105 -96
  143. package/dist/adapter/ezsp/driver/ezsp.d.ts.map +1 -1
  144. package/dist/adapter/ezsp/driver/ezsp.js +651 -586
  145. package/dist/adapter/ezsp/driver/ezsp.js.map +1 -1
  146. package/dist/adapter/ezsp/driver/frame.d.ts +40 -0
  147. package/dist/adapter/ezsp/driver/frame.d.ts.map +1 -0
  148. package/dist/adapter/ezsp/driver/frame.js +101 -0
  149. package/dist/adapter/ezsp/driver/frame.js.map +1 -0
  150. package/dist/adapter/ezsp/driver/index.d.ts +3 -3
  151. package/dist/adapter/ezsp/driver/index.js +8 -8
  152. package/dist/adapter/ezsp/driver/multicast.d.ts +12 -12
  153. package/dist/adapter/ezsp/driver/multicast.js +77 -72
  154. package/dist/adapter/ezsp/driver/multicast.js.map +1 -1
  155. package/dist/adapter/ezsp/driver/parser.d.ts +11 -12
  156. package/dist/adapter/ezsp/driver/parser.d.ts.map +1 -1
  157. package/dist/adapter/ezsp/driver/parser.js +104 -111
  158. package/dist/adapter/ezsp/driver/parser.js.map +1 -1
  159. package/dist/adapter/ezsp/driver/types/basic.d.ts +62 -62
  160. package/dist/adapter/ezsp/driver/types/basic.js +208 -208
  161. package/dist/adapter/ezsp/driver/types/basic.js.map +1 -1
  162. package/dist/adapter/ezsp/driver/types/index.d.ts +9 -9
  163. package/dist/adapter/ezsp/driver/types/index.d.ts.map +1 -1
  164. package/dist/adapter/ezsp/driver/types/index.js +138 -133
  165. package/dist/adapter/ezsp/driver/types/index.js.map +1 -1
  166. package/dist/adapter/ezsp/driver/types/named.d.ts +1287 -697
  167. package/dist/adapter/ezsp/driver/types/named.d.ts.map +1 -1
  168. package/dist/adapter/ezsp/driver/types/named.js +2329 -1726
  169. package/dist/adapter/ezsp/driver/types/named.js.map +1 -1
  170. package/dist/adapter/ezsp/driver/types/struct.d.ts +270 -251
  171. package/dist/adapter/ezsp/driver/types/struct.d.ts.map +1 -1
  172. package/dist/adapter/ezsp/driver/types/struct.js +803 -708
  173. package/dist/adapter/ezsp/driver/types/struct.js.map +1 -1
  174. package/dist/adapter/ezsp/driver/uart.d.ts +48 -44
  175. package/dist/adapter/ezsp/driver/uart.d.ts.map +1 -1
  176. package/dist/adapter/ezsp/driver/uart.js +382 -368
  177. package/dist/adapter/ezsp/driver/uart.js.map +1 -1
  178. package/dist/adapter/ezsp/driver/utils/crc16ccitt.d.ts +2 -2
  179. package/dist/adapter/ezsp/driver/utils/crc16ccitt.js +55 -55
  180. package/dist/adapter/ezsp/driver/utils/crc16ccitt.js.map +1 -1
  181. package/dist/adapter/ezsp/driver/utils/index.d.ts +18 -18
  182. package/dist/adapter/ezsp/driver/utils/index.js +72 -67
  183. package/dist/adapter/ezsp/driver/utils/index.js.map +1 -1
  184. package/dist/adapter/ezsp/driver/writer.d.ts +13 -13
  185. package/dist/adapter/ezsp/driver/writer.d.ts.map +1 -1
  186. package/dist/adapter/ezsp/driver/writer.js +85 -88
  187. package/dist/adapter/ezsp/driver/writer.js.map +1 -1
  188. package/dist/adapter/index.d.ts +4 -4
  189. package/dist/adapter/index.js +35 -35
  190. package/dist/adapter/serialPort.d.ts +10 -8
  191. package/dist/adapter/serialPort.d.ts.map +1 -1
  192. package/dist/adapter/serialPort.js +53 -22
  193. package/dist/adapter/serialPort.js.map +1 -1
  194. package/dist/adapter/serialPortUtils.d.ts +12 -12
  195. package/dist/adapter/serialPortUtils.js +18 -18
  196. package/dist/adapter/serialPortUtils.js.map +1 -1
  197. package/dist/adapter/socketPortUtils.d.ts +10 -10
  198. package/dist/adapter/socketPortUtils.js +16 -16
  199. package/dist/adapter/tstype.d.ts +85 -85
  200. package/dist/adapter/tstype.d.ts.map +1 -1
  201. package/dist/adapter/tstype.js +2 -2
  202. package/dist/adapter/z-stack/adapter/adapter-backup.d.ts +62 -62
  203. package/dist/adapter/z-stack/adapter/adapter-backup.js +462 -461
  204. package/dist/adapter/z-stack/adapter/adapter-backup.js.map +1 -1
  205. package/dist/adapter/z-stack/adapter/adapter-nv-memory.d.ts +150 -150
  206. package/dist/adapter/z-stack/adapter/adapter-nv-memory.js +258 -258
  207. package/dist/adapter/z-stack/adapter/adapter-nv-memory.js.map +1 -1
  208. package/dist/adapter/z-stack/adapter/endpoints.d.ts +11 -11
  209. package/dist/adapter/z-stack/adapter/endpoints.js +73 -73
  210. package/dist/adapter/z-stack/adapter/index.d.ts +2 -2
  211. package/dist/adapter/z-stack/adapter/index.js +8 -8
  212. package/dist/adapter/z-stack/adapter/manager.d.ts +86 -86
  213. package/dist/adapter/z-stack/adapter/manager.d.ts.map +1 -1
  214. package/dist/adapter/z-stack/adapter/manager.js +482 -476
  215. package/dist/adapter/z-stack/adapter/manager.js.map +1 -1
  216. package/dist/adapter/z-stack/adapter/tstype.d.ts +6 -6
  217. package/dist/adapter/z-stack/adapter/tstype.js +9 -10
  218. package/dist/adapter/z-stack/adapter/tstype.js.map +1 -1
  219. package/dist/adapter/z-stack/adapter/zStackAdapter.d.ts +81 -81
  220. package/dist/adapter/z-stack/adapter/zStackAdapter.d.ts.map +1 -1
  221. package/dist/adapter/z-stack/adapter/zStackAdapter.js +891 -868
  222. package/dist/adapter/z-stack/adapter/zStackAdapter.js.map +1 -1
  223. package/dist/adapter/z-stack/constants/af.d.ts +23 -23
  224. package/dist/adapter/z-stack/constants/af.js +27 -27
  225. package/dist/adapter/z-stack/constants/common.d.ts +278 -278
  226. package/dist/adapter/z-stack/constants/common.d.ts.map +1 -1
  227. package/dist/adapter/z-stack/constants/common.js +292 -289
  228. package/dist/adapter/z-stack/constants/common.js.map +1 -1
  229. package/dist/adapter/z-stack/constants/dbg.d.ts +22 -22
  230. package/dist/adapter/z-stack/constants/dbg.js +24 -24
  231. package/dist/adapter/z-stack/constants/index.d.ts +10 -10
  232. package/dist/adapter/z-stack/constants/index.js +47 -47
  233. package/dist/adapter/z-stack/constants/mac.d.ts +127 -127
  234. package/dist/adapter/z-stack/constants/mac.js +129 -129
  235. package/dist/adapter/z-stack/constants/sapi.d.ts +24 -24
  236. package/dist/adapter/z-stack/constants/sapi.js +26 -26
  237. package/dist/adapter/z-stack/constants/sys.d.ts +71 -71
  238. package/dist/adapter/z-stack/constants/sys.js +73 -73
  239. package/dist/adapter/z-stack/constants/util.d.ts +81 -81
  240. package/dist/adapter/z-stack/constants/util.js +83 -83
  241. package/dist/adapter/z-stack/constants/utils.d.ts +4 -4
  242. package/dist/adapter/z-stack/constants/utils.js +14 -14
  243. package/dist/adapter/z-stack/constants/zdo.d.ts +102 -102
  244. package/dist/adapter/z-stack/constants/zdo.js +104 -104
  245. package/dist/adapter/z-stack/models/index.d.ts +1 -1
  246. package/dist/adapter/z-stack/models/index.js +17 -17
  247. package/dist/adapter/z-stack/models/startup-options.d.ts +12 -12
  248. package/dist/adapter/z-stack/models/startup-options.js +2 -2
  249. package/dist/adapter/z-stack/structs/entries/address-manager-entry.d.ts +23 -23
  250. package/dist/adapter/z-stack/structs/entries/address-manager-entry.js +45 -45
  251. package/dist/adapter/z-stack/structs/entries/address-manager-entry.js.map +1 -1
  252. package/dist/adapter/z-stack/structs/entries/address-manager-table.d.ts +10 -10
  253. package/dist/adapter/z-stack/structs/entries/address-manager-table.js +22 -22
  254. package/dist/adapter/z-stack/structs/entries/aps-link-key-data-entry.d.ts +10 -10
  255. package/dist/adapter/z-stack/structs/entries/aps-link-key-data-entry.js +21 -21
  256. package/dist/adapter/z-stack/structs/entries/aps-link-key-data-table.d.ts +10 -10
  257. package/dist/adapter/z-stack/structs/entries/aps-link-key-data-table.js +23 -23
  258. package/dist/adapter/z-stack/structs/entries/aps-tc-link-key-entry.d.ts +10 -10
  259. package/dist/adapter/z-stack/structs/entries/aps-tc-link-key-entry.js +24 -24
  260. package/dist/adapter/z-stack/structs/entries/aps-tc-link-key-table.d.ts +10 -10
  261. package/dist/adapter/z-stack/structs/entries/aps-tc-link-key-table.js +23 -23
  262. package/dist/adapter/z-stack/structs/entries/channel-list.d.ts +8 -8
  263. package/dist/adapter/z-stack/structs/entries/channel-list.js +15 -15
  264. package/dist/adapter/z-stack/structs/entries/has-configured.d.ts +8 -8
  265. package/dist/adapter/z-stack/structs/entries/has-configured.js +16 -16
  266. package/dist/adapter/z-stack/structs/entries/index.d.ts +16 -16
  267. package/dist/adapter/z-stack/structs/entries/index.js +32 -32
  268. package/dist/adapter/z-stack/structs/entries/nib.d.ts +10 -10
  269. package/dist/adapter/z-stack/structs/entries/nib.js +68 -68
  270. package/dist/adapter/z-stack/structs/entries/nwk-key-descriptor.d.ts +10 -10
  271. package/dist/adapter/z-stack/structs/entries/nwk-key-descriptor.js +18 -18
  272. package/dist/adapter/z-stack/structs/entries/nwk-key.d.ts +8 -8
  273. package/dist/adapter/z-stack/structs/entries/nwk-key.js +15 -15
  274. package/dist/adapter/z-stack/structs/entries/nwk-pan-id.d.ts +8 -8
  275. package/dist/adapter/z-stack/structs/entries/nwk-pan-id.js +15 -15
  276. package/dist/adapter/z-stack/structs/entries/nwk-sec-material-descriptor-entry.d.ts +13 -13
  277. package/dist/adapter/z-stack/structs/entries/nwk-sec-material-descriptor-entry.js +23 -23
  278. package/dist/adapter/z-stack/structs/entries/nwk-sec-material-descriptor-table.d.ts +10 -10
  279. package/dist/adapter/z-stack/structs/entries/nwk-sec-material-descriptor-table.js +22 -22
  280. package/dist/adapter/z-stack/structs/entries/security-manager-entry.d.ts +20 -20
  281. package/dist/adapter/z-stack/structs/entries/security-manager-entry.js +36 -36
  282. package/dist/adapter/z-stack/structs/entries/security-manager-entry.js.map +1 -1
  283. package/dist/adapter/z-stack/structs/entries/security-manager-table.d.ts +10 -10
  284. package/dist/adapter/z-stack/structs/entries/security-manager-table.js +24 -24
  285. package/dist/adapter/z-stack/structs/index.d.ts +4 -4
  286. package/dist/adapter/z-stack/structs/index.js +20 -20
  287. package/dist/adapter/z-stack/structs/serializable-memory-object.d.ts +13 -13
  288. package/dist/adapter/z-stack/structs/serializable-memory-object.js +2 -2
  289. package/dist/adapter/z-stack/structs/struct.d.ts +99 -99
  290. package/dist/adapter/z-stack/structs/struct.js +296 -295
  291. package/dist/adapter/z-stack/structs/struct.js.map +1 -1
  292. package/dist/adapter/z-stack/structs/table.d.ts +94 -94
  293. package/dist/adapter/z-stack/structs/table.js +163 -161
  294. package/dist/adapter/z-stack/structs/table.js.map +1 -1
  295. package/dist/adapter/z-stack/unpi/constants.d.ts +28 -28
  296. package/dist/adapter/z-stack/unpi/constants.js +39 -41
  297. package/dist/adapter/z-stack/unpi/constants.js.map +1 -1
  298. package/dist/adapter/z-stack/unpi/frame.d.ts +16 -16
  299. package/dist/adapter/z-stack/unpi/frame.js +54 -48
  300. package/dist/adapter/z-stack/unpi/frame.js.map +1 -1
  301. package/dist/adapter/z-stack/unpi/index.d.ts +5 -5
  302. package/dist/adapter/z-stack/unpi/index.js +37 -37
  303. package/dist/adapter/z-stack/unpi/parser.d.ts +10 -10
  304. package/dist/adapter/z-stack/unpi/parser.js +75 -74
  305. package/dist/adapter/z-stack/unpi/parser.js.map +1 -1
  306. package/dist/adapter/z-stack/unpi/writer.d.ts +10 -10
  307. package/dist/adapter/z-stack/unpi/writer.js +44 -44
  308. package/dist/adapter/z-stack/utils/channel-list.d.ts +20 -20
  309. package/dist/adapter/z-stack/utils/channel-list.js +40 -40
  310. package/dist/adapter/z-stack/utils/channel-list.js.map +1 -1
  311. package/dist/adapter/z-stack/utils/index.d.ts +2 -2
  312. package/dist/adapter/z-stack/utils/index.js +18 -18
  313. package/dist/adapter/z-stack/utils/network-options.d.ts +8 -8
  314. package/dist/adapter/z-stack/utils/network-options.js +22 -22
  315. package/dist/adapter/z-stack/znp/buffaloZnp.d.ts +11 -11
  316. package/dist/adapter/z-stack/znp/buffaloZnp.js +113 -113
  317. package/dist/adapter/z-stack/znp/buffaloZnp.js.map +1 -1
  318. package/dist/adapter/z-stack/znp/definition.d.ts +5 -5
  319. package/dist/adapter/z-stack/znp/definition.js +3050 -3050
  320. package/dist/adapter/z-stack/znp/index.d.ts +3 -3
  321. package/dist/adapter/z-stack/znp/index.js +10 -10
  322. package/dist/adapter/z-stack/znp/parameterType.d.ts +22 -22
  323. package/dist/adapter/z-stack/znp/parameterType.js +25 -25
  324. package/dist/adapter/z-stack/znp/tstype.d.ts +21 -21
  325. package/dist/adapter/z-stack/znp/tstype.js +2 -2
  326. package/dist/adapter/z-stack/znp/znp.d.ts +44 -43
  327. package/dist/adapter/z-stack/znp/znp.d.ts.map +1 -1
  328. package/dist/adapter/z-stack/znp/znp.js +326 -325
  329. package/dist/adapter/z-stack/znp/znp.js.map +1 -1
  330. package/dist/adapter/z-stack/znp/zpiObject.d.ts +19 -19
  331. package/dist/adapter/z-stack/znp/zpiObject.js +102 -96
  332. package/dist/adapter/z-stack/znp/zpiObject.js.map +1 -1
  333. package/dist/adapter/zigate/adapter/index.d.ts +2 -2
  334. package/dist/adapter/zigate/adapter/index.js +10 -10
  335. package/dist/adapter/zigate/adapter/zigateAdapter.d.ts +70 -70
  336. package/dist/adapter/zigate/adapter/zigateAdapter.js +689 -684
  337. package/dist/adapter/zigate/adapter/zigateAdapter.js.map +1 -1
  338. package/dist/adapter/zigate/debug.d.ts +7 -7
  339. package/dist/adapter/zigate/debug.d.ts.map +1 -1
  340. package/dist/adapter/zigate/debug.js +19 -22
  341. package/dist/adapter/zigate/debug.js.map +1 -1
  342. package/dist/adapter/zigate/driver/buffaloZiGate.d.ts +18 -18
  343. package/dist/adapter/zigate/driver/buffaloZiGate.js +139 -139
  344. package/dist/adapter/zigate/driver/buffaloZiGate.js.map +1 -1
  345. package/dist/adapter/zigate/driver/commandType.d.ts +41 -41
  346. package/dist/adapter/zigate/driver/commandType.js +385 -385
  347. package/dist/adapter/zigate/driver/commandType.js.map +1 -1
  348. package/dist/adapter/zigate/driver/constants.d.ts +276 -276
  349. package/dist/adapter/zigate/driver/constants.d.ts.map +1 -1
  350. package/dist/adapter/zigate/driver/constants.js +371 -371
  351. package/dist/adapter/zigate/driver/constants.js.map +1 -1
  352. package/dist/adapter/zigate/driver/frame.d.ts +26 -26
  353. package/dist/adapter/zigate/driver/frame.js +172 -172
  354. package/dist/adapter/zigate/driver/frame.js.map +1 -1
  355. package/dist/adapter/zigate/driver/messageType.d.ts +11 -11
  356. package/dist/adapter/zigate/driver/messageType.js +278 -278
  357. package/dist/adapter/zigate/driver/messageType.js.map +1 -1
  358. package/dist/adapter/zigate/driver/parameterType.d.ts +20 -20
  359. package/dist/adapter/zigate/driver/parameterType.js +23 -23
  360. package/dist/adapter/zigate/driver/ziGateObject.d.ts +23 -23
  361. package/dist/adapter/zigate/driver/ziGateObject.js +110 -106
  362. package/dist/adapter/zigate/driver/ziGateObject.js.map +1 -1
  363. package/dist/adapter/zigate/driver/zigate.d.ts +49 -49
  364. package/dist/adapter/zigate/driver/zigate.d.ts.map +1 -1
  365. package/dist/adapter/zigate/driver/zigate.js +296 -303
  366. package/dist/adapter/zigate/driver/zigate.js.map +1 -1
  367. package/dist/buffalo/buffalo.d.ts +50 -50
  368. package/dist/buffalo/buffalo.js +324 -322
  369. package/dist/buffalo/buffalo.js.map +1 -1
  370. package/dist/buffalo/index.d.ts +3 -3
  371. package/dist/buffalo/index.js +33 -33
  372. package/dist/buffalo/tstype.d.ts +8 -8
  373. package/dist/buffalo/tstype.js +2 -2
  374. package/dist/controller/controller.d.ts +113 -113
  375. package/dist/controller/controller.d.ts.map +1 -1
  376. package/dist/controller/controller.js +641 -619
  377. package/dist/controller/controller.js.map +1 -1
  378. package/dist/controller/database.d.ts +18 -18
  379. package/dist/controller/database.js +96 -93
  380. package/dist/controller/database.js.map +1 -1
  381. package/dist/controller/events.d.ts +58 -58
  382. package/dist/controller/events.d.ts.map +1 -1
  383. package/dist/controller/events.js +108 -102
  384. package/dist/controller/events.js.map +1 -1
  385. package/dist/controller/greenPower.d.ts +12 -12
  386. package/dist/controller/greenPower.js +221 -220
  387. package/dist/controller/greenPower.js.map +1 -1
  388. package/dist/controller/helpers/index.d.ts +2 -2
  389. package/dist/controller/helpers/index.js +28 -28
  390. package/dist/controller/helpers/request.d.ts +21 -22
  391. package/dist/controller/helpers/request.d.ts.map +1 -1
  392. package/dist/controller/helpers/request.js +77 -71
  393. package/dist/controller/helpers/request.js.map +1 -1
  394. package/dist/controller/helpers/requestQueue.d.ts +13 -0
  395. package/dist/controller/helpers/requestQueue.d.ts.map +1 -0
  396. package/dist/controller/helpers/requestQueue.js +116 -0
  397. package/dist/controller/helpers/requestQueue.js.map +1 -0
  398. package/dist/controller/helpers/zclFrameConverter.d.ts +7 -7
  399. package/dist/controller/helpers/zclFrameConverter.d.ts.map +1 -1
  400. package/dist/controller/helpers/zclFrameConverter.js +50 -31
  401. package/dist/controller/helpers/zclFrameConverter.js.map +1 -1
  402. package/dist/controller/helpers/zclTransactionSequenceNumber.d.ts +5 -5
  403. package/dist/controller/helpers/zclTransactionSequenceNumber.js +13 -13
  404. package/dist/controller/helpers/zclTransactionSequenceNumber.js.map +1 -1
  405. package/dist/controller/index.d.ts +5 -5
  406. package/dist/controller/index.js +8 -8
  407. package/dist/controller/logger-stub.d.ts +6 -6
  408. package/dist/controller/logger-stub.js +2 -2
  409. package/dist/controller/model/device.d.ts +132 -133
  410. package/dist/controller/model/device.d.ts.map +1 -1
  411. package/dist/controller/model/device.js +724 -717
  412. package/dist/controller/model/device.js.map +1 -1
  413. package/dist/controller/model/endpoint.d.ts +128 -131
  414. package/dist/controller/model/endpoint.d.ts.map +1 -1
  415. package/dist/controller/model/endpoint.js +755 -821
  416. package/dist/controller/model/endpoint.js.map +1 -1
  417. package/dist/controller/model/entity.d.ts +14 -14
  418. package/dist/controller/model/entity.js +26 -26
  419. package/dist/controller/model/entity.js.map +1 -1
  420. package/dist/controller/model/group.d.ts +38 -38
  421. package/dist/controller/model/group.d.ts.map +1 -1
  422. package/dist/controller/model/group.js +225 -221
  423. package/dist/controller/model/group.js.map +1 -1
  424. package/dist/controller/model/index.d.ts +5 -5
  425. package/dist/controller/model/index.js +14 -14
  426. package/dist/controller/touchlink.d.ts +19 -19
  427. package/dist/controller/touchlink.js +159 -157
  428. package/dist/controller/touchlink.js.map +1 -1
  429. package/dist/controller/tstype.d.ts +20 -21
  430. package/dist/controller/tstype.d.ts.map +1 -1
  431. package/dist/controller/tstype.js +8 -9
  432. package/dist/controller/tstype.js.map +1 -1
  433. package/dist/index.d.ts +3 -3
  434. package/dist/index.js +33 -33
  435. package/dist/models/backup-storage-legacy.d.ts +26 -26
  436. package/dist/models/backup-storage-legacy.js +2 -2
  437. package/dist/models/backup-storage-unified.d.ts +49 -49
  438. package/dist/models/backup-storage-unified.js +2 -2
  439. package/dist/models/backup.d.ts +37 -37
  440. package/dist/models/backup.js +2 -2
  441. package/dist/models/index.d.ts +4 -4
  442. package/dist/models/index.js +20 -20
  443. package/dist/models/network-options.d.ts +12 -12
  444. package/dist/models/network-options.js +2 -2
  445. package/dist/utils/assertString.d.ts +2 -2
  446. package/dist/utils/assertString.js +8 -8
  447. package/dist/utils/assertString.js.map +1 -1
  448. package/dist/utils/backup.d.ts +20 -20
  449. package/dist/utils/backup.d.ts.map +1 -1
  450. package/dist/utils/backup.js +189 -187
  451. package/dist/utils/backup.js.map +1 -1
  452. package/dist/utils/equalsPartial.d.ts +2 -2
  453. package/dist/utils/equalsPartial.js +11 -11
  454. package/dist/utils/index.d.ts +9 -9
  455. package/dist/utils/index.js +45 -45
  456. package/dist/utils/isNumberArray.d.ts +2 -2
  457. package/dist/utils/isNumberArray.js +6 -6
  458. package/dist/utils/queue.d.ts +11 -11
  459. package/dist/utils/queue.d.ts.map +1 -1
  460. package/dist/utils/queue.js +61 -50
  461. package/dist/utils/queue.js.map +1 -1
  462. package/dist/utils/realpathSync.d.ts +2 -2
  463. package/dist/utils/realpathSync.js +12 -12
  464. package/dist/utils/wait.d.ts +2 -2
  465. package/dist/utils/wait.js +8 -8
  466. package/dist/utils/waitress.d.ts +21 -21
  467. package/dist/utils/waitress.d.ts.map +1 -1
  468. package/dist/utils/waitress.js +68 -61
  469. package/dist/utils/waitress.js.map +1 -1
  470. package/dist/zcl/buffaloZcl.d.ts +41 -41
  471. package/dist/zcl/buffaloZcl.d.ts.map +1 -1
  472. package/dist/zcl/buffaloZcl.js +594 -591
  473. package/dist/zcl/buffaloZcl.js.map +1 -1
  474. package/dist/zcl/definition/buffaloZclDataType.d.ts +17 -17
  475. package/dist/zcl/definition/buffaloZclDataType.js +20 -20
  476. package/dist/zcl/definition/cluster.d.ts +29 -29
  477. package/dist/zcl/definition/cluster.d.ts.map +1 -1
  478. package/dist/zcl/definition/cluster.js +5520 -5335
  479. package/dist/zcl/definition/cluster.js.map +1 -1
  480. package/dist/zcl/definition/dataType.d.ts +59 -59
  481. package/dist/zcl/definition/dataType.js +64 -64
  482. package/dist/zcl/definition/direction.d.ts +5 -5
  483. package/dist/zcl/definition/direction.js +8 -8
  484. package/dist/zcl/definition/endpointDeviceType.d.ts +4 -4
  485. package/dist/zcl/definition/endpointDeviceType.js +15 -15
  486. package/dist/zcl/definition/foundation.d.ts +11 -11
  487. package/dist/zcl/definition/foundation.js +167 -167
  488. package/dist/zcl/definition/frameControl.d.ts +10 -10
  489. package/dist/zcl/definition/frameControl.js +2 -2
  490. package/dist/zcl/definition/frameType.d.ts +5 -5
  491. package/dist/zcl/definition/frameType.js +8 -8
  492. package/dist/zcl/definition/index.d.ts +13 -13
  493. package/dist/zcl/definition/index.js +51 -51
  494. package/dist/zcl/definition/manufacturerCode.d.ts +1077 -1074
  495. package/dist/zcl/definition/manufacturerCode.d.ts.map +1 -1
  496. package/dist/zcl/definition/manufacturerCode.js +1082 -1079
  497. package/dist/zcl/definition/manufacturerCode.js.map +1 -1
  498. package/dist/zcl/definition/powerSource.d.ts +4 -4
  499. package/dist/zcl/definition/powerSource.js +12 -12
  500. package/dist/zcl/definition/status.d.ts +38 -38
  501. package/dist/zcl/definition/status.js +41 -41
  502. package/dist/zcl/definition/tstype.d.ts +16 -16
  503. package/dist/zcl/definition/tstype.js +2 -2
  504. package/dist/zcl/index.d.ts +16 -16
  505. package/dist/zcl/index.js +55 -55
  506. package/dist/zcl/tstype.d.ts +56 -56
  507. package/dist/zcl/tstype.js +9 -10
  508. package/dist/zcl/tstype.js.map +1 -1
  509. package/dist/zcl/utils.d.ts +6 -6
  510. package/dist/zcl/utils.js +164 -165
  511. package/dist/zcl/utils.js.map +1 -1
  512. package/dist/zcl/zclFrame.d.ts +40 -40
  513. package/dist/zcl/zclFrame.js +351 -347
  514. package/dist/zcl/zclFrame.js.map +1 -1
  515. package/dist/zcl/zclHeader.d.ts +8 -8
  516. package/dist/zcl/zclHeader.js +2 -2
  517. package/dist/zcl/zclStatusError.d.ts +5 -5
  518. package/dist/zcl/zclStatusError.js +14 -13
  519. package/dist/zcl/zclStatusError.js.map +1 -1
  520. package/package.json +11 -11
  521. package/release-please-config.json +1 -5
  522. package/tsconfig.json +4 -2
@@ -1,869 +1,892 @@
1
- "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || function (mod) {
19
- if (mod && mod.__esModule) return mod;
20
- var result = {};
21
- if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
22
- __setModuleDefault(result, mod);
23
- return result;
24
- };
25
- var __importDefault = (this && this.__importDefault) || function (mod) {
26
- return (mod && mod.__esModule) ? mod : { "default": mod };
27
- };
28
- Object.defineProperty(exports, "__esModule", { value: true });
29
- const tstype_1 = require("./tstype");
30
- const Events = __importStar(require("../../events"));
31
- const adapter_1 = __importDefault(require("../../adapter"));
32
- const znp_1 = require("../znp");
33
- const unpi_1 = require("../unpi");
34
- const zcl_1 = require("../../../zcl");
35
- const utils_1 = require("../../../utils");
36
- const Constants = __importStar(require("../constants"));
37
- const debug_1 = __importDefault(require("debug"));
38
- const debounce_1 = __importDefault(require("debounce"));
39
- const manager_1 = require("./manager");
40
- const assert_1 = __importDefault(require("assert"));
41
- const debug = (0, debug_1.default)("zigbee-herdsman:adapter:zStack:adapter");
42
- const Subsystem = unpi_1.Constants.Subsystem;
43
- const Type = unpi_1.Constants.Type;
44
- const { ZnpCommandStatus, AddressMode } = Constants.COMMON;
45
- const DataConfirmTimeout = 9999; // Not an actual code
46
- const DataConfirmErrorCodeLookup = {
47
- [DataConfirmTimeout]: 'Timeout',
48
- 26: 'MAC no resources',
49
- 183: 'APS no ack',
50
- 205: 'No network route',
51
- 225: 'MAC channel access failure',
52
- 233: 'MAC no ack',
53
- 240: 'MAC transaction expired',
54
- };
55
- class DataConfirmError extends Error {
56
- constructor(code) {
57
- const message = `Data request failed with error: '${DataConfirmErrorCodeLookup[code]}' (${code})`;
58
- super(message);
59
- this.code = code;
60
- }
61
- }
62
- class ZStackAdapter extends adapter_1.default {
63
- constructor(networkOptions, serialPortOptions, backupPath, adapterOptions, logger) {
64
- super(networkOptions, serialPortOptions, backupPath, adapterOptions, logger);
65
- this.supportsLED = null;
66
- this.znp = new znp_1.Znp(this.serialPortOptions.path, this.serialPortOptions.baudRate, this.serialPortOptions.rtscts);
67
- this.transactionID = 0;
68
- this.deviceAnnounceRouteDiscoveryDebouncers = new Map();
69
- this.interpanLock = false;
70
- this.interpanEndpointRegistered = false;
71
- this.closing = false;
72
- this.waitress = new utils_1.Waitress(this.waitressValidator, this.waitressTimeoutFormatter);
73
- this.znp.on('received', this.onZnpRecieved.bind(this));
74
- this.znp.on('close', this.onZnpClose.bind(this));
75
- }
76
- /**
77
- * Adapter methods
78
- */
79
- async start() {
80
- await this.znp.open();
81
- const attempts = 3;
82
- for (let i = 0; i < attempts; i++) {
83
- try {
84
- await this.znp.request(Subsystem.SYS, 'ping', { capabilities: 1 });
85
- break;
86
- }
87
- catch (e) {
88
- if (attempts - 1 === i) {
89
- throw new Error(`Failed to connect to the adapter (${e})`);
90
- }
91
- }
92
- }
93
- // Old firmware did not support version, assume it's Z-Stack 1.2 for now.
94
- try {
95
- this.version = (await this.znp.request(Subsystem.SYS, 'version', {})).payload;
96
- }
97
- catch (e) {
98
- debug(`Failed to get zStack version, assuming 1.2`);
99
- this.version = { "transportrev": 2, "product": 0, "majorrel": 2, "minorrel": 0, "maintrel": 0, "revision": "" };
100
- }
101
- const concurrent = this.adapterOptions && this.adapterOptions.concurrent ?
102
- this.adapterOptions.concurrent :
103
- (this.version.product === tstype_1.ZnpVersion.zStack3x0 ? 16 : 2);
104
- debug(`Adapter concurrent: ${concurrent}`);
105
- this.queue = new utils_1.Queue(concurrent);
106
- debug(`Detected znp version '${tstype_1.ZnpVersion[this.version.product]}' (${JSON.stringify(this.version)})`);
107
- this.adapterManager = new manager_1.ZnpAdapterManager(this.znp, {
108
- backupPath: this.backupPath,
109
- version: this.version.product,
110
- greenPowerGroup: this.greenPowerGroup,
111
- networkOptions: this.networkOptions,
112
- adapterOptions: this.adapterOptions,
113
- }, this.logger);
114
- const startResult = this.adapterManager.start();
115
- if (this.adapterOptions.disableLED) {
116
- // Wait a bit for adapter to startup, otherwise led doesn't disable (tested with CC2531)
117
- await (0, utils_1.Wait)(200);
118
- await this.setLED('disable');
119
- }
120
- return startResult;
121
- }
122
- async stop() {
123
- this.closing = true;
124
- await this.znp.close();
125
- }
126
- static async isValidPath(path) {
127
- return znp_1.Znp.isValidPath(path);
128
- }
129
- static async autoDetectPath() {
130
- return znp_1.Znp.autoDetectPath();
131
- }
132
- async getCoordinator() {
133
- return this.queue.execute(async () => {
134
- this.checkInterpanLock();
135
- const activeEpRsp = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'activeEpRsp');
136
- await this.znp.request(Subsystem.ZDO, 'activeEpReq', { dstaddr: 0, nwkaddrofinterest: 0 }, activeEpRsp.ID);
137
- const activeEp = await activeEpRsp.start().promise;
138
- const deviceInfo = await this.znp.request(Subsystem.UTIL, 'getDeviceInfo', {});
139
- const endpoints = [];
140
- for (const endpoint of activeEp.payload.activeeplist) {
141
- const simpleDescRsp = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'simpleDescRsp', { endpoint });
142
- await this.znp.request(Subsystem.ZDO, 'simpleDescReq', { dstaddr: 0, nwkaddrofinterest: 0, endpoint }, simpleDescRsp.ID);
143
- const simpleDesc = await simpleDescRsp.start().promise;
144
- endpoints.push({
145
- ID: simpleDesc.payload.endpoint,
146
- profileID: simpleDesc.payload.profileid,
147
- deviceID: simpleDesc.payload.deviceid,
148
- inputClusters: simpleDesc.payload.inclusterlist,
149
- outputClusters: simpleDesc.payload.outclusterlist,
150
- });
151
- }
152
- return {
153
- networkAddress: 0,
154
- manufacturerID: 0,
155
- ieeeAddr: deviceInfo.payload.ieeeaddr,
156
- endpoints,
157
- };
158
- });
159
- }
160
- async permitJoin(seconds, networkAddress) {
161
- const addrmode = networkAddress === null ? 0x0F : 0x02;
162
- const dstaddr = networkAddress || 0xFFFC;
163
- await this.queue.execute(async () => {
164
- this.checkInterpanLock();
165
- const payload = { addrmode, dstaddr, duration: seconds, tcsignificance: 0 };
166
- await this.znp.request(Subsystem.ZDO, 'mgmtPermitJoinReq', payload);
167
- await this.setLED(seconds == 0 ? 'off' : 'on');
168
- });
169
- }
170
- async getCoordinatorVersion() {
171
- return { type: tstype_1.ZnpVersion[this.version.product], meta: this.version };
172
- }
173
- async reset(type) {
174
- if (type === 'soft') {
175
- await this.znp.request(Subsystem.SYS, 'resetReq', { type: Constants.SYS.resetType.SOFT });
176
- }
177
- else {
178
- await this.znp.request(Subsystem.SYS, 'resetReq', { type: Constants.SYS.resetType.HARD });
179
- }
180
- }
181
- async setLED(action) {
182
- if (this.supportsLED == null) {
183
- // Only zStack3x0 with 20210430 and greater support LED
184
- const zStack3x0 = this.version.product === tstype_1.ZnpVersion.zStack3x0;
185
- this.supportsLED = !zStack3x0 || (zStack3x0 && parseInt(this.version.revision) >= 20210430);
186
- }
187
- if (!this.supportsLED || (this.adapterOptions.disableLED && action !== 'disable')) {
188
- return;
189
- }
190
- // Firmwares build on and after 20211029 should handle LED themselves
191
- const firmwareControlsLed = parseInt(this.version.revision) >= 20211029;
192
- const lookup = {
193
- 'disable': firmwareControlsLed ? { ledid: 0xFF, mode: 5 } : { ledid: 3, mode: 0 },
194
- 'on': firmwareControlsLed ? null : { ledid: 3, mode: 1 },
195
- 'off': firmwareControlsLed ? null : { ledid: 3, mode: 0 },
196
- };
197
- const payload = lookup[action];
198
- if (payload) {
199
- this.znp.request(Subsystem.UTIL, 'ledControl', payload, null, 500).catch(() => {
200
- // We cannot 100% correctly determine if an adapter supports LED. E.g. the zStack 1.2 20190608
201
- // fw supports led on the CC2531 but not on the CC2530. Therefore if a led request fails never thrown
202
- // an error but instead mark the led as unsupported.
203
- // https://github.com/Koenkk/zigbee-herdsman/issues/377
204
- // https://github.com/Koenkk/zigbee2mqtt/issues/7693
205
- this.supportsLED = false;
206
- });
207
- }
208
- }
209
- async requestNetworkAddress(ieeeAddr) {
210
- /**
211
- * NOTE: There are cases where multiple nwkAddrRsp are recevied with different network addresses,
212
- * this is currently not handled, the first nwkAddrRsp is taken.
213
- */
214
- debug("Request network address of '%s'", ieeeAddr);
215
- const response = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'nwkAddrRsp', { ieeeaddr: ieeeAddr });
216
- await this.znp.request(Subsystem.ZDO, 'nwkAddrReq', { ieeeaddr: ieeeAddr, reqtype: 0, startindex: 0 });
217
- const result = await response.start().promise;
218
- return result.payload.nwkaddr;
219
- }
220
- supportsAssocRemove() {
221
- return this.version.product === tstype_1.ZnpVersion.zStack3x0 && parseInt(this.version.revision) >= 20200805;
222
- }
223
- supportsAssocAdd() {
224
- return this.version.product === tstype_1.ZnpVersion.zStack3x0 && parseInt(this.version.revision) >= 20201026;
225
- }
226
- async discoverRoute(networkAddress, wait = true) {
227
- debug('Discovering route to %d', networkAddress);
228
- const payload = { dstAddr: networkAddress, options: 0, radius: Constants.AF.DEFAULT_RADIUS };
229
- await this.znp.request(Subsystem.ZDO, 'extRouteDisc', payload);
230
- if (wait) {
231
- await (0, utils_1.Wait)(3000);
232
- }
233
- }
234
- async nodeDescriptor(networkAddress) {
235
- return this.queue.execute(async () => {
236
- this.checkInterpanLock();
237
- try {
238
- const result = await this.nodeDescriptorInternal(networkAddress);
239
- return result;
240
- }
241
- catch (error) {
242
- debug(`Node descriptor request for '${networkAddress}' failed (${error}), retry`);
243
- // Doing a route discovery after simple descriptor request fails makes it succeed sometimes.
244
- // https://github.com/Koenkk/zigbee2mqtt/issues/3276
245
- await this.discoverRoute(networkAddress);
246
- const result = await this.nodeDescriptorInternal(networkAddress);
247
- return result;
248
- }
249
- }, networkAddress);
250
- }
251
- async nodeDescriptorInternal(networkAddress) {
252
- const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'nodeDescRsp', { nwkaddr: networkAddress });
253
- const payload = { dstaddr: networkAddress, nwkaddrofinterest: networkAddress };
254
- await this.znp.request(Subsystem.ZDO, 'nodeDescReq', payload, response.ID);
255
- const descriptor = await response.start().promise;
256
- let type = 'Unknown';
257
- const logicalType = descriptor.payload.logicaltype_cmplxdescavai_userdescavai & 0x07;
258
- for (const [key, value] of Object.entries(Constants.ZDO.deviceLogicalType)) {
259
- if (value === logicalType) {
260
- if (key === 'COORDINATOR')
261
- type = 'Coordinator';
262
- else if (key === 'ROUTER')
263
- type = 'Router';
264
- else if (key === 'ENDDEVICE')
265
- type = 'EndDevice';
266
- break;
267
- }
268
- }
269
- return { manufacturerCode: descriptor.payload.manufacturercode, type };
270
- }
271
- async activeEndpoints(networkAddress) {
272
- return this.queue.execute(async () => {
273
- this.checkInterpanLock();
274
- const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'activeEpRsp', { nwkaddr: networkAddress });
275
- const payload = { dstaddr: networkAddress, nwkaddrofinterest: networkAddress };
276
- await this.znp.request(Subsystem.ZDO, 'activeEpReq', payload, response.ID);
277
- const activeEp = await response.start().promise;
278
- return { endpoints: activeEp.payload.activeeplist };
279
- }, networkAddress);
280
- }
281
- async simpleDescriptor(networkAddress, endpointID) {
282
- return this.queue.execute(async () => {
283
- this.checkInterpanLock();
284
- const responsePayload = { nwkaddr: networkAddress, endpoint: endpointID };
285
- const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'simpleDescRsp', responsePayload);
286
- const payload = { dstaddr: networkAddress, nwkaddrofinterest: networkAddress, endpoint: endpointID };
287
- await this.znp.request(Subsystem.ZDO, 'simpleDescReq', payload, response.ID);
288
- const descriptor = await response.start().promise;
289
- return {
290
- profileID: descriptor.payload.profileid,
291
- endpointID: descriptor.payload.endpoint,
292
- deviceID: descriptor.payload.deviceid,
293
- inputClusters: descriptor.payload.inclusterlist,
294
- outputClusters: descriptor.payload.outclusterlist,
295
- };
296
- }, networkAddress);
297
- }
298
- async sendZclFrameToEndpoint(ieeeAddr, networkAddress, endpoint, zclFrame, timeout, disableResponse, disableRecovery, sourceEndpoint) {
299
- return this.queue.execute(async () => {
300
- this.checkInterpanLock();
301
- return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint || 1, zclFrame, timeout, disableResponse, disableRecovery, 0, 0, false, false, false, null);
302
- }, networkAddress);
303
- }
304
- async sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt, dataRequestAttempt, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore) {
305
- debug('sendZclFrameToEndpointInternal %s:%i/%i (%i,%i,%i)', ieeeAddr, networkAddress, endpoint, responseAttempt, dataRequestAttempt, this.queue.count());
306
- let response = null;
307
- const command = zclFrame.getCommand();
308
- if (command.hasOwnProperty('response') && disableResponse === false) {
309
- response = this.waitForInternal(networkAddress, endpoint, zclFrame.Header.frameControl.frameType, zcl_1.Direction.SERVER_TO_CLIENT, zclFrame.Header.transactionSequenceNumber, zclFrame.Cluster.ID, command.response, timeout);
310
- }
311
- else if (!zclFrame.Header.frameControl.disableDefaultResponse) {
312
- response = this.waitForInternal(networkAddress, endpoint, zcl_1.FrameType.GLOBAL, zcl_1.Direction.SERVER_TO_CLIENT, zclFrame.Header.transactionSequenceNumber, zclFrame.Cluster.ID, zcl_1.Foundation.defaultRsp.ID, timeout);
313
- }
314
- const dataConfirmResult = await this.dataRequest(networkAddress, endpoint, sourceEndpoint, zclFrame.Cluster.ID, Constants.AF.DEFAULT_RADIUS, zclFrame.toBuffer(), timeout);
315
- if (dataConfirmResult !== ZnpCommandStatus.SUCCESS) {
316
- // In case dataConfirm timesout (= null) or gives an error, try to recover
317
- debug('Data confirm error (%s:%d,%d,%d)', ieeeAddr, networkAddress, dataConfirmResult, dataRequestAttempt);
318
- if (response !== null)
319
- response.cancel();
320
- /**
321
- * In case we did an assocRemove in the previous attempt and it still fails after this, assume that the
322
- * coordinator is still the parent of the device (but for some reason the device is not available now).
323
- * Re-add the device to the assoc table, otherwise we will never be able to reach it anymore.
324
- */
325
- if (assocRemove && assocRestore && this.supportsAssocAdd()) {
326
- debug('assocAdd(%s)', assocRestore.ieeeadr);
327
- await this.znp.request(Subsystem.UTIL, 'assocAdd', assocRestore);
328
- assocRestore = null;
329
- }
330
- const recoverableErrors = [
331
- ZnpCommandStatus.NWK_NO_ROUTE, ZnpCommandStatus.MAC_NO_ACK, ZnpCommandStatus.MAC_CHANNEL_ACCESS_FAILURE,
332
- ZnpCommandStatus.MAC_TRANSACTION_EXPIRED, ZnpCommandStatus.BUFFER_FULL,
333
- ZnpCommandStatus.MAC_NO_RESOURCES,
334
- ];
335
- if (dataRequestAttempt >= 4 || !recoverableErrors.includes(dataConfirmResult) || disableRecovery) {
336
- throw new DataConfirmError(dataConfirmResult);
337
- }
338
- if (dataConfirmResult === ZnpCommandStatus.MAC_CHANNEL_ACCESS_FAILURE ||
339
- dataConfirmResult === ZnpCommandStatus.BUFFER_FULL ||
340
- dataConfirmResult === ZnpCommandStatus.MAC_NO_RESOURCES) {
341
- /**
342
- * MAC_CHANNEL_ACCESS_FAILURE: When many commands at once are executed we can end up in a MAC
343
- * channel access failure error. This is because there is too much traffic on the network.
344
- * Retry this command once after a cooling down period.
345
- * BUFFER_FULL: When many commands are executed at once the buffer can get full, wait
346
- * some time and retry.
347
- * MAC_NO_RESOURCES: Operation could not be completed because no memory resources are available,
348
- * wait some time and retry.
349
- */
350
- await (0, utils_1.Wait)(2000);
351
- return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt, dataRequestAttempt + 1, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore);
352
- }
353
- else {
354
- let doAssocRemove = false;
355
- if (!assocRemove && dataConfirmResult === ZnpCommandStatus.MAC_TRANSACTION_EXPIRED &&
356
- dataRequestAttempt >= 1 && this.supportsAssocRemove()) {
357
- const match = await this.znp.request(Subsystem.UTIL, 'assocGetWithAddress', { extaddr: ieeeAddr, nwkaddr: networkAddress });
358
- if (match.payload.nwkaddr !== 0xFFFE && match.payload.noderelation !== 255) {
359
- doAssocRemove = true;
360
- assocRestore =
361
- { ieeeadr: ieeeAddr, nwkaddr: networkAddress, noderelation: match.payload.noderelation };
362
- }
363
- assocRemove = true;
364
- }
365
- // NWK_NO_ROUTE: no network route => rediscover route
366
- // MAC_NO_ACK: route may be corrupted
367
- // MAC_TRANSACTION_EXPIRED: Mac layer is sleeping
368
- if (doAssocRemove) {
369
- /**
370
- * Since child aging is disabled on the firmware, when a end device is directly connected
371
- * to the coordinator and changes parent and the coordinator does not recevie this update,
372
- * it still thinks it's directly connected.
373
- * A discoverRoute() is not send out in this case, therefore remove it from the associated device
374
- * list and try again.
375
- * Note: assocRemove is a custom command, not available by default, only available on recent
376
- * z-stack-firmware firmware version. In case it's not supported by the coordinator we will
377
- * automatically timeout after 60000ms.
378
- */
379
- debug('assocRemove(%s)', ieeeAddr);
380
- await this.znp.request(Subsystem.UTIL, 'assocRemove', { ieeeadr: ieeeAddr });
381
- }
382
- else if (!discoveredRoute && dataRequestAttempt >= 1) {
383
- discoveredRoute = true;
384
- await this.discoverRoute(networkAddress);
385
- }
386
- else if (!checkedNetworkAddress && dataRequestAttempt >= 1) {
387
- // Figure out once if the network address has been changed.
388
- try {
389
- checkedNetworkAddress = true;
390
- const actualNetworkAddress = await this.requestNetworkAddress(ieeeAddr);
391
- if (networkAddress !== actualNetworkAddress) {
392
- debug(`Failed because request was done with wrong network address`);
393
- discoveredRoute = true;
394
- networkAddress = actualNetworkAddress;
395
- await this.discoverRoute(actualNetworkAddress);
396
- }
397
- else {
398
- debug('Network address did not change');
399
- }
400
- }
401
- catch (_a) { }
402
- }
403
- else {
404
- debug('Wait 2000ms');
405
- await (0, utils_1.Wait)(2000);
406
- }
407
- return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt, dataRequestAttempt + 1, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore);
408
- }
409
- }
410
- if (response !== null) {
411
- try {
412
- const result = await response.start().promise;
413
- return result;
414
- }
415
- catch (error) {
416
- debug('Response timeout (%s:%d,%d)', ieeeAddr, networkAddress, responseAttempt);
417
- if (responseAttempt < 1 && !disableRecovery) {
418
- // No response could be because the radio of the end device is turned off:
419
- // Sometimes the coordinator does not properly set the PENDING flag.
420
- // Try to rewrite the device entry in the association table, this fixes it sometimes.
421
- const match = await this.znp.request(Subsystem.UTIL, 'assocGetWithAddress', { extaddr: ieeeAddr, nwkaddr: networkAddress });
422
- debug(`Response timeout recovery: Node relation ${match.payload.noderelation} (${ieeeAddr} / ${match.payload.nwkaddr})`);
423
- if (this.supportsAssocAdd() && this.supportsAssocRemove() &&
424
- match.payload.nwkaddr !== 0xFFFE && match.payload.noderelation == 1) {
425
- debug(`Response timeout recovery: Rewrite association table entry (${ieeeAddr})`);
426
- await this.znp.request(Subsystem.UTIL, 'assocRemove', { ieeeadr: ieeeAddr });
427
- await this.znp.request(Subsystem.UTIL, 'assocAdd', { ieeeadr: ieeeAddr, nwkaddr: networkAddress, noderelation: match.payload.noderelation });
428
- }
429
- // No response could be of invalid route, e.g. when message is send to wrong parent of end device.
430
- await this.discoverRoute(networkAddress);
431
- return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt + 1, dataRequestAttempt, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore);
432
- }
433
- else {
434
- throw error;
435
- }
436
- }
437
- }
438
- else {
439
- return null;
440
- }
441
- }
442
- async sendZclFrameToGroup(groupID, zclFrame, sourceEndpoint) {
443
- return this.queue.execute(async () => {
444
- this.checkInterpanLock();
445
- await this.dataRequestExtended(AddressMode.ADDR_GROUP, groupID, 0xFF, 0, sourceEndpoint || 1, zclFrame.Cluster.ID, Constants.AF.DEFAULT_RADIUS, zclFrame.toBuffer(), 3000, true);
446
- /**
447
- * As a group command is not confirmed and thus immidiately returns
448
- * (contrary to network address requests) we will give the
449
- * command some time to 'settle' in the network.
450
- */
451
- await (0, utils_1.Wait)(200);
452
- });
453
- }
454
- async sendZclFrameToAll(endpoint, zclFrame, sourceEndpoint) {
455
- return this.queue.execute(async () => {
456
- this.checkInterpanLock();
457
- await this.dataRequestExtended(AddressMode.ADDR_16BIT, 0xFFFD, endpoint, 0, sourceEndpoint, zclFrame.Cluster.ID, Constants.AF.DEFAULT_RADIUS, zclFrame.toBuffer(), 3000, false, 0);
458
- /**
459
- * As a broadcast command is not confirmed and thus immidiately returns
460
- * (contrary to network address requests) we will give the
461
- * command some time to 'settle' in the network.
462
- */
463
- await (0, utils_1.Wait)(200);
464
- });
465
- }
466
- async lqi(networkAddress) {
467
- return this.queue.execute(async () => {
468
- this.checkInterpanLock();
469
- const neighbors = [];
470
- // eslint-disable-next-line
471
- const request = async (startIndex) => {
472
- const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'mgmtLqiRsp', { srcaddr: networkAddress });
473
- await this.znp.request(Subsystem.ZDO, 'mgmtLqiReq', { dstaddr: networkAddress, startindex: startIndex }, response.ID);
474
- const result = await response.start().promise;
475
- if (result.payload.status !== ZnpCommandStatus.SUCCESS) {
476
- throw new Error(`LQI for '${networkAddress}' failed with error: '${ZnpCommandStatus[result.payload.status]}' (${result.payload.status})`);
477
- }
478
- return result;
479
- };
480
- // eslint-disable-next-line
481
- const add = (list) => {
482
- for (const entry of list) {
483
- neighbors.push({
484
- linkquality: entry.lqi,
485
- networkAddress: entry.nwkAddr,
486
- ieeeAddr: entry.extAddr,
487
- relationship: entry.relationship,
488
- depth: entry.depth,
489
- });
490
- }
491
- };
492
- let response = await request(0);
493
- add(response.payload.neighborlqilist);
494
- const size = response.payload.neighbortableentries;
495
- let nextStartIndex = response.payload.neighborlqilist.length;
496
- while (neighbors.length < size) {
497
- response = await request(nextStartIndex);
498
- add(response.payload.neighborlqilist);
499
- nextStartIndex += response.payload.neighborlqilist.length;
500
- }
501
- return { neighbors };
502
- }, networkAddress);
503
- }
504
- async routingTable(networkAddress) {
505
- return this.queue.execute(async () => {
506
- this.checkInterpanLock();
507
- const table = [];
508
- // eslint-disable-next-line
509
- const request = async (startIndex) => {
510
- const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'mgmtRtgRsp', { srcaddr: networkAddress });
511
- await this.znp.request(Subsystem.ZDO, 'mgmtRtgReq', { dstaddr: networkAddress, startindex: startIndex }, response.ID);
512
- const result = await response.start().promise;
513
- if (result.payload.status !== ZnpCommandStatus.SUCCESS) {
514
- throw new Error(`Routing table for '${networkAddress}' failed with error: '${ZnpCommandStatus[result.payload.status]}' (${result.payload.status})`);
515
- }
516
- return result;
517
- };
518
- // eslint-disable-next-line
519
- const add = (list) => {
520
- for (const entry of list) {
521
- table.push({
522
- destinationAddress: entry.destNwkAddr,
523
- status: entry.routeStatus,
524
- nextHop: entry.nextHopNwkAddr,
525
- });
526
- }
527
- };
528
- let response = await request(0);
529
- add(response.payload.routingtablelist);
530
- const size = response.payload.routingtableentries;
531
- let nextStartIndex = response.payload.routingtablelist.length;
532
- while (table.length < size) {
533
- response = await request(nextStartIndex);
534
- add(response.payload.routingtablelist);
535
- nextStartIndex += response.payload.routingtablelist.length;
536
- }
537
- return { table };
538
- }, networkAddress);
539
- }
540
- async addInstallCode(ieeeAddress, key) {
541
- (0, assert_1.default)(this.version.product !== tstype_1.ZnpVersion.zStack12, 'Install code is not supported for ZStack 1.2 adapter');
542
- const payload = { installCodeFormat: key.length === 18 ? 1 : 2, ieeeaddr: ieeeAddress, installCode: key };
543
- await this.znp.request(Subsystem.APP_CNF, 'bdbAddInstallCode', payload);
544
- }
545
- async bind(destinationNetworkAddress, sourceIeeeAddress, sourceEndpoint, clusterID, destinationAddressOrGroup, type, destinationEndpoint) {
546
- return this.queue.execute(async () => {
547
- this.checkInterpanLock();
548
- const responsePayload = { srcaddr: destinationNetworkAddress };
549
- const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'bindRsp', responsePayload);
550
- const payload = {
551
- dstaddr: destinationNetworkAddress,
552
- srcaddr: sourceIeeeAddress,
553
- srcendpoint: sourceEndpoint,
554
- clusterid: clusterID,
555
- dstaddrmode: type === 'group' ?
556
- AddressMode.ADDR_GROUP : AddressMode.ADDR_64BIT,
557
- dstaddress: this.toAddressString(destinationAddressOrGroup),
558
- dstendpoint: type === 'group' ? 0xFF : destinationEndpoint,
559
- };
560
- await this.znp.request(Subsystem.ZDO, 'bindReq', payload, response.ID);
561
- await response.start().promise;
562
- }, destinationNetworkAddress);
563
- }
564
- async unbind(destinationNetworkAddress, sourceIeeeAddress, sourceEndpoint, clusterID, destinationAddressOrGroup, type, destinationEndpoint) {
565
- return this.queue.execute(async () => {
566
- this.checkInterpanLock();
567
- const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'unbindRsp', { srcaddr: destinationNetworkAddress });
568
- const payload = {
569
- dstaddr: destinationNetworkAddress,
570
- srcaddr: sourceIeeeAddress,
571
- srcendpoint: sourceEndpoint,
572
- clusterid: clusterID,
573
- dstaddrmode: type === 'group' ?
574
- AddressMode.ADDR_GROUP : AddressMode.ADDR_64BIT,
575
- dstaddress: this.toAddressString(destinationAddressOrGroup),
576
- dstendpoint: type === 'group' ? 0xFF : destinationEndpoint,
577
- };
578
- await this.znp.request(Subsystem.ZDO, 'unbindReq', payload, response.ID);
579
- await response.start().promise;
580
- }, destinationNetworkAddress);
581
- }
582
- removeDevice(networkAddress, ieeeAddr) {
583
- return this.queue.execute(async () => {
584
- this.checkInterpanLock();
585
- const response = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'mgmtLeaveRsp', { srcaddr: networkAddress });
586
- const payload = {
587
- dstaddr: networkAddress,
588
- deviceaddress: ieeeAddr,
589
- removechildrenRejoin: 0,
590
- };
591
- await this.znp.request(Subsystem.ZDO, 'mgmtLeaveReq', payload, response.ID);
592
- await response.start().promise;
593
- }, networkAddress);
594
- }
595
- /**
596
- * Event handlers
597
- */
598
- onZnpClose() {
599
- if (!this.closing) {
600
- this.emit(Events.Events.disconnected);
601
- }
602
- }
603
- onZnpRecieved(object) {
604
- if (object.type !== unpi_1.Constants.Type.AREQ) {
605
- return;
606
- }
607
- if (object.subsystem === Subsystem.ZDO) {
608
- if (object.command === 'tcDeviceInd') {
609
- const payload = {
610
- networkAddress: object.payload.nwkaddr,
611
- ieeeAddr: object.payload.extaddr,
612
- };
613
- this.emit(Events.Events.deviceJoined, payload);
614
- }
615
- else if (object.command === 'endDeviceAnnceInd') {
616
- const payload = {
617
- networkAddress: object.payload.nwkaddr,
618
- ieeeAddr: object.payload.ieeeaddr,
619
- };
620
- // Only discover routes to end devices, if bit 1 of capabilities === 0 it's an end device.
621
- const isEndDevice = (object.payload.capabilities & 1 << 1) === 0;
622
- if (isEndDevice) {
623
- if (!this.deviceAnnounceRouteDiscoveryDebouncers.has(payload.networkAddress)) {
624
- // If a device announces multiple times in a very short time, it makes no sense
625
- // to rediscover the route every time.
626
- const debouncer = (0, debounce_1.default)(() => {
627
- this.queue.execute(async () => {
628
- /* istanbul ignore next */
629
- this.discoverRoute(payload.networkAddress, false).catch(() => { });
630
- }, payload.networkAddress);
631
- }, 60 * 1000, true);
632
- this.deviceAnnounceRouteDiscoveryDebouncers.set(payload.networkAddress, debouncer);
633
- }
634
- this.deviceAnnounceRouteDiscoveryDebouncers.get(payload.networkAddress)();
635
- }
636
- this.emit(Events.Events.deviceAnnounce, payload);
637
- }
638
- else if (object.command === 'nwkAddrRsp') {
639
- const payload = {
640
- networkAddress: object.payload.nwkaddr,
641
- ieeeAddr: object.payload.ieeeaddr,
642
- };
643
- this.emit(Events.Events.networkAddress, payload);
644
- }
645
- else {
646
- /* istanbul ignore else */
647
- if (object.command === 'leaveInd') {
648
- const payload = {
649
- networkAddress: object.payload.srcaddr,
650
- ieeeAddr: object.payload.extaddr,
651
- };
652
- this.emit(Events.Events.deviceLeave, payload);
653
- }
654
- }
655
- }
656
- else {
657
- /* istanbul ignore else */
658
- if (object.subsystem === Subsystem.AF) {
659
- /* istanbul ignore else */
660
- if (object.command === 'incomingMsg' || object.command === 'incomingMsgExt') {
661
- try {
662
- const payload = {
663
- frame: zcl_1.ZclFrame.fromBuffer(object.payload.clusterid, object.payload.data),
664
- address: object.payload.srcaddr,
665
- endpoint: object.payload.srcendpoint,
666
- linkquality: object.payload.linkquality,
667
- groupID: object.payload.groupid,
668
- wasBroadcast: object.payload.wasbroadcast === 1,
669
- destinationEndpoint: object.payload.dstendpoint,
670
- };
671
- this.waitress.resolve(payload);
672
- this.emit(Events.Events.zclData, payload);
673
- }
674
- catch (error) {
675
- const payload = {
676
- clusterID: object.payload.clusterid,
677
- data: object.payload.data,
678
- address: object.payload.srcaddr,
679
- endpoint: object.payload.srcendpoint,
680
- linkquality: object.payload.linkquality,
681
- groupID: object.payload.groupid,
682
- wasBroadcast: object.payload.wasbroadcast === 1,
683
- destinationEndpoint: object.payload.dstendpoint,
684
- };
685
- this.emit(Events.Events.rawData, payload);
686
- }
687
- }
688
- }
689
- }
690
- }
691
- async getNetworkParameters() {
692
- const result = await this.znp.request(Subsystem.ZDO, 'extNwkInfo', {});
693
- return {
694
- panID: result.payload.panid, extendedPanID: result.payload.extendedpanid,
695
- channel: result.payload.channel
696
- };
697
- }
698
- async supportsBackup() {
699
- return true;
700
- }
701
- async backup(ieeeAddressesInDatabase) {
702
- return this.adapterManager.backup.createBackup(ieeeAddressesInDatabase);
703
- }
704
- async setChannelInterPAN(channel) {
705
- return this.queue.execute(async () => {
706
- this.interpanLock = true;
707
- await this.znp.request(Subsystem.AF, 'interPanCtl', { cmd: 1, data: [channel] });
708
- if (!this.interpanEndpointRegistered) {
709
- // Make sure that endpoint 12 is registered to proxy the InterPAN messages.
710
- await this.znp.request(Subsystem.AF, 'interPanCtl', { cmd: 2, data: [12] });
711
- this.interpanEndpointRegistered = true;
712
- }
713
- });
714
- }
715
- async sendZclFrameInterPANToIeeeAddr(zclFrame, ieeeAddr) {
716
- return this.queue.execute(async () => {
717
- await this.dataRequestExtended(AddressMode.ADDR_64BIT, ieeeAddr, 0xFE, 0xFFFF, 12, zclFrame.Cluster.ID, 30, zclFrame.toBuffer(), 10000, false);
718
- });
719
- }
720
- async sendZclFrameInterPANBroadcast(zclFrame, timeout) {
721
- return this.queue.execute(async () => {
722
- const command = zclFrame.getCommand();
723
- if (!command.hasOwnProperty('response')) {
724
- throw new Error(`Command '${command.name}' has no response, cannot wait for response`);
725
- }
726
- const response = this.waitForInternal(null, 0xFE, zclFrame.Header.frameControl.frameType, zcl_1.Direction.SERVER_TO_CLIENT, null, zclFrame.Cluster.ID, command.response, timeout);
727
- try {
728
- await this.dataRequestExtended(AddressMode.ADDR_16BIT, 0xFFFF, 0xFE, 0xFFFF, 12, zclFrame.Cluster.ID, 30, zclFrame.toBuffer(), 10000, false);
729
- }
730
- catch (error) {
731
- response.cancel();
732
- throw error;
733
- }
734
- return response.start().promise;
735
- });
736
- }
737
- async restoreChannelInterPAN() {
738
- return this.queue.execute(async () => {
739
- await this.znp.request(Subsystem.AF, 'interPanCtl', { cmd: 0, data: [] });
740
- // Give adapter some time to restore, otherwise stuff crashes
741
- await (0, utils_1.Wait)(3000);
742
- this.interpanLock = false;
743
- });
744
- }
745
- async setTransmitPower(value) {
746
- return this.queue.execute(async () => {
747
- await this.znp.request(Subsystem.SYS, 'stackTune', { operation: 0, value });
748
- });
749
- }
750
- waitForInternal(networkAddress, endpoint, frameType, direction, transactionSequenceNumber, clusterID, commandIdentifier, timeout) {
751
- const payload = {
752
- address: networkAddress, endpoint, clusterID, commandIdentifier, frameType, direction,
753
- transactionSequenceNumber,
754
- };
755
- const waiter = this.waitress.waitFor(payload, timeout);
756
- const cancel = () => this.waitress.remove(waiter.ID);
757
- return { start: waiter.start, cancel };
758
- }
759
- waitFor(networkAddress, endpoint, frameType, direction, transactionSequenceNumber, clusterID, commandIdentifier, timeout) {
760
- const waiter = this.waitForInternal(networkAddress, endpoint, frameType, direction, transactionSequenceNumber, clusterID, commandIdentifier, timeout);
761
- return { cancel: waiter.cancel, promise: waiter.start().promise };
762
- }
763
- /**
764
- * Private methods
765
- */
766
- async dataRequest(destinationAddress, destinationEndpoint, sourceEndpoint, clusterID, radius, data, timeout) {
767
- const transactionID = this.nextTransactionID();
768
- const response = this.znp.waitFor(Type.AREQ, Subsystem.AF, 'dataConfirm', { transid: transactionID }, timeout);
769
- await this.znp.request(Subsystem.AF, 'dataRequest', {
770
- dstaddr: destinationAddress,
771
- destendpoint: destinationEndpoint,
772
- srcendpoint: sourceEndpoint,
773
- clusterid: clusterID,
774
- transid: transactionID,
775
- options: 0,
776
- radius: radius,
777
- len: data.length,
778
- data: data,
779
- }, response.ID);
780
- let result = null;
781
- try {
782
- const dataConfirm = await response.start().promise;
783
- result = dataConfirm.payload.status;
784
- }
785
- catch (_a) {
786
- result = DataConfirmTimeout;
787
- }
788
- return result;
789
- }
790
- async dataRequestExtended(addressMode, destinationAddressOrGroupID, destinationEndpoint, panID, sourceEndpoint, clusterID, radius, data, timeout, confirmation, attemptsLeft = 5) {
791
- const transactionID = this.nextTransactionID();
792
- const response = confirmation ?
793
- this.znp.waitFor(Type.AREQ, Subsystem.AF, 'dataConfirm', { transid: transactionID }, timeout) : null;
794
- await this.znp.request(Subsystem.AF, 'dataRequestExt', {
795
- dstaddrmode: addressMode,
796
- dstaddr: this.toAddressString(destinationAddressOrGroupID),
797
- destendpoint: destinationEndpoint,
798
- dstpanid: panID,
799
- srcendpoint: sourceEndpoint,
800
- clusterid: clusterID,
801
- transid: transactionID,
802
- options: 0,
803
- radius,
804
- len: data.length,
805
- data: data,
806
- }, response ? response.ID : null);
807
- if (confirmation) {
808
- const dataConfirm = await response.start().promise;
809
- if (dataConfirm.payload.status !== ZnpCommandStatus.SUCCESS) {
810
- if (attemptsLeft > 0 &&
811
- (dataConfirm.payload.status === ZnpCommandStatus.MAC_CHANNEL_ACCESS_FAILURE ||
812
- dataConfirm.payload.status === ZnpCommandStatus.BUFFER_FULL)) {
813
- /**
814
- * 225: When many commands at once are executed we can end up in a MAC channel access failure
815
- * error. This is because there is too much traffic on the network.
816
- * Retry this command once after a cooling down period.
817
- */
818
- await (0, utils_1.Wait)(2000);
819
- return this.dataRequestExtended(addressMode, destinationAddressOrGroupID, destinationEndpoint, panID, sourceEndpoint, clusterID, radius, data, timeout, confirmation, attemptsLeft - 1);
820
- }
821
- else {
822
- throw new DataConfirmError(dataConfirm.payload.status);
823
- }
824
- }
825
- return dataConfirm;
826
- }
827
- }
828
- nextTransactionID() {
829
- this.transactionID++;
830
- if (this.transactionID > 255) {
831
- this.transactionID = 1;
832
- }
833
- return this.transactionID;
834
- }
835
- toAddressString(address) {
836
- if (typeof address === 'number') {
837
- let addressString = address.toString(16);
838
- for (let i = addressString.length; i < 16; i++) {
839
- addressString = '0' + addressString;
840
- }
841
- return `0x${addressString}`;
842
- }
843
- else {
844
- return address.toString();
845
- }
846
- }
847
- waitressTimeoutFormatter(matcher, timeout) {
848
- return `Timeout - ${matcher.address} - ${matcher.endpoint}` +
849
- ` - ${matcher.transactionSequenceNumber} - ${matcher.clusterID}` +
850
- ` - ${matcher.commandIdentifier} after ${timeout}ms`;
851
- }
852
- waitressValidator(payload, matcher) {
853
- const transactionSequenceNumber = payload.frame.Header.transactionSequenceNumber;
854
- return (!matcher.address || payload.address === matcher.address) &&
855
- payload.endpoint === matcher.endpoint &&
856
- (!matcher.transactionSequenceNumber || transactionSequenceNumber === matcher.transactionSequenceNumber) &&
857
- payload.frame.Cluster.ID === matcher.clusterID &&
858
- matcher.frameType === payload.frame.Header.frameControl.frameType &&
859
- matcher.commandIdentifier === payload.frame.Header.commandIdentifier &&
860
- matcher.direction === payload.frame.Header.frameControl.direction;
861
- }
862
- checkInterpanLock() {
863
- if (this.interpanLock) {
864
- throw new Error(`Cannot execute command, in Inter-PAN mode`);
865
- }
866
- }
867
- }
868
- exports.default = ZStackAdapter;
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || function (mod) {
19
+ if (mod && mod.__esModule) return mod;
20
+ var result = {};
21
+ if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
22
+ __setModuleDefault(result, mod);
23
+ return result;
24
+ };
25
+ var __importDefault = (this && this.__importDefault) || function (mod) {
26
+ return (mod && mod.__esModule) ? mod : { "default": mod };
27
+ };
28
+ Object.defineProperty(exports, "__esModule", { value: true });
29
+ const tstype_1 = require("./tstype");
30
+ const Events = __importStar(require("../../events"));
31
+ const adapter_1 = __importDefault(require("../../adapter"));
32
+ const znp_1 = require("../znp");
33
+ const unpi_1 = require("../unpi");
34
+ const zcl_1 = require("../../../zcl");
35
+ const utils_1 = require("../../../utils");
36
+ const Constants = __importStar(require("../constants"));
37
+ const debug_1 = __importDefault(require("debug"));
38
+ const debounce_1 = __importDefault(require("debounce"));
39
+ const manager_1 = require("./manager");
40
+ const assert_1 = __importDefault(require("assert"));
41
+ const debug = (0, debug_1.default)("zigbee-herdsman:adapter:zStack:adapter");
42
+ const Subsystem = unpi_1.Constants.Subsystem;
43
+ const Type = unpi_1.Constants.Type;
44
+ const { ZnpCommandStatus, AddressMode } = Constants.COMMON;
45
+ const DataConfirmTimeout = 9999; // Not an actual code
46
+ const DataConfirmErrorCodeLookup = {
47
+ [DataConfirmTimeout]: 'Timeout',
48
+ 26: 'MAC no resources',
49
+ 183: 'APS no ack',
50
+ 205: 'No network route',
51
+ 225: 'MAC channel access failure',
52
+ 233: 'MAC no ack',
53
+ 240: 'MAC transaction expired',
54
+ };
55
+ class DataConfirmError extends Error {
56
+ code;
57
+ constructor(code) {
58
+ const message = `Data request failed with error: '${DataConfirmErrorCodeLookup[code]}' (${code})`;
59
+ super(message);
60
+ this.code = code;
61
+ }
62
+ }
63
+ class ZStackAdapter extends adapter_1.default {
64
+ deviceAnnounceRouteDiscoveryDebouncers;
65
+ znp;
66
+ adapterManager;
67
+ transactionID;
68
+ version;
69
+ closing;
70
+ queue;
71
+ supportsLED = null;
72
+ interpanLock;
73
+ interpanEndpointRegistered;
74
+ waitress;
75
+ constructor(networkOptions, serialPortOptions, backupPath, adapterOptions, logger) {
76
+ super(networkOptions, serialPortOptions, backupPath, adapterOptions, logger);
77
+ this.znp = new znp_1.Znp(this.serialPortOptions.path, this.serialPortOptions.baudRate, this.serialPortOptions.rtscts);
78
+ this.transactionID = 0;
79
+ this.deviceAnnounceRouteDiscoveryDebouncers = new Map();
80
+ this.interpanLock = false;
81
+ this.interpanEndpointRegistered = false;
82
+ this.closing = false;
83
+ this.waitress = new utils_1.Waitress(this.waitressValidator, this.waitressTimeoutFormatter);
84
+ this.znp.on('received', this.onZnpRecieved.bind(this));
85
+ this.znp.on('close', this.onZnpClose.bind(this));
86
+ }
87
+ /**
88
+ * Adapter methods
89
+ */
90
+ async start() {
91
+ await this.znp.open();
92
+ const attempts = 3;
93
+ for (let i = 0; i < attempts; i++) {
94
+ try {
95
+ await this.znp.request(Subsystem.SYS, 'ping', { capabilities: 1 });
96
+ break;
97
+ }
98
+ catch (e) {
99
+ if (attempts - 1 === i) {
100
+ throw new Error(`Failed to connect to the adapter (${e})`);
101
+ }
102
+ }
103
+ }
104
+ // Old firmware did not support version, assume it's Z-Stack 1.2 for now.
105
+ try {
106
+ this.version = (await this.znp.request(Subsystem.SYS, 'version', {})).payload;
107
+ }
108
+ catch (e) {
109
+ debug(`Failed to get zStack version, assuming 1.2`);
110
+ this.version = { "transportrev": 2, "product": 0, "majorrel": 2, "minorrel": 0, "maintrel": 0, "revision": "" };
111
+ }
112
+ const concurrent = this.adapterOptions && this.adapterOptions.concurrent ?
113
+ this.adapterOptions.concurrent :
114
+ (this.version.product === tstype_1.ZnpVersion.zStack3x0 ? 16 : 2);
115
+ debug(`Adapter concurrent: ${concurrent}`);
116
+ this.queue = new utils_1.Queue(concurrent);
117
+ debug(`Detected znp version '${tstype_1.ZnpVersion[this.version.product]}' (${JSON.stringify(this.version)})`);
118
+ this.adapterManager = new manager_1.ZnpAdapterManager(this.znp, {
119
+ backupPath: this.backupPath,
120
+ version: this.version.product,
121
+ greenPowerGroup: this.greenPowerGroup,
122
+ networkOptions: this.networkOptions,
123
+ adapterOptions: this.adapterOptions,
124
+ }, this.logger);
125
+ const startResult = this.adapterManager.start();
126
+ if (this.adapterOptions.disableLED) {
127
+ // Wait a bit for adapter to startup, otherwise led doesn't disable (tested with CC2531)
128
+ await (0, utils_1.Wait)(200);
129
+ await this.setLED('disable');
130
+ }
131
+ return startResult;
132
+ }
133
+ async stop() {
134
+ this.closing = true;
135
+ await this.znp.close();
136
+ }
137
+ static async isValidPath(path) {
138
+ return znp_1.Znp.isValidPath(path);
139
+ }
140
+ static async autoDetectPath() {
141
+ return znp_1.Znp.autoDetectPath();
142
+ }
143
+ async getCoordinator() {
144
+ return this.queue.execute(async () => {
145
+ this.checkInterpanLock();
146
+ const activeEpRsp = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'activeEpRsp');
147
+ await this.znp.request(Subsystem.ZDO, 'activeEpReq', { dstaddr: 0, nwkaddrofinterest: 0 }, activeEpRsp.ID);
148
+ const activeEp = await activeEpRsp.start().promise;
149
+ const deviceInfo = await this.znp.request(Subsystem.UTIL, 'getDeviceInfo', {});
150
+ const endpoints = [];
151
+ for (const endpoint of activeEp.payload.activeeplist) {
152
+ const simpleDescRsp = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'simpleDescRsp', { endpoint });
153
+ await this.znp.request(Subsystem.ZDO, 'simpleDescReq', { dstaddr: 0, nwkaddrofinterest: 0, endpoint }, simpleDescRsp.ID);
154
+ const simpleDesc = await simpleDescRsp.start().promise;
155
+ endpoints.push({
156
+ ID: simpleDesc.payload.endpoint,
157
+ profileID: simpleDesc.payload.profileid,
158
+ deviceID: simpleDesc.payload.deviceid,
159
+ inputClusters: simpleDesc.payload.inclusterlist,
160
+ outputClusters: simpleDesc.payload.outclusterlist,
161
+ });
162
+ }
163
+ return {
164
+ networkAddress: 0,
165
+ manufacturerID: 0,
166
+ ieeeAddr: deviceInfo.payload.ieeeaddr,
167
+ endpoints,
168
+ };
169
+ });
170
+ }
171
+ async permitJoin(seconds, networkAddress) {
172
+ const addrmode = networkAddress === null ? 0x0F : 0x02;
173
+ const dstaddr = networkAddress || 0xFFFC;
174
+ await this.queue.execute(async () => {
175
+ this.checkInterpanLock();
176
+ const payload = { addrmode, dstaddr, duration: seconds, tcsignificance: 0 };
177
+ await this.znp.request(Subsystem.ZDO, 'mgmtPermitJoinReq', payload);
178
+ await this.setLED(seconds == 0 ? 'off' : 'on');
179
+ });
180
+ }
181
+ async getCoordinatorVersion() {
182
+ return { type: tstype_1.ZnpVersion[this.version.product], meta: this.version };
183
+ }
184
+ async reset(type) {
185
+ if (type === 'soft') {
186
+ await this.znp.request(Subsystem.SYS, 'resetReq', { type: Constants.SYS.resetType.SOFT });
187
+ }
188
+ else {
189
+ await this.znp.request(Subsystem.SYS, 'resetReq', { type: Constants.SYS.resetType.HARD });
190
+ }
191
+ }
192
+ async setLED(action) {
193
+ if (this.supportsLED == null) {
194
+ // Only zStack3x0 with 20210430 and greater support LED
195
+ const zStack3x0 = this.version.product === tstype_1.ZnpVersion.zStack3x0;
196
+ this.supportsLED = !zStack3x0 || (zStack3x0 && parseInt(this.version.revision) >= 20210430);
197
+ }
198
+ if (!this.supportsLED || (this.adapterOptions.disableLED && action !== 'disable')) {
199
+ return;
200
+ }
201
+ // Firmwares build on and after 20211029 should handle LED themselves
202
+ const firmwareControlsLed = parseInt(this.version.revision) >= 20211029;
203
+ const lookup = {
204
+ 'disable': firmwareControlsLed ? { ledid: 0xFF, mode: 5 } : { ledid: 3, mode: 0 },
205
+ 'on': firmwareControlsLed ? null : { ledid: 3, mode: 1 },
206
+ 'off': firmwareControlsLed ? null : { ledid: 3, mode: 0 },
207
+ };
208
+ const payload = lookup[action];
209
+ if (payload) {
210
+ this.znp.request(Subsystem.UTIL, 'ledControl', payload, null, 500).catch(() => {
211
+ // We cannot 100% correctly determine if an adapter supports LED. E.g. the zStack 1.2 20190608
212
+ // fw supports led on the CC2531 but not on the CC2530. Therefore if a led request fails never thrown
213
+ // an error but instead mark the led as unsupported.
214
+ // https://github.com/Koenkk/zigbee-herdsman/issues/377
215
+ // https://github.com/Koenkk/zigbee2mqtt/issues/7693
216
+ this.supportsLED = false;
217
+ });
218
+ }
219
+ }
220
+ async requestNetworkAddress(ieeeAddr) {
221
+ /**
222
+ * NOTE: There are cases where multiple nwkAddrRsp are recevied with different network addresses,
223
+ * this is currently not handled, the first nwkAddrRsp is taken.
224
+ */
225
+ debug("Request network address of '%s'", ieeeAddr);
226
+ const response = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'nwkAddrRsp', { ieeeaddr: ieeeAddr });
227
+ await this.znp.request(Subsystem.ZDO, 'nwkAddrReq', { ieeeaddr: ieeeAddr, reqtype: 0, startindex: 0 });
228
+ const result = await response.start().promise;
229
+ return result.payload.nwkaddr;
230
+ }
231
+ supportsAssocRemove() {
232
+ return this.version.product === tstype_1.ZnpVersion.zStack3x0 && parseInt(this.version.revision) >= 20200805;
233
+ }
234
+ supportsAssocAdd() {
235
+ return this.version.product === tstype_1.ZnpVersion.zStack3x0 && parseInt(this.version.revision) >= 20201026;
236
+ }
237
+ async discoverRoute(networkAddress, wait = true) {
238
+ debug('Discovering route to %d', networkAddress);
239
+ const payload = { dstAddr: networkAddress, options: 0, radius: Constants.AF.DEFAULT_RADIUS };
240
+ await this.znp.request(Subsystem.ZDO, 'extRouteDisc', payload);
241
+ if (wait) {
242
+ await (0, utils_1.Wait)(3000);
243
+ }
244
+ }
245
+ async nodeDescriptor(networkAddress) {
246
+ return this.queue.execute(async () => {
247
+ this.checkInterpanLock();
248
+ try {
249
+ const result = await this.nodeDescriptorInternal(networkAddress);
250
+ return result;
251
+ }
252
+ catch (error) {
253
+ debug(`Node descriptor request for '${networkAddress}' failed (${error}), retry`);
254
+ // Doing a route discovery after simple descriptor request fails makes it succeed sometimes.
255
+ // https://github.com/Koenkk/zigbee2mqtt/issues/3276
256
+ await this.discoverRoute(networkAddress);
257
+ const result = await this.nodeDescriptorInternal(networkAddress);
258
+ return result;
259
+ }
260
+ }, networkAddress);
261
+ }
262
+ async nodeDescriptorInternal(networkAddress) {
263
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'nodeDescRsp', { nwkaddr: networkAddress });
264
+ const payload = { dstaddr: networkAddress, nwkaddrofinterest: networkAddress };
265
+ await this.znp.request(Subsystem.ZDO, 'nodeDescReq', payload, response.ID);
266
+ const descriptor = await response.start().promise;
267
+ let type = 'Unknown';
268
+ const logicalType = descriptor.payload.logicaltype_cmplxdescavai_userdescavai & 0x07;
269
+ for (const [key, value] of Object.entries(Constants.ZDO.deviceLogicalType)) {
270
+ if (value === logicalType) {
271
+ if (key === 'COORDINATOR')
272
+ type = 'Coordinator';
273
+ else if (key === 'ROUTER')
274
+ type = 'Router';
275
+ else if (key === 'ENDDEVICE')
276
+ type = 'EndDevice';
277
+ break;
278
+ }
279
+ }
280
+ return { manufacturerCode: descriptor.payload.manufacturercode, type };
281
+ }
282
+ async activeEndpoints(networkAddress) {
283
+ return this.queue.execute(async () => {
284
+ this.checkInterpanLock();
285
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'activeEpRsp', { nwkaddr: networkAddress });
286
+ const payload = { dstaddr: networkAddress, nwkaddrofinterest: networkAddress };
287
+ await this.znp.request(Subsystem.ZDO, 'activeEpReq', payload, response.ID);
288
+ const activeEp = await response.start().promise;
289
+ return { endpoints: activeEp.payload.activeeplist };
290
+ }, networkAddress);
291
+ }
292
+ async simpleDescriptor(networkAddress, endpointID) {
293
+ return this.queue.execute(async () => {
294
+ this.checkInterpanLock();
295
+ const responsePayload = { nwkaddr: networkAddress, endpoint: endpointID };
296
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'simpleDescRsp', responsePayload);
297
+ const payload = { dstaddr: networkAddress, nwkaddrofinterest: networkAddress, endpoint: endpointID };
298
+ await this.znp.request(Subsystem.ZDO, 'simpleDescReq', payload, response.ID);
299
+ const descriptor = await response.start().promise;
300
+ return {
301
+ profileID: descriptor.payload.profileid,
302
+ endpointID: descriptor.payload.endpoint,
303
+ deviceID: descriptor.payload.deviceid,
304
+ inputClusters: descriptor.payload.inclusterlist,
305
+ outputClusters: descriptor.payload.outclusterlist,
306
+ };
307
+ }, networkAddress);
308
+ }
309
+ async sendZclFrameToEndpoint(ieeeAddr, networkAddress, endpoint, zclFrame, timeout, disableResponse, disableRecovery, sourceEndpoint) {
310
+ return this.queue.execute(async () => {
311
+ this.checkInterpanLock();
312
+ return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint || 1, zclFrame, timeout, disableResponse, disableRecovery, 0, 0, false, false, false, null);
313
+ }, networkAddress);
314
+ }
315
+ async sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt, dataRequestAttempt, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore) {
316
+ debug('sendZclFrameToEndpointInternal %s:%i/%i (%i,%i,%i)', ieeeAddr, networkAddress, endpoint, responseAttempt, dataRequestAttempt, this.queue.count());
317
+ let response = null;
318
+ const command = zclFrame.getCommand();
319
+ if (command.hasOwnProperty('response') && disableResponse === false) {
320
+ response = this.waitForInternal(networkAddress, endpoint, zclFrame.Header.frameControl.frameType, zcl_1.Direction.SERVER_TO_CLIENT, zclFrame.Header.transactionSequenceNumber, zclFrame.Cluster.ID, command.response, timeout);
321
+ }
322
+ else if (!zclFrame.Header.frameControl.disableDefaultResponse) {
323
+ response = this.waitForInternal(networkAddress, endpoint, zcl_1.FrameType.GLOBAL, zcl_1.Direction.SERVER_TO_CLIENT, zclFrame.Header.transactionSequenceNumber, zclFrame.Cluster.ID, zcl_1.Foundation.defaultRsp.ID, timeout);
324
+ }
325
+ const dataConfirmResult = await this.dataRequest(networkAddress, endpoint, sourceEndpoint, zclFrame.Cluster.ID, Constants.AF.DEFAULT_RADIUS, zclFrame.toBuffer(), timeout);
326
+ if (dataConfirmResult !== ZnpCommandStatus.SUCCESS) {
327
+ // In case dataConfirm timesout (= null) or gives an error, try to recover
328
+ debug('Data confirm error (%s:%d,%d,%d)', ieeeAddr, networkAddress, dataConfirmResult, dataRequestAttempt);
329
+ if (response !== null)
330
+ response.cancel();
331
+ /**
332
+ * In case we did an assocRemove in the previous attempt and it still fails after this, assume that the
333
+ * coordinator is still the parent of the device (but for some reason the device is not available now).
334
+ * Re-add the device to the assoc table, otherwise we will never be able to reach it anymore.
335
+ */
336
+ if (assocRemove && assocRestore && this.supportsAssocAdd()) {
337
+ debug('assocAdd(%s)', assocRestore.ieeeadr);
338
+ await this.znp.request(Subsystem.UTIL, 'assocAdd', assocRestore);
339
+ assocRestore = null;
340
+ }
341
+ const recoverableErrors = [
342
+ ZnpCommandStatus.NWK_NO_ROUTE, ZnpCommandStatus.MAC_NO_ACK, ZnpCommandStatus.MAC_CHANNEL_ACCESS_FAILURE,
343
+ ZnpCommandStatus.MAC_TRANSACTION_EXPIRED, ZnpCommandStatus.BUFFER_FULL,
344
+ ZnpCommandStatus.MAC_NO_RESOURCES,
345
+ ];
346
+ if (dataRequestAttempt >= 4 || !recoverableErrors.includes(dataConfirmResult) || disableRecovery) {
347
+ throw new DataConfirmError(dataConfirmResult);
348
+ }
349
+ if (dataConfirmResult === ZnpCommandStatus.MAC_CHANNEL_ACCESS_FAILURE ||
350
+ dataConfirmResult === ZnpCommandStatus.BUFFER_FULL ||
351
+ dataConfirmResult === ZnpCommandStatus.MAC_NO_RESOURCES) {
352
+ /**
353
+ * MAC_CHANNEL_ACCESS_FAILURE: When many commands at once are executed we can end up in a MAC
354
+ * channel access failure error. This is because there is too much traffic on the network.
355
+ * Retry this command once after a cooling down period.
356
+ * BUFFER_FULL: When many commands are executed at once the buffer can get full, wait
357
+ * some time and retry.
358
+ * MAC_NO_RESOURCES: Operation could not be completed because no memory resources are available,
359
+ * wait some time and retry.
360
+ */
361
+ await (0, utils_1.Wait)(2000);
362
+ return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt, dataRequestAttempt + 1, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore);
363
+ }
364
+ else {
365
+ let doAssocRemove = false;
366
+ if (!assocRemove && dataConfirmResult === ZnpCommandStatus.MAC_TRANSACTION_EXPIRED &&
367
+ dataRequestAttempt >= 1 && this.supportsAssocRemove()) {
368
+ /* istanbul ignore else */
369
+ if (!process.env['DISABLE_ASSOC_GET']) {
370
+ const match = await this.znp.request(Subsystem.UTIL, 'assocGetWithAddress', { extaddr: ieeeAddr, nwkaddr: networkAddress });
371
+ if (match.payload.nwkaddr !== 0xFFFE && match.payload.noderelation !== 255) {
372
+ doAssocRemove = true;
373
+ assocRestore =
374
+ { ieeeadr: ieeeAddr, nwkaddr: networkAddress, noderelation: match.payload.noderelation };
375
+ }
376
+ }
377
+ assocRemove = true;
378
+ }
379
+ // NWK_NO_ROUTE: no network route => rediscover route
380
+ // MAC_NO_ACK: route may be corrupted
381
+ // MAC_TRANSACTION_EXPIRED: Mac layer is sleeping
382
+ if (doAssocRemove) {
383
+ /**
384
+ * Since child aging is disabled on the firmware, when a end device is directly connected
385
+ * to the coordinator and changes parent and the coordinator does not recevie this update,
386
+ * it still thinks it's directly connected.
387
+ * A discoverRoute() is not send out in this case, therefore remove it from the associated device
388
+ * list and try again.
389
+ * Note: assocRemove is a custom command, not available by default, only available on recent
390
+ * z-stack-firmware firmware version. In case it's not supported by the coordinator we will
391
+ * automatically timeout after 60000ms.
392
+ */
393
+ debug('assocRemove(%s)', ieeeAddr);
394
+ await this.znp.request(Subsystem.UTIL, 'assocRemove', { ieeeadr: ieeeAddr });
395
+ }
396
+ else if (!discoveredRoute && dataRequestAttempt >= 1) {
397
+ discoveredRoute = true;
398
+ await this.discoverRoute(networkAddress);
399
+ }
400
+ else if (!checkedNetworkAddress && dataRequestAttempt >= 1) {
401
+ // Figure out once if the network address has been changed.
402
+ try {
403
+ checkedNetworkAddress = true;
404
+ const actualNetworkAddress = await this.requestNetworkAddress(ieeeAddr);
405
+ if (networkAddress !== actualNetworkAddress) {
406
+ debug(`Failed because request was done with wrong network address`);
407
+ discoveredRoute = true;
408
+ networkAddress = actualNetworkAddress;
409
+ await this.discoverRoute(actualNetworkAddress);
410
+ }
411
+ else {
412
+ debug('Network address did not change');
413
+ }
414
+ }
415
+ catch { }
416
+ }
417
+ else {
418
+ debug('Wait 2000ms');
419
+ await (0, utils_1.Wait)(2000);
420
+ }
421
+ return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt, dataRequestAttempt + 1, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore);
422
+ }
423
+ }
424
+ if (response !== null) {
425
+ try {
426
+ const result = await response.start().promise;
427
+ return result;
428
+ }
429
+ catch (error) {
430
+ debug('Response timeout (%s:%d,%d)', ieeeAddr, networkAddress, responseAttempt);
431
+ if (responseAttempt < 1 && !disableRecovery) {
432
+ // No response could be because the radio of the end device is turned off:
433
+ // Sometimes the coordinator does not properly set the PENDING flag.
434
+ // Try to rewrite the device entry in the association table, this fixes it sometimes.
435
+ /* istanbul ignore else */
436
+ if (!process.env['DISABLE_ASSOC_GET']) {
437
+ const match = await this.znp.request(Subsystem.UTIL, 'assocGetWithAddress', { extaddr: ieeeAddr, nwkaddr: networkAddress });
438
+ debug(`Response timeout recovery: Node relation ${match.payload.noderelation} (${ieeeAddr} / ${match.payload.nwkaddr})`);
439
+ if (this.supportsAssocAdd() && this.supportsAssocRemove() &&
440
+ match.payload.nwkaddr !== 0xFFFE && match.payload.noderelation == 1) {
441
+ debug(`Response timeout recovery: Rewrite association table entry (${ieeeAddr})`);
442
+ await this.znp.request(Subsystem.UTIL, 'assocRemove', { ieeeadr: ieeeAddr });
443
+ await this.znp.request(Subsystem.UTIL, 'assocAdd', { ieeeadr: ieeeAddr, nwkaddr: networkAddress, noderelation: match.payload.noderelation });
444
+ }
445
+ }
446
+ // No response could be of invalid route, e.g. when message is send to wrong parent of end device.
447
+ await this.discoverRoute(networkAddress);
448
+ return this.sendZclFrameToEndpointInternal(ieeeAddr, networkAddress, endpoint, sourceEndpoint, zclFrame, timeout, disableResponse, disableRecovery, responseAttempt + 1, dataRequestAttempt, checkedNetworkAddress, discoveredRoute, assocRemove, assocRestore);
449
+ }
450
+ else {
451
+ throw error;
452
+ }
453
+ }
454
+ }
455
+ else {
456
+ return null;
457
+ }
458
+ }
459
+ async sendZclFrameToGroup(groupID, zclFrame, sourceEndpoint) {
460
+ return this.queue.execute(async () => {
461
+ this.checkInterpanLock();
462
+ await this.dataRequestExtended(AddressMode.ADDR_GROUP, groupID, 0xFF, 0, sourceEndpoint || 1, zclFrame.Cluster.ID, Constants.AF.DEFAULT_RADIUS, zclFrame.toBuffer(), 3000, true);
463
+ /**
464
+ * As a group command is not confirmed and thus immidiately returns
465
+ * (contrary to network address requests) we will give the
466
+ * command some time to 'settle' in the network.
467
+ */
468
+ await (0, utils_1.Wait)(200);
469
+ });
470
+ }
471
+ async sendZclFrameToAll(endpoint, zclFrame, sourceEndpoint) {
472
+ return this.queue.execute(async () => {
473
+ this.checkInterpanLock();
474
+ await this.dataRequestExtended(AddressMode.ADDR_16BIT, 0xFFFD, endpoint, 0, sourceEndpoint, zclFrame.Cluster.ID, Constants.AF.DEFAULT_RADIUS, zclFrame.toBuffer(), 3000, false, 0);
475
+ /**
476
+ * As a broadcast command is not confirmed and thus immidiately returns
477
+ * (contrary to network address requests) we will give the
478
+ * command some time to 'settle' in the network.
479
+ */
480
+ await (0, utils_1.Wait)(200);
481
+ });
482
+ }
483
+ async lqi(networkAddress) {
484
+ return this.queue.execute(async () => {
485
+ this.checkInterpanLock();
486
+ const neighbors = [];
487
+ // eslint-disable-next-line
488
+ const request = async (startIndex) => {
489
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'mgmtLqiRsp', { srcaddr: networkAddress });
490
+ await this.znp.request(Subsystem.ZDO, 'mgmtLqiReq', { dstaddr: networkAddress, startindex: startIndex }, response.ID);
491
+ const result = await response.start().promise;
492
+ if (result.payload.status !== ZnpCommandStatus.SUCCESS) {
493
+ throw new Error(`LQI for '${networkAddress}' failed with error: '${ZnpCommandStatus[result.payload.status]}' (${result.payload.status})`);
494
+ }
495
+ return result;
496
+ };
497
+ // eslint-disable-next-line
498
+ const add = (list) => {
499
+ for (const entry of list) {
500
+ neighbors.push({
501
+ linkquality: entry.lqi,
502
+ networkAddress: entry.nwkAddr,
503
+ ieeeAddr: entry.extAddr,
504
+ relationship: entry.relationship,
505
+ depth: entry.depth,
506
+ });
507
+ }
508
+ };
509
+ let response = await request(0);
510
+ add(response.payload.neighborlqilist);
511
+ const size = response.payload.neighbortableentries;
512
+ let nextStartIndex = response.payload.neighborlqilist.length;
513
+ while (neighbors.length < size) {
514
+ response = await request(nextStartIndex);
515
+ add(response.payload.neighborlqilist);
516
+ nextStartIndex += response.payload.neighborlqilist.length;
517
+ }
518
+ return { neighbors };
519
+ }, networkAddress);
520
+ }
521
+ async routingTable(networkAddress) {
522
+ return this.queue.execute(async () => {
523
+ this.checkInterpanLock();
524
+ const table = [];
525
+ // eslint-disable-next-line
526
+ const request = async (startIndex) => {
527
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'mgmtRtgRsp', { srcaddr: networkAddress });
528
+ await this.znp.request(Subsystem.ZDO, 'mgmtRtgReq', { dstaddr: networkAddress, startindex: startIndex }, response.ID);
529
+ const result = await response.start().promise;
530
+ if (result.payload.status !== ZnpCommandStatus.SUCCESS) {
531
+ throw new Error(`Routing table for '${networkAddress}' failed with error: '${ZnpCommandStatus[result.payload.status]}' (${result.payload.status})`);
532
+ }
533
+ return result;
534
+ };
535
+ // eslint-disable-next-line
536
+ const add = (list) => {
537
+ for (const entry of list) {
538
+ table.push({
539
+ destinationAddress: entry.destNwkAddr,
540
+ status: entry.routeStatus,
541
+ nextHop: entry.nextHopNwkAddr,
542
+ });
543
+ }
544
+ };
545
+ let response = await request(0);
546
+ add(response.payload.routingtablelist);
547
+ const size = response.payload.routingtableentries;
548
+ let nextStartIndex = response.payload.routingtablelist.length;
549
+ while (table.length < size) {
550
+ response = await request(nextStartIndex);
551
+ add(response.payload.routingtablelist);
552
+ nextStartIndex += response.payload.routingtablelist.length;
553
+ }
554
+ return { table };
555
+ }, networkAddress);
556
+ }
557
+ async addInstallCode(ieeeAddress, key) {
558
+ (0, assert_1.default)(this.version.product !== tstype_1.ZnpVersion.zStack12, 'Install code is not supported for ZStack 1.2 adapter');
559
+ const payload = { installCodeFormat: key.length === 18 ? 1 : 2, ieeeaddr: ieeeAddress, installCode: key };
560
+ await this.znp.request(Subsystem.APP_CNF, 'bdbAddInstallCode', payload);
561
+ }
562
+ async bind(destinationNetworkAddress, sourceIeeeAddress, sourceEndpoint, clusterID, destinationAddressOrGroup, type, destinationEndpoint) {
563
+ return this.queue.execute(async () => {
564
+ this.checkInterpanLock();
565
+ const responsePayload = { srcaddr: destinationNetworkAddress };
566
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'bindRsp', responsePayload);
567
+ const payload = {
568
+ dstaddr: destinationNetworkAddress,
569
+ srcaddr: sourceIeeeAddress,
570
+ srcendpoint: sourceEndpoint,
571
+ clusterid: clusterID,
572
+ dstaddrmode: type === 'group' ?
573
+ AddressMode.ADDR_GROUP : AddressMode.ADDR_64BIT,
574
+ dstaddress: this.toAddressString(destinationAddressOrGroup),
575
+ dstendpoint: type === 'group' ? 0xFF : destinationEndpoint,
576
+ };
577
+ await this.znp.request(Subsystem.ZDO, 'bindReq', payload, response.ID);
578
+ await response.start().promise;
579
+ }, destinationNetworkAddress);
580
+ }
581
+ async unbind(destinationNetworkAddress, sourceIeeeAddress, sourceEndpoint, clusterID, destinationAddressOrGroup, type, destinationEndpoint) {
582
+ return this.queue.execute(async () => {
583
+ this.checkInterpanLock();
584
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.ZDO, 'unbindRsp', { srcaddr: destinationNetworkAddress });
585
+ const payload = {
586
+ dstaddr: destinationNetworkAddress,
587
+ srcaddr: sourceIeeeAddress,
588
+ srcendpoint: sourceEndpoint,
589
+ clusterid: clusterID,
590
+ dstaddrmode: type === 'group' ?
591
+ AddressMode.ADDR_GROUP : AddressMode.ADDR_64BIT,
592
+ dstaddress: this.toAddressString(destinationAddressOrGroup),
593
+ dstendpoint: type === 'group' ? 0xFF : destinationEndpoint,
594
+ };
595
+ await this.znp.request(Subsystem.ZDO, 'unbindReq', payload, response.ID);
596
+ await response.start().promise;
597
+ }, destinationNetworkAddress);
598
+ }
599
+ removeDevice(networkAddress, ieeeAddr) {
600
+ return this.queue.execute(async () => {
601
+ this.checkInterpanLock();
602
+ const response = this.znp.waitFor(unpi_1.Constants.Type.AREQ, Subsystem.ZDO, 'mgmtLeaveRsp', { srcaddr: networkAddress });
603
+ const payload = {
604
+ dstaddr: networkAddress,
605
+ deviceaddress: ieeeAddr,
606
+ removechildrenRejoin: 0,
607
+ };
608
+ await this.znp.request(Subsystem.ZDO, 'mgmtLeaveReq', payload, response.ID);
609
+ await response.start().promise;
610
+ }, networkAddress);
611
+ }
612
+ /**
613
+ * Event handlers
614
+ */
615
+ onZnpClose() {
616
+ if (!this.closing) {
617
+ this.emit(Events.Events.disconnected);
618
+ }
619
+ }
620
+ onZnpRecieved(object) {
621
+ if (object.type !== unpi_1.Constants.Type.AREQ) {
622
+ return;
623
+ }
624
+ if (object.subsystem === Subsystem.ZDO) {
625
+ if (object.command === 'tcDeviceInd') {
626
+ const payload = {
627
+ networkAddress: object.payload.nwkaddr,
628
+ ieeeAddr: object.payload.extaddr,
629
+ };
630
+ this.emit(Events.Events.deviceJoined, payload);
631
+ }
632
+ else if (object.command === 'endDeviceAnnceInd') {
633
+ const payload = {
634
+ networkAddress: object.payload.nwkaddr,
635
+ ieeeAddr: object.payload.ieeeaddr,
636
+ };
637
+ // Only discover routes to end devices, if bit 1 of capabilities === 0 it's an end device.
638
+ const isEndDevice = (object.payload.capabilities & 1 << 1) === 0;
639
+ if (isEndDevice) {
640
+ if (!this.deviceAnnounceRouteDiscoveryDebouncers.has(payload.networkAddress)) {
641
+ // If a device announces multiple times in a very short time, it makes no sense
642
+ // to rediscover the route every time.
643
+ const debouncer = (0, debounce_1.default)(() => {
644
+ // eslint-disable-next-line @typescript-eslint/no-floating-promises
645
+ this.queue.execute(async () => {
646
+ /* istanbul ignore next */
647
+ this.discoverRoute(payload.networkAddress, false).catch(() => { });
648
+ }, payload.networkAddress);
649
+ }, 60 * 1000, { immediate: true });
650
+ this.deviceAnnounceRouteDiscoveryDebouncers.set(payload.networkAddress, debouncer);
651
+ }
652
+ this.deviceAnnounceRouteDiscoveryDebouncers.get(payload.networkAddress)();
653
+ }
654
+ this.emit(Events.Events.deviceAnnounce, payload);
655
+ }
656
+ else if (object.command === 'nwkAddrRsp') {
657
+ const payload = {
658
+ networkAddress: object.payload.nwkaddr,
659
+ ieeeAddr: object.payload.ieeeaddr,
660
+ };
661
+ this.emit(Events.Events.networkAddress, payload);
662
+ }
663
+ else {
664
+ /* istanbul ignore else */
665
+ if (object.command === 'leaveInd') {
666
+ if (object.payload.rejoin) {
667
+ debug(`Device leave: Got leave indication with rejoin=true, nothing to do`);
668
+ }
669
+ else {
670
+ const payload = {
671
+ networkAddress: object.payload.srcaddr,
672
+ ieeeAddr: object.payload.extaddr,
673
+ };
674
+ this.emit(Events.Events.deviceLeave, payload);
675
+ }
676
+ }
677
+ }
678
+ }
679
+ else {
680
+ /* istanbul ignore else */
681
+ if (object.subsystem === Subsystem.AF) {
682
+ /* istanbul ignore else */
683
+ if (object.command === 'incomingMsg' || object.command === 'incomingMsgExt') {
684
+ try {
685
+ const payload = {
686
+ frame: zcl_1.ZclFrame.fromBuffer(object.payload.clusterid, object.payload.data),
687
+ address: object.payload.srcaddr,
688
+ endpoint: object.payload.srcendpoint,
689
+ linkquality: object.payload.linkquality,
690
+ groupID: object.payload.groupid,
691
+ wasBroadcast: object.payload.wasbroadcast === 1,
692
+ destinationEndpoint: object.payload.dstendpoint,
693
+ };
694
+ this.waitress.resolve(payload);
695
+ this.emit(Events.Events.zclData, payload);
696
+ }
697
+ catch (error) {
698
+ const payload = {
699
+ clusterID: object.payload.clusterid,
700
+ data: object.payload.data,
701
+ address: object.payload.srcaddr,
702
+ endpoint: object.payload.srcendpoint,
703
+ linkquality: object.payload.linkquality,
704
+ groupID: object.payload.groupid,
705
+ wasBroadcast: object.payload.wasbroadcast === 1,
706
+ destinationEndpoint: object.payload.dstendpoint,
707
+ };
708
+ this.emit(Events.Events.rawData, payload);
709
+ }
710
+ }
711
+ }
712
+ }
713
+ }
714
+ async getNetworkParameters() {
715
+ const result = await this.znp.request(Subsystem.ZDO, 'extNwkInfo', {});
716
+ return {
717
+ panID: result.payload.panid, extendedPanID: result.payload.extendedpanid,
718
+ channel: result.payload.channel
719
+ };
720
+ }
721
+ async supportsBackup() {
722
+ return true;
723
+ }
724
+ async backup(ieeeAddressesInDatabase) {
725
+ return this.adapterManager.backup.createBackup(ieeeAddressesInDatabase);
726
+ }
727
+ async setChannelInterPAN(channel) {
728
+ return this.queue.execute(async () => {
729
+ this.interpanLock = true;
730
+ await this.znp.request(Subsystem.AF, 'interPanCtl', { cmd: 1, data: [channel] });
731
+ if (!this.interpanEndpointRegistered) {
732
+ // Make sure that endpoint 12 is registered to proxy the InterPAN messages.
733
+ await this.znp.request(Subsystem.AF, 'interPanCtl', { cmd: 2, data: [12] });
734
+ this.interpanEndpointRegistered = true;
735
+ }
736
+ });
737
+ }
738
+ async sendZclFrameInterPANToIeeeAddr(zclFrame, ieeeAddr) {
739
+ return this.queue.execute(async () => {
740
+ await this.dataRequestExtended(AddressMode.ADDR_64BIT, ieeeAddr, 0xFE, 0xFFFF, 12, zclFrame.Cluster.ID, 30, zclFrame.toBuffer(), 10000, false);
741
+ });
742
+ }
743
+ async sendZclFrameInterPANBroadcast(zclFrame, timeout) {
744
+ return this.queue.execute(async () => {
745
+ const command = zclFrame.getCommand();
746
+ if (!command.hasOwnProperty('response')) {
747
+ throw new Error(`Command '${command.name}' has no response, cannot wait for response`);
748
+ }
749
+ const response = this.waitForInternal(null, 0xFE, zclFrame.Header.frameControl.frameType, zcl_1.Direction.SERVER_TO_CLIENT, null, zclFrame.Cluster.ID, command.response, timeout);
750
+ try {
751
+ await this.dataRequestExtended(AddressMode.ADDR_16BIT, 0xFFFF, 0xFE, 0xFFFF, 12, zclFrame.Cluster.ID, 30, zclFrame.toBuffer(), 10000, false);
752
+ }
753
+ catch (error) {
754
+ response.cancel();
755
+ throw error;
756
+ }
757
+ return response.start().promise;
758
+ });
759
+ }
760
+ async restoreChannelInterPAN() {
761
+ return this.queue.execute(async () => {
762
+ await this.znp.request(Subsystem.AF, 'interPanCtl', { cmd: 0, data: [] });
763
+ // Give adapter some time to restore, otherwise stuff crashes
764
+ await (0, utils_1.Wait)(3000);
765
+ this.interpanLock = false;
766
+ });
767
+ }
768
+ async setTransmitPower(value) {
769
+ return this.queue.execute(async () => {
770
+ await this.znp.request(Subsystem.SYS, 'stackTune', { operation: 0, value });
771
+ });
772
+ }
773
+ waitForInternal(networkAddress, endpoint, frameType, direction, transactionSequenceNumber, clusterID, commandIdentifier, timeout) {
774
+ const payload = {
775
+ address: networkAddress, endpoint, clusterID, commandIdentifier, frameType, direction,
776
+ transactionSequenceNumber,
777
+ };
778
+ const waiter = this.waitress.waitFor(payload, timeout);
779
+ const cancel = () => this.waitress.remove(waiter.ID);
780
+ return { start: waiter.start, cancel };
781
+ }
782
+ waitFor(networkAddress, endpoint, frameType, direction, transactionSequenceNumber, clusterID, commandIdentifier, timeout) {
783
+ const waiter = this.waitForInternal(networkAddress, endpoint, frameType, direction, transactionSequenceNumber, clusterID, commandIdentifier, timeout);
784
+ return { cancel: waiter.cancel, promise: waiter.start().promise };
785
+ }
786
+ /**
787
+ * Private methods
788
+ */
789
+ async dataRequest(destinationAddress, destinationEndpoint, sourceEndpoint, clusterID, radius, data, timeout) {
790
+ const transactionID = this.nextTransactionID();
791
+ const response = this.znp.waitFor(Type.AREQ, Subsystem.AF, 'dataConfirm', { transid: transactionID }, timeout);
792
+ await this.znp.request(Subsystem.AF, 'dataRequest', {
793
+ dstaddr: destinationAddress,
794
+ destendpoint: destinationEndpoint,
795
+ srcendpoint: sourceEndpoint,
796
+ clusterid: clusterID,
797
+ transid: transactionID,
798
+ options: 0,
799
+ radius: radius,
800
+ len: data.length,
801
+ data: data,
802
+ }, response.ID);
803
+ let result = null;
804
+ try {
805
+ const dataConfirm = await response.start().promise;
806
+ result = dataConfirm.payload.status;
807
+ }
808
+ catch {
809
+ result = DataConfirmTimeout;
810
+ }
811
+ return result;
812
+ }
813
+ async dataRequestExtended(addressMode, destinationAddressOrGroupID, destinationEndpoint, panID, sourceEndpoint, clusterID, radius, data, timeout, confirmation, attemptsLeft = 5) {
814
+ const transactionID = this.nextTransactionID();
815
+ const response = confirmation ?
816
+ this.znp.waitFor(Type.AREQ, Subsystem.AF, 'dataConfirm', { transid: transactionID }, timeout) : null;
817
+ await this.znp.request(Subsystem.AF, 'dataRequestExt', {
818
+ dstaddrmode: addressMode,
819
+ dstaddr: this.toAddressString(destinationAddressOrGroupID),
820
+ destendpoint: destinationEndpoint,
821
+ dstpanid: panID,
822
+ srcendpoint: sourceEndpoint,
823
+ clusterid: clusterID,
824
+ transid: transactionID,
825
+ options: 0, // TODO: why was this here? Constants.AF.options.DISCV_ROUTE,
826
+ radius,
827
+ len: data.length,
828
+ data: data,
829
+ }, response ? response.ID : null);
830
+ if (confirmation) {
831
+ const dataConfirm = await response.start().promise;
832
+ if (dataConfirm.payload.status !== ZnpCommandStatus.SUCCESS) {
833
+ if (attemptsLeft > 0 &&
834
+ (dataConfirm.payload.status === ZnpCommandStatus.MAC_CHANNEL_ACCESS_FAILURE ||
835
+ dataConfirm.payload.status === ZnpCommandStatus.BUFFER_FULL)) {
836
+ /**
837
+ * 225: When many commands at once are executed we can end up in a MAC channel access failure
838
+ * error. This is because there is too much traffic on the network.
839
+ * Retry this command once after a cooling down period.
840
+ */
841
+ await (0, utils_1.Wait)(2000);
842
+ return this.dataRequestExtended(addressMode, destinationAddressOrGroupID, destinationEndpoint, panID, sourceEndpoint, clusterID, radius, data, timeout, confirmation, attemptsLeft - 1);
843
+ }
844
+ else {
845
+ throw new DataConfirmError(dataConfirm.payload.status);
846
+ }
847
+ }
848
+ return dataConfirm;
849
+ }
850
+ }
851
+ nextTransactionID() {
852
+ this.transactionID++;
853
+ if (this.transactionID > 255) {
854
+ this.transactionID = 1;
855
+ }
856
+ return this.transactionID;
857
+ }
858
+ toAddressString(address) {
859
+ if (typeof address === 'number') {
860
+ let addressString = address.toString(16);
861
+ for (let i = addressString.length; i < 16; i++) {
862
+ addressString = '0' + addressString;
863
+ }
864
+ return `0x${addressString}`;
865
+ }
866
+ else {
867
+ return address.toString();
868
+ }
869
+ }
870
+ waitressTimeoutFormatter(matcher, timeout) {
871
+ return `Timeout - ${matcher.address} - ${matcher.endpoint}` +
872
+ ` - ${matcher.transactionSequenceNumber} - ${matcher.clusterID}` +
873
+ ` - ${matcher.commandIdentifier} after ${timeout}ms`;
874
+ }
875
+ waitressValidator(payload, matcher) {
876
+ const transactionSequenceNumber = payload.frame.Header.transactionSequenceNumber;
877
+ return (!matcher.address || payload.address === matcher.address) &&
878
+ payload.endpoint === matcher.endpoint &&
879
+ (!matcher.transactionSequenceNumber || transactionSequenceNumber === matcher.transactionSequenceNumber) &&
880
+ payload.frame.Cluster.ID === matcher.clusterID &&
881
+ matcher.frameType === payload.frame.Header.frameControl.frameType &&
882
+ matcher.commandIdentifier === payload.frame.Header.commandIdentifier &&
883
+ matcher.direction === payload.frame.Header.frameControl.direction;
884
+ }
885
+ checkInterpanLock() {
886
+ if (this.interpanLock) {
887
+ throw new Error(`Cannot execute command, in Inter-PAN mode`);
888
+ }
889
+ }
890
+ }
891
+ exports.default = ZStackAdapter;
869
892
  //# sourceMappingURL=zStackAdapter.js.map