background image

T h e   M o b il e   C h o ic e   f o r   y o u r   B r o a d b a n d   I n t e r n e t

API

29

© 2015 Dovado FZ-LLC

5.7.3.1

Reading an SMS via text

sms recvtxt [ID] (returns cleartext SMS with ID or all cleartext SMS in the inbox if ID is empty)

To read a SMS via text use the command 

sms recvtxt

Example:

>> sms list
new/total
1/1
Stored IDs: 1

>> sms recvtxt 1 
From: 46XXXXXXXXX
Sent: 12-07-23 11:27:36
Alphabet: UTF-8
ID: 1

Räksmörgås

End of SMS

>> 

5.7.3.2

Reading an SMS via PDU

sms recv [ID] (returns PDU with ID or all PDUs in the inbox if ID is empty [ID:PDU])

You can list all the current PDUs in your in the inbox using: 

sms recv

This will list all PDUs using in the format ID:PDU where ID is a unique internal descriptor of that
PDU (used for removing PDUs).
Conversion is needed to see the actual contents of the PDU.

Example:

>> sms list
new/total
1/1
Stored IDs: 1

>> sms recv 1
1:07916407970900F1040B91640XXXXXXXF40000217032117263800A

>> 

5.7.4

Removing an SMS/PDU

sms del ID

First you need the ID of the PDU you want to remove. It can be obtained using the 

sms recv

command. Then to remove a SMS/PDU, type: 

sms del ID

Example:

>> sms list
new/total
0/1
Stored IDs: 1

Summary of Contents for pro tinyac

Page 1: ...T h e M o b ile C h o ic e f o r y o u r B r o a d b a n d In t e r n e t Reference Manual 8 0 0 Universal Broadband Router ...

Page 2: ...Management and Portforward Part 2 Status Overview Bar 5 Part 3 Menu System 7 7 1 HOME 7 2 INTERNET 11 3 LAN 13 4 WLAN 15 5 VPN 16 6 SMS 18 7 NAS 19 8 AUTOMATION 20 9 POSITION 21 10 SYSTEM 23 11 UPGRADE 24 12 RESTART 24 13 LOGOUT Part 4 Mobile User Interface 25 Part 5 API 25 26 1 Enabling the API 26 2 Connecting to the API 26 3 Logging in to the API 26 4 API Syntax 27 5 Router info 27 6 Upgrade via...

Page 3: ... o a d b a n d In t e r n e t 3 Contents 2015 Dovado FZ LLC 31 1 Scenarios 32 2 Frequently Asked Questions Part 7 Support 35 Part 8 Open Source Notice 35 35 1 GPL v2 Applications 39 2 GPL v3 Applications 45 3 LGPL Application 50 4 Mixed Licenses ...

Page 4: ...on and guidance 1 1 Package contents Make sure all of the listed items below are included in your package If something is missing kindly contact your reseller Router USB Mobile Broadband router Power supply Quick Wizard Guide 2 x 3dBi antennas USB extension cable Additional optional items In addition to the items above you will may require a mobile broadband USB modem in order to connect to a mobi...

Page 5: ...e router s own interface which it normally uses to communicate on the Internet PPTP Interface this interface exists when a VPN PPTP service is used When PPTP is used the router has two IP addresses to the Internet 1 5 Remote Management and Portforward Not all Mobile Broadband operators ISP and VPN providers allow external access to your router from the Internet If the provider blocks such access i...

Page 6: ... modem Yellow color indicates that the router is connected Internet but LAN and WiFi clients is disable to access the Internet due to that scheduled event in the Internet Scheduler Red color indicates that it is disconnected from the Internet Traffic Quickly displaying this month s Internet consumption in gigabytes GB on the downlink and uplink of the USB modem New FW Indicates if there is a new f...

Page 7: ...ch settings you wish to use in order to access the Internet as well as secure your wireless network 3 1 3 Troubleshooting By default the Troubleshooting Wizard is enabled If it detects during the course of your setup that there is something wrong the Troubleshooting Wizard will then advise you on what the possible faults may be Note The Troubleshooting Wizard will not operate if either the Connect...

Page 8: ... about your Internet Connection VPN which shows the PPTP shows information about PPTP Connection USB Modem shows the details of your USB modem s radio signal It will also display which network mode the router is connected to 4G 3G or 2G along with the USB Modem s unique IMEI number and the SIM card s unique IMSI number This information might be useful when dealing with your mobile operator s helpd...

