FreeCalypso > hg > fc-pcsc-tools

annotate README @ 74:8562d8508cf2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
grcard2-set-{adm,super}-hex commands implemented It appears that GrcardSIM2 cards allow arbitrary 64-bit keys for ADM and SUPER ADM, not necessarily consisting of ASCII digits like the specs require for standard PIN and PUK, and pySim-prog.py in fact sets the ADM key to 4444444444444444 in hex by default, which is not an ASCII digit string. If the cards allow such keys, we need to support them too.
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 16 Feb 2021 04:10:36 +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!