background image

102

2N  TELEKOMUNIKACE a.s., www.2n.cz

®

8.1 AT API Description

The  AT  API  is  launched  on  the 

  Server  and  requires  a  licence.  You

2N   SmartCOM

®

have to enable its use in the 

 Control Panel. Refer to the figure below

2N  SmartCOM

®

for the basic function.

Figure: 

AT API

AT API Use

Having logged in, get connected via Telnet to the 

 Server address on

2N  SmartCOM

®

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:

 AT API

2N  SmartCOM

®

Login:
Admin
Password:
2n
OK

Now  you  are  in  the  AT  API  environment  in  the  standby  mode  and  can  enter  the
supported commands. Enter the 

 command or close the terminal application to log

ATZ

out.

Summary of Contents for SmartCom

Page 1: ...www 2n cz Firmware Version 2N SmartCom Wireless Device Management over IP User Manual 1 8 0 1 8 x ...

Page 2: ...rademarks and or trademarks or brands protected by law 2N TELEKOMUNIKACE administers the FAQ database to help you quickly find information and to answer your questions about 2N products and services On www faq 2n cz you can find information regarding products adjustment and instructions for optimum use and procedures What to do if Declaration of Conformity 2N TELEKOMUNIKACE hereby declares that th...

Page 3: ...ounting 17 3 Function and Use 20 3 1 Putting in Operation 21 3 2 GSM LED Indicator 22 3 3 Input and Output Circuits 23 3 4 Input Calibration 27 4 Configuration by Terminal 29 4 1 Configuration 30 4 2 List of Supported AT Commands 32 5 Configuration by SMS 53 6 Terminal Config 61 7 Control Panel 73 7 1 SC Server 74 7 2 Control Panel 77 7 3 Control Panel Use 82 8 AT API 101 8 1 AT API Description 10...

Page 4: ... Upgrade Update 127 11 2 Factory Default Reset 128 11 3 Repairs 129 12 Technical Parameters 130 12 1 Technical Parameters for Basic Version 131 12 2 Technical Parameters for PRO Version 133 13 Supplementary Information 136 13 1 List of Abbreviations 137 13 1 Regulations Laws and Directives 138 13 3 General Instructions and Cautions 139 ...

Page 5: ...we introduce the product outline its application 2N SmartCOM options and highlight the advantages following from its use The section also includes safety precautions Here is what you can find in this section 1 1 Product Description 1 2 Upgrade 1 3 Terms and Symbols Used ...

Page 6: ...or a long time Use 2N SmartCOM 2N in accordance herewith for the purposes it was designed and SmartCOM manufactured for is designed for Internet connection via the GPRS network and data 2N SmartCOM retransmission from peripherals connected to RS 232 485 M Bus via the IP protocol and GPRS network to a data requesting server or device Two relay outputs can be controlled and switched and parameters c...

Page 7: ...ased on RF energy radiation applies to too 2N SmartCOM may disturb the function of TV sets radio sets and PCs 2N SmartCOM Warning contains components that can be swallowed by 2N SmartCOM small children SIM card antenna etc Never exceed the voltage value specified on the adapter Check the available voltage range before connecting to a different power 2N SmartCOM supply When comes to the end of its ...

Page 8: ...near heat sources such as space heaters hot air heaters etc 2N SmartCOM only works reliably under the conditions specified in this User Manual Any unauthorised interventions and or changes in use and operation may result in malfunction or destruction of the product ...

Page 9: ...rresponds to FW version 2N SmartCOM 1 4 x 1 5 0 The User Manual corresponds to FW version 2N SmartCOM 1 5 x 1 6 0 The User Manual corresponds to FW version 2N SmartCOM 1 6 x 1 7 0 The User Manual corresponds to FW version 2N SmartCOM 1 7 x 1 8 0 The User Manual corresponds to FW version 2N SmartCOM 1 8 x Caution The manufacturer is committed to upgrading the firmware according to the clients requi...

Page 10: ...his information to prevent damage to the device Always Caution Important information for system functionality Tip Useful information for quick and efficient functionality Note Routines or advice for efficient use of the device AT Command AT command stored in the hyper terminal Future Functions and Features The in this document designates the functions and features that are grey marked text under p...

Page 11: ...2 Description and Installation In this section we describe the product and its installation 2N SmartCOM Here is what you can find in this section 2 1 Basic Version Description 2 2 PRO Version Description 2 3 Before You Start 2 4 Mounting ...

Page 12: ...continuous Internet connection via GPRS and two relays for output contact control Connectors for optional devices are located in the upper part of the u 2N SmartCOM nit Refer to the figures below for description The whole system is 2N SmartCOM enclosed in a solid aluminium case Figure 2N SmartCOM Description Top View Relay output terminals Input circuit terminals GSM LED indicator SIM holder GSM a...

Page 13: ...13 2N TELEKOMUNIKACE a s www 2n cz 1 2 3 Figure 2N SmartCOM Connectors Bottom View RS 232 bus connector RS 485 bus connector Power supply connector ...

Page 14: ...ee both optional and Ethernet interface optional Refer to the figures below for description The whole system is enclosed in a solid aluminium case 2N SmartCOM Figure 2N SmartCOM Description Bottom View RS 232 connector Power supply and battery connector U U contacts for input supply voltage in in Batt Batt contacts for gel lead acid accumulator RS 485 M Bus RS232 connector depends on the device ve...

Page 15: ...l block RE1 RE2 relay contacts IN1 IN2 input circuits type is determined by jumper settings GND ground to be used with input circuits IN1 and IN2 U U auxiliary contacts with supply voltage to be used e g for connecting in in supply voltage to relays directly connected to U U contacts on 4 pin in in power supply connector Signalling LEDs ZigBee WMbus GSM LED SIM holder SMA connector for GSM antenna...

