FreeCalypso > hg > fc-sim-tools

comparison doc/Back-end-selection @ 49:831a224e182b

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