diff SIM-data-formats @ 39:ce044aa49baf

SIM-data-formats: minor updates, including \E addition
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 25 Mar 2021 00:57:08 +0000
parents ec184dad4877
children 7609ff4be49f
line wrap: on
line diff
--- a/SIM-data-formats	Fri Feb 12 08:42:11 2021 +0000
+++ b/SIM-data-formats	Thu Mar 25 00:57:08 2021 +0000
@@ -2,16 +2,15 @@
 SIM cards and user data (primarily phonebooks) stored in them, accessing the
 same underlying data through various mechanisms:
 
-* Our current fc-simtool utility operates on SIM cards inserted into a smart
-  card "reader" device, without going through any kind of phone or other GSM
-  device - most direct manipulation of SIM user data content.
+* fc-simtool in our FC SIM tools suite operates on SIM cards inserted into a
+  smart card "reader" device, without going through any kind of phone or other
+  GSM device - most direct manipulation of SIM user data content.
 
-* We have plans to develop a companion utility (tentatively named fc-simint)
-  that will operate on SIM cards inserted into Calypso phones or FC modem
-  boards, working on the same principle as fc-loadtool (suspending and bypassing
-  the Calypso device's regular operational firmware), but operating on the
-  device's SIM interface rather than its flash.  This companion utility is
-  planned to replicate the end-user-oriented functionality of fc-simtool.
+* Our FC host tools suite features a new utility called fc-simint - it is a
+  front end to fc-simtool that operates on SIM cards inserted into Calypso
+  phones or FC modem boards, working on the same principle as fc-loadtool
+  (suspending and bypassing the Calypso device's regular operational firmware),
+  but operating on the device's SIM interface rather than its flash.
 
 * We have a FreeCalypso User Phone Tools suite that communicates with FC modem
   boards and the future FC phone handset via AT commands.  We have plans to add
@@ -60,10 +59,13 @@
 * GSM7 escape sequences for ASCII characters [\]^ and {|}~ are recognized and
   converted to these ASCII characters; \ is then escaped in the output as \\
 
+* GSM7 escape sequence for the Euro currency symbol is recognized and converted
+  to \E
+
 * GSM7 code points corresponding to CR and LF are represented as \r and \n
 
 * GSM7 escape characters that are not part of a valid sequence for [\]^ or {|}~
-  are represented as \e
+  (or for \E) are represented as \e
 
 * All other GSM7 characters that cannot be represented in ASCII in any other
   way are represented as \xX escapes, where xX is a two-digit hexadecimal number
@@ -95,6 +97,7 @@
 
 \"	literal "
 \\	literal \ (encoded in GSM 03.38 as another form of escape)
+\E	Euro currency symbol (ditto)
 \e	GSM 03.38 escape character 0x1B
 \n	GSM 03.38 LF character 0x0A
 \r	GSM 03.38 CR character 0x0D
@@ -115,8 +118,9 @@
 
 fc-simtool pb-dump command displays SIM phonebook content on the terminal or
 saves it in a file in the format defined here, and other tools such as
-fc-simtool pb-update command need to be able to read back the same format
-losslessly.  The phonebook file format is hereby shown by way of example:
+fc-simtool pb-restore and pb-update commands need to be able to read back the
+same format losslessly.  The phonebook file format is hereby shown by way of
+example:
 
 #1: #646#,0x81 "Check Minutes"
 #2: #674#,0x81 "Check Text Usage"