node-red-contrib-velbus-2026 0.10.3 → 0.10.4

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 (5) hide show
  1. package/CHANGELOG_FORUM.md +33 -0
  2. package/HANDOVER.md +1 -1
  3. package/README.md +23 -5
  4. package/package.json +1 -1
  5. package/velbus-2026-repo.bundle +0 -0
package/CHANGELOG_FORUM.md CHANGED
@@ -29,6 +29,39 @@ separate duplicate-table bugs took to fully resolve.
29
29
 
30
30
  ---
31
31
 
32
+ ## v0.10.4 — 09/07/2026
33
+
34
+ ### README.md — fixed real staleness, now publicly visible on the Flow Library
35
+
36
+ - **Prompted by successfully getting listed on the Node-RED Flow Library**
37
+ (`flows.nodered.org/node/node-red-contrib-velbus-2026`) — checked the
38
+ rendered page and found the displayed README was genuinely stale, not a
39
+ caching artifact: `velbus-glass-panel` still said "26 types" (actually 29),
40
+ `velbus-button` still listed only the original 6 types (actually 12, plus
41
+ lock/unlock/status/naming capability added since), `velbus-sensor` didn't
42
+ mention `VMB6IN` or the new generic analogue reading, `velbus-clock`
43
+ didn't mention sunrise/sunset, and the tarball install example still
44
+ hardcoded `v0.8.1`.
45
+ - **Root cause:** `README.md` was fixed once, early on, during initial npm
46
+ publish prep — then never touched again despite `HANDOVER.md` and
47
+ `CHANGELOG_FORUM.md` being kept scrupulously current through every
48
+ subsequent change. This is the user-facing document (visible on both npm
49
+ and the Flow Library), arguably more consequential to get right than the
50
+ developer-facing ones, and it drifted the most.
51
+ - **Fixed the specific staleness, and the root cause of it recurring:**
52
+ the hardcoded tarball version number is now written as `vX.Y.Z` with an
53
+ explanatory note, rather than a literal version that will go stale again
54
+ next release exactly as it did this time.
55
+ - Added pointers to `HANDOVER.md`, `CHANGELOG_FORUM.md`, and
56
+ `coverage-roadmap.md` — none of which were linked from `README.md` at all
57
+ before, despite being genuinely useful to anyone landing on the repo.
58
+ - Also confirmed, while investigating: the earlier concern about Node-RED's
59
+ post-2022 scoped-package naming policy did **not** block Flow Library
60
+ approval — this package is listed successfully under its original
61
+ unscoped name.
62
+
63
+ ---
64
+
32
65
  ## v0.10.3 — 09/07/2026
33
66
 
34
67
  ### velbus-glass-panel — VMBEL edge colour control (set_edge_color)
package/HANDOVER.md CHANGED
@@ -6,7 +6,7 @@ you're a new contributor, a new maintainer, or an AI assistant starting a fresh
6
6
  with no memory of previous work — this document should be sufficient on its own, together
7
7
  with the source code in this repository, to continue development competently.
8
8
 
9
- Current state at time of writing: **v0.10.3, 19 nodes, published on npm.**
9
+ Current state at time of writing: **v0.10.4, 19 nodes, published on npm.**
10
10
 
11
11
  ---
12
12
 
package/README.md CHANGED
@@ -52,8 +52,11 @@ npm install node-red-contrib-velbus-2026
52
52
  Via local tarball:
53
53
  ```bash
54
54
  cd ~/.node-red
55
- npm install /path/to/node-red-contrib-velbus-2026_v0.8.1.tar.gz
55
+ npm install /path/to/node-red-contrib-velbus-2026_vX.Y.Z.tar.gz
56
56
  ```
