MultiModem® iSMS Intelligent SMS Server Models: SF 100-G SF 400-G SF 800-G Administrator’s Guide
MultiModem® iSMS Administrator’s Guide Models: SF 100, SF 400, SF 800 Part Number S000461C Copyright © 2012 This publication may not be reproduced, in whole or in part, without prior expressed written permission from Multi-Tech Systems, Inc. All rights reserved. Multi-Tech Systems, Inc. makes no representations or warranty with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Furthermore, Multi-Tech Systems, Inc.
Contents Chapter 1 – Product Overview and Safety Information................................................................................... 7 Safety Warnings ..................................................................................................................................................... 7 Ethernet Port Caution ................................................................................................................................................ 7 Handling Precautions ........
Contents Web Interface Opens ............................................................................................................................................... 24 Navigating the Windows ....................................................................................................................................... 25 Menus ......................................................................................................................................................................
Contents Save & Restart .......................................................................................................................................................... 60 Utilities................................................................................................................................................................. 61 Utilities > Backup..........................................................................................................................................
Contents Appendix E – Time Zone Abbreviations ...................................................................................................... 116 Appendix F – End User License Agreement (EULA) ..................................................................................... 118 Appendix G – Regulatory Information ........................................................................................................ 122 Restriction of the Use of Hazardous Substances (RoHS) ......................
Chapter 1 – Product Overview and Safety Information The Multi-Tech iSMS is an intelligent Short Message Services (SMS) server that gives businesses the ability to broadcast and receive SMS text messages. The ready-to-use solution plugs into the Ethernet network and connects to the wireless network through an integrated quad-band GSM modem. Now anyone on the network can broadcast messages, which allows organizations to reach clients, subscribers, members and prospects in real-time through SMS.
Chapter 1 – Product Overview and Safety Information MultiModem iSMS Documentation User Guides All product documentation is available on the Multi-Tech website: http://www.multitech.com/man.go AT Commands The AT commands used to configure this product are described in a reference guide. You can find this guide, “GPRS AT Commands Reference Guide” on the Multi-Tech website.
Chapter 1 – Product Overview and Safety Information Front Panel of Models SF 400 and SF 800 Front Panel LEDs of Models SF 400 and SF 800 LED Description Power Lights when power is being supplied to the MultiModem iSMS. Status When functioning normally, the LED blinks. The LED is a solid light when the MultiModem iSMS is booting up, saving the configuration, restarting, or updating the firmware. Ethernet 100 Lights when a successful connection to the 100BaseT LAN is established.
Chapter 1 – Product Overview and Safety Information Installing a SIM Card for Models SF 400 and SF 800 SIM (Subscriber Identity Module) cards are required for the MultiModem iSMS to operate on a GPRS network. This section describes how to install the SIM card. Before You Begin Perform the procedure that follows—removal of chassis cover—only at an ESD workstation using an antistatic wrist strap.
Chapter 1 – Product Overview and Safety Information Modem Numbering In the Web interface, the modem tabs correspond to internal modems and use the numbering scheme shown in the illustration that follows. The row of LEDs shows where the front of the unit is. Disable unpopulated modems as described in Network Setup.
Chapter 1 – Product Overview and Safety Information Panel Mounting (SF 100) You can mount the SF 100 model using screws spaced according to the measurement shown in the illustration that follows. Note: Use either #6 or #8 pan head screws for all four mount locations.
Chapter 1 – Product Overview and Safety Information Rack or Wall Mounting (SF 400/800) The MultiModem SF 400/800 units can be rack (or wall) mounted with screws using the mounting brackets. Rack Mounting Ensure proper installation of the unit in a closed or multi-unit enclosure by following the recommended installation as defined by the enclosure manufacturer. Do not place the unit directly on top of other equipment or place other equipment directly on top of the unit.
Chapter 1 – Product Overview and Safety Information Technical Specifications Specifications SF 100 SF 400/800 Hardware Interfaces Network: 1 Ethernet 10/100BaseT Network: 1 Ethernet 10/100BaseT Console: 1 serial RS-232 Wireless Modems Dimensions Weight 1 Quad Band GSM 4 or 8 Quad Band GSM 850/900/1800/1900 MHz 850/900/1800/1900 MHz 6.4” w x 1.2” h x 6” d 17.4” w x 1.75” h x 8.5” d (16.3 cm x 3.0 cm x 15.2 cm) (44.2 cm x 4.5 cm x 21.6 cm) 1.25 lbs. SF 400: 7.75 lbs. (3.52 kg) SF 800: 8.
Chapter 1 – Product Overview and Safety Information RSS 132, 133, 102 Safety: cUL 60950-1; UL 60950-1; IEC 60950-1; AS/NZS 60950 Network compliance: PTCRB, GCF Warranty 2 years RSS 132, 133, 102 Safety: cUL 60950-1; UL 60950-1; IEC 60950-1; AS/NZS 60950 Network compliance: PTCRB, GCF 2 years * Multi-Tech Systems, Inc. recommends that the customer incorporate a 10% buffer into their power source when determining product load.
Chapter 2 – Setting up and using the iSMS Setting Up Your MultiModem iSMS New MultiModem iSMS units are preconfigured with an IP address of 192.168.2.1 and a 24 bit subnet mask (255.255.255.000). Before connecting your new MultiModem iSMS to your network and powering it up, identify the existing IP network numbering scheme of the target network. If the target network already implements a 192.168.2.xxx class C network, the unit's host IP address of 192.168.2.
Chapter 2 – Getting Started SF 100 Cabling 1. Plug one end of a RJ-45 cable into the LAN port on the MultiModem iSMS and the other end into your network or workstation interface. 2. Attach the cellular antenna. 3. Connect the provided power supply cable to the 9 volt power port on the back of the MultiModem iSMS, and plug the other end into an AC power outlet. About 30 seconds after you apply power, the unit’s front panel Status and LAN LEDs report normally.
Chapter 2 – Getting Started SF 400/800 Cabling 1. Plug one end of a RJ-45 cable into the LAN port on the MultiModem iSMS and the other end into your network or workstation interface. 2. Attach the cellular antennas. 3. Connect the provided power supply cable to the 9 volt power port on the back of the MultiModem iSMS, and plug the other end into an AC power outlet. The unit’s front panel Status and LAN LEDs report normally approximately 30 seconds after power is applied.
Chapter 2 – Getting Started Establishing TCP/IP Communication Use an IP enabled workstation with an Internet browser to setup and manage the MultiModem iSMS. Your workstation needs to be configured with a 192.168.2.x IP address and subnet mask of 255.255.255.000, to be able to communicate with a new (or factory defaulted) MultiModem iSMS (where x is not the number 0, 1, or 255, nor any other host number that may already be in use by another computer or device on the 192.168.2.x subnet).
Chapter 2 – Getting Started 5. The Local Area Connection Properties dialog box opens. 6. Select Internet Protocol (TCP/IP). 7. Click Properties. The Internet Protocol (TCP/IP) Properties dialog box opens.
Chapter 2 – Getting Started Note: If this window opens and displays your current IP configuration, record this information. This information can help you restore the workstation’s original settings after you finish configuring the MultiModem iSMS is configured. 8. To set a Fixed IP Address for the workstation, use the following IP address. a. Enter the workstation IP Address. Example: 192.168.2.x.
Chapter 2 – Getting Started Obtaining and Activating a Wireless Account Before you can use the cellular feature: ● Obtain a GSM wireless account with an activated SIM card capable of sending SMS text messages through your service provider. ● Install the SIM into the MultiModem iSMS. ● Activate your account. For further information, find the wireless activation notice on the Multi-Tech website. Follow the directions on the website to complete the activation of your account.
Chapter 2 – Getting Started Signal Strength Signal Strength Command To View Strength For the SF 400/800 models without signal LEDs, signal strength can be determined by using the following AT command: AT+CSQ. This command is the default setting on the Network Setup > Cellular Modem window. This works for the SF 100 as well.
Chapter 3 – iSMS Basics and the Setup Wizard Starting the iSMS Open a Web Browser 1. Be sure that the MultiModem iSMS is cabled and that the power is connected as shown in Chapter 2. 2. Then open a Web browser. 3. Type the IP address of your MultiModem iSMS in the address/location area of your browser: http://192.168.2.1 4. Press Enter. Login The Login window for the MultiModem iSMS Web Interface displays.
Chapter 3 – iSMS Basics and Setup Wizard Navigating the Windows Before using the Web Interface, you may find the following information about navigating through the windows and the structuring of the menus helpful. Other Options Menu Bar Window Name Sub Menu Input Area Menus Each Menu bar selection has its own sub-menu, which displays on the left side of the window. When you click one of the Main Menu choices, the first window listed in the sub-menu displays.
Chapter 3 – iSMS Basics and the Setup Wizard Table of Menus and Sub-Menus Administration System Setup – Set up the SMTP server for e-mail notifications, the names of individuals who receive notifications, and the email ID for the notifications FROM line. SNTP Client – Set up the synchronization of the MultiModem iSMS clock to real time. Admin Access – Set up the administrator's password and set an automatic inactivity disconnection interval.
Chapter 3 – iSMS Basics and Setup Wizard View Load Balance Logs View System Logs: A log of all Web access attempts. Saving System Configuration Changes There are two types of save functions within the WEB Management menu system. The first is a 'per feature' (per menu) save button. Most changes made per menu take effect immediately when you use this save function. However, some changes require a system restart. These are found individually in the Sub Menu input areas.
Chapter 3 – iSMS Basics and the Setup Wizard Configuring the MultiModem iSMS Using the Wizard Setup The Wizard Setup lets you conveniently enter the minimal setup requirements for a user based (web browser) Send SMS environment. The information you enter here carries over to other windows that require similar information. Note: For new units (units defaulted to factory settings), Received SMS is handled by the Receive API Polling feature.
Chapter 3 – iSMS Basics and Setup Wizard 4. In the Admin Password group, change the password. Change the password immediately after initial installation and also change it regularly thereafter for security purposes. ● Old Password – Enter the existing password (factory default is admin). ● New Password – Enter new password. ● Confirmation – Confirm your new password by re-entering it into this field. Note: You might want to record the new password for future reference. 5.
Chapter 4 – Using the MultiModem iSMS Web Interface You can use the Web-based configuration and management interface to set up SMS features and parameters. This chapter describes the Web Interface. Note: The antenna must be attached so the MultiModem iSMS can operate. IMPORTANT Note About Saving your Settings to Flash Memory When you have completed your MultiModem iSMS settings, you must go to the Save & Restart menu located at the top of the window under the menu bar.
Chapter 4 – Using the MultiModem iSMS Web Interface SMTP Server Enter the IP address or the resolvable name of your mail server; for example, smtp.yourdomain.com Port Enter the port number on which the mail server listens. Example: 25. Click Save. SMTP Server Authentication Some mail servers accept connection only after a user name and password are authenticated. If your server requires this, check the SMTP Server Authentication box. Then enter the User Name and Password in the next fields.
Chapter 4 – Using the MultiModem iSMS Web Interface Administration > SNTP Client Clicking the SNTP Client check box enables the SNTP client within the MultiModem iSMS. SNTP (Simple Network Time Protocol) is an internet protocol used to set up the synchronization of the unit’s clock to real time. Configuring SNTP General Configuration SNTP Client Enable or disable the SNTP Client to contact the configured server on the UDP port 123 and set the local time. Default is Enabled.
Chapter 4 – Using the MultiModem iSMS Web Interface Time Zone Configuration Time Zone Enter your time zone. Default = UTC (Universal Coordination). The greenwichmeantime.com website has Time Zone information in detail or you can find a portion of the Time Zone abbreviations in Appendix E of this manual. Time Zone Offset Enter +/- hh:mm. Default = +06:00. Offset is the amount of time varying from the standard time of a Time Zone.
Chapter 4 – Using the MultiModem iSMS Web Interface Administration > Administrative Access Use this window to set up the password that the administrator uses, to set an automatic inactivity disconnection interval and to define the TCP port on which the Web Management interface listens.
Chapter 4 – Using the MultiModem iSMS Web Interface Administration > Admin Access > Allowed Networks Use this window to set the networks that can access the MultiModem iSMS. The administrator can then add, edit and delete any network. By default, the LAN network is always allowed access to the MultiModem iSMS. In addition, the administrator can configure the IP Address and Subnet Mask as 0.0.0.0 to allow access to any network.
Chapter 4 – Using the MultiModem iSMS Web Interface Administration > Tools Use this window to reset the cellular modem. You may want to use Reset if you have lost your connection or if the modems are not functioning properly but you don't want to recycle power through the MultiModem iSMS. Reset Modem After clicking on the modem tab for the modem you want reset, click Reset. The modem corresponding to the number selected (1 – 4 for the SF 400, 1 – 8 for the SF 800) is reset.
Chapter 4 – Using the MultiModem iSMS Web Interface Administration > Factory Defaults Reset to Factory Defaults Click Factory Defaults to set all configuration parameters to the factory default settings. This includes setting the administrator account password back to "admin" and deleting all User accounts. Performing this function does NOT delete entries out of the Address Book, Groups, Inbox or Outbox databases.
Chapter 4 – Using the MultiModem iSMS Web Interface Network Setup Network Setup > IP Settings Use this window to set up your network. IP Settings – LAN The MultiModem iSMS needs to be programmed with a static IP address. The MultiModem iSMS does not support DHCP assigned IP addresses. IP Address Enter the IP Address of the LAN Interface. The factory default is 192.168.2.1. Subnet Mask Enter the Subnet Mask for the IP address configured. The factory default is 255.255.255.0.
Chapter 4 – Using the MultiModem iSMS Web Interface Network Setup > Cellular Modem Use this window to configure the cellular modems. Click the Modem# tab at the top to work with that specific modem. You configure each modem individually. Status Modem Status (SF 400 and SF 800 models only) This box is checked by default. This means that this modem is considered for use. If you do not have or want a SIM card for a particular modem, uncheck the box so that the modem is not used.
Chapter 4 – Using the MultiModem iSMS Web Interface Signal Strength Command The string entered here is sent to the cellular modem so that the signal strength LEDs can display the current signal strength. Use the following command: AT+CSQ The following table lists the meaning of the xx values in the signal strength response and explains how they correspond to the number of LEDs lit for signal strength.
Chapter 4 – Using the MultiModem iSMS Web Interface TCP Connection The TCP Connection feature is a per modem port feature that provides direct AT Command access to the modem's serial interface for troubleshooting purposes only. When you open a TCP socket on the defined TCP port number (e.g. 5000), the modem is no longer available to the unit's send and receive queues. Events that occur while the socket is open to the modem do not get logged by the system (i.e.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services Use the sub menus in SMS Services to define how the MultiModem iSMS SMS server handles incoming and outgoing SMS messages. You can also use the Send SMS menu to generate and send SMS (text) messages to other mobile devices, which are specific numbers or entries in the Address Book. SMS Services > Address Book The Address Book contains a list of cellular recipients (mobile end points) to which the MultiModem iSMS can send SMS messages.
Chapter 4 – Using the MultiModem iSMS Web Interface Address Book Click Add to display the Add a Phone Number window. Add a Phone Number Note that fields marked with an asterisk are required. Name Enter the name of the person you want to add to the SMS Phonebook. The maximum number of characters is 50 including spaces and punctuation. Phone Number Enter the mobile phone number of person you are adding. The maximum number of characters is 50 including spaces and punctuation.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services > Groups Use this window to create groups of recipients (names and phone numbers of mobile end points). Groups allow you to send SMS messages to many individuals using only a group name. A group is made up of entries from the Address Book. You can create up to 50 groups.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services > International Number Use this window to enable SMS messaging to international numbers. International numbers are identified according to the number of digits. Disable International Number If Disable International Number is checked (this is the default), SMS messages can be sent to phone numbers limited by the maximum allowed digits, as entered in the Maximum Digits field.
Chapter 4 – Using the MultiModem iSMS Web Interface MultiModem® iSMS System Administrator’s Guide 46
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services > SMS Settings Use this window to set general system settings related to SMS encoding format, time & date format and network registration. Extended ASCII 8-bit (ISO-8859-1) Set as Factory Default Enabling this mode allows the MultiModem iSMS to pass characters in the text message that are made up of 8 bits instead of 7 bits (1 byte characters 0x80 through 0xFF).
Chapter 4 – Using the MultiModem iSMS Web Interface Configuration dd/mm/yyyy mm/dd/yyyy yyyy-mm-dd Where dd represents the day as 2 digits, mm represents the month as 2 digits and yyyy represents the year as 4 digits. Save Click Save. Periodic Reregistration This feature causes all modems in the unit to re-register (un-register and then reconnect) with the cellular network at the selected interval. This feature can prevent the appearance of the MultiModem iSMS Server being 'camped' onto the network.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Text Enter the text of the message you want to send. -orYou can choose a Pre-Configured Message that you set up on the Triggers > Pre-Configured SMS window. Click the PreConfigured Message text to access a list of pre-configured messages. After the pre-configured message appears in the SMS Text field, you may continue to edit the contents of the message/SMS Text field. Unicode options are also available, please see Unicode Use below.
Chapter 4 – Using the MultiModem iSMS Web Interface Modem Select a specific modem from which to send the message, or use the default of “Any”. Priority Set the priority level for the message to be sent. When messages enter the queue to be sent, the priority levels are compared and the messages flagged as High are sent first, followed by Normal and Low. Options: Low, Normal (default), High.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services > SMS API This feature helps you use the MultiModem iSMS Application Program Interface (API). HTTP API and TCP API are Send SMS APIs (for sending SMS messages to mobile endpoints on the cellular network). Both methods can be enabled and uses simultaneously. SMS Messages received from the cellular network are handled by the Receive API process.
Chapter 4 – Using the MultiModem iSMS Web Interface Non Polling Receive API Configuration This group helps you select which method of Receive API is implemented by the MultiModem iSMS server (how SMS Messages received from the cellular network are handled).There are two methods: ● Polling: the received SMS is left in the Receive SMS queue until your application queries for it using an HTTP GET.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services > Load Balancing This feature provides a single interface to your Send SMS application when multiple units are needed for increased throughput. When multiple iSMS units are available on a network, they can be set up to work together to share the outgoing message load. This is achieved by designating one unit to be the Master and subsequent units (up to 4) to be Slaves.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services > Inbox This window displays a list of all messages received by the cellular modem port. There is an Inbox per modem port. Each listing includes the sender's number, the message received, and a timestamp. Click on the individual modem number tabs for a list of messages received by that modem. SF100 Note: SF100 models require a "Save to Flash" be performed for the Inbox and Outbox records to be retained upon system restart.
Chapter 4 – Using the MultiModem iSMS Web Interface SMS Services > Outbox The Outbox is for the unit as a whole. This window chronologically lists sent messages and includes Message ID, Sending unit, who submitted the message, receiver's number, the message sent, and the timestamp. To determine the specific modem port on which the SMS was transmitted, note the exact time and date of the message and then review the Sent SMS Log found in the Trace Logs menu.
Chapter 4 – Using the MultiModem iSMS Web Interface Triggers Use the four Triggers windows to: ● Establish a list of users who are authorized to trigger a broadcast. ● Set up broadcast triggers. ● Set up action triggers. ● Compose and save pre-configured messages. Triggers > Authentic List Use this window to set up a list of users who are authorized to trigger a broadcast. This list is made up of entries found in the Address Book.
Chapter 4 – Using the MultiModem iSMS Web Interface Add a Broadcast Trigger Note that the fields marked with an asterisk are required. This is a setup window; no messages are sent from this window. Trigger Message Type in a code or word that triggers the sending of the Broadcast Message. Broadcast Message Type in a message that is broadcast when the trigger code or word is received, or click Pre-Configured Message if you want to use one of these messages as your broadcast message.
Chapter 4 – Using the MultiModem iSMS Web Interface Triggers > Action Triggers Action Triggers are the codes or words sent from a remote cell phone and received by the MultiModem iSMS – the trigger executes the action associated with it. This is a setup window; no messages are sent from this window. The trigger codes or words along with the authentication function may be configured for each trigger action.
Chapter 4 – Using the MultiModem iSMS Web Interface Table of Trigger Codes and Trigger Actions Trigger Code/Word ADD ADDG To add an entry in the address book To add a group name and an entry. Note: The same action trigger message is used for creating a group name and adding an entry to a group. So, in the interface there is one configuration for both.
Chapter 4 – Using the MultiModem iSMS Web Interface Triggers > Pre-Configured SMS Use this window to compose and save pre-configured messages. Pre-Configured SMS Click Add to open the Add a Pre-Configured SMS window. Add a Pre-Configured SMS An asterisk indicates a required field. Pre-Configured SMS Enter the text for your Pre-Configured SMS Message. Encoding Type Select the encoding type to be used from ASCII, Extended ASCII or Unicode. Default is ASCII.
Chapter 4 – Using the MultiModem iSMS Web Interface Utilities > Backup Utilities Utilities > Backup The Backup window has two functions. First, it lets you save all MultiModem iSMS configuration files into one file for storing externally (Export Backup). Second, it is used to import and apply a configuration backup file (Import Backup from Remote Client).
Chapter 4 – Using the MultiModem iSMS Web Interface Utilities > Firmware Upgrade Use this feature to upgrade the firmware on the MultiModem iSMS to the latest version. You can download Multi-Tech firmware upgrades from Multi-Tech website. Before upgrading the unit's firmware: ● Save to Flash and then reboot the iSMS server. ● Back-up the unit's configuration. ● Stop using the iSMS Server while it is being upgraded. The upgrade process requires the Send API functions within the iSMS server be disabled.
Chapter 4 – Using the MultiModem iSMS Web Interface Import & Export Address Book Import & Export Address Book > Import Use this window to import contact information from a CSV formatted file. The process allows you to select which fields (values) in the CSV file to import. Duplicate records—where all values of the record are identical to the existing record found in the unit's Address Book— are not imported.
Chapter 4 – Using the MultiModem iSMS Web Interface Example: Excerpt from a .
Chapter 4 – Using the MultiModem iSMS Web Interface 65 MultiModem® iSMS System Administrator’s Guide
Chapter 4 – Using the MultiModem iSMS Web Interface Import & Export Address Book > Export Use this window to export the contents of the MultiModem iSMS Address Book. The export creates a CSV file with 4 fields (values) per record: Firstname,Lastname,Description,Phone-Number. This .csv file is then ‘tarred’ and zipped. The created .csv file is ideal for importing it into a different MultiModem iSMS server. It can also be imported by any other application that supports .
Chapter 4 – Using the MultiModem iSMS Web Interface Statistics & Logs Statistics & Logs > System Information The System Information window provides the following information: System Information ● Product Model Number ● Firmware Version ● MAC Address ● Entries in the Address Book Live Details ● Date and Time ● System Uptime ● Memory Utilization 67 MultiModem® iSMS System Administrator’s Guide
Chapter 4 – Using the MultiModem iSMS Web Interface Statistics & Logs > SMS Statistics The SMS Statistics window provides the following information by individual modem: SMS Statistics (SF 400/800 can select modem number): SIM Status - Indicates the presence of a SIM card and if the modem port is enabled or disabled. Signal Strength - See Signal Strength section in Chapter 2. Messages in Inbox - The number of messages received by the modem since the MultiModem iSMS server booted up.
Chapter 4 – Using the MultiModem iSMS Web Interface Statistics & Logs > Load Balancing Statistics When load balancing is set up with multiple units, this section is populated with statistics corresponding to the workload shared. Load Balancing Statistics Slaves List of possible slave units. Load Load for specific slave unit, or ‘Disabled’ for units not participating in load balancing. Jobs Distributed The number of jobs that have been given to the specific unit.
Chapter 4 – Using the MultiModem iSMS Web Interface Statistics & Logs > Log Traces The Log Traces window provides detailed information about SMS messages, API functions, and the SMS system per modem: SMS Logs (Sent, Received, Failure, Live) Send API Logs (Status, Failure, HTTP API Live, TCP API Live) Receive API Logs (Live, Failure) Load Balance Logs System Logs The number of logged messages depends on the amount of memory. Typically, the log can store information for about 500+ messages.
Chapter 5 – Using the NonAdministrative User Interface This chapter covers the Web Interface available to non-administrative users. Non-administrative users have access to the Send SMS menu and an Outbox tied to their account. Users browse to the address of the MultiModem iSMS, login using the name and password created by the administrator and can then send messages from the SMS Services > Send SMS window. Note: The Administrator uses the SMS > Send SMS Users window to identify and set up users.
Chapter 4 – Using the Non-Administrative User Interface SMS Services > Send SMS This is the window from which users send SMS text messages (original text or pre-configured messages). The window options here are the same options available to the administrator. SMS Services > Outbox This window is also available to users. It lists the SMS text messages sent. The list includes the receiver's number, the message sent, and a timestamp.
Chapter 6 – SMS Examples Verifying the SIM Card is Installed and Activated To verify that the SIM is installed correctly and that it is activated. 1. Power up the MultiModem iSMS. Wait until the Status LED and the LS LED are blinking before continuing. Make sure all setup procedures and connections have been made. See Chapter 2. 2. Open the Web browser, enter the IP address, and login to the MultiModem iSMS. See Chapter 3. 3. Go to the Network Setup > Cellular Modem window. 6. 73 a.
Chapter 6 – SMS Examples 10. Check the Outbox and observe that the message was sent. 11. Check the Inbox and observe that the message was received. This verifies that the cellular modem is functioning. Note: Sometimes you may have to refresh this window and wait several minutes for the cellular provider to deliver the message. 12. Go to the SMS Services > Address Book. Observe that the trigger SMS text message was processed and the name and phone number were added to the address book.
Chapter 6 – SMS Examples Creating a Broadcast Message for Future Use In this example a school wants to be prepared to send a message that school is closed for the day. The Administrator creates a Trigger Message word Snow and the following Broadcast Message: School is closed today. This example assumes that a Group called Parents has been created and that SF 100 stands for the Administrator's cell phone number. 1. Go to the Triggers > Add a Broadcast Trigger window. a.
Appendix A – Application Programming Interface (API) This appendix defines the Application Programming Interface (API) provided for sending and receiving SMS through the MultiModem iSMS. Use the API to integrate the MultiModem iSMS Send and Receive SMS capability into your custom application. APIs are defined to send and receive SMS using HTTP or TCP protocols. The packet formats and handshakes are provided in the next section “Send SMS API”.
Appendix A – Application Programming Interface (API) SMS API HTTP API This section describes how to configure the "HTTP Send API" by using the MultiModem iSMS web admin interface. HTTP Send API Status: Enable “HTTP Send API Status” to send SMS / query status using HTTP API. By default, HTTP Send API is disabled. HTTP Port: Configure the port to service the HTTP Send API.
Appendix A – Application Programming Interface (API) HTTP Send API Format Each "HTTP Send API Request" consists has four parts: ● The first part is the destination, that is, the MultiModem iSMS IP and HTTP port number. ● The second part is the API call which is the query; therefore, it has a '?' post-fixed to the call. ● The third part is for authentication, which is in the form of a username and password. ● The fourth part is the message parameters. Where: portnumber is optional.
Appendix A – Application Programming Interface (API) Authenticating API Requests The system needs to authenticate any API request. As such, the authentication credentials are included in the "Send SMS URL" or “Send SMS TCP” command. user - The username of the account, which has a maximum of 50 bytes. passwd - The password of the account, which has a maximum of 50 bytes. This user is Admin or the configured Send Users.
Appendix A – Application Programming Interface (API) 1 to 8 for SF 800 0 for any modem (Send API job is distributed using all available modems) If modem is not specified in the request, send API job is distributed using all the available modems. to The mobile number where the SMS is delivered. This number is given in double quotes. The maximum size of each recipient’s number is 50 bytes. text The message text to be sent.
Appendix A – Application Programming Interface (API) Sending to an Address Book Name The API can be used to send the message to a name in the MultiModem iSMS address book. If the name does not exist in the address book, the message is dropped. HTTP API format is: http://192.168.2.1[:portnumber]/sendmsg?user=user1&passwd=user1&cat=1 [&enc=0][priority=3][&modem=2]&ton=”bob”&text=message -orhttp://192.168.2.
Appendix A – Application Programming Interface (API) To The name in the address book where the SMS is to be delivered must be given within double quotes. The maximum size of each recipient's name is 50 bytes Text The message text to be sent. Enable Extended ASCII in the MultiModem iSMS to send both ASCII and extended ASCII characters. By default, Extended ASCII is disabled and the message can have only ASCII characters.
Appendix A – Application Programming Interface (API) Sending to a Group You can use the API to send SMS to a pre-defined group. The group must exist in the MultiModem iSMS. If the group does not exist, the message is dropped. HTTP API format is: http://192.168.2.1[:portnumber]/sendmsg?user=user1&passwd=user1&cat=1 [enc=1][priority=1][&modem=4]&group=”admin”&text=message -or- http://192.168.2.
Appendix A – Application Programming Interface (API) If modem is not specified in the request, send API job is distributed using all the available modems. Group The pre-defined group names must be in double quotes. The maximum size of group name is 50 bytes Text The message text to be sent. Enable Extended ASCII in the MultiModem iSMS to send both ASCII and extended ASCII characters. By default, Extended ASCII is disabled, and the message can have only ASCII characters.
Appendix A – Application Programming Interface (API) Sending a Broadcast Trigger Message You can use the API to send a broadcast trigger message to the MultiModem iSMS. HTTP API format is: http://192.168.2.1[:portnumber]/sendmsg?user=user2&passwd=user2&cat=2[& enc=0][&modem=5]&text=message -or- http://192.168.2.1[:portnumber]/sendmsg?user=user2&passwd=user2&cat=2 [&enc=2][&modem=5]&text=message should be hexadecimal form -or- http://192.168.2.
Appendix A – Application Programming Interface (API) If Unicode is enabled, a maximum of 70 characters can be sent. Despite the spanned SMS value set, the maximum number of characters allowed in the text field is: 160 for ASCII 140 for Extended ASCII 70 for Unicode Characters entered beyond the allowed limit are truncated. Use the API to send a trigger message to the MultiModem iSMS.
Appendix A – Application Programming Interface (API) Sending an Action Trigger Message Use this API to perform a predefined action. HTTP API format is: http://192.168.2.1[:portnumber]/sendmsg?user=user1&passwd=user1&cat=3 [&enc=0]&text=message -or- http://192.168.2.1[:portnumber]/sendmsg?user=user1&passwd=user1&cat=3[&enc=2]&text=message should be hexadecimal form Example: Configured action trigger for adding preconfigured SMS as 41;42;43 (with enc=2).
Appendix A – Application Programming Interface (API) Examples for action trigger with enc=2: To Add an entry in the Address book: Configured trigger: 41;42;43 (with enc=2) Name: 61;62;63;64 (abcd) Phone number: 39;38;38;36;30;39;38;38;36;30 (9886098860) http://192.168.2.1[:portnumber]/sendmsg?user=user1&passwd=user1& cat=3[&enc=2]&text=41;42;43;3a;61;62;63;64;3a;39;38;38;36;30;39;38;38;36;30 Here 3a is the equivalent hexadecimal for semi-colon.
Appendix A – Application Programming Interface (API) To delete an entry in the Address Book: Configured trigger: 47;48;49(with enc=2) Name: 61;62;63;64 (abcd) Phone number: 39;38;38;36;30;39;38;38;36;30 (9886098860) With Name and Number: http://192.168.2.1[:portnumber]/sendmsg?user=user1&passwd=user1&cat=3[&enc=2]&text=47;48;49;3a;61;62;63 ;64;3a;39;38;38;36;30;39;38;38;36;30 With Name only: http://192.168.2.
Appendix A – Application Programming Interface (API) Specifying modem for a cat=3 job is not applicable. Action trigger is executed even if modem is specified. text The trigger message text to be sent. Enable Extended ASCII in the MultiModem iSMS to send both ASCII and extended ASCII chars. By default, Extended ASCII is disabled, and the message can have only ASCII characters. If Unicode is enabled (if enc is not specified in request), ensure SMS text is only in hexadecimal form.
Appendix A – Application Programming Interface (API) HTTP Query API Format Processing the "Send API" and sending the message takes some time. So, only an apimsgid is returned as a response to the "Send SMS API". Query API can be used to query the status of a Send. It returns the status of a message submitted earlier. HTTP API format is: http://192.168.2.
Appendix A – Application Programming Interface (API) Error Codes Error Code Error Description Response to 601 Authentication failed Send API, Query API 602 Parse error Send API, Query API 603 Invalid category Send API 604 SMS message size is greater than 160 chars Send API 605 Recipient overflow Send API 606 Invalid recipient Query API 607 No recipient Send API 608 MultiModem iSMS is busy, can’t accept this request Send API, Query API 609 Timeout waiting for a TCP API request S
Appendix A – Application Programming Interface (API) TCP API Configuration of the "TCP Send API" Using the MultiModem iSMS Web Admin Interface TCP Send API Status: Enable “TCP Send API Status” to send SMS / query status using TCP API. By default, TCP Send API is disabled. TCP Port: Configure the port to service the TCP Send API. Default is 2040. Note: MultiModem iSMS can be accessed ONLY from the preconfigured allowed networks. Example: To access the MultiModem iSMS 204.26.122.125 from 125.63.78.
Appendix A – Application Programming Interface (API) value is separated by a semi-colon. Example: 0645;41;646) 3 - SMS text is in decimal form. Each decimal Value length is maximum 5, and each decimal value is separated by a semi-colon. Example: 1605;65;65300). Note: Maximum decimal value allowed is 65535. If enc is not specified in the send API request, default enc is the configured settings in SMS settings page. enc=2, if Unicode is enabled. enc=1, if Extended ASCII is enabled.
Appendix A – Application Programming Interface (API) Sending a Job to a Slave MultiModem iSMS From Master MultiModem iSMS You can use the TCP API to distribute the Job Load from Master MultiModem iSMS unit to a slave unit when load balancing is enabled in the master and with the slaves properly configured.
Appendix A – Application Programming Interface (API) e.g.
Appendix A – Application Programming Interface (API) Receive SMS API The Receive API feature is implemented in two modes: 1. Non-Polling Mode 2. Polling Mode Note: By Default, Polling mode is configured. Non Polling Mode Receive SMS API Process: ● Upon receipt of an SMS message and based on the configuration, the MultiModem iSMS sends the SMS to the HTTP or TCP server. ● If the post interval is zero seconds, the MultiModem iSMS uploads the message immediately upon receipt of it.
Appendix A – Application Programming Interface (API) HTTP Receive API – Non-Polling Mode Configuration of the "Non-Polling Mode HTTP Receive API" Using the MultiModem iSMS Web Admin Interface POST Packet Format with Authentication POST /cgi-bin/postquery.cgi HTTP/1.1 HOST: 192.168.2.2:80 User-Agent: MultiModem iSMS/1.40 Accept: text/xml, application/xml, application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8, application/msword, application/vnd.ms-powerpoint, image/png, */* Accept-Language: en-us; en;q=0.
Appendix A – Application Programming Interface (API) POST Packet Format without Authentication POST /ismsResponse_1.4x.rb HTTP/1.1 HOST: 172.17.20.1:80 User-Agent: MultiModem iSMS/1.41 Accept: text/xml, application/xml, application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png, */* Accept-Language: en-us; en;q=0.50 Accept-Encoding: gzip, deflate Accept-Charset: ISO-8859-1, utf-8;q=0.7, *;q=0.
Appendix A – Application Programming Interface (API) TCP Receive API – Non-Polling Mode Configuration of the "Non Polling mode TCP Receive API" Using the MultiModem iSMS Web Admin Interface TCP Receive API Request without Authentication From: MultiModem iSMS/1.40 Authentication: OFF Data-Length: 123 1:19525945092 +17635280856 08/10/15 07:29:32 26632HTTP Message text.
Appendix A – Application Programming Interface (API) TCP Receive API Request with Authentication From: MultiModem iSMS/1.40 Authentication: OFF Data-Length: 123 smsuser1 smsuser1 1:19525945092 +17635280856 08/10/15 07:29:32 26632HTTP Message text. Above payload comprised of: ● Username, Password if authentication is enabled and configured. ● Receiving modem number details: If receiving modem’s SIM number is configured then field has modem index:SIM number.
Appendix A – Application Programming Interface (API) Polling Mode Receive SMS API Process: ● Upon the receipt of request from TCP/HTTP application, the MultiModem iSMS responds with the SMS received based on the filter condition in the request and availability. Notes: ● Enabling the Non-Polling Mode Receive API disables the Receive API in Polling Mode. ● Disabling the Non-Polling Mode Receive API enables the Receive API in Polling Mode provided the API Ports are configured.
Appendix A – Application Programming Interface (API) Receive API – Polling Mode Receive API polling mode has two commands. The querycount? command and the recvmsg? command. querycount? The query count command is used to determine the number of unread SMS messages in the MultiModem iSMS receive queue. recvmsg? The receive message command is used to retrieve the unread SMS messages from the receive queue. Once a message is retrieved (read), it cannot be read again.
Appendix A – Application Programming Interface (API) HTTP Query Request using browser: http://192.168.2.1:81/querycount?user=admin&passwd=admin TCP Query Request: /querycount?user=admin&passwd=admin Successful responses for the query count are in the following format: Count: Value ‘Value’ gives the number of unread messages.
Appendix A – Application Programming Interface (API) Query to receive unread messages (recvmsg?) Examples: HTTP: Get /recvmsg?user=admin&passwd=admin[&options of your choice defining up to how many you want to receive at one time and received during what specific period]HTTP/1.1\r\n HTTP request using the browser to read 10 unread messages for a specific set of dates: http://192.168.2.
Appendix A – Application Programming Interface (API) Command responses (continued) Recvmsg? Successful responses to the recvmsg? command are in the following format: Packet_end_flag Unread_available Msg_Count Msg_index_1 Number Date Time Encode type Message Msg_index_2 Number Date Time Encode type Message Msg_index_N Number Notes: ● Packet_end_flag: 0 – More packets to continue; 1 – End of the packets. ● Unread_available: 1 – Unread Messages available; 0 – No Unread Messages available for the request.
Appendix A – Application Programming Interface (API) HTTP HTTP Receive API Response to recvmsg? command:
Appendix A – Application Programming Interface (API) TCP TCP Receive API Response to recvmsg? command: From: MultiModem iSMS/1.40 1 1 3 Msg_index_1 +919742204905 09/07/24 11:56:52 Unicode 0B880B870B890B900B920B930B930B930B930B940B930B930B940BB80BCA0BCB0BB90B9E0B9E0BA30BAF0B AE0BAA0BA90BA40BAF0BB20BB50BB70BB80BB80BB90BB9 Msg_index_2 +919742204905 09/07/24 11:40:48 ASCII MultiModem iSMS easy way to send bulk SMS.
Appendix A – Application Programming Interface (API) Error Codes 109 Error Code Error Description Response to 601 Authentication Failed Send API, Query API, Receive API 602 Parse Error Send API, Query API, Receive API 604 Filtering with SMS Text whose message size is greater than 280 chars (70 * 4 for Unicode is the maximum possible size of the SMS received by the MultiModem iSMS wireless modem) Receive API 605 Recipient Overflow Send API, Receive API 608 Server Busy Send API, Receive API
Appendix B – Table of Commonly Supported Subnet Addresses This appendix lists commonly supported subnets organized by address. Network Number Hosts Available Broadcast Address 255.255.255.128 N.N.N.0 N.N.N.1-126 N.N.N.127 /25 N.N.N.128 N.N.N.129-254 N.N.N.255 Network Number Hosts Available Broadcast Address 255.255.255.192 N.N.N.0 N.N.N.1-62 N.N.N.63 /26 N.N.N.64 N.N.N.65-126 N.N.N.127 N.N.N.128 N.N.N.129-190 N.N.N.191 N.N.N.192 N.N.N.193-254 N.N.N.
Appendix B – Table of Commonly Supported Subnet Addresses N.N.N.240 N.N.N.241-254 N.N.N.255 Network Number Hosts Available Broadcast Address 255.255.255.248 N.N.N.0 N.N.N.1-6 N.N.N.7 /29 N.N.N.8 N.N.N.9-14 N.N.N.15 N.N.N.16 N.N.N.17-22 N.N.N.23 N.N.N.24 N.N.N.25-30 N.N.N.31 N.N.N.32 N.N.N.33-38 N.N.N.39 N.N.N.40 N.N.N.41-46 N.N.N.47 N.N.N.48 N.N.N.49-54 N.N.N.55 N.N.N.56 N.N.N.57-62 N.N.N.63 N.N.N.64 N.N.N.65-70 N.N.N.71 N.N.N.72 N.N.N.73-78 N.N.N.79 N.N.N.80 N.N.N.
Appendix B – Table of Commonly Supported Subnet Addresses 112 N.N.N.32 N.N.N.33-34 N.N.N.35 N.N.N.36 N.N.N.37-38 N.N.N.39 N.N.N.40 N.N.N.41-42 N.N.N.43 N.N.N.44 N.N.N.45-46 N.N.N.47 N.N.N.48 N.N.N.49-50 N.N.N.51 N.N.N.52 N.N.N.53-54 N.N.N.55 N.N.N.56 N.N.N.57-58 N.N.N.59 N.N.N.60 N.N.N.61-62 N.N.N.63 N.N.N.64 N.N.N.65-66 N.N.N.67 N.N.N.68 N.N.N.69-70 N.N.N.71 N.N.N.72 N.N.N.73-74 N.N.N.75 N.N.N.76 N.N.N.77-78 N.N.N.79 N.N.N.80 N.N.N.81-82 N.N.N.83 N.N.N.84 N.N.N.
Appendix B – Table of Commonly Supported Subnet Addresses N.N.N.208 N.N.N.209-210 N.N.N.211 N.N.N.212 N.N.N.213-214 N.N.N.215 N.N.N.216 N.N.N.217-218 N.N.N.219 N.N.N.220 N.N.N.221-222 N.N.N.223 N.N.N.224 N.N.N.225-226 N.N.N.227 N.N.N.228 N.N.N.229-230 N.N.N.231 N.N.N.232 N.N.N.233-234 N.N.N.235 N.N.N.236 N.N.N.237-238 N.N.N.239 N.N.N.240 N.N.N.241-242 N.N.N.243 N.N.N.244 N.N.N.245-246 N.N.N.247 N.N.N.248 N.N.N.249-250 N.N.N.251 N.N.N.252 N.N.N.253-254 N.N.N.
Appendix C – Antennas for the MultiModem iSMS RF Specifications GSM 850 EGSM 900 GSM 1800 GSM 1900 Frequency RX 869 to 894 MHz 925 to 960 MHz 1805 to 1800 MHz 1930 to 1990 MHz Frequency TX 824 to 849 MHz 880 to 915 MHz 1710 to 1785 MHz 1850 to 1910 MHz RF Power Stand 2W at 12.5% duty cycle 2W at 12.5% duty cycle 1W at 12.5% duty cycle 1W at 12.
Appendix D – Waste Electrical and Electronic Equipment Directive (WEEE) Waste Electrical and Electronic Equipment (WEEE) Directive The WEEE directive places an obligation on manufacturers, distributors and retailers to take-back electronic products at the end of their useful life. A sister Directive, ROHS (Restriction of Hazardous Substances), complements the WEEE Directive by banning the presence of specific hazardous substances in the products at the design phase.
Appendix E – Time Zone Abbreviations This list represents a portion of the abbreviations used for different Time Zones. All of those listed here are valid entries for the MultiModem iSMS products.
Appendix E – Time Zone Abbreviations HAA Heure Avancée de l'Atlantique North America - 3 hours HAC Heure Avancée du Centre North America - 5 hours HADT Hawaii-Aleutian Daylight Time North America - 9 hours HAE Heure Avancée de l'Est North America - 4 hours HAP Heure Avancée du Pacifique North America - 7 hours HAR Heure Avancée des Rocheuses North America - 6 hours HAST Hawaii-Aleutian Standard Time North America - 10 hours HAT Heure Avancée de Terre-Neuve North America - 2:30
Appendix F – End User License Agreement (EULA) Multi-Tech Systems, Inc. Multi-User Software License Agreement IMPORTANT - READ BEFORE OPENING OR ACCESSING SOFTWARE This is a basic software license granted by Multi-Tech Systems, Inc., a Minnesota corporation, with its mailing address at 2205 Woodale Drive, Mounds View, MN 55112. This is a legal agreement between you (either an individual or a single entity) and Multi-Tech Systems, Inc.
Appendix F – End User License Agreement (EULA) optionally repair any defect, or replace it. This warranty is void if the failure has resulted from accident, abuse, or misapplication. A Software Registration Card must be on file at MTS for this warranty to be in effect. In all other respects, the MTS software is provided AS IS. Likewise, any other software provided with MTS software is provided AS IS.
Appendix F – End User License Agreement (EULA) I am not a citizen, national, or resident of, and am not under the control of the government of: Afghanistan, Cuba, Iran, Iraq, Libya, Montenegro, North Korea, Pakistan, Serbia, Sudan, Syria, nor any other country to which the United States has prohibited export. I will not download or by any other means export or re-export the Programs, either directly or indirectly, to the above countries, nor to citizens, nationals or residents of the above countries.
Appendix F – End User License Agreement (EULA) If this package contains multiple media formats (e.g., both 3.5" disk(s) and CD-ROM), they are provided only to facilitate use at a single site. Neither this Software, nor its accompanying documentation may be modified or translated without the written permission of Multi-Tech Systems, Inc. This agreement shall be governed by the laws of the State of Minnesota.
Appendix G – Regulatory Information Restriction of the Use of Hazardous Substances (RoHS) Multi-Tech Systems, Inc. Certificate of Compliance 2002/95/EC Multi-Tech Systems, Inc. confirms that this product now complies with the chemical concentration limitations set forth in the directive 2002/95/EC of the European Parliament (Restriction Of the use of certain Hazardous Substances in electrical and electronic equipment - RoHS) These Multi-Tech Systems, Inc.
Appendix G – Regulatory Information Information on HS/TS Substances According to Chinese Standards 依照中国标准的有毒有害物质信息 根据中华人民共和国信息产业部 (MII) 制定的电子信息产品 (EIP) 标准－中华人民共和国《电子信息产品污染控制管理办法》（第 39 号），也称作中国 RoHS，下表列出了 MultiTech Systems Inc.
Appendix G – Regulatory Information 47 CFR Part 15 Regulation This equipment has been tested and found to comply with the limits for a Class A digital device, pursuant to 47 CFR Part 15 regulations. The stated limits in this regulation are designed to provide reasonable protection against harmful interference in a commercial environment.
Index A F Action Triggers ....................................................... 58, 59 Address Book in SMS Services..................................... 42 Address List Format ...................................................... 66 Admin Access ............................................................... 34 Administration > Admin Access ................................... 34 Administration > Admin Access Allowed Networks .... 35 Administration > Factory Defaults ................................
Index Network Setup > IP Settings ......................................... 38 Non-administrative users............................................... 71 O Obtain a Wireless Account ............................................ 22 Open a Web browser ..................................................... 71 Outbox ........................................................................... 55 P Panel Mounting ............................................................. 12 Password Changing ..................
