SMS Tools User Guide
Contents
1. error if no profile number is selected and there is no stored last active profile number WWW netcommwireless com SMS Tools User Guide 11 gt NetCommWireless M2M Series Routers List of valid variables Where x is a profile number 1 6 If no profile is specified variables are read or written to for the current active profile If a profile is specified variables are read or written to for the specified profile number x RDB VARIABLE SMS VARIABLE ki NAME NAME IN ink profile x iplocal epee NN WAN IP address 202 44 185 111 wwan O radio informatio rssi 3G signal strength 65 dBm n signal strength statistics usage current usage 3G data usage of Rx 500 bytes Tx 1024 bytes Total current session 1524 bytes or Rx O byte Tx O byte Total O byte when wwan down statistics usage current wanuptime Up time of current 3G 1 days 02 30 12 or O days 00 00 00 session when wwan down wwan O system networ band Current 3G frequency WCDMA 850 k status current band HEAD AWRITE DESCRIPTION Profile RW link X User username or 3G username Guest could also return null usernamex link profile x pass password or 3G password Guest could also return null password link profile x auth type authtype or 3G Authentication pap or chap authtypex type link profile x enable Head link profile x apn profile no apn user pass auth iplocal status link profile x user profile 1 Te2. Disable Send Ack SMS for Set Command Enable 9 Disable Send Ack SMS to Fixed Number 9 SMS Sender Number Fixed Ack SMS Number send Error SMS for Get Set Exec Command Enable Disable Send Error SMS to Fixed Number 9 SMS Sender Number Fixed Error SMS Number Max Diag SMS Tx Limit messages per DAY v 0 100 messages sent Limit the maximum number of diagnostic text messages to be sent within a certain time period The current messages sent count automatically resets atthe beginning af the designated time unit For example the counter will resetto 0 at 1 00 2 00 for HOURS 00 00 for DAY 00 00 Monday for WEEK and the 1st day of the month for MONTH White List for Diagnostic or Execution SMS Messages Incoming diagnostic or execution SMS messages are first checked with this White List f the sender and password of the message do not match any ofthe destination numbers and passwords in the list the message is ignored and an error message is sent either ta the sender or a predefined destination Destination numbers can be easily added from SMS Inbox Outbox pages using the Add White List button up to a maximum of 20 entries 01 0412345678 B Save Figure 6 Diagnostics and Command Execution Setup Enable Authentication Enable or disable checking the sender s phone number against the allowed sender White List for incoming Diagnostics Command Execution SMS messages If authentication is enab
3. User Guide 9 Ea gt NetCommWireless M2M Series Routers Where PASSWORD is the password if configured for the corresponding sender number specified in the White List iy Multiple commands can be sent in the same message if separated by a semicolon i For Example get VARIABLENAMET get VARIABLENAME2 get VARIABLENAME3 PASSWORD get VARIABLENAMET get VARIABLENAME2 set VARIABLENAME VALUE1 set VARIABLENAME2 VALUE2 PASSWORD set VARIABLENAME1 VALUE1 set VARIABLENAME2 VALUE2 set VAHIABLENAMESZ VALUES a d d iy If required values can also be bound by an apostrophe double apostrophe or back tick For Example set VARIABLE VALUE jj set VARIABLE VALUE set VARIABLE VALUE get VARIABLE A password if required only needs to be specified once per SMS but can be prefixed to each command if desired PASSWORD get Variable1 get VARABLE2 PASSWORD set VARIABLE1 VALUE1 set VARIABLE2 VALUE2 If the command sent includes the reboot command and has already passed the White List password check the device keeps this password and executes the remaining command line after the reboot with this same password For Example amp PASSWORD execute reboot get Variable1 get VARABLE2 amp PASSWORD execute reboot PASSWORD get Variable1 get VARABLE2 Commands are not case sensitive however variable names and values are c
4. if the server accepts incoming text based message The TCP UDP address can be an IP address or domain name The port number range is from 1 to 65535 Please refer to your TCP UDP based SMS server configuration for which port to use For Example If someone sends a text message and Redirect to TCP is set to 192 168 20 3 and 2002 this text message is Stored in the router and forwarded to 192 168 20 3 on port 2002 at the same time SMS Configuration for Remote Diagnostics Enable Remote Diagnostics Enable or disable the Remote Diagnostics feature If this setting is enabled all incoming text messages are parsed and tested for if they contain Remote Diagnostics commands If Remote Diagnostics commands are found the router executes those commands This feature is disabled by default i Note It is possible to adjust settings and prevent your router from functioning correctly If this occurs you will need to perform a factory reset in order to restore normal operation It is highly recommended that you enable security when using this feature See the Inbox Outbox section below for further details SMS Tools User Guide WWW netcommwireless com A NetCommWireless M2M Series Routers i New Message This page allows vou to send a new text message to multiple recipients Services SMS New Message Create New Message Destination Number 001 Destination Number 002 Destination Number 003 LI o Destination Number 00
5. 4 LI oo Destination Number 005 LI Po O OE SMS Test Message 28 11 2012 Message Bady 27 160 Maximum number of characters can vary depending on coding scheme In GSM bit mode 160 characters can be sent within a message butthe limit changes to 50 characters ifthe message includes special characters In UCS2 mode most of special character set can be sent but only 50 characters can be sent within a single message Figure 3 SMS New Message page A new SMS message can be sent to a maximum of 100 recipients simultaneously After sending the message the result is displayed next to the destination number as Success in blue or Failure in red There are 10 recipient entry fields shown on this page by default but you can increase or decrease this number by pressing the 4 or button at right side of the last recipient entry field You can select to enable or disable individual message recipients by selecting the checkbox beside each entered number After entering the desired recipient numbers type your SMS message in the Message Body field and then click the Send button WWW netcommwireless com SMS Tools User Guide 5 Zw NetCommWireless Inbox Outbox You can check all sent SMS messages in the SMS Outbox or you can read delete reply or forward an SMS message to another mobile device from the SMS Inbox M2M Series Routers SMS message senders can be added to the White List which is used to secure the Remote D
6. Diagnostic commands acknowledgements and error notification messages sent to remote destination are stored in Inbox Outbox oecurity In order to provide security for SMS command execution it is recommended that all SMS commands be subject to successful authentication against the White List as well as setting a password for each phone number entered This prevents unauthorised or accidental execution of SMS commands SMS Command format Generic Format for reading variables get VARIABLENAME PASSWORD get VARIABLENAME Generic Format for writing to variables set VARIABLENAME VALUE amp PASSWORD set VARIABLENAME VALUE Generic Format for executing a command execute COMMAND amp PASSWORD execute COMMAND Replies Upon receipt of successfully formatted and authenticated if required command the router will reply to the SMS in the following format TYPE SMS CONTENTS Nes Get Command VARIABLENAME VALUE Pe Set Command Successfully set VARIABLENAME to VALUE Only sent if the acknowledgment message function is enabled Execute Command Successfully executed command COMMAND Pe Where VARIABLENAME is the name of the value to be read amp Where VARIABLENAME x is the name of another value to be read amp Where VALUE is the content to be written to the VARIABLENAME amp Where COMMAND is a supported command to be executed by the device e g reboot WWW netcommwireless com SMS Tools
7. ES gt NetCommWireless M2M Series Routers SMS Tools User Guide NetComm Wireless Limited 18 20 Orion Road Lane Cove NSW 2066 Sydney Australia t 61 2 9424 2000 f 61 2 9424 2010 www netcommwireless com ACN 002 490 486 A A NetCommWireless M2M Series Routers Introduction The SMS tools application has been developed to include basic SMS functionality such as sending a message receiving a message and redirecting an incoming message to another destination You can also utilise this functionality to read and change run time variables on the router Basic functionality supported Ability to send a text message via a 3G network and store in permanent storage amp Ability to receive a text message via a 3G network and store in permanent storage Ability to forward incoming text messages via a 3G network to another remote destination which may be a TCP UDP server or other mobile devices Ability to read run time variables from the device e g uptime and send result to a remote destination which may be a TCP UDP server or other mobile devices amp Ability to change live configuration on the device e g connection APN Ability to execute supported commands e g reboot Note Before performing the instructions in this guide please ensure that you have the latest firmware version on your router Visit http www netcommwireless com products m2m wireless to find your device and download the latest firmware Pl
8. G connection Password1234 execute pdpcycle1 Send SMS to disconnect the Not Required execute pdpdownt 3G connection Password1234 execute pdpdown1 Send SMS to connect the Not Required execute pdpup 3G connection Password1234 execute pdpupi Send multiple get command Not Required get wanip get rssi Password1234 get wanip get rssi Send multiple set command Not Required set apni 3netaccecss set password1 NetComm Password1234 set apn 3netaccecss set password NetComm WWW netcommwireless com SMS Tools User Guide 18
9. ase sensitive SMS Tools User Guide WWW netcommwireless com 10 ES gt NetCommWiireless M2M Series Routers List of valid commands which can be used in conjunction with the execute command pdpoycle pdpdown and pdpup commands can have a profile number suffix x added Without the suffix specified the command operates against the current active profile or last active profile DESCRIPTION Disconnect if connected and reconnect the 3G connection If a profile number is selected in the command try to disconnect reconnect the specified profile in pdpoycle or pdpcvclex case the profile is active If no profile number is selected try to disconnect reconnect the current active profile Reports an error if no profile number is selected and there is no currently activated profile Disconnect the PDP If a profile number is selected in the command try to disconnect the specified profile in case the profile is active If no profile number is selected try to disconnect the current active profile Reports an error if no profile number is selected and there is no currently activated profile pdpdown or pdpdownx Heconnect the PDP If a profile number is selected in the command try to connect with the specified profile If no profile number is selected try to pdpup or pdpupx connect to the last active profile The router will check the currently activated profile and disconnect this profile before executing the command Reports an
10. dband SMS provider E P incoming text messages to the remote destination Redirect to TCP Forward incoming text messages to the remote TCP destination defined TEE Eod aa iecleon The TOP port on which to connect to the remote destination on Redirect to UDP Forward Incoming text messages to the remote UDP destination defined UID Dee To ree The UDP port on which to connect to the remote destination on Enable Remote Enable diagnostics to be performed by a specially crafted Diagnostics SMS message Table 1 SMS Setup descriptions WWW netcommwireless com SMS Tools User Guide 3 gt NetCommWireless M2M Series Routers SMS Configuration for Redirection Incoming text messages can be redirected to another mobile device and or a TCP UDP message server Redirect To Mobile You can forward incoming text messages to a different destination number This destination number can be another mobile phone or 3G router phone number To disable the feature simply delete the number in the Redirect To Mobile field and click the Save button For Example If someone sends a text message and Redirect To Mobile is set to 0412345678 this text message is stored on the router and forwarded to 0412345678 at the same time Redirect to TCP amp TCP Port Redirect to UDP amp UDP Port You can also forward incoming text messages to a TCP UDP based destination The TCP or UDP server can be any kind of public or private server
11. ease also ensure that the SMS service is available on your SIM oetup General SMS functionality is enabled by default You can open the Setup page in order to configure additional settings From the menu bar along the top of the screen navigate to Services SMS Setup k Services Li PPTP Fsg All Status LAM PPPoE M System Information System Up Time 00 15 17 Router Version Hardware Phone Module Model FH BSz 3 1 340220T MAC Address 02 00 60 18 BB 33 M Ethernet Port Status LAN V Up 100 0 Mbps FDX HY Mobile Broadband MBB Profile Name Interface Status APN Local IP Remote IP Profile 1 mnet0 Up telstra intemet 100 166 103 188 0 0 0 0 Figure 1 Services SMS Setup SMS Tools User Guide www netcommwuwireless com 2 A gt NetCommwWireless M2M Series Routers Services SMS Setup General SMS Configuration SMS Enable Disable 9 Enable Disable Messages Page 10 50 Encoding Scheme 9 csM7 Bit O ucs2 SMSC Address SMS Configuration for Redirection Redirect to Mobile ag Redirect to TCP Po IP address or domain name TCP Portto Redirect __ 165535 Redirect to UDP PI IF address or domain name UDP Portto Redirect 165535 SMS Configuration for Remote Diagnostics Enable Remote Diagnostics 2 Enable Disable Figure 2 SMS Setup page CMM DERNTION The short message service center SMSC address is the AMS a number of your mobile broa
12. iagnostics feature Select the sender or recipient number and click the Add White List button Services SMS Inbox Received Messages Total 5 Messages 61412345676 614125857654 61412345676 614125867654 61412345676 ae cs From Time Message Fri amp pr 1 14 28 21 2011 sms test 0010 Fri amp pr 1 14 28 21 UTC 2011 Fri amp pr 1 14 28 20 2011 sms test 009 Fri Apr 1 14 28 20 UTC 201 Fri Apr 1 14 28 18 2011 sms test 008 Fri Apr 1 1428 19 UTC 2011 Fri Apr 1 14 28 18 2011 sms test 007 Fri Apr 1 142815 UTC 2011 Fri Apr 1 14 28 17 2011 sms test 006 Fri amp pr 1 1428 17 UTC 2011 Figure 4 SMS Inbox Services SMS Gutbox Sent Messages Total 5 Messages 61412345675 6141295857654 61412345675 51412887554 61412345676 ET Eh II p s De SMS Tools User Guide 6 To Time Message Fri Apr 1 14 31 50 2011 SMS TA test 005 Fri Apr 1 1431 50 UTC 201 1 Fri Apr 1 14 31 48 2011 ce TA test 004 Fri Apr 1 1431 49 UTC 2011 Fri Apr 1 14 31 48 2011 SMS TA test 005 Fri Apr 1 14 31 48 UTC 2011 Fri Apr 1 14 31 47 2011 SMS TA test 002 Fri Apr 1 14 31 47 UTC 2011 Fri Apr 1 14 31 46 2011 SMS Ts test 001 Fri Apr 1 14 31 46 UTC 2011 Figure 5 SMS Outbox WWW netcommwireless com E gt NetCommWireless M2M Series Routers Diagnostics and Command Execution Setup Services SMS Diagnostics amp Command Execution Setup SMS Diagnostics amp Command Execution Configuration Enable Authentication 9 Enable
13. led the router will check if the sender s number exists in the White List If it exists the router then checks the password in the incoming message against the password in the White List for the corresponding sending number If they match the Diagnostics Command is executed If the number does not exist in the White List or the password does not match the router does not execute the incoming Diagnostics Command Execution SMS message This is enabled by default o Note It is highly recommended to enable security when using the Diagnostics Command Execution feature Send Ack SMS for Set Command Enable or disable sending an acknowledge message after execution of a Set command If disabled the router does not send any acknowledgement after execution of a Set command This can be useful to determine if a command was received and executed by the router This is disabled by default Send Ack SMS to Select destination to send an acknowledgement message to after the execution of a Set command If Fixed Ack SMS Number is selected the acknowledgement message will be sent to the predefined number in the Fixed Ack SMS Number field WWW netcommwireless com SMS Tools User Guide Ea gt NetCommWireless M2M Series Routers If the SMS Sender Number is selected the acknowledgement message will be sent to sender directly The default setting is to use SMS Sender Number Fixed Ack SMS Number Enter the destinatio
14. lstra internet username password chap 202 44 185 111 up link profile x pass Or link profile x auth type profilex Write link profile x iplocal apn user pass auth link profile x status Telstra internet username password SMS Tools User Guide WWW netcommwireless com 12 E gt NetCommWireless M2M Series Routers SMS Diagnostics Examples The examples below demonstrate various combinations of supported commands This is not a complete list To obtain a complete list please contact NetComm Wireless DESCRIPTION AUTHENTICATION INPUT EXAMPLE set aon1 Telstra internet Not Required set apn2 3netaccecss Send SMS to change APN l Password1234 set apn1 Telstra internet Required Password1234 set aon2 3netaccecss Send SMS to change the 3G Not equired set username NetComm username 2 Password1234 set username NetComm Send SMS to change the 3G Not required set password NetComm password Password1234 set password NetComm Send SMS to change the 3G set authtype pap authentication Password1234 set authtype pap Required Password1234 execute reboot 00 234 execute reboot Send SMS to check the NotRequired Send SMS to check the 3G Not Required number Password1234 getimei 234 get imei Send SMS to check the Not Required current band Password1234 get band Send SMS to Disconnect if Not Required execute pdpcycle disconnected and reconnect the 3
15. n number to which acknowledgement messages are sent after the execution of a Set command oend Error SMS for Get Set Exec Command Enable or disable the sending of an error message resulting from the execution of a Get Set Exec command If disabled the router does not send any error notifications after the execution of a Get Set Exec command This function is disabled by default Send Error SMS to Select the destination of the error messages from the execution of a Get Set Exec command If Fixed Number is selected any error messages will be sent to the predefined number in the Fixed Error SMS Number field If SMS Sender Number is selected any error messages will be sent to the sender directly The default setting is to use SMS Sender Number Fixed Error SMS Number The destination number to which error messages from the execution of a Get Set Exec command should be sent Max Diag SMS Tx Limit You can set the maximum number of acknowledgement and error messages sent when an SMS Diagnostics and or Command is executed You can set the maximum limit on a per hour day week or month basis The default is to send a maximum of 100 messages per day You can check the current sent message count by looking next to the Max Diag SMS Tx Limit field If the maximum number has been exceeded you can also reset sent the message counter by pressing the Reset button The Total transmitted message count resets afte
16. r a reboot or at the beginning of the time frame specified ey Note Times displayed are in UTC format For example amp lf the time frame is set to HOUR and the current time is 04 30 then the counter will reset to zero at 05 00 lf time frame is set to DAY and current date and time is 04 30 17th of March then the counter will reset to zero at 00 00 18th of March ftime period is set to WEEK and current date and time is 04 30 Saturday then the counter will reset to zero at 00 00 on the coming Monday If time period is set to MONTH and current date and time is 04 30 17th of March then the counter will reset to zero at 00 00 1st of April SMS Tools User Guide WWW netcommwireless com 8 ES gt NetCommWiireless M2M Series Routers White List A maximum number of 20 entries can be stored in the router If Authentication is enabled any incoming Diagnostics Command Execution SMS messages are processed only if the sender s number exists in White List and the message password matches with the password specified in the White List One blank entry is shown by default and you can add or delete an entry by pressing the 4 or button The White List numbers and passwords can be cleared by pressing the Delete button To add a number to the white list enter the desired phone number and password then click the Save button Message Storage for Diagnostic Messages Diagnostic messages
Download Pdf Manuals
Related Search