iobroker.tint 0.3.0 → 0.3.1
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 +88 -46
- package/io-package.json +14 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -54,39 +54,20 @@ iobroker add tint
|
|
|
54
54
|
|
|
55
55
|
## Configuration
|
|
56
56
|
|
|
57
|
-
| Parameter | Default | Description |
|
|
58
|
-
|-----------|---------|-------------|
|
|
59
|
-
| IP address | `192.168.1.100` | IP address of the deCONZ / ConBee gateway |
|
|
60
|
-
| REST port | `80` | HTTP port of the deCONZ REST API |
|
|
61
|
-
| WebSocket port | `443` | WebSocket port used by deCONZ for push events |
|
|
62
|
-
| API key | *(empty)* | deCONZ API key (unlock in Phoscon / deCONZ settings) |
|
|
63
|
-
| Polling interval | `60` | Fallback REST poll interval in seconds |
|
|
64
|
-
| Auto-apply color wheel | `true` | Automatically set the chosen color on the active zone when the remote color wheel is turned |
|
|
65
|
-
| Transition time | `4` | Default light transition time in steps of 100 ms (4 = 400 ms) |
|
|
66
|
-
| Watchdog (minutes) | `120` | Watchdog timeout; adapter reconnects after this many minutes without a WebSocket event |
|
|
67
|
-
|
|
68
|
-
### Obtaining a deCONZ API key
|
|
69
|
-
|
|
70
|
-
1. Open the Phoscon web interface (usually `http://<gateway-ip>/pwa`).
|
|
71
|
-
2. Go to **Settings → Gateway → Advanced**.
|
|
72
|
-
3. Click **Authenticate app** and copy the generated API key.
|
|
73
|
-
|
|
74
|
-
Alternatively unlock via the deCONZ desktop app: **Menu → Settings → Gateway → Allow new connections** then call `/api` POST endpoint.
|
|
75
|
-
|
|
76
57
|
## Object structure
|
|
77
58
|
|
|
78
59
|
### Lights (`lights.<id>.*`)
|
|
79
60
|
|
|
80
61
|
| State | Type | R/W | Description |
|
|
81
|
-
|
|
62
|
+
|---|---|---|---|
|
|
82
63
|
| `info.name` | string | R | Light name from deCONZ |
|
|
83
64
|
| `info.modelid` | string | R | Model identifier |
|
|
84
65
|
| `info.manufacturer` | string | R | Manufacturer name |
|
|
85
66
|
| `info.reachable` | boolean | R | Zigbee reachability |
|
|
86
67
|
| `info.uniqueid` | string | R | Zigbee IEEE address |
|
|
87
68
|
| `state.on` | boolean | R/W | On / off |
|
|
88
|
-
| `state.brightness` | number (%) | R/W | Brightness 0–100
|
|
89
|
-
| `state.colorTemp` | number (K) | R/W | Color temperature 2000–6500
|
|
69
|
+
| `state.brightness` | number (%) | R/W | Brightness 0–100 % |
|
|
70
|
+
| `state.colorTemp` | number (K) | R/W | Color temperature 2000–6500 K |
|
|
90
71
|
| `state.hue` | number | R/W | Hue 0–65535 |
|
|
91
72
|
| `state.saturation` | number | R/W | Saturation 0–254 |
|
|
92
73
|
| `state.hex` | string | R/W | RGB color as `#RRGGBB` hex string |
|
|
@@ -95,29 +76,29 @@ Alternatively unlock via the deCONZ desktop app: **Menu → Settings → Gateway
|
|
|
95
76
|
| `state.colorMode` | string | R | Active color mode (`ct`, `xy`, `hs`) |
|
|
96
77
|
| `state.effect` | string | R/W | Light effect (`none`, `colorloop`, …) |
|
|
97
78
|
| `state.effectSpeed` | number | R/W | Effect speed 0–255 |
|
|
98
|
-
| `state.transitionTime` | number (×100
|
|
79
|
+
| `state.transitionTime` | number (×100 ms) | R/W | Per-light transition time override |
|
|
99
80
|
|
|
100
81
|
### Groups (`groups.<id>.*`)
|
|
101
82
|
|
|
102
83
|
| State | Type | R/W | Description |
|
|
103
|
-
|
|
84
|
+
|---|---|---|---|
|
|
104
85
|
| `info.name` | string | R | Group name |
|
|
105
86
|
| `info.memberCount` | number | R | Number of lights in the group |
|
|
106
87
|
| `info.allOn` | boolean | R | `true` when all lights in the group are on |
|
|
107
88
|
| `info.anyOn` | boolean | R | `true` when at least one light is on |
|
|
108
89
|
| `action.on` | boolean | R/W | Switch all lights in the group |
|
|
109
|
-
| `action.brightness` | number (%) | R/W | Group brightness 0–100
|
|
110
|
-
| `action.colorTemp` | number (K) | R/W | Group color temperature 2000–6500
|
|
90
|
+
| `action.brightness` | number (%) | R/W | Group brightness 0–100 % |
|
|
91
|
+
| `action.colorTemp` | number (K) | R/W | Group color temperature 2000–6500 K |
|
|
111
92
|
| `action.hex` | string | R/W | Group RGB color as `#RRGGBB` |
|
|
112
93
|
| `action.effect` | string | R/W | Group light effect |
|
|
113
|
-
| `action.transitionTime` | number (×100
|
|
94
|
+
| `action.transitionTime` | number (×100 ms) | R/W | Group transition time override |
|
|
114
95
|
| `action.activateScene` | string | R/W | Write a scene name to recall it |
|
|
115
96
|
| `scenes.<name>` | boolean | R/W | Set to `true` to recall this scene |
|
|
116
97
|
|
|
117
98
|
### Remotes (`remotes.<id>.*`)
|
|
118
99
|
|
|
119
100
|
| State | Type | R/W | Description |
|
|
120
|
-
|
|
101
|
+
|---|---|---|---|
|
|
121
102
|
| `info.name` | string | R | Remote name |
|
|
122
103
|
| `info.battery` | number (%) | R | Battery charge level |
|
|
123
104
|
| `info.reachable` | boolean | R | Zigbee reachability |
|
|
@@ -126,7 +107,7 @@ Alternatively unlock via the deCONZ desktop app: **Menu → Settings → Gateway
|
|
|
126
107
|
| `button.lastEventName` | string | R | Human-readable event name |
|
|
127
108
|
| `button.pressType` | string | R | `short`, `hold`, or `release` |
|
|
128
109
|
| `button.activeZone` | number | R | Active zone: 0 = all, 1–3 = zone 1–3 |
|
|
129
|
-
| `colorWheel.angle` | number (°) | R | Color wheel angle 0–359
|
|
110
|
+
| `colorWheel.angle` | number (°) | R | Color wheel angle 0–359 ° |
|
|
130
111
|
| `colorWheel.x` | number | R | CIE x of the selected color |
|
|
131
112
|
| `colorWheel.y` | number | R | CIE y of the selected color |
|
|
132
113
|
| `colorWheel.hex` | string | R | Selected color as `#RRGGBB` |
|
|
@@ -135,6 +116,69 @@ Alternatively unlock via the deCONZ desktop app: **Menu → Settings → Gateway
|
|
|
135
116
|
| `colorTemp.mired` | number | R | Selected color temperature in mired |
|
|
136
117
|
| `colorTemp.pressType` | string | R | `short` or `hold` |
|
|
137
118
|
|
|
119
|
+
### Plugs (`plugs.<id>.*`)
|
|
120
|
+
|
|
121
|
+
| State | Type | R/W | Description |
|
|
122
|
+
|---|---|---|---|
|
|
123
|
+
| `info.name` | string | R | Plug name from deCONZ |
|
|
124
|
+
| `info.modelid` | string | R | Model identifier |
|
|
125
|
+
| `info.manufacturer` | string | R | Manufacturer name |
|
|
126
|
+
| `info.reachable` | boolean | R | Zigbee reachability |
|
|
127
|
+
| `info.uniqueid` | string | R | Zigbee IEEE address |
|
|
128
|
+
| `state.on` | boolean | R/W | On / off |
|
|
129
|
+
|
|
130
|
+
### Covers (`covers.<id>.*`)
|
|
131
|
+
|
|
132
|
+
| State | Type | R/W | Description |
|
|
133
|
+
|---|---|---|---|
|
|
134
|
+
| `info.name` | string | R | Cover name from deCONZ |
|
|
135
|
+
| `info.modelid` | string | R | Model identifier |
|
|
136
|
+
| `info.manufacturer` | string | R | Manufacturer name |
|
|
137
|
+
| `info.reachable` | boolean | R | Zigbee reachability |
|
|
138
|
+
| `info.uniqueid` | string | R | Zigbee IEEE address |
|
|
139
|
+
| `state.position` | number (%) | R/W | Cover position, 0 = closed, 100 = open |
|
|
140
|
+
| `state.stop` | boolean | R/W | Write `true` to stop movement |
|
|
141
|
+
|
|
142
|
+
### Switches (`switches.<id>.*`)
|
|
143
|
+
|
|
144
|
+
| State | Type | R/W | Description |
|
|
145
|
+
|---|---|---|---|
|
|
146
|
+
| `info.name` | string | R | Switch name from deCONZ |
|
|
147
|
+
| `info.battery` | number (%) | R | Battery charge level |
|
|
148
|
+
| `info.reachable` | boolean | R | Zigbee reachability |
|
|
149
|
+
| `info.lastSeen` | string | R | Last seen timestamp |
|
|
150
|
+
| `button.lastEvent` | number | R | Raw deCONZ button event code |
|
|
151
|
+
| `button.lastEventName` | string | R | Human-readable event name |
|
|
152
|
+
|
|
153
|
+
### Sensors (`sensors.<id>.*`)
|
|
154
|
+
|
|
155
|
+
| State | Type | R/W | Description |
|
|
156
|
+
|---|---|---|---|
|
|
157
|
+
| `info.name` | string | R | Sensor name from deCONZ |
|
|
158
|
+
| `info.battery` | number (%) | R | Battery charge level |
|
|
159
|
+
| `info.reachable` | boolean | R | Zigbee reachability |
|
|
160
|
+
| `info.lastSeen` | string | R | Last seen timestamp |
|
|
161
|
+
| `value.temperature` | number (°C) | R | Temperature (ZHATemperature sensors) |
|
|
162
|
+
| `value.humidity` | number (%) | R | Humidity (ZHAHumidity sensors) |
|
|
163
|
+
| `value.pressure` | number (hPa) | R | Air pressure (ZHAPressure sensors) |
|
|
164
|
+
| `value.open` | boolean | R | Open/close state (ZHAOpenClose sensors) |
|
|
165
|
+
| `value.presence` | boolean | R | Motion detected (ZHAPresence sensors) |
|
|
166
|
+
| `value.brightness` | number (lux) | R | Light level (ZHALightLevel sensors) |
|
|
167
|
+
| `value.power` | number (W) | R | Power draw (ZHAPower sensors) |
|
|
168
|
+
| `value.consumption` | number (kWh) | R | Energy consumption (ZHAConsumption sensors) |
|
|
169
|
+
| `value.raw` | mixed | R | Raw value fallback for unrecognized sensor types |
|
|
170
|
+
|
|
171
|
+
### Thermostats (`thermostats.<id>.*`)
|
|
172
|
+
|
|
173
|
+
| State | Type | R/W | Description |
|
|
174
|
+
|---|---|---|---|
|
|
175
|
+
| `info.name` | string | R | Thermostat name from deCONZ |
|
|
176
|
+
| `info.battery` | number (%) | R | Battery charge level |
|
|
177
|
+
| `info.reachable` | boolean | R | Zigbee reachability |
|
|
178
|
+
| `state.temperature` | number (°C) | R | Measured temperature |
|
|
179
|
+
| `state.valve` | number (%) | R | Valve opening percentage |
|
|
180
|
+
| `state.setpoint` | number (°C) | R/W | Target temperature, 5–32 °C |
|
|
181
|
+
|
|
138
182
|
## Changelog
|
|
139
183
|
|
|
140
184
|
<!--
|
|
@@ -142,6 +186,9 @@ Alternatively unlock via the deCONZ desktop app: **Menu → Settings → Gateway
|
|
|
142
186
|
### **WORK IN PROGRESS**
|
|
143
187
|
-->
|
|
144
188
|
|
|
189
|
+
### 0.3.1 (2026-06-23)
|
|
190
|
+
* (ssbingo) Complete the Object structure documentation (Plugs, Covers, Switches, Sensors, Thermostats) in all 11 README files; cap the changelog at 5 entries with older history moved to CHANGELOG_OLD.md
|
|
191
|
+
|
|
145
192
|
### 0.3.0 (2026-06-23)
|
|
146
193
|
* (ssbingo) Fix: device tabs in admin no longer trigger a false "switch host" warning — React 18 and @mui/material v6 are now shared with admin's host instead of being bundled separately (panel bundle size drops from ~411 KB to ~66 KB)
|
|
147
194
|
* (ssbingo) Fix: remove leftover legacy "tint" sidebar tab (admin/tab_m.html) — superseded by the jsonConfig device tabs
|
|
@@ -156,25 +203,20 @@ Alternatively unlock via the deCONZ desktop app: **Menu → Settings → Gateway
|
|
|
156
203
|
### 0.2.4 (2026-06-15)
|
|
157
204
|
* (ssbingo) Improve pairing UX: click button first, adapter polls deCONZ every 3 s until pairing window opens (up to 60 s) — no more time pressure
|
|
158
205
|
|
|
159
|
-
|
|
160
|
-
* (ssbingo) Add automatic API key pairing: new "Request API key from deCONZ" button in the Settings tab
|
|
161
|
-
|
|
162
|
-
### 0.2.2 (2026-06-15)
|
|
163
|
-
* (ssbingo) Fix tab labels: "Leuchten" and "Gruppen" now shown correctly (i18n keys added to `admin/i18n/`)
|
|
164
|
-
* (ssbingo) Add static description text above each panel tab (always visible, even when panel fails to load)
|
|
165
|
-
* (ssbingo) Panel components: add sendTo timeout (10 s), alive-check, deferred mount via setTimeout, error boundary
|
|
166
|
-
* (ssbingo) Improve LightsTab and GroupsTab UX: status bar with dot indicator, count label, alert boxes for error/empty/offline
|
|
167
|
-
|
|
168
|
-
### 0.2.1 (2026-06-15)
|
|
169
|
-
* (ssbingo) Fix: panels were empty because `window.React` is not a global in admin 7
|
|
206
|
+
## Documentation
|
|
170
207
|
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
208
|
+
- 🇩🇪 [Deutsche Dokumentation](doc/de/README.md)
|
|
209
|
+
- 🇷🇺 [Документация на русском](doc/ru/README.md)
|
|
210
|
+
- 🇳🇱 [Nederlandse documentatie](doc/nl/README.md)
|
|
211
|
+
- 🇫🇷 [Documentation française](doc/fr/README.md)
|
|
212
|
+
- 🇮🇹 [Documentazione italiana](doc/it/README.md)
|
|
213
|
+
- 🇪🇸 [Documentación en español](doc/es/README.md)
|
|
214
|
+
- 🇵🇱 [Dokumentacja polska](doc/pl/README.md)
|
|
215
|
+
- 🇵🇹 [Documentação portuguesa](doc/pt/README.md)
|
|
216
|
+
- 🇺🇦 [Документація українською](doc/uk/README.md)
|
|
217
|
+
- 🇨🇳 [简体中文文档](doc/zh-cn/README.md)
|
|
175
218
|
|
|
176
|
-
|
|
177
|
-
* (ssbingo) Initial release: lights, groups, scenes, Tint remote with color wheel
|
|
219
|
+
Older changelogs can be found in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).
|
|
178
220
|
|
|
179
221
|
## License
|
|
180
222
|
|
package/io-package.json
CHANGED
|
@@ -1,8 +1,21 @@
|
|
|
1
1
|
{
|
|
2
2
|
"common": {
|
|
3
3
|
"name": "tint",
|
|
4
|
-
"version": "0.3.
|
|
4
|
+
"version": "0.3.1",
|
|
5
5
|
"news": {
|
|
6
|
+
"0.3.1": {
|
|
7
|
+
"en": "Complete the Object structure documentation (Plugs, Covers, Switches, Sensors, Thermostats) in all 11 README files; cap the changelog at 5 entries with older history moved to CHANGELOG_OLD.md",
|
|
8
|
+
"de": "Objektstruktur-Dokumentation (Steckdosen, Rollos, Schalter, Sensoren, Thermostate) in allen 11 README-Dateien vervollständigt; Changelog auf 5 Einträge begrenzt, ältere Historie nach CHANGELOG_OLD.md verschoben",
|
|
9
|
+
"ru": "Завершена документация структуры объектов (Розетки, Жалюзи, Выключатели, Датчики, Термостаты) во всех 11 файлах README; changelog ограничен 5 записями, более старая история перемещена в CHANGELOG_OLD.md",
|
|
10
|
+
"pt": "Documentação da estrutura de objetos concluída (Tomadas, Estores, Interruptores, Sensores, Termostatos) em todos os 11 ficheiros README; changelog limitado a 5 entradas, histórico mais antigo movido para CHANGELOG_OLD.md",
|
|
11
|
+
"nl": "Objectstructuurdocumentatie (Stekkers, Rolluiken, Schakelaars, Sensoren, Thermostaten) in alle 11 README-bestanden voltooid; changelog beperkt tot 5 items, oudere geschiedenis verplaatst naar CHANGELOG_OLD.md",
|
|
12
|
+
"fr": "Documentation de la structure des objets complétée (Prises, Volets, Interrupteurs, Capteurs, Thermostats) dans les 11 fichiers README ; changelog limité à 5 entrées, historique plus ancien déplacé vers CHANGELOG_OLD.md",
|
|
13
|
+
"it": "Documentazione della struttura degli oggetti completata (Prese, Tapparelle, Interruttori, Sensori, Termostati) in tutti gli 11 file README; changelog limitato a 5 voci, cronologia precedente spostata in CHANGELOG_OLD.md",
|
|
14
|
+
"es": "Documentación de la estructura de objetos completada (Enchufes, Persianas, Interruptores, Sensores, Termostatos) en los 11 archivos README; changelog limitado a 5 entradas, historial anterior movido a CHANGELOG_OLD.md",
|
|
15
|
+
"pl": "Uzupełniono dokumentację struktury obiektów (Gniazdka, Rolety, Przełączniki, Czujniki, Termostaty) we wszystkich 11 plikach README; dziennik zmian ograniczony do 5 wpisów, starsza historia przeniesiona do CHANGELOG_OLD.md",
|
|
16
|
+
"uk": "Завершено документацію структури об'єктів (Розетки, Жалюзі, Вимикачі, Датчики, Термостати) у всіх 11 файлах README; журнал змін обмежено 5 записами, старішу історію перенесено до CHANGELOG_OLD.md",
|
|
17
|
+
"zh-cn": "完成了对象结构文档（插座、窗帘、开关、传感器、温控器）在全部11个README文件中的补充；更新日志限制为5条，较旧的历史记录已移至CHANGELOG_OLD.md"
|
|
18
|
+
},
|
|
6
19
|
"0.3.0": {
|
|
7
20
|
"en": "Fix: device tabs no longer trigger a false \"switch host\" warning in admin (React 18 + MUI v6 now shared with admin instead of bundled separately); remove leftover legacy \"tint\" sidebar tab",
|
|
8
21
|
"de": "Bugfix: Geräte-Tabs lösen keine falsche \"Host wechseln\"-Warnung in Admin mehr aus (React 18 + MUI v6 werden jetzt mit Admin geteilt statt separat gebündelt); veralteten Sidebar-Tab \"tint\" entfernt",
|