FreeCalypso > hg > sms-coding-utils
comparison README @ 32:829e082793d0
new README
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Fri, 14 Jun 2024 19:42:25 +0000 |
| parents | 9ed03ed4e673 |
| children |
comparison
equal
deleted
inserted
replaced
| 31:19476164c54d | 32:829e082793d0 |
|---|---|
| 1 This code repository contains some utilities for encoding SMS in low-level test | 1 The present suite consists of utilities for encoding and decoding SMS message |
| 2 workflows: | 2 bodies and PDUs. On the decoding side, it includes sms-pdu-decode and |
| 3 pcm-sms-decode utilities that were previously maintained as part of FreeCalypso | |
| 4 host tools: they now extend beyond FreeCalypso GSM MS into SIM card exploration | |
| 5 (fc-simtool) and network-side SMSC prototyping applications. On the encoding | |
| 6 side, there are two new programs described in doc/Generator-tool-summary and | |
| 7 doc/Generator-tool-workflow articles. | |
| 3 | 8 |
| 4 * sms-encode-text performs the same encoding from user text input (ASCII, ISO | 9 Similarly to gsm-codec-lib, the present sms-coding-utils package stands between |
| 5 Latin-1 or UTF-8) into SMS as performed by fcup-smsend, including support for | 10 FreeCalypso and Themyscira Wireless software realms: it has potential |
| 6 concatenated SMS and the choice between GSM7 and UCS-2. However, the process | 11 applications on both the mobile side and the network side of GSM. It is |
| 7 stops after GSM7 or UCS-2 encoding and (in the case of concatenated SMS) UDH | 12 expected to be used together with any or all of the following software |
| 8 generation - the subsequent steps of SMS-SUBMIT PDU encoding and transmission | 13 components: |
| 9 via GSM 07.05 are eliminated in this version. The output is expected to be | |
| 10 fed to either sms-gen-tpdu or more specialized network-side test programs, | |
| 11 including those written for SMPP. | |
| 12 | 14 |
| 13 * sms-gen-tpdu takes the output of sms-encode-test, along with some additional | 15 * FreeCalypso host tools; |
| 14 inputs, and generates either a pure GSM 03.40 SMS-DELIVER or SMS-SUBMIT TPDU | 16 * FreeCalypso SIM tools; |
| 15 (for network-side testing) or the same TPDU preceded by an SC address, as used | 17 * ThemWi proto-SMSC implementation used to exercise SMS-over-GSUP functionality |
| 16 on the mobile side in GSM 07.05 PDU mode and in EF_SMS SIM storage. | 18 in Osmocom CNI suite. |
| 19 | |
| 20 However, even though the present sms-coding-utils suite is designed to be useful | |
| 21 with all of the above FC and ThemWi components, it does not depend on any of | |
| 22 them. The present package can be compiled and installed by itself (see INSTALL | |
| 23 document); all run-time interactions between these utilities and other software | |
| 24 happen through ASCII text files or pipes, or through binary files in externally | |
| 25 defined record format (GSM 11.11 spec and its successors) in the case of | |
| 26 pcm-sms-decode. |