This manual applies to the wireless program version 2.2.1
Manual version 2022-07-12
The header contains the following information.
The meterlist contains information about the wireless meters that have sent a telegram at some time. The list has an upper limit of 2000 meters.
A meter is excluded if it is listed in the exclude file and not listed in the include file. It will then never appear in the meter list.
The wireless program receives messages from wireless meters, decrypts and translates them into wired telegrams.
The wireless telegrams contain different CI-Fields. CI-fields supported are:
- 0x72 Tested
- 0x78 Tested
- 0x79 Ignored, see below
- 0x7A Tested
- 0x8C
- 0x8D Tested
- 0x8E
- 0x8F
- 0x90 Tested
- 0xA0--0xB7 Tested
Kamstrup meters do use CI-field 0x79 for compact unencrypted telegrams. Every eight'h telegram is a full telegram (CI-field = 0x78) but 7 of 8 telegrams are compact (Ci-field = 0x79). Expansion of compact telegrams is not supported and the telegram is not put into an LVAR container like for other unsupported telegrams but ignored. 0x78 telegrams are unencrypted and converted to wired telegrams but the 0x79 telegrams are thrown away because all other actions other than expanding them correctly will spoil the wired telegram.
The wired telegram
Datarecord 1: Fabrication number (Pi-900S serial number) 0C 78 XX XX XX XX
Datarecord 2: Duration [sec] 03 74 XX XX XX
Datarecord 3: RF signal strength (RSSI) [dBm] 01 FD 71 XX
Datarecord 4: Date/Time CP48 (UTC) 06 6D XX XX XX XX XX XX
If the wireless meter is unencrypted with a known CI-field or correctly decrypted, datarecord 5 will be wireless datarecord 1. If the wireless meter is either not decrypted or contains an unknown CI-field, datarecord 5 will be an L-var that contains the full wireless telegram.
Datarecord 4 is a timestamp of the incoming telegram in UTC (or Greenwich Mean Time). Most wired M-Bus application make timestamps when the telegram is read out but this is not acceptable with wireless meters since the value can be cached for hours before readout. This datarecord makes a timestamp when the telegram is sent which will give a much better timestamp and it is also more easily configurated than reading the meters timestamp.
The internal telegram is the telegram that can be read with the Wireless programs secondary address <serialno>.4129.01.36 or primary address (default 250).
Telegram 1
Datarecord 1: Fabrication number (Pi-900S serial number) 0C 78 XX XX XX XX
Datarecord 2: Date/Time CP48 06 6D XX XX XX XX XX XX
Datarecord 3: More datarecords in the next telegram 1F
Datarecord 4--: LVAR one per included meter 0D FD 76 10 (16 bytes)
The content of the 16 byte LVAR is defined in the following way:
4 bytes: M-Bus ID Little endian
2 bytes: Manufacturer Little endian
1 byte: Version
1 byte: Medium
1 byte: Primary address
2 bytes: Duration [min]
1 byte: RSSI0 + Hop count
1 byte: RSSI1 + Hop count
2 bytes: Reserved
The wireless Include/exclude files are semicolon separated CSV files (Comma Separated Values). The include/exclude system is a very powerful system to include the meters in your own system and exclude the neighbours meters to keep the total number of meters within license.
The filename must be on the format wireless_XXX.csv. The filename is case sensitive meaning that Wireless_include_T1C.csv and wireless_INCLUDE_t1C.CsV are two different files. Both will show up in the selection dropdown list.
Example:
wireless_include_T1C.csv and wireless_exclude_T1C.csv.
The files can be uploaded via the web interface. Configuration->Basic Configuration->"Upload CSV/XML-File"
By default, there are two files shipped with the Pi-900S: wireless_include_default.csv and wireless_exclude_default.csv. The files are only examples and must be renamed to take effect. They can be downloaded from Configuration->Basic Configuration->"Download CSV/XML-File"
The exclude file is a list of unwanted wireless meters. Wildcards can be used at will.
Example:
12345678.1111.22.33 Exclude a single meter (not very useful). If meter is registered in include file, it will be included.
FFFFFFFF.4129.FF.FF Exclude all PiiGAB wireless products that are not registered in the include file.
FFFFFFFF.FFFF.FF.FF Exclude all meters that are not registerd in the include file.
The include file is used either to override the exclude file or to add extra configuration parameters. It supports wildcards.
Examples:
12345678.1111.22.33;1;0123456789ABCDEF0123456789ABCDEF Primary address = 1, Wireless key.
FFFFFFFF.1111.FF.FF Include all meters with manufacturer = 1111. No decryption key
FFFFFFFF.1112.FF.FF;;;0 Include all meters with manufacturer = 1112. Passive (active = 0) unless included with full addresses
23456789.1112.22.44;200 Include meter and set primary address to 200. Not encrypted. Included and available
FFFFFFFF.2222.FF.FF;;0123456789ABCDEF0123456789ABCDE0 All meters with this MFCT = 2222 will have the same encryption key
12345678.2222.11.22;;0123456789ABCDEF0123456789ABCDE1 except this meter that has a different key even if it is further down the list.