@switchbot/homebridge-switchbot 5.0.0-beta.1 → 5.0.0-beta.100

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 (448) hide show
  1. package/.github/ISSUE_TEMPLATE/e2e-verification.md +36 -0
  2. package/.github/workflows/ci.yml +32 -0
  3. package/.github/workflows/manual-e2e.yml +115 -0
  4. package/.github/workflows/release.yml +0 -4
  5. package/CHANGELOG.md +35 -0
  6. package/E2E-VERIFICATION.md +121 -0
  7. package/MIGRATION.md +44 -0
  8. package/README.md +56 -3
  9. package/config.schema.json +91 -14787
  10. package/dist/deviceFactory.d.ts +13 -0
  11. package/dist/deviceFactory.d.ts.map +1 -0
  12. package/dist/deviceFactory.js +81 -0
  13. package/dist/deviceFactory.js.map +1 -0
  14. package/dist/devices/deviceBase.d.ts +50 -0
  15. package/dist/devices/deviceBase.d.ts.map +1 -0
  16. package/dist/devices/deviceBase.js +119 -0
  17. package/dist/devices/deviceBase.js.map +1 -0
  18. package/dist/devices/genericDevice.d.ts +298 -0
  19. package/dist/devices/genericDevice.d.ts.map +1 -0
  20. package/dist/devices/genericDevice.js +1065 -0
  21. package/dist/devices/genericDevice.js.map +1 -0
  22. package/dist/homebridge-ui/public/index.html +636 -246
  23. package/dist/homebridge-ui/server.d.ts +3 -1
  24. package/dist/homebridge-ui/server.d.ts.map +1 -1
  25. package/dist/homebridge-ui/server.js +467 -36
  26. package/dist/homebridge-ui/server.js.map +1 -1
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +4 -7
  29. package/dist/index.js.map +1 -1
  30. package/dist/platform.d.ts +35 -0
  31. package/dist/platform.d.ts.map +1 -0
  32. package/dist/platform.js +1562 -0
  33. package/dist/platform.js.map +1 -0
  34. package/dist/settings.d.ts +10 -249
  35. package/dist/settings.d.ts.map +1 -1
  36. package/dist/settings.js +5 -30
  37. package/dist/settings.js.map +1 -1
  38. package/dist/switchbotClient.d.ts +32 -0
  39. package/dist/switchbotClient.d.ts.map +1 -0
  40. package/dist/switchbotClient.js +194 -0
  41. package/dist/switchbotClient.js.map +1 -0
  42. package/dist/utils.d.ts +39 -50
  43. package/dist/utils.d.ts.map +1 -1
  44. package/dist/utils.js +39 -688
  45. package/dist/utils.js.map +1 -1
  46. package/docs/assets/highlight.css +14 -0
  47. package/docs/assets/icons.js +1 -1
  48. package/docs/assets/icons.svg +1 -1
  49. package/docs/assets/main.js +2 -2
  50. package/docs/assets/style.css +3 -3
  51. package/docs/index.html +77 -13
  52. package/docs/variables/default.html +1 -1
  53. package/eslint.config.js +2 -8
  54. package/package.json +21 -28
  55. package/scripts/e2e/README.md +25 -0
  56. package/scripts/e2e/curtain-e2e.sh +70 -0
  57. package/scripts/e2e/fan-e2e.sh +75 -0
  58. package/scripts/e2e/light-advanced-e2e.sh +97 -0
  59. package/scripts/e2e/light-e2e.sh +75 -0
  60. package/scripts/e2e/list-accessories.sh +19 -0
  61. package/scripts/e2e/lock-e2e.sh +65 -0
  62. package/scripts/generate-matter-maps.js +60 -0
  63. package/scripts/run-e2e-local.sh +14 -0
  64. package/src/deviceFactory.ts +122 -0
  65. package/src/devices/deviceBase.ts +141 -0
  66. package/src/devices/genericDevice.ts +995 -0
  67. package/src/homebridge-ui/public/index.html +636 -246
  68. package/src/homebridge-ui/server.ts +552 -41
  69. package/src/index.ts +4 -7
  70. package/src/platform.ts +1561 -0
  71. package/src/settings.ts +12 -277
  72. package/src/switchbotClient.ts +203 -0
  73. package/src/utils.ts +45 -713
  74. package/test/accessory-restore.spec.ts +73 -0
  75. package/test/device-mapping.spec.ts +37 -0
  76. package/test/deviceFactory.spec.ts +18 -0
  77. package/test/e2e/run-e2e.spec.ts +50 -0
  78. package/test/fan-swing.spec.ts +29 -0
  79. package/test/helpers/matter-harness.ts +53 -0
  80. package/test/lock-users.spec.ts +44 -0
  81. package/test/matter-childbridge.spec.ts +55 -0
  82. package/test/matter-descriptors.spec.ts +97 -0
  83. package/test/matter-device-state.spec.ts +101 -0
  84. package/test/matter-integration.spec.ts +70 -0
  85. package/test/platform.integration.spec.ts +55 -0
  86. package/test/switchbot-client-debounce.spec.ts +131 -0
  87. package/test/switchbot-client-openapi.spec.ts +56 -0
  88. package/test/switchbotClient.spec.ts +10 -0
  89. package/test/utils.spec.ts +20 -0
  90. package/vitest.config.ts +7 -0
  91. package/coverage/base.css +0 -224
  92. package/coverage/block-navigation.js +0 -87
  93. package/coverage/clover.xml +0 -15847
  94. package/coverage/coverage-final.json +0 -42
  95. package/coverage/docs/assets/dmt/dmt-component-data.js.html +0 -85
  96. package/coverage/docs/assets/dmt/dmt-components.js.html +0 -286
  97. package/coverage/docs/assets/dmt/index.html +0 -131
  98. package/coverage/docs/assets/hierarchy.js.html +0 -85
  99. package/coverage/docs/assets/icons.js.html +0 -136
  100. package/coverage/docs/assets/index.html +0 -146
  101. package/coverage/docs/assets/main.js.html +0 -265
  102. package/coverage/favicon.png +0 -0
  103. package/coverage/index.html +0 -191
  104. package/coverage/prettify.css +0 -1
  105. package/coverage/prettify.js +0 -2
  106. package/coverage/sort-arrow-sprite.png +0 -0
  107. package/coverage/sorter.js +0 -196
  108. package/coverage/src/device/blindtilt.ts.html +0 -3238
  109. package/coverage/src/device/bot.ts.html +0 -2803
  110. package/coverage/src/device/ceilinglight.ts.html +0 -2338
  111. package/coverage/src/device/colorbulb.ts.html +0 -2824
  112. package/coverage/src/device/contact.ts.html +0 -1465
  113. package/coverage/src/device/curtain.ts.html +0 -2869
  114. package/coverage/src/device/device.ts.html +0 -2500
  115. package/coverage/src/device/fan.ts.html +0 -2242
  116. package/coverage/src/device/hub.ts.html +0 -1408
  117. package/coverage/src/device/humidifier.ts.html +0 -2116
  118. package/coverage/src/device/index.html +0 -416
  119. package/coverage/src/device/iosensor.ts.html +0 -1375
  120. package/coverage/src/device/lightstrip.ts.html +0 -2617
  121. package/coverage/src/device/lock.ts.html +0 -1963
  122. package/coverage/src/device/meter.ts.html +0 -1372
  123. package/coverage/src/device/meterplus.ts.html +0 -1384
  124. package/coverage/src/device/meterpro.ts.html +0 -1618
  125. package/coverage/src/device/motion.ts.html +0 -1264
  126. package/coverage/src/device/plug.ts.html +0 -1372
  127. package/coverage/src/device/relayswitch.ts.html +0 -2284
  128. package/coverage/src/device/robotvacuumcleaner.ts.html +0 -1810
  129. package/coverage/src/device/waterdetector.ts.html +0 -1294
  130. package/coverage/src/homebridge-ui/index.html +0 -116
  131. package/coverage/src/homebridge-ui/server.ts.html +0 -229
  132. package/coverage/src/index.html +0 -161
  133. package/coverage/src/index.ts.html +0 -124
  134. package/coverage/src/irdevice/airconditioner.ts.html +0 -1687
  135. package/coverage/src/irdevice/airpurifier.ts.html +0 -844
  136. package/coverage/src/irdevice/camera.ts.html +0 -475
  137. package/coverage/src/irdevice/fan.ts.html +0 -766
  138. package/coverage/src/irdevice/index.html +0 -251
  139. package/coverage/src/irdevice/irdevice.ts.html +0 -1117
  140. package/coverage/src/irdevice/light.ts.html +0 -826
  141. package/coverage/src/irdevice/other.ts.html +0 -2458
  142. package/coverage/src/irdevice/tv.ts.html +0 -1222
  143. package/coverage/src/irdevice/vacuumcleaner.ts.html +0 -466
  144. package/coverage/src/irdevice/waterheater.ts.html +0 -469
  145. package/coverage/src/platform.ts.html +0 -8776
  146. package/coverage/src/settings.ts.html +0 -934
  147. package/coverage/src/utils.ts.html +0 -2092
  148. package/dist/devices-hap/airpurifier.d.ts +0 -54
  149. package/dist/devices-hap/airpurifier.d.ts.map +0 -1
  150. package/dist/devices-hap/airpurifier.js +0 -527
  151. package/dist/devices-hap/airpurifier.js.map +0 -1
  152. package/dist/devices-hap/blindtilt.d.ts +0 -90
  153. package/dist/devices-hap/blindtilt.d.ts.map +0 -1
  154. package/dist/devices-hap/blindtilt.js +0 -974
  155. package/dist/devices-hap/blindtilt.js.map +0 -1
  156. package/dist/devices-hap/bot.d.ts +0 -102
  157. package/dist/devices-hap/bot.d.ts.map +0 -1
  158. package/dist/devices-hap/bot.js +0 -811
  159. package/dist/devices-hap/bot.js.map +0 -1
  160. package/dist/devices-hap/ceilinglight.d.ts +0 -85
  161. package/dist/devices-hap/ceilinglight.d.ts.map +0 -1
  162. package/dist/devices-hap/ceilinglight.js +0 -701
  163. package/dist/devices-hap/ceilinglight.js.map +0 -1
  164. package/dist/devices-hap/colorbulb.d.ts +0 -88
  165. package/dist/devices-hap/colorbulb.d.ts.map +0 -1
  166. package/dist/devices-hap/colorbulb.js +0 -881
  167. package/dist/devices-hap/colorbulb.js.map +0 -1
  168. package/dist/devices-hap/contact.d.ts +0 -44
  169. package/dist/devices-hap/contact.d.ts.map +0 -1
  170. package/dist/devices-hap/contact.js +0 -409
  171. package/dist/devices-hap/contact.js.map +0 -1
  172. package/dist/devices-hap/curtain.d.ts +0 -73
  173. package/dist/devices-hap/curtain.d.ts.map +0 -1
  174. package/dist/devices-hap/curtain.js +0 -869
  175. package/dist/devices-hap/curtain.js.map +0 -1
  176. package/dist/devices-hap/device.d.ts +0 -98
  177. package/dist/devices-hap/device.d.ts.map +0 -1
  178. package/dist/devices-hap/device.js +0 -749
  179. package/dist/devices-hap/device.js.map +0 -1
  180. package/dist/devices-hap/fan.d.ts +0 -69
  181. package/dist/devices-hap/fan.d.ts.map +0 -1
  182. package/dist/devices-hap/fan.js +0 -649
  183. package/dist/devices-hap/fan.js.map +0 -1
  184. package/dist/devices-hap/hub.d.ts +0 -37
  185. package/dist/devices-hap/hub.d.ts.map +0 -1
  186. package/dist/devices-hap/hub.js +0 -392
  187. package/dist/devices-hap/hub.js.map +0 -1
  188. package/dist/devices-hap/humidifier.d.ts +0 -68
  189. package/dist/devices-hap/humidifier.d.ts.map +0 -1
  190. package/dist/devices-hap/humidifier.js +0 -628
  191. package/dist/devices-hap/humidifier.js.map +0 -1
  192. package/dist/devices-hap/iosensor.d.ts +0 -42
  193. package/dist/devices-hap/iosensor.d.ts.map +0 -1
  194. package/dist/devices-hap/iosensor.js +0 -382
  195. package/dist/devices-hap/iosensor.js.map +0 -1
  196. package/dist/devices-hap/lightstrip.d.ts +0 -79
  197. package/dist/devices-hap/lightstrip.d.ts.map +0 -1
  198. package/dist/devices-hap/lightstrip.js +0 -797
  199. package/dist/devices-hap/lightstrip.js.map +0 -1
  200. package/dist/devices-hap/lock.d.ts +0 -53
  201. package/dist/devices-hap/lock.d.ts.map +0 -1
  202. package/dist/devices-hap/lock.js +0 -561
  203. package/dist/devices-hap/lock.js.map +0 -1
  204. package/dist/devices-hap/meter.d.ts +0 -37
  205. package/dist/devices-hap/meter.d.ts.map +0 -1
  206. package/dist/devices-hap/meter.js +0 -379
  207. package/dist/devices-hap/meter.js.map +0 -1
  208. package/dist/devices-hap/meterplus.d.ts +0 -42
  209. package/dist/devices-hap/meterplus.d.ts.map +0 -1
  210. package/dist/devices-hap/meterplus.js +0 -384
  211. package/dist/devices-hap/meterplus.js.map +0 -1
  212. package/dist/devices-hap/meterpro.d.ts +0 -43
  213. package/dist/devices-hap/meterpro.d.ts.map +0 -1
  214. package/dist/devices-hap/meterpro.js +0 -468
  215. package/dist/devices-hap/meterpro.js.map +0 -1
  216. package/dist/devices-hap/motion.d.ts +0 -42
  217. package/dist/devices-hap/motion.d.ts.map +0 -1
  218. package/dist/devices-hap/motion.js +0 -345
  219. package/dist/devices-hap/motion.js.map +0 -1
  220. package/dist/devices-hap/plug.d.ts +0 -49
  221. package/dist/devices-hap/plug.d.ts.map +0 -1
  222. package/dist/devices-hap/plug.js +0 -395
  223. package/dist/devices-hap/plug.js.map +0 -1
  224. package/dist/devices-hap/relayswitch.d.ts +0 -96
  225. package/dist/devices-hap/relayswitch.d.ts.map +0 -1
  226. package/dist/devices-hap/relayswitch.js +0 -642
  227. package/dist/devices-hap/relayswitch.js.map +0 -1
  228. package/dist/devices-hap/robotvacuumcleaner.d.ts +0 -54
  229. package/dist/devices-hap/robotvacuumcleaner.d.ts.map +0 -1
  230. package/dist/devices-hap/robotvacuumcleaner.js +0 -523
  231. package/dist/devices-hap/robotvacuumcleaner.js.map +0 -1
  232. package/dist/devices-hap/waterdetector.d.ts +0 -41
  233. package/dist/devices-hap/waterdetector.d.ts.map +0 -1
  234. package/dist/devices-hap/waterdetector.js +0 -356
  235. package/dist/devices-hap/waterdetector.js.map +0 -1
  236. package/dist/devices-matter/BaseMatterAccessory.d.ts +0 -63
  237. package/dist/devices-matter/BaseMatterAccessory.d.ts.map +0 -1
  238. package/dist/devices-matter/BaseMatterAccessory.js +0 -100
  239. package/dist/devices-matter/BaseMatterAccessory.js.map +0 -1
  240. package/dist/devices-matter/ColorLightAccessory.d.ts +0 -18
  241. package/dist/devices-matter/ColorLightAccessory.d.ts.map +0 -1
  242. package/dist/devices-matter/ColorLightAccessory.js +0 -96
  243. package/dist/devices-matter/ColorLightAccessory.js.map +0 -1
  244. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts +0 -16
  245. package/dist/devices-matter/ColorTemperatureLightAccessory.d.ts.map +0 -1
  246. package/dist/devices-matter/ColorTemperatureLightAccessory.js +0 -83
  247. package/dist/devices-matter/ColorTemperatureLightAccessory.js.map +0 -1
  248. package/dist/devices-matter/ContactSensorAccessory.d.ts +0 -10
  249. package/dist/devices-matter/ContactSensorAccessory.d.ts.map +0 -1
  250. package/dist/devices-matter/ContactSensorAccessory.js +0 -31
  251. package/dist/devices-matter/ContactSensorAccessory.js.map +0 -1
  252. package/dist/devices-matter/DimmableLightAccessory.d.ts +0 -56
  253. package/dist/devices-matter/DimmableLightAccessory.d.ts.map +0 -1
  254. package/dist/devices-matter/DimmableLightAccessory.js +0 -170
  255. package/dist/devices-matter/DimmableLightAccessory.js.map +0 -1
  256. package/dist/devices-matter/DoorLockAccessory.d.ts +0 -12
  257. package/dist/devices-matter/DoorLockAccessory.d.ts.map +0 -1
  258. package/dist/devices-matter/DoorLockAccessory.js +0 -47
  259. package/dist/devices-matter/DoorLockAccessory.js.map +0 -1
  260. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts +0 -19
  261. package/dist/devices-matter/ExtendedColorLightAccessory.d.ts.map +0 -1
  262. package/dist/devices-matter/ExtendedColorLightAccessory.js +0 -108
  263. package/dist/devices-matter/ExtendedColorLightAccessory.js.map +0 -1
  264. package/dist/devices-matter/FanAccessory.d.ts +0 -14
  265. package/dist/devices-matter/FanAccessory.d.ts.map +0 -1
  266. package/dist/devices-matter/FanAccessory.js +0 -73
  267. package/dist/devices-matter/FanAccessory.js.map +0 -1
  268. package/dist/devices-matter/HumiditySensorAccessory.d.ts +0 -10
  269. package/dist/devices-matter/HumiditySensorAccessory.d.ts.map +0 -1
  270. package/dist/devices-matter/HumiditySensorAccessory.js +0 -33
  271. package/dist/devices-matter/HumiditySensorAccessory.js.map +0 -1
  272. package/dist/devices-matter/LeakSensorAccessory.d.ts +0 -10
  273. package/dist/devices-matter/LeakSensorAccessory.d.ts.map +0 -1
  274. package/dist/devices-matter/LeakSensorAccessory.js +0 -30
  275. package/dist/devices-matter/LeakSensorAccessory.js.map +0 -1
  276. package/dist/devices-matter/LightSensorAccessory.d.ts +0 -10
  277. package/dist/devices-matter/LightSensorAccessory.d.ts.map +0 -1
  278. package/dist/devices-matter/LightSensorAccessory.js +0 -33
  279. package/dist/devices-matter/LightSensorAccessory.js.map +0 -1
  280. package/dist/devices-matter/OccupancySensorAccessory.d.ts +0 -10
  281. package/dist/devices-matter/OccupancySensorAccessory.d.ts.map +0 -1
  282. package/dist/devices-matter/OccupancySensorAccessory.js +0 -43
  283. package/dist/devices-matter/OccupancySensorAccessory.js.map +0 -1
  284. package/dist/devices-matter/OnOffLightAccessory.d.ts +0 -36
  285. package/dist/devices-matter/OnOffLightAccessory.d.ts.map +0 -1
  286. package/dist/devices-matter/OnOffLightAccessory.js +0 -117
  287. package/dist/devices-matter/OnOffLightAccessory.js.map +0 -1
  288. package/dist/devices-matter/OnOffOutletAccessory.d.ts +0 -12
  289. package/dist/devices-matter/OnOffOutletAccessory.d.ts.map +0 -1
  290. package/dist/devices-matter/OnOffOutletAccessory.js +0 -43
  291. package/dist/devices-matter/OnOffOutletAccessory.js.map +0 -1
  292. package/dist/devices-matter/OnOffSwitchAccessory.d.ts +0 -12
  293. package/dist/devices-matter/OnOffSwitchAccessory.d.ts.map +0 -1
  294. package/dist/devices-matter/OnOffSwitchAccessory.js +0 -43
  295. package/dist/devices-matter/OnOffSwitchAccessory.js.map +0 -1
  296. package/dist/devices-matter/RoboticVacuumAccessory.d.ts +0 -66
  297. package/dist/devices-matter/RoboticVacuumAccessory.d.ts.map +0 -1
  298. package/dist/devices-matter/RoboticVacuumAccessory.js +0 -402
  299. package/dist/devices-matter/RoboticVacuumAccessory.js.map +0 -1
  300. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts +0 -11
  301. package/dist/devices-matter/SmokeCOAlarmAccessory.d.ts.map +0 -1
  302. package/dist/devices-matter/SmokeCOAlarmAccessory.js +0 -49
  303. package/dist/devices-matter/SmokeCOAlarmAccessory.js.map +0 -1
  304. package/dist/devices-matter/TemperatureSensorAccessory.d.ts +0 -10
  305. package/dist/devices-matter/TemperatureSensorAccessory.d.ts.map +0 -1
  306. package/dist/devices-matter/TemperatureSensorAccessory.js +0 -33
  307. package/dist/devices-matter/TemperatureSensorAccessory.js.map +0 -1
  308. package/dist/devices-matter/ThermostatAccessory.d.ts +0 -17
  309. package/dist/devices-matter/ThermostatAccessory.d.ts.map +0 -1
  310. package/dist/devices-matter/ThermostatAccessory.js +0 -87
  311. package/dist/devices-matter/ThermostatAccessory.js.map +0 -1
  312. package/dist/devices-matter/VenetianBlindAccessory.d.ts +0 -17
  313. package/dist/devices-matter/VenetianBlindAccessory.d.ts.map +0 -1
  314. package/dist/devices-matter/VenetianBlindAccessory.js +0 -100
  315. package/dist/devices-matter/VenetianBlindAccessory.js.map +0 -1
  316. package/dist/devices-matter/WindowBlindAccessory.d.ts +0 -15
  317. package/dist/devices-matter/WindowBlindAccessory.d.ts.map +0 -1
  318. package/dist/devices-matter/WindowBlindAccessory.js +0 -81
  319. package/dist/devices-matter/WindowBlindAccessory.js.map +0 -1
  320. package/dist/devices-matter/custom/PowerStripAccessory.d.ts +0 -97
  321. package/dist/devices-matter/custom/PowerStripAccessory.d.ts.map +0 -1
  322. package/dist/devices-matter/custom/PowerStripAccessory.js +0 -265
  323. package/dist/devices-matter/custom/PowerStripAccessory.js.map +0 -1
  324. package/dist/devices-matter/custom/index.d.ts +0 -8
  325. package/dist/devices-matter/custom/index.d.ts.map +0 -1
  326. package/dist/devices-matter/custom/index.js +0 -8
  327. package/dist/devices-matter/custom/index.js.map +0 -1
  328. package/dist/devices-matter/index.d.ts +0 -29
  329. package/dist/devices-matter/index.d.ts.map +0 -1
  330. package/dist/devices-matter/index.js +0 -28
  331. package/dist/devices-matter/index.js.map +0 -1
  332. package/dist/index.test.d.ts +0 -2
  333. package/dist/index.test.d.ts.map +0 -1
  334. package/dist/index.test.js +0 -14
  335. package/dist/index.test.js.map +0 -1
  336. package/dist/irdevice/airconditioner.d.ts +0 -61
  337. package/dist/irdevice/airconditioner.d.ts.map +0 -1
  338. package/dist/irdevice/airconditioner.js +0 -472
  339. package/dist/irdevice/airconditioner.js.map +0 -1
  340. package/dist/irdevice/airpurifier.d.ts +0 -50
  341. package/dist/irdevice/airpurifier.d.ts.map +0 -1
  342. package/dist/irdevice/airpurifier.js +0 -213
  343. package/dist/irdevice/airpurifier.js.map +0 -1
  344. package/dist/irdevice/camera.d.ts +0 -32
  345. package/dist/irdevice/camera.d.ts.map +0 -1
  346. package/dist/irdevice/camera.js +0 -107
  347. package/dist/irdevice/camera.js.map +0 -1
  348. package/dist/irdevice/fan.d.ts +0 -36
  349. package/dist/irdevice/fan.d.ts.map +0 -1
  350. package/dist/irdevice/fan.js +0 -200
  351. package/dist/irdevice/fan.js.map +0 -1
  352. package/dist/irdevice/irdevice.d.ts +0 -68
  353. package/dist/irdevice/irdevice.d.ts.map +0 -1
  354. package/dist/irdevice/irdevice.js +0 -298
  355. package/dist/irdevice/irdevice.js.map +0 -1
  356. package/dist/irdevice/light.d.ts +0 -36
  357. package/dist/irdevice/light.d.ts.map +0 -1
  358. package/dist/irdevice/light.js +0 -206
  359. package/dist/irdevice/light.js.map +0 -1
  360. package/dist/irdevice/other.d.ts +0 -57
  361. package/dist/irdevice/other.d.ts.map +0 -1
  362. package/dist/irdevice/other.js +0 -778
  363. package/dist/irdevice/other.js.map +0 -1
  364. package/dist/irdevice/tv.d.ts +0 -45
  365. package/dist/irdevice/tv.d.ts.map +0 -1
  366. package/dist/irdevice/tv.js +0 -327
  367. package/dist/irdevice/tv.js.map +0 -1
  368. package/dist/irdevice/vacuumcleaner.d.ts +0 -28
  369. package/dist/irdevice/vacuumcleaner.d.ts.map +0 -1
  370. package/dist/irdevice/vacuumcleaner.js +0 -104
  371. package/dist/irdevice/vacuumcleaner.js.map +0 -1
  372. package/dist/irdevice/waterheater.d.ts +0 -30
  373. package/dist/irdevice/waterheater.d.ts.map +0 -1
  374. package/dist/irdevice/waterheater.js +0 -105
  375. package/dist/irdevice/waterheater.js.map +0 -1
  376. package/dist/platform-hap.d.ts +0 -149
  377. package/dist/platform-hap.d.ts.map +0 -1
  378. package/dist/platform-hap.js +0 -2849
  379. package/dist/platform-hap.js.map +0 -1
  380. package/dist/platform-matter.d.ts +0 -75
  381. package/dist/platform-matter.d.ts.map +0 -1
  382. package/dist/platform-matter.js +0 -379
  383. package/dist/platform-matter.js.map +0 -1
  384. package/dist/verifyconfig.test.d.ts +0 -2
  385. package/dist/verifyconfig.test.d.ts.map +0 -1
  386. package/dist/verifyconfig.test.js +0 -167
  387. package/dist/verifyconfig.test.js.map +0 -1
  388. package/src/custom.d.ts +0 -7
  389. package/src/devices-hap/airpurifier.ts +0 -563
  390. package/src/devices-hap/blindtilt.ts +0 -1049
  391. package/src/devices-hap/bot.ts +0 -900
  392. package/src/devices-hap/ceilinglight.ts +0 -742
  393. package/src/devices-hap/colorbulb.ts +0 -904
  394. package/src/devices-hap/contact.ts +0 -457
  395. package/src/devices-hap/curtain.ts +0 -944
  396. package/src/devices-hap/device.ts +0 -811
  397. package/src/devices-hap/fan.ts +0 -711
  398. package/src/devices-hap/hub.ts +0 -439
  399. package/src/devices-hap/humidifier.ts +0 -669
  400. package/src/devices-hap/iosensor.ts +0 -427
  401. package/src/devices-hap/lightstrip.ts +0 -836
  402. package/src/devices-hap/lock.ts +0 -620
  403. package/src/devices-hap/meter.ts +0 -426
  404. package/src/devices-hap/meterplus.ts +0 -430
  405. package/src/devices-hap/meterpro.ts +0 -522
  406. package/src/devices-hap/motion.ts +0 -390
  407. package/src/devices-hap/plug.ts +0 -423
  408. package/src/devices-hap/relayswitch.ts +0 -727
  409. package/src/devices-hap/robotvacuumcleaner.ts +0 -568
  410. package/src/devices-hap/waterdetector.ts +0 -400
  411. package/src/devices-matter/BaseMatterAccessory.ts +0 -131
  412. package/src/devices-matter/ColorLightAccessory.ts +0 -113
  413. package/src/devices-matter/ColorTemperatureLightAccessory.ts +0 -98
  414. package/src/devices-matter/ContactSensorAccessory.ts +0 -37
  415. package/src/devices-matter/DimmableLightAccessory.ts +0 -196
  416. package/src/devices-matter/DoorLockAccessory.ts +0 -56
  417. package/src/devices-matter/ExtendedColorLightAccessory.ts +0 -127
  418. package/src/devices-matter/FanAccessory.ts +0 -87
  419. package/src/devices-matter/HumiditySensorAccessory.ts +0 -39
  420. package/src/devices-matter/LeakSensorAccessory.ts +0 -36
  421. package/src/devices-matter/LightSensorAccessory.ts +0 -39
  422. package/src/devices-matter/OccupancySensorAccessory.ts +0 -52
  423. package/src/devices-matter/OnOffLightAccessory.ts +0 -133
  424. package/src/devices-matter/OnOffOutletAccessory.ts +0 -52
  425. package/src/devices-matter/OnOffSwitchAccessory.ts +0 -52
  426. package/src/devices-matter/RoboticVacuumAccessory.ts +0 -484
  427. package/src/devices-matter/SmokeCOAlarmAccessory.ts +0 -59
  428. package/src/devices-matter/TemperatureSensorAccessory.ts +0 -39
  429. package/src/devices-matter/ThermostatAccessory.ts +0 -105
  430. package/src/devices-matter/VenetianBlindAccessory.ts +0 -118
  431. package/src/devices-matter/WindowBlindAccessory.ts +0 -94
  432. package/src/devices-matter/custom/PowerStripAccessory.ts +0 -309
  433. package/src/devices-matter/custom/index.ts +0 -8
  434. package/src/devices-matter/index.ts +0 -29
  435. package/src/index.test.ts +0 -19
  436. package/src/irdevice/airconditioner.ts +0 -533
  437. package/src/irdevice/airpurifier.ts +0 -252
  438. package/src/irdevice/camera.ts +0 -129
  439. package/src/irdevice/fan.ts +0 -226
  440. package/src/irdevice/irdevice.ts +0 -344
  441. package/src/irdevice/light.ts +0 -246
  442. package/src/irdevice/other.ts +0 -790
  443. package/src/irdevice/tv.ts +0 -378
  444. package/src/irdevice/vacuumcleaner.ts +0 -126
  445. package/src/irdevice/waterheater.ts +0 -127
  446. package/src/platform-hap.ts +0 -2986
  447. package/src/platform-matter.ts +0 -465
  448. package/src/verifyconfig.test.ts +0 -197
