FreeCalypso > hg > fc-pcsc-tools

annotate README @ 128:01aed8d0685a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/Low-level-commands: raw apdu command documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 20 Feb 2021 20:10:18 +0000
parents 2997836930f3
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
24
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 This code repository contains current versions of FreeCalypso SIM card
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 manipulation utilities fc-simtool and fc-uicc-tool; the old versions which were
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 previously maintained in the freecalypso-hwlab Hg repository are now deprecated
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 and no longer maintained.
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 The present utilities operate on SIM cards that are inserted into a smart card
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 "reader" device attached to the user's host computer (PC or laptop), *without*
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 going through any kind of phone or other GSM device. Whichever smart card
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 "reader" hardware you are going to use, it needs to be supported by pcsc-lite
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 software: our tools link with libpcsclite and thus require this library and its
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 header files to be installed in order to compile; actually running the programs
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 and getting them to work further requires pcscd and appropriate pcsc-lite back
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 end drivers. The Mother uses HID Omnikey 3121 and 6121 CCIDs (USB-interfaced),
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 with pcsc-lite and its ccid back end installed under Slackware 14.2.
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 fc-simtool is the utility of primary interest. It speaks the classic GSM 11.11
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 SIM protocol to the card (as opposed to the unwanted-innovation UICC protocol),
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 and it is intended to be useful to end users of regular operator-issued SIM
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 cards without admin privileges. High-level user-friendly commands include
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 manipulating PINs and phonebooks; low-level commands allow you to SELECT any
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 arbitrary file (MF/DF/EF) and to perform READ and UPDATE commands on any EF
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 (BINARY or RECORD as appropriate) as the card will allow, given your access
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 level. We (FreeCalypso core team) are also doing some experiments with
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 programmable SIM cards, hoping to some day be able to issue our own SIMs, but
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 this work is currently very experimental and not ready for consumption.
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 fc-uicc-tool is currently a very minimal tool for a few narrow use cases. It
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 implements a small subset of fc-simtool commands (basic low-level ones), but
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 speaking the new UICC protocol to the card - as well as new SELECT by AID
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 commands that are only possible with this new protocol, granting access to ADFs
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 for USIM and ISIM. The tool's only useful functions right now are (1) testing
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 whether or not a given card has USIM/ISIM functionality present, and (2)
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 manually exploring the file system under ADF.USIM or ADF.ISIM which cannot be
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 accessed in any other way. fc-uicc-tool does NOT currently replicate any of
2997836930f3 README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35 the high-level end-user-oriented functionality of fc-simtool!