Page 16: ...rs for the allowed range of working S 6 temperatures 2N SmartCOM may not be operated on sites exposed to direct sunshine or in the vicinity of heat sources 2N SmartCOM is designed for indoor use Never expose it to rain running water condensation moisture mist etc 2N SmartCOM may not be exposed to aggressive gases acid vapours solvents and similar chemicals Caution Make sure that you are equipped w...

Page 17: ...into the SMA antenna connector Figure Antenna Connection Caution Tighten the antenna connector never use a gently with your hand tool Note The antenna should be located in one and the same building with 2N for safety reasons SmartCOM SIM Card Installation Find the SIM card holder near the top 2N SmartCOM ...

Page 18: ...SmartCOM is DC supplied from a 12V 0 5A power adapter Make sure that the voltage value and polarity comply with the data specified at the powe 2N SmartCOM r connector before connecting your to an adapter other than that 2N SmartCOM included in the delivery is DC supplied in the range of 5 50V Make sure that the 2N SmartCOM PRO voltage value and polarity comply with the data specified at the powe 2...

Page 19: ...UNIKACE a s www 2n cz Warning Never connect the power supply until you have connected the antenna to avoid the GSM module damage Never connect any incompliant power supply to avoid electric accident or system damage ...

Page 20: ...ction and Use In this section we provide the basic and extended functions of the pro 2N SmartCOM duct Here is what you can find in this section 3 1 Putting in Operation 3 2 GSM LED Indicator 3 3 Input and Output Circuits 3 4 Input Calibration ...

Page 21: ...hining thus indicating a successful mobile provider connection and IP address assignment To identify the IP address assigned by the mobile provider or perform 2N SmartCOM the basic configuration upon power up get connected via the serial port RS 232 The port is in the data mode upon power up retransmitting all data from the input to the GPRS network Use the sequence preceded and followed by a 1 se...

Page 22: ...l with LED Indicator NO LIGHT POWER OFF indicates that the 12V power supply of the GPRS module is disconnected or works erroneously or the fuse is defective THREE QUICK FLASHES START or RESTART indicates the system start or restart This status must occur whenever the power supply is connected SLOW FLASHING INITIALISATION indicates the process of module login to the provider and IP network VERY QUI...

Page 23: ...Current measurement Electric current can be measured in the range between 4 and 20 mA Make sure that the jumpers are set as shown in Figure 3 3 before using this mode 2N SmartCOM Use the AT commands listed in ADC for reading and calibration Subs 4 2 Logical level monitoring You can monitor the logical levels of voltage and current signals Use other commands that those intended for classic measurem...

Page 24: ...power switch depending on their power input or signalling control and so on Remember to keep the parameters specified in the Technical parameters at the end of this manual You can control the relay outputs with the AT commands from the CMD mode of the RS 232 interface via a remote GPRS connection to the SIM card IP address or using an SMS message Refer to for AT command details and for SMS Subs 4 ...

Page 25: ...IP Access To access via the IP protocol use a Telnet supporting terminal and 2N SmartCOM get connected to the public IP address must be in 2N SmartCOM 2N SmartCOM mode 3 STANDALONE to provide access to three ports each of which serves one interface Tip Port 10000 helps you configure control the output relays and measure quantities on the input circuits Port 10001 works as a data pipe to port RS 23...

Page 26: ...cular 2N SmartCOM PRO buffer in the internal memory The saved data can be retrieved and deleted starting from the oldest record When the memory fills up the oldest data are deleted automatically to make space to new records You can define the minimum reading interval for each meter Any reading received from a meter before the end of this interval will not be stored The WM Bus module can work and s...

Page 27: ...lightly around this point Let us give an example suppose you place two terminals next to each other under identical external conditions One terminal will measure 966 and the other 957 for 10V Calibrate the input to eliminate such inconsistency 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 o...

Page 28: ...and 0 100 is now mapped to the input range of 3 8V The blue line is an example of measuring in the calibrated range of 0 to 10V Apply precisely one half of the calibrated voltage i e 5V to the input The AT command will return 50 i e one half of the 0 100 range again In this case 5V is the centre of the calibrated range If however the range was shifted the value would be shifted too as shown below ...

Page 29: ...n cz 4 Configuration by Terminal In this section we describe the configuration using AT commands 2N SmartCOM entered into the command line Here is what you can find in this section 4 1 Configuration 4 2 List of Supported AT Commands ...

Page 30: ...rt The baud rate is 115 200 bps by default Now enter the following sequence of characters preceded and followed by a 1 second delay into the terminal When answers OK you can start configuring the device using the AT 2N SmartCOM commands listed in Subs 4 2 Restart the RS 232 port when you have finished configuring to return into the data mode Send the following command at scport1 restart Configurat...

Page 31: ...e used for configuring Port 10000 is used for configuration input data reading and output control in the IP domain It is in the command mode upon power up and thus need neither be switched nor restarted after configuration Note This port requires the safety password if configured so Caution If your fails to respond to incoming TCP connections 2N SmartCOM check the status of the port to which you a...

Page 32: ...ial port transmission Tip Enter the port number or name or select a port The AT command then looks as follows at sccfg mode tcpclient at sccfg gprs_apn internet open Enter the command to set the APN to the mobile provider The configuration for O2 CZ is used as an example at sccfg gprs_user internet style font size 10 0pt line height 13 0pt at sccfg gprs_pass hds6cd5 These two commands help set the...

