Click here to Skip to main content

Article

Library for Decode/Encode SMS PDU

Eduard Gomolyako

Rate me:

4.74/5 (49 votes)

18 Oct 2012CPOL

757.7K

26.6K

128

192

Library for decoding and encoding mobile short messages to/from SMS protocol data unit

Last Updates

You can find some community fixes mentioned on comments section on Project Home at Google Code[^].

Introduction

The smspdulib library is intended for more transparent interaction with SMS PDU. This thought over hierarchy of classes will allow you to create new classes for other types of short messages using the realized base functionality.

At present, the following types of short messages are supported: status report, SMS (with long (large) SMS parts support).

Hierarchy of Classes

Classes hierarchy

Sample Code

This example shows you how to decode PDU.

C#

SMSType smsType = SMSBase.GetSMSType(pduSource);
switch (smsType) {
    case SMSType.SMS:
        SMS sms = new SMS();
        SMS.Fetch(sms, ref pduSource);
        //Use instance of SMS class here
        break;
    case SMSType.StatusReport:
        SMSStatusReport statusReport = new SMSStatusReport();
        SMSStatusReport.Fetch(statusReport, ref pduSource);
        //Use instance of SMSStatusReport class here
        break;
}

This example show you how to encode SMS to PDU.

C#

SMS sms = new SMS();
sms.Direction = SMSDirection.Submited;
sms.PhoneNumber = &quot;+74951234567&quot;;
sms.ValidityPeriod = new TimeSpan(4, 0, 0, 0);
sms.Message = &quot;Me message here!&quot;;
string pduSource = sms.Compose(SMS.SMSEncoding.UCS2);

Useful Links

Updated

Updated Decode7bit method: Fixed some bugs (see comments)
PopDate method now doesn't recognize time zone because some phones send strange stuff

Please help me find more detailed specification of PDU format and TP-SCTS format.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Written By

Eduard Gomolyako

Chief Technology Officer

Russian Federation

This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

farhood22-Jan-11 20:29

22-Jan-11 20:29

thank u So So SO MUCH my friend

astri30-Oct-10 23:14

30-Oct-10 23:14

great job ..

CellId.ru have freelibrary for working with SMS and GSM Modem

BSH-Systems9-Jul-10 4:49

9-Jul-10 4:49

on CellId.ru you can download free library for working with GSM modem! (for .NET) with C# sample.

You can send and receive SMS messages, USSD.
support GSM and UCS2 coding format and
PDU and Text format!!!

You can download from cellid.ru

BSH-Systems9-Jul-10 4:46

9-Jul-10 4:46

Some bugs

Recieve Long sms not correctly

amna_94726-May-10 17:42

26-May-10 17:42

i download update smspdulib from codeproblem.com its support multipart or long sms .but still a bug decode function and bug is when i receive multipart or long sms last part of sms convert to some garbage collection .if i recieve three parts sms..first two part recieved correctly but third part show like that please check this and guide me how can i solve this problem..

[1st Part]

I used the Visual Studio 2005 Beta 1 (it was one year ago) because Visual\r\nStudio 2005 has a SerialPort-component. You just have to connect with that

[2nd Part]

port to your modem/handphone, and read all the messages.\r\nI made a project that reads messages from a database and sends them, and\r\ninserts the rece

[Third Part]

RmKIAZKggCOKgAR]AB]_iQKeAhCEYK]@(QKeKAnCgABYg_Afkaa_eiAL_eP_kegADKioKK]AhQKAf[gAF_kYIADKAfK]IAJiGY@Jee_e[fkaa_ei]@Yg_A \t+[@

Recive sms problem

anil_singh201013-May-10 18:17

13-May-10 18:17

hi i m new in c# and want to develop sms application i heard smspdulib please tell me how to recieve sms using pdulib i m able to encode and decode sms using pdulib but i m unable to send and recieve sms.. hope u all brothers help me and and guide me

send and recieve sms using pdulib

paks_mundiasd11-May-10 17:20

11-May-10 17:20

please exmplain me how can i send and receive sms using smspdulib if possible give me any example

zadsdfas23-Mar-10 0:29

23-Mar-10 0:29

can anybody explain me how to send and recieve sms via gsm modem connected to PC via bluetooth (serial port profile) or data cable."

Service Center number missed?

flexchan25-Jan-10 6:27

25-Jan-10 6:27

Hi,

Could you please let me know how your code can involve the Service center number? I try to use Hyperterminal to send PDU SMS. When I past the PDU code generated by the program, it show the error.

The PDU code seems missed the PDU code.

Thanks.

Re: Service Center number missed?

AzmanXE25-Sep-16 19:21

25-Sep-16 19:21

Same also with me.Cannot put Service Center number. Are already found solution?

Wanted specification

k06a18-Jan-10 5:22

18-Jan-10 5:22

Here is technical specification:
"Digital cellular telecommunications system (Phase 2+);
Technical realization of the Short Message Service (SMS)
Point-to-Point (PP)"

ETSI TS 100 901 V7.5.0 (2001-12)

Re: Wanted specification

Eduard Gomolyako21-Jan-10 16:54

Eduard Gomolyako

21-Jan-10 16:54

Broken link. Page cannot be found.

Best, Ed.

Re: Wanted specification [modified]

k06a22-Jan-10 8:14

22-Jan-10 8:14

Sorry. It's very strange.
I have this document on Google Docs - Here it is

And a little bug, i think:
method SMS.Compose(...) have strange code in switch -> default(for _8bit):

switch (messageEncoding) {
   case SMSEncoding.UCS2:
      messageBytes = EncodeUCS2(_message);
      length = messageBytes.Length;
      break;
   case SMSEncoding._7bit:
      messageBytes = Encode7bit( _message, out length );
      break;
   default:
      //length = 0;
      messageBytes = new byte[0];
      break;
}

There is no user 8 bit data in messageBytes ((

Code from your Google Code SVN.

modified on Friday, January 22, 2010 2:52 PM

Re: Wanted specification

Eduard Gomolyako22-Jan-10 23:52

Eduard Gomolyako

22-Jan-10 23:52

Thank you for specification. It will be useful for contributors of this library.

About switch -> default I can say that it's seems to be not implemented default encoding. As I remember I don't have enough time, so it's uncompleted and is subject to implementation.

Best, Ed.

Re: Wanted specification

k06a23-Jan-10 7:18

23-Jan-10 7:18

Thanks for your job, Ed.
Hope documentation will help you to develop)

adiono9-Dec-09 4:03

9-Dec-09 4:03

Thanks a lot Eduard! you save my life!!... Smile | :)

Smile | :)

