3.8 Autonomous Metering System (AMS)

The AMS solution provides an automatic remote reading of not only such appliances as electric meters, gas meters or water meters, but also variable sensors and detectors. Data are read, remotely collected and transmitted to central software. This provides the building manager or power supplier with fresh consumption data for further processing (service billing, e.g.). IEC 62056-21 or M-Bus via the RS 232/RS 485/M-Bus interface is used for meter communication. Data can thus be read out periodically and stored in the 2N^® SmartCom PRO  internal memory for sorting and filtering. Integration of other communication protocols can be solved according to the customer's needs.

The AMS is configured via the AT interfaces described below. Log in via your terminal to an AMS-supporting 2N^® SmartCom PRO and follow the instructions below. Add up to 64 independent meters to the meter list. The data space size is determined by the HW version. All records are written into a circular buffer, which means that whenever the memory is full, the oldest record will be deleted and replaced with a new one.

AMS Device Configuration

The commands below are used for meter configuring.

AT^SCAMS=?

The command writes out the list of AMS module control commands, their parameters and parameter formats. 

Reply: 

^SCAMS: "ENABLE",0|1
^SCAMS: "RETRY",0-9
^SCAMS: "DEV_ADD",1-1000,"32"|1-1000,"32","3"
^SCAMS: "DEV_REMOVE",1-32
^SCAMS: "DEV_CLEAR"
^SCAMS: "DEV_INTERVAL","ALL"|1-32,"3"
^SCAMS: "DIRECT_READ",1-1000,"32"|1-1000,"32",110-230400,0|1
OK

AT^SCAMS?

The command writes out the contents of the device list to be served by the AMS module.

^SCAMS: NO DEVICE
OK

Example of a reply if the list includes 4 devices:

^SCAMS: 1> 2,"IEC62056-21","869551","1M"
^SCAMS: 2> 2,"IEC62056-21","869552","15M"
^SCAMS: 3> 128,"AIN_DIN","1/ADC/CAL","1M"
^SCAMS: 4> 128,"AIN_DIN","2/PULSE/ABS","1H"
OK

AT^SCAMS="ENABLE",<zapnuto>

^SCAMS: "ENABLE",1
OK

OK

ERROR

AT^SCAMS="RETRY"[<retry_count>]

^SCAMS: "RETRY",<current_retry_count>
OK

AT^SCAMS="RETRY"

OK

ERROR

AT^SCAMS="DEV_ADD",<port>,<protocol>,<address>,<interval>

 — Examples of Use — 

As configuration is not easy, let us give a few examples to help you set the required function(s) successfully.

AT^SCAMS="DEV_ADD",2,"IEC62056-21","869551","3M"

AT^SCAMS="DEV_ADD",2,1,"869551","3M"

AT^SCAMS="DEV_ADD",2,"MBUS","128@2400","1H"

AT^SCAMS="DEV_ADD",2,"MBUS","128","1H"

AT^SCAMS="DEV_ADD",2,2,"128","1H"

AT^SCAMS="DEV_ADD",2,"MBUS","*01579411@2400","1H"

AT^SCAMS="DEV_ADD",2,"MBUS","*015794FF@2400","1H"

AT^SCAMS="DEV_ADD",128,"AIN_DIN","1/ADC/CAL","1H"

AT^SCAMS="DEV_ADD",128,"AIN_DIN","2/DIN","2H"

AT^SCAMS="DEV_ADD",128,128,"2/DIN","2H"

AT^SCAMS="DEV_ADD",128,"AIN_DIN","1/PULSE/ABS","2H"

OK

ERROR

AT^SCAMS="DEV_REMOVE",<index>

AT^SCAMS="DEV_REMOVE",4

Reply format - action succeeded:

OK

Reply format - action failed: 

ERROR

AT^SCAMS="DEV_CLEAR"

 The AMS module command removes all the devices from the device list.

Reply format - action succeeded: 

OK

Reply format - action failed: 

ERROR

AT^SCAMS="DEV_INTERVAL",<index>,<interval>

The AMS module command changes the data reading time interval for a device included in the device list.

• <index> - index of the device (in the device list) for which time is to be changed
  • numerical format (number) or symbolic name (text string)
    • for number: index of the device (in the device list) for which time is to be changed
    • for text string: "ALL" - change time for all the devices included in the device list
• <interval> - time interval symbol text string (minutes/hours/days), setting options:
  • "1M", "2M", "3M", "4M", "5M", "6M", "10M", "12M", "15M", "20M", "30M", "1H", "2H", "3H", "4H", "6H", "8H", "12H", "1D"

Example 1 - suppose you want to change the data reading interval to 1 hour for the index 3 device:

AT^SCAMS="DEV_INTERVAL",3,"1H"

Example 2 - suppose you want to change the data reading interval to 30 minutes for all the devices listed:

AT^SCAMS="DEV_INTERVAL","ALL","30M"

Reply format - action succeeded: 

OK

Reply format - action failed: 

ERROR

AT^SCAMS="DIRECT_READ",<port>,<protocol>,<address>,{<extra_parameter1>[<extra_parameter2>]}

The AMS module command performs immediate data reading from a device and writes out the data.

• <port> - number of the physical port to which the device is connected - number
  • 2   - RS232/RS485/MBUS communication port (depending on HW version)
  • 128 - internal A/D input module communication port (analogue/digital input module)
• <protocol> - name of the communication protocol used for device communication
  • for number:
    • 1   - denotes the IEC 62056-21 protocol
    • 2   - denotes the M-Bus protocol
    • 128 - denotes the A/D input protocol (for reading data from the  analogue/digital input module )
  • for text string:
    • "IEC62056-21" -  denotes the  IEC 62056-21 protocol
    • "MBUS" -  denotes the  M-Bus protocol
    • "AIN_DIN" -  denotes the A/D input protocol (for reading data from the  analogue/digital input module )
• <address> - device address - text string
  • for IEC 62056-21 -  the address consists of a text string  <address> [@ <default_baudrate>][% <switches>], where:
    • <address> -  device address (identical with the original device address)
    • < default_baudrate > - an optional parameter defining the default baud rate in Bauds
    • < switches > - an optional parameter - switch array for data reading process control. Now an 'R' switch is only implemented to prevent a change of the default baud rate
  • for M-Bus- the  address consists of a text string  <address>[@<baudrate>]
    • <address> - M-Bus device (meter) address
      • primary address - <address> is a number ranging from 0 to 250
      • secondary address - <address> has the format *<address_8>, where <address_8> consists of 8 characters of the secondary address, where each character is:
        • a digit ranging from 0 to 9
        • a wildcard 'F' character (substituting any numerical value on the given position in the range between 0 and 9)
    • <baudrate> - communication rate in Bauds; if the parameter is not included, the default value is used. Setting options: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400. Default value: 2400 .
  • for A/D input protocol  - t he  address consists of the text string  <input>/<parameter>[/<option>]
    • <input> - number of the input for which data reading is to be made, setting options:
      • 1 - input 1
      • 2 - input 2
    • <parameter> - text string specifying the data to be read; setting options:
      • ADC   - analogue signal measurement on an analogue input
      • DIN   - logical value reading on analogue input; result values: 0 to 1
      • PULSE - digital input pulse counter reading
    • <option> -  text string specifying the parameter options; setting options :
      • for ADC:
        • CAL - the data reading result is a calibrated value ranging from 0 to 100
        • ABS -  he data reading result is a value obtained directly from the A/D converter ranging from 0 to 1023
      • for DIN - <option> is undefined and thus unavailable for this parameter
      • for PULSE:
        • ABS -  the data reading result is the current pulse count read in the input pulse counter ranging from 0 to (2^64 - 1)
        • REL -  the data reading result is the pulse count read after the last data reading (or pulse counter deletion/resetting) ranging from 0 to  (2^64 - 1)
• < extra_parameter1 > - optional protocol parameter
  • specifies the protocol default baud rate
  • IEC 62056-21 - specifies the required default baud rate of the protocol; if the parameter is not included, the default value is used
  • M-Bus - no meaning (ignored)
  • A/D inputs - no meaning (ignored)
• < extra_parameter2 > - optional protocol parameter 
  • specifies whether to deny or accept a higher baud rate offer for the "Protocol mode C"
  • IEC 62056-21 - logical value (if the parameter is not included, 0 is used)
    • 0 - the protocol accepts the higher baud rate offer from the device for the "Protocol mode C"
    • 1 - the protocol denies the higher baud rate offer from the device for the "Protocol mode C" and communication goes on at the default rate
  • M-Bus - no meaning (ignored)
  • A/D inputs  - no meaning (ignored)