Page 33: ... save Enter the command to save changes at sccfg restart Enter the command to restart 2N SmartCOM at sccfg srestart Save the changes and restart 2N SmartCOM at sccfg This command displays the currently set interface values SCCFG MODE 1 SCCFG GPRS_APN publicip t mobile cz SCCFG GPRS_USER internet SCCFG GPRS_PASS hfsdj515d SCCFG LOCAL_IP 89 24 3 195 SCCFG SIM_PIN 1234 SCCFG AUTH_IP 0 at sccfg This c...

Page 34: ... 400 in standard steps at scport1 data_bits 8 Enter the command to set the data bits to 8 Setting options 5 8 at scport1 stop_bits 2 Enter the command to set the stop bits to 2 Setting options 1 2 at scport1 parity 2 Enter the command to set the parity check type Setting options 0 4 0 none 1 even 2 odd 3 constant 1 4 constant 0 at scport1 flowcontrol 1 Enter the command to set the flow control typ...

Page 35: ...ng the RS 485 M Bus parameters at scport2 baudrate 9600 Enter the command to set the baud rate to 9 600 bps at scport2 baudrate 115200 Enter the command to set the baud rate to 115 200 bps at scport2 baudrate 230400 Enter the command to set the baud rate to 230 400 bps The baud rate can be set to 110 230 400 in standard steps at scport2 data_bits 8 Enter the command to set the data bits to 8 Setti...

Page 36: ...options Relay Outputs These commands are used for relay output control at screl1 Enter the command to identify the status of relay 1 at screl1 0 Enter the command to open relay 1 at screl1 0 0 Enter the command to open relay 1 The relay will be open after the terminal restart at screl1 0 1 Enter the command to open relay 1 The relay will be closed after the terminal restart at screl1 0 2 Enter the...

Page 37: ...lay will be in this position after restart at screl2 0 1 Enter the command to change the status of relay 2 The relay will be in the opposite position after restart at screl2 0 2 Enter the command to change the status of relay 2 The relay will be in the position as before restart after the terminal restart at screl2 1 Enter the command to change the status of relay 2 at screl2 1 0 Enter the command...

Page 38: ... to the currently measured value at scadc1 threshold_low 200 Manual calibration setting minimum values Setting options 0 960 at scadc1 threshold_high 250 Manual calibration setting maximum values Setting options 0 960 at scadc1 save Enter the command to save the changes at scadc1 Enter the command to display the currently set port values at scadc1 Enter the command to display the port setting opti...

Page 39: ...play the port setting options at scdin1 get_value Enter the command to detect the logical level on the port and send value 1 0 at scdin1 calib_min Enter the command to make automatic port calibration according to the currently measured value at scdin1 calib_max Enter the command to make automatic port calibration according to the currently measured value at scdin1 threshold_low 400 Manual calibrat...

Page 40: ...etting minimum values Setting options 0 960 at scdin2 threshold_high 550 Manual calibration setting maximum values Setting options 0 960 at scdin2 save Enter the command to save the changes at scdin2 Enter the command to display the currently set port values at scdin2 Enter the command to display the port setting options S0 Pulse Counting The commands below are used for pulse counter state setting...

Page 41: ...the command to store the counter value in the EEPROM manually at scpulse1 Enter the command to display the current interface settings at scpulse1 Enter the command to display the setting options for the interface at scpulse2 state Enter the comma1nd to know the current states of the input 2 counter COUNTING counting in progress STOPPED counting stopped at scpulse2 get_value Enter the command to re...

Page 42: ...e command to display the current interface settings at scpulse2 Enter the command to display the setting options for the interface General Commands General commands for 2N SmartCOM at A terminal function control command which executes no action and always gets the OK answer ate Enter the command to disable echo replies are displayed only instead of commands ate0 Enter the command to disable echo a...

Page 43: ...mmand to display the model 2N SmartCOM at gmr Enter the command to display the current firmware version SC_vxx xx at gsn Enter the command to display the GSM module IMEI ati Enter the command to display the model 2N SmartCOM ati3 Enter the command to display the current firmware version SC_vxx xx ati4 Enter the command to display the serial number 2N SmartCOM ato Enter the command to switch the po...

Page 44: ...p 0 disabled The port will be in the DATA mode upon power up 1 enabled The port will be in the CMD mode upon power up at sc232at Enter the command to display the automatic AT mode setting state at sc232at Enter the command to to display the automatic AT mode setting options at sccfgall Enter the command to display the currently set values for all interfaces SCCFG MODE TCPCLIENT SCCFG GPRS_APN inte...

Page 45: ...ing parameters 1 to 5 at scipauth clear Enter the command to delete all IP addresses from the list at scipauth Enter the command to write out the list of set IP addresses SCIPAUTH 1 90 182 112 54 SCIPAUTH 2 90 182 112 5 at scipauth Enter the command to display the setting options for the interface SCIPAUTH ADD 15 SCIPAUTH REMOVE 1 5 SCIPAUTH CLEAR Test Command This command is used for terminal tes...

Page 46: ...se this channel is used for GSM module communication during command execution When the command has been executed the original channel setup is restored and a new incoming connection is awaited Other Commands Boot State Service Others These commands are used for firmware upgrade and servicing of the GSM module at scupg http star 2n cz fejfar SmartCOM_SC_v00 04 bin The command is used for firmware u...

Page 47: ...ISMO228 WAVECOM MODEM L23_00gg WISMO228 140711 at iccid Enter the command to display the SIM ICCI Integrated Circuit Card IDentifier at scpras Enter the command to display the remaining PIN entering attempts at sig Enter the command to display signal intensity in dBm SIG 65dBm STRONG at scerr Enter the command to write out the error buffer status SCERR 72 8 10 SCERR 73 8 10 at scerrclear Enter the...

