Click here to Skip to main content
15,867,568 members
Articles / Programming Languages / C++

PDU lib under STL for SMS

Rate me:
Please Sign up or sign in to vote.
3.22/5 (6 votes)
21 May 2007CPOL2 min read 95.2K   998   27   30
This is a light weight lib for decoding and encoding the GSM SMS PDU format.

Introduction

The SMS message, as specified by the Etsi organization (documents GSM 03.40 and GSM 03.38), can be up to 160 characters long, where each character is 7 bits according to the 7-bit default alphabet. Eight-bit messages (max 140 characters) are usually not viewable by the phones as text messages; instead, they are used for data in, e.g., smart messaging (images and ringing tones) and OTA provisioning of WAP settings. 16-bit messages (max 70 characters) are used for Unicode (UCS2) text messages, viewable by most phones. A 16-bit text message of class 0 will, on some phones, appear as a Flash SMS (a.k.a. blinking SMS or alert SMS).

Please see dreamfabric for details.

This lib is used to encode/decode plain text to PDU format under 7-bit or UCS2 (yes, the EMS is not supported yet). This lib is easy to use, but not bug free, so please be patient :).

I have searched the internet, and there are some great libs for the PDU format under the .NET Framework which I can't use in my current job, so I wrote this lib for my own needs.

Source code

The source code is very simple, only two files; you can add them to your project or build a lib.

How to use...

There are two main function for the lib: Compose() and Fetch(). Using these two functions, you can compose a message or fetch data form a PDU string.

C++
/**
 *    Compose a shot message
 *    @para pdudata pdu: [out] The pdu result
 *    @para string msg:    data need to be sent
 *    @para string phone:    the destination phone number
 *    @para string msc:    message center number, if null, use the preset number
 *    @para EEncodeMethod eMethod:    the encode method, default is UCS2
 *
 *    @return the data length without the SMSC part[you need it in AT+CMGS command]
 */
int Compose (pdudata& pdu, 
    std::tstring msg, std::tstring phone,
    std::tstring msc = _T(""),
    EEncodeMethod eMethod = EEncodeUCS2) throw(...);


/**
 *    Fetch data form a pdu format data
 *    only return the message part(USERDATA), 
      use other member function to fetch information
 *    @para pdudata pdu: the source data
 *
 *    @return The nomral message
 */
std::tstring Fetch(pdudata pdu) throw(...);

Compose an SMS message

To compose a message, you need do this:

C++
CPDU pdu;
LPCTSTR szMsg = m_szEncodeContents.GetBuffer(m_szEncodeContents.GetLength());
pdu.SetMSCNumber(_T("13800210500"));    // Set the message center number here
try {

    CPDU::pdudata strPDU;
    // Compose the message
    int iLen = pdu.Compose(strPDU, szMsg, _T("13813878775"));
    WTL::CString csPDU;

    
    // Show the message to the output edit control
#ifdef _UNICODE
    MultiByteToWideChar(
        CP_ACP, 
        MB_PRECOMPOSED, 
        strPDU.c_str(), 
        -1,
        csPDU.GetBuffer(1024),
        1024
        );
#else
    csPDU = strPDU.c_str();
#endif // _UNICODE

    m_szDecodeContents = csPDU;
} catch (CPDUException e) {
    m_szDecodeContents = e.GetMessage().c_str();
}

Fetch data

When you need to fetch a message, you need do this:

C++
CPDU pdu;
WTL::CString szMessage = pdu.Fetch(pdustring);

If there are no exceptions, then you can use these functions to fetch other data:

C++
/**
 *    Fetch Data
 */
// The caller/sender number
std::tstring GetCaller()        { return m_szCaller; }
// The callee/recevier number
std::tstring GetCallee()        { return m_szCallee; }
// Message time stamp
std::tstring GetTimeStamp()        { return m_szTimeStamp; }

Notice

The tstl.h file is a TCHAR style header file for STL strings and streams.

Update

  • May 22 2007: Fixed a bug in the Decode7bit function, thanks to alexafros12345 :)

License

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


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

Comments and Discussions

 
Generalwhere i can find stl/stl.h header file Pin
krshna.padave17-Apr-09 0:41
krshna.padave17-Apr-09 0:41 
I get following error during compile
Error 1 fatal error C1083: Cannot open include file: 'stl/stl.h': No such file or directory

Thanks
GeneralRe: where i can find stl/stl.h header file Pin
Youngho Kim29-Jan-10 23:24
Youngho Kim29-Jan-10 23:24 
Generalsource code for PDU to Text Converter in java Pin
snehalpatil271-Mar-09 18:45
snehalpatil271-Mar-09 18:45 
GeneralA bug about offset in parsing reply number in Fetch() Pin
Allen.W5-Nov-07 18:36
Allen.W5-Nov-07 18:36 
QuestionRe: A bug about offset in parsing reply number in Fetch() Pin
afriza4-Sep-08 22:39
afriza4-Sep-08 22:39 
GeneralCPDU::Encode7bit Fix [modified] Pin
waelahmed9-Oct-07 23:08
waelahmed9-Oct-07 23:08 
GeneralRe: CPDU::Encode7bit Fix Pin
patiqs11-Sep-08 23:41
patiqs11-Sep-08 23:41 
QuestionPossible to integrate with C# Pin
nonintrusive24-Jul-07 7:07
nonintrusive24-Jul-07 7:07 
Questionhow to send picture in SMS? Pin
Shakeel Mumtaz10-Jun-07 5:46
Shakeel Mumtaz10-Jun-07 5:46 
GeneralCPDU::Decode7bit - bug fix Pin
alexafros1234517-May-07 10:38
alexafros1234517-May-07 10:38 
GeneralRe: CPDU::Decode7bit - bug fix Pin
Louis huang21-May-07 17:11
Louis huang21-May-07 17:11 
GeneralNot working for me Pin
trAndy29-Apr-07 13:58
trAndy29-Apr-07 13:58 
GeneralRe: Not working for me Pin
Louis huang29-Apr-07 16:47
Louis huang29-Apr-07 16:47 
GeneralRe: Not working for me Pin
trAndy29-Apr-07 19:56
trAndy29-Apr-07 19:56 
GeneralRe: Not working for me Pin
Louis huang29-Apr-07 23:10
Louis huang29-Apr-07 23:10 
GeneralUse a webservice instead Pin
xaml.net13-Jan-07 2:30
xaml.net13-Jan-07 2:30 
GeneralCopy from another site Pin
_johan6-Dec-06 3:26
_johan6-Dec-06 3:26 
GeneralRe: Copy from another site Pin
Louis huang6-Dec-06 14:27
Louis huang6-Dec-06 14:27 
QuestionQuestion about another method.... Pin
prcarp27-Nov-06 2:26
prcarp27-Nov-06 2:26 
AnswerRe: Question about another method.... Pin
Louis huang27-Nov-06 2:40
Louis huang27-Nov-06 2:40 
GeneralRe: Question about another method.... Pin
prcarp27-Nov-06 3:45
prcarp27-Nov-06 3:45 
GeneralRe: Question about another method.... Pin
Louis huang27-Nov-06 4:17
Louis huang27-Nov-06 4:17 
QuestionCan you tell me the use? Pin
Priyank Bolia26-Nov-06 23:40
Priyank Bolia26-Nov-06 23:40 
AnswerRe: Can you tell me the use? Pin
Louis huang27-Nov-06 2:21
Louis huang27-Nov-06 2:21 
GeneralRe: Can you tell me the use? Pin
Priyank Bolia28-Nov-06 19:48
Priyank Bolia28-Nov-06 19:48 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

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