Home

Maestro Heritage Software Tools User Manual

1. Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 57 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 bytes 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 58 empowering wireless CHAPTER 16 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 jo
2. 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 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 16 empowering wireless Command Syntax AT IPTCP lt port gt lt mode gt lt server gt lt TCPTxDelay gt 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 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
3. 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 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
4. 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 empowering wireless 2 AT commands for I Os on I O Plug in Board and CGPS Plug in Board NOTE An optional I O or CGPS 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 user guide a AT lIOBR command This command is to read the value of one or all Input Pins on the 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 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 Val
5. IP1DR1IP1THIIP1TRS5 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 61 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 IP1 TRO 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 input 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
6. b AT CGPSSTART command This command is to start running CGPS Plug in Board Command Syntax AT CGPSSTART lt type gt Response syntax OK Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 10 t i empowering wireless 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 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
7. lt port gt lt auth gt lt server gt lt id gt lt pwd gt OK Command Possible responses AT IPSMTP 25 1 smtp networ nn k com login pssd OK Note setup SMTP parameter using authentication with no encryption AT IPSMTP 25 0 smtp networ k com OK Note setup SMTP parameter no authentication AT IPSMTP IPSMTP 25 0 smtp network com OK Note display current setting Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 38 t empowering wireless AT IPSMTP IPSMTP 0 65535 0 2 120 64 64 OK Note Possible arguements Defined Values lt port gt Port number of the SMTP server Default value is 25 lt auth gt Authentication type used for authentication 0 no authentification required default l authentification with no encryption 2 authentication used with encrypted username password in MIME64 during AUTH LOGIN phase lt server gt IP address of SMTP server in xxx xxx xxx xxx format or an alpha numeric string format e g smtp 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 ATtEMADDR command This command is to save read and delete em
8. Number of displayed or possible Output Pin value depends on plug in type chose 2 Ifno lt pin gt argument is entered then all Output Pins values will be read and the result is displayed as a series 0 or 1 representing the value of Output from 1 to last from left to right 3 Always read 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 NMEA 0 2 OK Note possible values Defined 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 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
9. 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 mode 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 i
10. a AT IPFTP command ssssssssssssessesssnnsnnsorrorrerrenrennunnnunnannusnnsnnas 51 b AT FTPDOTA command sssssssssrnrrrrressrnnnnrrrrrerernnnnnrrreerennn 52 AT ADDINSTALL command ssssssssssssrrssrrrrrrrrrrrrnrrnnrrnrnrrsnrns 53 d Notes and cautions to be taken ssssssssssssssrrerrrrrrrrrrrrrrrrrrsrrss 54 CHAPTER 14 COMMAND STRING INTRODUCTION 55 1 Command String and Service CONCEPt cceeeee eee eee eee ee eee ees 55 CHAPTER 15 COMMAND STRING WRITING AND USING 56 1 Structure of Command String siaccsssdessecsevcenssadeevssscrseraaseerarenses 56 a SEMVICE LY T T E T E 56 b Serivce 10 E E T 56 C Operation type and Operation argument ssssssssssssssssssssssreerrren 56 2 Concatenating Command SUring ccccccssceesseeeeeeeseeeeseeeeeeeeaees 56 3 Entering and executing Command SUring cccceeeeseee sete eee e eee ees 57 a ATH CSTR command cece ecee cece eee n een EE nae Ene E EEE ES 57 b AT CSTRSET COMMANG ccccecceescceeseeseescesseeeceeeceesseesnenennans 57 CHAPTER 16 COMMAND STRING SERVICES ccssssseenees 59 I Alarm SO VICS antiin iaa E E AEEA 59 a Alarm Service Command String Syntax and explanation 59 b Reading Alarm Service StatuS ccecceeeeee eee eens teeta eee eeeeneeaes 59 2 COUNTER SErViCe cuitcnsiiaseiiuned e AE R AAAS Ea 60 a Counter Service Command String Syntax and explanation 60 Confidential the whole prese
11. 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 mode check reporting See section 1b for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 49 One Shot mode When user enters AT TMODE command the modem will perform a single check and will send tr empowering wireless b Operation of Modem Status Check and Monitoring back the result like this TMODE 1 15 10 111 222 33 3814 OK Meaning of parameters Check
12. 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 caused by such service 1 Description of the Operation appl DNS service mymodem ddns co Che Gynarti IP 200 123 111 211 pee a aan com lt gt 200 123 111 21 1 User need to create an account on DDNS service ie 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 tIPDDNSUPD command to configure automatic DDNS update upon each time of IPCONNECT establish
13. 1 TO1 CCO BCS SU3 BD1 b id of TO recipient c id of CC recipient d id of BC recipient e id of email subject f id of email body Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 71 empowering wireless CHAPTER 18 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 IPCONNECT AT EMBODY AT ETHRST Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 72 empowering wireless CHAPTER 19 QUESTIONS AND ANSWERS 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
14. 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 arguments 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 each 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 30 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 31 empowering wireless CHAPTER 7 DYNAMIC DNS To use this feature we strongly suggest getting special GPRS service from your network
15. 28 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 29 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 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 a 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 3445 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
16. 7 T Selecting Plugini ea a a aa 7 2 AT commands for I Os on I O Plug in Board and CGPS Plugin Board 8 a AT IOBR COMMANG sensorer nnr na a aoa 8 b AT IOBW command ssssssssssssnnsssnenusnnnnnnnnnnnnunnunnnnnnnnnnnunsnnnnenuni 8 C AT IOBOR command ss asessssssssssrnnssannnsnnnrnearnssuennnnnnnnnannnsnarrsnnn 9 3 AT commands for CGPS Plug in Board sssssssssssssssssssnsrrrrrrrrrese 10 a AT NMEA command ccccceccccceeeecccueeeeuecuceeeeeeucueeeereugunanrensages 10 b AT CGPSSTART command cccccecsccceeceeccceeeeveucueeeenesuguneesesaaas 10 C AT CGPSSTOP command ccccecececcceeeeeeecueeeeecucueeeeneegguuneensauas 11 d AT CGPSSTANDBY COMMANGA ccccccceeceeccceeeeeevcueeeeeeecguneeensuas 12 e AT AGPS COMMANC cccccccecccceeeucccueeeeeevcueeeeeevcuueeeenecuuuneenenaas 12 f AT GPSPOS command aassssssssusesrenssnnnnnrnnnannnnsnnnnsnunnuennnnnunnnns 13 4 AT commands for Ethernet Plug in Board ssssssssssesssssssessrrrrrns 14 a AT ETHRST command cccccccceeeecccceeeeeeccuueeeeeucuueeeeeecuauneensnags 14 CHAPTER 3 GPRS AND TCP UDP PARAMETERS SETUP 15 1 GPRS Network Parameters ccccccceeseeeeeeccueeeeeeeueeeeuuugueeneennenesegs 15 a AT IPGPRS command ssssssssssssrnnssannnnunnnnnnnsnnnnnsnnnnnnnunnnannns 15 b AT IPCONNECT command ss esssssssssssssrrensnnnnnrrrnnnnrnnennrenenrrenen 16 2 TCP UDP Parameters Setup ssssssssrrrrrssrrrrrrnrrrrrsnrrrerrnrrsrsrens 16 a AT IPTCP command ccccccc
17. 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 62 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 according 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 direction 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 102 DR2 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 trigge
18. 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 18 4 Command String Feature Are the status of Services settings and status will be saved when power is cut All Services status will 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 Yes You can use AT CSTRSTAT command to check 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
19. 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 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 is 32 characters c 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 IPDDNSUPD 1 good 203 111 111 111 OK Note perform DDNS update successful AT IPDDNSUPD IPDDNSUPD 3 badauth OK Note perform DDNS update unsuccessful AT IPDDNSUPD IPDDNSUPD 3 badauth OK Note display current setting automatic DDNS update disabled result of last DDNS update since power up AT IPDDNSU
20. 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 17 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 field 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 multiple 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 0 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
21. alpha numeric characters only e Each email body can contain up to 1024 characters If data entered is more than 1024 it will stop getting and saved to e On save email body to a same lt id gt old body will be over written e ATtEMSEND command This command is send an email with pre saved email subject using AT EMSUBJ command pre saved email body content using AT EMBODY command plus and additional email body to pre saved email address es using ATtEMADDR command Maximum three group of reipent s can be sent for a single email standard recipient carbon copy cc recipient blind carbon copy cc recipient GPRS connection IPCONNECT 1 1 must to be made and smtp parameters have to be entered properly before sending email otherwise will return CME ERROR 3 When finishing a result code will be returned Result code 0 means email transferred success otherwise there is error See following for more explanation Command Syntax AT EMSEND lt to_id gt lt ce_id gt lt bcc_id gt lt subj_id gt lt body_id gt lt add_body gt Response syntax EMSEND lt result gt OK CME EORR 3 Command Possible responses AT EMSEND 1 EMSEND 0 OK Note minimum email no subject and body successfully sent email to email address stored lt id gt 1 AT EMSEND 0 0 2 EMSEND 0 OK Note minimum email no subject and body successfully sent email to email address stored lt id gt 1 as bcc reci
22. 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 sole property of Maestro Wireless Solutions Limited 46 t i 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
23. 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 lt parameter gt is anda 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 20 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 Intern
24. 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 1 DE 1 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 73 t empowering wireless CHAPTER 20 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 INTERNET AT IPCTP 23 S 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 O
25. 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 enabled 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 tCMGS 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 t i empowering wireless CHAPTER 9 EMAIL SENDING SMTP SERVICE To use this feature make sure there is a SMTP server which can serve you The network service provider may have
26. 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 Ifthe TCP 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 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 12 Q amp A Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 24 empowering wireless b AT AUTOUDP command This command controls the Heritage
27. 0 if not to trigger Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 70 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 HS ager ESen ee 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 ee b current value of the timer a b c d c timer is running 1 or stop 0 d 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 Output Pin Service Enter AT CSTRSTAT OP 1 will get Device Power Control info SREE i a ia a Service id b State 0 low 1 hiah g Reading Device Power Control Service Enter AT CSTRSTAT PW 1 will get Device Power Control info PW 0 a Current Service id mode h Reading Email Sending Service Reading Enter AT CSTRSTAT EM 1 will get Email set 1 info a Service id EM
28. 1 to 10 can be set with different combinations of elements recipient to cc bcc subject and body a Email Sending Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Explanation Service Service id Operation Operation type type argument EM 1 to 10 TO 0 50 Id of recipient email address see Chapter 9 2b 0 no receipient CC 0 50 Id of cc recipient email address see Chapter 9 2b 0 no cc receipient BC 0 50 Id of bcc recipent email address see Chapter 9 2b 0 no bcc receipient SU 0 10 Id of email subject see Chapter 9 2c O no subject BD 0 3 Id of email body see Chapter 9 2c 0 no body SN additional Send out the email with above content setting plus additional content CTn to indicate variable IP options in SMS additional OP content TMn Example Setting up EM set 1 with elements recipient 1 cc 3 bcc 4 subject 1 content 2 EM 1TO1EM1CC3EM1BC4EM1SU1EM1BD1 Example Sending email EM set 1 with additional content HELLO WORLD EM 1 SN HELLO_WORLD Example Setting up EM set 2 with elements recipient bcc 3 no subject and content only 0 and send out immediately EM 2 BC 3 EM2 SN 0 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 Confidential the whole present document is the sole property of Maestro
29. 2 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 ASCH E EBCDIC Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 51 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 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 dwil file from FTP root directory file size i
30. 9ms 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 26 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 HOTCP and AT OUDP function provided original IP Connectivity See IP connectivity document Make sure you have made 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 an 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 p
31. CS to trigger 0 to cancel COUNTER CT Service ld Operation Type Argument and Explanation 1to5 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 0 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 to6 DR 0 to 1 101 106 1 63 trigger direction or I P sum multiple I P MS 1 to 63 Mask value for multiple I P 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 ld Operation Type Argument and Explanation 1 to 6 SW 0 to 1 state of Output port SMS SM Service ld Operation Type Argument and Explanation 1 to 10 SN SMS CONTENT variable CTn counter value IP input port value OP output value TMn countdown timer value Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless EMAIL EM Service ld Operation Type Argument and Explanation 1 to 10 TO 0 50 recipient id 0 to cancel CC 0 50 cc recipient id 0 to cancel BCC 0 50 bcc recipient id 0 to cancel SU 0 10 subject id 0 to cancel BD 0 3 body content id 0 to canc
32. LA 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 17 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 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 Coun
33. Limited 50 empowering wireless CHAPTER 13 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 IPFTP 21 A 1 123 456 789 id pwd AT FTPDOTA new_prog dwl 1 To perform the whole program update process several AT commands steps have to be sent 1 AT IPGPRS to set network parameters APN 2 AT IPFTP 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 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 1 ECP A 120 64 64 Note possible argument AT IPFTP IPFTP 21 T A 201 222 222 22
34. PD 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 34 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 badauth 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 tIPCONNECT 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 establ
35. 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 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 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 11 empowering wireless 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 Plug in in standby mode AT CGPSSTANDBY CGPSSTANDBY IN STANDBY MODE OK Note check current CGPS standby state Note 1 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 d
36. S 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 15 empowering wireless b AT tIPCONNECT 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 Activate 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
37. 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 Email sending SMTP 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 property of Maestro Wireless Solutions Limited t j 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
38. TCP 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 74 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 with 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 settings AT IPDDNSACCT mymodem dyndns org mylogin mypsswd OK set DDNS account settings AT IPDDNSUPD 1 OK enabl
39. Wireless Solutions Limited 66 empowering wireless b Using variable options within additional email content In the Email additional content field you can use and Service type to insert the current value of Service into the additional content Variable CTn TMn IP OP Description Current value of Current value Current I P Ports Current O P Ports summing counter Id n of Timer Id n summing value value calculation same as I P Ports Range of 1 to5 1 to 10 See Chap 13 4 c See Chap 13 4 c for n for calculation calculation Invalid Service name or Id will be ignored Note 1 To use Email Sending Service make sure all parameters has been setup properly first APN IPGPRS SMTP server IPSMTP Sender and recipient address EMADDR Subject EMSUBJ Body EMBODY It is strongly suggested you have tested the email sending function by using AT EMSEND command to send test emails first before using EM Command Sting If Operation argument of TO CC BC SU and BD is set to 0 default the associated Email set will not contain that element A minimum email contains one recipient either TO CC or BC and one character of additional email content Unlike AT EMSEND command sending email use EM service will automatically making GPRS connection IPCONNECT 1 1 In case email sending is unsuccessful due to any reason the same email will be resent for max 2 mo
40. 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 IP1TH1IP1TR4 Set Input 1 low to high 100mS threshold CT1ST3CT1TR6TM2 ST 30TM 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 76 t i empowering wireless 8 Command String programming example 3 Input Port signal SMS triggerin To set if Input Port 1 has a low to high signal and last for 0 5 seconds send a SMS to phone book number to tell Input Pins status Services used IP 1 CS Command String Command String to be entered Explanation AT CSTRSET 0 2 SM 1 SN PIN_1_HIGH_IP_STATUS _ IP CS2 send SMS to phone 1 with content PIN_1 AT CSTR IP 1 DRO IP 1 TH 5 IP 1 TR 2 Input 1 low to high 50mS threshold trigger CS2 9 Command String programming example 4 Input Port s
41. ail addresses of sender recipient cc recipient and bec recipient Command Syntax AT EMADDR lt oper gt lt id gt lt address gt Response syntax EMADDR lt oper gt lt id gt lt addr gt OK Command Possible responses AT EMADDR 0 0 a abc com OK Note store email address id 0 sender address AT EMADDR 0 1 b abc com OK Note store email address id1 AT EMADDR 1 1 EMADDR 1 b abc com Note read stored address id 1 AT EMADDR 2 1 OK Note erase email address id1 AT EMADDR EMADDR 0 2 0 50 64 Note possible argument Defined Values lt oper gt Type of operation 0 store email address to flash 1 read email address from flash 2 erase email address from flash Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless lt id gt Identification number id of the email address Valid value is 0 to 50 0 id of the sender address mandatory 1 50 id of recipient email address lt addr gt Email address to be stored Note e The program will NOT check if the address is in valid format or not e Email address stored with lt id gt 0 can only be used as of the sender address not recipent e For each lt id gt you can save more than one email address separated by comma e g AT EMADDR 0 1 me a com you a com him a com But each address list limited to 64 characters c AT tEMSUBJ command This
42. and 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 OK Note Set IPBUFF value to 5 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 19 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 a AT IPOPT command This command specifies the extra TCP UDP socket parameters Command Syntax AT IPOPT
43. ata 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 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 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 12 empowering wireless 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 taken time to time 4 AGPS operation is silent e g if GPRS is not available it will not should any message 5 User can use AT AGPSSTATUS command to check current AGPS status f AT GPSPOS command This command allows getting 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 co
44. ayload 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 UDP connection Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 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 P
45. b 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 Cancel 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 CA
46. ccccceececceueeeeueccaeeeeeescueeeeresgguuerensaaas 16 b AT IPUDP COMMANC ccceccccceeeeuceueeecueuuueeeecucueeeeresgguunestsaaas 18 Cc AT IPBUFF command ccccscccceeeeeccceeeeeevcueeeeuescuueeeneecuuunennenaas 19 3 Extra TCP UDP Parameters Setup oc iscicnssscccccsceawcessrencns sancassanen sans 20 a AT IPOPT command cccccccecccceeeecccceeeeeecsueeeeeescuueueeesauuunenesnags 20 CHAPTER 4 AUTOMATIC AND SELF RECOVERY TCP UDP CONNECTION jcsssccccastcaccasssscnasasaaseacsnaastaceseasaaaassanaaanasenanaaanse 22 1 Flow diagram of Auto TCP UDP connection function 00eee ee 23 2 AT commands for Auto TCP UDP CONNECTION cccceeeee eee eeuaeaueeees 24 a AT AUTOTCP command cccccceceesccceeeeeeccueeeeeescugeeeneeguuueennsnaas 24 b AT AUTOUDP COMMANGA cccccccccecccceeeeeecueeeeeeecuueeeeeecuuuneeeenags 25 3 AT commands for tuning Auto TCP UDP connection cceeeeeee 26 a AT AUFCM COMMANGA cccccccccceeeeccuceeeeeeecueeeeeesaugeeeeeecuaunenesnags 26 CHAPTER 5 AT COMMAND DRIVEN TCP UDP CONNECTION 27 1 AT commands for Auto TCP UDP connection sssssssssssrnssrrssrrrsrrnn 27 a AT DLEMODE COMMANGC ccccccccseccceeeueccueueeeescuueeeeeeauuuneensaaas 27 b AT AOTCP command sarreren anaren E aa 28 Cc AT OUDP command ccccceccccceeueccceseeveucuueueesecuuserereccunnenrenaas 28 CHAPTER 6 PING SERVICE cccccccnnncccccccnnnncceceessnnnnneeneeeeonan 30 1 AT command for setting up and execute PING c
47. command is to save read and delete email subject title Command Syntax AT EMSUBJ lt oper gt lt id gt lt subj gt Response syntax EMSUBJ lt oper gt lt id gt lt subj gt OK Command Possible responses AT EMSUBJ 0 1 This is subj 1 OK Note store email subject 1 AT EMSUBJ 1 1 EMSUBu 1 This is subj 1 Note read stored email subject with lt id gt 1 AT EMSUBJ 2 1 OK Note erase email subject with lt id gt 1 AT EMSUBJ EMSUBuU 0 2 1 10 128 Note possible argument Defined Values lt oper gt Type of operation 0 store email subject to flash 1 read email subject from flash 2 erase email subject from flash lt id gt Identification number id of the email subject Valid value is 1 to 10 lt subj gt Email subject to be stored Maximum 128 characters for each subject Note e It is recommend using only alpha numeric characters ASCII value 32 to 127 for email subject content Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless d AT tEMBODY command This command is to save read and delete pre stored email body content Up to 3 email bodies with 1024 characters max can be stored The lt id gt field is the id number of the email body to be stored To save email body first enter AT EMBODY 0 lt id gt then lt ENTER gt and wait for gt prompt Then simply type email body con
48. d 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 44 empowering wireless 2 AT command for configuring AT command by SMS a 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 Enable 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 matchin
49. dentification number id of the email body content Valid value is 0 to 3 O or missing parameter means no saved body will be used for this email lt add_body gt Additional email body content to be sent Maximum 128 characters can be sent Identification lt add_body gt will be added just after body indicated by lt body_id gt if available lt id gt Identification number id of the email body Valid value is 1 to 3 lt result gt Result code of the email sending process Result explanation Comments countermeasure code 0 Email sending successful 1 Reserved Contact Maestro Wireless 2 Reserved Contact Maestro Wireless 3 Smtp setup fail Check IPSMTP parameters 4 Cannot resolve smtp server Check IPSMTP parameters server not found 5 Connect smtp server timeout Retry later 99 Other error Contact Maestro Wireless 4xx 5xx SMTP protocol reply code Check SMTP document RFC 821 for explanation Note e As a standard SMTP type email the body should contain alpha numeric characters only e A minimum email contains at least sender s email address and one recipient address Subject and body can be left empty e On save email body to a same lt id gt old body will be over written e When one email is being sent you cannot send another email To put a queue of emails please use Command String EM email sending service Confidential the whole present document is the sol
50. e 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 17 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 69 t empowering wireless CHAPTER 17 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 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 Seer eae ea Ae ee b datetime set space if not set a b c c Command String id to be executed if trigger
51. e 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 000000AT IPGPRS 1 sgprs p E E 000000AT IPFTP 21 T A 202 100 222 222 USER PASSWORD 000000AT FTPDOTA MSP dwl upda ADINSTALL 2 M 100_VAF_094d_OAT316_32 NOV 11 18 01 42 6 Command String programming example 1 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 to be entered Explanation AT CSTRSET 0 80 TM 1 ST 60 Set timer 1 60 seconds countdown on power 1TR1TM 1 SW 1 up and set to trigger Command String 1 AT CSTRSET 0 1 0P 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 2 Input Port signal counting and triggering To set if Input Port 1 has
52. e property of Maestro Wireless Solutions Limited 43 empowering wireless CHAPTER 10 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 1 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 commas default key is 000000 c The 7 and 8 characters of the SMS content is AT in capital letters 6 If SMSAT 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 buffere
53. eceeeee ee ee ee eee eee 30 a AT IPPING command cecccccccceeeecccceeeeeeecueeeeeeecugeneenecuuuneeestags 30 CHAPTER 7 DYNAMIC DNS sssasnsnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 32 1 Description of the Operation cccccccesseeeseeeeeeeeeeeeeseneesaeeeaeeees 32 2 AT command for configuring Dynamic DNS ccceececeee cena ee eneee 33 a AT IPDDNSSERV command ccceccccceeeeecsceeeeecuceeeeecugeneneensaaas 33 b AT IPDDNSACCT command assssssssssrrnrssnnnnnrrrnnnnrrnnrrrsnrnrnarens 33 C AT IPDDNSUPD COMMANGC cccccececceceeeccueeeeeeecuueeeeeecuuueeensnaes 34 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless CHAPTER 8 TCP TERMINAL sssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnan 36 1 Description Of the Operation s sssssssssssrsrrrrrrrressssnrnnrnrrrrrrssesnns 36 2 AT command for TCP Terminal ssssesessssesenssnnnnnnsnenrosesessanennane 36 a AT TCPTERM COMMANC cccccccceceeeeceeeeeeeeeaeeeeeeeeeaeeeeaneeeaans 36 CHAPTER 9 EMAIL SENDING SMTP SERVICE sc0ssse000s 38 1 Description of the Operation s sssssssssssrsrrrrrrrrnssssnrnnrrrrrrrresesnns 38 2 AT command for email sending ccccccccseesseeeseeeeeeeeesseneeesnsanes 38 a ATH IPSMTP command ccecceceeeee eee e eee e eee e eee e ee eee e en eenaetaeeeaeeeae nna 38 b AT EMADDR command 1 ceeeccece eee eee eee e eee e eae eeeeeneenaeeaeeeaeeeaenia
54. ed Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 32 empowering wireless 2 AT command for configuring Dynamic DNS a 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 www 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 b AT tIPDDNSACCT command Command Syntax AT IPDDNSACCT lt hostname gt lt login gt lt psswd gt Response syntax OK Command Possible responses AT IPDDNSACCT 12345678 dy OK nw m m m ndns org maestro maestro
55. el SN additional email content variable CTn counter value IP input port value OP output value TMn countdown timer value DEVICE POWER CONTROL PW Service Id 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
56. ert the current value of Service into the SMS content Variable CTn TMn IP OP Description Current value of Current value Current I P Ports Current O P Ports summing counter Id n of Timer Id n summing value value calculation same as I P Ports Range of 1 to 5 1 to 10 See Chap 13 4 c See Chap 13 4 c for n for calculation 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 ASCII 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 The more of Command Strings the less of SMS length Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless 7 Email Sending Service This service is used to send out an Email to one or more email saved address with saved email subject and saved plus variable email content Please read Chapter 9 for entering email address subject and body Up to 10 set of groups service type EM id
57. esult 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 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 Solu
58. et 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 Heritage Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 21 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 unsuccessful 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 GN GPRS OF 4 RS 232 cable Broad band Fixed IP s 123 456 789 0 N 00 EE A E E O S E EE MEDEE Program monitoring Auto TCP connection set to connect Port 23 l l 123 456 789 0 port 23 i I l Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 22 empowering wireless 1 Flow diagram of Auto TCP UDP connecti
59. f 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 Deregister from network Flight mode Same as AT W32K 1 command 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 then 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 executed 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 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 68 maestro empowering wireless e This Devic
60. g with this key will be treated as a valid source of remote AT command 3 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 document is the sole property of Maestro Wireless Solutions Limited 45 empowering wireless CHAPTER 11 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
61. her own dedicated SMTP server For using other SMTP server please check if the service connection is possible or not This feature Heritage to send an email via a SMTP server This feature can save parameters like of SMTP sever name address of sender and recipient email subject and email body content Then with AT command this function will construct and email using the above stored Information The above information will also be used by Command String email sending service Chapter 16 7 1 Description of the Operation 1 Enter the following information by AT commands see following sections SMTP server Information address port login Info Email addresses of sender recipient s Email subject Email body content Valid minimal emails contain sender address and one recipient address with no subject and no content empty email 2 Make IP connection see Chapter 3 1 b Use AT EMSEND command to send out email An email can contain maximum up to 1024 pre stored 128 command line additional characters three sets of recipient To cc and bcc Each set have 64 characters of email address es Subject title up to 128 characters from a choice 10 pre store subject record AY 2 AT command for email sending a AT IPSMTP command This command is to set SMTP server parameters Command Syntax AT IPSMTP lt port gt lt auth gt lt server gt lt id gt lt pwd gt Response syntax IPSMTP
62. id value is from 1 to 6 for I O plug in and 1 to for CGPS plug in If omitted all 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 Number of displayed or possible Input Pin value depends on plug in type chose 2 Ifno lt pin gt argument is entered then all Input Pins values will be read and the result is displayed as a series 0 or 1 representing the value for input 1 to 6 from left to right 3 Always read Plug in Board user manual before wiring to avoid permanent damage to the board b AT IOBW command This command is to set write the value of one or all Output Pins on the I O plug in or CGPS plug in Command Syntax AT IOBW 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 Limited t i empowering wireless Command Possible responses AT IOBW 111111 OK Note set all six output pins to value 1 AT IOBW 000001 JOK Note set Output pins 1 to 5 to 1 6 to 0 AT IOBW 6 0 OK Note set Output pin 6 to 0 others not changed Defined Values lt pin gt ID of the Output Pin to be set Valid value is from 1 to 6 lt val gt Value output value of the pin to be set 0 Output Pin is opened 1 Out
63. ignal counting and triggering To set if Input Port 1 has a low to high signal and last for 0 5 seconds send an email with config set with EM 1 Services used EM 1 IP 2 CS Command String AT IPGPRS 1 INTERNET AT IPSMTP 25 0 smtp netowk com AT EMADDR 0 0 me netowrk com AT EMADDR 0 1 to_1 netowrk com to_2 network com AT EMADDR 0 2 cc_1 netowrk com cc_2 network com AT EMADDR 0 3 bcc_1 netowrk com bcc_2 network com AT EMSUBJ 0 1 Email subj 1 AT Cmd Cmd String to be entered Explanation Setup GPRS Setup SMTP server Setup sender address Setup recipient address Setup cc recipient address Setup bcc recipient address Setup email subject AT CSTR EM 1 TO 1 EM 1 CC2 EM 1 BC3 EM 1 SU 1 Set EM 1 using TO 1 CC 2 BCC 3 Subj 1 AT CSTRSET 0 3 EM 1 SN PIN_1_HIGH_IP_STATUS _ IP CS3 send out email with setting using EM 1with add content PIN_1 AT CSTR IP 2 DRO IP 2TH5 IP 2TR3 Set Input 2 low to high 50mS threshold trigger CS3 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 77 t empowering wireless CHAPTER 21 COMMAND STRING QUICK REFERENCE ALARM AL Service Id Operation Type Argument and Explanation 1to5 ST yy mm dd hh mm ss Date time 0 to cancel TR 0 to 50
64. ingle 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 Service 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 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 56 empowering wireless
65. ished 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 35 empowering wireless CHAPTER 8 TCP TERMINAL To use this feature we strongly suggest getting 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 the 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 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 O
66. 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 set 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
67. ith 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 b Reading O P Port status See Chapter 17 for details 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 CTn to indicate variable IP options in SMS content TMn Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 64 empowering wireless Example Send a message ALERT to phone number store in SIM phonebook 1 SM 1 SN ALERT 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 ins
68. 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 j empowering wireless CHAPTER 12 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 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
69. maestro empowering wireless Maestro Heritage Software Tools USER MANUAL Rev 1 3 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 1 3 3DEC2009 Update for software ver Wallace Lee 092f 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 Maestro Wireless Solutions Ltd assumes no liability for damage incurred directly or the places of use 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 ssssssnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 6 CHAPTER 2 HERITAGE PLUGIN SETUP AND COMMANDS
70. nce 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 a AT TCPTERM 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 36 tr 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 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
71. ng Service Status ssssssssssrrsesrrrrrrrerrrrres 67 8 Device Power Control Service ssssssssrsssssssssessrrrrnnnnrnnnnnnnnnnnnsnne 68 a Device Power Control Service Command String Syntax and explanatio Misso ioineinaii iniia ii ARKAE NENEN EANET AREENA 68 b Reading Device Power Control statuS sssssssssrsrrrrrrrrrrssrsssss 69 CHAPTER 17 COMMAND STRING READING STATUS OF 1 Command for reading current information of Services 0006 70 a AT CSTRSTAT command 2 cccceceecte ects ects eee e ee eeaeeneenaeeaeeeaeeeaenags 70 b Reading Alarm Service iiicisiis cxertoecrin deeieicutenraad es uncer eres 70 Cc Reading Counter Service cecceee eee ee eee eee eee e eee eee eats ea a eas 71 d Reading Countdown Timer Service ccceceee eee eeeeee eee eeeeeeeaes 71 e Reading Input Pin Service 0 cee niiu a eee eee 71 f Reading Ouput Pin Service sssssssssrrrssssrrrrrsrerrnrrsrerrnnrurerrnnns 71 g Reading Device Power Control Service sssssssssrrrrsserrrrrsrereres 71 h Reading Email Sending ServiCe sssssssssssrrrrsserrrrrsrerrnrrsrerrrnns 71 CHAPTER 18 KNOWN ISSUES sssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 2D 1 AT WIND COMMMANG sssrinin aere a 72 2 Saving of parameters to non volatile MEMOLSy ccccceeseeeeeeeeeeees 72 3 Mutually exclusive TCP UDP functions s ssssssssrrssrrrrnssrrrrrssnrnns 72 4 Sending Heritage Software commands over SMS ccceeeeeeeeeee
72. ns 39 C AT EMSUB command 2 eececee cece eee eee eee e eee e eae nae seen eee eas 40 d AT EMBODY command cceeccecceeee eee nets nets eee eeeeeeenaeeeeeneeeaenegs 41 e AT EMSEND command 2 cceececcee cece teat eee e nesses tent neat eee eneeeaeenns 42 CHAPTER 10 REMOTE AT COMMAND BY SMS ccccsssseeeees 44 1 Description of the operation sssssssssssrsrrrrrsrressssnrnnrnrrrrressesnns 44 2 AT command for configuring AT command by SMS 45 a AT SMSAT command riesi iess i aE AOAR EE OREA 45 3 Limitation and caution to be taken when using remote AT command 45 CHAPTER 11 CALL SCREENING cccccccceeeessnnesseeeeseeseanees 46 1 AT commands for configuring call SCrEENING cceeeeeeee ee ee nena ees 46 a AT CSRN command ssassessssssasssssennenrsnrnnrrunrunrannannnunnannannannane 46 b AT CSNW COMMANG occ ecce cece cece center eee tees eee e eae n natn anne e eee eas 46 C AT CSNR command rissies iin aina A AAAA 47 d AT CSND command sssssssanssnssrsssnnsnrenrsnrrnnrunnannanannanuanannannane 48 CHAPTER 12 MODEM STATUS CHECK AND MONITORING 49 1 AT command for Modem Status Check and Monitoring 06 49 a AT TMODE command ssssssssssssussessensenrsnrrorranranrannrnnnunnannannane 49 b Operation of Modem Status Check and Monitoring 005 50 CHAPTER 13 REMOTE PROGRAM UPDATE ssccesecesseesnnnnes 51 1 AT command for remote firmware Update ccccceeeeeeeeeeeeeeeae eee 51
73. nt document is the sole property of Maestro Wireless Solutions Limited t empowering wireless b Reading Counter Service Status sssssssrsrrrerrrrrrrnrrrrrrsrrrsens 60 3 Countdown Timer Service sing rs canteen cle Uenewtiencas exec dene hadee deme tag kaneis 60 a Countdown Timer Service Command String Syntax and explanation 60 b Reading Countdown Timer StatuS ccseceee esses testes tenes eeeeaes 61 4 LAput Port Servite rssi nea E E AETA onesie PAEA 61 a Input port Service Command String Syntax and explanation 61 b Input Port operation mechanism single I P triggering 62 C Input Port operation mechanism multiple I P triggering 63 d Reading I P Port statuS ssssssssssssssssrrrsrrrrrrrrrrrrrnrrnnrsnrssrnsrns 63 5 OQ tp t Port SerViCEsserssrre riesit tintis nas ira ENKE NAATA 64 a Output Port Service Command String Syntax and explanation 64 b Reading O P Port statuS sssssssssssssssssrrrrrrrrrrrrrrarnnrrnrrnrnrrssrns 64 6 OMS SSP VICS coated a a aa a Sa 64 a SMS Service Command String Syntax and explanation 64 b Using variable options within SMS Content ccccseeeseeeeeeeeeees 65 7 Email Sending Service s sssessssssensnnsrenennenessasannnnaneneneoseseneane 66 a Email Sending Service Command String Syntax and explanation 66 b Using variable options within additional email content 67 C Reading Email Sendi
74. of values ddd degree 000 to 360 mm mmmm minute 00 0000 to 59 9999 lt nbsat gt nn number of satellites in view 4 AT commands for Ethernet Plug in Board NOTE An optional Ethernet plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for information For details please read the Ethernet Plug in Board user guide a ATtETHRST command This command is to configure the periodic reset function of Heritage and Ethernet Plug in board If set the Heritage will perform a soft reset periodically with period set with this command Command Syntax AT ETHRST lt min gt Response syntax ETHRST 1 Command Possible responses AT ETHRST 0 OK Note disable periodic reset function AT ETHRST 360 OK Note enable periodic reset function with period of 360 minutes AT ETHRST ETHRST 360 OK Note read current value AT ETHRST ETHRST 0 1500 OK Note possible values Defined Values lt min gt Period of reset in minutes If set to 0 the periodic reset is disabled Default value is 1440 24 hours Note 1 This reset function and AT ETHRST command is function only when Ethernet Plug in is selected HPLUGIN 4 2 Once enabled this reset is unconditional Make sure the device connected to the Ethernet Plug in is able to handle the disconnection of Ethernet connection and can reconnect automatically Confidential the whole present document is the sole
75. olutions Limited 54 t empowering wireless CHAPTER 14 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 e esee gt Command String Command String ae ree 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 be 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 s 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 55 t empowering wireless CHAPTER 15 COMMAND STRING WRITING AND USING 1 Structure of Command String A s
76. on 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 GPRS activation Confidential the whole present document is the sote property of Maestro Wireless fail Solutions Limited 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 23 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
77. ossible 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 the 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
78. 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 argument 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 empowering wireless d AT CSND command This command is to erase authorized phone number entered Command Syntax AT CSND lt id1 gt
79. pient AT EMSEND 1 2 3 1 1 extra EMSEND 0 OK Note email with subject stored with lt id gt 1 body stored with lt id gt 1 and additional body extra is sent to Address with lt id gt 1 as recipient Address with lt id gt 2 as cc recipient Address with lt id gt 3 as bcc recipient AT EMSEND 1 2 3 1 1 extra CME ERROR 3 Note email sending fail possible reason IP not connected AT EMSEND 1 2 3 1 1 extra EMSEND 550 OK email sending fail smtp reply code No such user here Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 42 empowering wireless Defined Values lt to_id gt Identification number id of the email address es that as a normal email recipient Valid value is 0 to 50 0 or missing parameter means no recipient for this email lt cce_id gt Identification number id of the email address es that as a carbon copy cc email recipient Valid value is 0 to 50 0 or missing parameter means no cc recipient for this email lt cce_id gt Identification number id of the email address es that as a blind carbon copy cc email recipient Valid value is 0 to 50 0 or missing parameter means no recipient for this email lt subj_id gt Identification number id of the email subject Valid value is 0 to 10 0 or missing parameter means no subject for this email lt body_id gt I
80. property of Maestro Wireless Solutions Limited 14 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 Syntax 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 GPR
81. put Pin is closed shorted Note 1 Number of displayed or possible output pin value depends on plug in type chose 2 You can only set one of all or all Output Pins in one command 3 To set all Output Pins at one time enter command with a set of digits only 0 or 1 is allowed total number of digits is same as number of Output Pins available to set the state of each Output Pin respectively 4 Always read Plug in Board user manual before wiring to avoid permanent damage to the board c AT IOBOR command This command is to read the last value of one or all Output Pins on the plug in board Command Syntax AT IOBOR lt pin gt Response syntax IOBOR lt val gt lt val gt lt val gt lt val gt lt val gt lt val gt IOBOR lt pin gt lt val gt Command Possible responses AT IOBOR IOBOR 000000 OK Note read all output pins values AT IOBOR 1 IOBOR 1 0 OK Note read the value of output pin 1 AT IOBOR IOBOR 1 6 OK Note possible values Defined Values lt pin gt ID of the Output Pin to be read Valid value is from 1 to maximum number of Output Pin available on the plug in If omitted all Output Pins will be read lt val gt Current value status of the Output Pin 0 Output Pin is set to 0 open 1 Output Pin is set to 1 closed Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless Note 1
82. re times If all retries are fail that Email will be aborted When using EM service maximum 10 emails can be put on sending queue further Email sending requests will be aborted Buffered email queue is volatile and will be lost If modem Is power off or reset Also when there is EM service in queue AT EMSEND command will not be allowed The maximum length of the SMS content is limited by the maximum length of Command String 128 bytes The more of Command Strings the less of SMS length c Reading Email Sending Service status See Chapter 17 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 67 t i empowering wireless 8 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 The value of Service Id is the sum of the values each o
83. ring 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 17 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 63 t i 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 w
84. s 17000 bytes AT FTPDOTA updatel dwl sub FTPDOTA 0 update dwl 17001 OK Note download update1 dwi 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 empowering wireless 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 r
85. s 72 CHAPTER 19 QUESTIONS AND ANSWERS ccceceesseeseeneees O 1 A t TCP UDP arunan aa nsec anne EE NOAA E A EEDE TEENE KEE AEEY 73 2 AT command driven TCP UDP connection cccceceeeeeeeeeeueeuaueeuees 73 3 Remote AT command by SMS sssesessssesssssrssrnresessasennanersnroreseseane 73 4 Command String Feature s sssssssssrsrrrrrrrrrssessnnnnnnnnnrrrrrnsesenenn 73 CHAPTER 20 EXAMPLES OF HERITAGE SOFTWARE SETUP AND 1 To setup a Automatic TCP connection s sssssssssssrrrenrsranrsrnrnnss 74 2 To make a AT command driven TCP connection ssssssssesseserrerere 74 3 To setup periodic PING wisccsncessenrbrreanerediuss nanea EEEE AARE 75 4 To setup TCP Terminal and Dynamic DNS automatic update 75 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited Qe onan t empowering wireless Perform Remote program update by sending Command over SMS 76 Command String programming example 1 cccceseeeseeeeeeeeseees 76 Command String programming example 2 cccceeesee esse tense eeaees 76 Command String programming example 3 cccceeeeee cease eeeeenanes 77 Command String programming example 4 cccceceeeeeeeeeeeeeeees 77 HAPTER 21 COMMAND STRING QUICK REFERENCE 78 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless CHAPTER 1 INTRODUCTION Heritage
86. s 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 25 empowering wireless 3 AT commands for tuning Auto TCP UDP connection a ATtAUFCM command This command controls the buffering time of TDP UDP data sent to remote 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 3
87. s the sole property of Maestro Wireless Solutions Limited 17 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 the 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
88. 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 document is the sole property of Maestro Wireless Solutions Limited 18 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 comm
89. tent lt ctrl Z gt ASCII 26 to finish This command can be aborted using the lt ESC gt ASCII 27 character when entering text Command Syntax AT EMBODY lt oper gt lt id gt lt BODY gt text is entered lt ctrl z ESC gt Response syntax EMBODY lt oper gt lt id gt lt BODY gt Email body entered OK Command Possible responses AT EMBODY 0 1 This is email body 1 lt ctrl Z gt Note enter email body with lt id gt 1 EMBODY 1 21 OK Note successful stored 21 characters as email body with lt id gt 1 gt This is email lt ESC gt Note press lt ESC gt to abort email ell VALA A eae ohana beCer eer ere Tee eTETeT eT eC ev y Ete t err ere Ter ere Erte Cre CrereTeeres OK Note abort to store email body with lt id gt 1 AT EMBODY 1 1 EMBODY 1 This is email body 1 OK Note read stored email body with lt id gt 1 AT EMBODY 2 1 OK Note erase email body with lt id gt 1 AT EMBODY EMBODY 0 2 1 3 Note possible argument Defined Values lt oper gt Type of operation 0 store email body to flash 1 read email body from flash 2 erase email body from flash lt id gt Identification number id of the email body Valid value is 1 to 3 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 41 empowering wireless Note e Asastandard smtp type email the body should contain
90. ter 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 17 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 ST 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 60 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
91. tions Limited 53 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 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 S
92. 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 settings 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 second
93. urse 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 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 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 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 13 empowering wireless 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

Maestro Heritage Software Tools User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents