FreeCalypso > hg > fc-sim-tools

annotate doc/Back-end-selection @ 93:6041c601304d

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
fcsim1-mkprov: revert OTA key addition It appears that GrcardSIM2 cards (which is what we got for FCSIM1) do not support OTA after all, contrary to what we were previously led to believe by some tech support emails from Grcard - apparently those support emails and OTA descriptions referred to some other card model(s).
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 21 Apr 2021 05:38:39 +0000
parents 831a224e182b
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
49
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 fc-simtool and fc-uicc-tool can operate on SIM cards via any of the following 3
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 access paths:
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 * The card to be operated on can be inserted into a smart card reader/programmer
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 supported by pcsc-lite software stack, such as HID Omnikey 3121 and 6121 card
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 readers sold by Sysmocom webshop;
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 * The card can be inserted into a much simpler serial SIM reader - see the
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 Serial-SIM-readers article;
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 * The card can be sitting inside a Calypso phone or development board - see the
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 SIM-in-Calypso-phone article.
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14 In the PC/SC and serial SIM reader use cases, you run fc-simtool or fc-uicc-tool
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 directly, with the needed options to select the right target. In the more
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 special case of operating on SIM cards inside Calypso GSM devices, you have to
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 use the fc-simint front end described in the SIM-in-Calypso-phone article.
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 When running fc-simtool or fc-uicc-tool directly to operate on a card inserted
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 into a dedicated reader/programmer, use the following options to select the
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21 correct target:
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 -d /dev/ttyXXX
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 This option selects the serial SIM reader back end, operating on the
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 named serial port. See the Serial-SIM-readers article for additional
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27 speed enhancement options.
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29 -p N
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 This option selects the pcsc-lite back end, operating on reader number
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
32 N. If you have only one PC/SC-supported card reader on your system,
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
33 the correct option is -p0. If you have multiple readers, use
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
34 fc-pcsc-list utility to list them and figure out which number is which.
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
35
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
36 There is no default: if you run fc-simtool or fc-uicc-tool with neither -d nor
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
37 -p, you will get an error.
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
38
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
39 Each of the two target selection options runs a different back end program
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
40 behind the scenes: -d runs fcsim-serial-be, -p runs fc-pcsc-backend. This
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
41 separation allows for subset installations: if someone is only interested in
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
42 serial and/or Calypso back ends and does not have libpcsclite installed, they
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
43 can omit the pcsc back end, in which case fc-pcsc-backend won't be present and
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
44 therefore -p option won't work. One can similarly omit the serial and Calypso
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
45 back ends, although the Mother does not currently know of any practical system
831a224e182b doc/Back-end-selection article written
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
46 where they would pose compile-time difficulties.