comparison doc/User-oriented-commands @ 136:5494795406e0

doc/User-oriented-commands: FDN enable/disable documented
author Mychaela Falconia <falcon@freecalypso.org>
date Sun, 21 Feb 2021 01:05:05 +0000
parents 49f259cdb39e
children
comparison
equal deleted inserted replaced
135:49f259cdb39e 136:5494795406e0
122 This command retrieves the IMSI (International Mobile Subscriber Identity) from 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 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 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. 125 to decide which network they should try connecting to first.
126 126
127 It should also be noted that if your SIM has FDN (Fixed Dialing Numbers) enabled
128 and the card implements GSM SIM specs to the letter, including the idiotic
129 parts, then you will need to issue a rehab-imsi command before you can read the
130 IMSI record - see the FDN section further in this document.
131
127 sst 132 sst
128 133
129 Every SIM card is required to have an essential data record (an EF in technical 134 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 135 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 136 are allocated and activated on the given SIM. Our sst command lists all
286 pb-erase-range PBNAME start-rec end-rec 291 pb-erase-range PBNAME start-rec end-rec
287 292
288 This command erases the specified range of records in the named phonebook. The 293 This command erases the specified range of records in the named phonebook. The
289 starting record must be identified by number (SIM record numbers are 1-based); 294 starting record must be identified by number (SIM record numbers are 1-based);
290 the ending record argument may be either a number or the "end" keyword. 295 the ending record argument may be either a number or the "end" keyword.
296
297 Enabling and disabling FDN
298 ==========================
299
300 The Fixed Dialing Numbers (FDN) mechanism is normally disabled. The protocol
301 prescribed by GSM SIM specs is that FDN is enabled when the regular ADN
302 phonebook is invalidated, and is disabled (unrestricted dialing allowed)
303 otherwise. fc-simtool provides commands for invalidating and rehabilitating
304 ADN, thereby enabling and disabling FDN:
305
306 inval-adn
307
308 This command invalidates ADN and thereby enables FDN.
309
310 rehab-adn
311
312 This command rehabilitates ADN and thereby disables FDN.
313
314 The SIM will only allow inval-adn and rehab-adn operations after you have
315 successfully authenticated with PIN2 - see verify-pin2 command description.
316
317 GSM SIM specs also stipulate a certain hack to prevent FDN-ignorant phones from
318 making "forbidden" unrestricted calls: the specs stipulate that when a SIM
319 powers up in an FDN-enabled state (ADN is invalidated), the "smart" logic in
320 the SIM invalidates two essential files EF_IMSI and EF_LOCI (needed for GSM
321 operation), requiring the phone (ME) to rehabilitate these two files at the
322 beginning of every SIM session when FDN is in use. The thinking must have been
323 that if a given ME knows how to do these extra rehab-imsi, rehab-loci steps,
324 then it also knows about FDN and will honor it. Our answer: OK, whatever - but
325 we do provide rehab-imsi and rehab-loci commands in fc-simtool. These
326 operations require only CHV1 access, thus PIN1 or no PIN at all depending on
327 whether or not PIN1 is enabled - no need for PIN2.
291 328
292 Last Number Dialed (LND) 329 Last Number Dialed (LND)
293 ======================== 330 ========================
294 331
295 Traditional SIMs include a cyclic file that is intended to be updated whenever 332 Traditional SIMs include a cyclic file that is intended to be updated whenever