Simplewire, Inc. Perl SMS Software Development Kit 2.6.1 Contents ---------------------------------------------------------------- 1. Release Notes 2. Overview 3. Modules 4. Installation and Documentation 5. Example Source Code 6. Simplewire Developer Program 7. Demo Message Credits (How Do I Send Live Messages?) 8. Commercial Software License 9. Sales and Technical Support Release Notes ---------------------------------------------------------------- 2.6.1 - January 25, 2003 * Fixed minor XML formatting bug. * Addded recv_text.pl example show how to receive incoming SMS from Simplewire. * Added first version of the test suite. 2.6.0 - July 21, 2003 * Added WAP push support. * Added account() command to query network for real-time credit balance. * Methods submit(), query(), list(), account() all return a true or false based on success() property. * Implemented mobile originated SMS (receiving SMS) to support version 2.0 and 2.5 of the WMP protocol. * Verified and fixed all issues to verify module works in both "-w" and "-Tw" modes. * Deprecated functions -> new equivalent functions - msgSend() = submit() - msgStatusSend() = query() - carrierListSend() = list() - msgPin() = destAddr() - msgCallback() = sourceAddr() - proxyServer() = proxyHost() * Backwards compatability broken on ServerName and ServerDomain properties. These will NOT effect normal use of the SDK even if you previously used them. * Many other functions are renamed to adapt to new, upcoming standards going to be introduced in version 3.x.x of the SDK. All previously named functions are mapped to the new names meaning all previous code is backwards-compatible. * Fixed "unquoted string may conflict with future reserved word" bug when Perl is run in -w or warning mode. * Added SSL support, see Secure property for more information on how to use this new feature. $sms->secure(1); * Added debug output to help debug connection problems, network settings, and general problems. $sms->debug(1); * Deprecated ServerName, ServerDomain, and ServerPort. Please see RemoteHost and RemotePort. * Modified internal variables by renaming them: ServerName, ServerDomain = RemoteHost ServerPort = RemotePort ServerFile = RemoteFile Removed ServerProtocol since that is internally used. * Modified RemotePort function to default to 0 which stands for "unused". If unchanged, SDK will connect over port 80 and if "secure" is true, then SDK will connect over port 443. However, any update of RemotePort will cause the SDK to manually connect to that port. * Modified default remote host to wmp.simplewire.com not wmp-test.simplewire.com. * Modified remote file from /paging/rpc.xml to /wmp 2.5.1 - June 6, 2003 * Fixed minor bug regarding carrier list character translation. 2.5.0 - June 1, 2003 * Added EMS (Enhanced Message Service) features. 2.4.1 - October 26, 2001 * Added optFlash() * Added errorResolution() * Added methods that allow users to set image data in hex format instead of only being able to specify using filenames. * Updated installation procedures * Changed 'SmartMsg' carrierlist hash attribute to 'SmartMsgID' to match other SDKs. * Added proxyType() * Updated all example code * Updated perldoc manpage within SMS.pm 2.4.0 - (2001-9-21) * Added smart messaging. Updatated documentation. 2.3.3 - August 21, 2001 * Removed 'pwd' commands from makefile for compatibility with Windows installation. 2.3.2 - August 13, 2001 * Changed "UserName" to "Username" with lowercase 'n'. Added pass-through functions with old name for backward compatibility. - Updated documentation - Updated examples * Restored code for deprecated 'synchronous' method for backward compatibilty. Method does nothing. * Modified code for deprecated 'userAgent' method for backward compatibilty. Method returns empty string. * Added reset method, Reset(). SMS member values are no longer set in the new() method. The new() method calls Reset(). User can now reset a SMS object instead of creating a new fresh object. - Updated documentation * Renamed internal method 'xml' to 'toXML'. - Updated documentation * Added responseXML() to get/set the response XML. This will not be documented. * Added requestXML() to get/set the request XML. This will not be documented - at least, not at this time. * Added a reminder in the documentation that the Unicode escape sequences are meant only for double-quoted strings. * Added PublicChangeLog.txt - Modified release batch file to use PublicChangeLog.txt 2.3.1 - July 31, 2001 (Beta Program) * Renamed 'timeout' method to 'connectionTimeout' * ServerPagingURL renamed to ServerFile * Changed default ServerName from 'rpc' to 'wmp-test'. * Changed default OptDelimiter from ":" to undefined * DataCoding XML bug fixed 2.3.0 - July 19, 2001 - (Developed as version 2.2.2) * Unicode support added * Custom Simplewire Unicode escape sequence added. \\X#### * MsgText and MsgFrom attributes are now sent as Unicode * Deprecated synchronous * Deprecated RPC loop * Updated old error codes to new error codes * Modified README * Updated man page * Added optDataCoding method * Removed attributes: m_ServerFloor, m_ServerCeiling, m_Success. * Added subscriber password support * Revised examples 2.2.1 - July 2, 2001 * Included module dependencies * Automated module installation * Updated release script 2.2.0 - June 15, 2001 * Added serverPort function 2.1.3 - April 27, 2001 * Deprecated User Agent for licensing * Fixed minor EAGAIN macro error in SMS::HTTP on Red Hat 7.0 * Fixed entities bug while submitting XML to Simplewire 2.1.2 - April 16, 2001 * Windows compatibility with Active State Perl * Add PPD Distribution For Active State Perl * Fixed minor SMS::HTTP macro bug 2.1.0 - April 14, 2001 * Added Carrier Recognition Functions * Removed LWP::UserAgent dependency * Added Lite SMS::HTTP library * Improved performance by nearly 30% 2.0.0 - March 24, 2001 * Removed SMS::Request and SMS::Response * New interface and function names * Added new redundancy with looping of WMP Servers * Added MsgSendEx for easier sending of quick messages 1.0.0 - October 5, 2000 * First public release Overview ---------------------------------------------------------------- The Simplewire Perl SMS Software Development Kit is a 100% pure Perl module. You can use it in nearly any Unix, Linux, or Windows Perl programming environment. The kit has gone through rigorous quality-assurance and testing to ensure a comphrehensive and robust wireless messaging solution. In turn, the Perl SMS Software Development Kit delivers a scalable business solution for high-performance, web based applications in a variety of industries. The Perl SMS Software Development Kit connects your application to, and works in conjunction with, the Simplewire Wireless Messaging Network. This network is the conduit through which customers are able to reach wireless users throughout the world. One may view the hundreds of networks to which you may send messages via Simplewire at http://coverage.simplewire.com/. Please read below for more information on the Simplewire Developer Program and purchasing a Commercial Software License. Modules ---------------------------------------------------------------- The Simplewire Perl SMS Software Development Kit is referenced by the Net::SMS package namespace. Installation and Documentation ---------------------------------------------------------------- The /docs directory contains the Perl SMS Software Development Kit Manual. The manual is in Adobe Acrobat format (.PDF) and you will need the Adobe Acrobat Reader in order to view it. If you do not have the Adobe Acrobat Reader then you can get a free viewer by visiting http://www.adobe.com/. Example Source Code ---------------------------------------------------------------- The /examples directory contains comprehensive source code that demonstrates how to use the Perl SMS Software Development Kit in a variety of ways. You can use this code to quickly develop and test your wireless messaging application. There is a code example for every major function in the Perl SMS Software Development Kit. There are also more programming resources available at the Simplewire Developer Website at http://developers.simplewire.com/. Simplewire Developer Program ---------------------------------------------------------------- If you have not already done so, please join the free Simplewire Developer Program. The program offers you the opportunity to create and quality-assure your wireless messaging application before commercially releasing it. The program provides wireless development tools and resources to help you get started at no cost. Furthermore, you will gain access to an online account, from which you may manage all of your resources, as well as the Simplewire Virtual Mobile Phone, to which you may send free test messages online. To join the program, or for more information, visit http://devprogram.simplewire.com/. Demo Message Credits ---------------------------------------------------------------- In order to send live messages to actual mobile devices from your Developer Account, you must purchase Demo Messages, in the form of credits, on the Simplewire Wireless Messaging Network. Please note that Demo Messages will include the "Simplewire Evaluation" tag at the beginning of each message. All remaining Demo Message Credits will be automatically transferred to your commercial account when you Go Live! In order to purchase Demo Message Credits, login to Your Account at http://www.simplewire.com/account/, and click the "Demo It" button. Commercial Software License ---------------------------------------------------------------- In order to eliminate the "Simplewire Evaluation" tag and gain access to the full spectrum of features, you must upgrade to a commercial account and Go Live! You may do this by purchasing a commercial license for the SMS Software Development Kit or an SMS Starter Package in the Simplewire Store located at http://www.simplewire.com/store/platform/. Sales and Technical Support ---------------------------------------------------------------- Technical support is offered for both developers and commercial users. One may submit problems, bug reports, incompatibilities, requests for change, or other comments at http://support.simplewire.com/. Sales support is offered for users interested in purchasing a commercial license or to answer any questions about Simplewire's products and services. Submit sales inquiries to the Sales Team at http://www.simplewire.com/contact/sales/.