Page 9: ...ou can alter the settings regarding your network connection Load preset Predefined profiles for different networks types WAN MTU Change the Maximum Transmission Unit MRU Change the Maximum Maximum Receive Unit Enable MSS Clamping Enabling MSS clamping will force the clients to use a certain MTU 3 2 4 WAN The default setting is that your operator automatically will allocate you an IP address Should...

Page 10: ... that you have registered e g example dyndns org Interface Here you can select if you should use the direct IP interface default or use the PPTP interface to update the dynamic DNS Special note for freedns afraid org Hash freedns afraid org does not use usernames instead they use a private hash signature Special note for Other Dynamic DNS provider Service URL here you enter the URL to your Dynamic...

Page 11: ...total is calculated for the month per interface These figures are automatically updated every five minute a forced update can be manually requested by pushing the Update button 3 2 7 1 Notification of Data Traffic Usage Upon enabling this feature the router can send you an SMS and or E Mail notification after a certain amount of data has been consumed by your Internet connection It will then conti...

Page 12: ... are finished View DHCP Table is a function that shows the IP and MAC addresses of all clients that has got an IP address assigned by the router 3 3 3 Port Forwarding Port Forwarding to LAN lets you specify which ports clients on the public Internet shall be able to communicate through to clients on your private network Reserved Ports is a list of ports that cannot be used to access your private n...

Page 13: ...hich can increase throughput for compatible 802 11n which also support 40MHz Please note that by selecting 40MHz you might experience incompatibility with certain devices In such case please use 20MHz The 2nd Channel drop down menu will be available once the Bandwidth has been manually set to 40MHz From there you can appoint the placement of the secondary channel to be located either below or abov...

Page 14: ...e encryption The key is case sensitive You have the possibility to define up to 4 different keys at once so that you can rotate keys in order to randomize your security WPA1 WPA2 Enterprise is based on the strong WPA PSK authentication However the authentication is done on a RADIUS authentication server For the router to negotiate with such a server the server s IP address communication port and l...

Page 15: ...ess to which you want to connect Username The VPN account username with which you want to connect if you don t know it please contact your IT administration or your VPN provider Password The VPN account password with which you want to connect if you don t know it please contact your IT administration or your VPN provider Echo timeout The PPP echo timeout value this value is normally 60 seconds Ech...

Page 16: ...he proper international format beginning with a country code for example 4670xxxxxxx If you wish to send any messages to a short service number usually only a few digits long shorter than a regular telephone number then tick in the Short Number box above the message A regular SMS supports 160 characters however the Dovado router also supports long text messages and will display how many messages y...

Page 17: ...following events New Firmware The router will check the Dovado firmware servers once a day for a new firmware release As soon as it has identified a newer release you will be sent an SMS notification from the router Restart In case the router was forced to restart itself after 3 unsuccessful connection attempts based on the settings located in the Connection Tracker A restart can also be affected ...

Page 18: ...quent SMS texts to a regular list of recipients then enter those recipients to the router s Phonebook Once inserted you can compose a new message and simply select the recipient by name All entries into the Phonebook are to be stored in the international number format It is also possible to store Short Numbers as well 3 7 NAS If you insert into a unused USB port an external USB hard drive or thumb...

Page 19: ...mages are typically uploaded to an FTP server Transfer rates tend to be somewhat higher with FTP than with the SMB protocol 3 8 AUTOMATION This menu covers Home Automation You can take control of the lighting as well as power up other appliances within your home from your computer or phone You can also control what time Ethernet LAN and WiFi clients should be able to access the Internet For furthe...

Page 20: ...r 3 8 3 Groups If you wish to cluster several appliances into a group you can tick in the various alias boxes and label them as a group This is particularly useful if you have several lamps in a specific room such as bedroom or several appliances within the same category such as lamps It is also possible to create groups of days for instance weekdays vs weekends in order to simplify clustering of ...

Page 21: ...ter s location For further information visit http www dovado com gps Custom API key It is possible to enter your own Google Maps key For further info visit https developers google com maps documentation javascript tutorial 3 10 SYSTEM The System sub menu offers you to alter some of the advanced settings within the router along with the user management 3 10 1 Users This page allows you to manage yo...

Page 22: ... redial while the router is on For the router to contain the accurate time zone you may have to manually select your region country city to make sure the router will be able to present you with the right time and date By making this selection your router will automatically update itself whenever a time change occurs throughout a year depending on the time zone you re in By default the router will ...

