homebridge-lanternic 0.1.2 → 0.1.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.
- package/README.md +11 -8
- package/package.json +4 -4
package/README.md
CHANGED
|
@@ -1,12 +1,17 @@
|
|
|
1
1
|
# Homebridge LanternIC
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
[](https://www.npmjs.com/package/homebridge-lanternic)
|
|
4
|
+
[](https://www.npmjs.com/package/homebridge-lanternic)
|
|
5
|
+
[](https://github.com/Gibsonmb71/homebridge-lanternic/actions/workflows/ci.yml)
|
|
6
|
+
[](https://www.npmjs.com/package/homebridge-lanternic)
|
|
7
|
+
[](https://homebridge.io/)
|
|
8
|
+
[](LICENSE)
|
|
4
9
|
|
|
5
|
-
|
|
10
|
+
Homebridge plugin for BLE RGBIC/RGBWIC light strips controlled by the Magic Lantern app.
|
|
6
11
|
|
|
7
12
|
## Status
|
|
8
13
|
|
|
9
|
-
|
|
14
|
+
These unbranded Magic Lantern BLE strips ship with multiple firmware variants so it's hard to ensure compatibility for all strips.
|
|
10
15
|
|
|
11
16
|
- HomeKit Lightbulb service
|
|
12
17
|
- On/off with RGB-black fallback plus optional native Magic Lantern power frames
|
|
@@ -18,11 +23,11 @@ LanternIC is a hardware-tested pre-release plugin. It is designed for production
|
|
|
18
23
|
- Command-builder tests for the known Magic Lantern frames
|
|
19
24
|
- Package smoke tests against Homebridge 1 and 2 on Node.js 22 and 24 in CI
|
|
20
25
|
|
|
21
|
-
Effects
|
|
26
|
+
Effects and segment control are not supported as there is no good way to expose them in Apple Home.
|
|
22
27
|
|
|
23
28
|
## Install
|
|
24
29
|
|
|
25
|
-
|
|
30
|
+
Install it like any other Homebridge plugin:
|
|
26
31
|
|
|
27
32
|
```sh
|
|
28
33
|
sudo npm install -g homebridge-lanternic
|
|
@@ -213,7 +218,7 @@ The core frames available here are:
|
|
|
213
218
|
- Effect speed: `7e0402xxffffff00ef`, where `xx` is 0-100 decimal encoded as one byte
|
|
214
219
|
- Basic effect: `7e0503xx06ffff00ef`
|
|
215
220
|
|
|
216
|
-
These
|
|
221
|
+
> These Magic Lantern BLE frame notes are based on packet-captures from [@kassabov](https://github.com/kassabov) in Home Assistant Core issue [#145934](https://github.com/home-assistant/core/issues/145934). (thanks!)
|
|
217
222
|
|
|
218
223
|
- Home Assistant Core issue: <https://github.com/home-assistant/core/issues/145934>
|
|
219
224
|
- Home Assistant community thread: <https://community.home-assistant.io/t/new-integration-for-ble-magic-lantern/454055>
|
|
@@ -233,8 +238,6 @@ The command builders are isolated so we can add variants if your strip uses a sl
|
|
|
233
238
|
|
|
234
239
|
## Reliability Choices
|
|
235
240
|
|
|
236
|
-
This plugin avoids the usual BLE plugin failure pattern of overlapping scans, overlapping writes, and stale connections:
|
|
237
|
-
|
|
238
241
|
- All BLE operations are serialized through a single manager queue.
|
|
239
242
|
- Every characteristic write has a timeout and is retried with exponential backoff.
|
|
240
243
|
- Failed writes force a disconnect and rediscovery.
|
package/package.json
CHANGED
|
@@ -2,17 +2,17 @@
|
|
|
2
2
|
"name": "homebridge-lanternic",
|
|
3
3
|
"displayName": "LanternIC",
|
|
4
4
|
"type": "module",
|
|
5
|
-
"version": "0.1.
|
|
5
|
+
"version": "0.1.3",
|
|
6
6
|
"description": "Homebridge plugin for BLE RGBIC/RGBWIC light strips controlled by the Magic Lantern app.",
|
|
7
7
|
"author": "Gibson Bell",
|
|
8
8
|
"license": "MIT",
|
|
9
|
-
"homepage": "https://github.com/
|
|
9
|
+
"homepage": "https://github.com/Gibsonmb71/homebridge-lanternic#readme",
|
|
10
10
|
"repository": {
|
|
11
11
|
"type": "git",
|
|
12
|
-
"url": "git+https://github.com/
|
|
12
|
+
"url": "git+https://github.com/Gibsonmb71/homebridge-lanternic.git"
|
|
13
13
|
},
|
|
14
14
|
"bugs": {
|
|
15
|
-
"url": "https://github.com/
|
|
15
|
+
"url": "https://github.com/Gibsonmb71/homebridge-lanternic/issues"
|
|
16
16
|
},
|
|
17
17
|
"keywords": [
|
|
18
18
|
"homebridge-plugin",
|