Encoder/Decoder

Member 30541152-Nov-09 23:25

2-Nov-09 23:25

Hello,

For the message "test" the following pdu is generated: 0001000C91293313325476000004F4F29C0E ;

Ive used the following online pdu decoder, http://twit88.com/home/utility/sms-pdu-encode-decode[^]
and the result is:

SMSC#B9DF64799DCE73
Sender:
TimeStamp:// ::
TP_PID:
TP_DCS:
TP_DCS-popis:Uncompressed Text
class Blush | :O

Blush | :O

Alphabet:Default

Length Blush | :O

Blush | :O

With your decoder the result is:

Service center number:
Service center time stamp: 01-01-0001 0:00:00
Message reference #: 0
Direction: Submited
Phone number: +923331234567
Status report indication: False
Message:
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ '

So I must assume something is wrong. Anyone with a solution ? Sugestions ?
Thanks

Re: Encoder/Decoder

uncleR18-Nov-09 1:19

18-Nov-09 1:19

Hi, the problem is in the Fecth() Function, it is not checking if validity period is not present.

You can fix it by doing this:

if (sms._direction == SMSDirection.Submited)
   if (sms._validityPeriod != 0x00) 
        sms._validityPeriod = PopByte(ref source);

Re: Encoder/Decoder

ummarbhutta21-Nov-09 4:49

21-Nov-09 4:49

You can download the new library with bug resolved from following link
http://forum.codeproblem.com/c/sms-sending-and-receiving-using-at-commands-in-c-with-support-of-long-sms/msg49/#msg49[^]

if any problem let me know Big Grin | :-D

Big Grin | :-D

Re: Encoder/Decoder

Member 305411522-Nov-09 22:44

22-Nov-09 22:44

Many Thanks

Re: Encoder/Decoder

ohinCZ24-Nov-09 0:02

24-Nov-09 0:02

This fix doesn't work for me. I am quite new to PDU, but for what I know I assume a typo. Didn't you want to test for _validityPeriodFormat?

if (sms._direction == SMSDirection.Submited)
{
  if (sms._validityPeriodFormat != 0x00)
    sms._validityPeriod = PopByte(ref source);
}

Re: Encoder/Decoder

Member 305411525-Nov-09 8:17

25-Nov-09 8:17

Your pdu doesn't support character like áà and ç. It would be great for you to add this type of characters to the decoding. Worldwide support from your library.

Updated version of this library

ummarbhutta18-Oct-09 8:03

18-Oct-09 8:03

I have uploaded a new verision of this library which supports 7-bit encoding as well as sending ling (multi part sms) using 7-bit encoding, have a look and have fun..
http://forum.codeproblem.com/c/sms-sending-and-receiving-using-at-commands-in-c-with-support-of-long-sms/msg38/. Big Grin | :-D

Big Grin | :-D

Suggestion/Doubts about receiving long SMS

faber7517-Oct-09 0:17

17-Oct-09 0:17

Hi, wonderful and helpful code.
I'm building an app that may receive lengthy messages and i have a few doubts.
I can recognize they are lengthy checking bool InParts and i can get current number with Part.
I can't get the total number of parts, because you use the 3rd header byte (that should contain the total parts number) for the InPartsID.
Is there something i'm missing ?
I changed your code for the InPartsID excluding _userDataHeader[3] from the evaluation, renamed the Part property to PartCurrent and created the property PartTotal as

    public int InPartsID
    {
        get
        {
            if (!InParts)
                return 0;

            return (_userDataHeader[2] << 8); // was return (_userDataHeader[2] << 8) + _userDataHeader[3];
        }
    }

    public int PartTotal
    {
        get
        {
            if (!InParts)
                return 0;

            return _userDataHeader[3];
        }
    }

public int PartCurrent
{
    get
    {
        if (!InParts)
        return 0;

        return _userDataHeader[4];
    }
}

In the tests that i'm doing is running just fine but PDU 'syntax' is new to me and i fear i'm missing something.
Sounds good to you ?

Thanks again for your code and for any suggestions you may give,
Fabrizio

Member 108861211-Oct-09 19:58

11-Oct-09 19:58

hi
thanks for sharing the nice article.
Iam new to the windows mobile development. I have requirement where in i have to send the SMS in binary format(8 BIT) via windows mobile 5.0 and 6.0 version. Iam using WinCE for this. Can you please help is there anyway i can acheive it.

Thanks,

General News Suggestion Question Bug Answer Joke Praise Rant Admin

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Go to top