Page 48: ... at scchg srestart Enter the command to save the changes and modify the charging parameters immediately at scchg Enter the command to display the current charger settings and charging state at scchg Enter the command to display the charger setting options Warning Remember to set the charger parameters before connecting the accumulator and starting the charging process Make sure that the settings a...

Page 49: ...ule at scwmbus dev_add MAN 12345678 600 Enter the command to add an item to a table of meters to be read MAN is a three character abbreviation for the manufacturer followed by the meter serial number The last parameter denotes the minimum time interval in seconds between two stored readings of the meter to be added If the last parameter is not entered all messages received from the meter are store...

Page 50: ...pace Delete the oldest record and enter the get_oldest command to read the oldest but one record at scwmbus del_all Enter the command to delete all records from the Wireless M Bus meter data space at scwmbus mode 11 Enter the command to set the device operating mode 1 T1 3 S1 8 C1 11 T1 C at scwmbus get_space Enter the command to display free memory space for WM bus message storing at scwmbus mess...

Page 51: ...r the command to return the current IP address used on the Ethernet port at sceth fixed_ip 192 168 1 1 Manual IP address setting at sceth mask 255 255 255 0 Manual network mask setting at sceth gateway 192 168 1 254 Manual default gateway setting at sceth dns1 0 0 0 0 Manual primary DNS setting at sceth dns2 0 0 0 0 Manual secondary DNS setting at sceth save Enter the command to save changes at sc...

Page 52: ...P 7 15 SCETH MASK 7 15 SCETH GATEWAY 7 15 SCETH DNS1 7 15 SCETH DNS2 7 15 SCETH SAVE SCETH RESTART SCETH SRESTART at scchprim GSM Enter the command to set the primary channel to be used for creating IP connections GSM connections will be created via GPRS ETH connections will be created via Ethernet at scchprim Enter the command to display the currently set primary channel at scchled1 GSM Enter the...

Page 53: ...ending number Function Desription You can configure by sending short text messages to the telephone 2N SmartCOM number of the SIM card inserted in the terminal Doing this respect the below listed parameters to avoid an SMS processing error Every configuration SMS must meet the following conditions Name of device SC Correctly formatted command INFO CNF etc Authorisation password Correctly defined p...

Page 54: ...ent 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 INFO SMS Send the following message to identify the provider IMSI IMEI or serial number of your 2N SmartCOM SC INFO PWD password Caution Remember to enter the corr...

Page 55: ..._terminal_status current terminal status in the Client mode only CONNECTING terminal connection to Server in 2N SmartCOM progress CONNECTED terminal connection to Server completed 2N SmartCOM num_of_connected_clients count of clients currently connected to all ports in the STANDALONE mode only Basic Settings The following configuration SMS sets the basic parameters necessary for a proper function ...

Page 56: ...self by the password to get connected via this port 0 disabled 1 enabled APN gprs_apn provider s Access Point Name DUSR gprs_data_user user name for provider connection DPWD gprs_data_password password for provider connection IPS server_ip_address 2N SmartCOM Server IP address used in the Client mode PORTS server_port listening server port for terminal connection used in the Client mode NPWD new_p...

Page 57: ...n errors To display the buffer contents use either the terminal an AT command or an SMS The SMS displays the last 10 errors starting with the most recent one Send the following SMS SC ERR PWD password CLR CLR clear the error buffer Tip This command includes one optional parameter If you add this CLR string after the password in the command SMS you will receive an SMS showing the current buffer con...

Page 58: ...een introduced defining to which state the relay should be switched after power up Example Suppose you want relay 1 to be switched into the open state now and into the closed state after restart and relay 2 to close and retain so after restart Hence send the following configuration SMS SC REL PWD Password R1 0 R2 1 S1 1 S2 2 The command will be executed and the terminal will send the following rep...

Page 59: ...cal format only ranging from 0 0 0 0 to 255 255 255 255 DEL ip_id delete the IP address on the selected list position Caution Select in the ip_id parameter to delete all the IP addresses from the 0 list The SMS will be as follows SC IPA PWD password DEL 0 REP ip_addr_1 ip_addr_2 ip_addr_5 replace the existing address list with a new one Example Suppose you want to know whether the IP access functi...

Page 60: ...ur ERR Unknown command an unknown command has been entered Four commands are allowed INFO CNF ERR REL IPA ERR Password missing the configuration SMS fails to include the password i e the PWD password string ERR Password incorrect the password is wrong ERR Too many parameters the configuration SMS contains more than 160 characters or was sent as a 16 bit message with diacritic symbols and or substa...

Page 61: ...ed for basic configuration of the terminal This subsection provides details on its environment and basic functions Launch the application from the directory into which you installed it Note The installation 2N SmartCOM Terminal Configuration Program requires of free disk space at least 20 MB ...

Page 62: ...e Terminal Configuration Program 2N SmartCOM hereinafter referred to as Terminal Config window The main toolbar helps you select the for connection to hereinafter referred to as Serial port 2N SmartCOM terminal This list includes all available serial ports installed in the PC on which the application is running ...

Page 63: ...window displayed during the connecting process The last main toolbar button helps you from the terminal connected Load configuration the application gets connected and reads out all relevant data Tip 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 c...

Page 64: ...M erminals Refer to for application use details Subs 6 1 Use the menu to read configuration import export configuration or reset the File connected terminal Via the menu you can adjust communication parameters Options and or change the default language CZ or EN The section helps you disable View the tags that are not frequently used and occupy too much space Open the View menu and specify the tag ...

Page 65: ...ly Ethernet SC PRO ETH Having read configuration go to the tag of the section General Parameters Figure General Menu Here you can set all parameters comfortably as you can with the AT commands described in i e GSM commands plus automatic answer parameters Push t S 4 Save o save the values Push to apply the changes immediately Save and restart The Ethernet menu is only available to terminals equipp...

