Add repeater protocol and device firmware features

This commit is contained in:
Lars Nolden
2026-09-21 12:30:50 +02:00
parent 73d3ddf00c
commit a11a4b3b89
41 changed files with 7791 additions and 228 deletions
+89
View File
@@ -0,0 +1,89 @@
/*
* Independent header-only identification; no third-party decoder code.
* Factual medium/type codes and documented TCH exceptions cross-referenced
* against wmbusmeters src/wmbus.cc, mediaType(), retrieved 2026-09-09:
* https://github.com/wmbusmeters/wmbusmeters/blob/master/src/wmbus.cc
* That reference project is GPL-3.0-or-later (Fredrik Öhrström and contributors);
* no implementation is copied here. No payload, driver or model decoding.
* FLAG/company registration facts are sourced separately in manufacturers.js.
*/
import { manufacturers } from './manufacturers.js';
export function hex(value, width = 2) {
return Number.isInteger(value) && value >= 0
? `0x${value.toString(16).toUpperCase().padStart(width, '0')}` : 'nicht verfügbar';
}
export function manufacturerInfo(value) {
if (!Number.isInteger(value) || value < 0 || value > 0xFFFF) {
return { code: '', name: 'Hersteller nicht verfügbar', raw: hex(value, 4), warning: 'Kein gültiges Herstellerfeld vorhanden' };
}
const letters = [(value >> 10) & 31, (value >> 5) & 31, value & 31];
const valid = letters.every(letter => letter >= 1 && letter <= 26);
const code = valid ? String.fromCharCode(...letters.map(letter => letter + 64)) : '';
return {
code,
name: code ? (manufacturers[code] || 'Nicht registrierter / unbekannter Hersteller') : 'Ungültiger Herstellercode',
raw: hex(value, 4),
warning: !valid ? 'Das Herstellerfeld enthält keine gültige Kennung aus drei Buchstaben (A–Z)'
: value & 0x8000 ? 'Das höchste Bit im Herstellerfeld ist gesetzt; die Suche im FLAG-Herstellerverzeichnis nutzt nur die unteren 15 Bits' : '',
};
}
const media = {
0x00: 'Sonstiges', 0x01: 'Ölzähler', 0x02: 'Stromzähler', 0x03: 'Gaszähler',
0x04: 'Wärmezähler', 0x05: 'Dampfzähler', 0x06: 'Warmwasserzähler (30–90 °C)',
0x07: 'Wasserzähler', 0x08: 'Heizkostenverteiler', 0x09: 'Druckluftzähler',
0x0A: 'Kältevolumen am Auslass', 0x0B: 'Kältevolumen am Einlass',
0x0C: 'Wärmevolumen am Einlass', 0x0D: 'Wärme- / Kältelastzähler',
0x0E: 'Bus- / Systemkomponente', 0x0F: 'Unbekanntes Messmedium',
0x15: 'Heißwasserzähler (≥90 °C)', 0x16: 'Kaltwasserzähler',
0x17: 'Heiß- / Kaltwasserzähler', 0x18: 'Druckmesser', 0x19: 'Analog-Digital-Wandler',
0x1A: 'Rauchmelder', 0x1B: 'Raumtemperatur- / Luftfeuchtesensor',
0x1C: 'Gasmelder', 0x20: 'Stromschalter', 0x21: 'Gas- / Wasserventil',
0x25: 'Kundenanzeige', 0x28: 'Abwasser', 0x29: 'Abfall',
0x2A: 'Für Kohlendioxid reserviert', 0x31: 'Für Kommunikationssteuerungen reserviert',
0x32: 'Für Einweg-Funkweiterleiter reserviert', 0x33: 'Für Zweiweg-Funkweiterleiter reserviert',
0x36: 'Funkkonverter (Systemseite)', 0x37: 'Funkkonverter (Zählerseite)',
};
const techemMedia = {
0x43: 'Wärmezähler', 0x62: 'Warmwasser', 0x72: 'Kaltwasser',
0x80: 'Heizkostenverteiler', 0xC3: 'Wärmezähler', 0xF0: 'Rauchmelder',
};
export function mediumInfo(value, manufacturer) {
const raw = hex(value);
if (!Number.isInteger(value) || value < 0 || value > 255) {
return { name: 'Gerätetyp nicht verfügbar', raw, scoped: false };
}
let name = media[value];
// Only this exact manufacturer has these documented non-standard meanings.
const scoped = manufacturer === 0x5068 && Object.hasOwn(techemMedia, value);
if (scoped) name = techemMedia[value];
if (!name) {
if (value >= 0x1D && value <= 0x1F) name = 'Für Sensoren reserviert';
else if (value >= 0x22 && value <= 0x24) name = 'Für Schaltgeräte reserviert';
else if (value >= 0x26 && value <= 0x27) name = 'Für Kundengeräte reserviert';
else if (value >= 0x2B && value <= 0x2F) name = 'Für Umweltmessgeräte reserviert';
else if (value >= 0x30 && value <= 0x3F) name = 'Für Systemgeräte reserviert';
else name = 'Unbekannter / reservierter Gerätetyp';
}
return { name, raw, scoped };
}
export function senderIdentity(row) {
const rawId = typeof row.meter_id === 'string' ? row.meter_id : '';
const id = /^[0-9A-Fa-f]{8}$/.test(rawId) ? rawId.toUpperCase() : '';
const trusted = row.source === 'rx' && row.crc_ok === true && row.reception === 'ok';
const manufacturer = manufacturerInfo(row.manufacturer);
const medium = mediumInfo(row.device_type, row.manufacturer);
const warnings = [];
if (!trusted) warnings.push('Keine empfangene Kennung mit gültiger CRC-Prüfsumme; eigene Namen und Geräteerkennung werden nicht verwendet');
if (rawId && !id) warnings.push('Ungültige ID: erwartet werden genau acht Hexadezimalstellen (0–9, A–F)');
if (id && !/^[0-9]{8}$/.test(id)) warnings.push('ID nicht im BCD-Ziffernformat: Die Hexadezimalkennung bleibt unverändert. Sie darf nicht als dezimale Zählernummer gelesen werden');
if (trusted && manufacturer.warning) warnings.push(manufacturer.warning);
return {
id, rawId, trusted, labelEligible: trusted && Boolean(id), manufacturer, medium, warnings,
key: `${id}/${row.manufacturer}/${row.version}/${row.device_type}`,
};
}