iobroker.faikout 0.1.0 → 0.2.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 CHANGED
@@ -42,6 +42,12 @@ Objects are grouped per device:
42
42
  econo, powerful, comfort, streamer, sensor, LED, quiet, humidify. `selectedMode` is the operating mode
43
43
  without "off": while the unit runs it equals `mode`, while it is off it keeps the mode set last (taken
44
44
  from the module's native status). Writing it sends the mode and switches the unit on.
45
+ - `mode`, `fan`, `swing` and `preset` are text, as the module speaks them. Each has a numeric twin
46
+ (`modeNum`, `fanNum`, `swingNum`, `presetNum`) with `common.states` such as
47
+ `{0: "off", 1: "heat_cool", 2: "cool", 3: "heat", 4: "dry", 5: "fan_only"}` for Lovelace and other
48
+ tools that expect numbers. Both are writable and mean the same: a command on either sends exactly one
49
+ command to the module (as text); both are set with `ack=true` when the module confirms. The numbers
50
+ are fixed; new values of a future firmware are appended.
45
51
  - `<device>.status.*` — readings: temperatures, humidity, energy, power, compressor and fan speed
46
52
  - `<device>.info.*` — device diagnostics: IP, WiFi signal, uptime, firmware
47
53
 
@@ -108,6 +114,25 @@ reporting 100 % — seen on units that still have Daikin's own WiFi adapter fitt
108
114
  pass on the percentage; the modes of Daikin's app (off / automatic / fixed) are not part of what is
109
115
  known about the S21 interface. Econo is only taken over while the unit is running.
110
116
 
117
+ ### Lovelace, type detector and other tools that expect numbers
118
+
119
+ The module speaks text (`mode` = `"cool"`), and the text states stay the main form for scripts, vis and
120
+ the device cards. Lovelace, however, converts the keys of `common.states` to numbers when it writes a
121
+ climate entity; with text keys this gives `NaN` and the command is lost. Use the numeric twins in
122
+ `<device>.control.*` for such tools:
123
+
124
+ | State | Role | Values |
125
+ | ----------- | --------------------------- | ----------------------------------------------------------------------------- |
126
+ | `modeNum` | `level.mode.airconditioner` | 0 off, 1 heat_cool, 2 cool, 3 heat, 4 dry, 5 fan_only |
127
+ | `fanNum` | `level.mode.fan` | 0 auto, 1 night, 2 low, 3 lowMedium, 4 medium, 5 mediumHigh, 6 high |
128
+ | `swingNum` | `level.mode.swing` | 0 off, 1 on, 2 vertical, 3 horizontal, 4 both, 5 comfort, 6 horizontalComfort |
129
+ | `presetNum` | `level.mode` | 0 home, 1 eco, 2 boost |
130
+
131
+ The roles let the type detector find them as part of an air conditioner. Writing `2`, `"2"` or the label
132
+ `"cool"` to `modeNum` sends one command `cool` to the module; `modeNum` and `mode` are both set with
133
+ `ack=true` when the module confirms. A value outside the list is discarded with a warning in the log.
134
+ The twins are created with the first report of a module after the update.
135
+
111
136
  ## Visualisation (vis templates)
112
137
 
113
138
  The folder [`vis-templates/`](vis-templates/) contains ready-made **vis 1** views for two units: overview,
@@ -121,6 +146,28 @@ one detail page per unit with controls, energy history and a phone view. They us
121
146
  Placeholder for the next version (at the beginning of the line):
122
147
  ### **WORK IN PROGRESS**
123
148
  -->
149
+ ### 0.2.1 (2026-11-19)
150
+ - `control.swing` / `swingNum`: new value `H+C` (`horizontalComfort`, number 6) for comfort mode with
151
+ horizontal swing. Comfort is a mode of the vertical louvres; the swing selector (e.g. in Lovelace) can now
152
+ combine it with horizontal swing. Needs Faikout firmware with `H+C` support; older firmware reports `C`
153
+ during comfort and treats a written `H+C` as `off`.
154
+ - Renamed modules (issue #6): after changing the hostname of a module, the adapter kept the old name in memory
155
+ until the next restart and, once its objects were deleted, logged `State "...consumption..." has no existing
156
+ object` every hour. The module is now recognised by its hardware ID (`info.id`): the old name is no longer
157
+ updated, its consumption counters (today, month, JSON series) continue under the new name, and its objects
158
+ stay untouched until you delete them (SmarthomeElektroniker)
159
+ - Deleted objects are noticed while the adapter runs: a deleted device is dropped, a deleted state or branch is
160
+ created again before the next write; states are no longer written to objects that do not exist
161
+ (SmarthomeElektroniker)
162
+ - Dev dependency `@iobroker/testing` 6.3.2 (SmarthomeElektroniker)
163
+
164
+ ### 0.2.0 (2026-11-13)
165
+ - Numeric twins of the text control states: `control.modeNum`, `fanNum`, `swingNum` and `presetNum` with
166
+ `common.states` (`{0: "off", 1: "heat_cool", ...}`) and the roles `level.mode.airconditioner`,
167
+ `level.mode.fan`, `level.mode.swing` and `level.mode`, for Lovelace and the type detector (forum thread
168
+ 85668). Both forms are writable; a command on either sends exactly one command to the module, both are set
169
+ with `ack=true` when the module confirms. Text states, vis widgets and device cards are unchanged.
170
+
124
171
  ### 0.1.0 (2026-11-12)
125
172
  - Device manager support (`@iobroker/dm-utils`): one card per air conditioner in the admin tab "Devices"
126
173
  with the running operation (mode, current action, room/target/outside temperature, fan speed, humidity,
@@ -151,23 +198,6 @@ one detail page per unit with controls, energy history and a phone view. They us
151
198
  cannot set CSS custom properties with `.css()`, so it always stayed blue.
152
199
  - New: vis templates (`vis-templates/`) – overview, detail page per unit, energy and phone view.
153
200
 
154
- ### 0.0.17
155
- - Fixed units of `status.comp` and `status.fanfreq`: the module sends Hz by default and rpm only with `ha.comprpm`/`ha.fanrpm`.
156
- The adapter now takes the unit from the module's Home Assistant discovery (a fractional fan value is always Hz),
157
- sets it on the state and remembers it per device. The VIS widgets show the unit of the state.
158
- - All fields the module can report are described: new `status.action` (with `no.hvacaction` off), `status.loopback`,
159
- `status.bletemp`/`blehum`/`blebat`, `info.dma`, `info.restart`, `info.ipv6`, `info.secureboot`, `info.nvsecryption`.
160
- `dma` and `restart` were created as unknown fields under `status.*` up to 0.0.16 and are moved to `info.*` on start.
161
- - New tab "Module settings" in the instance configuration: which settings the faikout module needs for the complete set of
162
- data points (all eleven languages). Same table in the README.
163
- - Warning in the log when a module is connected without `ha.enable`.
164
-
165
- ### 0.0.16
166
- - Release notes in `io-package.json` trimmed to seven entries and translated into all languages (repository checker E1032/E1144).
167
-
168
- ### 0.0.15
169
- - The MQTT broker's shutdown timeout uses the adapter's `setTimeout` (repository checker E5005).
170
-
171
201
  [Older changelog entries can be found here](CHANGELOG_OLD.md)
172
202
 
173
203
  ## Trademark and relationship to the hardware project
package/io-package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "common": {
3
3
  "name": "faikout",
4
- "version": "0.1.0",
4
+ "version": "0.2.1",
5
5
  "titleLang": {
6
6
  "en": "Faikout",
7
7
  "de": "Faikout",
@@ -71,6 +71,32 @@
71
71
  }
72
72
  ],
73
73
  "news": {
74
+ "0.2.1": {
75
+ "en": "Renamed modules are recognised by their hardware ID: no more writes to deleted objects, consumption counters continue under the new name (issue #6); deleted objects are noticed at runtime; new swing value H+C (comfort with horizontal swing)",
76
+ "de": "Umbenannte Module werden an ihrer Hardware-ID erkannt: keine Schreibzugriffe mehr auf gelöschte Objekte, Verbrauchszähler laufen unter dem neuen Namen weiter (Issue #6); gelöschte Objekte werden zur Laufzeit erkannt; neuer Schwenkwert H+C (Komfort mit waagerechtem Schwenken)",
77
+ "ru": "Переименованные модули распознаются по аппаратному ID: больше нет записи в удалённые объекты, счётчики потребления продолжаются под новым именем (issue #6); удалённые объекты обнаруживаются во время работы; новое значение качания H+C (комфорт с горизонтальным качанием)",
78
+ "pt": "Módulos renomeados são reconhecidos pelo ID de hardware: sem gravações em objetos excluídos, os contadores de consumo continuam com o novo nome (issue #6); objetos excluídos são detectados em execução; novo valor de oscilação H+C (conforto com oscilação horizontal)",
79
+ "nl": "Hernoemde modules worden herkend aan hun hardware-ID: geen schrijfacties meer naar verwijderde objecten, verbruikstellers lopen door onder de nieuwe naam (issue #6); verwijderde objecten worden tijdens het draaien opgemerkt; nieuwe zwenkwaarde H+C (comfort met horizontaal zwenken)",
80
+ "fr": "Les modules renommés sont reconnus par leur ID matériel : plus d'écriture vers des objets supprimés, les compteurs de consommation continuent sous le nouveau nom (issue #6) ; les objets supprimés sont détectés en cours d'exécution ; nouvelle valeur d'oscillation H+C (confort avec oscillation horizontale)",
81
+ "it": "I moduli rinominati vengono riconosciuti dall'ID hardware: nessuna scrittura su oggetti eliminati, i contatori di consumo proseguono con il nuovo nome (issue #6); gli oggetti eliminati vengono rilevati durante l'esecuzione; nuovo valore di oscillazione H+C (comfort con oscillazione orizzontale)",
82
+ "es": "Los módulos renombrados se reconocen por su ID de hardware: ya no se escribe en objetos eliminados, los contadores de consumo continúan con el nuevo nombre (issue #6); los objetos eliminados se detectan en ejecución; nuevo valor de oscilación H+C (confort con oscilación horizontal)",
83
+ "pl": "Moduły o zmienionej nazwie są rozpoznawane po identyfikatorze sprzętowym: brak zapisów do usuniętych obiektów, liczniki zużycia działają dalej pod nową nazwą (issue #6); usunięte obiekty są wykrywane w trakcie działania; nowa wartość nachylenia H+C (komfort z poziomym ruchem)",
84
+ "uk": "Перейменовані модулі розпізнаються за апаратним ID: більше немає запису у видалені об'єкти, лічильники споживання продовжуються під новою назвою (issue #6); видалені об'єкти виявляються під час роботи; нове значення гойдання H+C (комфорт із горизонтальним гойданням)",
85
+ "zh-cn": "重命名的模块通过硬件 ID 识别:不再写入已删除的对象,用电计数器在新名称下继续(issue #6);运行时可识别已删除的对象;新的摆风值 H+C(舒适模式加水平摆风)"
86
+ },
87
+ "0.2.0": {
88
+ "en": "Numeric twins of the text control states (modeNum, fanNum, swingNum, presetNum) with level.mode roles for Lovelace and the type detector; one command per write, ack only with the module confirmation",
89
+ "de": "Zahl-Datenpunkte neben den Text-Steuerfeldern (modeNum, fanNum, swingNum, presetNum) mit level.mode-Rollen für Lovelace und den Type-Detector; ein Befehl pro Schreibvorgang, ack erst mit der Bestätigung des Moduls",
90
+ "ru": "Числовые аналоги текстовых управляющих состояний (modeNum, fanNum, swingNum, presetNum) с ролями level.mode для Lovelace и детектора типов; одна команда на каждую запись, ack только после подтверждения модуля",
91
+ "pt": "Estados numéricos ao lado dos estados de controlo em texto (modeNum, fanNum, swingNum, presetNum) com funções level.mode para o Lovelace e o detetor de tipos; um comando por escrita, ack apenas com a confirmação do módulo",
92
+ "nl": "Numerieke tegenhangers van de tekstuele besturingsdatapunten (modeNum, fanNum, swingNum, presetNum) met level.mode-rollen voor Lovelace en de typedetector; één commando per schrijfactie, ack pas na bevestiging door de module",
93
+ "fr": "Équivalents numériques des états de commande textuels (modeNum, fanNum, swingNum, presetNum) avec les rôles level.mode pour Lovelace et le détecteur de type ; une seule commande par écriture, ack uniquement après confirmation du module",
94
+ "it": "Stati numerici accanto agli stati di controllo testuali (modeNum, fanNum, swingNum, presetNum) con ruoli level.mode per Lovelace e il rilevatore di tipo; un solo comando per scrittura, ack solo con la conferma del modulo",
95
+ "es": "Estados numéricos junto a los estados de control de texto (modeNum, fanNum, swingNum, presetNum) con roles level.mode para Lovelace y el detector de tipos; un solo comando por escritura, ack solo con la confirmación del módulo",
96
+ "pl": "Liczbowe odpowiedniki tekstowych stanów sterujących (modeNum, fanNum, swingNum, presetNum) z rolami level.mode dla Lovelace i detektora typów; jedno polecenie na zapis, ack dopiero po potwierdzeniu przez moduł",
97
+ "uk": "Числові відповідники текстових керувальних станів (modeNum, fanNum, swingNum, presetNum) з ролями level.mode для Lovelace і детектора типів; одна команда на кожен запис, ack лише після підтвердження модуля",
98
+ "zh-cn": "为文本控制状态新增数值对应项(modeNum、fanNum、swingNum、presetNum),带 level.mode 角色,适用于 Lovelace 和类型检测器;每次写入只发送一条命令,模块确认后才设置 ack"
99
+ },
74
100
  "0.1.0": {
75
101
  "en": "Device cards in the admin (device manager): on/off with confirmation, operating mode, target temperature and fan speed directly on the card, Wi-Fi signal and live values; new state control.selectedMode",
76
102
  "de": "Gerätekarten im Admin (Geräteverwaltung): Ein/Aus mit Rückfrage, Betriebsart, Solltemperatur und Lüfterstufe direkt auf der Karte, WLAN-Signal und laufende Werte; neuer Datenpunkt control.selectedMode",
@@ -135,32 +161,6 @@
135
161
  "pl": "Informacje o wydaniu skrócone do siedmiu wpisów i przetłumaczone (kontrola repozytorium E1032/E1144)",
136
162
  "uk": "Примітки до випуску скорочено до семи записів і перекладено (перевірка репозиторію E1032/E1144)",
137
163
  "zh-cn": "发行说明精简为七条并已翻译(仓库检查 E1032/E1144)"
138
- },
139
- "0.0.15": {
140
- "en": "Shutdown timeout of the MQTT broker uses the adapter timer (checker E5005)",
141
- "de": "Abschalt-Zeitlimit des MQTT-Brokers nutzt den Adapter-Zeitgeber (Checker E5005)",
142
- "ru": "Тайм-аут остановки MQTT-брокера использует таймер адаптера (проверка E5005)",
143
- "pt": "O tempo limite de encerramento do broker MQTT usa o temporizador do adaptador (verificação E5005)",
144
- "nl": "Afsluittime-out van de MQTT-broker gebruikt de timer van de adapter (controle E5005)",
145
- "fr": "Le délai d'arrêt du broker MQTT utilise le minuteur de l'adaptateur (contrôle E5005)",
146
- "it": "Il timeout di arresto del broker MQTT usa il timer dell'adattatore (controllo E5005)",
147
- "es": "El tiempo de espera de cierre del broker MQTT usa el temporizador del adaptador (comprobación E5005)",
148
- "pl": "Limit czasu zamykania brokera MQTT korzysta z timera adaptera (kontrola E5005)",
149
- "uk": "Тайм-аут зупинки MQTT-брокера використовує таймер адаптера (перевірка E5005)",
150
- "zh-cn": "MQTT 代理的关闭超时使用适配器计时器(检查 E5005)"
151
- },
152
- "0.0.14": {
153
- "en": "Consumption states renamed to English IDs (consumption.total.today ...), existing values are migrated; status.autoe can be written; complete translations of admin and widgets",
154
- "de": "Verbrauchsdatenpunkte auf englische IDs umbenannt (consumption.total.today ...), vorhandene Werte werden übernommen; status.autoe ist beschreibbar; vollständige Übersetzungen von Admin und Widgets",
155
- "ru": "Состояния потребления переименованы в английские ID (consumption.total.today ...), существующие значения переносятся; status.autoe можно записывать; полные переводы админки и виджетов",
156
- "pt": "Estados de consumo renomeados para IDs em inglês (consumption.total.today ...), os valores existentes são migrados; status.autoe pode ser escrito; traduções completas do admin e dos widgets",
157
- "nl": "Verbruiksstatussen hernoemd naar Engelse ID’s (consumption.total.today ...), bestaande waarden worden overgenomen; status.autoe is schrijfbaar; volledige vertalingen van admin en widgets",
158
- "fr": "États de consommation renommés en ID anglais (consumption.total.today ...), les valeurs existantes sont migrées ; status.autoe est modifiable ; traductions complètes de l’admin et des widgets",
159
- "it": "Stati di consumo rinominati con ID inglesi (consumption.total.today ...), i valori esistenti vengono migrati; status.autoe è scrivibile; traduzioni complete di admin e widget",
160
- "es": "Estados de consumo renombrados a ID en inglés (consumption.total.today ...), los valores existentes se migran; status.autoe se puede escribir; traducciones completas del admin y los widgets",
161
- "pl": "Stany zużycia przemianowane na angielskie ID (consumption.total.today ...), istniejące wartości są przenoszone; status.autoe można zapisywać; pełne tłumaczenia panelu i widżetów",
162
- "uk": "Стани споживання перейменовано на англійські ID (consumption.total.today ...), наявні значення переносяться; status.autoe можна записувати; повні переклади адмінки та віджетів",
163
- "zh-cn": "能耗状态改为英文 ID(consumption.total.today 等),现有数值自动迁移;status.autoe 可写入;管理界面和小部件完整翻译"
164
164
  }
165
165
  },
166
166
  "restartAdapters": [
package/lib/fields.js CHANGED
@@ -87,9 +87,11 @@ const FELDER = {
87
87
  states: liste(FAN_MODES),
88
88
  name: { en: 'Fan speed', de: 'Lüfterstufe' },
89
89
  },
90
- // ACHTUNG: `swing` kennt sechs Werte, nicht nur off/on. Die HA-Discovery meldet zwar nur
91
- // off|on, das Geraet selbst sendet aber H, V, H+V (beide Achsen) und C (Komfortbetrieb) -
92
- // siehe SWING_* in Faikout.c. Am Wohnzimmer-Geraet stand live "V"; mit einer Liste aus
90
+ // ACHTUNG: `swing` kennt sieben Werte, nicht nur off/on. Die HA-Discovery meldet zwar nur
91
+ // off|on, das Geraet selbst sendet aber H, V, H+V (beide Achsen), C (Komfortbetrieb) und
92
+ // H+C (waagerecht schwenken plus Komfort, ab der Firmware mit SWING_HCOMFORT) -
93
+ // siehe SWING_* in Faikout.c. Komfort ist eine Betriebsart der senkrechten Lamellen;
94
+ // aeltere Firmware meldet waehrend Komfort immer C, auch wenn waagerecht geschwenkt wird. Am Wohnzimmer-Geraet stand live "V"; mit einer Liste aus
93
95
  // nur off/on waere das im VIS ein unbekannter Zustand gewesen.
94
96
  swing: {
95
97
  kanal: 'control',
@@ -103,6 +105,7 @@ const FELDER = {
103
105
  H: 'horizontal',
104
106
  'H+V': 'both',
105
107
  C: 'comfort',
108
+ 'H+C': 'horizontalComfort',
106
109
  },
107
110
  name: { en: 'Swing', de: 'Luftverteilung' },
108
111
  },
@@ -566,6 +569,125 @@ const FELDER = {
566
569
  },
567
570
  };
568
571
 
572
+ /*
573
+ * ZAHL-ZWILLINGE der Text-Steuerfelder (Forum 85668, FernetMenta 13.11.2026).
574
+ *
575
+ * Das Modul spricht Text: state/<Name> meldet mode "cool", command/<Name>/mode nimmt "cool".
576
+ * Die Text-Datenpunkte bleiben deshalb die Hauptform - App, VIS-Bausteine, Geraetekarten und
577
+ * Skripte der Nutzer haengen daran. Lovelace dagegen rechnet beim Schreiben die Schluessel aus
578
+ * common.states mit parseInt() in Zahlen um (climateEntity.js, iobroker.lovelace 7.4.1) - bei
579
+ * Text-Schluesseln wie "cool" kommt NaN heraus. Der Type-Detector erwartet fuer Luefter und
580
+ * Schwenken ebenfalls Zahlen (level.mode.fan / level.mode.swing).
581
+ *
582
+ * Darum gibt es neben jedem Text-Feld einen Zahl-Datenpunkt `<feld>Num` mit
583
+ * common.states {0: "off", 1: "heat_cool", ...}. Beide sind schreibbar und meinen dasselbe:
584
+ * - Meldung des Moduls -> beide werden mit ack=true gesetzt (zahlZwillingeErgaenzen()).
585
+ * - Befehl auf EINEN der beiden -> genau EIN MQTT-Befehl auf command/<Name>/<feld>, immer als
586
+ * Text. Der andere Datenpunkt wird NICHT angefasst; er zieht mit der Bestaetigung des Moduls
587
+ * nach. So entsteht keine Schleife und kein doppelter Befehl.
588
+ *
589
+ * DIE REIHENFOLGE DER LISTEN IST DIE ZAHL - sie darf sich nie aendern, nur hinten wachsen.
590
+ * Neue Werte einer kuenftigen Firmware werden angehaengt.
591
+ */
592
+ const ZAHL_ZWILLINGE = {
593
+ mode: {
594
+ werte: MODES,
595
+ role: 'level.mode.airconditioner',
596
+ name: { en: 'Operating mode (number)', de: 'Betriebsart (Zahl)' },
597
+ },
598
+ fan: {
599
+ werte: FAN_MODES,
600
+ role: 'level.mode.fan',
601
+ name: { en: 'Fan speed (number)', de: 'Lüfterstufe (Zahl)' },
602
+ },
603
+ swing: {
604
+ werte: ['off', 'on', 'V', 'H', 'H+V', 'C', 'H+C'],
605
+ role: 'level.mode.swing',
606
+ name: { en: 'Swing (number)', de: 'Luftverteilung (Zahl)' },
607
+ },
608
+ preset: {
609
+ werte: ['home', 'eco', 'boost'],
610
+ role: 'level.mode',
611
+ name: { en: 'Preset (number)', de: 'Voreinstellung (Zahl)' },
612
+ },
613
+ };
614
+
615
+ for (const [feld, z] of Object.entries(ZAHL_ZWILLINGE)) {
616
+ const text = FELDER[feld];
617
+ const states = {};
618
+ z.werte.forEach((w, i) => {
619
+ // Beschriftung wie beim Text-Datenpunkt (swing: "V" -> "vertical"), damit Lovelace
620
+ // dieselben Namen anzeigt und beim Schreiben zurueckfindet.
621
+ states[i] = (text.states && text.states[w]) || w;
622
+ });
623
+ FELDER[`${feld}Num`] = {
624
+ kanal: text.kanal,
625
+ type: 'number',
626
+ role: z.role,
627
+ w: true,
628
+ cmd: feld,
629
+ zahlZu: feld,
630
+ states,
631
+ min: 0,
632
+ max: z.werte.length - 1,
633
+ step: 1,
634
+ name: z.name,
635
+ };
636
+ }
637
+
638
+ /**
639
+ * Ergaenzt eine Meldung um die Zahl-Zwillinge (mode "cool" -> modeNum 2). Unbekannte Texte
640
+ * bekommen keinen Zwilling: der Text-Datenpunkt zeigt sie trotzdem, die Zahl bleibt stehen.
641
+ *
642
+ * @param {object} daten gemeldete Felder (Klartext aus state/<Name>)
643
+ * @returns {object} dieselben Felder plus <feld>Num, wo zuordenbar
644
+ */
645
+ function zahlZwillingeErgaenzen(daten) {
646
+ let ergebnis = daten;
647
+ for (const [feld, z] of Object.entries(ZAHL_ZWILLINGE)) {
648
+ if (typeof daten[feld] !== 'string') {
649
+ continue;
650
+ }
651
+ const i = z.werte.indexOf(daten[feld]);
652
+ if (i >= 0) {
653
+ if (ergebnis === daten) {
654
+ ergebnis = { ...daten };
655
+ }
656
+ ergebnis[`${feld}Num`] = i;
657
+ }
658
+ }
659
+ return ergebnis;
660
+ }
661
+
662
+ /**
663
+ * Text fuer das Kommandotopic aus einem geschriebenen Zahl-Datenpunkt. Angenommen werden die
664
+ * Zahl (auch als Text "2", wie manche Oberflaechen sie schicken), die Beschriftung ("vertical")
665
+ * und der Modultext selbst ("V").
666
+ *
667
+ * @param {string} feld Feldname des Zahl-Datenpunkts (z. B. "modeNum")
668
+ * @param {string|number|boolean} wert geschriebener Wert
669
+ * @returns {string|null} Text fuer das Modul oder null, wenn der Wert nicht passt
670
+ */
671
+ function zahlZuText(feld, wert) {
672
+ const def = FELDER[feld];
673
+ const z = def && def.zahlZu && ZAHL_ZWILLINGE[def.zahlZu];
674
+ if (!z) {
675
+ return null;
676
+ }
677
+ if (typeof wert === 'number' || (typeof wert === 'string' && /^\s*\d+\s*$/.test(wert))) {
678
+ const n = Number(wert);
679
+ return Number.isInteger(n) && n >= 0 && n < z.werte.length ? z.werte[n] : null;
680
+ }
681
+ if (typeof wert === 'string') {
682
+ if (z.werte.includes(wert)) {
683
+ return wert;
684
+ }
685
+ const i = Object.values(def.states).indexOf(wert);
686
+ return i >= 0 ? z.werte[i] : null;
687
+ }
688
+ return null;
689
+ }
690
+
569
691
  /** Felder, die der Adapter nie als Datenpunkt anlegt (Struktur statt Wert). */
570
692
  const UEBERSPRINGEN = new Set(['ble']);
571
693
 
@@ -836,4 +958,7 @@ module.exports = {
836
958
  einheitAusWert,
837
959
  ohneHaEnable,
838
960
  abgelehntAuswerten,
961
+ ZAHL_ZWILLINGE,
962
+ zahlZwillingeErgaenzen,
963
+ zahlZuText,
839
964
  };
package/lib/namen.js CHANGED
@@ -1043,6 +1043,51 @@ const UEBERSETZUNGEN = {
1043
1043
  uk: 'Пристрій підключено',
1044
1044
  'zh-cn': '设备已连接',
1045
1045
  },
1046
+ // Zahl-Zwillinge der Text-Steuerfelder (fields.js, ZAHL_ZWILLINGE)
1047
+ 'Operating mode (number)': {
1048
+ ru: 'Режим работы (число)',
1049
+ pt: 'Modo de funcionamento (número)',
1050
+ nl: 'Bedrijfsmodus (getal)',
1051
+ fr: 'Mode de fonctionnement (nombre)',
1052
+ it: 'Modalità operativa (numero)',
1053
+ es: 'Modo de funcionamiento (número)',
1054
+ pl: 'Tryb pracy (liczba)',
1055
+ uk: 'Режим роботи (число)',
1056
+ 'zh-cn': '运行模式(数值)',
1057
+ },
1058
+ 'Fan speed (number)': {
1059
+ ru: 'Скорость вентилятора (число)',
1060
+ pt: 'Velocidade do ventilador (número)',
1061
+ nl: 'Ventilatorstand (getal)',
1062
+ fr: 'Vitesse du ventilateur (nombre)',
1063
+ it: 'Velocità ventola (numero)',
1064
+ es: 'Velocidad del ventilador (número)',
1065
+ pl: 'Prędkość wentylatora (liczba)',
1066
+ uk: 'Швидкість вентилятора (число)',
1067
+ 'zh-cn': '风扇转速(数值)',
1068
+ },
1069
+ 'Swing (number)': {
1070
+ ru: 'Распределение воздуха (число)',
1071
+ pt: 'Distribuição do ar (número)',
1072
+ nl: 'Luchtverdeling (getal)',
1073
+ fr: 'Distribution de l’air (nombre)',
1074
+ it: 'Distribuzione dell’aria (numero)',
1075
+ es: 'Distribución del aire (número)',
1076
+ pl: 'Rozprowadzanie powietrza (liczba)',
1077
+ uk: 'Розподіл повітря (число)',
1078
+ 'zh-cn': '送风摆动(数值)',
1079
+ },
1080
+ 'Preset (number)': {
1081
+ ru: 'Предустановка (число)',
1082
+ pt: 'Predefinição (número)',
1083
+ nl: 'Voorinstelling (getal)',
1084
+ fr: 'Préréglage (nombre)',
1085
+ it: 'Preimpostazione (numero)',
1086
+ es: 'Preajuste (número)',
1087
+ pl: 'Ustawienie wstępne (liczba)',
1088
+ uk: 'Передустановка (число)',
1089
+ 'zh-cn': '预设(数值)',
1090
+ },
1046
1091
  };
1047
1092
 
1048
1093
  /**
package/main.js CHANGED
@@ -132,6 +132,7 @@ class Faikout extends utils.Adapter {
132
132
 
133
133
  this.on('ready', this.onReady.bind(this));
134
134
  this.on('stateChange', this.onStateChange.bind(this));
135
+ this.on('objectChange', this.onObjectChange.bind(this));
135
136
  this.on('unload', this.onUnload.bind(this));
136
137
  }
137
138
 
@@ -141,6 +142,9 @@ class Faikout extends utils.Adapter {
141
142
  await this.setState('info.connection', { val: false, ack: true });
142
143
  await this.verbrauchUmziehen();
143
144
  await this.objekteAbgleichen();
145
+ // Geloeschte Objekte mitbekommen (Issue #6): sonst schreibt der Adapter weiter in einen
146
+ // Zweig, den er fuer angelegt haelt - "State ... has no existing object".
147
+ await this.subscribeObjectsAsync('*');
144
148
 
145
149
  const port = Number(this.config.port) || 1888;
146
150
  this.broker = new FaikoutBroker({
@@ -186,8 +190,17 @@ class Faikout extends utils.Adapter {
186
190
  }
187
191
 
188
192
  async stundenwechsel() {
189
- for (const [id, g] of this.geraete) {
193
+ // Kopie: geraetVergessen() nimmt waehrend der Schleife Eintraege heraus.
194
+ for (const [id, g] of [...this.geraete]) {
195
+ // Issue #6: Ein umbenanntes Modul blieb bis zum Neustart als Geist in this.geraete, und
196
+ // jede volle Stunde gingen setState-Aufrufe auf die vom Nutzer geloeschten Objekte.
197
+ if (!(await this.geraetNochDa(id, g))) {
198
+ continue;
199
+ }
190
200
  for (const z of ZAEHLER) {
201
+ if (this.geraete.get(id) !== g) {
202
+ break; // inzwischen geloescht oder umbenannt
203
+ }
191
204
  const ergebnis = verbrauch.pruefen(g.zaehler[z.feld], new Date());
192
205
  if (!ergebnis.werte) {
193
206
  continue;
@@ -293,7 +306,8 @@ class Faikout extends utils.Adapter {
293
306
  }
294
307
  // Die gewaehlte Betriebsart (ohne "off") laeuft als eigenes Feld mit.
295
308
  const gewaehlt = felder.gewaehlteBetriebsart(daten, false);
296
- const werte = gewaehlt ? { ...daten, selectedMode: gewaehlt } : daten;
309
+ // Dazu die Zahl-Zwillinge (modeNum, fanNum ...) fuer Lovelace und Co.
310
+ const werte = felder.zahlZwillingeErgaenzen(gewaehlt ? { ...daten, selectedMode: gewaehlt } : daten);
297
311
  this.werteUebernehmen(t.geraet, werte).catch(e => this.log.warn(`${t.geraet}: ${e.message}`));
298
312
  } else if (t.art === 'state' && t.unter === 'status') {
299
313
  // Aus der nativen Meldung nur die Betriebsart einer AUSGESCHALTETEN Anlage - der Rest
@@ -462,6 +476,12 @@ class Faikout extends utils.Adapter {
462
476
  const alt = await this.getObjectAsync(id);
463
477
  g = {
464
478
  name: geraetName,
479
+ // Geraeteobjekt gab es vor diesem Lauf nicht - Kandidat fuer die Uebernahme der
480
+ // Zaehler eines umbenannten Moduls (siehe modulIdPruefen()).
481
+ neu: !alt,
482
+ // Hardware-ID des Moduls (Feld `id`, die MAC ohne Doppelpunkte). Erst gesetzt, wenn
483
+ // sie in diesem Lauf gemeldet und gegen die anderen Geraete geprueft wurde.
484
+ modulId: null,
465
485
  angelegt: new Set(),
466
486
  feuchteEcht: !!(alt && alt.native && alt.native.feuchteEcht),
467
487
  // Die Zaehlerstaende muessen den Adapter-Neustart ueberleben, sonst faengt
@@ -492,6 +512,11 @@ class Faikout extends utils.Adapter {
492
512
  // Der Name kann sich aendern, wenn der Hostname im Modul umgestellt wird.
493
513
  g.name = geraetName;
494
514
 
515
+ // Hardware-ID: erkennt ein umbenanntes Modul, bevor die Zaehler verarbeitet werden.
516
+ if (typeof daten.id === 'string' && daten.id && g.modulId !== daten.id) {
517
+ await this.modulIdPruefen(id, g, daten.id);
518
+ }
519
+
495
520
  for (const [feld, wert] of Object.entries(daten)) {
496
521
  if (wert === null || wert === undefined) {
497
522
  continue;
@@ -862,11 +887,189 @@ class Faikout extends utils.Adapter {
862
887
  }
863
888
 
864
889
  async zaehlerstandSichern(id, g) {
890
+ // Nie ein geloeschtes Geraeteobjekt per extendObject als Rumpf wiederbeleben (Issue #6).
891
+ if (!(await this.geraetNochDa(id, g))) {
892
+ return;
893
+ }
865
894
  g.gesichert = Date.now();
866
895
  g.zaehlerGeaendert = false;
867
896
  await this.extendObject(id, { native: { zaehler: g.zaehler } });
868
897
  }
869
898
 
899
+ // ---------------------------------------------------------------- Umbenennen und Loeschen (Issue #6)
900
+
901
+ /**
902
+ * Ist das Geraet noch im Speicher UND sein Geraeteobjekt noch vorhanden? Fehlt das Objekt (vom
903
+ * Nutzer geloescht), wird das Geraet vergessen. Meldet sich das Modul weiter, entsteht es mit
904
+ * der naechsten Nachricht vollstaendig neu.
905
+ *
906
+ * @param {string} id Objekt-ID des Geraets
907
+ * @param {object} g gemerkter Zustand des Geraets
908
+ * @returns {Promise<boolean>} true, wenn weitergeschrieben werden darf
909
+ */
910
+ async geraetNochDa(id, g) {
911
+ if (this.geraete.get(id) !== g) {
912
+ return false;
913
+ }
914
+ if (await this.getObjectAsync(id)) {
915
+ return true;
916
+ }
917
+ this.geraetVergessen(id, 'its objects were deleted');
918
+ return false;
919
+ }
920
+
921
+ /**
922
+ * Nimmt ein Geraet aus allen Speichern des laufenden Adapters, die am Geraet bzw. seinem Namen
923
+ * haengen. Die Einheiten (this.einheiten) bleiben: sie stammen aus der Discovery, die nicht
924
+ * wiederholt wird, und schaden ohne Geraet nicht.
925
+ *
926
+ * @param {string} id Objekt-ID des Geraets
927
+ * @param {string} grund Grund fuers Log
928
+ */
929
+ geraetVergessen(id, grund) {
930
+ const g = this.geraete.get(id);
931
+ if (!g) {
932
+ return;
933
+ }
934
+ this.geraete.delete(id);
935
+ const praefix = `${id}.`;
936
+ for (const speicher of [this.geschrieben, this.reihenStunde]) {
937
+ for (const schluessel of [...speicher.keys()]) {
938
+ if (schluessel.startsWith(praefix)) {
939
+ speicher.delete(schluessel);
940
+ }
941
+ }
942
+ }
943
+ this.haWarnung.delete(g.name);
944
+ this.abgelehntWarnung.delete(g.name);
945
+ this.log.info(`"${g.name}" (${this.namespace}.${id}) is no longer updated: ${grund}.`);
946
+ this.verbindungPruefen();
947
+ }
948
+
949
+ /**
950
+ * Ein Objekt im eigenen Namensraum wurde geloescht. Alles, was der Adapter darueber im Speicher
951
+ * hat, muss weg - sonst haelt er den Datenpunkt fuer angelegt und schreibt per setState auf ein
952
+ * Objekt, das es nicht mehr gibt. Ist es das Geraeteobjekt selbst, wird das Geraet vergessen.
953
+ *
954
+ * @param {string} volleId Objekt-ID mit Namensraum
955
+ * @param {ioBroker.Object | null | undefined} obj neues Objekt, null/undefined beim Loeschen
956
+ */
957
+ onObjectChange(volleId, obj) {
958
+ if (obj || !volleId.startsWith(`${this.namespace}.`)) {
959
+ return;
960
+ }
961
+ const id = volleId.slice(this.namespace.length + 1);
962
+ const geraetId = id.split('.')[0];
963
+ const g = this.geraete.get(geraetId);
964
+ if (!g) {
965
+ return;
966
+ }
967
+ if (id === geraetId) {
968
+ this.geraetVergessen(geraetId, 'its objects were deleted');
969
+ return;
970
+ }
971
+ this.geschrieben.delete(id);
972
+ this.reihenStunde.delete(id);
973
+ // Den Eintrag selbst, alles darunter und die Zweige darueber (consumption.total steht fuer
974
+ // den ganzen Zweig) - fehlt einer seiner Datenpunkte, wird der Zweig neu angelegt.
975
+ for (const a of [...g.angelegt]) {
976
+ if (a === id || a.startsWith(`${id}.`) || id.startsWith(`${a}.`)) {
977
+ g.angelegt.delete(a);
978
+ }
979
+ }
980
+ }
981
+
982
+ /**
983
+ * Prueft die Hardware-ID eines Moduls gegen die anderen Geraete. Der Objektbaum haengt am
984
+ * Hostnamen; wird der im Modul umgestellt, meldet sich dasselbe Modul unter neuem Namen.
985
+ * Bis 0.2.0 lief das alte Geraet dann im Speicher weiter (Issue #6).
986
+ *
987
+ * Ein anderes Geraet mit derselben ID ist der fruehere Name dieses Moduls. Es wird vergessen und
988
+ * im Objekt als umbenannt markiert (native.renamedTo), damit es nicht bei jedem Start erneut
989
+ * auffaellt; seine Objekte und Verlaufsdaten bleiben unangetastet - loeschen kann sie der Nutzer.
990
+ * Die Zaehlerstaende (Basis fuer heute, Monat und die JSON-Reihen) werden uebernommen, wenn das
991
+ * Geraet unter dem neuen Namen noch keine eigene Geschichte hat: Geraeteobjekt in diesem Lauf
992
+ * neu angelegt, noch kein Zaehlerstand, oder selbst frueher als umbenannt markiert (Modul hat
993
+ * seinen alten Namen zurueck). Sonst bleiben die eigenen Zaehler - nichts wird ueberschrieben.
994
+ *
995
+ * @param {string} id Objekt-ID des Geraets
996
+ * @param {object} g gemerkter Zustand des Geraets
997
+ * @param {string} modulId gemeldete Hardware-ID
998
+ */
999
+ async modulIdPruefen(id, g, modulId) {
1000
+ g.modulId = modulId;
1001
+ const eigen = await this.getObjectAsync(id);
1002
+ const eigenNative = (eigen && eigen.native) || {};
1003
+ const ohneGeschichte = g.neu || !Object.keys(g.zaehler).length || !!eigenNative.renamedTo;
1004
+
1005
+ // aid -> {name, zaehler, objekt}
1006
+ const frueher = new Map();
1007
+ // Im Speicher: das Modul lief in diesem Lauf schon unter dem alten Namen.
1008
+ for (const [aid, ag] of this.geraete) {
1009
+ if (aid !== id && ag.modulId === modulId) {
1010
+ frueher.set(aid, { name: ag.name, zaehler: ag.zaehler, objekt: false });
1011
+ }
1012
+ }
1013
+ // Im Objektbaum: alter Name aus einem frueheren Lauf. native.modulId gibt es erst nach 0.2.0, davor
1014
+ // steht die ID nur im Datenpunkt info.id.
1015
+ try {
1016
+ for (const geraet of await this.getDevicesAsync()) {
1017
+ const aid = geraet._id.slice(this.namespace.length + 1);
1018
+ const n = geraet.native || {};
1019
+ if (aid === id || n.renamedTo) {
1020
+ continue;
1021
+ }
1022
+ let gleich = n.modulId === modulId;
1023
+ if (!gleich && !n.modulId) {
1024
+ const st = await this.getStateAsync(`${aid}.info.id`);
1025
+ gleich = !!st && st.val === modulId;
1026
+ }
1027
+ if (!gleich) {
1028
+ continue;
1029
+ }
1030
+ const bekannt = frueher.get(aid);
1031
+ frueher.set(aid, {
1032
+ name: bekannt ? bekannt.name : n.faikoutName || aid,
1033
+ // Speicherstand ist aktueller als der zuletzt gesicherte im Objekt.
1034
+ zaehler: bekannt ? bekannt.zaehler : n.zaehler || null,
1035
+ objekt: true,
1036
+ });
1037
+ }
1038
+ } catch (e) {
1039
+ this.log.debug(`Device lookup for module ${modulId} skipped: ${e.message}`);
1040
+ }
1041
+
1042
+ let uebernommen = null;
1043
+ for (const [aid, alt] of frueher) {
1044
+ this.geraetVergessen(aid, `module ${modulId} now reports as "${g.name}"`);
1045
+ if (alt.objekt) {
1046
+ await this.extendObject(aid, { native: { modulId, renamedTo: id } });
1047
+ }
1048
+ const hatZaehler = alt.zaehler && Object.keys(alt.zaehler).length;
1049
+ if (ohneGeschichte && hatZaehler && !uebernommen) {
1050
+ g.zaehler = JSON.parse(JSON.stringify(alt.zaehler));
1051
+ uebernommen = alt.name;
1052
+ }
1053
+ const zusatz = uebernommen === alt.name ? 'Consumption counters taken over. ' : '';
1054
+ this.log.info(
1055
+ `"${g.name}": module ${modulId} was known as "${alt.name}" (${this.namespace}.${aid}). ${zusatz}The old objects are no longer updated and can be deleted.`,
1056
+ );
1057
+ }
1058
+
1059
+ const native = { modulId };
1060
+ if (eigenNative.renamedTo) {
1061
+ native.renamedTo = null;
1062
+ }
1063
+ if (uebernommen) {
1064
+ native.zaehler = g.zaehler;
1065
+ g.gesichert = Date.now();
1066
+ g.zaehlerGeaendert = false;
1067
+ }
1068
+ if (eigen && (eigenNative.modulId !== modulId || eigenNative.renamedTo || uebernommen)) {
1069
+ await this.extendObject(id, { native });
1070
+ }
1071
+ }
1072
+
870
1073
  async objektAnlegen(geraetId, def, feld, stateId, einheit = def.unit) {
871
1074
  await this.extendObject(`${geraetId}.${def.kanal}`, {
872
1075
  type: 'channel',
@@ -956,7 +1159,21 @@ class Faikout extends utils.Adapter {
956
1159
 
957
1160
  // Der ECHTE Geraetename gehoert ins Topic, nicht die bereinigte Objekt-ID.
958
1161
  const topic = `command/${g.name}/${suffix}`;
959
- const nutzlast = this.nutzlast(feld, state.val);
1162
+ let nutzlast;
1163
+ if (def && def.zahlZu) {
1164
+ // Zahl-Zwilling (modeNum ...): das Modul versteht nur Text. Der Text-Datenpunkt
1165
+ // bleibt unberuehrt - beide ziehen mit der Bestaetigung des Moduls nach. Ihn hier
1166
+ // mitzuschreiben (ack=false) loeste einen zweiten Befehl aus.
1167
+ nutzlast = felder.zahlZuText(feld, state.val);
1168
+ if (nutzlast === null) {
1169
+ this.log.warn(
1170
+ `${g.name}: value ${JSON.stringify(state.val)} for ${feld} is not valid (allowed: ${JSON.stringify(def.states)}) - command discarded.`,
1171
+ );
1172
+ return;
1173
+ }
1174
+ } else {
1175
+ nutzlast = this.nutzlast(feld, state.val);
1176
+ }
960
1177
  const ok = await this.broker.publish(topic, nutzlast);
961
1178
  if (ok) {
962
1179
  this.log.debug(`-> ${topic} = ${nutzlast}`);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iobroker.faikout",
3
- "version": "0.1.0",
3
+ "version": "0.2.1",
4
4
  "description": "Connect Daikin air conditioners with a faikout module locally via MQTT.",
5
5
  "author": {
6
6
  "name": "Immanuel",
@@ -38,7 +38,7 @@
38
38
  "@alcalzone/release-script-plugin-manual-review": "^5.2.0",
39
39
  "@iobroker/adapter-dev": "^1.5.0",
40
40
  "@iobroker/eslint-config": "^2.3.4",
41
- "@iobroker/testing": "^6.3.0",
41
+ "@iobroker/testing": "^6.3.2",
42
42
  "@tsconfig/node22": "^22.0.6",
43
43
  "@types/node": "^22.18.11",
44
44
  "mqtt": "^5.15.2",
@@ -58,7 +58,7 @@
58
58
  "test:integration": "mocha test/integration --exit",
59
59
  "test": "npm run test:package && npm run test:unit",
60
60
  "lint": "eslint .",
61
- "test:unit": "mocha test/verbrauch test/broker test/namen test/einheiten test/abgelehnt test/schreiblast test/devicemanager --exit",
61
+ "test:unit": "mocha test/verbrauch test/broker test/namen test/einheiten test/abgelehnt test/schreiblast test/devicemanager test/zahlundtext test/umbenennen --exit",
62
62
  "release": "release-script"
63
63
  }
64
64
  }
@@ -697,7 +697,7 @@ vis.binds.faikout = {
697
697
  .on('click', function () {
698
698
  var alt = ctx.wert(z.feld);
699
699
  // `swing` ist eine Liste (off/on), alle anderen sind Schalter.
700
- // `swing` kennt off/on/V/H/H+V/C (SWING_* in Faikout.c). Umgeschaltet wird nur
700
+ // `swing` kennt off/on/V/H/H+V/C/H+C (SWING_* in Faikout.c). Umgeschaltet wird nur
701
701
  // zwischen aus und ein; die Achsen setzt man ueber swingv/swingh.
702
702
  if (z.feld === 'control.swing') vis.setValue(ctx.oid(z.feld), alt === 'off' ? 'on' : 'off');
703
703
  else vis.setValue(ctx.oid(z.feld), !alt);
@@ -1102,7 +1102,7 @@ vis.binds.faikout = {
1102
1102
  .html(b.SYM[z.sym] + (mitText ? '<span>' + z.name + '</span>' : ''))
1103
1103
  .on('click', function () {
1104
1104
  var alt = ctx.wert(z.feld);
1105
- // `swing` kennt off/on/V/H/H+V/C (SWING_* in Faikout.c). Umgeschaltet wird nur
1105
+ // `swing` kennt off/on/V/H/H+V/C/H+C (SWING_* in Faikout.c). Umgeschaltet wird nur
1106
1106
  // zwischen aus und ein; die Achsen setzt man ueber swingv/swingh.
1107
1107
  if (z.feld === 'control.swing') vis.setValue(ctx.oid(z.feld), alt === 'off' ? 'on' : 'off');
1108
1108
  else vis.setValue(ctx.oid(z.feld), !alt);