@@ -1,484 +0,0 @@
1
- /* global NodeJS */
2
-
3
- /**
4
- * Robotic Vacuum Cleaner Accessory Class
5
- *
6
- * This is a comprehensive example demonstrating all available features
7
- * of the RoboticVacuumCleaner device type including:
8
- * - Multiple run modes (Idle, Cleaning, Mapping)
9
- * - Multiple clean modes (Vacuum, Mop, Vacuum & Mop, Deep Clean)
10
- * - Operational state management with realistic transitions
11
- * - Service area (room) support
12
- *
13
- * IMPORTANT: Platform Matter accessories
14
- * =======================================
15
- * This vacuum is registered as a platform accessory using
16
- * api.matter.registerPlatformAccessories(), which works the same as HAP.
17
- * Platform accessories are registered synchronously and are immediately ready for use.
18
- *
19
- * Demo behavior:
20
- * - Start/Resume: Sets run mode to "Cleaning", runs for 15/10 seconds, then returns to dock
21
- * - Return to dock: Immediately sets "Idle" mode, then Seeking (5s) → Charging (3s) → Docked
22
- * - Stop: Immediately stops and resets to "Idle" mode
23
- * - Pause: Cancels automatic completion timer, keeps "Cleaning" mode
24
- */
25
-
26
- import type { API, Logger, MatterRequests } from 'homebridge'
27
-
28
- import { BaseMatterAccessory } from './BaseMatterAccessory.js'
29
-
30
- export class RoboticVacuumAccessory extends BaseMatterAccessory {
31
- private activeTimers: NodeJS.Timeout[] = []
32
-
33
- constructor(api: API, log: Logger) {
34
- const serialNumber = 'VACUUM-001'
35
- super(api, log, {
36
- uuid: api.matter.uuid.generate(serialNumber),
37
- displayName: 'Robot Vacuum',
38
- deviceType: api.matter.deviceTypes.RoboticVacuumCleaner,
39
- serialNumber,
40
- manufacturer: 'Homebridge Matter',
41
- model: 'HB-MATTER-VACUUM-ROBOTIC',
42
- firmwareRevision: '2.0.0',
43
- hardwareRevision: '1.0.0',
44
-
45
- clusters: {
46
- // Power Source: Battery status and percentage
47
- powerSource: {
48
- status: 0, // 0 = Active
49
- order: 0, // Primary power source
50
- description: 'Battery',
51
- batPercentRemaining: 100, // 0-200, where 200 = 100% (0.5% increments)
52
- batChargeLevel: 2, // 0 = Ok, 1 = Warning, 2 = Critical
53
- batReplaceability: 1, // 0 = Unspecified, 1 = Not replaceable, 2 = User replaceable, 3 = Factory replaceable
54
- },
55
-
56
- // Run Mode: Controls what the vacuum is doing (Idle, Cleaning, Mapping)
57
- rvcRunMode: {
58
- supportedModes: [
59
- { label: 'Idle', mode: 0, modeTags: [{ value: 16384 }] }, // RvcRunMode.ModeTag.Idle
60
- { label: 'Cleaning', mode: 1, modeTags: [{ value: 16385 }] }, // RvcRunMode.ModeTag.Cleaning
61
- { label: 'Mapping', mode: 2, modeTags: [{ value: 16386 }] }, // RvcRunMode.ModeTag.Mapping
62
- ],
63
- currentMode: 0,
64
- },
65
-
66
- // Clean Mode: Controls HOW the vacuum cleans
67
- // You can combine semantic tags (0-9) with functional tags (16384-16386)
68
- // Available semantic tags: Auto, Quick, Quiet, LowNoise, LowEnergy, Vacation, Min, Max, Night, Day
69
- // Available functional tags: DeepClean, Vacuum, Mop
70
- rvcCleanMode: {
71
- supportedModes: [
72
- // Basic functional modes
73
- { label: 'Vacuum', mode: 0, modeTags: [{ value: 16385 }] }, // Vacuum
74
- { label: 'Mop', mode: 1, modeTags: [{ value: 16386 }] }, // Mop
75
- { label: 'Vacuum & Mop', mode: 2, modeTags: [{ value: 16385 }, { value: 16386 }] }, // Both
76
-
77
- // Deep clean modes
78
- { label: 'Deep Clean', mode: 3, modeTags: [{ value: 16384 }] }, // DeepClean
79
- { label: 'Deep Vacuum', mode: 4, modeTags: [{ value: 16384 }, { value: 16385 }] }, // DeepClean + Vacuum
80
- { label: 'Deep Mop', mode: 5, modeTags: [{ value: 16384 }, { value: 16386 }] }, // DeepClean + Mop
81
-
82
- // Intensity modes
83
- { label: 'Quick Clean', mode: 6, modeTags: [{ value: 1 }, { value: 16385 }] }, // Quick + Vacuum
84
- { label: 'Max Clean', mode: 7, modeTags: [{ value: 7 }, { value: 16385 }] }, // Max + Vacuum
85
- { label: 'Min Clean', mode: 8, modeTags: [{ value: 6 }, { value: 16385 }] }, // Min + Vacuum
86
-
87
- // Quiet modes
88
- { label: 'Quiet Vacuum', mode: 9, modeTags: [{ value: 2 }, { value: 16385 }] }, // Quiet + Vacuum
89
- { label: 'Quiet Mop', mode: 10, modeTags: [{ value: 2 }, { value: 16386 }] }, // Quiet + Mop
90
- { label: 'Night Mode', mode: 11, modeTags: [{ value: 8 }, { value: 16385 }] }, // Night + Vacuum
91
-
92
- // Energy efficient
93
- { label: 'Eco Vacuum', mode: 12, modeTags: [{ value: 4 }, { value: 16385 }] }, // LowEnergy + Vacuum
94
- { label: 'Eco Mop', mode: 13, modeTags: [{ value: 4 }, { value: 16386 }] }, // LowEnergy + Mop
95
-
96
- // Auto mode
97
- { label: 'Auto', mode: 14, modeTags: [{ value: 0 }, { value: 16385 }] }, // Auto + Vacuum
98
- ],
99
- currentMode: 0, // start with basic Vacuum
100
- },
101
-
102
- // Operational State: Current state (Stopped, Running, Paused, Error, etc.)
103
- rvcOperationalState: {
104
- operationalStateList: [
105
- { operationalStateId: 0 }, // stopped (standard label from Matter spec)
106
- { operationalStateId: 1 }, // running
107
- { operationalStateId: 2 }, // paused
108
- { operationalStateId: 3 }, // error
109
- { operationalStateId: 64 }, // seeking charger
110
- { operationalStateId: 65 }, // charging
111
- { operationalStateId: 66 }, // docked
112
- ],
113
- operationalState: 66, // start docked
114
- },
115
-
116
- // Service Area: Room/zone selection for targeted cleaning
117
- serviceArea: {
118
- supportedMaps: [], // empty array - we don't use map features
119
- supportedAreas: [
120
- {
121
- areaId: 0,
122
- mapId: null, // required: must be null when supportedMaps is empty
123
- areaInfo: {
124
- locationInfo: {
125
- locationName: 'Living Room',
126
- floorNumber: 0,
127
- areaType: 7, // AreaNamespaceTag.LivingRoom
128
- },
129
- landmarkInfo: null,
130
- },
131
- },
132
- {
133
- areaId: 1,
134
- mapId: null,
135
- areaInfo: {
136
- locationInfo: {
137
- locationName: 'Kitchen',
138
- floorNumber: 0,
139
- areaType: 10, // AreaNamespaceTag.Kitchen
140
- },
141
- landmarkInfo: null,
142
- },
143
- },
144
- {
145
- areaId: 2,
146
- mapId: null,
147
- areaInfo: {
148
- locationInfo: {
149
- locationName: 'Bedroom',
150
- floorNumber: 0,
151
- areaType: 2, // AreaNamespaceTag.Bedroom
152
- },
153
- landmarkInfo: null,
154
- },
155
- },
156
- {
157
- areaId: 3,
158
- mapId: null,
159
- areaInfo: {
160
- locationInfo: {
161
- locationName: 'Bathroom',
162
- floorNumber: 0,
163
- areaType: 6, // AreaNamespaceTag.Bathroom
164
- },
165
- landmarkInfo: null,
166
- },
167
- },
168
- ],
169
- selectedAreas: [0, 1, 2, 3], // all areas selected by default
170
- },
171
- },
172
-
173
- handlers: {
174
- rvcRunMode: {
175
- changeToMode: async (request: MatterRequests.ChangeToMode) => this.handleChangeRunMode(request),
176
- },
177
- rvcCleanMode: {
178
- changeToMode: async (request: MatterRequests.ChangeToMode) => this.handleChangeCleanMode(request),
179
- },
180
- rvcOperationalState: {
181
- pause: async () => this.handlePause(),
182
- stop: async () => this.handleStop(),
183
- start: async () => this.handleStart(),
184
- resume: async () => this.handleResume(),
185
- goHome: async () => this.handleGoHome(),
186
- },
187
- serviceArea: {
188
- selectAreas: async (request: MatterRequests.SelectAreas) => this.handleSelectAreas(request),
189
- skipArea: async (request: MatterRequests.SkipArea) => this.handleSkipArea(request),
190
- },
191
- },
192
- })
193
-
194
- this.logInfo('initialized and ready.')
195
- }
196
-
197
- private async handleChangeRunMode(request: MatterRequests.ChangeToMode): Promise<void> {
198
- this.logInfo(`ChangeToMode (run) request received: ${JSON.stringify(request)}`)
199
- const { newMode } = request
200
- const modeStr = ['Idle', 'Cleaning', 'Mapping'][newMode] || `Unknown (mode=${newMode})`
201
- this.logInfo(`changing run mode to: ${modeStr}`)
202
- // TODO: await myVacuumAPI.setRunMode(newMode)
203
-
204
- // Clear any existing timers
205
- this.clearTimers()
206
-
207
- if (newMode === 1) {
208
- // Switching to Cleaning mode - start the vacuum
209
- this.updateOperationalState(1) // Running
210
-
211
- // Simulate cleaning completion after 15 seconds
212
- const completionTimer = setTimeout(() => {
213
- this.logInfo('cleaning completed, returning to dock.')
214
- this.updateRunMode(0) // Set to Idle - cleaning session ending
215
- this.returnToDock()
216
- }, 15000)
217
-
218
- this.activeTimers.push(completionTimer)
219
- } else if (newMode === 0) {
220
- // Switching to Idle mode - return to dock
221
- this.returnToDock()
222
- } else if (newMode === 2) {
223
- // Switching to Mapping mode - start mapping
224
- this.updateOperationalState(1) // Running
225
-
226
- // Simulate mapping completion after 20 seconds
227
- const completionTimer = setTimeout(() => {
228
- this.logInfo('mapping completed, returning to dock.')
229
- this.returnToDock()
230
- }, 20000)
231
-
232
- this.activeTimers.push(completionTimer)
233
- }
234
- }
235
-
236
- private async handleChangeCleanMode(request: MatterRequests.ChangeToMode): Promise<void> {
237
- this.logInfo(`ChangeToMode (clean) request received: ${JSON.stringify(request)}`)
238
- const { newMode } = request
239
- const modes = [
240
- 'Vacuum',
241
- 'Mop',
242
- 'Vacuum & Mop',
243
- 'Deep Clean',
244
- 'Deep Vacuum',
245
- 'Deep Mop',
246
- 'Quick Clean',
247
- 'Max Clean',
248
- 'Min Clean',
249
- 'Quiet Vacuum',
250
- 'Quiet Mop',
251
- 'Night Mode',
252
- 'Eco Vacuum',
253
- 'Eco Mop',
254
- 'Auto',
255
- ]
256
- const modeStr = modes[newMode] || `Unknown (mode=${newMode})`
257
- this.logInfo(`changing clean mode to: ${modeStr}`)
258
- // TODO: await myVacuumAPI.setCleanMode(newMode)
259
- }
260
-
261
- private async handlePause(): Promise<void> {
262
- this.logInfo('pausing.')
263
- // TODO: await myVacuumAPI.pause()
264
- this.clearTimers() // Clear cleaning completion timer
265
- this.updateOperationalState(2) // Paused
266
- }
267
-
268
- private async handleStop(): Promise<void> {
269
- this.logInfo('stopping.')
270
- // TODO: await myVacuumAPI.stop()
271
- this.clearTimers()
272
- this.updateRunMode(0) // Reset to Idle
273
- this.updateOperationalState(0) // Stopped
274
- }
275
-
276
- private async handleStart(): Promise<void> {
277
- this.logInfo('starting (via start command).')
278
- // TODO: await myVacuumAPI.start()
279
-
280
- // Clear any existing timers
281
- this.clearTimers()
282
-
283
- this.updateRunMode(1) // Set to Cleaning mode - this will trigger the run mode handler logic
284
- this.updateOperationalState(1) // Running
285
-
286
- // Simulate cleaning completion after 15 seconds
287
- const completionTimer = setTimeout(() => {
288
- this.logInfo('cleaning completed, returning to dock.')
289
- this.updateRunMode(0) // Set to Idle - cleaning session ending
290
- this.returnToDock()
291
- }, 15000)
292
-
293
- this.activeTimers.push(completionTimer)
294
- }
295
-
296
- private async handleResume(): Promise<void> {
297
- this.logInfo('resuming.')
298
- // TODO: await myVacuumAPI.resume()
299
-
300
- // Clear any existing timers
301
- this.clearTimers()
302
-
303
- this.updateRunMode(1) // Set to Cleaning mode
304
- this.updateOperationalState(1) // Running
305
-
306
- // Simulate cleaning completion after 10 seconds (shorter since resuming)
307
- const completionTimer = setTimeout(() => {
308
- this.logInfo('cleaning completed, returning to dock.')
309
- this.updateRunMode(0) // Set to Idle - cleaning session ending
310
- this.returnToDock()
311
- }, 10000)
312
-
313
- this.activeTimers.push(completionTimer)
314
- }
315
-
316
- private async handleGoHome(): Promise<void> {
317
- this.logInfo('goHome command received.')
318
- // TODO: await myVacuumAPI.goHome()
319
-
320
- // Clear any existing timers
321
- this.clearTimers()
322
-
323
- // Defer state updates to ensure handler completes first
324
- setImmediate(() => {
325
- // Set to Idle mode since we're ending the cleaning session
326
- this.updateRunMode(0)
327
-
328
- // Initiate return to dock sequence
329
- this.returnToDock()
330
- })
331
- }
332
-
333
- private async handleSelectAreas(request: MatterRequests.SelectAreas): Promise<void> {
334
- this.logInfo(`SelectAreas request received: ${JSON.stringify(request)}`)
335
- const { newAreas } = request
336
- const areaNames = newAreas.map((id: number) =>
337
- ['Living Room', 'Kitchen', 'Bedroom', 'Bathroom'][id] || `Area ${id}`,
338
- )
339
- this.logInfo(`selecting areas: ${areaNames.join(', ')}`)
340
- // TODO: await myVacuumAPI.selectAreas(newAreas)
341
- }
342
-
343
- private async handleSkipArea(request: MatterRequests.SkipArea): Promise<void> {
344
- this.logInfo(`SkipArea request received: ${JSON.stringify(request)}`)
345
- const { skippedArea } = request
346
- const areaName = ['Living Room', 'Kitchen', 'Bedroom', 'Bathroom'][skippedArea] || `Area ${skippedArea}`
347
- this.logInfo(`skipping area: ${areaName}`)
348
- // TODO: await myVacuumAPI.skipArea(skippedArea)
349
- }
350
-
351
- /**
352
- * Helper method to clear all active timers
353
- */
354
- private clearTimers(): void {
355
- this.activeTimers.forEach(timer => clearTimeout(timer))
356
- this.activeTimers = []
357
- }
358
-
359
- /**
360
- * Helper method to initiate return to dock sequence
361
- * Can be called synchronously from other handlers
362
- */
363
- private returnToDock(): void {
364
- this.logInfo('initiating return to dock sequence.')
365
-
366
- // Defer ALL state updates to ensure handler completes first
367
- setImmediate(() => {
368
- // Start seeking charger directly (skip intermediate Stopped state)
369
- this.updateOperationalState(64) // Seeking Charger
370
-
371
- // After 5 seconds, start charging
372
- const chargingTimer = setTimeout(() => {
373
- this.logInfo('reached dock, now charging.')
374
- this.updateOperationalState(65) // Charging
375
-
376
- // After 3 more seconds, fully docked
377
- const dockedTimer = setTimeout(() => {
378
- this.logInfo('fully charged and docked.')
379
- this.updateOperationalState(66) // Docked
380
- }, 3000)
381
-
382
- this.activeTimers.push(dockedTimer)
383
- }, 5000)
384
-
385
- this.activeTimers.push(chargingTimer)
386
- })
387
- }
388
-
389
- /**
390
- * Update Methods - Use these to update the vacuum state from your API/device
391
- *
392
- * Since this is a platform accessory, state updates work immediately after registration.
393
- */
394
-
395
- public updateOperationalState(state: number): void {
396
- this.updateState('rvcOperationalState', { operationalState: state })
397
- const states = [
398
- 'Stopped',
399
- 'Running',
400
- 'Paused',
401
- 'Error',
402
- null,
403
- null,
404
- null,
405
- null,
406
- ...Array.from({ length: 56 }).fill(null),
407
- 'Seeking Charger',
408
- 'Charging',
409
- 'Docked',
410
- ]
411
- this.logInfo(`operational state updated to: ${states[state] || `Unknown (${state})`}`)
412
- }
413
-
414
- public updateRunMode(mode: number): void {
415
- this.updateState('rvcRunMode', { currentMode: mode })
416
- const modes = ['Idle', 'Cleaning', 'Mapping']
417
- this.logInfo(`run mode updated to: ${modes[mode] || `Unknown (${mode})`}`)
418
- }
419
-
420
- public updateCleanMode(mode: number): void {
421
- this.updateState('rvcCleanMode', { currentMode: mode })
422
- const modes = [
423
- 'Vacuum',
424
- 'Mop',
425
- 'Vacuum & Mop',
426
- 'Deep Clean',
427
- 'Deep Vacuum',
428
- 'Deep Mop',
429
- 'Quick Clean',
430
- 'Max Clean',
431
- 'Min Clean',
432
- 'Quiet Vacuum',
433
- 'Quiet Mop',
434
- 'Night Mode',
435
- 'Eco Vacuum',
436
- 'Eco Mop',
437
- 'Auto',
438
- ]
439
- this.logInfo(`clean mode updated to: ${modes[mode] || `Unknown (${mode})`}`)
440
- }
441
-
442
- public updateSelectedAreas(areaIds: number[]): void {
443
- this.updateState('serviceArea', { selectedAreas: areaIds })
444
- const areaNames = areaIds.map(id =>
445
- ['Living Room', 'Kitchen', 'Bedroom', 'Bathroom'][id] || `Area ${id}`,
446
- )
447
- this.logInfo(`selected areas updated to: ${areaNames.join(', ') || 'All Areas'}`)
448
- }
449
-
450
- public updateCurrentArea(areaId: number | null): void {
451
- this.updateState('serviceArea', { currentArea: areaId })
452
- if (areaId !== null) {
453
- const areaName = ['Living Room', 'Kitchen', 'Bedroom', 'Bathroom'][areaId] || `Area ${areaId}`
454
- this.logInfo(`current area updated to: ${areaName}`)
455
- } else {
456
- this.logInfo('current area cleared')
457
- }
458
- }
459
-
460
- public updateProgress(progress: Array<{ areaId: number, status: number }>): void {
461
- this.updateState('serviceArea', { progress })
462
- this.logInfo(`progress updated: ${progress.length} areas`)
463
- }
464
-
465
- /**
466
- * Update battery percentage
467
- * @param percentage - Battery percentage (0-100)
468
- */
469
- public async updateBatteryPercentage(percentage: number): Promise<void> {
470
- // Convert percentage to Matter format (0-200, where 200 = 100%)
471
- const batPercentRemaining = Math.max(0, Math.min(200, Math.round(percentage * 2)))
472
-
473
- // Determine charge level based on percentage
474
- let batChargeLevel = 0 // Ok
475
- if (percentage < 20) {
476
- batChargeLevel = 2 // Critical
477
- } else if (percentage < 40) {
478
- batChargeLevel = 1 // Warning
479
- }
480
-
481
- await this.updateState('powerSource', { batPercentRemaining, batChargeLevel })
482
- this.logInfo(`battery updated to: ${percentage}% (${batChargeLevel === 0 ? 'Ok' : batChargeLevel === 1 ? 'Warning' : 'Critical'})`)
483
- }
484
- }
@@ -1,59 +0,0 @@
1
- /**
2
- * Smoke/CO Alarm Accessory Class
3
- */
4
-
5
- import type { API, Logger } from 'homebridge'
6
-
7
- import { BaseMatterAccessory } from './BaseMatterAccessory.js'
8
-
9
- export class SmokeCOAlarmAccessory extends BaseMatterAccessory {
10
- constructor(api: API, log: Logger) {
11
- const serialNumber = 'SENSOR-006'
12
- const SmokeCoAlarmServer = api.matter.deviceTypes.SmokeSensor.requirements.SmokeCoAlarmServer
13
- const SmokeSensorWithBoth = api.matter.deviceTypes.SmokeSensor.with(
14
- SmokeCoAlarmServer.with('SmokeAlarm', 'CoAlarm'),
15
- )
16
-
17
- super(api, log, {
18
- uuid: api.matter.uuid.generate(serialNumber),
19
- displayName: 'Smoke Sensor',
20
- deviceType: SmokeSensorWithBoth,
21
- serialNumber,
22
- manufacturer: 'Homebridge Matter',
23
- model: 'HB-MATTER-SENSOR-SMOKE-CO',
24
- firmwareRevision: '2.0.0',
25
- hardwareRevision: '1.0.0',
26
-
27
- clusters: {
28
- smokeCoAlarm: {
29
- smokeState: 0, // 0 = normal, 1 = warning, 2 = critical
30
- coState: 0,
31
- batteryAlert: 0,
32
- deviceMuted: 0,
33
- testInProgress: false,
34
- hardwareFaultAlert: false,
35
- endOfServiceAlert: 0,
36
- interconnectSmokeAlarm: 0,
37
- interconnectCoAlarm: 0,
38
- contaminationState: 0,
39
- smokeSensitivityLevel: 1,
40
- expressedState: 0,
41
- },
42
- },
43
- })
44
-
45
- this.logInfo('initialized.')
46
- }
47
-
48
- public updateSmokeState(state: 0 | 1 | 2): void {
49
- this.updateState('smokeCoAlarm', { smokeState: state })
50
- const stateStr = ['Normal', 'Warning', 'Critical'][state]
51
- this.logInfo(`smoke state: ${stateStr}.`)
52
- }
53
-
54
- public updateCOState(state: 0 | 1 | 2): void {
55
- this.updateState('smokeCoAlarm', { coState: state })
56
- const stateStr = ['Normal', 'Warning', 'Critical'][state]
57
- this.logInfo(`co state: ${stateStr}.`)
58
- }
59
- }
@@ -1,39 +0,0 @@
1
- /**
2
- * Temperature Sensor Accessory Class
3
- */
4
-
5
- import type { API, Logger } from 'homebridge'
6
-
7
- import { BaseMatterAccessory } from './BaseMatterAccessory.js'
8
-
9
- export class TemperatureSensorAccessory extends BaseMatterAccessory {
10
- constructor(api: API, log: Logger) {
11
- const serialNumber = 'SENSOR-004'
12
- super(api, log, {
13
- uuid: api.matter.uuid.generate(serialNumber),
14
- displayName: 'Temperature Sensor',
15
- deviceType: api.matter.deviceTypes.TemperatureSensor,
16
- serialNumber,
17
- manufacturer: 'Homebridge Matter',
18
- model: 'HB-MATTER-SENSOR-TEMPERATURE',
19
- firmwareRevision: '2.0.0',
20
- hardwareRevision: '1.0.0',
21
-
22
- clusters: {
23
- temperatureMeasurement: {
24
- measuredValue: 2100, // 21.00°C (in hundredths)
25
- minMeasuredValue: -5000,
26
- maxMeasuredValue: 10000,
27
- },
28
- },
29
- })
30
-
31
- this.logInfo('initialized.')
32
- }
33
-
34
- public updateTemperature(celsius: number): void {
35
- const value = Math.round(celsius * 100) // convert to hundredths
36
- this.updateState('temperatureMeasurement', { measuredValue: value })
37
- this.logInfo(`temperature: ${celsius}°C.`)
38
- }
39
- }
@@ -1,105 +0,0 @@
1
- /**
2
- * Thermostat Accessory Class
3
- */
4
-
5
- import type { API, Logger, MatterRequests } from 'homebridge'
6
-
7
- import { BaseMatterAccessory } from './BaseMatterAccessory.js'
8
-
9
- export class ThermostatAccessory extends BaseMatterAccessory {
10
- constructor(api: API, log: Logger) {
11
- const serialNumber = 'THERMOSTAT-001'
12
- super(api, log, {
13
- uuid: api.matter.uuid.generate(serialNumber),
14
- displayName: 'Thermostat',
15
- deviceType: api.matter.deviceTypes.Thermostat,
16
- serialNumber,
17
- manufacturer: 'Homebridge Matter',
18
- model: 'HB-MATTER-THERMOSTAT',
19
- firmwareRevision: '2.0.0',
20
- hardwareRevision: '1.0.0',
21
-
22
- clusters: {
23
- thermostat: {
24
- localTemperature: 2100, // 21.00°C
25
- occupiedHeatingSetpoint: 2000,
26
- occupiedCoolingSetpoint: 2400,
27
- minHeatSetpointLimit: 700,
28
- maxHeatSetpointLimit: 3000,
29
- minCoolSetpointLimit: 1600,
30
- maxCoolSetpointLimit: 3200,
31
- controlSequenceOfOperation: 4, // cooling and heating
32
- systemMode: 0, // off
33
- },
34
- },
35
-
36
- handlers: {
37
- thermostat: {
38
- setpointRaiseLower: async (request: MatterRequests.SetpointRaiseLower) =>
39
- this.handleSetpointRaiseLower(request),
40
- systemModeChange: async (request: { systemMode: number, oldSystemMode: number }) =>
41
- this.handleSystemModeChange(request),
42
- occupiedHeatingSetpointChange: async (request: { occupiedHeatingSetpoint: number, oldOccupiedHeatingSetpoint: number }) =>
43
- this.handleOccupiedHeatingSetpointChange(request),
44
- occupiedCoolingSetpointChange: async (request: { occupiedCoolingSetpoint: number, oldOccupiedCoolingSetpoint: number }) =>
45
- this.handleOccupiedCoolingSetpointChange(request),
46
- },
47
- },
48
- })
49
-
50
- this.logInfo('initialized.')
51
- }
52
-
53
- private async handleSetpointRaiseLower(request: MatterRequests.SetpointRaiseLower): Promise<void> {
54
- this.logInfo(`SetpointRaiseLower request: ${JSON.stringify(request)}`)
55
- const { mode, amount } = request
56
- const tempChange = amount / 10 // convert from tenths to degrees
57
- this.logInfo(`adjusting setpoint by ${tempChange}°C (mode: ${mode}).`)
58
- // TODO: await myThermostatAPI.adjustSetpoint(mode, tempChange)
59
- }
60
-
61
- private async handleSystemModeChange(request: { systemMode: number, oldSystemMode: number }): Promise<void> {
62
- this.logInfo(`SystemMode change: ${JSON.stringify(request)}`)
63
- // Matter Thermostat SystemMode enum: 0=Off, 1=Auto, 3=Cool, 4=Heat, 5=EmergencyHeat, 6=Precooling, 7=FanOnly
64
- const modeNames = ['Off', 'Auto', 'Reserved', 'Cool', 'Heat', 'Emergency Heating', 'Precooling', 'Fan Only']
65
- const modeName = modeNames[request.systemMode] || `Unknown (${request.systemMode})`
66
- this.logInfo(`system mode changed to: ${modeName}.`)
67
- // TODO: await myThermostatAPI.setSystemMode(request.systemMode)
68
- }
69
-
70
- private async handleOccupiedHeatingSetpointChange(request: { occupiedHeatingSetpoint: number, oldOccupiedHeatingSetpoint: number }): Promise<void> {
71
- this.logInfo(`OccupiedHeatingSetpoint change: ${JSON.stringify(request)}`)
72
- const celsius = request.occupiedHeatingSetpoint / 100 // convert from hundredths to degrees
73
- this.logInfo(`heating setpoint changed to: ${celsius}°C.`)
74
- // TODO: await myThermostatAPI.setHeatingSetpoint(celsius)
75
- }
76
-
77
- private async handleOccupiedCoolingSetpointChange(request: { occupiedCoolingSetpoint: number, oldOccupiedCoolingSetpoint: number }): Promise<void> {
78
- this.logInfo(`OccupiedCoolingSetpoint change: ${JSON.stringify(request)}`)
79
- const celsius = request.occupiedCoolingSetpoint / 100 // convert from hundredths to degrees
80
- this.logInfo(`cooling setpoint changed to: ${celsius}°C.`)
81
- // TODO: await myThermostatAPI.setCoolingSetpoint(celsius)
82
- }
83
-
84
- public updateCurrentTemperature(celsius: number): void {
85
- const value = Math.round(celsius * 100)
86
- this.updateState('thermostat', { localTemperature: value })
87
- this.logInfo(`current temperature: ${celsius}°C.`)
88
- }
89
-
90
- public updateHeatingSetpoint(celsius: number): void {
91
- const value = Math.round(celsius * 100)
92
- this.updateState('thermostat', { occupiedHeatingSetpoint: value })
93
- this.logInfo(`heating setpoint: ${celsius}°C.`)
94
- }
95
-
96
- public updateCoolingSetpoint(celsius: number): void {
97
- const value = Math.round(celsius * 100)
98
- this.updateState('thermostat', { occupiedCoolingSetpoint: value })
99
- this.logInfo(`cooling setpoint: ${celsius}°C.`)
100
- }
101
-
102
- public updateSystemMode(mode: number): void {
103
- this.updateState('thermostat', { systemMode: mode })
104
- }
105
- }