Documente Academic
Documente Profesional
Documente Cultură
Copyright 2009 10 Software Engineering Research Center National University of Computer and Emerging Sciences Lahore, Pakistan http://www.serc.org.pk http://www.nu.edu.pk
Copyright 2009-10 SERC, FAST-NU, Lahore, Pakistan. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the associated document entitled "GNU FDL 1.3". You can also get the copy at http://www.gnu.org/licenses/fdl.html.
Team
Hafeez-ur-Rehman Nida Shakeel Uzair Shahid Amna Afzal Fizza Hamid Sahar Khalid Hinna Hafeez Umer Hayat Farah Qureshi Shahram Javed Farooq Ahmed zurmalik@gmail.com Shakeel.nida@gmail.com oxairshahid@gmail.com shoutingwhisper4@gmail.com f.yrhyder@gmail.com saharkhalid@gmail.com hinnahafeezsh@gmail.com umerhayat1@gmail.com farahkq@gmail.com shahramjaved75@gmail.com farooq.ahmed@serc.org.pk
Kannel is an advanced open-source SMS (Short Messaging Service) and WAP (Wireless Application Protocol) gateway, owned and maintained by Kannel Group (http://www.kannel.org). A detailed setup and usage guide for Kannel as well as other technical documentation is available at http://kannel.org/doc.shtml.
This document is not meant to be an advanced guide for Kannel, but will only serve as an illustrated instruction set in order to setup Kannel using a pre-packaged LFS-Kannel Virtual Machine, specifically configured for the purpose of testing and using Openbravo Mobile Alerts Module. In order to get further information about Kannel, please visit http://www.kannel.org.
Setting up Kannel
Setting up Kannel, for the purpose of testing Openbravo Mobile Alerts Module, is a twostep process: 1. Connecting and configuring the GSM Modem 2. Configuring and launching Kannel
Development of the Openbravo Mobile Alerts Module was tested using a Nokia 7210 Supernova hand set (http://europe.nokia.com/find-products/devices/nokia-7210supernova). The instructions in this document assume any Nokia mobile phone as a GSM Modem, ultimately acting as SMSC.
In order to configure your Nokia mobile phone, follow the instructions below. 1. Start a Windows XP Machine (This is because drivers for Nokia mobile phones are most readily available on the Windows XP platform) 2. Download and setup device drivers for your mobile phone. In this case, setup Nokia PC Suite (http://europe.nokia.com/get-support-and-software/downloadsoftware/nokia-pc-suite). 3. Launch Nokia PC Suite 4. Connect your mobile phone with your PC using the appropriate USB data cable. System will automatically detect your modem 5. Enable the PC Suite mode from your mobile. 6. In order to verify that your mobile is properly connected with the system, open the Computer Management Console (Control Panel -> Administrative Tools -> Computer Management) and select the Device Manager option
7. Expand the Modems node. Your mobile shall be listed there under the modems node
Page 2
8. Double-click on your modem node to show its properties. Go to Diagnostics tab and click on Query Modem button to test the modem. Modem should respond to various AT commands successfully
9. Now, go to the Modem tab and note the COM port the modem is using
Page 3
10. Enable the remote communication over the telnet, since the communication between Kannel and the mobile phone will be done using a telnet channel. In order to enable telnet communication with the modem, you will need to map a TCP/IP port (used for telnet session) to the modem serial port (the COM port noted in step 9 above). This mapping will be created using tcp2com an open-source solution to bridge a TCP socket and a serial (COM) port for Windows platform. tcp2com is hosted on Source Forge .Net at http://sourceforge.net/projects/tcp2com/. tcp2com is also shipped with this release package. In order to create the mapping: a. Open the Windows Command Prompt b. Go to the directory where you downloaded the tcp2com program c. Type the following command on the command prompt d. tcp2com --install tcp/[port] com[num] [port] is the TCP/IP port number to be mapped e.g. 8888 [num] is the COM port number being used by the mobile as noted in step 9, which in this case is 5. As an illustration, see the image below
Page 4
11. Step 10 above will create a Window Service named tcp2com-5. Make sure that this service is running. Select the Services option in Computer Management console and locate the above-mentioned service. If the service is not running, start this service
12. Now, you can test if your mobile is properly configured for telnet session or not. Open a telnet session on your machine at the specified port (i.e. 8888 in this case) and type command AT. Your mobile shall respond with a message OK.
Page 5
Page 6
7. Configure the host IP and port number of your Windows XP machine to which your mobile is connected
8. Save the configuration file and exit by pressing the following keys in the given order a. ESC (Escape Key) b. :x
Page 7
Launching Kannel 9. Type the following at the command prompt kannelbearerbox /etc/smskannel.conf
10. Open another terminal by pressing the key combination ALT+F3 11. Type the following command kannelsmsbox /etc/smskannel.conf
After this step, Kannel will be successfully configured and ready to send your alerts via SMS. Now, configure your Mobile Alerts Module according to the module configuration document and start receiving the alerts on your mobile.
Summary
Just to re-cap, verify that you have completed the following steps: 1. Connected your mobile to a Windows XP machine and verified that your mobile is properly detected as a modem 2. Created a bridge between a TCP Socket and the modems COM port, using tcp2com executable 3. Properly configured Kannel 4. Launch Kannel 5. Configured the Openbravo Mobile Alerts Module
Page 8
Workstation Workstation
Kannel
Http
bearerbox
smsbox
tcp2com
Modem Drivers
Windows XP
Workstation
Page 9