annotate doc/Back-end-selection @ 103:3477438b5706 default tip

new fc-simtool command script: oper-sim-test
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 06 Aug 2022 16:34:43 +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.