Page 66: ...e Ethernet Menu Use the RS 232 and RS485 M Bus tags to set communication parameters for each port Set the password request enable and AT mode upon power up for RS 232 Use the WM Bus tag to set the operating and decryption modes for the module ...

Page 67: ...refore be careful while configuring the keys A key adding error may lead to a decryption error Furthermore you can to the list Enter the device code and serial Add new device number Complete the timeout e g in case the selected device sends multiple identical pieces of information in a short time interval The remaining parameters are optional and need not be specified Warning Contact the device ma...

Page 68: ... helps you display the error codes captured during the operation If Error buffer no error has occurred since the last clearing date SCERR NO ERROR will be displayed If an error occured the error code will be displayed Click on the Error code table button to display the message decryption window Figure Error Buffer Use the tag to enter commands of your own for parameter Own AT commands setting The ...

Page 69: ... the current firmware file and press to initiate the upgrading process which is Start signalled by the progress bar below When the process is completed the terminal will get restarted 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 ...

Page 70: ...ommand to be sent to the terminal or to be stored for later use Refer to Console for the current terminal communication listing and to for the list of Current settings configured commands in the terminal Figure User Defined Functions Menu Refer to for more details on the UDF setting options S 9 The tag displays the current date time and time zone data You can also RTC settings synchronise the devi...

Page 71: ...set the maximum SC PRO charging voltage and current Figure Charger Menu is the last accessible tag You can define from which IP addresses it will be IP access possible to access the terminal Attempts from non listed IP addresses will be ignored Press to enable the function and to add an IPv4 address to the list Click on an ON Add item for selection and push to delete an address from the list Remov...

Page 72: ...72 2N TELEKOMUNIKACE a s www 2n cz Figure IP Access Menu ...

Page 73: ...ol Panel In this section administration and use of the product using the 2N SmartCOM 2N Server and Control Panel are described SmartCOM 2N SmartCOM Here is what you can find in this section 7 1 SC Server 7 2 Control Panel 7 3 Control Panel Use ...

Page 74: ...erver to be installed By 2N SmartCOM default C Program Files SC Server is 2N TELEKOMUNIKACE 2N SmartCOM used Also select the port for the application to communicate with the terminals and other 2N Control Panel applications Make sure that the port is accessible from the SmartCOM Internet see above and properly configured in all terminals and applications Http accessibility is necessary as the sele...

Page 75: ...is increased by 1 by every Server 2N SmartCOM restart The Licence Tool is installed together with the server Having 2N SmartCOM launched the application you can see the version ID and details on service settings for the server installed See Figure Figure Licence Tool A unique ID is generated for your server during installation Send this code including your licence requirements to for an extended l...

Page 76: ...TELEKOMUNIKACE a s www 2n cz will change into OK Now the last row of the includes all the Listing parameters licensed server properties count of users count of terminals and AT API and terminal upgrade enable ...

Page 77: ...ed Follow the Wizard 2N SmartCOM instructions Select the directory for the Control Panel to be installed 2N SmartCOM By default C Program Files is used 2N TELEKOMUNIKACE 2N SmartCOM 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 Control Panel It automatically 2N SmartCOM adds an item to the menu and the...

Page 78: ...e Admin Password 2n If you use one and the same PC for the Control Panel and the 2N SmartCOM 2N Server you can enter the local loop address 127 0 0 1 or the local host SmartCOM text as the server address To log in to another server enter the local or public IP address Or use the DNS names if you use DNS Enter the listening port into the i Port tem as selected during your Server installation Contac...

Page 79: ... menus necessary for its work with terminals only The Administrator also views the user user group managing and server setting menus The line displays the following information From the left application version Status currently signed in user count of configured terminals count of on line terminals current server address server listening port and application status Find the button in the bottom pa...

Page 80: ...ttons to communication Start Stop with the terminal Push the Add user button to add a user Push the button to add a user group Add group Push the general button to add an object to a Add group and create new virtual ports and terminals Click on to modify the parameters already Edit configured Click on to remove an object from Remove configuration The button changes the user Change password passwor...

Page 81: ...artCOM configuration Use this button to install the virtual serial port driver Push the button to log out the currently Sign out signed in user Use to search the relevant table columns Search Use to control the relay Switch on Switch off contacts Use the button to display details on the terminal Click on to upgrade firmware of selected Update terminals Click on to reset the factory default values ...

Page 82: ...place as well as assign small terminal groups to authorised users User Mode Having singed in as the User you get access to four items of the main menu only and They are all you need for Terminals Connections Virtual Ports Settings 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 onl...

Page 83: ...the moment they are saved Click on the button in on line terminals to display details on the connected Info terminal relay control and values measured on analogue and digital inputs Figure Terminals Menu Terminal Details The include the following data GSM module IMEI International Terminal Details Mobile Equipment Identity name and number of the GSM provider at which your 2N is registered signal i...

Page 84: ...ns a table showing the terminals that are assigned a Connections virtual port The table includes the terminal name serial number IP address and physical port to be connected to the selected virtual port The field defines the Status current of the terminal the terminal is on line connected to the server and ready for Not Connected virtual port connection the terminal virtual port connection is in p...

Page 85: ...al port upon the application start Press to interconnect the terminal with the virtual port If one and the same port Start is used by multiple terminals the other users will not be able to press until the Start first connection has been finished Refer to the note below Push to terminate Stop communication Note Although there may be multiple terminals assigned to a virtual port one terminal can onl...

Page 86: ...irtual ports for each of them This however applies to serial ports only virtual ports are transferable to other PCs This option however can be disabled in the configuration Create TCP Port To create a virtual TCP port select and enter the port to be created Also tick off Add to enable the port use for the current PC only Finally click on Allow local host only Create Figure Create TCP Port Create C...

