/ 
NetSDS-Message-0.021
River stage zero No dependents
/ NetSDS::Message::SMS

NAME

NetSDS::Message::SMS - short message according to ETSI GSM 03.40

SYNOPSIS

use NetSDS::Message::SMS;

...

$msg = NetSDS::Message::SMS->new();
$msg->udh(conv_hex_str('050102030405');
$msg->ud('Hello there');

$msg->coding(COD_7BIT);

print "SM: " . $msg->message_body();

DESCRIPTION

This class provides API to SMS message data structure.

CLASS API

new() - class constructor

Implements SMS constructor.

my $object = NetSDS::Message::SMS->new();
coding() - set/get SMS coding

Paramters: new coding to set

Returns: message coding

$msg->coding(COD_UCS2);
mclass() - set/get message class

Paramters: new message class value

$msg->mclass(0); # Send as Flash SMS
udh() - set/get UDH

Paramters: UDH as binary string

Returns: UDH

$msg->udh(conv_hex_str('050.02130405');
ud() - set/get user data

Paramters: user data as binary string

Returns: user data

esm_class() - get esm_class from message

See 5.2.12 chapter of SMPP 3.4 specification for details.

$esm_class = $msg->esm_class();
dcs() - get data coding scheme

Returns data coding schmeme in accordance with ETSI GSM 03.38

$dcs = $msg->dcs();
message_body() - return SMS message body

Returns: SMS body as byte string (UDH + UD)

$msg_hex = conv_str_hex($msg->message_body);
text($string, $coding) - set SM data from text string

Paramters: string, SMS coding

# Set SMS text
$msg->text('Just some string', COD_7BIT);

This will set UDH to undef and UD to string in GSM 03.38.

EXPORTED FUNCTIONS

create_long_sm($text, $coding) - concatenated SMS sequence

Paramters: text string (UTF-8), SMS coding

Returns: array of NetSDS::Message::SMS objects

# Create 300 character string
my $long_str = 'abc'x100;

my @parts = create_long_sm($long_str, COD_7BIT);

EXAMPLES

See samples directory for examples.

BUGS

Unknown yet

SEE ALSO

* ETSI GSM 03.38 - alphabets and language specific information

* ETSI GSM 03.40 - SMS realization on GSM networks

* SMPP Protocol Specification v3.4

TODO

* Implement RPI and message mode support in esm_class()

* Implement MWI support in dcs() method

AUTHOR

Michael Bochkaryov <misha@rattler.kiev.ua>

LICENSE

Copyright (C) 2008 Michael Bochkaryov

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA