Maestro Smart Pack User Manual 100 2G Rev.1.0 Confidential, the whole present document is the sole property of Maestro Wireless Solutions Ltd.
Revision history Rev. 0.97e Rev 1.0 Date 29Apr2013 Details First release Originated by Wallace Lee 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.
Table of contents 1. INTRODUCTION ...............................................................................................................................................................................................6 2. INSTALLATION .................................................................................................................................................................................................6 3. 2.1. CHECKING THE SMARTPACK PROGRAM .............................
7.2. 8. AT COMMAND FOR CONFIGURING DYNAMIC DNS ........................................................................................................... 28 7.2.1. AT+IPDDNSSERV command .................................................................................................................................... 28 7.2.2. AT+IPDDNSACCT command .................................................................................................................................... 28 7.2.3.
13.3. 14 CALL SCREENING .........................................................................................................................................................................................51 14.1 15 AT COMMAND FOR CONFIGURING CALL SCREENING ......................................................................................................... 51 14.1.1 AT+CSRN command ................................................................................................................
20.2.1 Counter Service Command String Syntax and explanation ................................................................................... 67 20.2.2 Reading Counter Service Status ............................................................................................................................. 67 20.3 20.3.1 Countdown Timer Service Command String Syntax and explanation ................................................................... 67 20.3.2 Reading Countdown Timer status ......
24 25 23.2 AUTOTCP/UDP ............................................................................................................................................................... 78 23.3 AT COMMAND DRIVEN TCP/UDP CONNECTION ............................................................................................................... 78 23.4 REMOTE AT COMMAND BY SMS ....................................................................................................................................
1. INTRODUCTION Maestro Smart Pack (MSP) package is a software solution for Maestro 100 2G modem.
3. GPRS AND TCP/UDP PARAMETERS SETUP GPRS related functions (Automatic and AT command driven TCP/UDP connection, PING service, DDNS support, Remote program update described in Chapter 5,6,7,8 and 17) requires GPRS connection and TCP / UDP parameters setup. This chapter will describe those required setups. 3.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.
3.2. Activating GPRS Connection For using AT command driven TCP/UDP connection (described in Chapter 5), you need to first activate the MSP GPRS connection. There are two AT commands: - AT+CGATT - AT+IPCONNECT 3.2.1. AT+CGATT command This standard AT command is to make the modem to attach to or detach GPRS network. For details please read AT command document.
AT+IPCONNECT=1,1 AT+ IPCONNECT =1,0 +CME ERROR: 3 Note: Activate GPRS connection fail OK Note: Deactivate GPRS connection success Defined Values: 0: using GSM Bearer ( Note: do NOT use this for MSP ) 1: using GPRS Bearer. 0: to stop connection 1: to start connection. Note: Before you making GPRS connection by this command make sure you have finished the following first: 1. Entered APN settings by AT+IPGPRS command Chapter 3.1.1) 2.
AT+ IPTCP =23,”S”,255.255.255.255”,0 AT+ IPTCP =? OK to set the modem to wait for TCP socket connection request (Server (listening) mode) any calling IP address allowed, port 23 (for main UART) +IPTCP: (0-65535),("C","S"),(120),(0-1) OK Note : possible argument Defined Values: The port number to be used for the TCP socket connection. Default value is 0. Valid range is 0 to 65535. Mode of TCP operation. Default value is “S”. “S” Server (Listening) mode.
3.3.2. 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=,,,,,,,,0 + IPUDP: ,,,,1 Command AT+ IPUDP? AT+ IPUDP =23,”C”,202.144.111.222”,0 AT+ IPUDP =23,”S”,255.255.255.
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. 3.3.3.
Defined Values: 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.4. Extra TCP/UDP Parameters Setup User can set additional parameters of TCP/UDP connection, including “keep alive” packet, maximum packet size, TTL and periodic PING action to monitor Internet connection 3.4.1. AT+IPOPT command This command specifies the extra TCP/UDP socket parameters.
3 specify the TTL value of the socket connection to . The value can be set from 1 to 255. default value is 64.
4. AUTOMATIC AND SELF-RECOVERY TCP/UDP CONNECTION The Auto TCP/UDP connection feature is defined for accessing serial devices over the Internet. Maestro 100 2G 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.
4.1.
4.2. AT commands for Auto TCP/UDP connection 4.2.1. AT+AUTOTCP command This command controls the Maestro 100 2G 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.
4.2.2. AT+AUTOUDP command This command controls the Maestro 100 2G 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.
4.3. AT commands for tuning AutoTCP/UDP connection 4.3.1. 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.
Option Applicable mode Serial port behavior if option enabled 1 Client / Server as client: in data mode all the time, data buffered as server: in data mode when socket connected, command mode when not (data not buffered) 2 Server (n/a) 3 Server (n/a) Command Syntax AT+AUOPT=
Note : - When #1 is enabled with client mode, the serial port of the modem will be changed into data mode without waiting socket connection. And once data enter to serial port data will be buffered and then start connecting remote TCP server. This option is good when remote TCP server is not good for keeping socket all the time. - New entered option values will become valid only after AutoTCP/UDP is disabled then re-enabled.
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. Make sure you have made the GPRS connection by AT+IPCONNECT command before making socket connection (see Chapter 24, setup examples). 5.1. AT commands for Auto TCP/UDP connection 5.1.1.
5.1.2. AT+OTCP command This command sent by the attached host to open a TCP connection to the TCP server specified by the AT+IPTCP 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.
Note : - AT+OUDP connection is exclusive to other TCP/UDP feature. See Chapter 23 (Q&A) - If UDP connection is unsuccessful or broken after connection the GPRS connection will also be disconnected. (+IPCONNECT: 1,0). So please enter AT+IPCONNECT=1,1 to reconnect GPRS before entering AT+OUDP. - Due to the nature of UDP socket connection, sending ETX characters (when DLEMODE is 1)may not be able to make disconnection.
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. 6.1. AT command for setting up and execute ping 6.1.1. AT+IPPING command Command Syntax AT+IPPING AT+IPPING= ,, , , Response syntax: +IPPING : ,, time= OK Command AT+ IPPING=2, ”210.103.11.
Timeout value in second for ping request. Recommended to be more than 10. Default value is 15. Valid range is 1 to 60. 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 Solution Ltd.
7. DYNAMIC DNS Note: To use this feature, we strongly suggest to get special GPRS service from your network operator : a. Network will assign a true public IP address to M100 2G upon GPRS activations, and b. that GPRS connection allows incoming access from public Internet to Maestro This feature lets Maestro 100 2G to login to certain Dynamic DNS service providers, to update the hostname with M100 2G current IP address. So user can access M100 2G with pre-registered hostname.
7.2. AT command for configuring Dynamic DNS 7.2.1. AT+IPDDNSSERV command Command Syntax AT+IPDDNSSERV= , Response syntax: +IPDDNSSERV: , OK Command Possible responses: AT+IPDDNSSERV=”members.dyndns.org”,8 OK Note : enter DDNS service provider’s update server 0 information AT+ IPDDNSSERV? +IPDDNSSERV: ”members.dyndns.
Defined Values: 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. Login name of the DDNS service account. Maximum length is 32 characters. Login password of the DDNS service account. Maximum length is 32 characters. 7.2.3.
return code of DDNS update server. Following table list the relationship between and Result Ret_code 1 2 good no_chg 3 4 badauth donator 5 6 7 8 9 10 11 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 maybe a negative value, contact Maestro to get details.
8. TCP TERMINAL Note: To use this feature, we strongly suggest to get special GPRS service from your network operator : a. Network will assign a true public IP address to M100 upon GPRS activations, and b. that GPRS connection allows incoming access from public Internet to Maestro This feature lets Maestro 100 2G can be connected through TCP channel, and AT commands can be sent over this channel.
Command AT+TCPTERM =2,”123456”,23,30 AT+TCPTERM=1 AT+TCPTERM=0 AT+TCPTERM ? AT+TCPTERM =? Possible responses: OK Note : configure TCP Terminal, password: 123456, port: 23, timeout:30(secs) OK Note: enable TCP terminal OK Note: disable TCP terminal +TCPTERM: 1,”123456”,23,30 OK Note display current status +TCPTERM: (0-1),(16),(1-65535),(1-65535) OK Note : possible argument Defined Values: 0 disable TCP Terminal. 1 enable TCP Terminal.
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 enables M100 to send an email via a SMTP server. This feature can save parameters like of SMTP sever name, address of sender and recipient, email subject and email body (content).
Defined Values: Port number of the SMTP server. Default value is 25. Authentication type used for authentication: 0 no authentication required (default) 1 authentication with no encryption 2 authentication used with encrypted username/password in MIME64 during AUTH LOGIN phase IP address of SMTP server (in xxx.xxx.xxx.xxx format) or an alpha numeric string format (e.g. smtp.server.
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 Email address to be stored 9.2.3. AT+EMSUBJ command This command is to save, read and delete email subject (title).
Command Syntax: AT+EMBODY= , text is entered Response syntax: +EMBODY : , Email body entered OK Command AT+ EMBODY=0,1 Possible responses: > This is email body #1 Note: enter email body with =1 +EMBODY: 1,21 OK Note: successful stored 21 characters as email body with =1 AT+ EMBODY=0,1 > This is email Note: press to abort email body entry AT+ EMBODY=1,1 AT+ EMBODY=2,1 AT+ EMBODY=? OK Note: abort to store email body with =1 +EMBODY: 1 This
9.2.5. 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 an 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.
Identification number (id) of the email body (content). Valid value is 0 to 3. '0'or missing parameter means no saved body will be used for this email. Additional email body (content) to be sent. Maximum 128 characters can be sent. will be added just after body indicated by (if available). Identification number (id) of the email body.
10. SOCKET COMMUNICATION SERVICE Similar to email sending service, this feature lets M100 to send raw TCP message, up to 256 bytes, to a TCP server. This is useful for M2M communication client to send data to server without any kind of protocol overhead. It can be also used with Command String for sending status of plug-in board. The socket communication service is one way only. Data sent in the direction from server to modem during connection is discarded. 10.1. 1.
IP address of host (in xxx.xxx.xxx.xxx format) or an alpha numeric string format (e.g. myhost.com) Maximum 120 characters Note: if alpha numeric string format is used, make sure the GPRS network has proper DNS service available. Port number of the host server. Valid range is 1 to 65535.. Number of retry after the first connection unsuccessful. Each retry will be delayed according to parameter. Default value is 0 (no retry). Valid range is 0 to 10.
AT+ SCMESS=1,1 AT+ SCMESS=2,1 AT+ SCMESS=? +SCMESS: 1 This is message body #1 OK Note: read stored message with =1 OK Note: erase message body with =1 +SCMESS: (0-2),(1-3) Note: possible argument Defined Values: Type of operation: 0 enter message body 1 read saved message 2 erase saved message Identification number (id) of the message. Valid value is 1 to 3 Note: Each message can contain up to 128 characters.
AT+ SCSEND=1,1,”extra” AT+SCSEND=? +EMSEND: -4 OK Message sending fail (cannot find host) +SCSEND: (1-10),(1-3)[,{128}] Note: possible argument Defined Values: Identification number (id) host entered using AT+SCHOST command. Valid value is 1 to 50. Identification number (id) of the saved message. Valid value is 1 to 3.. Additional message (content) to be sent. Maximum 128 characters can be sent. will be added just after message indicated by (if available).
11. REMOTE AT COMMAND BY SMS This feature is to control the modem to interpret AT command from incoming SMS, executing it, and return the result to sender by SMS. The user can enable the modem to receive AT command by incoming SMS. See following about AT+SMSAT command. 11.1. Description of the Operation Step 1 : send AT command to modem by SMS 000000AT+CSQ Step 2 : modem execute and return response by SMS +CSQ: 17,0 OK 5.
11.2. AT command for configuring AT command by SMS 11.2.1.
12. I/O TRIGGERED AT COMMAND This feature makes use of the Maestro 100 Input/Output port as a sensor. If the signal to the port match the pre-defined condition a stored AT command will be executed. User can use AT+IOAT command to set the condition and store AT command to be executed. 12.1. Description of the Operation Wiring Diagram : I/O port 1. When the I/O port is connected to battery –ve side, Switch closed : logic level low Switch opened : logic level high 2.
When set as high-to-low triggering : I/O port voltage time = T Start counting time when a when period of low signal high to low signal reach Threshold value the * See AT+IOAT command on setting Threshold value T. 12.2. AT command for configuring I/O triggered AT command 12.2.1.
Time required for the detected state to trigger the AT command exestuation. Unit is in millisecond. Valid value from 1 to 50 (0.1 sec to 5 sec). Refer to the above timing diagram in section 12.1 AT command to be executed when the I/O port is triggered successfully. The length of the command is limited to 128 characters. See section 11.3 for more details. 12.3. Notes and cautions to be taken when using I/O triggered AT command 1. The I/O port is limited to drain current 10mA max.
13. AI TRIGGERED AT COMMAND This feature makes use of the Maestro 100 2G analogue input (AI) port as a sensor. If the signal to the port match the pre-defined condition a stored AT command will be executed. User can use AT+ADCAT command to set the condition and store AT command to be executed, and using AT+ADCATLMT command to set the upper and lower limit of the sensing value. 13.1. Description of the Operation AI port 1. And external DC voltage can be connected to the AI port.
13.2. AT commands for configuring AI triggered AT command 13.2.1. AT+ADCAT command This command is to enable/disable and configure AI triggered AT command function.
13.2.2. AT+ADCATLMT command This command is to set high and low limit of AI triggered AT command. Please note these two values will be “synchronized” with the HL and LL or the AI Command String service (see Chapter 12.7). So changing the values by this command will also change the corresponding Command String values at the same time.
14 CALL SCREENING This feature enable Maestro 100 2G 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. 14.1 AT command for configuring call screening 14.1.1 AT+CSRN command This command is to enable or disable call screening feature.
Command AT+CSNW=1,”12345678” AT+CSNW=11,”12345678” AT+CSNW=3,”1qaaa” AT+CSNW=? Possible responses: OK Note : enter authorized number to location 1 +CME ERROR: 3 Note : location out of range +CME ERROR: 3 Note : non-numeric characters not allowed +CSNW: (1-10),(20) Note : possible argument Defined Values : Location of the authorized phone number to be stored. Valid range is from 1 to 10 Authorized phone number. First digit can be “+”, others must be numeric digits.
14.1.4 AT+CSND command This command is to erase authorized phone number entered. Command Syntax: AT+CSND=(,) Response syntax: +CSNR: ,…. Command AT+CSND=1 AT+CSNR=1,8 AT+CSND=? Possible responses: OK Note : erase authorized number in location 1 OK Note : erase authorized number in from location 1 to 8 +CSND=(1-10),(1-10) OK Note: possible argument Defined Values : Beginning location of the authorized phone number to be erased. Valid range is from 1 to 10.
15 MODEM STATUS CHECK AND MONITORING The Modem Status Check and Monitoring feature makes the modem can check the status of the modem in either “one shot” or periodic (per minute) mode. Modem will also report check result by SMS if result is beyond preset limit, and reset automatically if losing network connection.
3 to set the number in field as network signal trigger level for periodic mode check reporting. See section 9.1.2 for details 4 to set the number in field as input voltage trigger level for periodic mode check reporting. See section 9.1.2 for details 15.1.2 Operation of Modem Status Check and Monitoring “One Shot” mode: When user enter AT+TMODE command the modem will perform a single check and will send back the result like this: +TMODE: 1, 15, “10.111.222.
16 AUTOMATIC PIN ENTRY The Automatic Pin entry feature lets user to save a PIN code into M100 2G. When M100 2G detects a PIN (PIN1) enabled SIM on starting it will use this saved PIN code to unlock the SIM. To prevent further PIN blocking user can set minimum PIN Remaining Attempt Number as a prerequisite for the automatic PIN entry operation. 16.1 AT command for Automatic PIN Entry 16.1.1 AT+AUTOPIN command This command is to configure and enable/disable Automatic PIN Entry feature.
0 no unsolicited message (default) 1 unsolicited message +AUTOPINE: will be displayed if is 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.
17 REMOTE PROGRAM UPDATE By using this feature, user can download the new version of Maestro Power Pack 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. GPRS download file from FTP server AT commands to start download and update FTP server AT+IPFTP=21,”A’,”I”,”123.456.789”,”id”,”pwd” AT+FTPDOTA=”new_prog.
Translation of carriage return, valid values are: I image (no translation, default), A ASCII E EBCDIC Passive or Active mode valid values are: P passive (default), A active 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. login name of the user.
AT+FTPDOTA=”update1.dwl” AT+FTPDOTA=? +FTPDOTA: -3 OK Note : error on downloading file (FTP open fail) +FTPDOTA: (128)[,(128)] Note : possible argument Defined Values : File name of the file to be downloaded. Maximum 128 characters. Path (directory) name where the file is placed. Maximum 128 characters. If is omitted, program will try to download from FTP’s root (entry) directory. Maximum 128 characters.
Defined Values: 2 update process successful 3 update process unsuccessful (original program will be loaded) Note: for other result code please contact Maestro Wireless Solutions Version number of existing running Maestro Smart Pack program. 17.2 Notes and cautions to be taken on using remote program update 1. This feature is ONLY for updating new Maestro Smart Pack program. Do not use it for downloading other things.
18 COMMAND STRING - INTRODUCTION “Command String” is a set of programmable scripts originally for Maestro Heritage modem. And now it is incorporated to M100 2G. User can input sets of Command Strings to control various kinds of “Service”. Unlike AT command, Command strings can be stored inside M100 2G and can be executed upon output of certain services. 18.
19 COMMAND STRING – WRITING AND USING 19.1 Structure of Command String A single Command String is a text string composed with four fields, for example: TM 1 ST 100 Operation argument Service type Service id Operation type 19.1.1 Service type This field has two capital characters indicates the type of Service to be chosen: Field entry AL CT Service alarm Counter See Chapter 20.1 20.2 19.1.2 TM IP (*) Countdown input ports timer 20.3 20.4 SM SMS 20.
19.3 Entering and executing Command String You can use the following AT commands to store and execute Command String 19.3.1 AT+CSTR command Description: This command is used to execute a Command String directly.
Defined Values: 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 Identification number (id) of the Command String. Valid value is 1 to 50, and 80; i.e. up to 51 Command Strings can be stored. Command String with id = 80 will be executed when modem power up Command String Note: Each Command String is limited to 128 bytes.
20 COMMAND STRING – SERVICES “Service” is a kind function or tool that can be made use by Command String. There are two kinds of Services: Trigger capable When a certain pre-defined condition is matched (e.g. timer reach zero) “trigger” a stored Command String. These Services include: Alarm, Counter, Input Port, and Countdown Timer Non-Trigger capable Can only perform job when called by Command String. These Services include: SMS 20.
20.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. 20.2.
Example: Set Countdown Timer #1 to execute Command String #10 and start 600 seconds countdown TM 1 ST 600 TM 1 SW 1 TM 1 TR 10 Example: Stop Countdown Timer #1 TM 1 SW 0 Example: Cancel Countdown Timer #1 to trigger Command String TM 1 TR 0 Note: When the Countdown Timer expires (reach 0) it will stop automatically (SW 0). 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.
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 Threshold value is 1 sec. E.g.
Example: Send a message “ALERT” to phone number store in SIM phonebook #1: SM 1 SN ALERT Example: Send a message “Counter#2_value_is_20" to phone number store in SIM phonebook #1: SM 1 SN Counter#2_value_is_%CT2 20.5.
SN (additional content) %CTn %IP, %TMn %AI Send out the email with above setting plus additional content “%” to indicate “variable” options in additional content Example: Setting up EM set #1 with elements: recipient #1, cc #3, bcc #4, subject #1, content #2: EM 1 TO 1 EM 1 CC 3 EM 1 BC 4 EM 1 SU 1 EM 1 BD 1 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 o
6. 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. 20.6.3 Reading Email Sending Service status See Chapter 21 for details. 20.7 Analogue Input Service Analogue Input Service can use the signal of Analogue Input to control the execution of Command String.
AI value T=TH Trigger to execute Command String if TP=1 or TP=3 Time = T Start to count threshold time when crossing H/L Limit Time = T T=TH Trigger to execute Command String if TP=2 or TP=3 Note: Please read M100 2G manual carefully before setup. 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 20.7.3 Reading Analogue Input Service status See Chapter 21 for details. 20.
Example: Send a message SC #1 “Counter#2_value_is_20" (report counter # value): SC 1 SN Counter#2_value_is_%CT2 20.8.
21 COMMAND STRING - READING STATUS OF SERVICES 21.1 Command for reading current information of Services You can use AT command to read the info of trigger capable Services. 21.1.1 AT+CSTRSTAT Command Description: This command is to read current parameter or status of a particular service.
21.1.3 Reading Counter Service Enter AT+CSTRSTAT = “CT 1” will get Counter #1 info: CT 1 : ST 300 CV 20 a b c 21.1.4 a. Service id b. trigger value of the counter c. current value of the counter d. Command String id to be executed if trigger (0 if not to trigger) TR 3 d Reading Countdown Timer Service Enter AT+CSTRSTAT = “TM 1” will get Countdown Timer #1 info: TM 1 : CV 90 SW 0 a b c 21.1.5 a. Service id b. current value of the timer c. timer is running (1) or stop (0) d.
22 KNOWN ISSUES The Maestro 100 2G Smart Pack will affect certain other AT commands operation. Please note. 22.1 Mutually exclusive TCP/UDP functions. Following functions are exclusive to each other, i.e. if either is enabled others could not be then: AT+AUTOTCP=1 AT+AUTOUDP=1 AT+OTCP AT+OUDP 22.
23 QUESTIONS AND ANSWERS 23.1 Installation Q. If I changed my Maestro 100 2G with the MSP installed, can it be changed back to have TCP/IP feature? A. It depends. Contact Distributor or Maestro Wireless Solutions. Q. I have downloaded the dwl file, and entered AT+WOPEN=1, but I still cannot use MSP, why? A. It could be installation problem. You can issue command AT+WOPEN=0, then AT+WOPEN=4, then repeat the download procedure. If this still not help you may need to re-flash the main firmware first.
23.6 TCP Terminal Q. I have entered AT+TCPTERM=1 to enable TCP Terminal, but I cannot access Maestro by using Telnet, why? A. After power up or entering AT+TCPTERM=1, Maestro 100 2G will wait for 15 seconds before starting TCP Terminal. So please try later. Confidential, the whole present document is the sole property of Maestro Wireless Solution Ltd.
24 Examples of MSP setup and operation 24.1 To setup an 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” (APN is INTERNET) AT+IPTCP = 23,”C”,”61.167.60.1”,1 (target TCP is 61.167.60.1, port 23, client mode, TxDelay is enabled) AT+AUTOTCP=1 (open TCP socket connection) (TCP connection will start after 20 secs) OK OK OK To setup Auto connect to TCP server with IP 61.167.60.
24.3 To setup periodic ping To setup to pin an IP address every 30 minutes, disconnect GPRS if fail Commands to be entered Modem response AT+IPGPRS=1,”INTERNET” (APN is INTERNET) AT+IPPING = 2,”61.167.60.1”, 3,2,15 (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 (enable Ping every 1800secs, if ping fail then disconnect GPRS ) OK OK OK 24.
AT+IPDDNSUPD=1 (enable automatic DDNS update) AT+TCPTERM=2,”mypsswd”,1024,30 (set TCP Terminal password to “mypsswd”,port 1024 and timeout 30 secs ) AT+TCPTERM=1 (enable TCP Terminal) OK OK OK 24.7 Perform Remote program update by sending Command over SMS To download update file from ftp.maestro.com, directory “update”, filename “MSP.
24.9 Command String programming example 2 Input Port signal email 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 #1 AT Cmd/Cmd String to be entered 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.
25 COMMAND STRING QUICK REFERENCE Service Id 1 to 5 ALARM “AL” Argument and Explanation yy/mm/dd,hh:mm:ss(Date time, 0 to cancel) 0 to 50 (CS to trigger, 0 to cancel) Operation Type ST TR COUNTER “CT” Argument and Explanation 1 to 255 (Decrement) 1 to 255 (Increment) 0 (Reset) -32768 to 32768 (value to trigger 0 to 50 (CS to trigger, 0 to cancel) Service Id 1 to 5 Operation Type DE IN RS ST TR Service Id 1 to 10 Operation Type ST SW TR Argument and Explanation 1 to 2147483647 (Timer initial value)
Service Id 1 to 1 Service Id 1 to 10 Operation Type TP TH HL LL TR Operation Type TO BD SN ANALOGUE INPUT “AI” Argument and Explanation 1 to 3 (Trigger type: higher than HL, lower than LL, or both) 1 to 255 (threshold tp trigger unit in 0.