Page 87: ...OM Port Having installed a COM port into the PC activate the COM port Although the port has been added to the table the item shows NO Therefore click on Virtual ports Ready this table row to view the port details and the button Push the button to Refresh change the port status from Ready NO to Ready YES Figure Refresh Button ...

Page 88: ...virtual serial port drivers If no drivers have been installed you cannot use or add serial ports in the me Virtual ports nu If the com0com driver is not installed the com0com is not installed message gets displayed as shown in Figure You can install drivers for 32 and 64 bit systems too If the installation process is successful the com0com is installed will be displayed Caution You need the Admin ...

Page 89: ...igure Autologin Caution By interrupting automatic login you also disable the Allow automatic parameter Thus you will have to re enable it to use autologin login again The application checkbox helps you debug the application or just record Logging server communication The files are automatically split after reaching 10MB Admin Mode The Admin user has access to all User mode menus plus the user and ...

Page 90: ...e users who forget their passwords Click on to change the user details Edit The menu contains the user groups to which the user is assigned Click on Groups and select an item from the list to create a new group Push to remove a Add Remove group from the list Add user Click on the button next to the filter setting You will be asked to complete Add user the login full user name and password to ensur...

Page 91: ...g able to configure then or connect to them Connect users with the right may view and also connect to the Connect terminals via the menu Connections Configure users with the right have the advantages of the two Configure user groups above and moreover may configure the communication parameters of the terminal ports Monitor not implemented yet Prepared for future use Use the menu to add remove the ...

Page 92: ...n also add a note to the group Click on to create a new group Create Links Figure Links Menu The menu displays the currently connected terminals and users The Links 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 Find the bu...

Page 93: ...lay the Terminal including the terminal name serial number hardware version as well as count Details of available relays and digital and analogue inputs Notes can be added if available Click on to change the terminal details Edit Specify in the in which group the selected terminal shall be visible Terminal Groups i e which group shall be allowed to use this terminal Click on to add a group Add Cli...

Page 94: ...ure Create Terminal To add a terminal enter the terminal name serial number and password The parameters are limited and you will be checked during entering No name or serial number may be duplicated in the configuration You will be notified of any duplication in the configuration Click on to create a new terminal Create ...

Page 95: ...gs are available here too Set the port for API connection and communication There is a button for you to enable disable the API 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 you will have to enter a new Listen Port port during login If you forget it you will have to reinstall the whole...

Page 96: ...ation only Note The Application data directory shows the location of the server LOG files Hence it is only in the PC on which the Server 2N SmartCOM is installed You will not find this directory on the PC from which you launch the Control Panel and log in to the 2N SmartCOM 2N Server remotely SmartCOM Default Terminal Firmware URL is the address that can be used for firmware upgrade for the termin...

Page 97: ...SmartCOM ticks off the terminal or group of terminals to be updated This enables the but Update ton Push the button to execute automatic update for all the selected terminals Note The terminals that are off line during the update will be updated as soon as they log in to the Server 2N SmartCOM There is a list of available FW versions in the left section of the window Push the Add button to add a n...

Page 98: ...rminal to be updated The second column indicates whether the terminal is on line or off line The terminal name serial number and current firmware versions are available here too An actual or scheduled upgrade is indicated by original FW new FW The Status field defines the state of the terminal updating process as follows OK update completed terminal ready for work UPDATING update in progress ERROR...

Page 99: ...ute update later set the required date and time The update will start automatically on the selected day and at the selected time Note There is a server limitation as to the count of terminals for updating If you want to update more terminals than 10 at the same time the first 10 terminals will start updating at the specified time the next 10 terminals will start updating in one minute and so on un...

Page 100: ...mware Update Details Figure Push the button in the column to open the Info Details Firmware update details including the upgrade date Click on to re schedule the upgrade or push Change to retain the original setting and close the window Keep ...

Page 101: ...KOMUNIKACE a s www 2n cz 8 AT API In this section the function is described from the user s point 2N SmartCOM AT API of view Here is what you can find in this section 8 1 AT API Description 8 2 Supported Commands ...

Page 102: ...ing logged in get connected via Telnet to the Server address on 2N SmartCOM 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 AT API 2N SmartCOM Login Admin Password 2n OK Now you are in the AT API environment in the standby mode and can enter the supported comman...

Page 103: ...is always sent ate Enter the command to disable echo to display just replies not commands ate0 Enter the command to disable echo ate1 Enter the command to enable echo ati Enter the command to display the device model AT API 2N SmartCOM 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 Server 2N SmartCOM at cgmi Enter t...

Page 104: ...terminate the TCP connection Server Settings at sccfg Enter the command to read out and display the current server settings SCCFG LISTEN PORT 50505 SCCFG HTTP PORT 93 SCCFG HTTP ENABLED 1 SCCFG AT API PORT 1562 SCCFG AT API ENABLED 1 SCCFG LOG LEVEL 3 SCCFG MAX USER TCP CONNECTIONS 100 SCCFG MAX TERMINAL TCP CONNECTIONS 100 SCCFG KEEPALIVE TIMEOUT 60 SCCFG KEEPALIVE SENDING PERIOD 180 SCCFG TERMIN...

Page 105: ...port Enter the command to establish connection to the selected terminal and selected port Note Suppose you want to establish connection to terminal 50 0295 0562 and its RS 232 port Enter the following command into the API ATD5002950562 1 Enter the command to switch on the command mode for you to enter the basic AT commands for server information and the command for connection ATH termination ato E...

Page 106: ...l at screl ser_no relay state Enter the command to set the relay contact position at screl ser_no relay state state_after_term_restart Enter the command to set the relay contact position and define the contact behaviour after the terminal restart 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 ...

