FreeCalypso > hg > fc-sim-tools

annotate doc/Back-end-selection @ 99:97ba63d9361a

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
scripts/fcsim1-sst: turn off STK & OTA services In the initial unprogrammed state of the cards from Grcard, SST has services 25 through 29 set to allocated and activated. However, these cards appear to not actually support OTA, ENVELOPE commands do nothing (just return SW 9000), and they were never observed issuing any proactive SIM commands, even after a feature-generous TERMINAL PROFILE. Therefore, let's list these STK & OTA services as allocated, but not activated in our FCSIM1 SST.
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 05 May 2021 04:26:07 +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.