diff --git a/README.md b/README.md index fc6f29c..a183095 100644 --- a/README.md +++ b/README.md @@ -50,9 +50,10 @@ You can trigger a reload of the config files with `sudo killall -HUP wmbusmeters `wmbusmetersd /tmp/thepidfile` from a script instead.) Check the config file /etc/wmbusmeters.conf and edit the device. For example: -`auto:c1` or `im871a:c1` +`auto:c1` or `im871a:c1` or `im871a[457200101056]:t1` or `/dev/ttyUSB2:amb8465:c1,t1` -Adding a device like auto or im871a will trigger an automatic probe of all serial ttys. +Adding a device like auto or im871a will trigger an automatic probe of all serial ttys +to auto find or to find on which tty the im871a resides. If you specify a full device path like `/dev/ttyUSB0:im871a:c1` or `rtlwmbus` or `rtl433` then it will not probe the serial devices. If you must be really sure that it will not probe something @@ -154,7 +155,7 @@ depending on if you are running as a daemon or not. # Running without config files, good for experimentation and test. ``` -wmbusmeters version: 1.0.0 +wmbusmeters version: 1.0.2 Usage: wmbusmeters {options} ( [meter_name] [meter_type]{:} [meter_id] [meter_key] )* As you can use: @@ -190,12 +191,17 @@ As you can use: --usestderr write notices/debug/verbose and other logging output to stderr (the default) --usestdoutforlogging write debug/verbose and logging output to stdout --verbose for more information +``` As you can use: -auto:c1, to have wmbusmeters look existing serial devices and probe them to detect: im871a, amb8465, cul, rc1180 or rtlsdr. +auto:c1, to have wmbusmeters probe for devices: im871a, amb8465, cul, rc1180 or rtlsdr (spawns rtlwmbus). -If you have two im871a you can supply both of them and set different listening modes: +im871a:c1 to start all connected im871a devices in c1 mode, ignore all other devices. + +/dev/ttyUSB1:amb8465:c1 to start only this device on this tty. Do not probe for other devices. + +If you have two im871a you can supply both of them with their unique id:s and set different listening modes: im871a[12345678]:c1 im871a[11223344]:t1 You can also specify rtlwmbus and if you set the serial in the rtlsdr @@ -210,6 +216,7 @@ rtlsdr dongle like this `rtlwmbus[1234]`. These telegrams are expected to have the data link layer crc bytes removed already! rtlwmbus, to spawn the background process: "rtl_sdr -f 868.95M -s 1600000 - 2>/dev/null | rtl_wmbus" +for each attached rtlsdr dongle. rtlwmbus:868.9M, to tune to this fq instead. @@ -230,18 +237,19 @@ stdin:rtlwmbus, to read telegrams formatted using the rtlwmbus format from stdin telegrams.msg:rtlwmbus, to read rtlwmbus formatted telegrams from this file. Works for rtl433 as well. -simulation_abc.txt, to read telegrams from the file (which has a name beginning with simulation_) +simulation_abc.txt, to read telegrams from the file (the file must have a name beginning with simulation_....) expecting the same format that is the output from --logtelegrams. This format also supports replay with timing. As meter quadruples you specify: - a mnemonic for this particular meter + a mnemonic for this particular meter (!Must not contain a colon ':' character!) one of the supported meters (can be suffixed with : to specify which mode you expect the meter to use when transmitting) an 8 digit mbus id, usually printed on the meter an encryption key unique for the meter if the meter uses no encryption, then supply NOKEY +``` Supported wmbus dongles: IMST 871a (im871a) Amber 8465 (amb8465) diff --git a/wmbusmeters.1 b/wmbusmeters.1 index cd563c4..3adbcdd 100644 --- a/wmbusmeters.1 +++ b/wmbusmeters.1 @@ -101,9 +101,6 @@ mqtt_publish) sent to a REST API (eg curl) or store it in a database .TP \fBim871a[12345678]:t1\fR look for the im871a dongle with this particular id. -.TP -\fB/dev/ttyUSB0:9600\fR read serial data from tty at 9600 bps, expects raw wmbus frames with the DLL crcs removed. - .TP \fB/dev/ttyUSB0:amb8465:c1,t1\fR expect an amb8465 on this tty. @@ -114,6 +111,9 @@ mqtt_publish) sent to a REST API (eg curl) or store it in a database \fBrtlwmbus[alfa]:433M:c1,t1 rtlwmbus[beta]:868.9M:c1,t1\fR Use two rtlsdr dongles, one has its id set to alfa (using rtl_eeprom) and the other set to beta. Alfa has an antenna tuned for 433M, beta has an antenna suitable for 868.9M. +.TP +\fB/dev/ttyUSB0:9600\fR read serial data from tty at 9600 bps, expects raw wmbus frames with the DLL crcs removed. + .TP \fBstdin:rtlwmbus\fR read rtlwmbus formatted data from stdin.