Page 107: ...PI in the same manner as if you configured the terminal via the RS232 port or TCP port 10000 in the Standalone mode The configuration port is accessible under number zero Enter the ATD command as if you accessed the terminal physical ports Upon connection you can set even the functions that are inaccessible via the Control Panel or AT API commands such as the user defined functions UDF described b...

Page 108: ...g time UNIX timestamp id record code in circular buffer rssi signal intensity in dBm during message receiving len received message length in bytes at scwmbus del_oldest Enter the command to delete the oldest record from the Wireless M Bus meter data space Delete the oldest record and enter the get_oldest command to read the oldest but one record at scwmbus del_all Enter the command to delete all r...

Page 109: ...109 2N TELEKOMUNIKACE a s www 2n cz 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 110: ...n cz 9 User Defined Functions UDF This section describes the function of the terminal user settings called 2N SmartCOM User Defined Functions UDF Here is what you can find in this section 9 1 UDF Description 9 2 UDF Condition Setting ...

Page 111: ...nsical syntaxes and or repetition of identical conditions Such meaningless statuses cannot be processed effectively due to a limited memory and power capacities of the terminal Set the conditions using the AT commands in the terminal configuration Each AT command must include the condition syntax parameter1 sign parameter2 followed by the separator action type and action parameters A typical AT co...

Page 112: ... listed and available for work Therefore mind that an SMS or TCP message can be sent or the relay can be activated immediately AT SCUDF CLEAR Enter the command to clear all conditions from the terminal memory AT SCUDF REMOVE Enter the command to clear the condition with the selected ID AT SCUDF Enter the command to list all the conditions saved AT SCUDF Enter the command to display the setting opt...

Page 113: ... their value is their state will be 0 0 The following operators can be used for evaluation operator Description param1 is greater than param2 param1 is smaller than param2 param1 is equal to param2 param1 is greater than or equal to param2 param1 is smaller than or equal to param2 Conjunction Disjunction Negation Use the standard syntax i e to compare the param1 operator param2 measured value Howe...

Page 114: ...aution If you use Negation the parameter will be treated as a digital input It cannot be expected for example that if 50 is measured on AIN1 50 can be obtained after negation Action Types Insert an action after the separator for the selected syntax SAVE Enter SAVE to save the condition result into the terminal memory for later use Note A typical condition saving AT command looks as follows At scud...

Page 115: ...server and not executing new actions CNT 1 5 Enter CNT 1 5 to control all of the 5 internal counters Note The AT command for counter increment by 1 can be as follows for example At scudf add AIN1 50 CNT1 d 1 Action Parameters Use the parameters of the actions mentioned above to change the relay states and set the address for SMS TCP sending Enter the parameters in the format mark value and separat...

Page 116: ...ction only r REL Timer Set the timer in seconds where is the waiting time Refer to the subse t xx xx Timer ction for details Caution The timer can be used for the and actions only TCP SMS Message Set the message The maximum message length is 40 characters Longer m text messages will be rejected Note The maximum of 40 characters is derived from the maximum length of the SMS to be sent If the maximu...

Page 117: ...on Suppose you want to enter a command into the terminal which when the limit value 80 on input 1 is exceeded will send an SMS to number 123456789 including the the currently measured value ALARM value is The AT command looks as follows AT SCUDF ADD AIN1 80 SMS p 123456789 m ALARM value is AIN1 The following SMS will be sent to the set number ALARM value is 87 Caution Should you enter an invalid o...

Page 118: ...xecuted after the timeout if the condition is true The condition need not be evaluated as false before re execution 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 The parameter defines that the counter value increases by the ...

Page 119: ...ion type not supported 10 UDF_RESP_ERROR_PHONE_NUMBER_LEN Telephone number length error 11 UDF_RESP_ERROR_PHONE_NUMBER Telephone number not found or not supported 12 UDF_RESP_ERROR_IP_ADDRESS IP address not found or not supported 13 UDF_RESP_ERROR_IP_PORT IP port wrong 14 UDF_RESP_ERROR_RELAY_STATE Relay state not found or not supported 15 UDF_RESP_ERROR_PARAM_PARSE Action parameter translation er...

Page 120: ...ot found 20 UDF_RESP_ERROR_PARAM_TYPE_INVALID Action parameter not supported for selected action type 21 UDF_RESP_ERROR_ACTION_IN_PROGRESS Condition action in progress 22 UDF_RESP_ERROR_MESSAGE_MISSING Message to be sent not found 23 UDF_RESP_ERROR_PARAM_VALUE Value format or range is invalid ...

Page 121: ...to export and import databases safely You are not advised to copy the sc_config db database files between servers to avoid data loss Tip The application is launched in the command row The common path to the program is identical for all WINDOWS XP Vista and 7 versions c Program Files 2N TELEKOMUNIKACE 2N SmartCOM SC Server sc_config exe If sc_config exe is launched without any parameter the program...

Page 122: ...cExportDatabase The program will create a new file called e g db 20120221095921 export xml The number in the filename includes the current database export date and time in the YYYYMMDDhhmmss format The database is saved into the user data folder and so can be different for different systems Note A typical storage for WINDOWS XP is C Documents and Settings All Users Application Data 2N TELEKOMUNIKA...

Page 123: ...ter another A successful import of each table is always confirmed after completion 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 Note If the database contains a high number of users and terminals the import of tables will take a rather long time typically a few m...

Page 124: ...Enter this command to print out the HTTP port gAtPort Enter this command to print out the AT API port gLicensesNumber Enter this command to print out the PC ID for licence gTerminalPV1url URL for update of terminals with the protocol version 1 the 2N SmartCOM oldest ones Parameter set commands sListenPort Enter this command to set the listen port port for the 2N SmartCOM protocol sHttpPort Enter t...