Page 23: ... restarted 3 11 3 Live Upgrade Live upgrade will keep your router updated with the latest firmware release available on Dovado s servers It automatically checks for new firmware once a day however it is also possible to check manually by click on the Check Firmware 3 11 4 FTP Method If you have an FTP server you have the choice to upgrade the router via FTP Once the upgrade file is on the FTP serv...

Page 24: ...other routers of the same model and firmware revision This can come in handy if performing a mass deployment of clone configurations 3 12 RESTART Push Restart in order to restart the router and initiate all the settings you have saved within the menu 3 13 LOGOUT Normally the login session will expire after 10 minutes of no activity Should you wish to manually terminate the login session then click...

Page 25: ...ation regarding your connection the GPS position in case you have a GPS dongle connected to it as well as execute Automation tasks Home Automation Wake On LAN Internet connection 5 API The Application Programmable Interface API allows you to create your own custom interface with the router You can control certain features such as Home Automation as well as manage SMS messaging ...

Page 26: ...nge 192 168 0 1 to the IP of your router If the connection was successful you will receive something similar to This is version X Y of the API SMS is enabled and HOMEAUTOMATION is enabled for you Followed by a prompt 5 3 Logging in to the API The API uses the Username and Password as specified in the Web GUI To log in as user admin type user admin When prompted for a password enter it using the fo...

Page 27: ...ENCODING ISO UCS ISO for ascii 256 Leave blank for autodetection sms recv ID returns PDU with ID or all PDUs in the inbox if ID is empty ID PDU sms recvtxt ID returns cleartext SMS with ID or all cleartext SMS in the inbox if ID is empty sms del ID 5 5 Router info To display information about the router execute the command info It will respond with a list of parameters for example Firmware_Revisio...

Page 28: ...er of SMS PDUs sms list returns number of unread read messages You can list the number of SMS PDUs on your router using sms list The first digit of the response shows the current number of unread SMS PDU s and the second digit the total amount in the inbox 5 7 2 Sending SMS The API can handle two ways of send SMS either by receiving a PDU or via UTF 8 UCS encoded text messages 5 7 2 1 Sending an S...

Page 29: ... ID returns PDU with ID or all PDUs in the inbox if ID is empty ID PDU You can list all the current PDUs in your in the inbox using sms recv This will list all PDUs using in the format ID PDU where ID is a unique internal descriptor of that PDU used for removing PDUs Conversion is needed to see the actual contents of the PDU Example sms list new total 1 1 Stored IDs 1 sms recv 1 1 07916407970900F1...

Page 30: ... command is ETB End of Transmission Block ASCII character 23d Since there can only be one instance of the API running on the Router a session that has been inactive for more than 60 seconds will be dropped in favor of a new session 5 9 1 Example code API example code for different platforms are available on http www dovado mobi 5 9 1 1 PHP Below is a sample php script that will connect to the rout...

Page 31: ...ng text socket_write socket smstxt r n strlen smstxt 3 Sending end of message socket_write socket r n 3 respons_wait socket echo Closing socket socket_write socket bye r n 6 socket_close socket echo OK n n 6 Troubleshooting Dovado routers are designed with simplicity in mind If you are experiencing difficulties with certain features or unable to get online via the router then kindly check the hint...

Page 32: ...please visit http www dovado com faq 6 2 1 My router is not connecting to the Internet Do all of the following First check if the Internet LED on the router is OFF If so continue with the following steps otherwise go to section The router indicates Internet connectivity yet I can t surf Please verify that you are able to connect to your mobile operator using the USB modem in your computer Always i...

Page 33: ...have made your ideal configuration you save it to your computer in case of future manual resets of the router To do this go to Upgrade Configurations page and extract a backup configuration file 6 2 4 My firmware upgrade seems to have failed and I cannot access my router anymore Download the latest version of the Dovado Firmware Utility Upgrader for your router and select the Rescue tab to restore...

Page 34: ... traffic The simplest way to know is to try the USB modem directly in the computer and see if messages can be sent received Following that check the USB modem s connection manager in your computer to see which SMS Service Center also known as SMS C it is using Having identified the SMS C place that number into the SMS Service Center field in your router located under SMS Settings If this does not ...

