Files
heltec-repeater/firmware/main/web/identity.js
T

90 lines
4.9 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 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}`,
};
}