Page 125: ... a high number of terminals 100 are used to avoid disconnection sKeepAlivePeriod 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 Server commands cStartServer Enter the command to start the Server service 2N SmartCOM cStopServer Enter the command to sto...

Page 126: ...KOMUNIKACE a s www 2n cz 11 Maintenance This section describes how to maintain the product 2N SmartCOM Here is what you can find in this section 11 1 Firmware Upgrade Update 11 2 Factory Default Reset 11 3 Repairs ...

Page 127: ... information on new functions and firmware versions a s Enter the following command into the terminal to upgrade firmware at scupg http SERVER_IP http_port SmartCOM_SC_v00 04 bin The command has to include the address of the server for downloading and the exact name of the firmware file Caution Make sure that connected to the Internet during 2N SmartCOM is the whole process of firmware upgrading t...

Page 128: ...ure Factory Reset Jumper Disconnect from the power supply Connect the jumper as shown in 2N SmartCOM Fig 11 1 basic version on the left PRO version on the right and reconnect the power supply Now the Flash memory is deleted and the factory default values are reset for all ports Remember to remove the jumper to avoid deletion of the factory values upon every start ...

Page 129: ... Should you need some service interventions please contact the 2N Technical Support staff via e mail or tel TELEKOMUNIKACE a s techsupport 2n cz 420 900300300 repairs may be made by an authorised servicing centre or the 2N SmartCOM manufacturer only ...

Page 130: ...2N TELEKOMUNIKACE a s www 2n cz 12 Technical Parameters This section provides a list of technical parameters 2N SmartCOM 12 1 Technical Parameters for Basic Version 12 2 Technical Parameters for PRO Version ...

Page 131: ...o 3W Connector DC Jack 2 1mm GSM Mobile network type GSM 850 EGSM 900 DCS1800 PCS 1900 SIM card Plug in 3V 1V8 small Transmission power 2W 1W Data transmission GPRS class 10 Receiver sensitivity 108 dBm Antenna Frequency 850 900 1800 1900 MHz Impedance 50 Ω Maximum power 2W Antenna connector type SMA Relays Two Maximum voltage 250V AC 30V DC Maximum current 2A Maximum power 30W 62 5VA ...

Page 132: ...A 0 20 mA DC RS232 Interface Connector D Sub 9 pin male Transmission rate 110 23400 Baud RS485 or M Bus Interface Optional Connector RJ12 6 pin Count of M Bus devices Up to 5 Working Conditions Temperature 40 C 85 C Relative humidity 0 80 Others Dimensions without connectors 69 x 100 x 24 mm CE certificate ...

Page 133: ... 16 AWG wires 2 GSM Mobile network type GSM 850 EGSM 900 DCS1800 PCS 1900 SIM card Plug in 3V 1V8 small Transmission power 2W 1W Data transmission GPRS class 10 Receiver sensitivity 108 dBm Antenna Frequency 850 900 1800 1900 MHz Impedance 50 Ω Maximum power 2W Antenna connector type SMA Relays Two Maximum voltage 250V AC 30V DC Maximum current 2A Maximum power 30W 62 5VA ...

Page 134: ...ional Connector Terminal block for 1 5mm 16 AWG wires 2 Count of M Bus devices Up to 5 Wireless M Bus Optional Frequency 868 870MHz Data memory 120kB Charger Accumulator type Gel lead acid 6V or 12V set the parameters before connection Charging current Up to 350 mA Real Time Clock Power failure back up 0 33F super capacitor 2 day back up capacity Working Conditions Temperature 40 C 85 C Relative h...

Page 135: ...135 2N TELEKOMUNIKACE a s www 2n cz Others Dimensions w o connectors 105 x 100 x 30 mm CE certificate ...

Page 136: ... 13 Supplementary Information This section provides supplementary information on 2N SmartCOM Here is what you can find in this section 13 1 List of Abbreviations 13 1 Regulations Laws and Directives 13 3 General Instructions and Cautions ...

Page 137: ...ket Radio Service High speed packet oriented mobile data service HW Hardware For this purpose hardware means an electronic device circuit board component etc PIN Personal Identification Number SIM card protecting code against unauthorised use PUK Personal Unblocking Key SIM card unblocking code after repeated wrong PIN entering attempts SIM Subscriber Identity Module Chip module for GSM identifica...

Page 138: ...ctive 2005 32 EC of the European Parliament and of the Council with regard to ecodesign requirements for standby and off mode electric power consumption of electrical and electronic household and office equipment Directive 2011 65 EU of the European Parliament and of the Council of 8 June 2011 on the restriction of the use of certain hazardous substances in electrical and electronic equipment Regu...

Page 139: ...age incurred as a result of a natural disaster or any other unfavourable natural condition The manufacturer shall not be held liable for any damage of the product arising during the shipping thereof The manufacturer shall not make any warrant with regard to data loss or damage The manufacturer shall not be liable and responsible for any direct or indirect damage incurred as a result of a use of th...

Page 140: ...ectric appliances and battery packs removed from them to dedicated dumpsites or containers or give them back to the dealer or manufacturer for environmental friendly disposal The dealer or manufacturer shall take the product back free of charge and without requiring another purchase Make sure that the devices to be disposed of are complete Do not throw battery packs into fire Battery packs may not...

Page 141: ...141 2N TELEKOMUNIKACE a s www 2n cz 2N TELEKOMUNIKACE a s Modřanská 621 143 01 Prague 4 Czech Republic Tel 420 261 301 500 Fax 420 261 301 599 E mail sales 2n cz Web www 2n cz 1665v1 8 0 ...

Reviews: