 |
 |
 |
 |
 |
 |
Kylix SMS Server User Manual 2.1
General
In the info-era while networking technology takes the lead, many software products have integrated high-efficient communication modes, among which the most frequently used are Email and instant communication software (ICQ etc.) Email is comparatively easy to be integrated into your software products, but it has some defects, such as lag-behind sending, easy to lose, virus and spam mails, which will hugely increase the maintenance time and cost of the whole system. As a newly emerging communication solution in recent year, the instant communication software is able to send message timely to others, which solved many problems that existed with Email. But in the meantime it relies on hardware like PC or PDA, and can’t exist without PC or PDA. On the other hand, our generally used instant communication software are huge in number but lack of uniform standard, for each of them is an independent system, and hard to be integrated into your software products.
SMS is a very effective communication mode, which enables more quick, direct and inexpensive interconnection for people. With the unceasing development of the mobile communication technology, the per capita mobile phone possession rate is already very high, and the hardware is not a problem any more. SMS enable people to communicate with each other anytime at any place, make itself the favorite communication means for many people. In light of this, many companies hope to incorporate this most effective communication mode into their software products. But you may find yourself in front of a bunch of problems when you are ready to upgrade your system, which includes: A large amount of modification to your original software, the choosing of right hardware equipment, facing unfamiliar development of hardware application, complicated protocols and numerous instructions, which costs you huge amount of time and money to finish these work, and sometimes you have to drop this most effective communication tool. Through our investigation into the customers using related products, we find many companies are expecting a quick, simple and inexpensive way to use SMS in their software products, and this is the very reason why we come up with this software.
Kylix SMS Server is a SMS serving software specially designed to add SMS functions to other software products. With this software, you can easily incorporate the SMS functions into your software. There is absolutely no need for you to understand the principal of SMS, the development of SMS hardware equipment, the complicated AT command set and protocols, the encoding rules of PDU and Unicode, the similarity and difference of every model of hardware equipment, your original software structure (whether B/S or C/S), the development environment of your original software (whether Java, PHP, VC or Delphi), and the operating system of your server (whether Windows or Linux). All you need to do is install Kylix SMS Server onto your software system, connect a GSM device to a serial port of your PC that can attach the database, and run this software after configuring several simple parameters. It only costs you 10 minutes to supply your software with SMS-based communication functions, which will make your whole system communicate in a more quick and effective way, thus add a shining point to your software products.
Screen shots
|
|
|
|
|
|
|
|
|
Features
Kylix SMS Server is especially designed for adding SMS functions into your software product quickly and effectively. This software uses the method of circularly checking the SMSOut Table in the database, and then encodes the message need to be sent based on SMS format of GSM network, and send the encoded message to GSM Network with mobile phone or GSM Modem, and then the GSM Network will send this message to the recipient. After the message is successfully sent, the software will mark the message in the database as Already Sent. After the recipient receives the message and answers it, the software will insert the answered message into the SMSIn Table of the database. Once finish inserting action, it will delete the message in the mobile phone or GSM Modem. When you need to send message with your software, you only need to insert the message and the recipient mobile phone number into the SMSOut Table of the database, and then the message will be sent out very soon. If you want to work with the message answered by the recipient, you only need to handle the newly received message in the SMSIn Table of the database.
Kylix SMS Server acquired good compatibility through connecting to database with ADO, it can work with various kinds of databases such as MS Access, MS SQL Server, Oracle, MySQL and PostgreSQL etc. The database may running with Windows, Linux or other operating systems. As long as you have one client or server PC running Windows with your software, you can install the GSM device on that PC, and run this software on it as a SMS server for your system.
Kylix SMS Server is able to encode the sent message with PDU format of GSM network, and it will automatically detect the language used by the sent message, and handle the message with GSM 7Bits, ASCII or Unicode, it supports both single-byte language and multi-bytes language (e.g. Chinese). For long message, it can be sent in long message mode or split messages mode. You can also set the SMS center number. The software can dynamically display the status of the hardware, such as Sending, Receiving and Idle, and automatically retry for failed outgoing message. All process will have detailed log, enables you to retrieve received, unsent, sent and failed messages for statistic or checking purpose.
Kylix SMS Server supports various brands of GSM mobile phones such as Nokia, Siemens, Sony-Ericsson as well as several models of GSM Modems, such as Wavecom, Siemens, Motorola and Ericsson etc. This software is able to automatically identify the brand and model of the hardware, and use optimum parameters accordingly. It can read information about hardware including brand, model, IMEI, Battery Level and Signal Quality etc. This software also supports PIN function; the security of the system is thus protected.
Kylix SMS Server provides with full log and warning mechanism. It will save the system-running status of software and hardware into a log file, the size of it has been restricted, so you don’t have to worry that it will occupy too much hard disk space. You can use SMS message to report system-running status on a daily basis, such as the number of sent messages, received messages, unsent messages, and hardware equipment, database connection status etc. Meanwhile, the administrator can also send SMS message to get the current system-running status. SMS warning functions can also monitor running status of the database in almost real time, when the hardware or network fails and causes database disconnected, Kylix SMS Server can immediately send warning message to specified mobile phone, get administrator to handle the problem as soon as possible. When using GSM mobile phone as SMS hardware equipment, you can set the software to send a SMS message promptly to the specified phone number when the battery level is low, to remind administrator to charge the mobile phone in time, which can avoid the system down caused by low-battery off of the mobile phone.
As you can see from the above features that, Kylix SMS Server not only helps you easily incorporate the SMS functions into your software product, but also provide your system with more Running Status Reports at a speed faster than ever before, which will facilitate the maintenance of your system, reduce the maintenance cost and improve the maintenance efficiency.
Kylix SMS Server can work as an external optional module of your software product, beside that, you can also include this software as part of your software, install it along with your system. You can even choose to “OEM” this software as your company name, making it an integrated part of your product.
Hardware and software
requirements
1. There should be at least one PC running Windows with the system server or
client, such as: Windows9X, Windows Me, Windows 2000, Windows XP and Windows
2003.
2. There should be one existed database in the original software, or you can
create a new one.
FAQ: Is Kylix SMS Server able to work with software without database?
3. A GSM mobile phone or GSM Modem, we recommend GSM Modem.
FAQ: How to choose GSM Device?
4. A SIM card with SMS service.
Installation
1. Choose one PC running with Windows from your system as SMS server, and each
following step should be done on that PC.
2. Double click "SMSServerSetup. exe " to install this software. When the
installing finished it can run automatically, then the Configuration dialog box
will be displayed for you to set the parameters.
3. The software installed with a MS Access database file "SMSDemo.mdb", 2 tables
in this file are used for sending and receiving message. If you are first times
use this software we suggest you use the default database, and then go to step
5. If you want to use the database of your own software, open "ODBC Data Source
Manager" in Control Panel, and build a DSN based on the information of your
database.
4. Choose Database Tab Page of the software, and then enter DSN and other
database information such as login user name and password. Set SQL scripts
according to the names of the tables and fields of your database. If you don’t
have SMS In/Out table in your software yet, we suggest you use default value.
Please refer to "Configuration" on next chapter for detailed explanation.
How to: Configuration of Database
5. Follow the instruction of your GSM device, connect your device to a serial
port or USB port, or align it with the infrared port, turn on the device and
wait about 30 seconds before the device properly logged itself into GSM network,
and then go on with the following step.
FAQ: How to choose GSM device?
6. Choose Device Tab Page, and then choose the right port number and baud rate
according to the user’s manual of your GSM device, and enter SMS center number.
If your SIM card asks for PIN code, please enter the proper PIN code. Leave it
blank if PIN code is not required.
7. Click Apply button after complete parameter setting. Locate Kylix SMS Server
icon in Windows tray, and then right click on it, choose "SMS Server Start" from
the menu to start the service.
8. Choose Information Tab Page and wait for about 10 seconds before you can see
correct GSM device parameters, otherwise you should check if the port number and
baud rate of your GSM device is properly set. If there are unsent SMS messages
in your SMSOut Table, then you can see the number of the messages in "Unsent"
field, otherwise you should check the parameter settings of the database.
9. Select "send-receive SMS" from start menu, the database file will be opened by MS Access. Modify any record in SMSOut table, change the value in Phone field to receiver's phone number, and change the value of status field to 0. Wait several seconds, before receiver's phone will receive the message. Send a message with a mobile phone to the number of the GSM device, and wait several seconds, after the GSM device receives the message, open SMSIn table and you can see the received message.
10. When the software is running, status in "Service Status" of Information Tab Page, and you will find the icon displaying current status in Windows tray. There are 3 modes of status altogether, Running, Stopped and Error. In case any errors appear, please open the "Configuration" dialog box, check each option is correctly set, the database is well connected and the GSM device is working properly.
11. Upgrade your software, insert
SMS messages need to be sent into the SMSOut Table, and query SMSIn table when
you want to check answered SMS messages. Now the SMS functions of your software
are ready for use.
Parameter Setting Reference
1. Device Tab Page
FAQ: How to choose GSM device?
Port Number: when the IR or blue tooth GSM device connects to your PC through virtual serial port, you should choose the virtual serial Port Number rather than IR port.
COM Baudrate: please refer
to your GSM device instruction manual, usually it would be 9600, 19200 or 57600.
FAQ: How to set
Connection Mode and Port Number.
Retry Interval(s): the waiting time before retrying when error sending
message. Increase this value when you encounter errors in sending SMS in batch,
and this will decrease the sending speed.
Retry Times: times of retry if sending message fails.
SMS Center Number: leave it blank if you have set it in your SIM Card.
You can also set SMS Center number with your mobile phone.
PIN Code: leave it blank if your SIM card does not require PIN code.
Concatenated SMS Mode: use Concatenated SMS mode.
FAQ: What is Concatenated SMS mode?
2. Database Tab Page
Connection: ADO connection
string or ODBC DSN or OLE DB udl file.
User: database user name.
Password: user password.
Interval(s): the time interval for database querying. The smaller value
means more promptly sending but heavier database load, and the larger value
means less promptly sending but lighter database load.
SMSOut select SQL: to query messages need to be sent, among which
<MSGID>,<PHONE>,<MSGBODY> are escape sequences, and no other value should be
used.
SMSOut update SQL: to update the sent result to the database, among which
<RESULT>,<MSGID> are escape sequences, and no other value should be used.
SMSIn insert SQL: to insert the received messages into the database,
among which <PHONE>,<MSGBODY>,<TIME> are escape sequences, and no other value
should be used.
How to: Configuration of Database
3. Message Tab Page
Sending period limit: set
messages to be sent in specified period.
Start sending time: the start time for the sending period.
End sending time: the close time for the sending period.
DB Connection Lost Warning: when the database connection is broken, it
will send warning message to the specified phone.
Send Daily Report: send report at specified time every day.
Report Time: time for sending the report message.
Battery Low Warning: send warning message to specified phone when battery
level is low.
Start Service when OS starts: start SMS service when Operating System starts.
4. Information Tab Page
Manufacturer: the brand of
GSM device.
Model: the Model of GSM device.
IMEI: the Sequence Number of GSM device.
Battery Level: current battery level of GSM device.
Signal Quality: current signal quality of GSM device.
Sent: accumulated sent messages.
Unsent: number of unsent messages in the database.
Received: accumulated received messages.
Failed: accumulated failed sending messages.
5. Gateway Tab Page
POP3 Server: Email server domain or IP address.
POP3 Account: Email account.
POP3 Password: account password.
POP3 Port: Email server POP3
port, default port is 110.
Query Interval: Polling interval, minimum
value is 60s.
Test POP3: test the POP3 settings.
Email Content: send Email body to mobile phone.
Email Address: send Email
sender address to mobile phone. If both Email Content and Email Address are
unchecked, software only send Email subject to mobile phone.
Default Number: if Number Prefix string is not found in Email subject,
the SMS will be sent to this number.
Number prefix: identifier string
of the receptor number. If this string is not found in Email subject, the SMS
will be sent to Default Number. At least one of Default Number and Number Prefix
must be set to use Gateway functions.
6. About Tab Page
Device Code: hardware
identify code of GSM device, which should be supplied during registration.
Registration Code: registration code you purchased.
Register: register the software with the registration code you purchased.
Order Online: Purchase
the software online.
Configuration of Database
Kylix SMS Server exchanges data
with your software through database, so you need to build two tables
according to certain rules.
1. SMSOut table records messages need to be sent, which should include the
following fields:
MsgID, Phone,
MsgBody, Status
2. SMSIn table records messages received, which should include the following
fields:
Phone, MsgBody,
RecTime
You can use other field names, so long as you can match these fields with the escape sequence in the three SQL scripts. The software uses a MS Access database by default, where you can see time format (#<TIME>#) in the insert script, and you can modify it into "<TIME>" in case you are using other databases. Escape sequence is the section enclosed by "<" and ">", which takes the same format with the following examples.
select msgid as <MSGID>, phone as <PHONE>, msgbody as <MSGBODY> from smsout where status=0
update smsout set status=<RESULT> where msgid=<MSGID>
insert
into smsin(phone, msgbody, rectime) values('<PHONE>',
'<MSGBODY>', #<TIME>#)
FAQs
1. How do I run this software as soon as possible, I want to try if it works
before adding these feature to my software and database, what should I do?
2. How to choose GSM Device?
3. Does the software
support GPRS or CDMA Modem?
4. How to Set
Connection Mode and Port Number?
5. What is Concatenated SMS Mode?
6.
Is Kylix SMS Server able to work with software without database?
7. Why there are some unsent messages in "Unsent" of Information Tab Page, and
the software does not send it automatically?
8. I am using Linux server on my system, can I still use Kylix SMS Server?
9. Our system is B/S structure and developed with PHP, how do I send SMS
message?
10. How do
I know whether the message is successfully sent?
11. My device was damaged and I changed a new one, how can I keep using it?
12. How to make Kylix SMS Server as a integrate part of our software product
rather than an additional software?
13. I feel inconvenient with the device related registration, can I use other
registration means?
14. We want to build in SMS functions into our software, but not as additional
software, what should we do?
At first please connect to your GSM device, refer to the following description about the select of GSM device. The software installed with a MS Access database file “SMSDemo.mdb”, 2 tables in this file are used for sending and receiving message. You can directly test with this database file. Run the software, open the database file with MS Access and modify any record in SMSOut table, change the value in Phone field to receiver's phone number, and change the value of status field to 0. Wait several seconds, before receiver's phone will receive the message. Send a message with a mobile phone to the number of the GSM device, and wait several seconds, after the GSM device receives the message, open SMSIn table and you can see the received message.
We recommend using GSM Modem, which is better in performance, stableness, and compatibility compared with mobile phone, and it's able to work continuously without charging, its signal quality also outperforms mobile phone. Commonly used GSM Modem includes WAVECOM, SIEMENS, ERICSSON, MOTOROLA etc, we recommend using WAVECOM WMOD2.
Mobile phone is also a good choice for the software that doesn't have a large number of messages to be sent. With so many brands of mobile phones exist in market, an outdated model are preferred. Because they are cheap, and the stability have been tested by the market. Features such as chord ring, color picture and camera contribute nothing to the system, on the contrary, it decreases the standby time and increases the charging times. Among commonly used brands of mobile phones on the market, Nokia and Siemens are most suitable to this work, and most importantly, Siemens shows best support and compatibility for AT command set of GSM device standard, we strongly recommend using these brands.
If your GSM device is unable to work with Kylix SMS ActiveX Control, please contact us.
3. Does the software support GPRS or CDMA Modem?
GPRS is an extending service based on GSM, SMS is supported by all GPRS mobile phone or modem. CDMA is not supported by Kylix SMS Server in this version. It will be supported in future.
4. How to Set Connection Mode and Port Number?
Kylix SMS Server supports GSM device with different interfaces, including serial port, USB, Bluetooth, Infrared. For USB interface, usually it is simulated to a virtual serial port by installing the device driver. And then you can choose the virtual serial port from the Device Tab Page of the software. If you are using GSM device with Bluetooth interface, be sure to install a Bluetooth adapter onto your PC, the adapter driver will then simulate Bluetooth interface to a virtual serial port. And then you can choose the virtual serial port from the Device Tab Page. For GSM device using IR connection, there are 2 communication modes. One is connecting through IR protocol by choosing Infrared from Device Tab Page of the software. The other is simulating IR to a virtual serial port, and you should choose virtual serial port number from the Device Tab Page, rather than Infrared.
5. What is Concatenated SMS Mode?
For message contains more than 160 (GSM 7Bits) or 70 (Unicode) characters, you can send the message by two modes. One is sending by concatenated message mode (e.g. 700 characters), and the receiver's phone will display a single message easy to read. The other is splitting the long message into several independent messages for the receiver. Concatenate message mode requires the support of receiver's mobile phone, it's supported by latest models of mobile phones, and it may display garbled codes for old models. All models of mobile phones support split messages, only it seems somewhat inconvenience for receivers to read. Split messages mode is used by default.
6. Is Kylix SMS Server able to work with software without database?
Kylix SMS Server exchanges data
with your software through database, so database must be provided. For
software without database interface, you can upgrade it by attaching
database.
We may add new feature of exchanging data through file for the future
version, please contact us if you need this feature now.
Kylix SMS Server provides Sending Period Limit function, which keeps messages from sending during non-working period, so nobody will be disturbed at rest time. You can enable or disable this function or modify the time period values by using the options in Message Tab Page. This time period limit is only effective to the messages to be sent in database, Warning Messages such as low battery, database disconnection and daily report etc, are not limited by time period.
8. I am using Linux server on my system, can I still use Kylix SMS Server?
Kylix SMS Server uses Windows ADO to connect to database and implement data exchange through database, so long as there is one PC (server or client) running Windows and it can connects to the database of your software, you can install Kylix SMS Server on that PC, and use this software after building ADO connection string. Contact us if you need to run this software under Linux.
9. Our system is B/S structure and developed with PHP, how do I send SMS message?
You only need to have a PC (server or client) running Windows in order to connect it to database through ADO, and you can build 2 tables in the database, one for sending SMS and one for receiving. When you want to send message, just insert the contents and receiver's phone number into SMSOut table and Kylix SMS Server will send out the message in seconds. The received messages will be inserted into SMSIn table; you only need to read SMSIn table to process all received messages. You can use it in a same way whether your system is B/S or C/S structure.
10. How do I know whether the message is successfully sent?
There is a Status field in SMSOut table, insert message to be sent into this table, and set Status field to 0. Kylix SMS Server will update this field to 1 after successfully send out the message, and update it to -1 when sending fails, by checking this field you will know whether it's successful.
11. My device was damaged and I changed a new one, how can I keep using it?
Please refer to instruction listed in "Software registration".
If you need to install Kylix
SMS Server while installing your software, you only need to copy the
installed files in Kylix SMS Server folder to the directory of your
software, and make configuration after copy completed.
Windows NT, Windows2000, Windows XP, Windows 2003
install service: SMSServer /install
start service: SMSServer /start
stop service: SMSServer /stop
uninstall service: SMSServer /remove
Windows 95, Windows 98, Windows ME
run: SMSServer /win9x
If you want to use it as a integrate part of your product, that is, to mark it as your trademark, please contact us, so we can provide you with satisfying service and favorable price.
13. I feel inconvenient with the device related registration, can I use other registration means?
Kylix SMS Server uses device related registration, which will register you according to IMEI code of your GSM device. But if you prefer other registration means, please contact us.
If you need to directly develop the SMS functions into your software, you can use the other product "Kylix SMS ActiveX Control" provided by us. It's able to send and receive messages, it supports various formats of ringtones and logos, and it can also use phonebook to dial or forward calling, and it's easy to use. For more information, please refer to the introduction on our website.
Registration
Kylix SMS Server is distributed as shareware, you can download and try and copy as you like. When not registered, the software will add information of our company for the sent messages as well as the received messages, and some words will be replaced by ".". If you feel good after trial using, you should register this software for long term using. All limits will be removed after registration.
This software is registered in a GSM device bundled way, each license is bundled to a GSM device. When you are ready to register this software, connect your GSM device to the PC, run Kylix SMS Server, open the Configuration window of the software, select About Tab Page, and then copy the device code displayed in "Device Code". Click "Order Online" button to open purchase page, and fill in the device code when requested. After you received the registration code, please click "Register" button and copy it to "Registration Code" to finish the registration.
Consider the possibility that GSM device may damage or be replaced; we provide 2 additional chances to change hardware device code for each license. Be sure to keep the Email when you first registered, and attach the registration Email content when you need to modify device code, or we can't provide device code changing service. Each license only runs on one device at the same time, after changing GSM device for certain times, the registration codes provided by us should not be used to connect to more than one device. If you need to add new device to your software, please purchase new license.
Contact us
If you have any problems during your using or trial, or if you have any idea or
suggestion, please feel free to connect us.
|
Sale: |
|||
|
Support: |
|||
|
Website: |
Note: Please do not forget to send your error report along with the log files KylixSVR.log and KylixSMS.log and your system specifications. We need to know the model of the mobile phone or GSM/GPRS modem you have, your Connection Mode, Cable/Adapter Model, COM Port Number, COM Port Baudrate, your developing tools and the Operating System you use, so that we can help you.