Reply format:

^SCAMS: <error_code>,<device_identification>,<data>
OK

• <error_code> - error code returned as a result of the data reading process (0 means no error) - number 
  • 32-bit signless decimal number
• <device_identification> - device identification - text string<data> - raw data read from a device - text string
  • 32-bit signless decimal number
    
    

— Examples of Immediately Readings — 

Example 1 - suppose you want to read immediately and write out data for a device connected to port 2, communicating via IEC 62056-21 and having the address 947833. The command is as follows:

AT^SCAMS="DIRECT_READ",2,1,"947833"

Example 2 - same as above, but 1200 Bd is the default baud rate:

AT^SCAMS="DIRECT_READ",2,"IEC62056-21","947833",1200

Example 3 - same as above, but the higher baud rate offer for the "Protocol mode C" from the device is denied:

AT^SCAMS="DIRECT_READ",2,1,"947833",1200,1

Example 4 - suppose you want to read immediately and write out data for a device connected to port 2, communicating via M-Bus, having the primary address  128 and communicating at 2400 Bd:

AT^SCAMS="DIRECT_READ",2,"MBUS","128@2400"

Example 5 - same as above, but  the baud rate is not specified and thus the default baud rate of 2400 Bd is used:

AT^SCAMS="DIRECT_READ",2,"MBUS","128"

Example 6 - same as above, but the protocol is given in a numerical format :

AT^SCAMS="DIRECT_READ",2,2,"128"

Example 7 - suppose you want to read immediately and write out data for a device connected to port 2, communicating via M-Bus, having the secondary address 01579411  and communicating at 2400 Bd:

AT^SCAMS="DIRECT_READ",2,"MBUS","*01579411@2400"

Example 8 - suppose you want to read immediately and write out data for a device connected to port 2, communicating via M-Bus, having the secondary address with two wildcard positions 015794FF   and communicating at 2400 Bd :

AT^SCAMS="DIRECT_READ",2,"MBUS","*015794FF@2400"

Example 9 -  suppose you want to read the immediate signal value for analogue input 1 via the A/D input port and calibrate and write out the result :

AT^SCAMS="DIRECT_READ",128,"AIN_DIN","1/ADC/CAL"

Example 10 -  suppose you want to read the immediate signal value for analogue input 2 via the A/D input port, convert the result into logical interpretation of the signal level and write out the result :

AT^SCAMS="DIRECT_READ",128,"AIN_DIN","2/DIN"

Example 11 -  suppose you want to read the immediate pulse counter value for digital input 1 via the A/D input port and write out the result :

AT^SCAMS="DIRECT_READ",128,"AIN_DIN","1/PULSE/ABS"

— End of Examples of Immediate Readings — 

Automatic Meter Detection

The command is used for automatic detection of a device on a bus.

AT^SCAMSADD=,<port>,<protocol>,<baudrate>,<interval>,<count_of_expected_devices>

The command detects a device on the bus, adds it to AMS device list, deletes data in the data space and writes out the result including the addresses of the meters detected.

• <port> - number of the physical port to which the device is connected - number
  • 2   - RS232/RS485/M-Bus communication port (depending on the HW version)
  • 128 - internal A/D input module communication port (analogue/digital input module)
• <protocol> -  name/number of the communication protocol used for device communication
  • for number:
    • 1   - denotes the IEC 62056-21 protocol
    • 2   - denotes the M-Bus protocol
    • 128 - denotes the A/D input reading protocol (for reading data from the  analogue/digital input module )
  • for text string:
    • "IEC62056-21" -  denotes the IEC 62056-21 protocol
    • "MBUS" -  denotes the M-Bus protocol
    • "AIN_DIN" -  denotes the A/D input protocol (for reading data from the  analogue/digital input module )
• <baudrate> - communication rate in Bauds; if the parameter is not included, the default value is used
  • setting options: 300, 600, 1200, 2400, 4800, 9600, 19200, 38400; default value: 2400.
• <interval> -  time interval symbol   text string  (minutes/hours/days); setting options:
  • "1M", "2M", "3M", "4M", "5M", "6M", "10M", "12M", "15M", "20M", "30M", "1H", "2H", "3H", "4H", "6H", "8H", "12H", "1D"
• <count_of_expected_devices> - number specifying the count of newly added devices
  • count of devices expected to be on the bus. If the count is met, automatic detection will be terminated. 

Reply format:

^SCAMSADD: <error_code> , <count_of_devices> , <primary_address1> ; <secondary_address1> ; <primary_address2> ; <secondary_address2> ; ..................... "OK

Examples of commands (3 meter detection on M-Bus, 2400 Bd 2 hour AMS reading interval) - one command written in different ways:

AT^SCAMSADD=2,2,"default","2h",3

AT^SCAMSADD=2,2,"2400","2h",3

AT^SCAMSADD=2,mbus,"default","2h",3

AT^SCAMSADD=2,mbus,"2400","2h",3

Examples of replies:

No error (detection of 3 meters): With error (a different meter count was detected: 2 meters in this case): 

^SCAMSADD: 65286,2,"1,00660421;19,08780251"OK

With error (secondary address collision of the M-Bus slave devices): 

^SCAMSADD: 131094,0,""OK

Reading of AMS Records

AT interface for AMS-type data record reading.

AT^SCDATA=?

^SCDATA: "MESS_CNT"^SCDATA: "GET_SPACE"^SCDATA: "GET_OLDEST"^SCDATA: "GET_FILTERED","0-150"^SCDATA: "DEL_OLDEST"^SCDATA: "DEL_ALL"OK

AT^SCDATA="MESS_CNT"

The data record reading module command returns the count of data records stored.

 Reply format: 

^SCDATA: "MESS_CNT",<count>OK

Example of reply (the data record memory contains 44 records): 

^SCDATA: "MESS_CNT",44OK

The data record reading module command returns the memory size available for data record storing (in bytes).

Reply format: 

^SCDATA: "GET_SPACE",<count>OK

Example of reply (the available free memory space is 7,008,089 B) 

^SCDATA: "GET_SPACE",7008089OK

AT^SCDATA="GET_OLDEST",<count>

The data record reading module command returns the listing of the oldest data records .

• <count> - specifies the count of the oldest records to be listed - number

Reply format for a known data format and meaning of the parameters in the row:

AT^SCDATA: <record_type>,<time_stamp>,<sequence_number>,<protocol>,<index>,<error_code>,<device_identification>,<data>OK

^SCDATA:"WMBUS",1452142010,36617,-14,70,"44A2057714005401377277140054A2050137E70000002F2F046D052707210167460DFD11106563616B696E756D6F6B656C65544E320E138545030000002F2F2F2F2F2F2F2F2F"OK

AT^SCDATA: <record_type>,<time_stamp>,<sequence_number>,"Unsupported record format"OK

Filtering of AMS Records

AT^SCDATA="GET_FILTERED",<filter>

AT^SCDATA: <record_type>,<time_stamp>,<sequence_number>,<protocol>,<index>,<error_code>,<device_identification>,<data>  
OK

<parameter> - text string defining the condition parameter. The supported strings are as follows:

• RECORD_TYPE - data record type
• TIME - data record timestamp
• TABLE_ID - device index in the device list
• ERROR_CODE - data record error code

<session> - text string defining the required session between the condition parameter and condition value. The supported strings are as follows:

AT^SCDATA="GET_FILTERED","RECORD_TYPE==WMBUS"

AT^SCDATA="GET_FILTERED","RECORD_TYPE==AMS;TIME>=1388665085;TIME<=1388668685"

AT^SCDATA="GET_FILTERED","RECORD_TYPE==AMS;TIME>1388665085;TABLE_ID==1"

AT^SCDATA="GET_FILTERED","ERROR_CODE!=0"

AT^SCDATA="GET_FILTERED","ERROR_CODE==0;RECORD_TYPE==AMS;TIME>1388668685"

AT^SCDATA="DEL_OLDEST",<count>

AT^SCDATA="DEL_OLDEST",5

OK

ERROR

AT^SCDATA="DEL_ALL"

OK

ERROR

AT^SCAMS="DIRECT_READ",128,"AIN_DIN","2/DIN"