# HG changeset patch
# User Mychaela Falconia <falcon@freecalypso.org>
# Date 1691225072 0
# Node ID 9ed03ed4e673cdd59dd80d30b40421d1b06b502e
# Parent  17dd30989c0bfc45790a587fa4eef2267f08bfad
add README

diff -r 17dd30989c0b -r 9ed03ed4e673 README
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Sat Aug 05 08:44:32 2023 +0000
@@ -0,0 +1,16 @@
+This code repository contains some utilities for encoding SMS in low-level test
+workflows:
+
+* sms-encode-text performs the same encoding from user text input (ASCII, ISO
+  Latin-1 or UTF-8) into SMS as performed by fcup-smsend, including support for
+  concatenated SMS and the choice between GSM7 and UCS-2.  However, the process
+  stops after GSM7 or UCS-2 encoding and (in the case of concatenated SMS) UDH
+  generation - the subsequent steps of SMS-SUBMIT PDU encoding and transmission
+  via GSM 07.05 are eliminated in this version.  The output is expected to be
+  fed to either sms-gen-tpdu or more specialized network-side test programs,
+  including those written for SMPP.
+
+* sms-gen-tpdu takes the output of sms-encode-test, along with some additional
+  inputs, and generates either a pure GSM 03.40 SMS-DELIVER or SMS-SUBMIT TPDU
+  (for network-side testing) or the same TPDU preceded by an SC address, as used
+  on the mobile side in GSM 07.05 PDU mode and in EF_SMS SIM storage.