FreeCalypso > hg > fc-pcsc-tools

comparison doc/User-oriented-commands @ 65:cc48ac3b151c

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc/User-oriented-commands: basic info commands documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 14 Feb 2021 23:03:00 +0000
parents 8cd4771bdd79
children d4058ae94749
comparison
equal deleted inserted replaced
64:8cd4771bdd79 65:cc48ac3b151c
99 verify-pin2 XXXX 99 verify-pin2 XXXX
100 change-pin2 old-PIN new-PIN 100 change-pin2 old-PIN new-PIN
101 unblock-pin2 PUK2-secret-code new-PIN2 101 unblock-pin2 PUK2-secret-code new-PIN2
102 102
103 Unlike PIN1, PIN2 cannot be disabled per traditional SIM card standards. 103 Unlike PIN1, PIN2 cannot be disabled per traditional SIM card standards.
104
105 Getting basic info from the SIM
106 ===============================
107
108 The following commands are available for retrieving basic info from the SIM:
109
110 iccid
111
112 This command retrieves the ICCID (Integrated Circuit Card ID) record from the
113 SIM - it is a number of up to 20 digits (although 19-digit ICCIDs are most
114 common) that identifies the SIM card as a physical artifact. If your SIM is of
115 the traditional operator-issued kind, as opposed to a developer-oriented
116 programmable SIM from vendors like Sysmocom who have different ideas, this ICCID
117 will usually be the SIM card ID number printed on the physical plastic, along
118 with a barcode representation of the same number.
119
120 imsi
121
122 This command retrieves the IMSI (International Mobile Subscriber Identity) from
123 the SIM - it is the most fundamental ID token by which GSM phones present
124 themselves to networks, and they even use the first 5 or 6 digits of the IMSI
125 to decide which network they should try connecting to first.
126
127 sst
128
129 Every SIM card is required to have an essential data record (an EF in technical
130 terms) called the SIM Service Table, or SST. This SST indicates which services
131 are allocated and activated on the given SIM. Our sst command lists all
132 allocated service numbers, listing just a plain number if the service is both
133 allocated and activated (the usual case), or a number with a '^' suffix if the
134 service is allocated but not activated. You will need to look in the 3GPP TS
135 51.011 spec to make sense of these service numbers.
136
137 user-sum
138
139 This command displays a user-friendly summary of user-oriented services present
140 on the SIM. It reads SST to get the list of available and activated services,
141 but it considers only user-oriented ones (as opposed to SIM services dealing
142 with GSM network functions or serving operators' interests rather than users'),
143 and it displays them in a user-friendly manner. For each present SIM phonebook
144 (ADN, FDN, SDN) and for the SMS store, user-sum displays the storage capacity
145 provided by the SIM (number of phonebook entries or messages), and for each of
146 the various phonebooks, the allocated number of alpha tag bytes is also
147 displayed.
148
149 The number of bytes allocated for the alpha tag in SIM phonebooks determines
150 the maximum length of the name field in each phonebook entry. These name fields
151 can be written either in GSM7 encoding (GSM 03.38 aka 3GPP 23.038) or in UCS-2;
152 when GSM7 encoding is used, no SMS-style septet packing is applied - instead the
153 high bit of each byte is simply cleared. Therefore, the maximum number of
154 characters in a phonebook entry name field usually equals the number of bytes
155 allocated for the alpha tag on the SIM, except for names containing ASCII
156 characters [\]^ and {|}~ which get expanded to 2-character escape sequences in
157 GSM7 encoding.
158
159 uicc-dir
160
161 If your SIM card functions not only as a classic GSM 11.11 SIM, but also as a
162 UICC with USIM/ISIM or other UICC-based applications, it will have a file named
163 EF_DIR in its file system, listing those applications. fc-simtool uicc-dir
164 command dumps the content of this file in a human-readable form - but please
165 note that fc-simtool only speaks the classic GSM 11.11 protocol to the SIM, and
166 not the UICC protocol. EF_DIR does not officially exist in the classic GSM SIM
167 spec, hence the dir command in fc-uicc-tool (speaking the UICC protocol) is the
168 official way to read and dump the content of EF_DIR.
169
170 Manipulating SIM phonebooks
171 ===========================
172
173 Manipulating stored SMS
174 =======================
175
176 Manipulating SMS profiles
177 =========================
178
179 Identifying MVNO SIMs
180 =====================
181