Home

Maestro Heritage Software Tools

1. 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 mypsswa OK set DDNS account settings AT IPDDNSUPD 1 OK enable automatic DDNS update AT TCPTERM 2 mypsswd 1024 30 OK set TCP Terminal password to mypsswa port 1024 and timeout 30 secs AT TCPTERM 1 OK enable TCP Terminal Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 86 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
2. 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 EMADDR22 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 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 45 t 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 EMSUBJ command This command is to save read and delete email subject title Command Syntax AT EMSUB J lt oper gt lt id gt lt subj gt Response syntax EMSUBJ lt oper gt lt id gt lt subj gt OK Command
3. Example Configure Input Port 1 with detection high to low and threshold value 0 1s and trigger Command String 5 if signal condition match IP 1 DR1IP1TH1IP1TR5 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 69 t 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 IP1TR5 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 DRO 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 1 TH 10 IP1TR5 When period of high signal reach the Threshold value the co
4. 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 AT ADDINSTALL 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 Solutions Limited 61 empowering wireless Defined Values lt r
5. 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 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 11 t 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 f
6. 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 Note disable periodic mode check AT TMODE 1 OK 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 O 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 b Operation of Modem Status Check and Monitoring Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 55 empowering wireless One Shot mode When user enters AT TMODE command the modem will perform a single check and will send back the result like this TMODE 1 15 10 111 222 33 3814 OK Meaning of parameters Check item Result Result Remark field rom data 1 O fail checksum 1 pass network signal 2 Range from 1 32 or same as AT CSQ strength 99 modem IP 3 IN XXX XXX XX
7. field Service Service id Operation Operation Explanation type type argument OP 1 to 6 SW OTO1 Set the state of Output Port Example Set the Output Port 1 with logic state ON 1 OP1SW1 Input Port operation mechanism Output Port Short logic 1 Open logic 0 I O board plug in OP 1 SW 1 gt Output Port 1 will short OP 1 SW 0 gt Output Port 1 will open Note Read I O board plug in documentation for the connecting and specifications of Output Ports When power up or reset ALL Output Ports are set to logic 0 open Previous output state will NOT be kept b Reading O P Port status See Chapter 18 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 72 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 phone
8. 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 O 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 CSNW2 lt id gt lt num gt Response syntax OK Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 52 t empowering wireless Command Possible responses AT CSNW 1 12345678 OK Note enter authorized number to location 1 AT CSNW 11 12345678 CME ERROR 3 Note location out of range AT CSNW 3 1qaaa CME ERROR 3 Note non numeric characters not allowed AT CSNW CSRN 1 10 20 Note possible argument Defined Values lt id gt Location of the authorized phone number to be stored Valid range is from 1 to 10 lt num gt Authorized phone number First digit can be others must be numeric digits Maximum length is 20 Not
9. 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 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
10. 1 value by 20 CT 1 IN 20 Example Reset Counter 1 value to 0 CT1RS0 Note e Initial Counter and trigger values are zero e The Counter is recorded by a signed 16 bit register if the Counter value is 32767 and you increase it by 1 the value will change to 32768 e There is no limit on no of times of triggering E g If you first set trigger value to 2 and reset Counter to 0 then you increment counter by 2 then decrement by 2 and increment by 2 again Then the associated Command String will be executed twice b Reading Counter Service status See Chapter 18 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 OTO1 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 68 t empowering wireless Example Set Countdown Timer 1 to execute Command String 10 and start 600 seconds countdown TM 1 ST 600 TM 1 SW1TM 1 TR 10 Example Stop Countdown Timer 1 1SW 0 E
11. 2 Pulse Counter HERO70 0 4 a AT IOBR 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 Valid value is from 1 to 6 for I O plug in and 1 to for CGPS plug in 2 for Ethernet plug in If omitted all Input Pins will be read lt val gt Current value status of the Input Pin O 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 If no 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 plug in Command Syntax AT IOBW2 lt val gt lt val gt AT IOBW2 lt pin gt lt val gt Response syntax O
12. AISW lt AI gt 0 Note 1 Changing the value of lt shunt gt will change the reading value of Analogue Input See AT AIR command for details d AT AISW command This command is to enable disable the 500 ohm internal resistor of the Analogue Inputs of the plug in board Command Syntax AT AISW2 lt val gt lt val gt lt val gt lt val gt AT AISW lt AI gt lt val gt Response syntax OK Command Possible responses AT AISW 1111 OK Note set all AI s 500 ohm resistor to OFF AT AISW 0001 OK Note set the 4 AI s 500 ohm resistor to OFF Others to ON AT AISW 1 0 OK Note set the 1st AI s 500 ohm resistor to ON others not changed Defined Values lt AI gt ID of the Analogue Input resistor to be set Valid value is 1 to 4 lt val gt Analogue Input resistor state 0 500 ohm resistor enabled default value 1 500 ohm resistor disabled Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 18 empowering wireless Note 1 You can only set one of all or all resistor states in one command 2 To set all resistor states at one time enter command with 4 of digits only O or 1 is allowed to set the state of each resistor respectively 3 Always read Plug in Board user manual before setting to avoid permanent damage to the board 4 Changing the value of lt val gt will change the reading value of Analogue Input See AT A
13. CSNR 1 8 OK 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 CHAPTER 12 MODEM STATUS CHECK AND Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 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 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
14. 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 O initiates the sending of a TCP frame as soon as possible after the reception of a single character value from the host If it is set to 1 initiate a delay will be introduced before the sending of a TCP frame The default value is 0 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 23 tr 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
15. 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 AT OUDP 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 34 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 S
16. Possible responses AT EMSUBJ 0 1 This is subj 1 OK Note store email subject 1 AT EMSUBuJ 1 1 EMSUBJ 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 EMSUBJ 0 2 1 10 128 Note possible argument Defined Values lt oper gt Type of operation O 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 46 t empowering wireless d AT EMBODY 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 content lt ctrl Z gt ASCH 26 to finish This command can be aborted using Command Syntax the lt ESC gt ASCII 27 character when entering text AT EMBODY lt oper gt lt id
17. String programming example 5 ccceeeeeeee eee eee eee eaee 88 11 Command String programming example 6 ccccceee eee eeeeeaeeeaes 89 CHAPTER 22 COMMAND STRING QUICK REFERENCE 90 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited empowering wireless CHAPTER 1 INTRODUCTION Heritage Software Tools is a set of software solutions for Maestro Heritage modem New functions added to increase application range of various industrial and automated applications AT commands specific for individual plug in boards Automatic and self recovery TCP UDP socket connection AT command driven TCP UDP socket connection Ping Service Dynamic DNS note 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 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 s
18. document is the sole property of Maestro Wireless Solutions Limited 32 t empowering wireless CHAPTER 5 AT COMMAND DRIVEN TCP UDP CONNECTION This feature let user to make a TCP or UDP connection upon the AT OTCP or AT OUDP command This socket connection feature does support DLE ETX character coding See 5 1 a The AT OTCP and AT OUDP operation is similar to ATHOTCP 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 DLEMODBE 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 DLEMODBE is set to 1 the ETX character means a request or an indication of end of connection As a consequence ETX characters that belong to the payload data must be sent by the host on the serial port preceded by a DLE character Similarly ETX characters received by the TCP IP stack from the Internet are sent to the host through the serial port preceded by a DLE character ETX is character hex 03 DLE character i
19. driven TCP connection described in Chapter 4 and 5 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 22 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 T CPTxDelay 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 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
20. 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 CMTTY etc will not be displayed on TCP terminal Never send interactive AT command by SMS e g AT CMGS This feature cannot return the prompt to the sender for second input Always think twice before you send AT command For example if you send AT CPOF it will turn off the modem and you need to go to access the modem to reset it Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 43 t 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 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
21. es IAA ich ANENE AREAREN ARNERI 64 b Service Id vringi onnaa o EAEE NE ENEE 64 C Operation type and Operation argument cccceeeeeeeeeeeeeeeaeeas 64 2 Concatenating Command String ssssssssssssrrrrssrernrrrnsurrrnnnsrrernnns 64 3 Entering and executing Command String ssssssssssssrrressrrrrrrsrrerrn 65 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless a AT CSTR COMMANG esisin e i vices i i 65 b AT CSTRSET command sssssssssssssssrrrrrssrrrrrrrnsrrrrrrnrnsrrrrrnnrnern 65 CHAPTER 17 COMMAND STRING SERVICES cccccccccceees2O7 1 Alari SErViCEssis ienas enasna niiae aE EAEE AE nii 67 a Alarm Service Command String Syntax and explanation 67 b Reading Alarm Service StatuS ccccceeeeee eee ee eee ee eee neta eee eaenes 67 2 Co nter SIV ICS oerrinne err roina EE EEEE ETE TEE 68 a Counter Service Command String Syntax and explanation 68 b Reading Counter Service StatuS ccecceeeeeee ee eee estates eaeeeeaeees 68 3 COUNTGOWN Timer ServVic cues nccicsionrsandinedasnaweareenveducancewucdawnensunaade 68 a Countdown Timer Service Command String Syntax and explanation 68 b Reading Countdown Timer Status cceceeeee eee ee teens teens eaeees 69 4 Input 0am m0 gt 1 0 On 69 a Input port Service Command String Syntax and explanation 69 b Input Port operation mechanism s
22. high 1 signal will trigger 0 32 IP 102DR2 gt both I P Port 1 Is low 0 and 2 is high 1 signal will trigger 0 2 TH operation is same as single I P triggering Note e Due to product limitation the modem cannot detect switching action with period less than 100ms If the input signal change is less than 100ms this feature will not be able to detect accurately Always uses Id 101 to 106 for multiple I P triggering application If two or more I P Ports change at the same timer I P Port smaller id have higher priority i e Command String related to that I P Port will be executed first e It is possible that a single I P Port can be included into two or more multiple I P Port groups e Incase of multiple I P triggering it will NOT check the direction of signal change of each included I P just check the combined state value against DR value ion The execution time may be delayed d Reading I P Port status See Chapter 18 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 71i t empowering wireless 5 Output Port Service NOTE An optional I O plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for info Output Port Service can control the state of I O board s output ports by Command String a Output Port Service Command String Syntax and explanation 1 field 2 field 3 field 4
23. is the sole property of Maestro Wireless Solutions Limited 80 t empowering wireless c Reading Counter Service Enter AT CSTRSTAT CT 1 will get Counter 1 info CT 1 ST300 CV20 TR 3 a Service id ta so ARESTA 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 D 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 Service id 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 a IP 1 _MS1 DRO THS TR3 45 f Reading Output Pin Service Enter AT CSTRSTAT OP 1 will get Device Power Control info ieee cia ie a Service id b State 0 low 1 high 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 Service id id of TO recipient id of CC recipient id of BC reci
24. 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 42 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 123456 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 disable TCP Terminal 1 enable TCP Terminal 2 configure TCP Terminal parameters lt psswd gt Login password for TCP Terminal When user opens the Heritage TCP Terminal port it will prompt password User need to enter the password set with this parameter User has 3 times of chance to enter correct password If password is correct user can enter AT command otherwise TCP connection will be closed It can be consisting 1 to 16 alphanumeric characters Default is 000000 6 zeros lt port gt Port number of TCP Terminal Please do not set to the same value of port number in IPTCP and IPUDP command Default is 23 Valid value is 1 to 65535 lt timeout gt Maximum time in second TCP terminal will wait for an
25. 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 ASCI Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless E EBCDIC 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 is 17000 bytes AT FTPDOTA update1 dwl sub FTPDOTA 0 update dwl 17001 OK No
26. 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 sd lia DNS service mymodem ddns cone eal Dynamic IP 200 123 111 211 fads ddns com lt gt 200 123 111 21 1 User need to create an account on DDNS service ia and register a hostname Following providers are tested working correctly www dyndns com www no ip com 2 Use AT IPDDNSSERV command to enter DDNS update server URL and port no Use AT IPDDNSACCT to enter own account login password and hostname 3 When IPCONNECT is ready use AT IPDDNSUPD command to update the above hostname with modem s current IP address 4 User can also use AT IPDDNSUPD command to configure automatic DDNS update upon each time of IPCONNECT established Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 38 t empowering wireless 2 AT command for configuring Dynamic DNS a AT IPDDNSSERV command Command Syntax AT IPDDNSSERV lt s
27. reset Pulse Counter e After power loss Pulse Counter value will be reset to zero c Reading Pulse Counter Service status See Chapter 18 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 79 t empowering wireless CHAPTER 18 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 er ee ae se ee b datetime set space if not set a b c c Command String id to be executed if trigger 0 if not to trigger Confidential the whole present document
28. 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 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 O 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 1TO1EM1CC3EM1BC4EM1SU1EMI1BD1 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 EM 2SN 0 Example Send a message Coun
29. 00 will be executed e Second String TM 1 TR 99 will not be executed because 99 is out of range Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 64 t empowering wireless 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 i
30. 2EM1BC3 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 IP2THS5IP2TR 3 Set Input 2 low to high 50mS threshold trigger CS3 10 Command String programming example 5 Analogue Input signal counting and triggering To set if AI 1 value exceed 1V and last for 2 seconds send an email with config set with EM 1 Services used SM 1 Al 1 CS Command String AT Cmd Cmd String to be entered Explanation AT CSTRSET 0 2 SM 1 SN AlL_1_over_1000mV CS2 send SMS to phone 1 with content AI_1_over_1000mV AT CSTR AI 1 TP 1 AI 1 HL 1000 AI 1 TH 2 AL1 TR 2 Set AI 1 exceed HL trigger HL 1000mV 50mS threshold trigger CS2 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 88 t empowering wireless 11 Command String programming example 6 Pulse Counter signal counting and triggerin To set if PC 1 value exceed 100 then set Output Port 1 to high Services used OP 1 CS Command String AT Cmd Cmd String to be entered Explanation AT CSTRSET 0 2 0P 1 SW 1 switch Output Port 1 to logic 1 AT CSTR PC 1 RS 0 PC 1 ST 100 PC 1 TR Reset PC 1 value to 0 Set PC 1 exceed 100 2 trigger CS2 Confidential the wh
31. CHAPTER 2 HERITAGE PLUGIN SETUP AND COMMANDS 8 l Selecting PIU aeeie EEEE E E EE ETA 8 2 AT commands for digital I Os on Plug in Boards ccceeeeeeeee ees 9 a AT IOBR command ccccccceeecceeccceeeucueeescaueecueueesuueeecuueeeauuneesanes 9 b AT IOBW command ccccccecccceeecceeeccceeeccuueecuueeesuuueecuueeeguuneeguegs 9 C AT IOBOR command cccccccecceescceeesceeucuaeeesuueereuaeeesuuneesgunerags 10 3 AT commands for CGPS Plug in Board sssssssssssssssssssssssnrerrrrrrrrrns 11 a AT NMEA command uu cccccsesecceeccueeuccaueusuaueueuaueveueuevauenereueneraas 11 b AT CGPSSTART COMMANG ccccccccceeccceeeeceeeesueeeeeuueeecuueeesgnneeaes 11 C AT CGPSSTOP command cccceeeecceescceeeeceeeecueeeveuueeecuueeesunnerags 12 d AT CGPSSTANDBY command ccceceecceescceeucueeeeeuaeevaueneesueneeaes 13 e AT AGPS command ssssssssrssssnssnsnannnsnennnnnsnsnannnnnnsnnannnnnsnearenn 13 f AT GPSPOS command ssssssssesssrrrrrnrnnsrrrrrsnnnnnnnrrnnnnnrrrrerenrnna 14 4 AT commands for Ethernet Plug in Board cccccceseeeseeeeeeseeeees 15 a AT ETHRST command ccccceccsescceeeccaueuecaueucueueveueuevcuenercuenerags 15 5 AT commands for Pulse Counter Plug in Board ccceeeeeeee seen ees 16 a AT CNTREAD COMMAN cccceeeeceeeseceeeecaeeesuaeeveuueeeauunerseunerags 16 b AT CNTRESET command cccccccccceescceeesceeeecceeeeeuueeecueeeesgnneeaes 16 Cc AT AICFG COMMAMNGA ccccccccecceescceeeecaeeuecaueueun
32. IR command for details e AT AISR command This command is to read the value of one or all resistor states on the plug in board Command Syntax AT AISR lt AI gt Response syntax AISR lt val gt lt val gt lt val gt lt val gt AISR lt AI gt lt val gt Command Possible responses AT AISR AISR 1111 OK Note read all resistor states AT AISR 1 AISR 1 0 OK Note read the state of AI 1 resistor state AT AISR AISR 1 4 OK Note possible values Defined Values lt AlI gt ID of Analogue Input resistor to be read Valid value is from 1 to 4 If omitted all resistors state will be read lt val gt Current value status of the resistor 0 500 ohm resistor enabled default value 1 500 ohm resistor disabled Note 1 If no lt AI gt argument is entered then all resistor states will be read and the result is displayed as a series 0 or 1 representing the value for resistor 1 to 4 from left to right f AT AIR command This command is to read the value of one or all Analogue Inputs on the plug in board Command Syntax AT AIR lt AI gt Response syntax AIR lt val gt lt val gt lt val gt lt val gt AIR lt AI gt lt val gt Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 19 t empowering wireless Command Possible responses AT AIR AI
33. K Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless Command Possible responses AT IOBW 111111 OK Note set all six output pins to value 1 AT IOBW 000001 OK Note set Output pins 1 to 5 to 1 6 to 0 AT IOBW 6 0 OK Note set Output pin 6 to 0 others not changed Defined Values lt pin gt ID of the Output Pin to be set Valid value depends on number of Input Pins of plug in used lt val gt Value output value of the pin to be set 0 Output Pin is opened 1 Output Pin is closed shorted Note 1 Number of displayed or possible output pin value depends on plug in type chose 2 Youcan 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 O 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 IOB
34. MAND STRING INTRODUCTION Command String is a set of programmable scripts for Maestro Heritage mode User can input sets of Command Strings to control various kinds of Service Unlike AT command Command strings can be stored inside heritage and can be executed upon output of certain services 1 Command String and Service Concept _ eee gt Command String Command String at ETERS A Command String Trigger capable Stored in flash Services sc Sa avs E E Ge eo San ea cai ga mel ew ge Me ee eee eo 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 oF condition is matched e g timer reach zero can trigger a stored Command String 6 Execute stored Command String to control Services again Lt Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 63 t empowering wireless CHAPTER 16 COMMAND STRING WRITING AND USING 1 Structure of Command
35. OR 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 O 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 10 t empowering wireless Note 1 Number of displayed or possible Output Pin value depends on plug in type chose 2 If no 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
36. P 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 31 t empowering wireless 3 AT commands for tuning Auto TCP UDP connection a AT AUFCM 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 39ms or immediately if internal buffer is full Increasing this value can make the data packet size bigger especially when data flow is slow thus reducing overhead Note If the value is set too high the maximum data transfer speed may be decreased Confidential the whole present
37. P output value TMn countdown timer value EMAIL EM Service Id 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 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 90 t empowering wireless SU 0 10 subject id 0 to cancel BD 0 3 body content id 0 to cancel 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 ANALOGUE INPUT Al Service Id Operation Type Argument and Explanation 1 to4 TP 1 to 3 Trigger type higher than HL lower than LL or both TH 1 to 255 threshold tp trigger unit in second HL 6000 to 6000 High Limit unit mV or mA LL 6000 to 6000 Low Limit unit mV or mA TR 0 to 50 CS to trigger 0 to cancel PULSE COUNTER PC Service Id Operation Type Argument and Explanation 1 to 4 ST 1 to 65535 Trigger value RS Don t care reset counter TR 0 to 50 CS to trigger 0 to cancel Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 91
38. 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 seconds delay after power up To stop auto UDP connection you need to enter the command AT AUTOUDP 0 by 1 within 20 seconds after power up or 2 during reconnection serial port back to command mode or 3 by SMS see Chapter SMS AT command Auto TCP connection is exclusive to other TCP UD
39. R 0 0009375 0 1 108125 0 OK Note read all Analogue Input values AT AIR AIR ERROR ERROR ERROR ERROR OK Note error on reading Analogue Input values AT AIR 1 AISR 1 1 032845 OK Note read value of AI 1 AT AIR 1 AISR 1 1 032845 OK Note error on reading Analogue Input value AT AIR AISR 1 4 OK Note possible values Defined Values lt AI gt ID of Analogue Input value to be read Valid value is from 1 to 4 If omitted all AI values will be read lt val gt Value of the Analouge Input When 500 ohm resistor is disabled the unit of value is V When 500 ohm resistor is disabled the unit of value is mA Note 1 Carefully read the Plug in manual before connecting Analogue Inputs otherwise the device may be damaged 2 Ifno lt AI gt argument is entered then AI values will be read and the result is displayed for Al 1 to 4 from left to right 3 If you get ERROR or CME ERROR 3 even with correct command and argument it could be the Plug in is not functioning or connection problem Contact Maestro Wireless or distributor Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 20 t empowering wireless CHAPTER 3 GPRS AND TCP UDP PARAMETERS SETUP The Automatic and AT command driven TCP UDP connection PING service DDNS support described in Chapter 4 5 6 7 and 8 requires GPRS connection and TCP UDP parameters setup This chapter will describe
40. RNET 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 8 255 255 255 255 OK 1 to accept TCP connection from any IP address port 23 client mode TxDelay is enabled AT AUTOTCP 1 OK open TCP socket connection Modem will start to monitor TCP port 23 after 20 secs 2 To make a AT command driven TCP connection IP Connectivity AT feature user can follow the following steps to make OTCP connection To connect to TCP server with IP 61 167 60 1 port 23 Commands to be entered Modem response AT IPGPRS 1 INTERNET OK APN is INTERNET AT IPCTP 23 C 61 167 60 1 1 OK target TCP is 61 167 60 1 port 23 TxDelay is enabled AT DLEMODE 1 OK AT CGATT 1 OK AT IPCONNECT 1 1 OK OK GPRS connection OK AT OTCP CONNECT 115200 open TCP socket connection Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 85 t empowering wireless 3 To setup periodic ping To setup to pin an IP address every 30 minutes disconnect GPRS if fail
41. 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 3 Use AT EMSEND command to send out email 4 Anemail 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 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 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 n k com login pssd OK Note setup SMTP parameter using authe
42. String A single Command String is a text string composed with four fields for example TM 1ST 100 Service typ Operation argument Service id 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 entry AL CT IP OP SM EM PS AI PS Service alarmi Counter Countdo input output SMS Email Power Analogue Pulse wn timer ports ports control input counter See 17 1 17 2 17 3 17 4 17 5 17 6 17 7 17 8 17 9 17 10 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 1 to5 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 1ST 100 TM 1 TR 99 TM 1 SW 1 e First String TM 1 ST 1
43. T 64 32 32 OK Note Possible arguements Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 39 t empowering wireless Defined Values lt hostname gt Hostname to be associated with M100 s IP address Should register the hostname in your account and verified it on your DDNS service provider Maximum length is 64 characters lt login gt Login name of the DDNS service account Maximum length is 32 characters lt psswd gt Login password of the DDNS service account Maximum length 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 IPDDNSUPD IPDDNSUPD 0 1 OK Note Possible arguements Defined Values lt auto_upd gt 0 disable automatic DDNS update 1 enable automatic DDNS update see notes f
44. T CNTREAD 1 CNTREAD 1 10 0 OK Note read current value and state of Pulse Counter 1 AT CNTREAD 1 CNTREAD 1 OK Note error on reading Pulse Counter AT CNTREAD CNTREAD 1 4 1 10 OK Note possible values Defined Values lt cnt gt ID of the Pulse counter Valid range is 1 to 4 lt val gt Pulse counter current value Valid range is O to 65535 if it is 1 means there is problem reading counter value lt state gt 0 Pulse Counter is disconnected 1 Pulse Counter is disconnected Note 1 Occasionally the initial counter value of counters may not be zero Please use AT CNTRESET command to reset counters just after connection b AT CNTRESET command This command is to read the value of one or all Pulse Counters on the plug in board Command Syntax AT CNTRESET lt cnt gt Response syntax OK CME ERROR 3 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 16 t empowering wireless Command Possible responses AT CNTRESET OK Note reset all four Pulse Counters 0 AT CNTRESET 1 OK Note reset Pulse Counter 1 to 0 AT CNTRESET 1 CME ERROR 3 Note Error resetting Pulse Counter Defined Values lt cnt gt ID of the Pulse counter to be reset Valid range is 1 to 4 c AT AICFG command Note normally you NEED NOT use this command to change the setting of Analogue Inputs Consult Maest
45. X 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 e 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 e Ifthe modem is registered to the network the counter will be reset to 0 and perform check same as one shot mode e 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 e 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 e If3 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 CHAPTER 13 AUTOMATIC PIN ENTRY The Automatic Pin entry feature lets user to save a PIN code into Heritage When Heritage detects a PIN PIN1 enabled SIM on starting it will use this saved PIN code to unlock the Confidential the whole present document is th
46. able 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 of which is related to a particular Device Power Control operation value Function Remark 1 Turn off LEDs except network status LED 2 Enable power down mode W32K mode Same as AT W32K 1 command 4 Deregister from network Flight mode Same as AT COPS 2 command 8 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 e 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 e 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 e Each time when PW Command String is executed Refer to AT command manual for the details of power down W32K mode e Refer to AT command manual for the details of power down W32K
47. able 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 1 and a TCP socket connected every 7200 seconds 2 hours an empty keep alive packet will be sent out from the modem to avoid socket being closed because of idle timeout 2 Specifies the maximum size of the outgoing packet to lt parameter gt The size can be set from 1 to 65535 OxFFFF default value is 65535 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 26 maestro empowering wireless 3 Specifies the TTL value of the socket connection to lt parameter gt The value can be set from 1 to 255 Default value is 128 4 Specify weather to use ping function to check Internet connectivity lt parameter gt is the period in second of calling ping function after GPRS connected IPCONNECT lt action gt to specify the action will be taken if a set of ping action fail 0 do nothing default 1 disconnect GPRS IPCONNECT 1 0 2 reset Maestro Heritage C
48. al the whole present document is the sole property of Maestro Wireless Solutions Limited 87 t 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 IP1THS5SIP1TR 2 Input 1 low to high 50mS threshold trigger CS2 9 Command String programming example 4 Input Port signal 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 Cmd Cmd String to be entered Explanation 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 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 1TO1EM1CC
49. astest 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 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 12 t 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 th
50. book 1 SM 1 SN Counter 2_value_is_ CT2 b Using variable options within SMS content In the SMS content field you can use and Service type to insert the current value of Service into the SMS content Variable CTn TMn IP 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 1to5 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 t empowering wireless 7 Email Sending Service This service is used to send out an Email to one or more email saved address with
51. d 11 In case the modem cannot get terminal response within 26 seconds the modem will then abort the command and return intermediate responses if present 12 If the 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 50 t 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 matching 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 re
52. d out of range AT CSTRSET 1 1 CSTRSET 1 TM1 ST 3 Note read stored Command String id 1 AT CSTRSET 3 1 OK Note execute stored Command String id 1 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 65 empowering wireless 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 66 t empowering wireless CHAPTER 17 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 S
53. e 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 1 to 10 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless d AT CSND command This command is to erase authorized phone number entered Command Syntax AT CSND lt id1 gt lt id2 gt Response syntax CSNR lt id gt lt num gt Command Possible responses AT CSND 1 OK Note erase authorized number in location 1 AT
54. e 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 more 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 18 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 75 t 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 dis
55. e 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 data thru Internet about 3Kbyte each time to shorten GPS fix time Make sure the IPGPRS setting Is properly set before using AGPS feature Command Syntax AT AGPS lt val gt Response syntax OK Command Possible responses AT AGPS 1 OK Note enable AGPS feature AT AGPS 1 OK Note disable AGPS feature AT AGPS AGPS 1 OK Note check current APS standby state 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 13 empowering wireless 2 Make sure the GPRS service is available and the IPGPRS setting is properly set 3 The program will sel
56. e sole property of Maestro Wireless Solutions Limited 56 t empowering wireless SIM To prevent further PIN blocking user can set minimum PIN Remaining Attempt Number as a prerequisite for the automatic PIN entry operation Following items will be checked 1 AT command for Automatic PIN Entry a AT AUTOPIN command This command is to configure and enable disable Automatic PIN Entry feature Command Syntax AT AUTOPIN lt mode gt lt pin gt lt remain gt lt unso gt Response syntax OK Command Possible responses AT AUTOPIN 1 OK Note enable Automatic PIN Entry AT AUTOPIN 0 OK Note disable Automatic PIN Entry AT AUTOPIN AUTOPIN 1 1234 3 0 OK Note display current setting AT AUTOPIN AUTOPIN 0 2 4 1 3 0 1 Note possible arguments AT AUTOPIN 2 8888 3 0 OK Note set saved PIN as 8888 PIN Remaining Attempt Number as 3 disable unsolicited message AT AUTOPIN 1 AT AUTOPIN 2 2 1 AT CFUN 1 AUTOPINE 1 OK OK Note enable Automatic PIN Entry and unsolicited message and set PIN Remaining Attempt Number to 2 OK Note after reset PIN Remaining Attempt Number is 1 Automatic PIN Entry aborted and display unsolicted message Defined Values lt mode gt 0 disable Automatic PIN Entry default value 1 enable Automatic PIN Entry 2 configure parameters lt pin gt Four digit PIN code for Automatic PIN E
57. eeee eee eee eee eeeeaees 78 10 Pulse Counter ServiCe sessssererennsnsnsnrnnsnannnnananenenensasesesennnno 79 a Pulse Counter Service Command String Syntax and explanation 79 b Pulse Counter operation mechanism ssssssssssssssssrrrrrsssrrrrrrrssens 79 C Reading Pulse Counter Service Status ccececeeeeeeeee eset eee enennees 79 CHAPTER 18 COMMAND STRING READING STATUS OF 1 Command for reading current information of Services sss 80 a AT CSTRSTAT command wiicestscisenpeeavectede stern a EE a 80 b Reading Alarm Service s ssssssssrssserrsrrrrurrrnsrrnnsrrnnerrnnsrrnnerrnnns 80 Cc Reading Counter Service weiciiciciccccceceiceneceresteedsnedevecevederedrecrers 81 d Reading Countdown Timer Service ccecceeee eee ee teens eeeeeeaeees 81 e Reading Input Pin Service ccceee cece eect eee ee eats teens teen eaeaes 81 f Reading Output Pin Service sssssssssssrrssrrssrrrrsrrnrerrnnsrrnnerrnnns 81 g Reading Device Power Control Service sssssssrsssrrssrrresrrresrrrers 81 h Reading Email Sending Service sssssssssssersssrrrsrrrrsrrnrsrrreerrnses 81 i Reading Analogue Input Service cecceeeeeee eect neta teeta eee eaeees 82 j Reading Pulse Counter ServiCe cccececeeeeeeee eee e este eee eeeeeeaeaes 82 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless CHAPTER 19 KNOWN ISSUES sssssssnn
58. eeeeuneereueeeseunnnraas 17 d AT AISW command asssssssessrsrnsussssnnnrnnnnnnnnrrsnunnnnnnrennnnrnrrerearnna 18 e AT AISR command cccccccceeecceeccceeecceeeccueeeugeeeeegueeecuuneesgunerags 19 f ATHAIR COmMMaNd cccccceccsescueeuccueeuccaueueuaueueueueueuauercuenesauenerags 19 CHAPTER 3 GPRS AND TCP UDP PARAMETERS SETUP 21 1 GPRS Network Parameters ssssssssssrrsrsnrrrrnnrrnrnnnnnnnnnnnsanrrnnnrrrnn 21 a AT IPGPRS COMMANGA cccccceccceccceeecceeesceeeecueeeeegenersuunersgnnerags 21 b AT IPCONNECT COMMANGA cccccccccceccceeecceeeesueeeeeuueeecuueeesgnneeags 22 2 TCP UDP Parameters Setup issccccss ets dudedeatced edsnevadscnsiedetancendacaantien 22 a AT IPTCP command qu cecccccccseeccaeeuecaeeueuaeeueueuereueueveunneseunseraas 22 b AT IPUDP command cccccccecceeecceeescaeeescaeeesuaeercuunerauueeesgunerags 24 C AT IPBUFF command ssssssssssssessssrnrrnunnrnnnrrsnnnnnnnrrruenanrrrrerenrnna 25 3 Extra TCP UDP Parameters SetUp ssssssrrrrrrrrrssrsnnrrrrrrrrssrnnnnn 26 a AT IPOPT COMMANGA cccccceecceeccceeescaeeeccaeeesceeeeegueeeeuunensannneags 26 CHAPTER 4 AUTOMATIC AND SELF RECOVERY TCP UDP CONNECTION rainn 28 1 Flow diagram of Auto TCP UDP connection function ccee eee 29 2 AT commands for Auto TCP UDP CONNECTION cccceeeeeeeeeeeeeeeneaee 30 a AT AUTOTCP command uu cccccceeeceeececeeeeceeeesueeeeeueeencuueeesgnneeags 30 b AT AUTOUDP command ssssssssssrrrrrssnsrrrrrnnnnnnnn
59. er condition that value is higher than the high limit 1000 threshold value 2s and trigger Command String 1 if signal condition match AI3 TP 1 AI 3 TH 2 AI 3 HL 1000 AI 3 TR2 Example cancel Al 1 to trigger Command String AI1 TRO Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 77 empowering wireless b Analogue Input operation mechanism Voltage to AI 6 to 6V The Analogue Input Service will keep checking the AI once every one second Depending on Trigger Type TP set the service will trigger executing Command String if condition fulfilled Trigger Type TP AI value change from lower than AI value change from higher to higher than HL value than to lower than LL value 1 Trigger 2 Trigger 3 Trigger Trigger Al value T TH gt Trigger to execute Command String if TP 1 or TP 3 Start to count threshold ot 2 2 22 2 2 2 HL time when crossing H L Limit T TH Trigger to execute Command String if TP 2 or Note e Please read Pulse Counter Plug in board manual carefully before setup e The Service cannot detect AI value change period less than 1s If the AI value change is less than 1 second this feature will not be able to detect accurately c Reading Analogue Input Service status See Chapter 18 for details Confidential the whole present document is the sole property of Maestro Wire
60. erv_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 ndns org 80 OK 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 IPDDNSACCT command Command Syntax AT IPDDNSACCT lt hostname gt lt login gt lt psswd gt Response syntax OK Command Possible responses AT IPDDNSACCT 12345678 dy OK n n m m ndns org maestro maestro Note enter DDNS account and host name info AT IPDDNSACCT IPDDNSACCT 12345678 dyndns org maestr o maestro OK Note display current status AT IPDDNSACCT IPDDNSACC
61. ervices include Alarm Counter Input Port and Countdown Timer e Non Trigger capable Can only perform job when called by Command String These Services include Output Port SMS 1 Alarm Service Alarm is used to execute a Command String when the real time clock of the Heritage meets the set time of the Alarm To use Alarm it is required to set the real time clock of the modem properly see AT CCLK in AT command manual There are total of 5 Alarms can be used a Alarm Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Explanation Service Service id Operation Operation argument type type AL 1 to 5 ST 09 10 10 12 00 00 Set alarm date time yy mm dd hh mm ss format ST 0 Cancel preset TR 1 to 50 Set Command String to be 0 run 0 to cancel setting Example Set alarm 1 to execute Command String 20 at 01O0CT2008 01 00 00 AL 1 TR 1 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 o
62. esult 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 No resume function on FTP downloading The whole file has to be downloaded at one time otherwise the downloaded data will be discarded e6 39 character on file path because it cannot be transferred correctly over SMS Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 62 t empowering wireless CHAPTER 15 COM
63. f 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 course gt lt nbsat gt Command Possible responses AT GPSOPS GPSPOS 1 225454 192294 4916 45N 12311 12W 111 1 0 9 25 5 180 0 06 OK Note see defined values AT GPSPOS GPSPOS 154555555 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 Exa
64. f that Alarm will be lost e This service will make use of Heritage internal alarm command AT CALA so please avoid using AT CALA command by yourself when Alarm Service is used e Ifthe modem is restarted date time setting of each Alarm will be checked against real time clock time If time is passed the setting will be cancelled e Alarm Service is one shot type There is no periodic alarm like daily or weekly b Reading Alarm Service status See Chapter 18 for details Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 67 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
65. fer 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 25 t empowering wireless Defined Values lt buff gt The number of bytes of data to be buffered Default value is 0 i e no buffering Valid range is 0 to 100 Note If the TCP or UDP socket connection is broken buffered data will be lost 3 Extra TCP UDP Parameters Setup User can set additional parameters of TCP UDP connection including keep alive packet maximum packet size and TTL a AT IPOPT command This command specifies the extra TCP UDP socket parameters Command Syntax AT IPOPT lt CMDType gt lt parameter gt action gt Response Syntax IPOPT lt CMDType gt lt parameter gt lt action gt Command Possible responses AT IPOPT IPOPT 1 0 IPOPT 2 536 IPOPT 3 64 IPOPT 4 0 0 OK Note display current settings AT IPOPT 1 1 OK Note en
66. 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 body OY ef nnnnnnnnnnnnnnnnineietitnntnitnitvnninitnttnnitintinnnnnnes 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 O 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 47 t empowering wireless Note e As a standard smtp type email the body should contain alpha numeric characters only e Fach 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
67. 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 24 t empowering wireless lt UDPTxDelay gt This parameter determines if there is time delay introduced before sending a UDP frame that has not been entirely filled with user data If it is set to 0 initiates the sending of a UDP frame as soon as possible after the reception of a single character value from the host If it is set to 1 initiate a delay will be introduced before the sending of a UDP frame The default value is 0 c AT IPBUFF command This command specifies the number of bytes of payload data from remote peer buffered inside the modem when automatic or AT command driven TCP UDP connection is made e Ifthe quantity of buffered data reaches this value the whole buffered data will be sent out to the serial port e If the 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 buf
68. ing 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 O000000AT CSQ 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 ATISMSAT gommand 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 buffered recorded then return to the sender s phone number in one single SMS 10 Ifresponse s of the AT command is are more than 160 characters only the first 160 characters will be returne
69. ingle I P triggering 70 i Input Port operation mechanism multiple I P triggering 7i d Reading I P Port Status sssssssssssssrrrsssrrrrrrrrsrrrrrrnnnserrrrnnrnerns 71 5 Output Port Servicers snena eE EEEE OE EE 72 a Output Port Service Command String Syntax and explanation 72 b Reading O P Port StatuS cccccceseeeeeeeeeeeeeeeeeeeeeeaeeeeeaseaeeaenes 72 6 SMS Serveeri TEET EEA RENEE EEE TE ETENEE 72 a SMS Service Command String Syntax and explanation 72 b Using variable options within SMS content ssssssssssrssrererrrrse 73 7 Email Sending Service oucccosensccusouaredcsounden ana a aaa 74 a Email Sending Service Command String Syntax and explanation 74 b Using variable options within additional email content 75 Cc Reading Email Sending Service StatuS ceeceeeeeee teeter eee 75 8 Device Power Control Service asst edecisicddeccechte se ssdncesecesttsotseaeectectncs 76 a Device Power Control Service Command String Syntax and explanatio visi veccsawst ets casey stastveie A N KEA 76 b Reading Device Power Control StatuS ceeeeeee eens eee eeee ees 77 9 Analogue Input SCRVICS sic cs cient ct casdccceutcatdsncetbecsecaeaiesestiedisnceane 77 a Analogue Input Service Command String Syntax and explanation 77 b Analogue Input operation mechanism ccceeeeee eee eeeeeeeneeaeeneeas 78 C Reading Analogue Input Service Status cceecee
70. is enabled it will start the TCP socket connection automatically after 20 seconds 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 In TCP connected data mode the DSR and DCD signals of the serial port will go to high If the 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 The setting will be saved and after power off the AUTOTCP will be restarted with the 20 seconds delay after power up 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 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 30 tr empowering wireless b AT AUTOUDP command This command controls the Heritage to start UDPacket connection automatically Before using AT AUTOUDP TCP and GPRS settings MUST be setup properly using AT IPUDP and AT IPGPRS command respectively Command Syntax AT AUTOUDP lt mode gt Response syntax AUTOUDP lt mode gt Command
71. less Solutions Limited 78 t empowering wireless 10 Pulse Counter Service NOTE An optional Pulse Counter plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for information Pulse Counter Service can use the value of Pulse counter to control the execution of Command String a Pulse Counter Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Explanation Service Service id Operation Operation type type argument PC 1 to 4 ST 0 to 65535 Pulse Counter value to trigger RS 1 Don t care Reset Pulse Counter value to zero TR 1 to 50 Set Command String to be 0 run 0 to cancel setting Example Configure PC 1 trigger condition that value is equal or higher than 100 and trigger Command String 5 PC1ST100PC1TR5 Example Reset PC 3 value to 0 PC1RS0 Example cancel PC 1 to trigger Command String PC1TRO b Pulse Counter operation mechanism The Pulse Counter Service will keep checking the Pulse Counters once every one second If the Pulse Counter value is equal or larger than the ST value the service will trigger executing Command String Note e Please read Pulse Counter Plug in board manual carefully before setup e The Pulse Counter value is incremental only The Trigger will appear once if the counter value crosses the ST value So it is suggested in the triggered Command String to include Command to
72. llowing 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 AT AUTOPIN Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 83 t empowering wireless CHAPTER 20 QUESTIONS AND ANSWERS gt O gt O gt O gt O 1 AutoTCP UDP Can I specify lt server gt by URL e g xxxx com rather than IP address Yes but only if your GPRS network have proper DNS service You cannot specify your own DNS server If I enabled AutoTCP or AutoUDP how can I stop it you need to enter the command AT AUTOTCP 0 or AUTOUDP 0 by either 1 within 20 seconds after power up or 2 during reconnection serial port back to command mode or 3 by SMS see Chapter 6 2 AT command driven TCP UDP connection Why I see three OK coming after entering AT IPCONNECT 1 1 command The Software Tools program is issuing internal AT command for GPRS setup so extra OK responses will be seen After the TCP UDP connection is stopped I wan to enter AT OTCP or AT OUDP to reconnect but I get message CME ERROR 3 Why After TCP UDP socket connection the GPRS connection sessio
73. 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 48 t 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 cc_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 cc_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 O or missing parameter means no subject for this email lt body_id gt Identification number id of the email body content Valid value is O to 3 O or missing parameter means no saved body will be used for this email lt add_body gt Additional email body conte
74. maestro empowering wireless Maestro Heritage Software Tools USER MANUAL Rev 1 4 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 t empowering wireless REVISION HISTORY 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 1 4 8Nov2010 Update for software ver Walace Lee 092i This manual is written without any warranty Maestro Wireless Solutions Ltd reserves the right to modify or improve the product and its accessories which can also be withdrawn without prior notice Besides our company stresses the fact that the performance of the product as well as accessories depends not only on the proper conditions of use but also on the environment around the places of use Maestro Wireless Solutions Ltd assumes no liability for damage incurred directly or indirectly from errors omissions or discrepancies between the modem and the manual Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless TABLE OF CONTENTS CHAPTER 1 INTRODUCTION sssassssnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 7
75. mmand string will be executed Start counting time when a low to high signal change is detected Input port voltage lime T gt When T 1second the Command String 5 will be executed E g when set as high to low triggering and threshold 1 sec IP 1 DR1IP1TH10IP1TR5 Input port iat Start counting time when When period of low signal reach a high to low signal Threshold value the command change is detected string will be executed When T 1second the Command String 5 will be executed Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 70 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 I 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 I P 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
76. mode Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 76 t empowering wireless e This Device Power Control setting is not saved by itself so each time when power on the status should be 0 without any PW Command String executed b Reading Device Power Control status See Chapter 18 for details 9 Analogue Input Service NOTE An optional Pulse Counter plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for information Analogue Input Service can use the signal of Analogue Input to control the execution of Command String a Analogue Input Service Command String Syntax and explanation 1 field 2 field 3 field 4 field Explanation Service Service id Operation Operation type type argument AI 1 to 4 TP 1 to 3 Trigger Type of AI value change to trigger TH 1 to 255 Duration of the AI state to trigger unit in 1s HL 6000 to 6000 High Limit of AI to trigger units mA or mV LL 6000 to 6000 Low Limit of AI to trigger unit mA or mV TR 1 to 50 Set Command String to be 0 run 0 to cancel setting Example Configure Al 1 trigger condition that value is either higher than the high limit 3000 or lower than low limit 1000 and threshold value 1s and trigger Command String 5 if signal condition match AI 1 TP 3 AI 1 TH 1 AI 1 HL 3000 AI 1 LL 1000 AI1 TR5 Example Configure AI 3 trigg
77. mple 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 14 t 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 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 AT ETHRST 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 wi
78. n 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 19 4 Command Siring 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 no of the CS to be triggered then the triggered CS will be executed first e g CT 1 IN 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 84 t empowering wireless CHAPTER 21 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 INTE
79. nnection 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 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
80. nnnnnnnnnnnnnnnnnnnnnnnnn 42 1 Description of the Operation ssssssssssssrenensasasesessososenrsrorerenenne 42 2 AT command for TCP Terminal sssssssessssssasesessssonenesesrorererenenas 42 a AT TCPTERM command sesccriciis recie 42 CHAPTER 9 EMAIL SENDING SMTP SERVICE sccssseee0s 44 i Description of the Operation cccccececcee cece eeeeeeeeaeeeeaeeeeeeeeeaaees 44 2 AT command for email sending sicioccccisececcsuctecdedadecaneansvesdesaedccscas 44 a AT IPSMTP command ssssssssssssssrrrrrrssrrrrrrrnsrrrrrrnrnnrrrrrnnrnerns 44 b AT EMADDR command cceceeee eee e eee eee eset neta teeta tent ents 45 Cc ATFEMSUBI GCOMMANG cteniecs severe ti liwawiert ested i a 46 d AT EMBODY command 2 ccc eecece eee eee eet t nena teat na tents 47 e AT EMSEND command ssissssssesssnrrnrissrenrsnrnusnnninnnsnnnurrusnannnnn 48 CHAPTER 10 REMOTE AT COMMAND BY SMS sssssssnnsssnnssnns 50 1 Description of the operation ssssssssssrsrenensasesesessssonenrsrorerenenae 50 2 AT command for configuring AT command by SMS sses 51 a AT SMSAT comman dipi snensineo piii ai Naa 51 3 Limitation and caution to be taken when using remote AT command 51 CHAPTER 11 CALL SCREENING ssssssssnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnn 52 1 AT commands for configuring call screening ssssssssssrsrrssssrrrrressns 52 a AT CSRN command ssssssssrssransenrrurnusnenrsnnnnenenrunnansnerrunnannnnn 52 b AT CSNW command iiririsiiiciri
81. nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 83 I AT WIND COMMANG sci cisdevcce asic icededivicissaietesssinterbaavcetinierciais 83 2 Saving of parameters to non volatile MEMOTFY ccceceee eee ee eens 83 3 Mutually exclusive TCP UDP functionS s ssssssrssssrsnrrrrrrrsrssrsrnns 83 4 Sending Heritage Software commands over SMS sessen 83 CHAPTER 20 QUESTIONS AND ANSWERS ssssssssnnnnnnnnnnnnnnnn 84 l Aut TCP UDP iioun mun dasid wen a i a e oiai 84 2 AT command driven TCP UDP connection ssssssssssrrrssnrrnssarrrssrrns 84 3 Remote AT command by SMS s ssssssssssssrerensasesesessssonenrsrorerenenae 84 4 Command String Feature cccccccecssesseeseeeseesseeseeeeeeeeeeeeeeeeeeanes 84 CHAPTER 21 EXAMPLES OF HERITAGE SOFTWARE SETUP AND OPERATION siripiininininondn ennan 85 1 To setup a Automatic TCP connection siscsecerissscesscevvacenedeszecdsorseees 85 2 To make a AT command driven TCP connection ccccceeee eee eens 85 Se Tosetup periodic Pingesssienii ni ane a a RE 86 4 To setup TCP Terminal and Dynamic DNS automatic update 86 5 Perform Remote program update by sending Command over SMS 87 6 Command String programming example 1 cceeeeee eect eee ee eee 87 7 Command String programming example 2 cceeeeee cette eee eee ee ee 87 8 Command String programming example 3 cceeeeee cette eee ee eee 88 9 Command String programming example 4 cceeeeee eee eee teens 88 10 Command
82. nt 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 sole property of Maestro Wireless Solutions Limited 49 empowering wireless CHAPTER 10 REMOTE AT COMMAND BY SMS This feature is to control the modem to interpret AT command from incom
83. ntication 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 44 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 1 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 AT EMADDR command This command is to save read and delete email addresses of sender recipient cc recipient and bec recipient Command Syntax AT EMADDR2 lt oper gt lt id gt lt address gt Response syntax EMADDR lt oper gt lt id gt lt addr gt
84. ntry default value is 0000 lt remain gt Minimum value of PIN Remaining Attempt Number If PIN Remaining Attempt Number is less than the value of lt remain gt Automatic PIN Entry will not operate Valid value is 1 to 3 Default value is 3 lt unso gt 0 no unsolicited message default 1 unsolicited message AUTOPINE lt pin_remain gt will be displayed if lt remain gt is Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 57 stro empowering wireless larger than PIN Remaining Attempt Number Note Be VERY careful on using this feature as normally a SIM card have 3 times of PIN entry attempts Further Incorrect attempt will lead to the card become SIM blocked and need PUK to unblock the cad This feature is only for SIM card that is PIN1 enabled It will not work for PIN2 or PUK locked SIM card The Automatic PIN Entry operation will be performed only after power up or restart Enabling AUTOPIN after power up will not make it operate immediately The AT AUTOPIN command cannot be entered remotely SMS TCP Terminal I can only be entered via local physical port The AT AUTOPIN command is not password protected Be cautious of saved PIN entry read by other people Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 58 t empowering wireless CHAPTER 14 REMOTE PROGRAM UPDATE By using this feature
85. o 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 35 t empowering wireless CHAPTER 6 PING SERVICE This feature is to make a ping ICMP Echo Request to a specified IP address and get back the echo result Ping service can also be called 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 3 1 15 OK Note configure ping target 210 103 11 18 3 ping trials total 1 second between each trial timeout limit 15 AT IPPING IPPING 210 103 11 18 time 562ms IPPING 210 103 11 18 time 662ms IPPING 210 103 11 18 time 762ms OK Note Execute ping action no argument AT IPPING IPPING 0 2 15 1 10 1 10 1 60 OK Note Possible arguments AT IPPING IPPING 210 103 11 18 3 1 15 OK Note Display current sta
86. oftware side there are commands to configure and control different plug in boards 1 Selecting Plug in AT HPLUGIN command Description This command is used to setup Heritage with individual hardware plug in board Command Syntax AT HPLUGIN lt type gt Response Syntax HPLUGIN lt type gt Command Possible responses AT HPLUGIN HPLUGIN 1 OK Note show current settings AT HPLUGIN 2 OK Note use plug in 2 CGPS AT HPLUGIN HPLUGIN 1 4 OK Note possible values Defined Values lt type gt Plug in type 1 VO plug in board HERO10 default value 2 CGPS plug in board HERO20 3 reserved 4 Ethernet plug in board HER040 5 Pulse counter plug in board HERO70 Note e After changing the lt type gt value the modem will reset immediately e Modem will not detect and check if HPLUGIN value match with actual plug in user should make sure entering is correct Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless 2 AT commands for digital I Os on Plug in Boards NOTE An optional plug in board I O CGPS Ethernet or Pulse counter is needed to plug to Heritage for using this Service Contact Maestro Wireless for information For details please read the user guide of plugins Plug in No of input supported No of output supported I O HERO10 6 6 C GPS HERO20 6 4 Ethernet HERO40 2
87. ole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless CHAPTER 22 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 CS to trigger 0 to cancel COUNTER CT Service Id 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 Id 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 Id Operation Type Argument and Explanation 1 to 6 SW 0 to 1 state of Output port SMS SM Service Id Operation Type Argument and Explanation 1 to 10 SN SMS CONTENT variable CTn counter value IP input port value O
88. onfidential the whole present document is the sole property of Maestro Wireless Solutions Limited 27 t empowering wireless CHAPTER 4 AUTOMATIC AND SELF RECOVERY TCP UDP CONNECTION The Auto TCP UDP connection feature is defined for accessing serial devices over the Internet Heritage can be configured that after power up it will connect to a remote TCP UDP socket client mode or to wait for the TCP UDP socket connection request from remote peer server mode If the socket connection is 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 Fixed IP TCP Socket connection via the Internet GPRS network A RS 232 cable 123 456 789 0 00 Auto TCP connection set to connect Program monitoring 123 456 789 0 port 23 l l l l Port 23 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 28 1 Flow diagram of Auto TCP UDP connection function empowering wireless Mlodem Power on restart Is AutoTCP UDP enabled Wait for 20 secs f Re attach GPRS GPRS attach OK i Re activate GPRS a Yes Confidential the whole present document is the Solutions Limited No CP UDP connection reque
89. or 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 40 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 GPRS is connected IPCONNECT 1 1 and ping target and parameters are set properly If automatic DDNS update enabled Heritage will detect GPRS connection and start DDNS update once connection is established If update is fail it will retry for 3 times maximum User can enter AT IPDDNSUPD to check the result of last update result Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited gt Stro empowering wireless CHAPTER 8 TCP TERMINAL To u
90. pient id of email subject id of email body EM 1 TO1 CCO BC5 SU3 BD1 homan Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 81 tr empowering wireless i Reading Analogue Input Service Reading Enter AT CSTRSTAT AI 1 will get AI 1 info Service id Al _ 1 TP1 HL100 LL10 TH5 TR1 CV30 b Trigger Type 1 3 ef g High Limit mV or mA Low Limit mV or mA Threshold value second Command String id to be executed if trigger 0 if not to trigger g current value mV or mA o m Ooanq j Reading Pulse Counter Service Reading Enter AT CSTRSTAT PC 1 will get Email set 1 info PC 1 ST1 CVO TR5 a Service id a b c d b trigger value of the pulse counter c current value of the pulse counter d Command String id to be executed if trigger 0 if not to trigger Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 82 t empowering wireless CHAPTER 19 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 Fo
91. ro Wireless for details This command is to configure the Analogue Inputs of the plug in board Command Syntax AT AICFG lt ACTION gt lt AI gt lt FSD gt lt DR gt lt SHUNT gt when lt ACTION gt 0 AT AICFG lt ACTION gt lt AI gt lt AI gt when lt ACTION gt 1 Response syntax OK AICFG lt AI gt lt FSD gt lt DR gt lt SHUNT gt Command Possible responses AT AICFG 0 1 4 0 1 OK Note Al 1 use FSD 6 144V1 DR 128SPS 5000hm ON AT AICFG 0 1 OK Note Al 1 5000hm OFF others no change AT AICFG 1 1 AICFG 1 0 4 0 OK Note read Al 1 settings AT AICFG 1 1 4 AICFG 1 0 4 0 AICFG 2 0 4 0 AICFG 3 0 4 0 AICFG 4 0 4 0 OK Note read Al 1 to Al 4 settings Defined Values lt Al gt ID of the Analogue Input that configuration to be set or read Valid range is 1 to 4 or 255 to configure all 4 Analogue Inputs lt FSD gt Full scale deflection setting 0 6 144V default value 1 4 096V 2 2 048V 3 1 024V 4 0 512V 5 0 256V Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 17 t empowering wireless lt DR gt Sapmple data rate 0 8SPS 1 16SPS 2 32SPS 3 64SPS 4 128SPS default value 5 250SPS 6 475SPS 7 800SPS lt SHUNT gt 500ohm resistor setting For details please read HERO70 manual 0 500 ohm resistor enabled same as AT AISW lt AI gt 1 1 500 ohm resistor disabled same as AT
92. rrruenanrrrrererrnna 31 3 AT commands for tuning Auto TCP UDP connection sssssssesesese 32 a AT AUFCM command cccccccecccescceeccaueucuaueucuaueveuaueveuenerauenerags 32 CHAPTER 5 AT COMMAND DRIVEN TCP UDP CONNECTION 33 1 AT commands for Auto TCP UDP CONNECTION cccceeeeceeeeeeeeeeeeeaee 33 a AT DLEMODE command ccccccccecceeccceeesceeeecceeeeegueeesuuneesgnnneags 33 b AT AOTCP command 2 ccccccceccceccceeesceeeccaeeusueeeesgueeecuuneraunnerags 34 Ci AT OUDP COMMANA 2 cccccecccceeccceeeseaeeescaeeusuaeeesgueeregunersgnnerags 34 CHAPTER 6 PING SERV ICE ssssssasnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 36 1 AT command for setting up and execute ping ssssssssssrsrrssssrrrrressens 36 a AT IPPING command ccccccecceeecceeecceeeeceeeesceeeeegunersuuneesgunerags 36 CHAPTER 7 DYNAMIC DNS ssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 38 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited t empowering wireless I Description of the Operation ssssssssssssrerensasasesessssonenrsrorerenenne 38 2 AT command for configuring Dynamic DNS ccc cece ee ee eee eens 39 a AT IPDDNSSERV COMMANGC cccceceeee eee testes eee eeeeeeeeetenenaeenenas 39 b AT IPDDNSACCT command sssssssssrssssssrrrrrrsrrrrrrrnnsrrrrrrnrsern 39 Cc AT IPDDNSUPD command cceceeceeee eee e eee eee e estes eeeenetenenaeeninas 40 CHAPTER 8 TCP TERMINAL sssssssnsnnnnnnnnnn
93. s 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 t empowering wireless b AT AOTCP command This command is sent by the attached host to open a TCP connection to the TCP server specified by the AT IPCTP command If socket connection is made successfully it will response CONNECT 115200 and the serial port will go to data mode all data entered to the serial port will be sent to remote TCP UDP peer If socket connection is unsuccessful or socket is disconnected afterwards the modem will send out NO CARRIER message and back to command mode Command Syntax AT OTCP Response syntax CONNECT 115200 Command Possible responses AT OTCP CONNECT 115200 Note TCP connection made successfully AT OTCP CME ERROR 3 Note fail either IPCONNECT is not ready or socket service is used already AT OTCP NO CARRIER Note possibly remote server no response
94. se 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 attuafu OK 352061000294955 ta M160 UAF_695 0AT316_32 Hay 4 200917 49 33 i ESS Telnet Terminal 1 Uses AT TCPTERM command to configure password port for the TCP terminal and enable TCP terminal function 2 After about 20 seconds Heritage will connect to the Internet automatically And then it will check the TCP port 3 User from outside Internet can use Telnet application to connect the port of Heritage TCP terminal User need to know the IP address of the Heritage Or with the aid of Dynamic DNS Chapter user can use the hostname associated the Heritage for connections 4 Once connected user need to enter password If password is correct user can send AT command to the Heritage on Telnet program 2 AT command for TCP Terminal a AT TCPTERM command Command Syntax AT TCPTERM
95. sent OOOOOO0AT IPGPRS 1 sgprs OOO000AT 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 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 O 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 DR1IP1TH1IIP1TR4 Set Input 1 low to high 100mS threshold CT1ST3CTiITR6ETM2 ST 30 TM 2 TR trigger CS4 5 Set Counter 1 trigger value to 3 trigger CS 6 Set Timer 2 to 30 secs trigger CS5 Confidenti
96. st from allowed peer Yes Vv Open TCP UDP socket connect to serial port TCP UDP disconnected or closed GPRS attach fail No GPRS activation fail No GPRS activation OK Client mode OK to open pre defined TCP UDP socket y Open TCP UDP socket connect to serial port TCP UDP disconnected or closed GPRS attach fail No Dealy 2 seconds 29 t empowering wireless 2 AT commands for Auto TCP UDP connection a AT AUTOTCP command This command controls the Heritage to start TCP socket connection automatically Before using AT AUTOTCP TCP and GPRS settings MUST be setup properly using AT IPTCP and AT IPGPRS command respectively Command Syntax AT AUTOTCP lt mode gt Response syntax AUTOTCP lt mode gt Command Possible responses AT AUTOTCP 0 OK Note disable AutoTCP AT AUTOTCP 1 OK Enable AutoTCP AT AUTOTCP AUTOTCP 1 OK Note display current status AT AUTOTCP AUTOTCP 0 1 Note possible argument Defined Values lt mode gt 1 enable auto TCP 0 disable auto TCP Note 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 ONLY GPRS PDP context 1 will be used So please setup IPGPRS settings with lt cid gt 1 Once AutoTCP
97. sult 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 Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 51 t empowering wireless 5 Some AT commands can be sent over SMS See Chapter 17 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 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
98. te download update1 dwil file from FTP sub directory file size is 17001 bytes AT FTPDOTA update1 dwl sub 1 ADINSTALL 2 M100_VAF_094d_OAT316_32 Nov 11 200718 01 42 Note download update1 dwil 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 updatel1 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 60 t 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 result gt Result code of the downloading process
99. ter 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 Wireless Solutions Limited 74 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 1to5 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 EMSUB3J 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 O 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 us
100. th 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 property of Maestro Wireless Solutions Limited 15 t empowering wireless 5 AT commands for Pulse Counter Plug in Board NOTE An optional Pulse Counter plug in board is needed to plug to Heritage for using this Service Contact Maestro Wireless for information For details please read the Plug in Board user guide a AT CNTREAD command This command is to read the value of one or all Pulse Counters on the plug in board Command Syntax AT CNTREAD lt cnt gt Response syntax CNTREAD lt val gt lt val gt lt val gt lt val gt lt state gt lt state gt lt state gt lt state gt CNTREAD lt pin gt lt val gt lt state gt Command Possible responses AT CNTREAD CNTREAD 1 2 3 4 1 1 1 1 OK Note read all Pulse Counters values and states A
101. 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 GPRS service Max 50 characters lt PW gt Password used to access the GPRS service Max 50 characters Confidential the whole present document is the sole property of Maestro Wireless Solutions Limited 21 t empowering wireless b AT IPCONNECT command This command is to make the modem to activate or deactivate GPRS co
102. tus 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 36 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 37 empowering wireless CHAPTER 7 DYNAMIC DNS To use this feature we strongly suggest getting special GPRS service from your network operator Network will assign a true public IP address to Heritage upon GPRS activations and b that GPRS connection allows incoming access from public Internet to Heritage This feature lets Heritage to login to certain Dynamic DNS service
103. 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 I 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 AY 1 E P A 120 64 64 Note possible argument AT IPFTP IPFTP 21 71 A 201 222 222 222 userid pssd OK Note display current setting Defined Values lt port gt Port
104. vnniinsicicciiininen nnii 52 Cc ATHCSNR command oneni a 53 d AT CSND command ssssssssrssrasssnrrurrussenrunnnunnenrunnansnerrunnannnnn 54 CHAPTER 12 MODEM STATUS CHECK AND MONITORING 54 1 AT command for Modem Status Check and Monitoring 0 06 55 a AT TMODE command 2 ceecece cece cece erence ent teat nanan 55 b Operation of Modem Status Check and Monitoring 0 55 CHAPTER 13 AUTOMATIC PIN ENTRY ccccsssseensssceseeessnnnes 56 1 AT command for Automatic PIN Entry ccccccecceeceeeeeeeeeeeeeeeeaas 57 a AT AUTOPIN command 1 ceececeece eee e eee e eee eee e eee ne ene tnatnnenaennenas 57 CHAPTER 14 REMOTE PROGRAM UPDATE sssccssccesseessnnees 59 1 AT command for remote firmware update cceeeeeee eset eee ene eenes 59 a AT IPFTP COMIMANG cccccceeeeeeeeseeeeeeeeeeeeeeeeeeeeeteeeaetantaseaseass 59 b AT FTPDOTA COMMANA eceeeeee cece cence eee eee estes ene t eet na teat naennenas 60 C AT ADDINSTALL command sssssssrrsrrasrenrsnrnnsrenrunnansenerrunnannnnn 61 d Notes and cautions to be taken sssssssssssrrrrrssrrrrrrrsssrrrrrrrssns 62 CHAPTER 15 COMMAND STRING INTRODUCTION 63 1 Command String and Service Concept s sssssssssssssssssrssssssssesene 63 CHAPTER 16 COMMAND STRING WRITING AND USING 64 l Str ct r of Command String lt cictoncincitececsatxandiageondeiasiwensdudenecates 64 a SEIMVICE ype ssiri ainka Ea AREARE ies vie
105. will be over written e AT EMSEND 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 AT EMADDR 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 cc_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 successtfully 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 successtfully sent email to email address stored lt id gt 1 as bcc recipient 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
106. xample Cancel Countdown Timer 1 to trigger Command String 1 TRO Note e When the Countdown Timer expires reach 0 it will stop automatically SW 0 e If two 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 18 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 to6 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

Maestro Heritage Software Tools

Contents

Download Pdf Manuals

Related Search

Related Contents