FreeCalypso > hg > fc-sim-tools
comparison README @ 22:f893cdde97a4
updated top-level README added
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Sun, 14 Mar 2021 08:20:20 +0000 |
| parents | |
| children | 0299c16f2ab1 |
comparison
equal
deleted
inserted
replaced
| 21:f6c5aade6559 | 22:f893cdde97a4 |
|---|---|
| 1 This code repository contains current versions of FreeCalypso SIM card | |
| 2 manipulation utilities fc-simtool and fc-uicc-tool; the old versions which were | |
| 3 previously maintained in freecalypso-hwlab and fc-pcsc-tools Hg repositories | |
| 4 are now deprecated and no longer maintained. | |
| 5 | |
| 6 The present version has been refactored to allow other card communication back | |
| 7 ends besides libpcsclite: the tools can now operate on SIM cards that sit inside | |
| 8 Calypso phones or development boards (the necessary simagent back end lives in | |
| 9 the freecalypso-tools Hg repository), and it would be easy to add support for | |
| 10 Phoenix-style serial SIM readers if someone were to either send me one or point | |
| 11 me to a place where I can buy one. All libpcsclite compile-time dependencies | |
| 12 have been factored out into the pcsc back end; if you don't have a pcsc-lite | |
| 13 based reader and don't need that support, you can exclude this back end from | |
| 14 your build and thus eliminate that compile-time dependency. | |
| 15 | |
| 16 fc-simtool is the utility of primary interest. It speaks the classic GSM 11.11 | |
| 17 SIM protocol to the card (as opposed to the unwanted-innovation UICC protocol), | |
| 18 and it is intended to be useful to end users of regular operator-issued SIM | |
| 19 cards without admin privileges. High-level user-friendly commands include | |
| 20 manipulating PINs and phonebooks; low-level commands allow you to SELECT any | |
| 21 arbitrary file (MF/DF/EF) and to perform READ and UPDATE commands on any EF | |
| 22 (BINARY or RECORD as appropriate) as the card will allow, given your access | |
| 23 level. We (FreeCalypso core team) are also doing some experiments with | |
| 24 programmable SIM cards, hoping to some day be able to issue our own SIMs, but | |
| 25 this work is currently very experimental and not ready for consumption. | |
| 26 | |
| 27 fc-uicc-tool is currently a very minimal tool for a few narrow use cases. It | |
| 28 implements a small subset of fc-simtool commands (basic low-level ones), but | |
| 29 speaking the new UICC protocol to the card - as well as new SELECT by AID | |
| 30 commands that are only possible with this new protocol, granting access to ADFs | |
| 31 for USIM and ISIM. The tool's only useful functions right now are (1) testing | |
| 32 whether or not a given card has USIM/ISIM functionality present, and (2) | |
| 33 manually exploring the file system under ADF.USIM or ADF.ISIM which cannot be | |
| 34 accessed in any other way. fc-uicc-tool does NOT currently replicate any of | |
| 35 the high-level end-user-oriented functionality of fc-simtool! |