2N SmartCom PRO User Manual
Hide thumbs Also See for SmartCom PRO:

Advertisement

Quick Links

 
 
2N® SmartCom PRO User
Manual
 
 
 
 
 
 
v.1.11.3
www.2n.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SmartCom PRO and is the answer not in the manual?

Questions and answers

Summary of Contents for 2N SmartCom PRO

  • Page 1     2N® SmartCom PRO User Manual             v.1.11.3 www.2n.com...
  • Page 2: Table Of Contents

    2N® SmartCom PRO User Manual Content: • 1. Product Overview • 1.1 Product Description • 1.2 Changes • 1.3 Terms and Symbols Used • 2. Description and Installation • 2.1 Description • 2.2 Before You Start • 2.3 Mounting •...
  • Page 3: Product Overview

    Any mobile telephone use prohibition based on RF energy radiation applies ® to 2N  SmartCom PRO too. ®  SmartCom PRO may disturb the function of TV sets, radio sets and PCs. ® Warning! 2N  SmartCom PRO contains components that can be swallowed by small children (SIM card, antenna, etc.).
  • Page 4: Changes

    2N® SmartCom PRO User Manual ® When 2N  SmartCom PRO comes to the end of its operational life, dispose of it in accordance with applicable regulations. ®  SmartCom PRO is equipped with an external antenna connector. The antenna has to be located indoors for safety reasons. ...
  • Page 5: Future Functions, New Features

    2N® SmartCom PRO User Manual • Vždy dodržujte tyto pokyny, abyste se vyhnuli nebezpečí úrazu.  Varování • Vždy dodržujte tyto pokyny, abyste se vyvarovali poškození zařízení.  Upozornění • Důležité upozornění. Nedodržení pokynů může vést k nesprávné funkci zařízení.  • Užitečné informace pro snazší a rychlejší používání nebo nastavení.
  • Page 6: Description And Installation

    Ethernet connector is mounted on the bottom too. Refer to the figures below for ® details. The whole 2N  SmartCom PRO system is enclosed in a solid aluminium case. Mount the case on a DIN rail for easier installation.  ®  SmartCom PRO Description (Bottom View) RS 232 connector •...
  • Page 7: Before You Start

    ® • Install the 2N  SmartCom PRO antenna with respect to the signal quality in the location. Where the signal is poor, use a higher gain antenna (not included in the delivery). • No strong electromagnetic radiance is allowed on the installation site.
  • Page 8: Mounting

    Antenna Connection  Caution • Tighten the antenna connector gently with your hand; never use a tool!  Note ® • The antenna should be located in one and the same building with 2N  SmartCom PRO for safety reasons. 8 /  224...
  • Page 9: Sim Card Installation

    Make sure that the GSM provider's SIM card is intended for the GSM network ® supported by your 2N  SmartCom PRO  version and that GPRS-based data transmission is activated. • Make sure that the SIM card does not request the PIN or that the PIN is identical ®...
  • Page 10: Power Supply

    ® your 2N  SmartCom PRO to an adapter other than that included in the delivery. Connect the supply voltage to the 4–pin connector next to the RS 232 connector. You can also connect a gel– lead–acid accumulator as a power supply backup. The supply voltage is also present on the 10–...
  • Page 11: Function And Use

     ® •  SmartCom PRO  is working if the LED indicator is shining, thus indicating a successful mobile provider connection and IP address assignment. ® To identify the 2N  SmartCom  PRO  IP address assigned by the mobile provider or perform the basic configuration upon power up, get connected via the serial port (RS 232).
  • Page 12 2N® SmartCom PRO User Manual ® mode. When your 2N  SmartCom  PRO  replies OK, start configuring using the AT commands as listed below. Restart the serial port to return to the data mode. To do so, you can either send the ATO ®...
  • Page 13 2N® SmartCom PRO User Manual  ® •  SmartCom PRO can also be configured via Terminal Config. Refer to Sub. 4.1. • If you cannot use a PC, make the basic settings using SMS messages. Refer to Sub 4.2 for details.
  • Page 14 Enter the SCCFG command via the AT interface to make basic configuration of the GSM/UMTS ® module, access to the server and listening ports of  2N  SmartCom PRO.  If you do not have access to a PC, you can control the terminal via SMS to a certain extent. Refer to Subs.
  • Page 15 2N® SmartCom PRO User Manual at^sccfg=? The command displays the interface setting options. • ^SCCFG: "MODE","TCPCLIENT"|"STANDALONE"|"DATA_OFF" • ^SCCFG: "GPRS_APN","0-32" • ^SCCFG: "GPRS_USER","0-32" • ^SCCFG: "GPRS_PASS","0-32" • ^SCCFG: "LOCAL_IP" • ^SCCFG: "SERVER_IP","7-15" • ^SCCFG: "SERVER_PORT",0-65535 • ^SCCFG: "AUTH_PASS","5-64" • ^SCCFG: "SIM_PIN","0-8"...
  • Page 16  SmartCom PRO  connects to the selected server for interface data resending. ® • STANDALONE (3) – 2N  SmartCom PRO  works as a server to which clients get connected (transparent transmission between TCP and serial interfaces). ® • DATA_OFF - the 2N  SmartCom PRO GSM/UMTS module is not logged in to the data network but waits for an SMS.
  • Page 17 If your provider requires authentication, ask for necessary access data. at^sccfg="local_ip" ® • This command makes 2N  SmartCom PRO  return the IP address assigned to it by the provider. at^sccfg="server_ip","90.182.112.54" ® • The command sets the IPv4 address of the server to which 2N  SmartCom PRO  connects...
  • Page 18 Select one of the following 2N  SmartCom PRO  server communication encryption modes: ® • Mode 0 DISABLED – 2N  SmartCom PRO  shall not encrypt any data itself. ® • Mode 1 OPTIONAL – 2N  SmartCom PRO  shall encrypt data if the counterparty requires so.
  • Page 19 2N® SmartCom PRO User Manual at^sccfg="save" • The command saves the changes. at^sccfg="restart" ® • The command restarts 2N  SmartCom  PRO . at^sccfg="srestart" ® • The command saves the changes and restarts 2N  SmartCom  PRO.  19 /  224...
  • Page 20 2N® SmartCom PRO User Manual ® Ethernet Port Setting (2N  SmartCom PRO ETH only) ® These commands are only implemented in 2N  SmartCom  PRO  ETH, which includes an Ethernet port. at^sceth="ip_method","DHCP" • The command selects the IP address setting mode: •...
  • Page 21 2N® SmartCom PRO User Manual at^sceth="restart" • The command restarts the Ethernet port. at^sceth="srestart" • The command saves the changes and restarts the Ethernet port. at^sceth? • The command displays the currently set interface values. • ^SCETH: "IP_METHOD","FIXED"  • ^SCETH: "LOCAL_MAC","7C:1E:B3:00:92:E5"...
  • Page 22 2N® SmartCom PRO User Manual at^sceth=? • The command displays the interface setting options. • ^SCETH: "IP_METHOD","FIXED"|"DHCP" • ^SCETH: "LOCAL_MAC" • ^SCETH: "LOCAL_IP" • ^SCETH: "FIXED_IP","7–15" • ^SCETH: "MASK","7–15" • ^SCETH: "GATEWAY","7–15" • ^SCETH: "DNS1","7–15" • ^SCETH: "DNS2","7–15" • ^SCETH: "SAVE"...
  • Page 23 2N® SmartCom PRO User Manual Gel-Lead-Acid Accumulator Charger ® ® This function is only available in 2N  SmartCom PRO and 2N  SmartCom PRO ETH, which includes an intelligent charger for an external gel-lead-acid accumulator. Charging is automatically controlled and terminated when full charging is achieved. The device is supplied from the accumulator without loss in the case of power outage and the accumulator is automatically recharged upon power recovery.
  • Page 24 Never connect an accumulator with a rated voltage higher than the ® ®  SmartCom PRO supply voltage. If this happened, 2N  SmartCom PRO would start using a higher voltage supply, i.e. the battery, discharge the accumulator and switch to a lower voltage supply. However, it would be unable to recharge the battery (see the condition below) and you would lose backup during power outage.
  • Page 25: Led Indicator

    LED from the right (when viewed from the front, see the figure below) indicates the GSM/UMTS module state. This LED can have two functions: the basic function is to signal terminal ® connection to the GPRS/UMTS network in the standalone mode and 2N  SmartCom Server in ®...
  • Page 26: Input And Output Circuits

    This subsection describes the input and output circuits of 2N  SmartCom including their main use, control and location.   ® •  SmartCom PRO is equipped with reliable terminals for easier and faster connection. • Refer to S. 6 for a complete AT command list.
  • Page 27: Input Circuits

    Voltage can be measured in the range between 0 and 10 V DC. Make sure that ® the 2N  SmartCom PRO jumpers are set as shown in the figure above before using this mode. Use the AT commands listed below for reading and calibration. Current Measurement Electric current can be measured in the range between 4 and 20 mA.
  • Page 28 2N® SmartCom PRO User Manual at^scadc1="adc_value" • The command performs measurement and returns the value from the A/D converter. at^scadc1="calib_min" • Automatic interface calibration according to the currently measured value. at^scadc1="calib_max" • Automatic interface calibration according to the currently measured value.
  • Page 29 2N® SmartCom PRO User Manual at^scadc1="threshold_high",250 • Manual calibration setting (maximum values). Setting options: 0 – 960.  at^scadc1="save" • The command saves the changes. Logical Level Monitoring You can monitor the logical levels of voltage and current signals. Use other commands than those intended for classic measurements and define the threshold levels.
  • Page 30 2N® SmartCom PRO User Manual at^scdin1="save" • The command saves the changes. Pulse Counting on S0 Inputs Make sure that the jumpers are set as shown in the figure below for pulse counting on S0 inputs. The S0 input has thus a power supply of its own and can be connected directly to the switch or relay contacts.
  • Page 31: Output Circuits

    2N® SmartCom PRO User Manual at^scpulse1="clear" • The command clears the input 1 counter. at^scpulse1="save" • Manual storing of the counter value into the EEPROM. Output Circuits ®  SmartCom  PRO  is equipped with two relay outputs for turning on/off electrical appliances (by an additional power switch or as signalling control inputs, depending on their power input).
  • Page 32: Relay Outputs

    2N® SmartCom PRO User Manual Relay Outputs Use the commands below to control the relay outputs. An example is given for relay 1. For relay 2, use the same commands but for screl2. at^screl1? • The commands detects the state of relay 1.
  • Page 33 The command closes relay 1 . Upon terminal restart, the relay will be in the state in which it was before restart . RS 232 and RS 485/ M-Bus Interfaces ® Find the interface connectors on the bottom side of 2N  SmartCom PRO. Refer to Subs. 2.1. A 9- pin D-sub connector is used for RS-232 and a 3-pin WAGO terminal for RS 485 or M-Bus located...
  • Page 34: Input Calibration

    2N® SmartCom PRO User Manual at^scport1="stop_bits",2 • The command sets the stop bit count to  2.  • Setting options: 1–2. at^scport1="parity",2 • The command sets the parity security type: • 0 – none • 1 – even • 2 – odd •...
  • Page 35 2N® SmartCom PRO User Manual  Note • Keep in mind that an uncalibrated input is not non-functional. It is able to measure and read values less precisely, but sufficiently for rough voltage or current detection. For calibration, use the terminals and AT commands described in Sub.
  • Page 36: User Defined Functions - Udf

    2N® SmartCom PRO User Manual –   The yellow line shows the case that 7V is applied to the input. In case you measure 7V in the calibrated 10V range, the AT command will return 70 as 70 represents 70% of the calibrated range.
  • Page 37 2N® SmartCom PRO User Manual • Make sure that each command includes the condition (syntax), separator (:) and action to be executed ("<syntax>:<action>") to avoid command setting error.  Caution • The maximum length of an AT command is 80 characters. 37 /  224...
  • Page 38 This subsection provides all the AT commands and parameters that can be used for setting of UDF conditions. The basic commands are described first and then their parts are ® explained. These are the basic commands for the 2N  SmartCom PRO UDF.  AT^SCUDF="ADD","<code>"...
  • Page 39 2N® SmartCom PRO User Manual AT^SCUDF=? • Enter the command to display the setting options. • ^SCUDF: "ADD","0–100"  • ^SCUDF: "REMOVE",1–10  • ^SCUDF: "CLEAR" Supported Syntaxes The condition parameters can be entered in variable ways. For universality, each of the parameters can be a digit, i.e.
  • Page 40 2N® SmartCom PRO User Manual  Caution • The parameters that are listed as digits, i.e. AIN and PUL, which may be 0 – 100, or 0 – 4294967295, are converted to logic values as follows: if their value is 0, their state will be 0.
  • Page 41: Action Types

    2N® SmartCom PRO User Manual AIN1<=AIN2 – the syntax will be marked true in case the value measured on AIN1 is lower than the value measured on AIN2. NFG - the syntax will be marked true (i.e. network failure) in case PING failed or the IP address was not obtained during the time set at at^scping="interval",<minutes>.
  • Page 42 2N® SmartCom PRO User Manual  Note • A typical relay switching AT command looks as follows: At^scudf="add","AIN1>50:REL1 r[1]" Enter SMS to send the defined SMS to the defined telephone number.  Note • A typical SMS sending AT command looks as follows: At^scudf="add","AIN1>50:SMS p[+420123456789] m[text 1]"...
  • Page 43 2N® SmartCom PRO User Manual  Caution • Make sure that the telephone number and message parameters are completed to set this function successfully.  Warning • Make sure that the TCP receiving server exists to avoid process slow–down due to the terminal waiting for the reply from a non–existent server and not executing...
  • Page 44 2N® SmartCom PRO User Manual  Caution • The telephone number can be used for the SMS action only. • Enter telephone numbers consisting of 1 – 15 characters into the parameter. Relay state Set the relay contact position r[1 or 0]. 1 means that the relay is closed and 0 means that the relay is open.
  • Page 45 2N® SmartCom PRO User Manual  Caution • The message can be used for the TCP and SMS actions only. You can also insert the following keys into the message parameter to show the value currently measured on the input circuits or the current logic value of the conditions in the SMS.
  • Page 46 2N® SmartCom PRO User Manual  Caution • Should you enter an invalid or incomplete key, the key will not be included in the SMS sent.  • Enter a special key $$ to display the $ character in the SMS as the single $ character introduces other keys.
  • Page 47: Error Codes

    2N® SmartCom PRO User Manual Counters There 5 virtual counters altogether in the terminal program for counting actions or storing current values for later computation. The following two parameters are used for control: Counter incrementing Enter string d[1]. The 'd' parameter defines that the counter value increases by the value included in the brackets (one step).
  • Page 48 2N® SmartCom PRO User Manual UDF_RESP_ERROR_SYNTAX_AC Action syntax error TION UDF_RESP_ERROR_SYNTAX_AC Action type not supported TION_TYPE UDF_RESP_ERROR_PHONE_NU Telephone number length error MBER_LEN UDF_RESP_ERROR_PHONE_NU Telephone number not found or MBER not supported UDF_RESP_ERROR_IP_ADDRES IP address not found or not supported UDF_RESP_ERROR_IP_PORT...
  • Page 49 2N® SmartCom PRO User Manual UDF_RESP_ERROR_ACTION_IN_ Condition action in progress PROGRESS UDF_RESP_ERROR_MESSAGE_ Message to be sent not found MISSING UDF_RESP_ERROR_PARAM_VAL Value format or range is invalid UE             SC Ping Enter the commands to set periodical pinging to the set address in defined intervals. Use SC Ping to ensure the correct function of NFG syntax in UDF or keep firewall connection if the terminal is in the STANDALONE mode.
  • Page 50: Wireless M-Bus Interface

    ® meter defined in the meter list, 2N  SmartCom PRO will store it into a circular buffer in the internal memory. The stored data can only be retrieved and deleted starting from the oldest record. When the memory is full, the oldest data will be deleted automatically to make space to new records.
  • Page 51 2N® SmartCom PRO User Manual ® •  SmartCom PRO can be equipped with two WM-Bus modules. The other WM-Bus module replaces the ZigBee module. • This optimisation is useful whenever you need the 868MHz and 169MHz modules at the same time or use the C1+T1 and S1 modes on one frequency.
  • Page 52 2N® SmartCom PRO User Manual at^scwmbus="get_oldest" • The command writes out the oldest record from the Wireless M–Bus meter reading data zone. Example of reply: ^SCDATA: "WMBUS",<timestamp>,<id>,<rssi>,<len>,"<binary data in hexadecimal format>" Meaning of the parameters: • timestamp – record receiving time (UNIX timestamp).
  • Page 53 2N® SmartCom PRO User Manual • 1 - T1 • 3 - S1 • 8 - C1 • 11 - T1+C • 17 - N1  Note • The 17 - N1 mode is displayed and can be selected only if the terminal is equipped with a WM-Bus module that supports this mode.
  • Page 54 2N® SmartCom PRO User Manual   at^scwmbus="RF_channel",1 • The parameter defines the WM-Bus transmission channel. Setting options: 1 - 10. RC1180 channel RC1701 channel 868.050 MHz 169.406250 MHz (Channel 1a) 868.150 MHz 169.418750 MHz (Channel 1b) 868.250 MHz 169.431250 MHz (Channel 2a) 868.350 MHz...
  • Page 55 2N® SmartCom PRO User Manual at^scwmbus="Install_mode",0 • The parameter selects the normal/filter off mode. Normal means that it is necessary to define the modules from which data can be received. All the other modules will be ignored. Filter off means that the module receives and stores all data captured, even those from the modules that are not defined.
  • Page 56: Zigbee Interface

    ® with 2N  SmartCom PRO, which works as  a coordinator for this network. The ZigBee communication technology, based on the IEEE 802.15.4 – ZigBee standard, is one of the wireless PANs (Personal Area Networks). PANs also include a very popular IEEE 802.15.1 – Bluetooth technology, which is mostly applied in consumer electronics.
  • Page 57 ® At present, 2N  SmartCom PRO behaves as a Master, i.e. the main network coordinator to which devices get connected. A sufficient amount of clusters have been mounted to help you comfortably control your air conditioners, ZigBee keypads, sockets, moisture and other meters, street lighting and many other systems. ...
  • Page 58 EP4: ONOFF: 0, ®  SmartCom PRO constitutes a wireless PAN to which devices log in. The meters are listed in a table. The count of the meters (n) is determined by the firmware version. There can be up to 32 devices depending on the customer's requirements. As the first step is to properly configure a wireless network, the first set of commands relates to network setup and device adding.
  • Page 59: Network Configuration

    2N® SmartCom PRO User Manual Network Configuration AT^SCZB="ADD",<16 HEX>[<dev_id>] • The command adds a device to the list. <16 HEX> means a sixteen-character IEEE address. Ask your meter manufacturer for these data. • <dev_id> - this optional parameter specifies the meter list position. If it is not used, a new device is added to the first free list position.
  • Page 60 2N® SmartCom PRO User Manual AT^SCZB="CLEAR" • The command removes all devices from the list.  AT^SCZB="PANID"[<4 HEX>] • The command sets the network identifier to the value specified in the parameter.  • <4 HEX> - gives the new network name. The setting options are 4 hexadecimal characters (0 - F).
  • Page 61 2N® SmartCom PRO User Manual AT^SCZB="CHANNEL"[<8 HEX>] The command sets the used channel to the value set by the parameter.  • <8 HEX> - gives the new network name. The setting options are 8 hexadecimal characters (0 - F). The values of the last 8 positions are entered without 0x.
  • Page 62 2N® SmartCom PRO User Manual AT^SCZB="PRECFGKEY"[<32 HEX>] • The command sets the pre-configured key for encrypted communication. • <32 HEX> - encryption string including 16 ASCII characters in hexadecimal format: 32 characters 0 - F. AT^SCZB="PRECFGKEY_ENABLE"[<0-1>] • The command enables/disables sending of the encryption key.
  • Page 63  1 - 254 on for a defined period of time • 255 - constantly on  • To add devices via Next Hop, make sure that permit join is enabled for 2N® SmartCom PRO and the point that is the closest to the device to be added. 63 /  224...
  • Page 64 2N® SmartCom PRO User Manual AT^SCZB="PERMIT_JOIN_ALL",<time> • The command permits all the devices in the list to let new devices join the network. • <time> - time is set in seconds. Setting options: 0 - 255. • 0 - off •  1 - 254 on for a defined period of time •...
  • Page 65 2N® SmartCom PRO User Manual AT^SCZB="BASIC",<dev_id>,<EP> • The command reads out all the values included in the BASIC cluster. • The following information can be included, for example: (BASIC_ZCL_VER, BASIC_APP_VER, BASIC_STACK_VER, BASIC_HW_VER, BASIC_MAN_NAME, BASIC_MODEL_ID, BASIC_PWR_SRC, BASIC_LOC_DESC, ONOFF, POWCFG_MAINS_VOLTAGE, POWCFG_BATTERY_VOLTAGE). AT^SCZB="DEVTEMP",<dev_id>,<EP> •...
  • Page 66 2N® SmartCom PRO User Manual AT^SCZB="MSTVAL",<dev_id>,<EP> • The command reads out the Multi State Value. Used mostly for error codes. AT^SCZB="ONOFF",<dev_id>,<EP> • The command returns the 1/0 value depending on the immediate setting. AT^SCZB="ONOFF_SET",<dev_id>,<EP>,<state> • The command sets the switch to the value specified in the state parameter. Setting options: 1 - on, 0 - off.
  • Page 67 2N® SmartCom PRO User Manual AT^SCZB="THERM_MODE",<dev_id>,<EP>,<value> • The command sets the thermostat mode to the defined value: 2 hexadecimal characters. Refer to the table below.  Value Description Auto Cool Heat Emergency heating Precooling Fan only 02, 08, fe Reserved AT^SCZB="THERM_TEMP_HEAT",<dev_id>,<EP>,<value> •...
  • Page 68: Autonomous Metering System (Ams)

    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.
  • Page 69 2400 bps, set a higher rate on port RS 485 in the ®  SmartCom PRO configuration. When the AMS communication stops at 300 bps, the preset higher rate is reset automatically. ® •  SmartCom PRO supports the A, C and E modes according to IEC 62056-21. 69 /  224...
  • Page 70 2N® SmartCom PRO User Manual 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"...
  • Page 71 2N® SmartCom PRO User Manual AT^SCAMS? The command writes out the contents of the device list to be served by the AMS module. Table row format: ^SCAMS: <index>> <port>,<protocol>,<address>,<interval> • <index> - device index in the device list - number •...
  • Page 72 2N® SmartCom PRO User Manual AT^SCAMS="ENABLE",<zapnuto> The AMS module command writes out the current state (on/off) of the AMS module (without additional details) or sets the on/off state for the AMS module (according to the parameter below). • <on> - if included, the parameter specifies the required new AMS on/off state and the command sets the new state;...
  • Page 73 2N® SmartCom PRO User Manual AT^SCAMS="RETRY"[<retry_count>] The AMS module command writes out the current setting of the count of the data reading retries in case reading failed (without any additional parameters) or sets the count of the device data reading retries (according to the parameter below).
  • Page 74 2N® SmartCom PRO User Manual AT^SCAMS="DEV_ADD",<port>,<protocol>,<address>,<interval>  The AMS module command adds a device to the device list . • <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) •...
  • Page 75 2N® SmartCom PRO User Manual • 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.
  • Page 76 2N® SmartCom PRO User Manual  — Examples of Use —  As configuration is not easy, let us give a few examples to help you set the required function(s) successfully. Example 1 - suppose you want to add a device to the device list, which is connected to physical port 2, communicates via IEC 62056-21, the device address is 869551 and the data reading interval is 3 minutes.
  • Page 77 2N® SmartCom PRO User Manual  Example 8 - s uppose you want to add a device to the device list, which is connected to the  A/D input port, and the interval of calibrated analogue value reading on analogue input 1 is 1 hour: AT^SCAMS="DEV_ADD",128,"AIN_DIN","1/ADC/CAL","1H"...
  • Page 78 2N® SmartCom PRO User Manual 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:  Reply format - action failed:  ERROR 78 /  224...
  • Page 79 2N® SmartCom PRO User Manual 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 •...
  • Page 80 2N® SmartCom PRO User Manual • 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 •...
  • Page 81 2N® SmartCom PRO User Manual • <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: •...
  • Page 82 2N® SmartCom PRO User Manual • 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>...
  • Page 83 2N® SmartCom PRO User Manual 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"...
  • Page 84 2N® SmartCom PRO User Manual — End of Examples of Immediate Readings —  Automatic Meter Detection The command is used for automatic detection of a device on a bus.  Caution • When you enter this command, the SCDATA (record memory) and meter list will be deleted! AT^SCAMSADD=,<port>,<protocol>,<baudrate>,<interval>,<count_of_expected_devices>...
  • Page 85 2N® SmartCom PRO User Manual • 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...
  • Page 86 2N® SmartCom PRO User Manual ^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): ...
  • Page 87 2N® SmartCom PRO User Manual 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  • If you enter AT^SCDATA="GET_OLDEST" without specifying the count of records, the last record will only be read.
  • Page 88 2N® SmartCom PRO User Manual ^SCDATA:"WMBUS",1452142010,36617,-14,70, "44A2057714005401377277140054A2050137E70000002F2F046D052707210167460DFD11106563616B69 6E756D6F6B656C65544E320E138545030000002F2F2F2F2F2F2F2F2F"OK Reply 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> The data record reading module command returns the listing of records according to the preset record filter.  •...
  • Page 89 2N® SmartCom PRO User Manual • for IEC 62056-21 - received data text string (as received from the device) • for M-Bus - data framework text string received from the device in the ASCII HEX format (data byte is represented by two consecutive ASCII characters specifying the data byte value in the hexadecimal format) •...
  • Page 90: Filter Settings

    2N® SmartCom PRO User Manual Filter Settings general format for <filter> is "<condition>;<condition>;..;<condition>", where <condition> specifies the filtering condition. The maximum count of conditions in the <filter> array is 10. The data record listing is sent only if it meets all the <filter> conditions.
  • Page 91 2N® SmartCom PRO User Manual The command writes out all the data records whose error code is non-zero . AT^SCDATA="GET_FILTERED","ERROR_CODE!=0" The command writes out all the data records whose error code is  0, whose record type is AMS and timestamp is greater than 1388668685.
  • Page 92 2N® SmartCom PRO User Manual Record Deleting AT^SCDATA="DEL_OLDEST",<count> The data record reading module command deletes the oldest data record . • <count> - specifies the count of the oldest records to be deleted. Example: remove the five oldest data records from the memory. ...
  • Page 93 2N® SmartCom PRO User Manual AMS Error Codes in Data Reading Lists General AMS Core Errors No error (no error has occurred) Error in the input of parametric reading data to protocol module Error in the output of reading data from protocol module...
  • Page 94 2N® SmartCom PRO User Manual IEC 62056-21 Support Plug-In Module Errors 65796 Invalid character in CR and LF arrays in Identification message received 66049 Invalid character in Data block in Data message received 66050 Insufficient size of AMS internal received data buffer for the amount of data in Data...
  • Page 95 2N® SmartCom PRO User Manual M-Bus Support Plug-In Module Errors 13108 "REQ_UD2" communication framework was not sent to device within defined timeout 13108 "REQ_UD2" communication framework was not sent to device within defined timeout 13108 Reply reception timeout from device to"REQ_UD2" communication framework 13108 Wrong communication framework type in reply from device to "REQ_UD2"...
  • Page 96 2N® SmartCom PRO User Manual A/D Input Support Plug-In Module Errors 8388609 Data reading interrupted and terminated by user 8388610 Wrong device address string format 8388611 Request communication framework sending timeout to A/D input module 8388612 Request communication framework sending timeout to A/D input module...
  • Page 97: Other Useful Functions

    2N® SmartCom PRO as Router ®  SmartCom PRO can be used for access to the Internet. This function is only available in the versions equipped with an Ethernet connector. Set the main route to the Internet via GSM and connect the device to the network or machine to be connected to the Internet.
  • Page 98 2N® SmartCom PRO User Manual IP Address Access Authorisation These commands help you define 5 IP addresses authorised for connection to your terminal. All incoming calls from undefined addresses will be ignored. at^sccfg="auth_ip",1 • The command enables/disables IP address access authorisation.
  • Page 99 2N® SmartCom PRO User Manual Configuration Port Control Communication via port RS-232 is used for configuration. Switch the port to the command mode to start configuring and back to the transparent mode when you have finished to make the port resend the right data.
  • Page 100 2N® SmartCom PRO User Manual at^sc232at? • The command displays the automatic AT mode switching setting state. at^sc232at=? • The command displays the automatic AT mode switching setting options. at^sc232lock=0-1 • The command sets RS 232 authorisation, which means that a password is required for connection via this port: 0 = enabled, 1 = disabled.
  • Page 101: Configuration

    1–second delay, into the terminal:   ® When 2N  SmartCom PRO  answers OK, you can start configuring the device using the AT commands listed in Sub. Restart the RS–232 port when you have finished configuring to return into the data mode. Send the following command: at^scport1="restart"...
  • Page 102 ®  SmartCom PRO  will send you the IP address as negotiated with the provider or assigned by the DHCP server in the Ethernet case. If a fixed public IP address is activated on the SIM card, the SIM will always use this IP address. If a dynamic public IP address is used, check the IP address whenever your restart the device.
  • Page 103: Configuration By Sms

    4.2 Configuration by SMS The SMS messages described in this section are used for basic settings of the terminal. You have ® to know the telephone number of the SIM card inserted in your 2N  SmartCom PRO  to ensure a reliable function.
  • Page 104 2N® SmartCom PRO User Manual • Maximum length of 160 characters (which is one SMS, concatenated SMS are not supported) 104 /  224...
  • Page 105 Information on each fragment of the long SMS is written into the User Data Header (UDH) and so no fragment may be longer than 153 chars ® in 7-bit encoding. Not supporting the UDH encoding system, 2N  SmartCom cannot process such SMS correctly and marks them as errors.
  • Page 106 2N® SmartCom PRO User Manual INFO SMS Send the following message to identify the provider, IMSI, IMEI or serial number of ® your 2N  SmartCom PRO : SC INFO PWD=<password>  Caution • Remember to enter the correct password into the SMS to avoid SMS ignoring as a SPAM.
  • Page 107 2N® SmartCom PRO User Manual • <terminal_fw_version> – terminal firmware version. • <current_terminal_status> – current terminal status (in the Client mode only). ® • CONNECTING – terminal connection to 2N  SmartCom Server in progress. ® • CONNECTED – terminal connection to 2N  SmartCom Server completed. • LISTENING - terminal is in the STANDALONE mode.
  • Page 108: Basic Settings

    2N® SmartCom PRO User Manual Basic Settings The following configuration SMS sets the basic parameters necessary for a proper function of terminal, including connection provider ® ® and 2N  SmartCom Server, 2N  SmartCom PRO  mode switching and RS 232 authorisation enable. Use the following command to know the current parameter settings: SC CNF PWD=<password>...
  • Page 109  ® • If the SMS has been created and processed correctly, 2N  SmartCom PRO  will send a confirmation SMS to the number from which the original SMS was sent. The confirmation SMS contains all the recently set parameters and is used for verification of the set values.
  • Page 110 2N® SmartCom PRO User Manual  Caution • Some GSM providers do not require user name and password for Internet connection setup. Therefore, contact your provider to make sure. Example of configuration SMS: Suppose you want to change the default password (into password 1) and set APN to 'internet.open'.
  • Page 111 2N® SmartCom PRO User Manual The following reply will come from the terminal after processing: 1:8,10 2:3,10 1:1,0 7:8,10 6:8,7 5:7,40 4:11,848 The following reply will come if there is no error in the error buffer:  NO ERROR  Note •...
  • Page 112: Relay Control

    2N® SmartCom PRO User Manual Relay Control Every terminal is equipped with two relay outputs, which can be SMS controlled. The configuration SMS must include the password and one of the four programmable parameters at least. The programmable parameters include: •...
  • Page 113 2N® SmartCom PRO User Manual IP Access You can also set IP address access authorisation using SMS. By enabling the IP Access you will restrict the access to the terminal configuration to selected IP addresses. You can select up to 5 different IP addresses.
  • Page 114 2N® SmartCom PRO User Manual AUTH=1 1:90.156.29.195 2:109.54.2.234 Now disable the IP access and delete all IP addresses from the list using the following SMS:  SC IPA PWD= AUTHpassword=0 DEL=0 The following reply will come from the terminal:  AUTH=0 NO IP ...
  • Page 115 2N® SmartCom PRO User Manual AMS Settings Use the SMS below to detect the M-Bus meters, assign them to the AMS list and read the current meter list.  SC AMS PWD=<password> The command checks the meters installed. • PWD=<password> – authentication password. Remember to set the password via AUTH_PASS as this parameter is mandatory for the configuration SMS!
  • Page 116 2N® SmartCom PRO User Manual Configuration SMS parameters: • PWD=<password> – authentication password. Remember to set the password via AUTH_PASS as this parameter is mandatory for the configuration SMS! • QTY=<n> – count of devices detected - number • This parameter gives the count of the devices that should be connected to the bus and thus detected.
  • Page 117 2N® SmartCom PRO User Manual The terminal sends the following reply: <session>:<message_id>> AMSADD started Message parameters: • <session> - communication thread id: 1 - 100 • <message_id> - message id in communication thread 1 The following reply comes from the terminal after processing: <session>:<message_id>>...
  • Page 118 2N® SmartCom PRO User Manual GSM Hard Reset Initialized Factory Reset Use SMS to initiate the terminal factory reset. After this SMS is sent, you will get a reply and the command will be executed.. The SMS is as follows: SC FRES PWD=<password>...
  • Page 119: Error Replies

    2N® SmartCom PRO User Manual Error Replies ® Having noticed an error in the configuration SMS or command processing, 2N  SmartCom PRO  will send you an error reply. If the terminal generates an error reply, it means that the command was not executed! ...
  • Page 120 Terminal Config) window. The main toolbar helps you select the Serial port for ® connection to 2N  SmartCom PRO (hereinafter referred to as terminal). This list includes all available serial ports installed in the PC on which the application is running. 120 /  224...
  • Page 121 Figure: Communication Settings Having selected a port, set the communication parameters to adjust communication rates and ® signal transmission parameters for the serial port. The 2N  SmartCom PRO  factory values are set here by default. Refer to the Communication Settings figure above.  No password is requested by default for the RS 232 port and so nothing has to be filled in.
  • Page 122 2N® SmartCom PRO User Manual  • The application connects to the selected terminal, identifies the RS 232 mode (DATA or COMMAND), switches the port as necessary, reads out the data, switches the port into the original mode and terminates communication. This gives the other users continuous access to the terminal.
  • Page 123 2N® SmartCom PRO User Manual View Menu Go to Help to know details on the Terminal Config manufacturer and version.  123 /  224...
  • Page 124 2N® SmartCom PRO User Manual Use of Application  Not all tabs are accessible to all device models. • General, RS 232, RS 485 / M-Bus, Error buffer, Own AT commands, FW upload, User defined functions and IP access are accessible to all terminals.
  • Page 125 2N® SmartCom PRO User Manual Ethernet Menu Use the RS 232 and RS 485 / M-Bus tabs to set communication parameters for each port. Set the password request enable and AT mode upon power up for RS 232. Use WM-Bus to set the operating and decryption modes for the module.
  • Page 126 2N® SmartCom PRO User Manual  Caution • The keys are added to the WM-Bus module directly for security reasons and are not displayed in the configuration. Therefore, be careful while configuring the keys. • A key adding error may lead to a decryption error.
  • Page 127 2N® SmartCom PRO User Manual Figure: Error Buffer Use the Own AT commands tab to enter commands of your own for parameter setting. The tab behaves like a terminal. Enter a string into the AT command field corresponding to the supported commands listed in Subs.
  • Page 128 2N® SmartCom PRO User Manual Figure: User Defined AT Commands The last tab helps you upgrade firmware via the terminal COM port. Select the path to the current firmware file and press Start to initiate the upgrading process, which is signalled by the progress bar below.
  • Page 129 2N® SmartCom PRO User Manual Figure: FW Upload  Caution • Make sure that the terminal FW supports FW upgrade via the COM port to make the process successful. The minimum terminal FW version must be 1.4.0. The User defined functions tab helps you set the UDF graphically and more easily in the application than using an AT command in the terminal.
  • Page 130 2N® SmartCom PRO User Manual User Defined Functions Menu Refer to S. 3.5 for more details on the UDF setting options.  The RTC settings tab displays the current date, time and time zone data. You can also synchronise the device time with your PC time, or set the device time manually. Click on Save to confirm the settings.
  • Page 131 2N® SmartCom PRO User Manual RTC Settings Menu Charger is another setting option. It displays the back-up battery charging state for the PRO terminals. You can enable/disable the function and set the maximum charging voltage and current. 131 /  224...
  • Page 132 2N® SmartCom PRO User Manual Charger Menu IP access is the last accessible tab. You can define from which IP addresses it will be possible to access the terminal. Attempts from non-listed IP addresses will be ignored. Press ON to enable the function and Add to add an IPv4 address to the list. Click on an item for selection and push Remove to delete an address from the list.
  • Page 133 2N® SmartCom PRO User Manual IP Access Menu 133 /  224...
  • Page 134: Sw Applications

     SmartCom Server version, it will ask you whether to uninstall. If you select No, the ® wizard will be terminated. If you select Yes, the current 2N  SmartCom Server version will be removed. Then you will be asked whether or not to remove the configuration files. If you select No, the current configuration will be retained and the application will only be updated. ...
  • Page 135 2N® SmartCom PRO User Manual Here you can also set the port for the AT API; refer to Sub. 5.4 for details. Now the wizard is ready ® to install the 2N  SmartCom Server. It displays the list of settings. Check the set parameters carefully as the values cannot be changed without reinstallation when the installation has been completed! If you find an error, push the Back button to return to the respective window.
  • Page 136 2 users and 2 terminals.  Caution ® • The clock counter is increased by 1 by every 2N  SmartCom Server restart. ® The 2N  SmartCom Licence Tool is installed together with the server. Having launched the application, you can see the version, ID and details on service settings for the server installed.
  • Page 137 2N® SmartCom PRO User Manual Having received the licence file, launch the Licence Tool application and enter the path to this file into the License path parameter. Push Upload to add the licence to the server directory and restart the server to update the licence data. The licence status will change into OK. Now, the last row of the Listing parameters includes all the licensed server properties: count of users,...
  • Page 138 2N® SmartCom PRO User Manual Management ® SC_config is an administrator program launched in the 2N  SmartCom Server control row. This application can help you configure all the server parameters: start/stop the server or export/ import the server database.   Caution • Use this program to export and import databases safely.
  • Page 139 2N® SmartCom PRO User Manual sc_config.exe Database Export and Import You can export the database under normal operation. When the program is launched, a copy of the current database is generated for export purposes so that the database cannot be changed during export.
  • Page 140 Users\Application Data\2N TELEKOMUNIKACE\2N SmartCOM\SC Server\db– 20120221095921–export.xml. • A typical storage for WINDOWS Vista and 7 is C:\ProgramData\2N TELEKOMUNIKACE\2N SmartCOM\SC Server\db–20120221095921–export.xml. You may import the database with the server switched off only. If the server is running, the database cannot be imported and the program signals an error. Stop the server using the following command: C:\Program Files\2N TELEKOMUNIKACE\2N SmartCOM\SC Server\sc_config.exe –...
  • Page 141: Setting Options

    2N® SmartCom PRO User Manual  Caution • The path to the file with the exported database must always be given in brackets as if no path is found, the current database will be deleted and replaced with a new blank one.
  • Page 142 2N® SmartCom PRO User Manual -gListenPort ® • Enter this command to print out the listen port (port for the 2N  SmartCom protocol). -gHttpPort • Enter this command to print out the HTTP port. -gAtPort • Enter this command to print out the AT API port.
  • Page 143 2N® SmartCom PRO User Manual Parameter set commands -sListenPort <listen_port> ® • Enter this command to set the listen port (port for the 2N  SmartCom protocol). -sHttpPort <http_port> • Enter this command to set the HTTP port. -sAtPort <at_port> • Enter this command to set the port for AT API.
  • Page 144 Enter this command to set the interval between the KeepAlive packets. This number should be higher than the KEEP_ALIVE_TIMEOUT. -sResetAdmin • Enter this command to reset the Admin user password to '2n'. -sTerminalPV1url ® • Sets URL for update of terminals with the 2N  ...
  • Page 145: Control Panel

    2N® SmartCom PRO User Manual Server commands -cStartServer ® • Enter the command to start the 2N  SmartCom Server service. -cStopServer ® • Enter the command to stop the 2N  SmartCom Server service. -cRestartServer ® • Enter the command to restart the 2N  SmartCom Server service. -cExportDatabase ® •...
  • Page 146 \Program Files\2N TELEKOMUNIKACE\2N SmartCOM\ is used. Also, select whether the application shall be installed for the currently signed-in user or all PC users.  ® Now the wizard is ready to install the 2N  SmartCom Control Panel. It automatically adds an item to the Start menu and the application icon to the desktop.
  • Page 147 2N® SmartCom PRO User Manual Figure: Sign-In Window The encryption settings are in the right-hand bottom corner. Click on Change encryption key to display the encryption setting window. If the server requires so, enable packet encryption and set the key. Enter the key either in the ASCII format, where HEX is completed automatically with the translated characters, or enter the HEXA key.
  • Page 148: Introduction To Application

    2N® SmartCom PRO User Manual Encryption Settings Introduction to Application You will be shown the application layout and main controls in this subsection. The application can be viewed in two ways: the User mode and the Admin mode. The User may see the menus necessary for its work with terminals only.
  • Page 149 2N® SmartCom PRO User Manual Figure: Application Window Basic Controls Push the Home button to return to the main menu. 149 /  224...
  • Page 150 2N® SmartCom PRO User Manual Basic Controls Click on Refresh to update the status of objects in the selected menu,  e.g. the terminal status in the Terminals or Connections menu. Push these buttons to Start/Stop communication with the terminal. Push the Add user button to add a user.. Push the Add group button to add a user group.
  • Page 151 2N® SmartCom PRO User Manual Basic Controls Push the Create button to create new objects. Click on the Cancel button to clear the currently made changes. Click on Save to save the currently made changes and send them to ® the 2N  SmartCom Server configuration. Use this button to install the virtual serial port driver.
  • Page 152: Control Panel Use

    2N® SmartCom PRO User Manual Basic Controls Use Search to search the relevant table columns. Use Switch on/Switch off to control the relay contacts. Use the button to display details on the terminal. Click on Update to upgrade firmware of selected terminals. Click on Default to reset the factory default values for all parameters.
  • Page 153 2N® SmartCom PRO User Manual User Mode Having singed in as the User, you get access to four items of the main menu only: Terminals, Connections, Virtual Ports and Settings. They are all you need for standard work with the terminals. You have been assigned to one of the groups by the Administrator and so you are allowed to view the terminals assigned to this group only.
  • Page 154 2N® SmartCom PRO User Manual   The Terminals menu displays the terminals assigned to the group you have the right to view.  A green dot before the terminal means that the terminal is on-line (connected to the server) and you can get connected to it. A red dot means that the terminal is off-line. ...
  • Page 155 Figure: Terminals Menu Terminal Details The Terminal Details include the following data: GSM module IMEI (International Mobile ® Equipment Identity), name and number of the GSM provider at which your 2N  SmartCom PRO is registered, signal intensity in dBm, ICCID (Integrated Circuit Card ID) and IMSI (International Mobile Subscriber Identity).
  • Page 156 2N® SmartCom PRO User Manual Terminal Time Synchronisation The time setting supporting PRO and PRO ETH terminals also display the terminal time. Click on Synchronize to set the same time value for the terminal as there is in the server. 156 /  224...
  • Page 157 2N® SmartCom PRO User Manual Connections Figure: Connections Menu   The Connections menu contains a table showing the terminals that are assigned a virtual port. The table includes the terminal name, serial number, IP address and physical port to be connected to the selected virtual port. The Status field defines the current of the terminal: •...
  • Page 158 2N® SmartCom PRO User Manual • Disconnecting - disconnection from the virtual port is in progress. • Terminal Disconnected - the terminal is off-line, i.e. has been disconnected from the SC server. • Disconnect by other user - the terminal has been disconnected by another user. This means that the other user has interconnected its virtual port with this terminal.
  • Page 159: Virtual Ports

    2N® SmartCom PRO User Manual Virtual Ports Figure: Virtual Ports Menu   Administer virtual ports using the Virtual Ports menu. Every user can use this menu as these settings only relate to the PC with which the user is working. This means that where more PCs are used, the user must create the virtual ports for each of them.
  • Page 160 2N® SmartCom PRO User Manual Figure: Create TCP Port Create COM Port A virtual COM port is created similarly as instructed above. Just select a port and click on Create to make the com0com driver install the selected port into the PC.
  • Page 161 2N® SmartCom PRO User Manual Figure: Create COM Port Having installed a COM port into the PC, activate the COM port. Although the port has been added to the Virtual ports table, the Ready item shows NO. Therefore, click on this table row to view the port details and the Refresh button.
  • Page 162 2N® SmartCom PRO User Manual Settings Figure: Settings Men   You can change the user password in the Settings menu. Enter the old password and then the new one. The minimum password length and correctness is checked by the parameters. Save the setting using the Change password button.
  • Page 163 2N® SmartCom PRO User Manual • The installation requires 0.5 MB of free disk space at least. The menu also includes encryption key settings for server communication, like in the sign-in window. Tick the checkbox to enable packet encryption. Enter the selected key into the Key field and save the setting.
  • Page 164 2N® SmartCom PRO User Manual Autologin  Caution • By interrupting automatic login you also disable the Allow automatic login parameter. Thus, you will have to re-enable it to use autologin again. The application Logging checkbox helps you debug the application or just record server communication.
  • Page 165: Admin Mode

    The Users menu is used for user administration. The list of users is on left. A green dot before the ® user name means that the user is on-line (connected to the 2N  SmartCom  Server). A red dot means that the user is off-line (logged out). ...
  • Page 166 2N® SmartCom PRO User Manual The Groups menu contains the user groups to which the user is assigned. Click on Add and select an item from the list to create a new group. Push Remove to remove a group from the list. Add user Click on the Add user button next to the filter setting. You will be asked to complete the login, full user name and password to ensure a proper function.
  • Page 167 2N® SmartCom PRO User Manual The Groups menu helps you group users and terminals. As it is unnecessary for all users to view and manage all terminals, you can create small user groups for terminal data reading and administering. Click on a group to display the Group Details including the full group name, notes if any and rights assigned to the group.
  • Page 168 2N® SmartCom PRO User Manual Links Obrázek: Links Menu   The Links menu displays the currently connected terminals and users. The Administrator can supervise and disconnect them if necessary. The table includes the serial number, IP address and port of the selected terminal, the user currently working with the terminal, the user IP address and active port.
  • Page 169 2N® SmartCom PRO User Manual  • The Stop button is used for unconditional disconnection of a terminal from the virtual ports regardless of the data transmission state. Terminals Figure: Admin Mode Terminals   The Terminals menu in the Admin mode is similar to that in the User mode but is extended by group assignment, terminal adding and terminal editing options. ...
  • Page 170 2N® SmartCom PRO User Manual Specify in the Terminal Groups in which group the selected terminal shall be visible (i.e. which group shall be allowed to use this terminal). Click on Add to add a group. Click on Remove to remove a group from the list. ...
  • Page 171 2N® SmartCom PRO User Manual Server Settings  Figure: Server Settings Menu   ® The Server Settings menu contains the 2N  SmartCom Server settings. The menu has two parts. The first menu part affects the server function directly and any change may lead to restart and subsequent disabling of work of other users. Set the listening port and http port and enable the http daemon here.
  • Page 172 2N® SmartCom PRO User Manual  Caution • Important! A change of these parameters will affect the server function directly. Remember the changed values for later use. For example, if you change the Listen Port, you will have to enter a new port during login. If you forget it, you will have to reinstall the whole server! •...
  • Page 173 ® is only in the PC on which the 2N  SmartCom Server is installed. You will not find ® this directory on the PC from which you launch the 2N  SmartCom Control Panel ® and log in to the 2N  SmartCom Server remotely! Default Terminal Firmware URL is the address that can be used for firmware upgrade for the...
  • Page 174: Firmware Management

    2N® SmartCom PRO User Manual Firmware Management Figure: Firmware Management Menu   ® The Firmware Management menu is used for updating the 2N  SmartCom  PRO  terminal ® firmware via the 2N  SmartCom Server. The user selects a firmware version and ticks off the terminal or group of terminals to be updated. This enables the Update button. Push the button to execute automatic update for all the selected terminals. ...
  • Page 175 2N® SmartCom PRO User Manual  Caution ® • Just one default firmware version identical with the 2N  SmartCom Control Panel FW version is available after a new server installation. Add more firmware versions to the database if necessary. ®...
  • Page 176 2N® SmartCom PRO User Manual  Caution • Remember to check off the firmware version and one terminal/terminal group at least to enable the Update button. Otherwise, Update will not be available. • Tick off the checkbox in the table header to select all table items, i.e. all available terminals and/or terminal groups.
  • Page 177: At Api

    Figure: AT API AT API Use ® Having logged in, get connected via Telnet to the 2N  SmartCom Server address on the port selected for the AT API. After connection, you will be asked to enter the user name and password. You can use any login available on the server. The login dialogue looks as follows: 2N®...
  • Page 178 Enter the command to display the device model – 2N  SmartCom AT API. ati3 • Enter the command to display the current server version: x.x.x.x.x ati4 ® • Enter the command to display the serial number of the 2N  SmartCOM Server.  178 /  224...
  • Page 179: Server Settings

    2N® SmartCom PRO User Manual at+cgmi • Enter the command to display the device manufacturer – 2N Telekomunikace a.s. at+cgmm ® • Enter the command to display the device model – 2N  SmartCom AT API. at+cgmr • Enter the command to display the current server version: x.x.x.x.x at+gmi •...
  • Page 180 2N® SmartCom PRO User Manual • ^SCCFG: "MAX USER TCP CONNECTIONS",100 • ^SCCFG: "MAX TERMINAL TCP CONNECTIONS",100 • ^SCCFG: "KEEPALIVE TIMEOUT",60 • ^SCCFG: "KEEPALIVE SENDING PERIOD",180 • ^SCCFG: "TERMINAL FW URL","http://$(SERVER_IP):93/firmware/1.4.0.4.2.bin" at^sccfg="listen_port",1560 • Enter the command to set the server listening port to 1560.
  • Page 181: Terminal Connection

    2N® SmartCom PRO User Manual at^sccfg="server_restart" ® • Enter the command to restart the 2N  SmartCom Server.  Caution • All the above parameters are saved into the server database but will not become effective until the new database is loaded into the server memory after restart.
  • Page 182: Terminal Communication

    2N® SmartCom PRO User Manual • Enter the command to terminate connection with the currently connected terminal without leaving the API environment. You can go on entering commands and establish new connections. Terminal Communication at^scstate<ser_no> • Enter the command to know the terminal state. The reply is as follows: Terminal state:<br>...
  • Page 183: Port Settings

    2N® SmartCom PRO User Manual at^scdin<ser_no>#<input>="get_value" • Enter the command to read the value from the digital input. at^scadc<ser_no>#<input>="get_value" • Enter the command to read the value from the analogue input. Port Settings at^scport<ser_no>#<port>? • Enter the command to know the current port configuration. The reply is as follows: •...
  • Page 184 2N® SmartCom PRO User Manual  Caution • You can enter all the port parameters or omit them sequentially from the last one. This means that to change the communication baud rate only, enter the following: at^scport5002961583#1=57600 • To set all the port parameters at once, send the following command: ...
  • Page 185 2N® SmartCom PRO User Manual at^scupg<ser_no>="<version>"[<timestamp>] • The FW version and timestamp are set for the terminal upgrade.  Note •  Enter time as UNIX TIME. Enter 1357055424 for 1.1.2013 15:50:24. at^scupg<ser_no>="CANCEL" • Enter the command to cancel the terminal upgrade.
  • Page 186 2N® SmartCom PRO User Manual at^scuser="edit",<user_id>,"<login>","<full_name>","<password>",<user_flags>[ "<description>"] • Enter the command to edit a user with the selected User ID. Always enter all parameters. at^scuser="remove",<user_id> • Enter the command to delete a user with the selected User ID. at^scgroup? •...
  • Page 187 2N® SmartCom PRO User Manual at^scgroup="add_terminal",<group_id>,<terminal_id> •  Enter the command to assign a terminal to the specified group. at^scgroup="remove_user",<group_id>,<user_id> • Enter the command to remove a user from the specified group. at^scgroup="remove_terminal",<group_id>,<terminal_id> • Enter the command to remove a terminal from the specified group.
  • Page 188 2N® SmartCom PRO User Manual at^scgroup="set_right",<group_id>,MONI,<0|1> • Enter the command to assign or remove MONITOR right to/from the specified group. at^scterminal? • Enter the command to return the list of all SC Server terminals. at^scterminal="add","<name>","<serial_number>","<password>" ,"<description>"] • Enter the command to add a terminal to the database.
  • Page 189 2N® SmartCom PRO User Manual URC (Unsolicited Result Codes) notifies state changes of the following objects: users, terminals and connections. at^scind? • Enter the command to write out to which URC the user is logged in. at^scind="<type>",<value> •  Enter the command to log in/out the user to/from URC.
  • Page 190: List Of Supported At Commands

    2N® SmartCom PRO User Manual 6. List of Supported AT Commands ® This section provides a list of all AT commands that can be used for the 2N  SmartCom PRO configuration including their formats and brief function description. Refer to the interface subsections mentioned in the headers for details.
  • Page 191 2N® SmartCom PRO User Manual GSM Commands Subs 3.1 at^sccfg? Displays the currently set values. at^sccfg=? Displays the interface setting options. at^sccfg="listenportcmd",10000 Specifies the listening port for IP access to the configuration port. at^sccfg="listen_port1",10001 Specifies the listening port for IP access to port1.
  • Page 192 2N® SmartCom PRO User Manual Port 2 (RS 485/M-Bus/RS 232) Subs. 3.3 at^scport2="baudrate",9600 Sets the baud rate to 9600 bps. at^scport2="data_bits",8 Sets the data bit count to 8. at^scport2="stop_bits",2 Sets the stop bit count to 2.  at^scport2="parity",2 Sets the parity security type. ...
  • Page 193 2N® SmartCom PRO User Manual Relay Outputs Subs. 3.1 at^screl1=1,1 Switches relay 1 to the closed state. The relay will be closed upon terminal restart. at^screl1=1,2 Switches relay 1 to the closed state. Upon terminal restart, the relay will be in the state in which it was before restart.
  • Page 194 2N® SmartCom PRO User Manual ADC - Input Circuits Subs. 3.1 at^scadc1="calib_min" Interface calibration according to the currently measured value. at^scadc1="calib_max" Interface calibration according to the currently measured value. at^scadc1="threshold_low",200 Manual calibration setting (minimum values). at^scadc1="threshold_high",250 Manual calibration setting (maximum values).
  • Page 195 2N® SmartCom PRO User Manual ADC - Input Circuits Subs. 3.1 at^scdin1="adc_value" Performs measurement and returns the A/D converter value. at^scdin1="calib_min" Interface calibration according to the currently measured value. at^scdin1="calib_max" Interface calibration according to the currently measured value. at^scdin1="threshold_low",200 Manual calibration setting (minimum values).
  • Page 196 2N® SmartCom PRO User Manual S0 - Pulse Input Subs. 3.1 at^scpulse1="state" Detects the current state. at^scpulse1="get_value" Reads out the counter state. at^scpulse1="set_value",100 Sets the immediate pulse count. at^scpulse1="stimer",60 Sets the EEPROM storing interval for counter values. at^scpulse1="start" Starts counting on input 1.
  • Page 197 2N® SmartCom PRO User Manual ETH Settings Subs. 3.1 at^sceth="ip_method","DHCP" Sets the IP address setting mode. at^sceth="local_mac" Writes out the currently used MAC address. at^sceth="local_ip" Writes out the currently used IPv4 address. at^sceth="fixed_ip","192.168.1.1" Manual IP address setting. at^sceth="mask","255.255.255.0" Manual network mask setting.
  • Page 198 2N® SmartCom PRO User Manual IP Address Access Authorisation Subs. 3.9 at^scipauth="add","54.182.153.21" Adds an IP address to the list.  at^scipauth="remove",2 Removes an IP address from the list. at^scipauth="clear" Clears all addresses from the list. at^scipauth? Displays the currently set values.
  • Page 199 2N® SmartCom PRO User Manual Charger Subs. 3.1 at^scchg="max_voltage",6800 Sets the maximum accumulator voltage. at^scchg="max_current",350 Sets the maximum charging current. at^scchg="state" Detects the current charging state. at^scchg="start" Starts charging. at^scchg="stop" Stops charging. at^scchg="save" Saves the changes. at^scchg="srestart" Saves the changes and resets the charging parameters immediately.
  • Page 200 2N® SmartCom PRO User Manual WM-Bus Subs. 3.6 at^scwmbus="del_oldest" Deletes the oldest record. at^scwmbus="del_oldest"<,n> Provides bulk deleting of n messages. at^scwmbus="del_all" Deletes all records in the data zone. at^scwmbus="mode",11 Sets the device working mode. at^scwmbus="get_space" Displays free memory space for WM-Bus message storing.
  • Page 201 2N® SmartCom PRO User Manual Subs. 3.8 AT^SCAMS? Writes out the contents of the AMS-served device list. AT^SCAMS="ENABLE",1 Writes out the current on/off state of the AMS module. AT^SCAMS="RETRY",5 Sets the count of device data reading retries. AT^SCAMS="RETRY" Detects the currently set count of data reading retries.
  • Page 202 2N® SmartCom PRO User Manual Subs. 3.8 AT^SCDATA="GET_FILTERED","RECORD_T Writes out all the data records stored in the data YPE==WMBUS" record memory. AT^SCDATA="DEL_OLDEST" Deletes the oldest record. AT^SCDATA="DEL_OLDEST",5 Deletes 5 oldest records. AT^SCDATA="DEL_ALL" Deletes all records in the data zone. ZigBee Subs.
  • Page 203 2N® SmartCom PRO User Manual ZigBee Subs. 3.7 AT^SCZB="RESTART" Restarts the interface and creates a new PAN. AT^SCZB="POLL",6 Reads out and updates the device list data for a defined device. AT^SCZB="POLL_TIME",500 Reads out and updates the device list data for all devices automatically.
  • Page 204 2N® SmartCom PRO User Manual ZigBee Subs. 3.7 AT^SCZB="ONOFF_SET",<dev_id>,<EP>, Sets the switch to the value specified in the parameter. AT^SCZB="TEMP",<dev_id>,<EP> Returns a temperature value in °C with the accuracy of 2 decimal places. AT^SCZB="THERM",<dev_id>,<EP> Reads out and displays the currently set thermostat mode.
  • Page 205 2N® SmartCom PRO User Manual ZigBee Subs. 3.7 AT^SCZB="IDENTIFY_START",<dev_id>,< For internal use only. Non-configurable! EP> AT^SCZB="2NCST",<dev_id>,<EP> For internal use only. Non-configurable! AT^SCZB="2NCST_WRITE",<dev_id>,<EP For internal use only. Non-configurable! > SC Ping Subs. 3.5 AT^SCPING="host","8.8.8.8" Sets the IP address of the Host to which the ICMP request is to be sent.
  • Page 206 2N® SmartCom PRO User Manual User Defined Functions Subs. 3.5 AT^SCUDF=? Displays the setting options. AT^SCUDF="add","AIN1>50:SAVE" Saves the condition. AT^SCUDF="add","AIN1>50:REL1 r[1]" Switches the relay state. AT^SCUDF="add","AIN1>50:SMS Sends an SMS.  p[+420123456789] m[text 1]" 206 /  224...
  • Page 207 2N® SmartCom PRO User Manual User Defined Functions Subs. 3.5 AT^SCUDF="add","AIN1>50:TCP Sends a TCP message. i[62.134.22.87:8026] m[text 1]" AT^SCUDF="add","AIN1>50:CNT1 d[1]" Increments the counter. General Commands Does not perform any action and OK is always sent to it. Disables echo (the sent commands are no more displayed and replies are displayed only).
  • Page 208 2N® SmartCom PRO User Manual General Commands ATS0=5 Sets the count of rings before automatic answer. at^sc23 Sets the AT mode upon power up. 2at=1 at^sc23 Displays the setting options or automatic AT mode enable. 2at=? at^sccfg Displays the currently set values for all the interfaces.
  • Page 209: Maintenance

     SmartCom PRO is connected to the Internet during the whole process of firmware upgrading to avoid firmware installation failure. 7.2 Factory Default Reset ®  SmartCom PRO can be factory reset. To do so, loosen the screws and remove the upper part of the case. Figure: Factory Reset Jumper ®...
  • Page 210: Repairs

    Technical Support staff via e-mail: techsupport@2n.cz or tel.: (+420)900300300. ®  SmartCom PRO repairs may be made by an authorised servicing centre or the manufacturer only. You can also use the error log for troubleshooting. It is a part of the memory where errors are recorded if detected.
  • Page 211 2N® SmartCom PRO User Manual ^SCERR: {id}> {ID},{Additional value} • id - sequence of numbers defining the error sequence after power up • ID - error identification • Additional value - more details and situation description • count of attempts left •...
  • Page 212 2N® SmartCom PRO User Manual Name Additional value Description ERR_TYPE_CMS_COMMAND CMS error CMS error in command channel ERR_TYPE_CME_DATA CME error CME error in data channel ERR_TYPE_CMS_DATA CMS error CMS error in data channel ERR_TYPE_CME_UPGRADE CME error CME error in command...
  • Page 213 2N® SmartCom PRO User Manual Name Additional value Description ERR_TYPE_GSM_COMMAND Command channel General error in command state channel ERR_TYPE_GSM_COMMAND Command channel General error in command _UPGRADE state channel while upgrading ERR_TYPE_GSM_DATA Data channel state    General error in data channel    ...
  • Page 214 2N® SmartCom PRO User Manual Name COMMAND_SUB_STATE_SIM_PIN_ATTEMPT_STATUS COMMAND_SUB_STATE_INSERT_SIM_PIN COMMAND_SUB_STATE_GET_IMSI COMMAND_SUB_STATE_GET_ICCID COMMAND_SUB_STATE_DELETE_ALL_STORED_MESSAGES COMMAND_SUB_STATE_SIGNAL_QUALITY COMMAND_SUB_STATE_FIELD_STRENGTH COMMAND_SUB_STATE_ASK_NETWORK_REGISTRATION COMMAND_SUB_STATE_NETWORK_REGISTRATION_INDICATION COMMAND_SUB_STATE_CHARACTER_SET COMMAND_SUB_STATE_LIST_ALL_UNREAD_MESSAGES COMMAND_SUB_STATE_SHOW_TEXT_MODE_PARAMS COMMAND_SUB_STATE_NEW_MESSAGE_INDICATION COMMAND_SUB_STATE_CLOSE_CONNECTION COMMAND_SUB_STATE_OTHER COMMAND_SUB_STATE_START_UP_LED_SEQUENCE COMMAND_SUB_STATE_IDLE_AT COMMAND_SUB_STATE_INIT_COMPLETE COMMAND_SUB_STATE_SEND_RESPONSE_MESSAGE_CMD COMMAND_SUB_STATE_SEND_RESPONSE_MESSAGE_TEXT COMMAND_SUB_STATE_START_IP_STACK COMMAND_SUB_STATE_NET_OPT_AUTO_SWITCH_ON 214 /  224...
  • Page 215 2N® SmartCom PRO User Manual Name COMMAND_SUB_STATE_OPEN_GPRS_BEARER COMMAND_SUB_STATE_SET_APN COMMAND_SUB_STATE_SET_USER_NAME COMMAND_SUB_STATE_SET_PASSWORD COMMAND_SUB_STATE_START_GPRS_BEARER COMMAND_SUB_STATE_GET_LOCAL_ADDRESS COMMAND_SUB_STATE_GET_PEER_ADDRESS COMMAND_SUB_STATE_CREATE_TCP_SERVER COMMAND_SUB_STATE_CLOSE_CLIENT COMMAND_SUB_STATE_WISMO_DIRECT_ACCESS COMMAND_SUB_STATE_RESTART_CLOSE_ALL_CONNECTIONS COMMAND_SUB_STATE_READ_OPERATOR_ID_START COMMAND_SUB_STATE_READ_OPERATOR_ID COMMAND_SUB_STATE_READ_OPERATOR_NAME_START COMMAND_SUB_STATE_GSM_BANDS_GET COMMAND_SUB_STATE_GSM_BANDS_SET COMMAND_SUB_STATE_RTC COMMAND_SUB_STATE_RTC_SAVE Data Channel States Name DATA_SUB_STATE_OTHER DATA_SUB_STATE_START_DATA_EXCHANGE 215 /  224...
  • Page 216 2N® SmartCom PRO User Manual Name DATA_SUB_STATE_WAIT_FOR_CONNECT DATA_SUB_STATE_ECHO_OFF DATA_SUB_STATE_SET_URC_TYPES DATA_SUB_STATE_CLOSE_START DATA_SUB_STATE_PRE_PPP_WAIT DATA_SUB_STATE_SEND_PPP DATA_SUB_STATE_CLOSE_AT DATA_SUB_STATE_DATA_CHANNEL_CLOSED DATA_SUB_STATE_CREATE_TCP_CLIENT DATA_SUB_STATE_WAIT_FOR_CONNECTION_TO_PEER DATA_SUB_STATE_TEST_AT DATA_SUB_STATE_TEST_SIGNAL_QUALITY DATA_SUB_STATE_TEST_READ_OPERATOR_NAME DATA_SUB_STATE_TEST_SIM_CHECK DATA_SUB_STATE_TEST_ASK_NETWORK_REGISTRATION DATA_SUB_STATE_TEST_GET_LOCAL_ADDRESS UPG Error Codes Reply codes for the firmware upgrade process. Name UPG_RESP_OK UPG_RESP_FINISHED UPG_RESP_HTTP_ERROR 216 /  224...
  • Page 217 2N® SmartCom PRO User Manual Name UPG_RESP_TARGET_ERROR UPG_RESP_PORT_ERROR UPG_RESP_PATH_ERROR UPG_RESP_TARGET_HEADER_ERROR UPG_RESP_HW_VERSION_ERROR UPG_RESP_TIMEOUT_ERROR UPG_RESP_FW_MARK_ERROR UPG_RESP_CRC_CHECK_ERROR UPG_RESP_FW_LENGTH_ERROR UPG_RESP_FW_VERSION_ERROR 217 /  224...
  • Page 218: Technical Parameters

    GSM / UMTS *The used frequency depends on the module used and ground for which it is ® intended. 2N  SmartCom PRO uses several types of GSM/UMTS modules as ordered. • 2G mobile network frequency: GSM 850 MHz, EGSM 900 MHz, DCS1800 MHz, PCS 1900 MHz •...
  • Page 219 2N® SmartCom PRO User Manual Relays (Two) • Maximum voltage: 250 V AC, 30 V DC • Maximum current: 2 A • Maximum power: 30 W / 62.5 VA Input Interfaces (Two) • Voltage range: 0–10 V DC • Current range: 0–20 mA DC •...
  • Page 220 2N® SmartCom PRO User Manual ZigBee (Optional) • Frequency: 2.400 ~ 2.4835 GHz • Channel count: 16 • Data rate: 250 kbps • Maximum output power  (RC2400): 4 dBm • Maximum output power  (RC2400HP): 20 dBm* • Flash memory: 256 kB • Antenna connector type: SMA ...
  • Page 221: Supplementary Information

    FW (Firmware) Software responsible for system function. • SW (Software) 9.2 Directives, Laws and Regulations ® SmartCom PRO je ve shodě s následujícími směrnicemi a předpisy: • 2014/35/EU pro elektrická zařízení pro užití v určitých mezích napětí • 2014/30/EU pro elektromagnetickou kompatibilitu •...
  • Page 222 2N® SmartCom PRO User Manual Výrobce nenese žádnou odpovědnost za případné škody vzniklé používáním výrobku jiným způsobem, než je uvedeno v tomto návodu, tedy zejména jeho nesprávným použitím, nerespektováním doporučení a upozornění. Jakékoliv jiné použití nebo zapojení výrobku, kromě postupů a zapojení uvedených v návodu, je považováno za nesprávné...
  • Page 223 2N® SmartCom PRO User Manual Po době jejich použitelnosti elektrozařízení pocházející z domácností a upotřebené akumulátory vyjmuté ze zařízení odevzdejte na speciálních sběrných místech nebo předejte zpět prodejci nebo výrobci, který zajistí jejich ekologické zpracování. Zpětný odběr je prováděn bezplatně a není vázán na nákup dalšího zboží. Odevzdávaná zařízení musejí být úplná.
  • Page 224 Uživatelský manuál 2N® SmartCom 224 /  224...

Table of Contents