3.8 Autonomous Metering System (AMS)

The AMS solution provides automatic remote reading of such appliances as electric meters, gas meters or water meters, but also variable sensors and detectors. Data is 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 is 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.

Response:

^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

^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",<on>

^SCAMS: "ENABLE",1
OK

OK

ERROR

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

^SCAMS: "RETRY",<current_retry_count>
OK

AT^SCAMS="RETRY"

AT^SCAMS="RETRY",2

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

Response format – action succeeded:

OK

Response format – action failed:

ERROR

AT^SCAMS="DEV_CLEAR"

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

Response format – action succeeded:

OK

Response 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
  • numeric 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 – suppose you want to change the data reading interval to 1 hour for the index 3 device:

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

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

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

Response format – action succeeded:

OK

Response 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
  • 1 – RS232 communication port
    
  • 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
    • 3 – denotes the Modbus protocol
    • 64 – denotes the INMAT 51 / INMAT 66 communication protocol
    • 65 – denotes the LOTOS 301 communication 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
    • "MODBUS" – denotes the Modbus protocol
      
    • "INMAT" – denotes the INMAT 51 / INMAT 66 communication protocol
    • "LOTOS" – denotes the LOTOS 301 communication protocol
      
    • "AIN_DIN" – denotes the A/D input protocol (analogue/digital input module data reading protocol)
• <address> – device address – device address text string
  • for IEC 62056-21 –  the address consists of 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 initial baud rate.
  • for M-Bus- the address consists of 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 Modbus the address consists of text string <address> @ <default_baudrate> [<max_cmd_data_size>, <data_block_1>,...., <data_block_N>], where:

• • • <address> – Modbus device 8-bit address (mandatory parameter) 
      
    • < default_baudrate > – a mandatory parameter defining the default baud rate in bauds. Default = 9600.
    • <max_cmd_data_size> – an optional parameter defining the maximum size of the data block to be provided by the target device at once. Default = 1.
    • <data_block_x> – an optional parameter consisting of the following parts: <cmd>:<mem_addr>:<data_cnt>, where:
  • • • <cmd> – Modbus command, 8-bit HEX
      • <mem_addr> – target Modbus device memory address, 16-bit HEX
      • <data_cnt> – count of data to be read out of the target Modbus device, starting at  <mem_addr>, 16-bit DEC
  • for INMAT 51/66 the address consists of text string <address>[@<baudrate>]|<command_1>,<command_2>,....,<command_N>, where:
    
    • • <address> – device address – number ranging from 0 to 63 
      • <baudrate> – communication rate in bauds. If the parameter is not included, the default baudrate is used: 9600.
      • <command_x> – text string <command_code>[:<parameter_1>[:<parameter_2>[:....[:<parameter_K>]]]]", which specifies one command.
        • <command_code> – an alphabetical letter that specifies an INMAT 51/66 command. The letters are assigned to the following commands:
          • • 'I' – read device ID
            • 'S' – read one value
            • 'E' – read one value from value matrix
            • 'B' –read value block from value matrix
            • 'M' – read memory
        • <parameter_x> – text string of one command parameter. The count of command parameters depends on the command type. The command parameter counts and formats are as follows:
          • • command 'I' (read device ID): parameter count is zero (no parameters are needed)
            • command 'S' (read one value): parameter count is 2
              
              • <parameter_1> – an alphabetical letter that specifies the required variable type. The letters are assigned to the following types:
                • • 'I' – type "INT", 2 bytes
                  • 'L' – type "LONG", 4 bytes
                  • 'F' – type "FLOAT", number with a decimal floating point (according to IEEE), 4 bytes
                  • 'S' – type "STRING", sequence of ASCII characters terminated with a zero char, 1 to 246 bytes
              • <parameter_2> – database variable index within a station (INX); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FF
            • command 'E' (read  one value from value matrix): parameter count is 4
              • <parameter_1> – an alphabetical letter that specifies the required variable type. The letters are assigned to the following types:
                
                • 'I' – type "INT", 2 bytes
                • 'L' – type "LONG", 4 bytes
                • 'F' – type "FLOAT", number with a decimal floating point (according to IEEE), 4 bytes
                • 'S' – type "STRING", sequence of ASCII characters terminated with a zero char, 1 to 246 bytes
              • <parameter_2> – database variable index within a station (INX); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FF
              • <parameter_3> – database variable row index of the matrix type (IY); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
              • <parameter_4> – database variable column index of the matrix type (IX); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
            • command 'B' (read value block from value matrix): parameter count is 6
              
              • <parameter_1> – an alphabetical letter that specifies the required variable type. The letters are assigned to the following types:
                
                • 'I' – type "INT", 2 bytes
                • 'L' – type "LONG", 4 bytes
                • 'F' – type "FLOAT", number with a decimal floating point (according to IEEE), 4 bytes
                • 'S' – type "STRING", sequence of ASCII characters terminated with a zero char, 1 to 246 bytes
              • <parameter_2> – database variable index within a station (INX); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FF
              • <parameter_3> – database variable row index of the matrix type (IY); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
              • <parameter_4> – database variable column index of the matrix type (IX); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
              • <parameter_5> – database variable row index of the matrix type (NY); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
              • <parameter_6> – database variable column index of the matrix type (NX); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
            • command 'M' (read memory): parameter count is 6
              
              • <parameter_1> – "offset", defines an offset within a segment (OFFS); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
              • <parameter_2> – "segment", defines a memory segment (SEG); hexadecimal number (16-bit ASCII HEX) ranging from 0 to FFFF
              • <parameter_3> – count of read bytes; hexadecimal number (16-bit ASCII HEX) ranging from 0 to F5
  • for LOTOS 301 the address consists of an empty text string (i.e. "")

• • for A/D inputs the address consists of 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
      • 3 – input 3
    • <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 – the 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  > – an 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)
  • MODBUS – no meaning (ignored)
    
  • INMAT 51/66 – no meaning (ignored)
  • LOTOS 301 – no meaning (ignored)
    
  • A/D inputs – no meaning (ignored)
• <  extra_parameter2  > – an 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)
    
  • Modbus – no meaning (ignored)
  • INMAT 51/66 – no meaning (ignored)
  • LOTOS 301 – no meaning (ignored)
    
  • A/D inputs – no meaning (ignored)
    
    
    

Response 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

— Examples of Immediate Readings —

Example – 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:

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

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

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

Example – 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 – 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 – 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 – same as above, but the protocol is given in the numerical format :

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

Example – 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 – 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 – 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 – suppose you want to read the immediate signal value for analogue input 2 via the A/D input port, convert the result into logical signal level value and write out the result:

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

Example – 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>,<number_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
  • 1 – RS232 communication port
    
  • 2 – RS232/RS485/M-Bus communication port (depending on the HW version)
• <protocol> – name/number of the communication protocol used for device communication
  • for number:
    
    • 2 – denotes the M-Bus protocol
    for text string:
    
    • "MBUS" – denotes the M-Bus protocol
• <baudrate> – communication rate in bauds; if the parameter is not included, the default value is used

  • setting options: 300, 600, 1200, 2400; 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"
• <number_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.
    
    

Response format:

^SCAMSADD:<error_code>,<number_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 responses:

No error (detection of 3 meters):

^SCAMSADD: 0,3,"1,00660421;19,08780251;1,09801004"
OK

Error (a different count of meters detected, 2 meters here):

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

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 reading module command returns the count of data records stored.

Response format:

^SCDATA: "MESS_CNT",<count>
OK

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

^SCDATA: "MESS_CNT",44
OK

AT^SCDATA="GET_SPACE"

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

Response format:

^SCDATA: "GET_SPACE",<count>
OK

Example of response (the available free memory space is 7008089 B):

^SCDATA: "GET_SPACE",7008089
OK

AT^SCDATA="GET_OLDEST",<count>

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

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

Response 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,"44A2057714005401377277140054A2050137E70000002F2F046D052707210167
60DFD11106563616B696E756D6F6B656C65544E320E138545030000002F2F2F2F2F2F2F2F2F"
OK

Response format for unknown data format:

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