net::sms(3)
NAME
Net::SMS - Sends wireless messages to any carrier includ
ing text messages and SMS (Short Message Service).
SYNOPSIS
The Perl SMS SDK provides easy, high-level control of the Simplewire wireless text-messaging platform. The Perl SMS SDK was designed to be as developer-friendly as possible by hiding the intricacies of the XML format required to communicate with the Simplewire WMP (Wireless Message Pro tocol) servers. The Perl SMS SDK makes it possible to send an SMS message off with as little as two lines of code. This software is commercially supported. Go to www.sim plewire.com for more information.
INSTALLATION
For very detailed instructions, please refer to the .PDF
manual that has been included in the /docs directory of
the Net-SMS-X.XX.tar.gz download. Once you unzip and
untar this file, inside the /docs directory will be very
detailed installation instructions.
If you are advanced in Perl, then you may just follow the
instructions below. Place the release file in the root
directory. In the root directory, execute the following
commands, where "X.XX" represents the specific version
being used.
[root]# tar -zxvf Net-SMS-X.XX.tar.gz
[root]# cd Net-SMS-X.XX
[Net-SMS-X.XX]# perl Makefile.PL
[Net-SMS-X.XX]# make
[Net-SMS-X.XX]# make install
EXAMPLES
See the /examples folder that is contained within the
Net-SMS-X.XX.tar.gz download file.
QUICK START
# Import Module use Net::SMS;
# Create Object my $sms = Net::SMS->new();
# Subscriber Settings $sms->sub
scriberID("123-456-789-12345"); $sms->subscriberPass
word("Password Goes Here");
# Message Settings $sms->msgPin("+1 100 510 1234");
$sms->msgFrom("Demo"); $sms->msgCallback("+1 100 555
1212"); $sms->msgText("Hello World From Simplewire!");
print "Sending message to Simplewire...0;
# Send Message $sms->msgSend();
- # Check For Errors if ($sms->success) {
- print "Message was sent!0; } else {
print "Message was not sent!0;
print "Error Code: " . $sms->errorCode() . "0;
print "Error Description: " . $sms->errorDesc() . - "0;
- print "Error Resolution: " . $sms->errorResolution() .
- "0; }
UNICODE
For Unicode characters in the range 0x00 to 0xFF, you can
use the Perl hexadecimal escape sequence.
Format:
Backslash + Lowercase 'x' + Two Hex Digits
Example: $r->msgText( "Uppercase Z: A" );
For Unicode characters in the range 0x0000 to 0xFFFF, Sim
plewire provides its own escape sequence. This is only for
use with the msgFrom and msgText methods.
Format:
Backslash + Backslash + Uppercase 'X' + Four Hex Digits
Example: $r->msgText( "Smiley Face:
- Note: Both sequences can be used in the same string.
- Example: $r->msgText( "Degree Sign:
- Tilde: );
SEE ALSO
/Net-SMS-X.XX/examples/
/Net-SMS-X.XX/docs/sw-doc-manual-perl-2.4.0.pdf
Visit http://www.simplewire.com/
AUTHOR
Simplewire <support@simplewire.com> www.simplewire.com
COPYRIGHT
- Please refer to License.txt within the Net-SMS-X.XX.tar.gz
file for licensing information.