Home

Maestro Heritage Software Tools

1. CTn to indicate variable IP options in SMS content TMn Example Send a message ALERT to phone number store in SIM phonebook 1 SM 1 SN ALERT Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 56 t empowering wireless Example Send a message Counter 2_value is 20 to phone number store in SIM phonebook 1 SM 1 SN Counter 2_value_is CT2 b Using variable options within SMS content In the SMS content field you can use and Service type to insert the current value of Service into the SMS content Variable CTn TMn IP Description Current value of counter Current value of Current I P Ports Id n Timer Id n summing value Range of n 1 to5 1 to 10 See Chap 13 4 c for calculation Invalid Service name or Id will be ignored Note 1 Due to modem SIM initialization it is recommended to send SMS 30 seconds after power up 2 Only send SMS with normal characters If SMS content has character with ASCH value outside the range between 11 and 127 the SMS may not be sent properly 3 Incase of sending SMS failure e g network problem the program will delay 0 5 second and try to resend the SMS If the second time retry i e 3 times total fails this SMS delivery will be aborted 4 The maximum length of the SMS content is limited by the maximum length of Command String 128 bytes T
2. AT CSTRSTAT lt type gt lt id gt Response Syntax OK CME ERROR 3 Command Possible responses AT CSTSTAT AL 1 AL 1 ST 01 01 01 12 00 00 TR 2 OK Note read current setting of Alarm 1 AT CSTRSTAT TM 10 TM 10 CV 66 SW 1 TR 20 OK Note read current info of countdown timer 10 AT CSTRSTAT IP 9 CME ERROR 3 Note id out of range Defined Values lt type gt Define type of Service AL alarm CT counter IP Input Port CT Countdown timer PW Device Power Control lt id gt Service id b Reading Alarm Service Enter AT CSTRSTAT AL 1 will get Alarm 1 info AL 1 ST _ 01 01 01 12 00 00 TR 3 a Service id Soe See eps ae a eae Ae ae b datetime set space if not set a b c c Command String id to be executed if trigger 0 if not to trigger Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 59 t empowering wireless c Reading Counter Service Enter AT CSTRSTAT CT 1 will get Counter 1 info CT 1 ST300 CV20 TR 3 a Service id PaaS See eae es b trigger value of the counter a b c d c current value of the counter d Command String id to be executed if trigger 0 if not to trigger d Reading Countdown Timer Service Enter AT CSTRSTAT TM 1 will get Countdown Timer 1 info TM 1 CW90 SWO TR 3 a Service id b current value of the timer a b c d c timer is running 1 or stop 0 d
3. t empowering wireless 2 AT commands for Auto TCP UDP connection a ATtAUTOTCP command This command controls the Heritage to start TCP socket connection automatically Before using AT AUTOTCP TCP and GPRS settings MUST be setup properly using AT IPTCP and AT IPGPRS command respectively Command Syntax AT AUTOTCP lt mode gt Response syntax AUTOTCP lt mode gt Command Possible responses AT AUTOTCP 0 OK Note disable AutoTCP AT AUTOTCP 1 OK Enable AutoTCP AT AUTOTCP AUTOTCP 1 OK Note display current status AT AUTOTCP AUTOTCP 0 1 Note possible argument Defined Values lt mode gt 1 enable auto TCP 0 disable auto TCP Note e Before enabling Auto TCP it MUST be properly set the GPRS settings by AT IPGPRS command and TCP settings by AT IPTCP command see Chapter 3 e ONLY GPRS PDP context 1 will be used So please setup IPGPRS settings with lt cid gt 1 e Once AutoTCP is enabled it will start the TCP socket connection automatically after 20 seconds e Once the TCP connection is established successfully the serial port will go to data mode all data entered to the serial port will be sent to remote TCP peer No more AT commands will be accepted then e In TCP connected data mode the DSR and DCD signals of the serial port will go to high e If the TCP connection is broken the modem will try to reconnect automatically During re connection period serial port will g
4. sssssssssersrrssssrenrssssnenrrsssenns 52 a Countdown Timer Service Command String Syntax and explanation ai sexeeede cia wed ies aciscndueamneneriosawewineddnciene sweden eben disease 52 b Reading Countdown Timer StatuS cccceeeeeeseeeeeeeeeeanaes 53 4 Input Port Service wivsuatarasedectuaurnaavacevawusuid siirinsesi raderar 53 a Input port Service Command String Syntax and explanation 53 b Input Port operation mechanism single I P triggering 54 c Input Port operation mechanism multiple I P triggering 55 d Reading I P Port Status xiissccnsieusdasievaeiaxcentivesowssaxedsetiweianiox 55 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 5 Outp t Port S rviCe sarreretan unaa AIREAREN 56 a Output Port Service Command String Syntax and explanation 56 6 SMS ho 6 eee ne eee ee er er ee eee eter nee 56 a SMS Service Command String Syntax and explanation 56 b Using variable options within SMS content ccceeeeeees 57 7 Device Power Control ServiCe cccceccseceeeeeeeeseeeeeneeeaaaes 57 a Device Power Control Service Command String Syntax and explanation fax teuceas basen nese tecesceceusces edeecueeurcearsyscterse se ceeeeencee 57 b Reading Device Power Control statuS cccceceeeeeeeeeeeaeees 58 CHAPTER 16 COMMAND STRING READING STATUS OF SERVICES 59 1 Command for reading cur
5. 9 REMOTE AT COMMAND BY SMS ccsccceeeeeeeeeeeeeeeeeseeenenenes 36 3 Description of the Operation ccccescceeeeseeesceeeneseeeenaaes 36 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 4 AT command for configuring AT command by SMG 37 5 Limitation and caution to be taken when using remote AT COMMMANG eeste vanes cuxenndaweionsd Ge linadnmieewseuedavesdgausiassankers 37 CHAPTER 10 CALL SCREENING csssccccssesserecnsensseeennsenseeseneeasseeseneensseeess 38 1 AT commands for configuring call screening eeeee eee 38 a AT CSRN COMMING sis scciscauecieceveweeeovswerdinacs aaa ieee 38 b AT 4CSNW command lt ccutccskcusceccsuidenscelsectadiamsisetccenseceade 38 ATFCSNR Command siscccsateesentscomusscececascenterscanaenceessacuseake 39 d ATFCSND Command rseson EEEE NEE 40 CHAPTER 11 MODEM STATUS CHECK AND MONITORING cccceseeseeeeee 41 1 AT command for Modem Status Check and Monitoring 41 a Al 1 MODE Command tinicscscetvtaseececeteabicivesteitesiaoardiatouies 41 b Operation of Modem Status Check and Monitoring 42 CHAPTER 12 REMOTE PROGRAM UPDATE 0ssceeecseesseeeesseeeeeeeeseeeeeeese 43 1 AT command for remote firmware Update ccceeeee seen eens 43 a gt ATFIPFTP command ssiuieccccmceimeiiventa nseni arnee 43 b AT FIEPDOTA c mMand arisin 44 c AT ADDINSTALL command cci
6. Defined Values lt filename gt File name of the file to be downloaded Maximum 128 characters lt path gt Path directory name where the file is placed Maximum 128 characters If lt path gt is omitted program will try to download from FTP s root entry directory Maximum 128 characters lt update gt If a third parameter 1 is entered the program will execute the AT ADINSTALL command if the download process is successful This is useful for sending update commands over SMS so that one SMS is saved in this case See next section for the details of AT ADINSTALL command lt result gt Result code of the downloading process Result explanation Comments countermeasure code 0 Download successful 1 SIM card problem Check SIM card and PIN 2 Internal memory problem Try reset modem 3 FTP connection fail Check network signal check FTP status check FTP address 4 Reserved 5 Download file size not same as Retry downloading FTP reported 6 Not enough space for Contact Maestro Wireless downloading 7 File format incorrect Check file for downloading 8 Error writing flash Contact Maestro Wireless 4xx 5xx FTP protocol return code Check FTP document RFC 959 for explanation c ATtADDINSTALL command This command is perform the program update process File downloaded by AT FTPDOTA command will replace the existing Heritage program Modem will restart and then restart result
7. FTPDOTA command This command is to inform the modem the filename and FTP path The modem will login to the FTP server download the update file and optionally execute the update process Command Syntax AT FTPDOTA lt filename gt lt path gt lt update gt Response syntax FTPDOTA 0 lt filename gt lt filesize gt FTPDOTA lt result gt ADINSTALL lt adinstall result gt Command Possible responses AT FTPDOTA update dwl FTPDOTA 0 update dwl 17000 OK Note download update dwl file from FTP root directory file size is 17000 bytes AT FTPDOTA updatel dwl sub FTPDOTA 0 update dwl 17001 OK Note download update1 dwil file from FTP sub directory file size is 17001 bytes AT FTPDOTA updatel dwl sub 1 ADINSTALL 2 M100_VAF_094d_OAT316_32 Nov 11 200718 01 42 Note download updatel dwi file from FTP sub directory and perform program update successfully AT FTPDOTA FTPDOTA update dwl 17001 OK Note check downloaded file ready for update AT FTPDOTA FTPDOTA OK Note no downloaded file AT FTPDOTA updatel dwl FTPDOTA 3 OK Note error on downloading file FTP open fail AT FTPDOTA FTPDOTA 128 128 Note possible argument Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless
8. IPCONNECT Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 61 t empowering wireless CHAPTER 18 QUESTIONS AND ANSWERS gt gt O 1 AutoTCP UDP Can I specify lt server gt by URL e g xxxx com rather than IP address Yes but only if your GPRS network have proper DNS service You cannot specify your own DNS server If I enabled AutoTCP or AutoUDP how can I stop it you need to enter the command AT AUTOTCP 0 or AUTOUDP 0 by either 1 within 20 seconds after power up or 2 during reconnection serial port back to command mode or 3 by SMS see Chapter 6 2 AT command driven TCP UDP connection Why I see three OK coming after entering AT IPCONNECT 1 1 command The Software Tools program is issuing internal AT command for GPRS setup so extra OK responses will be seen After the TCP UDP connection is stopped I wan to enter AT OTCP or AT OUDP to reconnect but I get message CME ERROR 3 Why After TCP UDP socket connection the GPRS connection session will also be disconnected So please enter AT IPCONNECT 1 1 to reconnect GPRS first 3 Remote AT command by SMS Can I send any AT command by SMS to control other features described in this document Yes Please refer to Chapter 15 4 Command String Feature Are the status of Services settings and status will be saved when power is cut Besides Output Port Services all Services status will
9. Note set the TCP port to 23 AT IPTCP OK 23 C 202 144 111 222 0 Note to set the modem to connect TCP socket Client caller mode to target address 202 144 111 222 and port 23 AT IPTCP OK 23 S 255 255 255 255 0 to set the modem to wait for TCP socket connection request Server listening mode any calling IP address allowed port 23 AT IPTCP IPTCP 0 65535 C S 120 0 1 OK Note possible argument Defined Values lt port gt The port number has to be used for the TCP socket connection Default value is 0 Valid range is 0 to 65535 lt mode gt Mode of TCP operation Default value is S S Server Listening mode This configures Maestro Heritage to open a listening TCP connection on the specified lt port gt The TCP connection will be active upon getting socket connection request from the allowed remote TCP peer see lt address gt C Client caller mode This configures Maestro Heritage to request opening a TCP connection to the server with the specified lt address gt and lt port gt Note This parameter is used by Auto TCP connection see Chapter 4 only lt address gt The address of the TCP server or host Default value is empty Legal values could be 32 bit in dotted decimal notation i e XXX XXX XXX XXX or alphanumeric ASCII test string up to 120 characters only if DNS is available on the GPRS network Note In Server Listening mod
10. TCPTERM TCPTERM 1 7123456 23 30 Note display current status AT TCPTERM TCPTERM 0 1 16 1 65535 1 65535 OK Note possible argument Defined Values lt mode gt 0 1 2 disable TCP Terminal enable TCP Terminal configure TCP Terminal parameters lt psswd gt Login password for TCP Terminal When user opens the Heritage TCP Terminal port it will prompt password User need to enter the password set with this parameter User has 3 times of chance to enter correct password If password is correct user can enter AT command otherwise TCP connection will be closed It can be consisting 1 to 16 alphanumeric characters Default is 000000 6 zeros lt port gt Port number of TCP Terminal Please do not set to the same value of port number in IPTCP and IPUDP command Default is 23 Valid value is 1 to 65535 lt timeout gt Maximum time in second TCP terminal will wait for an entry after TCP terminal opened If no data received in this period the connection will be closed Default is 30 Valid value is 1 to 65535 Note If TCP terminal is enabled the Heritage will connect to GPRS IPCONNECT 1 1 about 15 seconds after power up Only one TCP terminal connection can be made at a time Any further connection requested will be refused Not all AT commands could be executed If un allowed command is entered command not allowed message will be returned Command echo feature is always en
11. be saved into non volatile memory so e g like Countdown timer will resume counting when power recover But all Output Ports will be set to logic 0 when power up Can I check the status out Output Ports No What should be noted with the execution priority of concatenated Command String During executing concatenated Command String if the 1 part of the CS leading to another no of the CS to be triggered then the triggered CS will be executed first e g CT LIN 1 CT 1 DE 1 If the first CS counter 1 increment by 1 will let the Counter 1 to trigger CS 2 then CS 2 will be executed BEFORE executing CT DE 1 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 62 t empowering wireless CHAPTER 19 EXAMPLES OF HERITAGE SOFTWARE SETUP AND OPERATION 1 To setup a Automatic TCP connection To setup Auto connect to TCP server with IP 61 167 60 1 port 23 client mode Commands to be entered Modem response AT IPGPRS 1 INTERNET OK APN is INTERNET AT IPCTP 23 C 61 167 60 1 1 OK target TCP is 61 167 60 1 port 23 client mode TxDelay is enabled AT AUTOTCP 1 OK open TCP socket connection TCP connection will start after 20 secs To setup Auto connect to remote TCP client request with any IP address port 23 server mode Commands to be entered Modem response AT IPGPRS 1 INTERNET OK APN is INTERN
12. by IPCONNECT as a tool to check Internet connection See AT IPOPT command in Chapter 3 for details 1 AT command for setting up and execute ping AT IPPING command Command Syntax AT SMSAT lt mode gt lt key gt AT IPPING lt mode gt lt address gt lt nb gt lt delay gt lt timeout gt Response syntax IPPING lt address gt time lt echo time gt Command Possible responses AT IPPING 2 210 103 11 18 3 1 15 OK Note configure ping target 210 103 11 18 3 ping trials total 1 second between each trial timeout limit 15 AT IPPING IPPING 210 103 11 18 time 562ms IPPING 210 103 11 18 time 662ms IPPING 210 103 11 18 time 762ms OK Note Execute ping action no argument AT IPPING IPPING 0 2 15 1 10 1 10 1 60 OK Note Possible arguements AT IPPING IPPING 210 103 11 18 3 1 15 OK Note Display current status Defined Values lt mode gt 0 1 reserved 2 configure ping address and parameters below lt address gt IP address of the target to be pinged Must be in form of dot decimal notation XXX XXX XXX XXX lt nb gt Numbers of ping trials for each ping action E g if the value is 3 will ping the target for 3 times Default value is 3 Valid range is 1 to 10 When used with IPCONNECT check the ping is assumed fail if all ping trails fail lt delay gt Time in second between e
13. e g TM 1 ST 100 means to set the value or countdown timer 1 to 100 seconds See further chapters for the explanation of each service 2 Concatenating Command String You can concatenate Command Strings update 128 bytes long totally including space They will be executed sequentially However if one Command String is incorrect or invalid execution will be stopped and successive Command Stings will not be executed For example TM 1 ST 100 TM 1 TR 99 TM 1 SW 1 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 48 t empowering wireless e First String TM 1 ST 100 will be executed e Second String TM 1 TR 99 will not be executed because 99 is out of range e Third String TM 1 SW 1 is correct but will not be executed because execution is stopped on 2 String 3 Entering and executing Command String You can use the following AT commands to store and execute Command String a AT CSTR command Description This command is used to execute a Command String directly Command Syntax AT CSTR lt string gt Response Syntax OK CME ERROR 3 Command Possible responses AT CSTR TM 1 ST 3 OK Note entire Command String executed successfully AT CSTR TM 1 ST 3 TM 30 ST 4 CME ERROR 3 Note one Command String cannot be executed Defined Values lt string gt Command String Note When there is error
14. is 32 characters AT IPDDNSUPD command Command Syntax AT IPDDNSUPD AT IPDDNSUPD lt auto_upd gt Response syntax OK IPDDNSUPD lt result gt lt ret code gt Command Possible responses AT IPDDNSUPD 1 OK Note enable automatic DDNS update AT IPDDNSUPD 0 OK Note disable automatic DDNS update AT IPDDNSUPD AT IPDDNSUPD AT IPDDNSUPD IPDDNSUPD 1 good 203 111 111 111 OK Note perform DDNS update successful IPDDNSUPD 3 badauth OK Note perform DDNS update unsuccessful IPDDNSUPD 3 badauth OK Note display current setting automatic DDNS update disabled result of last DDNS update since power up AT IPDDNSUPD IPDDNSUPD 0 1 OK Note Possible arguements Defined Values lt auto_upd gt 0 disable automatic DDNS update 1 enable automatic DDNS update see notes for details lt result gt result of DDNS update process it is related to the return code of DDNS update server if lt result gt is 1 or 2 the update is assumed successful lt ret_code gt return code of DDNS update server Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 32 empowering wireless Following table list the relationship between lt result gt and lt ret_code gt Result 1 2 3 4 5 6 7 8 9 10 11 Ret code good no chg bada
15. losing network connection Following items will be checked network registration periodic mode only triggering reset rom test signal strength can trigger reporting IP address of modem only when GPRS connection activated 1 AT command for Modem Status Check and Monitoring a AT TMODE command This command is to perform and setup modem status check and monitoring feature Command Syntax AT TMODE lt mode gt lt para gt Response syntax TMODE lt test1 gt lt test2 gt Command Possible responses AT TMODE TMODE 1 15 10 111 222 33 3814 OK Note execute status check one shot mode AT TMODE TMODE 0 4 15 Note possible argument AT TMODE TMODE 1 1234567 10 3500 OK Note display current setting AT TMODE 0 OK AT TMODE 1 OK Note disable periodic mode check Note enable periodic mode check AT TMODE 2 1234567 OK Note set telephone number for periodic mode reporting AT TMODE 3 10 OK Note set network signal trigger level for remote reporting AT TMODE 4 3450 OK Note set input voltage trigger level for remote reporting Defined Values lt mode gt 0 disable periodic mode check 1 enable periodic mode check 2 to set the number in lt para gt field as telephone number for periodic mode check reporting See section 7 1 2 for details 3 to set the number in lt para gt field as network signal trigger level for periodic
16. lt parameter gt is 1 and a TCP socket connected every 7200 seconds 2 hours an empty keep alive packet will be sent out from the modem to avoid socket being closed because of idle timeout 2 Specifies the maximum size of the outgoing packet to lt parameter gt The size can be set from 1 to 65535 OxFFFF default value is 65535 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 18 maestro empowering wireless 3 Specifies the TTL value of the socket connection to lt parameter gt The value can be set from 1 to 255 Default value is 128 4 Specify weather to use ping function to check Internet connectivity lt parameter gt is the period in second of calling ping function after GPRS connected IPCONNECT lt action gt to specify the action will be taken if a set of ping action fail 0 do nothing default 1 disconnect GPRS IPCONNECT 1 0 2 reset Maestro Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 19 t empowering wireless CHAPTER 4 AUTOMATIC AND SELF RECOVERY TCP UDP CONNECTION The Auto TCP UDP connection feature is defined for accessing serial devices over the Internet Heritage can be configured that after power up it will connect to a remote TCP UDP socket client mode or to wait for the TCP UDP socket connection request from remote peer server mode If the socket connection is unsu
17. peer Data coming towards UART will be buffered for a delay period before being sent out Command Syntax AT AUFCM lt delay gt Response syntax AUFCM lt delay gt Command Possible responses AT AUFCM 1 OK Note set the AUFCM value to 1 AT AUFCM AUFCM 2 OK Note display current status AT AUFCM AUFCM 1 255 Note possible argument Defined Values lt delay gt Default value 0 Possible value 1 to 255 Delay units between sending buffered data to TCP UDP peer The actual delay time is calculated by the value of lt delay gt times 18 5 ms So if lt delay gt is equal to 2 that means data will be sent to remote peer every 39ms or immediately if internal buffer is full Increasing this value can make the data packet size bigger especially when data flow is slow thus reducing overhead Note If the value is set too high the maximum data transfer speed may be decreased Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 24 t empowering wireless CHAPTER 5 AT COMMAND DRIVEN TCP UDP CONNECTION This feature let user to make a TCP or UDP connection upon the AT OTCP or AT OUDP command This socket connection feature does support DLE ETX character coding See 5 1 a The AT OTCP and AT OUDP operation is similar to AT OTCP and AT OUDP function provided original IP Connectivity See IP connectivity document Make sure you have mad
18. property of Maestro Wireless Solutions Limited t empowering wireless CHAPTER 2 HERITAGE PLUGIN SETUP AND COMMANDS Maestro Heriage allows different harware plug in boards to be conneted to the expansion slot to enhance functionality In software side there are commands to configure and control different plug in boards 1 Selecting Plug in AT HPLUGIN command Description This command is used to setup Heritage with individual hardware plug in board Command Syntax AT HPLUGIN lt type gt Response Syntax HPLUGIN lt type gt Command Possible responses AT HPLUGIN HPLUGIN 1 OK Note show current settings AT HPLUGIN 2 OK Note use plug in 2 CGPS AT HPLUGIN HPLUGIN 1 4 OK Note possible values Defined Values lt type gt Plug in type 1 TO plug in board default value 2 CGPS plug in board 3 reserved 4 Ethernet plug in board Note e After changing the lt type gt value the modem will reset immediately e Modem will not detect and check if HPLUGIN value match with actual plug in user should make sure entering is correct Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 2 AT commands for I O Plug in Board NOTE An optional I O plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for information For details please read the I O Plug in Board us
19. recommended to stop other Software Tools such as AutoTCP UDP connection during program downloading and updating Depending on the file size and network condition the download time could be a few minutes up to 30 minutes Be patient to wait for response after entering AT FTPDOTA command Do not use character on file path because it cannot be transferred correctly over SMS No resume function on FTP downloading The whole file has to be downloaded at one time otherwise the downloaded data will be discarded ce 99 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 46 t empowering wireless CHAPTER 13 COMMAND STRING INTRODUCTION Command String is a set of programmable scripts for Maestro Heritage mode User can input sets of Command Strings to control various kinds of Service Unlike AT command Command strings can be stored inside heritage and can be executed upon output of certain services 1 Command String and Service Concept eee gt Command String Command String ee ae ene Command String Trigger capable Stored in flash Services Non Trigger capable Services Command String and Service operation mechanism 1 Use AT command to enter preset Command Strings 2 Command strings can be executed upon power up or directly by AT commands 3 Executed Command Strings will drive some Services to b
20. Command String id to be executed if trigger 0 if not to trigger e Reading Input Pin Service Reading Enter AT CSTRSTAT IP 1 will get Input Port 1 info a Service id IP__1 _MS1_ DRO THS _TR3 b Mask value valid for multiple I P trigger c direction of detection d threshold value of the detection e Command String id to be executed if trigger 0 if not to trigger f Reading Device Power Control Service Enter AT CSTRSTAT PW 1 will get Device Power Control info PW 0 a Current Service id mode Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 60 t empowering wireless CHAPTER 17 KNOWN ISSUES The Heritage Softtools will affect certain other AT commands operation Please note 1 AT WIND command AT WIND command will be disabled 2 Saving of parameters to non volatile memory You cannot save the settings of the following AT commands by concatenating the amp W command AT CREG AT CGREG AT CGEREP To save the above settings please enter AT amp W separately 3 Mutually exclusive TCP UDP functions Following functions are exclusive to each other i e if either is enabled others could not be then AT AUTOTCP 1 AT AUTOUDP 1 AT OTCP 4 Sending Heritage Software commands over SMS You can use the remote AT command by SMS feature to send Heritage Software AT commands mentioned in this document except the followings AT OTCP AT OUDP AT
21. DP connection Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless b AT AOTCP command This command is sent by the attached host to open a TCP connection to the TCP server specified by the AT IPCTP command If socket connection is made successfully it will response CONNECT 115200 and the serial port will go to data mode all data entered to the serial port will be sent to remote TCP UDP peer If socket connection is unsuccessful or socket is disconnected afterwards the modem will send out NO CARRIER message and back to command mode Command Syntax AT OTCP Response syntax CONNECT 115200 Command Possible responses AT OTCP CONNECT 115200 Note TCP connection made successfully AT OTCP CME ERROR 3 Note fail either IPCONNECT is not ready or socket service is used already AT OTCP NO CARRIER Note possibly remote server no response Note AT OTCP connection is exclusive to other TCP feature See Chapter Q amp A If TCP connection is unsuccessful or broken after connection the GPRS connection will also be disconnected IPCONNECT 1 0 So please enter AT IPCONNECT 1 1 to reconnect GPRS before entering AT OTCP c ATtOUDP command This command sent by the attached host to open a UDP connection to the UDP server specified by the AT IPUDP command If socket connection is made successfully it will response CONNECT 115200 and t
22. ET AT IPCTP 23 C 255 255 255 255 OK 1 to accept TCP connection from any IP address port 23 client mode TxDelay is enabled AT AUTOTCP 1 OK open TCP socket connection Modem will start to monitor TCP port 23 after 20 secs 2 To make a AT command driven TCP connection IP Connectivity AT feature user can follow the following steps to make OTCP connection To connect to TCP server with IP 61 167 60 1 port 23 Commands to be entered Modem response AT IPGPRS 1 INTERNET OK APN is INTERNET AT IPCTP 23 C 61 167 60 1 1 OK target TCP is 61 167 60 1 port 23 TxDelay is enabled AT DLEMODE 1 OK AT CGATT 1 OK AT IPCONNECT 1 1 OK OK GPRS connection OK AT OTCP CONNECT 115200 open TCP socket connection Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 63 t empowering wireless 3 To setup periodic ping To setup to pin an IP address every 30 minutes disconnect GPRS if fail Commands to be entered Modem response AT IPGPRS 1 INTERNET OK APN is INTERNET AT IPPING 2 61 167 60 1 3 2 15 OK ping is 61 167 60 1 no of trial is 3 delay between pin is 2 secs timeout is 15 secs AT IPOPT 4 1800 1 OK enable Ping every 1800secs if ping fail then disconnect GPRS 4 To setup TCP Terminal and Dynamic DNS automatic update Open TCP Terminal wi
23. K Note Set IPBUFF value to 5 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 17 t empowering wireless Defined Values lt buff gt The number of bytes of data to be buffered Default value is 0 i e no buffering Valid range is 0 to 100 Note If the TCP or UDP socket connection is broken buffered data will be lost 3 Extra TCP UDP Parameters Setup User can set additional parameters of TCP UDP connection including keep alive packet maximum packet size and TTL AT IPOPT command This command specifies the extra TCP UDP socket parameters Command Syntax AT IPOPT lt CMDType gt lt parameter gt action gt Response Syntax IPOPT lt CMDType gt lt parameter gt lt action gt Command Possible responses AT IPOPT IPOPT 1 0 IPOPT 2 536 IPOPT 3 64 IPOPT 4 0 0 OK Note display current settings AT IPOPT 1 1 OK Note enable the keep alive packet feature AT IPOPT 2 512 OK Note set the size of maximum packet that to be sent to 512 bytes AT IPOPT 3 128 OK Note set TTL to 128 AT IPOPT 4 60 1 OK Note Enable Ping action every 60 seconds if ping fail then disconnect GPRS AT IPOPT IPOPT 1 4 0 65535 0 2 OK Note possible argument Defined Values lt CMDType gt 1 setup keep alive packet feature When lt parameter gt is 0 the feature is disabled When
24. T 1 TO Initial value of Countdown Timer 2147483647 in seconds SW O0TO1 Start 1 or Stop 0 Timer TR 1 to 50 Set Command String to be run 0 0 to cancel setting Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 52 t empowering wireless Example Set Countdown Timer 1 to execute Command String 10 and start 600 seconds countdown TM 1ST 600 TM 1SW1TM1 TR 10 Example Stop Countdown Timer 1 TM 1SW0 Example Cancel Countdown Timer 1 to trigger Command String T 1 TRO Note e When the Countdown Timer expires reach 0 it will stop automatically SW 0 e Iftwo or more Timers expire at the same timer Timer with smaller id has higher priority i e Command String related to that Timer will be executed first e These are not precision Timers if the Modem is busy e g with network communication The execution time may be delayed b Reading Countdown Timer status See Chapter 16 for details 4 Input Port Service NOTE An optional I O plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for information Input Port Service can use the signal of I O board s input ports to control the execution of Command String You can control the change of single or multiple Input Port signals as a condition to trigger Command String execution a Input port Service Command String Syntax and explanation 1 fiel
25. T is enabled the modem will read each incoming SMS if the conditions mentioned in 1 are matched the message will be executed even it is an invalid AT command 7 When using SMSAT feature only CNMI x 1 x x x setting could be used i e incoming message will be stored in SIM card 8 The maximum length of the AT command is limited by length of SMS i e 160 6 154 characters 9 When the SMS AT command is executed all intermediate and final responses will be buffered recorded then return to the sender s phone number in one single SMS 10 Ifresponse s of the AT command is are more than 160 characters only the first 160 characters will be returned 11 Incase the modem cannot get terminal response within 26 seconds the modem will then abort the command and return intermediate responses if present 12 Ifthe SMSAT feature is enabled all incoming SMS either with valid AT command or not will be erased This is to prevent SIM card memory from fully filled such the modem will not receive new SMS Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 36 t empowering wireless 4 AT command for configuring AT command by SMS AT SMSAT command Command Syntax AT SMSAT lt mode gt lt key gt Response syntax SMSAT lt mode gt lt key gt Command Possible responses AT SMSAT 0 OK Note disable remote AT command by SMS AT SMSAT 1 OK E
26. abled except entering password Unsolicited codes like RING CMTT etc will not be displayed on TCP terminal Never send interactive AT command by SMS e g AT CMGS This feature cannot return the prompt to the sender for second input Always think twice before you send AT command For example if you send AT CPOF it will turn off the modem and you need to go to access the modem to reset it Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless CHAPTER 9 REMOTE AT COMMAND BY SMS This feature is to control the modem to interpret AT command from incoming SMS executing it and return the result to sender by SMS The user can enable the modem to receive AT command by incoming SMS See following about AT SMSAT command 3 Description of the operation Step 1 send AT command to modem by SMS 000000AT CSQ i T Step 2 modem execute and return response by SMS CSQ 17 0 OK 5 When enabled the modem will treat the incoming SMS as a source of AT command only if all of the following conditions a b and c are fulfilled a The content of SMS sent to the modem is using standard 7 bit GSM data decoding scheme b The first 6 characters of the SMS content matches the lt key gt parameter set by Aiea command default key is 000000 c The 7 and 8 characters of the SMS content is AT in capital letters 6 If SMSA
27. ach ping trial Default value is 3 Valid range is 1 to 10 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 28 maestro empowering wireless Note Ping target must be in dot decimal notation format URL format is not supported Before making command driven ping action AT IPPING w o argument make sure GPRS is connected IPCONNECT 1 1 and ping target and parameters are set properly Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 29 tr empowering wireless CHAPTER 7 DYNAMIC DNS To use this feature we strongly suggest to get special GPRS service from your network operator Network will assign a true public IP address to Heritage upon GPRS activations and b that GPRS connection allows incoming access from public Internet to Heritage This feature lets Heritage to login to certain Dynamic DNS service providers to update the hostname with Heritage current IP address So user can access Heritage with pre registered hostname User can use this function together with TCP Terminal see Chapter 8 and can use Telnet to access Heritage and send AT command over Internet Maestro Wireless Solution Ltd does not have affinity with any Dynamic DNS service providers Maestro Wireless Solution Ltd does not guarantee any service provided by DDNS service providers and not liable to any loss or damage
28. and driven TCP connection 0s000e 63 3 To setup periodic PING ssssssssrssrsssensnnssssnennnsnennnrsssenens 64 4 To setup TCP Terminal and Dynamic DNS automatic update 64 5 Perform Remote program update by sending Command over SMS egian eea e EE E E R KETTES 65 6 COMMAND STRING PROGRAMMING EXAMPLE 20000008 65 7 COMMAND STRING PROGRAMMING EXAMPLE 00e00eee 65 CHAPTER 20 COMMAND STRING QUICK REFERENCE s sssssssssssnnnnennnnenne 66 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless CHAPTER 1 INTRODUCTION Heritage Software Tools is a set of software solutions for Maestro Heritage modem New functions added to increase application range of various industrial and automated applications AT commands specific for individual plug in boards Automatic and self recovery TCP UDP socket connection AT command driven TCP UDP socket connection Ping Service Dynamic DNS note Remote AT command through SMS and TCP Terminal note Call screening reject call made by unauthorized phone number Modem status check and monitoring Remote program updating Command String programming scripts Remote program updating Users can configure and use the above features by following this document Note Special GPRS service from network recommended See Chapter 7 and 8 for details Confidential the whole present document is the sole
29. and version will be displayed Command Syntax AT ADINSTALL Response syntax ADINSTALL lt result gt lt ver gt Command Possible responses AT ADINSTALL ADINSTALL 2 HERITAGE_090b_OAT422a_32 Feb 26 200811 42 36 Note update successful show existing program version AT ADINSTALL ADINSTALL 3 HERITAGE_090a_OAT422a_32 Jan 26 200811 42 36 Note update unsuccessful show existing program version AT ADINSTALL CEE ERROR 3 Note update unsuccessful no update file available Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 45 empowering wireless Defined Values lt result gt 2 update process successful 3 update process unsuccessful original program will be loaded Note for other result code please contact Maestro Wireless Solutions lt ver gt Version number of existing running Software Tools d Notes and cautions to be taken This feature is ONLY for updating new program for Heritage Do not use it for downloading other things Always contact Maestro Wireless or distributor for correct update file and information If you want to perform update for modem at remote site by AT command over SMS make sure the feature is enabled by command AT SMSAT 1 is entered Make sure you have setup GPRS settings by AT IPGPRS command When entering AT FTPDOTA command the program will make GPRS connection automatically if not connected before It is
30. caused by such service 1 Description of the Operation p DNS service Dynamic IP 200 123 111 21 lt gt a eS 111 21 1 User need to create an account on DDNS service iai and register a hostname Following providers are tested working correctly www dyndns com www no ip com 2 Use AT IPDDNSSERV command to enter DDNS update server URL and port no Use AT IPDDNSACCT to enter own account login password and hostname 3 When IPCONNECT is ready use AT IPDDNSUPD command to update the above hostname with modem s current IP address 4 User can also use AT IPDDNSUPD command to configure automatic DDNS update upon each time of IPCONNECT established Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 30 t empowering wireless 2 AT command for configuring Dynamic DNS AT IPDDNSSERV command Command Syntax AT IPDDNSSERV lt serv_url gt lt serv_port gt Response syntax IPDDNSSERV lt serv_url gt lt serv_port gt OK Command Possible responses AT IPDDNSSERV members dy OK ndns org 80 Note enter DDNS service provider s update server information AT IPDDNSSERV IPDDNSSERV members dyndns org 80 OK Note display current status AT IPDDNSSERV IPDDNSSERV 64 0 65535 OK Note Possible arguements Defined Values lt serv_url gt URL of the update server For example it is members dyndns org for ww
31. ccessful or disconnected it will repeat the connection request and back to waiting stage This make remote peer can access serial device connected to Maestro Heritage Direct serial connection RS 232 cable TCP Socket connection via the Internet GPRS network Broad band ee A RS 232 cable l Fixed IP GN 123 456 789 0 N 00 partie evercieci cers Satieiee cect scoccoscecscS i Program monitoring Auto TCP connection set to connect Port 23 123 456 789 0 port 23 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 20 empowering wireless 1 Flow diagram of Auto TCP UDP connection function odem Power on restart Is AutoTCP UDP enabled Wait for 20 secs Stop LY i Re attach GPRS i Re activate GPRS CP UDP connection request from allowed peer Open TCP UDP socket connect to serial port m TCP UDP disconnected or closed ctivation il No OK to open pre defined TCP UDP socket y Open TCP UDP socket connect to serial port TCP UDP disconnected or closed ctivation il Dealy 2 seconds No Confidential the whole present document is the sote property of Maestro Wireless Solutions Limited 21
32. cel 1 Alarm setting AL1ST0 Example Cancel 1 Alarm executing Command String AL1TRO Note e The Alarm date time input MUST to fulfill the following requirements 1 In yy mm dd hh mm ss format program will also check if input date time is valid or not 2 At least 4 minutes later than current modem s real time clock time check by AT CCLK command e Do not concatenate after ST operation set time operation should be at the last part of Command String e After alarm time the ST setting of that Alarm will be lost e This service will make use of Heritage internal alarm command AT CALA so please avoid using AT CALA command by yourself when Alarm Service is used e Ifthe modem is restarted date time setting of each Alarm will be checked against real time clock time If time is passed the setting will be cancelled e Alarm Service is one shot type There is no periodic alarm like daily or weekly b Reading Alarm Service status See Chapter 16 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 2 Counter Service Counter is used to execute a Command String when the Counter value equals a preset value There are total of 5 Counters a Counter Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Service Service id Operation Operation Explanation type type argument CT 1
33. d 2 field 3 field 4 field Explanation Service Service id Operation Operation type type argument IP 1 to 6 DR Otol Direction of I P signal change 101 to 106 if IP is 1 to 6 to trigger 1 TO 63 Binary sum value of mulitiple if IP is 101 to I P to trigger 106 MS 1 TO 63 Mask value to select multiple I Ps for triggering TH 1 to 255 Duration of the I P state to trigger unit in O 1s TR 1 to 50 Set Command String to be 0 run 0 to cancel setting Example Configure Input Port 1 with detection high to low and threshold value 0 1s and trigger Command String 5 if signal condition match IP1DR1IP1THIIP1TRS5 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 53 empowering wireless Example Configure Input Port 4 is high and Port 6 is low and threshold value 0 1s and trigger Command String 5 if signal condition match IP 101 MS40 DR8 IP 101 TH 1 IP 1 TR5 Example cancel Input Port 1 to trigger Command String IP1TRO b Input Port operation mechanism single I P triggering DC voltage to Input Port 5 32V logic 1 high ov logic O low I O board plug in The Input Port will give out a high or low signal depending on the input voltage to the port The Command String can check the change of Input port Signal operation DR IP 1 DR 0 gt detect a low to high input voltage change IP 1 DR 1 gt detect a high to low in
34. d hh mm ss Date time 0 to cancel TR 0 to 50 CS to trigger 0 to cancel COUNTER CT Service ld Operation Type Argument and Explanation 1 to 5 DE 1 to 255 Decrement IN 1 to 255 Increment RS 0 Reset ST 32768 to 32768 value to trigger TR 0 to 50 CS to trigger 0 to cancel COUNTDOWN TIMER TM Service ld Operation Type Argument and Explanation 1 to 10 ST 1 to 2147483647 Timer initial value SW O to 1 stop or start timer TR 1 to 50 CS to trigger 0 to cancel INPUT PORT IP Service Id_ Operation Type Argument and Explanation 1 to 6 DR 0 to 1 1 63 trigger direction or I P sum 101 106 MS 1 to 63 CS to trigger Id 101 106 only TH 1 to 255 Duration state to trigger unit in 0 1s TR 1 to 50 CS to trigger 0 to cancel OUTPUT PORT OP Service Id Operation Type Argument and Explanation 1 to 6 SW 0 to 1 state of Output port SMS SM Service Id Operation Type Argument and Explanation 1 to 10 SN SMS CONTENT variable CTn counter value IP input port value TMn countdown timer value DEVICE POWER CONTROL PW Service ld Operation Type Argument and Explanation 0 to 15 1 dummy 1 dummy Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited
35. e Operation at Telnet 352061000294955 dyndns org Connect Edit Terminal Help password correct at cgsn OK attuafy OK 3520610090294955 y M166_UAF_695_0AT316_32 May 4 200917 49 33 aS Telnet Terminal 1 Uses AT TCPTERM command to configure password port for the TCP terminal and enable TCP terminal function 2 After about 20 seconds Heritage will connect to the Internet automatically And then it will check the TCP port 3 User from outside Internet can use Telnet application to connect the port of Heritage TCP terminal User need to know the IP address of the Heritage Or with the aid of Dynamic DNS Chapter user can use the hostname associated the Heritage for connections 4 Once connected user need to enter password If password is correct user can send AT command to the Heritage on Telnet program 2 AT command for TCP Terminal AT ITCPTERM command Command Syntax AT TCPTERM lt mode gt lt psswd gt lt port gt lt timeout gt Response syntax TCPTERM lt stat gt lt psswd gt lt port gt lt timeout gt OK Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 34 t empowering wireless Command Possible responses AT TCPTERM 2 123456 23 3 OK 0 Note configure TCP Terminal password 123456 port 23 timeout 30 secs AT TCPTERM 1 OK Note enable TCP terminal AT TCPTERM 0 OK Note disable TCP terminal AT
36. e done e g sending SMS or setting output pins 4 Executed Command Strings can also configure and control some Services that have trigger capability 5 These Services when a certain pre defined H PEN f gt condition is matched e g timer reach zero can trigger a stored Command String 6 Execute stored Command String to control Services again Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 47 t empowering wireless CHAPTER 14 COMMAND STRING WRITING AND USING 1 Structure of Command String A single Command String is a text string composed with four fields for example TM 1ST 100 Service typ Operation argument Service id lt Operation type Each field is separated by a space ascii value 32 a Service type This field has two capital characters indicates the type of Service to be chosen Field AL CT TM IP OP SM entry Service alarm Counter oun aon BUS y Output SMS timer ports ports See 13 1 13 2 13 3 13 4 13 5 13 6 Chapter Services need optional I O plug in board See further chapters for the explanation of each service b Serivce Id Each type of Service there has more than one unit e g there are 5 counters available so the id range is to 5 c Operation type and Operation argument For each type of Service there are few kinds of operations
37. e the GPRS connection by AT IPCONNECT command before making socket connection see Chapter 17 setup examples 1 AT commands for Auto TCP UDP connection a AT DLEMODE command When performing the AT command driven TCP or UDP socket connection the attached host has the choice to code or not the ETX character When DLEMODE is set to 0 no specific process is needed on ETX characters It means that it is not possible for a host to request a end of connection or to receive a clear indication of end of connection from the TCP IP stack When DLEMODE is set to 1 the ETX character means a request or an indication of end of connection As a consequence ETX characters that belong to the payload data must be sent by the host on the serial port preceded by a DLE character Similarly ETX characters received by the TCP IP stack from the Internet are sent to the host through the serial port preceded by a DLE character ETX is character hex 03 DLE character is hex 10 Dec 16 Default value is 0 Command Syntax AT DLEMODE lt mode gt Response syntax DLEMODE lt mode gt Command Possible responses AT DLEMODE 0 OK Note disable DLEMODE AT DLEMODE 1 OK Note Enable DLEMODE AT DLEMODE DLEMODE 1 OK Note display current status AT DLEMODE DELMODE 0 1 Note possible argument Defined Values lt mode gt 1 enable DLEMODE 0 disable DLEMODE Note DLEMODE is not available for Automatic TCP U
38. e the modem will only accept TCP connection request for the caller with address specified in the lt address gt field Yet if it is set to 255 255 255 255 the modem will accept request from ANY address lt TCPTxDelay gt This parameter determines if there is time delay introduced before sending a TCP frame that has not been entirely filled with user data If it is set to 0 initiates the sending of a TCP frame as soon as possible after the reception of a single character value from the host If it is set to 1 initiate a delay will be introduced before the sending of a TCP frame The default value is 0 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited LS t empowering wireless b AT IPUDP command This command specifies the UDP socket parameters and mode that to be used by automatic or AT command driven UDP connection described in Chapter 4 and 5 Command Syntax AT IPUDP lt port gt lt mode gt lt server gt lt UDPTxDelay gt Response Syntax IPUDP lt port gt lt mode gt lt server gt lt UDPTxDelay gt Command Possible responses AT IPUDP IPUDP 0 S 0 OK Note show current settings AT IPUDP 23 OK Note set the UDP port to 23 AT IPUDP OK 23 C 202 144 111 222 0 Note to set the modem to connect UDP socket Client caller mode to target address 202 144 111 222 and port 23 AT IPUDP OK 23 S 255 255 255 255 0 to set t
39. ecscsecescscacnccestwrcdsusstedecsad asexs 45 d Notes and cautions to be taken sssssssssssssrrrrssssrrrrsssssnns 46 CHAPTER 13 COMMAND STRING INTRODUCTION ccccccseseeesseeseeeeeees 47 1 Command String and Service Concept cceee cence eeeee eens 47 CHAPTER 14 COMMAND STRING WRITING AND USING cccseeseeeeeee 48 1 Structure of Command String scsec cies edivins deste ccaseveevies cede 48 Ge SEVICE YPE vias ciawenecorsriaes a ee EE 48 D Serivce Id s2ccsescecccdueesansepceadeasesedenscasen eden seardareacneneansaaceens 48 c Operation type and Operation argument ccseceeeee eee eee 48 2 Concatenating Command String cceeeceeee eee ee eeeeeeeeaee eee 48 3 Entering and executing Command String ccceceeeeenee eee 49 a AT 4CSTR COMMAN Gesics cies scewracieisabicins vedecisesteecs sees eeaaad eens 49 b Al CS I RSET COMMON sccceatsavencucererasaeierasaraercxccaneananaesens 49 CHAPTER 15 COMMAND STRING SERVICES cccseeseeeeeeeeeeseeeeseeeeeeeeees 51 1 Alarm Service is es deeds ore gart ae ebeeredee essa Geadecedensenibeccesenete 51 a Alarm Service Command String Syntax and explanation 51 b Reading Alarm Service statuS sssssssssrsrssrrrrrrrenrrrrrrssnn 51 2 Counter SErvViCe crs risrisini ia a aE 52 a Counter Service Command String Syntax and explanation 52 b Reading Counter Service StatuS ssssrsssrrrrrrrrrrrrrrrrrnrns 52 3 Countdown Timer Service
40. ed t empowering wireless Command Possible responses AT IOBW 111111 OK Note set all six output pins to value 1 AT IOBW 000001 OK Note set Output pins 1 to 5 to 1 6 to 0 AT IOBW 6 0 OK Note set Output pin 6 to O others not changed Defined Values lt pin gt ID of the Output Pin to be set Valid value is from to 6 lt val gt Value output value of the pin to be set 0 Output Pin is opened 1 Output Pin is closed shorted Note 1 You can only set one of six or all six Output Pins at one command 2 To set all six Output Pins at one time enter command with a set of six digits only 0 or 1 is allowed to set the Output Pin of 1 to 6 respectively 3 Always read I O Plug in Board user manual before wiring to avoid permanent damage to the board 3 AT commands for CGPS Plug in Board NOTE An optional C GPS plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for information For details please read the C GPS Plug in Board user guide a AT NMEA command This command is set if NMEA frames should not be sent out to com port or not Command Syntax AT NMEA lt val gt Response syntax NMEA 1 Command Possible responses AT NMEA 1 OK Note enable NMEA frames to be sent AT NMEA INMEA 1 OK Note read current value AT NMEA INMEA 0 2 OK Note possible values Def
41. en time to time 4 AGPS operation is silent e g if GPRS is not available it will not should any messag 5 User can use AT AGPSSTATUS command to check current AGPS status f AT GPSPOS command This command allows to get the last position information received Command Syntax AT GPSPOS Response syntax GPSPOS lt fix gt lt time gt lt date gt lt latitude gt lt longitude gt lt altitude gt lt hdop gt lt speed gt lt course gt lt nbsat gt Command Possible responses AT GPSOPS GPSPOS 1 225454 192294 4916 45N 12311 12W 111 1 0 9 25 5 180 0 06 OK Note see defined values AT GPSPOS GPSPOS 1 0 OK Note see defined values Defined Values lt fix gt 0 Invalid Fix 1 2D fix 2 3Dfix 1 Itis not possible to define a position lt time gt hhmmss time of fix ranges of values hh hour 00 to 23 mm minute 00 to 59 ss second 00 to 59 Example 225454 means 22 54 54 UTC lt date gt ddmmyy date of fix ranges of values dd day 01 to 31 mm month 01 to 12 yy year 2000 to 2099 Example 191194 means November 19th of 1994 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 11 t empowering wireless lt latitude gt ddmm mmmm N S _ ranges of values dd degree 00 to 90 mm mmmm minute 00 0000 to 59 9999 N S North or South Example latitude of the fix 4916 45N means 49 degree 16 45
42. ent Defined Values lt id1 gt Beginning location of the authorized phone number to be read Valid range is from 1 to 10 lt id2 gt Ending location of the authorized phone number to be read Valid range is from to 10 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless d AT CSND command This command is to erase authorized phone number entered Command Syntax AT CSND lt id1 gt lt id2 gt Response syntax CSNR lt id gt lt num gt Command Possible responses AT CSND 1 OK Note erase authorized number in location 1 AT CSNR 1 8 JOK Note erase authorized number in from location 1 to 8 AT CSND CSND 1 10 1 10 OK Note possible argument Defined Values lt id1 gt Beginning location of the authorized phone number to be erased Valid range is from 1 to 10 lt id2 gt Ending location of the authorized phone number to be erased Valid range is from 1 to 10 AT CSRN command Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless CHAPTER 11 MODEM STATUS CHECK AND MONITORING The Modem Status Check and Monitoring feature makes the modem can check the status of the modem in either one shot or periodic per minute mode Modem will also report check result by SMS if result is beyond preset limit and reset automatically if
43. er guide a AT lIOBR command This command is to read the value of one or all six of Input Pins on the I O plug in board Command Syntax AT IOBR lt pin gt Response syntax IOBR lt val gt lt val gt lt val gt lt val gt lt val gt lt val gt IOBR lt pin gt lt val gt Command Possible responses AT IOBR IOBR 000000 OK Note read all six input pins values AT IOBR 1 IOBR 1 0 OK Note read the value of input pin 1 AT IOBR IOBR 1 6 OK Note possible values Defined Values lt pin gt ID of the Input Pin to be read Valid value is from 1 to 6 If omitted all six Input Pins will be read lt val gt Current value status of the Input Pin 0 input signal not detected 1 input signal detected Note 1 Ifno lt pin gt argument is entered then all six Input Pins values will be read and the result is displayed as six 0 or 1 representing the value for input 1 to 6 from left to right 2 Always read I O Plug in Board user manual before wiring to avoid permanent damage to the board b ATtIOBW command This command is to set write the value of one or all six of Output Pins on the I O plug in board Command Syntax AT IOBW5 lt val gt lt val gt lt val gt lt val gt lt val gt lt val gt AT IOBW lt pin gt lt val gt Response syntax OK Confidential the whole present document is the sole property of Maestro Wireless Solutions Limit
44. estimate FACTCOLD start with Factory Defaults instead of previous run data almanac data no drift estimate SIMCOLD start with no change to previous run data area needed for Simulator runs Note 1 The argument will be saved automatically and CGPS will be restarted automatically after power off on cycle To prevent CGPS start running on next power up please use AT CGPSSTOP command c AT CGPSSTOP command This command is to stop running CGPS Plug in Board Command Syntax AT CGPSSTOP Response syntax OK Command Possible responses AT CGPSSTOP OK Note stop running CGPS Plug in AT CGPSSTOP CGPSSTOP STATE IS OFF OK Note check current CGPS state Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless Note 1 This command will stop CGPS clock and next CGPS start need to be WARM or COLD type If want to re start CGPS with HOT option please use AT CGPSSTANDBY command d AT CGPSSTANDBY command This command is to set CGPS Plug in Board in standby mode This consumes slightly more power but allows for faster restarts when the CGPS plug in is restarted with the CGPSSTART command Note when doing a HOT start see CGPSSTART command the previous session should be stopped with this command Command Syntax AT CGPSSTANDBY Response syntax OK Command Possible responses AT CGPSSTANDBY OK Note set CGPS Plu
45. et by AT TMODE 2 xxxxxxx max number of digit is 20 If the result of the input voltage is lower than the setting of AT TMODE 4 x the test result will be sent over SMS to the telephone number set by AT TMODE 2 xxxxxxx If 3 consecutive checks fail i e 3 SMS sent then the periodic mode check will be disabled automatically Network signal trigger level range is from 1 31 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 42 t empowering wireless CHAPTER 12 REMOTE PROGRAM UPDATE By using this feature user can download the new version of Maestro Heritage program from a FTP server and upgrade the program By combining Remote AT command by SMS feature user can control the Maestro to complete the program downloading and updating process remotely Download file from FTP server AT commands to start download and update fe een ate ee eee oe sea i i AT IPFTP 21 A I 123 456 789 id pwd i AT FTPDOTA new_prog dwl 1 I To perform the whole program update process several AT commands steps have to be sent 1 AT IPGPRS to set network parameters APN 2 ATHPFTP to set FTP server parameters name user id password 3 AT FTPDOTA to set filename and FTP path and start downloading 4 AT ADINSTALL to install the downloaded new program Note by adding one extra parameter after step 3 complete step 4 will be executed automatically See following
46. g in in standby mode AT CGPSSTANDBY CGPSSTANDBY IN STANDBY MODE OK Note check current CGPS standby state Note 2 This command will NOT stop CGPS clock and next CGPS start can HOT type faster to fix If want to stop CGPS to save more power please use AT CGPSSTOP command e AT AGPS command This command is to enable or disable using AGPS feature for faster GPS fix When enabled Heritage will use GPRS service to download Satellite data thru Internet about 3Kbyte each time to shorten GPS fix time Make sure the IPGPRS setting Is properly set before using AGPS feature Command Syntax AT AGPS lt val gt Response syntax OK Command Possible responses AT AGPS 1 OK Note enable AGPS feature AT AGPS 1 OK Note disable AGPS feature AT AGPS AGPS 1 OK Note check current APS standby state Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 10 t empowering wireless Defined Values lt val gt 0 AGPS is disabled 1 AGPS is enabled Note 1 The AGPS setting should be made before starting running CGPS by CGPSSTART command 2 Make sure the GPRS service is available and the IPGPRS setting is properly set 3 The program will self control the AGPS functionality Once AGP is needed it will try downloading new satellite data about 3Kbytes thru GPRS The need of downloading is determined by internal program and may be tak
47. gs with lt cid gt 1 Once AutoUDP is enabled it will start the UDP socket connection automatically after 20 seconds Once the UDP connection is established successfully the serial port will go to data mode all data entered to the serial port will be sent to remote UDP peer No more AT commands will be accepted then In UDP connected data mode the DSR and DCD signals of the serial port will go to high If the UDP connection is broken the modem will try to reconnect automatically During re connection period serial port will go back to command mode and DSR DCD signal back to low The setting will be saved and after power off the AUTOUDP will be restarted with the 20 seconds delay after power up To stop auto UDP connection you need to enter the command AT AUTOUDP 0 by 1 within 20 seconds after power up or 2 during reconnection serial port back to command mode or 3 by SMS see Chapter SMS AT command Auto TCP connection is exclusive to other TCP UDP feature See Chapter 18 Q amp A Due to the nature of UDP socket connection AT AUTOUDP 0 may not be able to disconnection in this case you may send command AT IPCONNECT 1 0 to disconnect GPRS connection Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 23 t empowering wireless 3 AT commands for tuning Auto TCP UDP connection AT AUFCM command This command controls the buffering time of TDP UDP data sent to remote
48. he modem to wait for UDP socket connection request Server listening mode any calling IP address allowed port 23 AT IPUDP IPUDP 0 65535 C S 120 0 1 OK Note possible argument Defined Values lt port gt The port number has to be used for the UDP socket connection Default value is 0 Valid range is 0 to 65535 lt mode gt Mode of UDP operation Default value is S S Server Listening mode This configures Maestro Heritage to open a listening UDP connection on the specified lt port gt The UDP connection will be active upon getting socket connection request from the allowed remote UDP peer see lt address gt C Client caller mode This configures Maestro Heritage to request opening a UDP connection to the server with the specified lt address gt and lt port gt Note This parameter is used by Auto UDP connection see Chapter 3 only lt address gt The address of the UDP server or host Default value is empty Legal values could be 32 bit in dotted decimal notation i e xxx xxx xxx xxx or alphanumeric ASCII test string up to 120 characters only if DNS is available on the GPRS network Note In Server Listening mode the modem will only accept UDP connection request for the caller with address specified in the lt address gt field Yet if it is set to 255 255 255 255 the modem will accept request from ANY address Confidential the whole present doc
49. he more of Command Strings the less of SMS length 7 Device Power Control Service By using Device Power Control Service user can control on off state of certain component of the Heritage in order to save power consumption A single Service id field can be set to control four parts of the Heritage a Device Power Control Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Service Service id Operation Operation Explanation type type argument PW 0 to 15 don t don t Service Id to decide componets care care on off state Example Enable low clock mode and disable LEDs PW 300 Example Enable low clock mode disable LEDs UART and deregister from Network PW 1500 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 57 t empowering wireless The value of Service Id is the sum of the values each of which is related to a particular Device Power Control operation value Function Remark Turn off LEDs except network status LED Enable power down mode W32K mode Same as AT W32K 1 command co N Deregister from network Flight mode Same as AT COPS 2 command Turn off UART Com port will not get any data The larger the id value of PW the more power saving of the Heritage For example user can set e g the Heritage to register to network only once per day sending out SMS the
50. he serial port will go to data mode all data entered to the serial port will be sent to remote UDP peer If socket connection is unsuccessful or socket is disconnected afterwards the modem will send out NO CARRIER message and back to command mode Command Syntax AT OUDP Response syntax CONNECT 115200 Command Possible responses AT OUDP CONNECT 115200 Note UDP connection made successfully AT OUDP CME ERROR 3 Note fail either IPCONNECT is not ready or socket service is used already AT OUDP NO CARRIER Note possibly remote server no response Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 26 maestro empowering wireless Note e AT OUDP connection is exclusive to other TCP UDP feature See Chapter 18 Q amp A e If UDP connection is unsuccessful or broken after connection the GPRS connection will also be disconnected IPCONNECT 1 0 So please enter AT IPCONNECT 1 1 to reconnect GPRS before entering AT OUDP e Due to the nature of UDP socket connection sending ETX characters when DLEMODE is 1 may not be able to make disconnection Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 27 t empowering wireless CHAPTER 6 PING SERVICE This feature is to make a ping ICMP Echo Request to a specified IP address and get back the echo result Ping service can also be called
51. in between concatenated Command String CME ERROR 3 will be returned See 2 2 b AT CSTRSET command Description This command is used to store read and delete Command String It can also used to execute stored Command String Command Syntax AT CSTRSET lt oper gt lt id gt lt string gt Response Syntax OK CME ERROR 3 Command Possible responses AT CSTRSET 0 1 TM 1 ST 3 JOK Note store Command String with String id 1 AT CSTRSET 0 99 TM 1 ST 3 CME ERROR 3 Note id out of range AT CSTRSET 1 1 CSTRSET 1 TM1 ST 3 Note read stored Command String id 1 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 49 empowering wireless AT CSTRSET 3 1 OK Note execute stored Command String id 1 AT CSTRSET 2 1 OK Note erase Command String id 1 from flash memory AT CSTRSET 3 1 CME ERROR 3 Note id 1 is empty Defined Values lt oper gt Define type of operation 0 store Command String to flash 1 read Command String from flash 2 erase Command String from flash 3 execute Command String stored in flash lt id gt Identification number id of the Command String Valid value is 1 to 50 and 80 i e e upto 51 Command Strings can be stored e Command String with id 80 will be executed when modem power up lt string gt Command String Note e Each Command String is limited to 128 by
52. ined Values lt val gt 0 no NMEA frames will be sent out 1 NMEA frames will be sent out to the com port 2 reserved Note 1 You can only set the NMEA value BEFORE starting the CGPS Plug in otherwise you will get error message See section of CGPS command for starting CGPS Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 2 The command will not check if CGPS Plug in is present or not NMEA frames will come out a while after CGPS is started If no CGPS Plug in present no NMEA frame will be come out b AT CGPSSTART command This command is to start running CGPS Plug in Board Command Syntax AT CGPSSTART lt type gt Response syntax OK Command Possible responses AT CGPSSTART OK Note start running CGPS Plug in default is HOT start AT CGPSSTART COLD OK Note start running CGPS Plug in COLD start AT CGPSSTART CGPSSTART HOT WARM COLD FACTCOLD SIMCOLD AGPSON AGPSOF F OK Note possible values AT CGPSSTART CGPSSTART HOT AGPSON OK Note read current value Defined Values lt type gt HOT start with all previous run data previous run should end with AT CGPRSSTANDBY command this will expect the fastest fixing WARM start with previous run data except position sigma is high prev run should end with AT CGPSSTOP command COLD start with NO previous run data except drift
53. le property of Maestro Wireless Solutions Limited 38 t empowering wireless Command Possible responses AT CSNW 1 12345678 OK Note enter authorized number to location 1 AT CSNW 11 12345678 CME ERROR 3 Note location out of range AT CSNW 3 1qaaa CME ERROR 3 Note non numeric characters not allowed AT CSNW CSRN 1 10 20 Note possible argument Defined Values lt id gt Location of the authorized phone number to be stored Valid range is from 1 to 10 lt num gt Authorized phone number First digit can be others must be numeric digits Maximum length is 20 Note e Enter phone number exactly same as the incoming one especially if entering International phone number Use AT CLIP command to check incoming call number first e Enter empty phone number in the lt num gt field will erase the record of that location c AT CSNR command This command is to read authorized phone number entered Command Syntax AT CSNR lt id1 gt lt id2 gt Response syntax CSNR lt id gt lt num gt Command Possible responses AT CSNR 1 CSNR 1 12345678 OK Note display authorized number in location 1 AT CSNR 1 8 CSNR 1 12345678 CSNR 3 123456 CSNR 6 12345678 CSNR 8 12345678 OK Note display authorized number in from location 1 to 8 AT CSNR CSNR 1 10 1 10 OK Note possible argum
54. maestro empowering wireless Maestro Heritage Software Tools USER MANUAL Rev 1 2 www maestro wireless com Email contact maestro wireless com Tel 852 2869 0688 Fax 852 2525 4701 Address Room 3603 3609 36 F 118 Connaught Road West Sheung Wan Hong Kong REVISION HISTORY t empowering wireless Rev Date Details Originated by 1 0 1 Mar2008 First release Wallace Lee 1 1 22Sep2008 Update for software ver Wallace Lee 091d 1 2 18MAY2009 Update for software ver Wallace Lee 092 This manual is written without any warranty Maestro Wireless Solutions Ltd reserves the right to modify or improve the product and its accessories which can also be withdrawn without prior notice Besides our company stresses the fact that the performance of the product as well as accessories depends not only on the proper conditions of use but also on the environment around the places of use Maestro Wireless Solutions Ltd assumes no liability for damage incurred directly or indirectly from errors omissions or discrepancies between the modem and the manual Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless TABLE OF CONTENTS CHAPTER 1 INTRODUCTION cccccccsccsssccecceeecseeceeneccnseceecneeceeeeeesneecesenenss 5 CHAPTER 2 HERITAGE PLUGIN SETUP AND COMMANDG ss csseeeeeeeeees 6 1 Selecting PlQ 10 svi
55. ment is the sole property of Maestro Wireless Solutions Limited 37 t empowering wireless CHAPTER 10 CALL SCREENING This feature enables Heritage to reject incoming call if the phone number does not match one of the entries of authorized phone number list Unauthorized incoming call will be hanged up within one ring Up to 10 authorized phone numbers can be stored Each number can be as long as characters Waiting call can also be rejected 1 AT commands for configuring call screening a AT CSRN command This command is to enable or disable call screening feature Command Syntax AT CSRN lt mode gt Response syntax CSRN lt mode gt Command Possible responses AT CSRN 0 OK Note disable call screening AT CSRN 1 OK Enable call screening AT CSRN CSRN 1 Note display current status AT CSRN CSRN 0 1 Note possible argument Defined Values lt mode gt 0 disable call screening 1 enable call screening Note e To use call screening make sure Caller ID service is enabled otherwise all incoming call will be rejected e To apply call screening to waiting call please first enable Call waiting indication by command AT CCWA 1 1 e Rejected incoming will not be diverted to voice mail b AT CSNW command This command is to enter authorized phone number Command Syntax AT CSNW lt id gt lt num gt Response syntax OK Confidential the whole present document is the so
56. min North lt longitude gt dddmm mmmm E W ranges of values dd degree 00 to 180 mm mmmm minute 00 0000 to 59 9999 E W East or West Example longitude of the fix 12 311 12W means 123 degree 11 12 min West lt altitude gt mmmm m altitude of fix in meter lt hdop gt mmm mm horizontal dilution of position in meter lt speed gt SSSS S Speed over ground in kilometers per hour lt course gt dddmm mmmm course in degree minute ranges of values ddd degree 000 to 360 mm mmmm minute 00 0000 to 59 9999 lt nbsat gt nn number of satellites in view Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 12 t empowering wireless CHAPTER 3 GPRS AND TCP UDP PARAMETERS SETUP The Automatic and AT command driven TCP UDP connection PING service DDNS support described in Chapter 4 5 6 7 and 8 requires GPRS connection and TCP UDP parameters setup This chapter will describe those required setups 1 GPRS Network Parameters User need to enter the following parameters for GPRS connection Access point name APN User name Password They are to be entered by using AT IPGPRS command Contact your network operator for these parameters a AT IPGPRS command Description This command is used to setup GPRS network parameters for the TCP UDP connection feature Command Syntax AT IPGPRS lt Cid gt lt APN gt lt UN gt lt PW gt Response Synta
57. mode check reporting See section 1b for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 41 t empowering wireless b Operation of Modem Status Check and Monitoring One Shot mode When user enters AT TMODE command the modem will perform a single check and will send back the result like this TMODE 1 15 10 111 222 33 3814 OK Meaning of parameters Check item Result Result Remark field rom data 1 O fail checksum 1 pass network signal 2 Range from 1 32 or same as AT CSQ strength 99 modem IP 3 In XXX XXX XXX XXX Only shown when GPRS address format session is activated Input voltage 4 Voltage to the modem s See below internal module times 1000 Note This is not for end customer use Periodic mode When user enters AT TMODE 1 command the modem will perform periodic check every one minute Firstly it will check if the modem is registered to the network if the modem is not registered to the network it will increase a counter by one If the counter reach 5 i e not registered for consecutive 5 minutes the modem will reset If the modem is registered to the network the counter will be reset to 0 and perform check same as one shot mode If the result of the network signal strength is lower than the setting of AT TMODE 3 x the test result will be sent over SMS to the telephone number s
58. n de register Note BE VERY CAREFUL to use with id 8 Turn off UART This will make Heritage Com port switched off and cannot accept AT command NEVER program the Heritage to enable this once power up Although Operation type and Operation argument fields are ignored dummy entries are needed for consistent Command String Syntax Use may write PW Command String like this 0 as dummy entry PW 1500 Refer to AT command manual for the details of power down W32K mode It is recommended to use PW service some time after power on So user can have time to change setting Each time when PW Command String is exectuted Refer to AT command manual for the details of power down W32K mode Refer to AT command manual for the details of power down W32K mode This Device Power Control setting is not saved by itself so each time when power on the status should be 0 without any PW Command String executed b Reading Device Power Control status See Chapter 16 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 58 t empowering wireless CHAPTER 16 COMMAND STRING READING STATUS OF SERVICES 1 Command for reading current information of Services You can use AT command to read the info of trigger capable Services a AT CSTRSTAT command Description This command is to read current parameter or status of a particular service Command Syntax
59. nable remote AT command by SMS AT SMSAT SMSAT 1 000000 OK Note display current status AT SMSAT 2 123456 OK Note set the lt key gt value AT SMSAT SMSAT 0 2 6 OK Note possible argument Defined Values lt mode gt 0 disable remote AT command by SMS 1 enable remote AT command by SMS 2 change the value of the lt key gt lt key gt A 6 digit numeric character key from 000000 to 999999 Only incoming SMS with the first 6 characters matching with this key will be treated as a valid source of remote AT command 5 Limitation and caution to be taken when using remote AT command This feature will not judge the result of executing the command so care has to be taken not to enter improper command that make the modem becoming out of control 1 Never send interactive AT command by SMS e g AT CMGS This feature cannot return the prompt to the sender for second input 2 Always wait for the return SMS with AT responses before you send another SMS AT command 3 It could be in some case e g network failure the modem cannot return response SMS The modem will try sending response SMS for three times max If still not successful it will abort 4 Always think twice before you send AT command by SMS For example if you send AT CPOF it will turn off the modem and you need to go to access the modem to reset it 5 Some AT commands can be sent over SMS See Chapter 17 Confidential the whole present docu
60. ng to the above table for example IP 101 MS 40 gt I P Port 4 and 6 signal is selected for Id 101 8 32 IP 102 MS3 gt IP Port 1 and 2 signals is selected for Id 102 1 2 And operation DR is now used to determine the state s not driecton of I P Ports to trigger If the I P is low 0 state the value is 0 otherwise the valuing method is same as MS operation for example IP 101 DR 32 gt both I P Port 4 and 6 with high 1 signal will trigger 0 32 IP 102DR2 gt both I P Port 1 Is low 0 and 2 is high 1 signal will trigger 0 2 TH operation is same as single I P triggering Note e Due to product limitation the modem cannot detect switching action with period less than 100ms If the input signal change is less than 100ms this feature will not be able to detect accurately Always uses Id 101 to 106 for multiple I P triggering application If two or more I P Ports change at the same timer I P Port smaller id have higher priority i e Command String related to that I P Port will be executed first e It is possible that a single I P Port can be included into two or more multiple I P Port groups e Incase of multiple I P triggering it will NOT check the direction of signal change of each included I P just check the combined state value against DR value ion The execution time may be delayed d Reading I P Port status See Chapter 16 for details Confidential the whole present document is
61. o back to command mode and DSR DCD signal back to low e The setting will be saved and after power off the AUTOTCP will be restarted with the 20 seconds delay after power up e To stop auto TCP connection you need to enter the command AT AUTOTCP 0 by either 1 within 20 seconds after power up or 2 during reconnection serial port back to command mode or 3 by SMS see Chapter SMS AT commands e Auto TCP connection is exclusive to other TCP UDP feature See Chapter 11 Q amp A Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 22 t empowering wireless b AT AUTOUDP command This command controls the Heritage to start UDPacket connection automatically Before using AT AUTOUDP TCP and GPRS settings MUST be setup properly using AT IPUDP and AT IPGPRS command respectively Command Syntax AT AUTOUDP lt mode gt Response syntax AUTOUDP lt mode gt Command Possible responses AT AUTOUDP 0 OK Note disable AuttoUDP AT AUTOUDP 1 OK Note Enable AutoUDP AT AUTOUDP AUTOUDP 1 OK Note display current status AT AUTOUDP AUTOUDP 0 1 Note possible argument Defined Values lt mode gt 1 enable auto UDP 0 disable auto UDP Note Before enabling Auto UDP it MUST be properly set the GPRS settings by AT IPGPRS command and UDP settings by AT IPUDP command ONLY GPRS PDP context 1 will be used So please setup IPGPRS settin
62. put voltage change To prevent transient noise signal a threshold value can be set operation TH This is the time period required for the detected state to trigger Command String execution Unit is in 1 millisecond Valid value from 1 to 50 0 1 sec to 5 sec E g TH 10 gt Threshold value is 1 sec E g When set as low to high triggering and threshold 1 second IP 1 DRO IP 1TH10IP1TR5 When period of high signal reach the Threshold value the AT command will be executed Start counting time when a low to high signal change is detected Input port voltage lime T When T 1second the Command String 5 will be executed E g when set as high to low triggering and threshold 1 sec IP 1 DR 1 IP 1 TH 10 IP 1TR5 When period of low signal reach Threshold value the AT command will be executed Start counting time when a high to low signal change is detected When T 1second the Command String 5 will be executed Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 54 empowering wireless c Input Port operation mechanism multiple I P triggering For multiple I P triggering each I P port will be assigned with a numerical value 1 P 1 2 3 4 5 6 value decimal 1 2 4 8 16 32 value binary 1 10 100 1000 10000 100000 To select I P Ports use the MS operation with value equal to the sum of values accordi
63. rent information of Services 59 a Al CSTRSTAT command fvecids cesses end eicets cee eewidte wevavideeide 59 b Reading Alarm Service sssssssasnnnressnnnnrrossnnnnressnnnrrrsenns 59 c Reading Counter Service sssssrrssssrsrrsssenennsnssenenrsrserens 60 d Reading Countdown Timer ServicCe cccccceeeeeeeeeseeeeeeeeees 60 e Reading Input Pin Service ccceceseeeseeeensseeeenseeeeeeeeeees 60 f Reading Device Power Control ServiCe cccccceeeeseeeeeeeeees 60 CHAPTER 17 KNOWN ISSUES 2 ccceseeecesneeecenseecenneeseenseseenseenenseesenaes 61 1 AT WIND command 223 cackeeeveaetescssweicyiiteeviediaewniest xe teeeeast 61 2 Saving of parameters to non volatile memory cccee eee 61 3 Mutually exclusive TCP UDP functions ccce eee eeee eee ee eee ees 61 4 Sending Heritage Software commands over SMS 0085 61 CHAPTER 18 QUESTIONS AND ANSWERS cs cccceseeecesseeeenseeseenseeseeeees 62 T PO CP UDP pacssnteivenciescaceieseiais cides eee 62 2 AT command driven TCP UDP CONNECtION cceeeeeeeeeeeees 62 3 Remote AT command by SMS ccccceeeeeeeeeeseeeeeseeeenaaes 62 4 Command String FERN cic cveravesveursedscestesessvecensiedewiaccaawte 62 CHAPTER 19 EXAMPLES OF HERITAGE SOFTWARE SETUP AND OPERATION Stade bene us aes pest Aa E cot saul cation A E EAA 63 1 To setup a Automatic TCP CONNECTION cceee eee eee eee ee eees 63 2 To make a AT comm
64. rrrsssrnns 18 CHAPTER 4 AUTOMATIC AND SELF RECOVERY TCP UDP CONNECTION 20 1 Flow diagram of Auto TCP UDP connection function 21 2 AT commands for Auto TCP UDP Connection cceeeeeeeeees 22 a AT HAUTOTCP command ccccc cess seeeeceeeeuuuuuueeeeeeeeeuuuuuuunees 22 b AT AUTOUDP COMMBAINNG i winds vsedasawanswicnvwseeetud sedeeadvanvwsedeewnn 23 3 AT commands for tuning Auto TCP UDP connection 24 CHAPTER 5 AT COMMAND DRIVEN TCP UDP CONNECTION c00c00se000 25 1 AT commands for Auto TCP UDP COnnection cccccceeeueeeees 25 a Al DLEMODE command lt cicctdeesesveleestetiiatieeeeesiee ate Gceeeeas 25 b AT HAOTCP COMMANG ccccsscescecceueeeeeeseeeucucuuuueeeessesaaaaeees 26 c AT OUDP command siiscicscemiietevedidiavsdssucdiatidetasntueuseneies 26 CHAPTER 6 PING SERVICE ccsccecccnsecuscneceuseeuseceeeuseeuseneseuseauesauesusesaesaes 28 1 AT command for setting up and execute ping c cece cece ees 28 CHAPTER 7 DYNAMIC DNS csccccccnscuscneceueseueeeeeuseeusenueeuseeussauesunenaesaes 30 1 Description of the Operation 2 2 cccccscsasceseeessseeevsseevess sade est 30 2 AT command for configuring Dynamic DNS ccceeeee eee 31 CHAPTER 8 TCP TERMINAL ccccecccsscccecneceuseeueeceeeusenuseneeeueseueseeesunesaesnes 34 1 Description of the Operation ccceccseeeseeeeeneeeeeneeenees 34 2 AT command for TCP Terminal ccccccceeecceuuuueeeeeeeeauuues 34 CHAPTER
65. sections for details 1 AT command for remote firmware update a AT IPFTP command This command is to set FTP server parameters Command Syntax AT IPFTP lt port gt lt type gt lt mode gt lt server gt lt id gt lt pwd gt Response syntax OK Command Possible responses AT IPFTP OK 21 71 A 201 123 222 222 Note setup FTP parameter userid pssd AT IPFTP IPFTP 0 65535 CA I E CP A 120 64 64 Note possible argument AT IPFTP IPFTP 21 I A 201 222 222 222 userid pssd OK Note display current setting Defined Values lt port gt Port number of the FTP server Default value is 21 lt type gt Translation of carriage return valid values are I image no translation default A ASCII E EBCDIC Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 43 t empowering wireless lt mode gt Passive or Active mode valid values are P passive default A active lt server gt IP address of FTP server in xxx xxx xxx xxx format or an alpha numeric string format e g ftp server com Maximum 120 characters Note if alpha numeric string format is used make sure the GPRS network has proper DNS service available lt id gt login name of the user Maximum 64 characters lt pwd gt Password for the user Maximum 64 characters b AT
66. svisascsaisavetiessiesiiiedieiveriaeweiniasleedvaedaeivads 6 2 AT commands for I O Plug in Board ccc cece eee eeeeeee ee eeeeanees 7 a AT IOBR command ccccccceueuueeeeeeeecuccuuuuuuueseeseueuuuuuuennggs 7 b AT IOBW command yiccinwscsseceiadaavdeaaanssecianastamianateesssedsaswneds 7 3 AT commands for CGPS Plug in Board s ssssssssssssrrrrssssrrrrrns 8 a Are NMEA Command ieee wien daciecniesueserwatbietebianss A 8 b AT CGPSSTART command isisssceciscisuvisadswserasavanonsaneeowndadeawns 9 c AT CGPSSTOP command cece ccecceeeeeeeeceeeuuuuuueeeeeeeeuuuuueneees 9 d AT CGPSSTANDBY command scccsseecceueuseeeeeeeeucucununeees 10 e AT 4AGPS COMMANG siaciececsrcncniaarenineevusceseviqenseeetuasenennwanes 10 f ATFGPSPOS command eisite sect iiedaesecertbees ieee EE 11 CHAPTER 3 GPRS AND TCP UDP PARAMETERS SETUP cssscesessenseeees 13 1 GPRS Network Parameters cccccccseeccceeeuueuueuseeeeeucuuunuueees 13 a AT IPGPRS COMMANA cccccccuuveeeeceeeuucceeeuuuuesueneueeuuuauenns 13 b AT IPCONNECT COMMANG ccccccccsscesccecccccueuueeeeeuesaaaaaes 14 2 TCP UDP Parameters Setup cccceceesceeeeesceesseeeeeseenenaaes 14 a AT IPTCP command siiceccaiccnsennsdceaincaetaeandaaieavnsesuseeeranawendn 14 b AT IPUDP command ssasasnssnsnnnnnnnnnnnnrnnrnrrnnnnnunnnnnnnnnnnnne 16 c AT IPBUFF command sssasssssssssunnsnnrrunnrnrrnrnrrnrnrnnernnnennnne 17 3 Extra TCP UDP Parameters Setup s ssssssssssssrrrressssrr
67. tes e The program will NOT check if the input Command String is valid or not Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 50 t empowering wireless CHAPTER 15 COMMAND STRING SERVICES Service is a kind function or tool that can be made use by Command String There are two kinds of Services e Trigger capable When a certain pre defined condition is matched e g timer reach zero trigger a stored Command String These Services include Alarm Counter Input Port and Countdown Timer e Non Trigger capable Can only perform job when called by Command String These Services include Output Port SMS 1 Alarm Service Alarm is used to execute a Command String when the real time clock of the Heritage meets the set time of the Alarm To use Alarm it is required to set the real time clock of the modem properly see AT CCLK in AT command manual There are total of 5 Alarms can be used a Alarm Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Explanation Service Service id Operation Operation argument type type AL 1 to 5 ST 09 10 10 12 00 00 Set alarm date time yy mm dd hh mm ss format ST 0 Cancel preset TR 1 to 50 Set Command String to be 0 run 0 to cancel setting Example Set alarm 1 to execute Command String 20 at 01OCT2008 01 00 00 AL 1 TR1 AL 1 ST 08 10 01 01 00 00 Example Can
68. th port 1024 and enable DDNS update with hostname mymodem dyndns orq Commands to be entered Modem response AT IPGPRS 1 INTERNET OK APN is INTERNET AT IPDDNSSERV members dyndns org 80 OK set DDNS server settigns AT IPDDNSACCT mymodem dyndns org mylogin mypsswd OK set DDNS account settigns AT IPDDNSUPD 1 OK enable automatic DDNS update AT TCPTERM 2 mypsswd 1024 30 OK set TCP Terminal password to mypsswa port 1024 and timeout 30 secs AT TCPTERM 1 OK enable TCP Terminal Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 5 Perform Remote program update by sending Command over SMS To download update file from fto maestro com directory update filename MSP dwl login id USER password PASSWORD Remember to enter AT SMSAT 1 to enable AT command over SMS first default key 000000 SMS Flow and response min three SMS to be sent OOOO000AT IPGPRS 1 sgprs eg a OOOOOOAT IPFTP 21 I A 202 100 222 222 USER PASSWORD OO00000AT FTPDOTA MSP dwl upda ADINSTALL 2 M 100_VAF_094d_OAT316_32 NOV 11 18 01 42 6 COMMAND STRING PROGRAMMING EXAMPLE Output port power up status settings To set Output Port 1 3 and 6 to logic 1 short 1 minute after power up Command String
69. the sole property of Maestro Wireless Solutions Limited 55 t empowering wireless 5 Output Port Service NOTE An optional I O plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for info Output Port Service can control the state of I O board s output ports by Command String a Output Port Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Service Serviceid Operation Operation Explanation type type argument OP 1 to 6 SW 0TO 1 Set the state of Output Port Example Set the Output Port 1 with logic state ON 1 OP1SW1 Input Port operation mechanism Output Port Short logic 1 Open logic 0 I O board plug in OP 1 SW 1 gt Output Port 1 will short OP 1 SW 0 gt Output Port 1 will open Note Read I O board plug in documentation for the connecting and specifications of Output Ports When power up or reset ALL Output Ports are set to logic 0 open Previous output state will NOT be kept 6 SMS Service This service is used to send out a SMS to phone number recorded in the first 10 phonebook records in SIM card a SMS Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Explanation Service Service id Operation Operation type type argument SM 1 to 10 SN SMS content Send out the SMS to phone number inside SIM card
70. to 5 DE 1 TO 255 Decrement the value of Counter with argument value IN 1 TO 255 Increment the value of Counter with argument value RS 0 Reset the Counter value to zero ST 32768 to Set the trigger value 32767 If Counter value equal this value will execute Command String TR 1 to 50 Set Command String to be run 0 0 to cancel setting Example Set Counter 1 to execute Command String 10 if Counter value equal 100 CT 1ST 100 CT 1TR10 Example Increase Counter 1 value by 20 CT 1 IN 20 Example Reset Counter 1 value to 0 CT1RS0 Note e Initial Counter and trigger values are zero e The Counter is recorded by a signed 16 bit register if the Counter value is 32767 and you increase it by 1 the value will change to 32768 e There is no limit on no of times of triggering E g If you first set trigger value to 2 and reset Counter to 0 then you increment counter by 2 then decrement by 2 and increment by 2 again Then the associated Command String will be executed twice b Reading Counter Service status See Chapter 16 for details 3 Countdown Timer Service Countdown Timer is used execute a Command String when the Timer value reach zero Counting period is 1 second There are total of 10 Countdown Timers a Countdown Timer Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Service Service id Operation Operation Explanation type type argument TM 1 to 10 S
71. to be entered Explanation AT CSTRSET 0 80 TM 1 ST 60 Set timer 1 60 seconds countdown on power 1TR11TM 1 SW 1 up and set to trigger Command String 1 AT CSTRSET 0 1 OP 1 SW 1 OP Command String 1 switch Output Port 1 3 3 SW 1 OP 6 SW 1 and 6 to logic 1 7 COMMAND STRING PROGRAMMING EXAMPLE Input Port signal counting and triggering To set if Input Port 1 has a low to high signal for three times within 30 seconds set Output Port 5 to high Services used IP 1 CT 1 TM 2 OP 5 CS Command String Command String to be entered Explanation AT CSTRSET 0 6 0P 5 SW 1 CT 1 RS 0 CS6 OP 5 set to 1 Counter 1 reset 0 AT CSTRSET 0 5 CT 1 RS 0 TM 2 ST 30 CS5 Counter 1 reset 0 set Timer 2 to 30 sec TM 2 SW 0 and stops it AT CSTRSET 0 4 CT 1 IN 1 TM 2 SW 1 CS4 increment Counter 1 by 1 switch Timer 2 on AT CSTR IP 1 DR 1 IP 1 TH1IP1TR4 Set Input 1 low to high 100mS threshold CT1ST3CT1TR6TM2 ST 30 TM 2 TR trigger CS4 5 Set Counter 1 trigger value to 3 trigger CS 6 Set Timer 2 to 30 secs trigger CS5 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless CHAPTER 20 COMMAND STRING QUICK REFERENCE ALARM AL Service ld Operation Type Argument and Explanation 1to5 ST yy mm d
72. ument is the sole property of Maestro Wireless Solutions Limited 16 t empowering wireless lt UDPTxDelay gt This parameter determines if there is time delay introduced before sending a UDP frame that has not been entirely filled with user data If it is set to 0 initiates the sending of a UDP frame as soon as possible after the reception of a single character value from the host If it is set to 1 initiate a delay will be introduced before the sending of a UDP frame The default value is 0 c AT IPBUFF command This command specifies the number of bytes of payload data from remote peer buffered inside the modem when automatic or AT command driven TCP UDP connection is made e Ifthe quantity of buffered data reaches this value the whole buffered data will be sent out to the serial port e Ifthe data from remote is large enough at one time only multiple of this value data will be sent out to the serial port remainder will be kept inside buffer Example AT IPBUFF 5 1234567890 ABCDEFGH Command Syntax AT IPBUFF lt buff gt Response Syntax IPBUFF lt buff gt 18 bytes of data sent from TCP or UDP socket to modem 15 bytes multiple of 5 data sent out to serial port remaining data buffered inside Command Possible responses AT IPBUFF IPBUFF 0 100 OK Note display possible values AT IPBUFF IP BUFF O OK Note display current status AT IPBUFF 5 O
73. uth donator notfqdgn Nohost numhost abuse badagent dnserr 911 Visit Website of DDNS service providers for the explanation of return code Note If the DDNS update process fails because of failure to get server response the lt result gt maybe a negative value contact Heritage to get details Before making command driven ping action AT IPPING w o argument make sure Confidential the whole present document is the sole property of Maestro Wireless GPRS is connected IPCONNECT 1 1 and ping target and parameters are set properly If automatic DDNS update enabled Heritage will detect GPRS connection and start DDNS update once connection is established If update is fail it will retry for 3 times maximum User can enter AT IPDDNSUPD to check the result of last update result Solutions Limited 33 empowering wireless CHAPTER 8 TCP TERMINAL To use this feature we strongly suggest to get special GPRS service from your network operator a Network will assign a true public IP address to Heritage upon GPRS activations and b that GPRS connection allows incoming access from public Internet to Heritage This feature lets Heritage 100 can be connected through TCP channel and AT commands can be sent over this channel User can use Telnet type terminal service to login to M100 and control it by sending AT commands through the telnet 1 Description of th
74. vate GPRS connection success AT IPCONNECT 1 1 CME ERROR 3 Note Activate GPRS connection fail AT IPCONNECT 1 0 OK Note Deactivate GPRS connection success Defined Values lt Bearer gt 0 using GSM Bearer Note do NOT use this 1 using GPRS Bearer lt Connect gt 0 to stop connection 1 to start connection Note Before you connect to GPRS by this command make sure you have finished the following first 1 Entered APN settings by AT IPGPRS command Chapter 3 1 a 2 It is suggested after modem power up wait about 20 seconds before making GPRS connection 2 TCP UDP Parameters Setup For using automatic or AT command driven TCP UDP connection described in Chapter 5 and 6 you need to first enter the target TCP UDP peer parameters There are e AT IPTCP e AT IPUDP e AT IPBUFF a AT IPTCP command This command specifies the TCP socket parameters and mode that to be used by automatic or AT command driven TCP connection described in Chapter 4 and 5 Command Syntax AT IPTCP lt port gt lt mode gt lt server gt lt TCPTxDelay gt Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 14 t empowering wireless Response Syntax IPTCP lt port gt lt mode gt lt server gt lt TCPTxDelay gt Command Possible responses AT IPTCP IPTCP 0 S 0 OK Note show current settings AT IPTCP 23 OK
75. w dyndns com Check with your DDNS service provider for correct name lt serv_port gt Port number of the update server For example it is 80 or 8080 for www dyndns com Check with your DDNS service provider for correct port number List of parameters of verified DDNS service providers Provider lt serv_url gt lt serv_port gt www dynnds com members dyndns org 80 www no ip com dynupdate no ip com 80 AT IPDDNSACCT command Command Syntax AT IPDDNSACCT lt hostname gt lt login gt lt psswd gt Response syntax OK Command Possible responses AT IPDDNSACCT 12345678 dy ndns org maestro maestro OK Note enter DDNS account and host name info AT IPDDNSACCT IPDDNSACCT 12345678 dyndns org maestr o maestro OK Note display current status AT IPDDNSACCT IPDDNSACCT 64 32 32 OK Note Possible arguements Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 31 t empowering wireless Defined Values lt hostname gt Hostname to be associated with M100 s IP address Should register the hostname in your account and verified it on your DDNS service provider Maximum length is 64 characters lt login gt Login name of the DDNS service account Maximum length is 32 characters lt psswd gt Login password of the DDNS service account Maximum length
76. x IPGPRS lt Cid gt lt APN gt lt UN gt lt PW gt Command Possible responses AT IPGPRS IPGPRS 1 INTERNET OK Note show current settings AT IPGPRS 1 OK Note set Cid value to 1 AT IPGPRS OK 1 INTERNET Note set the PDP value to 1 and APN to INTERNET AT IPGPRS IPGPRS 1 4 100 50 50 OK Note possible values Defined Values lt Cid gt PDP context identifier Note to use with TCP UDP connection feature this value must be set to 1 lt APN gt Access point name of the GPRS network Max 100 characters lt UN gt User name to access the GPRS service Max 50 characters lt PW gt Password used to access the GPRS service Max 50 characters Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 13 t empowering wireless b AT IPCONNECT command This command is to make the modem to activate or deactivate GPRS connection Once IPCONNECT is success you can perform TCP UDP connection as described on other chapters Please read note below on using this command Command Syntax AT IPCONNECT lt Bearer gt lt Connect gt Response Syntax IPCONNECT lt Bearer gt lt Connect gt Command Possible responses AT IPCONNECT IPCONNECT 0 1 0 1 OK Note display possible values AT IPCONNECT IPCONNECT 1 0 OK Note display current status AT IPCONNECT 1 1 OK OK OK Note Acti

Maestro Heritage Software Tools

Contents

Download Pdf Manuals

Related Search

Related Contents