57
+ (replace `X.Y.Z` with whichever version tarball you have — deliberately not
58
+ hardcoded here, since a literal version number in this file has gone stale
59
+ every single time it's been written one before)
57
60
 
58
61
  ---
59
62
 
@@ -68,13 +71,13 @@ npm install /path/to/node-red-contrib-velbus-2026_v0.8.1.tar.gz
68
71
  ### Inputs (teal)
69
72
  | Node | Modules |
70
73
  |---|---|
71
- | `velbus-glass-panel` | All VMBEL and VMBGP variants — 26 types including OLED, PIR, and original series. Thermostat, LED control, open collector. |
74
+ | `velbus-glass-panel` | All VMBEL and VMBGP variants — 29 types including OLED, PIR, and original series. Thermostat, LED control, open collector. `VMBEL` family only: edge colour control (`set_edge_color`) — applies an already-defined colour across layer/edge/page combinations; defining new custom colours stays in VelbusLink. |
72
75
  | `velbus-thermostat` | Dedicated thermostat node for all glass panel modules. |
73
- | `velbus-button` | VMB8PB, VMB8PBU, VMB6PBN, VMB2PBN, VMB4PB, VMB6PB-20 |
76
+ | `velbus-button` | 12 types across original and V2 series: VMB8PB, VMB8PBU, VMB6PBN, VMB2PBN, VMB4PB, VMB6PB-20, VMB8IR, VMB4PD, VMB4RF, VMBRFR8S, VMBVP01, VMBKP, VMBIN. Lock/unlock and richer status decode where the specific type supports it (not universal); named channels in event output; fixed semantic labels for VMBVP01 (DoorBird). |
74
77
  | `velbus-pir` | VMBPIRM, VMBPIRC, VMBPIRO, VMBPIRO-10 |
75
78
  | `velbus-pir-20` | VMBPIR-20, VMBPIRO-20 |
76
79
  | `velbus-meteo` | VMBMETEO — wind, rain, light, temperature, alarm outputs |
77
- | `velbus-sensor` | VMB7IN (8 digital inputs + 4 pulse counters), VMB4AN (16-channel analogue/alarm) |
80
+ | `velbus-sensor` | VMB7IN (8 digital inputs + 4 pulse counters), VMB4AN (channels 1-8 alarm outputs + generic analogue reading on channels 9-12 — mode-aware but deliberately no engineering-unit conversion), VMB6IN (6 digital inputs) |
78
81
  | `velbus-sensor-20` | VMB8IN-20 (8 digital + 24 alarm channels via subaddresses, energy counters) |
79
82
 
80
83
  ### Outputs (blue)
@@ -87,7 +90,7 @@ npm install /path/to/node-red-contrib-velbus-2026_v0.8.1.tar.gz
87
90
  | `velbus-blind` | VMB1BL, VMB2BL — original series, stop/up/down only |
88
91
  | `velbus-blind-s` | VMB1BLS, VMB2BLE, VMB2BLE-10 — full position, lock, force, inhibit |
89
92
  | `velbus-blind-20` | VMB2BLE-20 — V2 series with CAN FD support |
90
- | `velbus-clock` | No fixed module — broadcasts time/date/DST to bus address `0x00`, plus global/local clock alarm (V2 series only) |
93
+ | `velbus-clock` | No fixed module — broadcasts time/date/DST to bus address `0x00`, plus global/local clock alarm and sunrise/sunset enable (V2 series only) |
91
94
  | `velbus-energy` | VMBPSUMNGR-20 — power supply manager: PSU load, live wattage/voltage/amperage, warranty counter, PSU alarms (V2 series only) |
92
95
 
93
96
  ---
@@ -122,6 +125,21 @@ at `/velbus`.
122
125
 
123
126
  Tested on a live 18-module installation including VMBEL4, VMBELO, VMBELPIR,
124
127
  VMBPIR-20, VMB1RYS, and VMB8DC-20. CAN FD modules confirmed working.
128
+ `VMBGPOD` specifically confirmed against two real panels on a separate
129
+ installation, after an earlier gap where it showed as `unknown` in a scan.
130
+
131
+ ---
132
+
133
+ ## Further documentation
134
+
135
+ - [`HANDOVER.md`](https://github.com/MDAR/node-red-contrib-velbus-2026/blob/main/HANDOVER.md) —
136
+ comprehensive technical reference for developing this palette: architecture, protocol
137
+ quirks found the hard way, per-node testing status, and known open issues. Written to
138
+ assume no prior context.
139
+ - [`CHANGELOG_FORUM.md`](https://github.com/MDAR/node-red-contrib-velbus-2026/blob/main/CHANGELOG_FORUM.md) —
140
+ full version-by-version development history, including *why* things changed, not just what.
141
+ - [`coverage-roadmap.md`](https://github.com/MDAR/node-red-contrib-velbus-2026/blob/main/coverage-roadmap.md) —
142
+ every Velbus module type and feature considered for this palette, what's in scope, and why.
125
143
 
126
144
  ---
127
145
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "node-red-contrib-velbus-2026",
3
- "version": "0.10.3",
3
+ "version": "0.10.4",
4
4
  "description": "Node-RED palette for Velbus building automation \u2014 relay, dimmer, glass panel, PIR, blind, sensor, meteo, clock nodes. Original and V2 (-20) series.",
5
5
  "keywords": [
6
6
  "node-red",
package/velbus-2026-repo.bundle CHANGED
Binary file