Page 35: ...RPOSE See the GNU General Public License for more details 3rd parties may obtain a complete corresponding machine readable copy of the source code of such software under the GPL GPLv2 or LGPL at http www dovado com Alternatively Dovado offers to provide such source code to you on CD ROM for a charge covering the cost of performing such distribution such as the cost of media shipping and handling u...

Page 36: ...License GPL Version 2 License usb_modeswitch Version 0 9 7 License GPL Version 2 License wireless_tools Copyright c 1997 2002 Jean Tourrilhes jt hpl hp com Version 29 License GPL Version 2 License smstools Copyright C 2006 Keijo Kasvi Version 3 1 14 License GPL Version 2 License 802 1x Copyright c 2002 2003 Jouni Malinen jkmaline cc hut fi Version 2 6 0 0 License GPL Version 2 License sispmctl C 2...

Page 37: ...tions Finally any free program is threatened constantly by software patents We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses in effect making the program proprietary To prevent this we have made it clear that any patent must be licensed for everyone s free use or not licensed at all The precise terms and conditions for copying distribution ...

Page 38: ...h the major components compiler kernel and so on of the operating system on which the executable runs unless that component itself accompanies the executable If distribution of executable or object code is made by offering access to copy from a designated place then offering equivalent access to copy the source code from the same place counts as distribution of the source code even though third pa...

Page 39: ...ESS FOR A PARTICULAR PURPOSE THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU SHOULD THE PROGRAM PROVE DEFECTIVE YOU ASSUME THE COST OF ALL NECESSARY SERVICING REPAIR OR CORRECTION 12 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MAY MODIFY AND OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE BE LIAB...

Page 40: ...rightable work licensed under this License Each licensee is addressed as you Licensees and recipients may be individuals or organizations To modify a work means to copy from or adapt all or part of the work in a fashion requiring copyright permission other than the making of an exact copy The resulting work is called a modified version of the earlier work or a work based on the earlier work A cove...

Page 41: ... any legal power to forbid circumvention of technological measures to the extent such circumvention is effected by exercising rights under this License with respect to the covered work and you disclaim any intention to limit operation or modification of the work as a means of enforcing against the work s users your or third parties legal rights to forbid circumvention of technological measures 4 C...

Page 42: ...thods procedures authorization keys or other information required to install and execute modified versions of a covered work in that User Product from a modified version of its Corresponding Source The information must suffice to ensure that the continued functioning of the modified object code is in no case prevented or interfered with solely because modification has been made If you convey an ob...

Page 43: ...e Not Required for Having Copies You are not required to accept this License in order to receive or run a copy of the Program Ancillary propagation of a covered work occurring solely as a consequence of using peer to peer transmission to receive a copy likewise does not require acceptance However nothing other than this License grants you permission to propagate or modify any covered work These ac...

Page 44: ...Others Freedom If conditions are imposed on you whether by court order agreement or otherwise that contradict the conditions of this License they do not excuse you from the conditions of this License If you cannot convey a covered work so as to satisfy simultaneously your obligations under this License and any other pertinent obligations then as a consequence you may not convey it at all For examp...

Page 45: ...he GNU Library Public License version 2 hence the version number 2 1 Preamble The licenses for most software are designed to take away your freedom to share and change it By contrast the GNU General Public Licenses are intended to guarantee your freedom to share and change free software to make sure the software is free for all its users This license the Lesser General Public License applies to so...

Page 46: ...Public License is Less protective of the users freedom it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library The precise terms and conditions for copying distribution and modification follow Pay close attention to the difference between a work based on the library and a work that use...

Page 47: ...ful when you wish to copy part of the code of the Library into a program that is not a library 4 You may copy and distribute the Library or a portion or derivative of it under Section 2 in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine readable source code which must be distributed under the terms of S...

Page 48: ... with or distribute the Library except as expressly provided under this License Any attempt otherwise to copy modify sublicense link with or distribute the Library is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compli...

Page 49: ...GES INCLUDING ANY GENERAL SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES END O...

Page 50: ...rved Permission to use copy modify and distribute this software for any purpose with or without fee is hereby granted provided that the above copyright notice and this permission notice appear in all copies THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EXPRESS OR IMPLIED INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMEN...

Page 51: ...pyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution The name of the author may not be used to endorse or promote products derived from this software without specific prior written permission THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS AS IS AND ANY EXPRESS OR IMPLIED WARRANTIES INCLUD...

Page 52: ... are met Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution Neither name of the GPSD project nor the names of its contributors ...

Reviews: