# HG changeset patch # User Mychaela Falconia # Date 1616633828 0 # Node ID ce044aa49bafbde62030aeeb7ab4821744ba5a5f # Parent ec184dad4877b287d9a70ee133c8e228ed9d900a SIM-data-formats: minor updates, including \E addition diff -r ec184dad4877 -r ce044aa49baf SIM-data-formats --- 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"