SMS PDU Decoder

A Rust library for decoding SMS PDU (Protocol Data Unit) format as specified in GSM 03.40.

This is a Rust port of the Python library smspdudecoder by Sergey Yenchuk.

Features

• 📱 Decode SMS-DELIVER (incoming) messages
• 📤 Decode SMS-SUBMIT (outgoing) messages
• 🔤 Support for GSM 7-bit encoding (including extended characters)
• 🌍 Support for UCS-2 (Unicode) encoding
• 📦 Support for concatenated (multi-part) messages
• ⏰ Timezone-aware timestamp parsing
• 🛡️ Handles truncated PDUs gracefully

Installation

Add this to your Cargo.toml:

[dependencies]
sms-pdu-decoder = "0.1.0"

Usage

Simple API

For quick decoding of incoming SMS messages:

use sms_pdu_decoder::read_incoming_sms;

fn main() {
    let pdu = "07916407058099F9040B916407950303F100008921222140140004D4E2940A";
    
    match read_incoming_sms(pdu) {
        Ok(sms) => {
            println!("From: {}", sms.sender);
            println!("Message: {}", sms.content);
            println!("Date: {}", sms.date);
        }
        Err(e) => eprintln!("Error: {}", e),
    }
}

Detailed API

For more control and access to all PDU fields:

use sms_pdu_decoder::SmsDeliver;

fn main() {
    let pdu = "07916407058099F9040B916407950303F100008921222140140004D4E2940A";
    
    match SmsDeliver::decode(pdu) {
        Ok(sms) => {
            println!("SMSC: {}", sms.smsc.number.unwrap_or_default());
            println!("Sender: {}", sms.sender.number);
            println!("Encoding: {}", sms.dcs.encoding);
            println!("Timestamp: {}", sms.scts);
            println!("Message: {}", sms.user_data.data);
        }
        Err(e) => eprintln!("Error: {}", e),
    }
}

Direct Codec Usage

You can also use the codecs directly:

use sms_pdu_decoder::{Gsm7Bit, Ucs2};

fn main() {
    // GSM 7-bit decoding
    let text = Gsm7Bit::decode("C8F71D14969741F977FD07", false).unwrap();
    println!("GSM 7-bit: {}", text); // "How are you?"
    
    // UCS-2 (Unicode) decoding
    let text = Ucs2::decode("004C006F00720065006D").unwrap();
    println!("UCS-2: {}", text); // "Lorem"
}

Examples

Run the included example:

cargo run --example decode_sms

Supported Encodings

• GSM 7-bit: Default SMS encoding, supports basic Latin alphabet and some special characters
• GSM 7-bit Extended: Includes additional characters like {, }, [, ], €, etc.
• UCS-2: Unicode encoding for international characters
• 8-bit/Binary: Raw binary data

API Documentation

Main Functions

• read_incoming_sms(pdu: &str) - Simple API for decoding incoming SMS
• read_outgoing_sms(pdu: &str) - Simple API for decoding outgoing SMS
• SmsDeliver::decode(pdu: &str) - Detailed API for incoming SMS
• SmsSubmit::decode(pdu: &str) - Detailed API for outgoing SMS

Codecs

• Gsm7Bit::decode(data: &str, strip_padding: bool) - Decode GSM 7-bit encoded text
• Gsm7Bit::encode(data: &str, with_padding: bool) - Encode text to GSM 7-bit
• Ucs2::decode(data: &str) - Decode UCS-2 (UTF-16BE) encoded text
• Ucs2::encode(data: &str) - Encode text to UCS-2

Testing

Run the test suite:

cargo test

All tests from the original Python implementation are included and passing.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

• Original Python implementation: smspdudecoder by Sergey Yenchuk
• This Rust port was developed with assistance from Kiro AI

License

This project is licensed under the MIT License - see the LICENSE file for details.

References

• GSM 03.40 Specification
• GSM 03.38 Specification (Character Sets)

Changelog

0.1.0 (2024)

• Initial release
• Full support for SMS-DELIVER and SMS-SUBMIT PDU decoding
• GSM 7-bit and UCS-2 encoding support
• Concatenated message support
• Timezone-aware timestamp parsing