pull/1371/head
Fredrik Öhrström 2024-08-25 15:38:05 +02:00
rodzic 9fb318a503
commit a7c80a9c72
1 zmienionych plików z 11 dodań i 23 usunięć

Wyświetl plik

@ -30,26 +30,19 @@ or into json:
}
```
Wmbusmeters can collect telegrams from radio using hardware dongles or rtl-sdr software radio dongles,
or from m-bus meters using serial ports, or from files/pipes.
Wmbusmeters can collect telegrams from radio using hardware dongles or
rtl-sdr software radio dongles, or from m-bus meters using serial
ports, or from files/pipes.
# You can now write new meter drivers without recompiling wmbusmeters!
Wmbusmeters uses drivers to translate the measurement values from a
meter to understandable key-value pairs.
What is a driver and why is it needed?
The (w)mbus meters can be very complicated. Even though
the protocol is self-describing and you can automatically
decode a 32 bit signed binary word representing a volume in m3
stored in storage slot 1.
What does this measurement mean? Is it last months final measurement
that will be used for water billing? Is it the amount of gas
delivered last year?
The driver creates mapping rules from Type,Unit,StorageNr,SubUnitNr,TariffNr
into for example `heat_consumption_at_set_date_kwh`.
For example:
You can automatically decode a 32 bit signed binary word
representing a volume in m3 stored in storage slot 1 but what does this
measurement mean? Is it last months final measurement that will be
used for water billing? Is it the amount of gas delivered last year?
The [drivers](https://github.com/wmbusmeters/wmbusmeters/tree/master/drivers/src)
adds this knowledge, here is an example:
```
field {
name = target
@ -63,11 +56,6 @@ field {
}
```
Will create a mapping rule that looks for a Instantaneous,Volume,20,0,0 value
and, if found, then generate `"target_m3": 1234` json key-value in the decoded output.
[Drivers](https://github.com/wmbusmeters/wmbusmeters/tree/master/drivers/src)
[FAQ/WIKI/MANUAL pages](https://wmbusmeters.github.io/wmbusmeters-wiki/)
The program runs on GNU/Linux, MacOSX, FreeBSD, and Raspberry Pi.