FreeCalypso > hg > fc-pcsc-tools
comparison doc/User-oriented-commands @ 70:8dee7aa9ec58
doc/User-oriented-commands: phonebook commands documented
| author | Mychaela Falconia <falcon@freecalypso.org> |
|---|---|
| date | Mon, 15 Feb 2021 04:38:09 +0000 |
| parents | d4058ae94749 |
| children | a008f7a4bddf |
comparison
equal
deleted
inserted
replaced
| 69:d4058ae94749 | 70:8dee7aa9ec58 |
|---|---|
| 208 It is not clear if ordinary end user phones would do anything useful with | 208 It is not clear if ordinary end user phones would do anything useful with |
| 209 the extra records if one were to write something there. | 209 the extra records if one were to write something there. |
| 210 | 210 |
| 211 fc-simtool provides a unified set of commands and data formats for working with | 211 fc-simtool provides a unified set of commands and data formats for working with |
| 212 all SIM phonebooks: all pb-* commands take the name of the phonebook to be | 212 all SIM phonebooks: all pb-* commands take the name of the phonebook to be |
| 213 operated on as their first argument. | 213 operated on as their first argument. The following commands are available: |
| 214 | |
| 215 pb-dump PBNAME | |
| 216 | |
| 217 This command dumps the full content of the selected phonebook on the terminal. | |
| 218 The data format for representing SIM phonebook content in UNIX-based text files | |
| 219 and dumps is described in the SIM-data-formats document in the freecalypso-docs | |
| 220 repository. | |
| 221 | |
| 222 pb-dump PBNAME outfile | |
| 223 | |
| 224 This form of the pb-dump command dumps the full content of the selected | |
| 225 phonebook, but saves it in the named file instead of sending it to the terminal. | |
| 226 This form is ideal for making backups of large SIM phonebooks. | |
| 227 | |
| 228 pb-dump-rec PBNAME rec | |
| 229 | |
| 230 This command dumps a single record from a potentially large phonebook. | |
| 231 | |
| 232 pb-dump-rec PBNAME start-rec end-rec | |
| 233 | |
| 234 This command dumps the specified range of records from a potentially large | |
| 235 phonebook. | |
| 236 | |
| 237 pb-update PBNAME filename | |
| 238 | |
| 239 This command reads a phonebook data file in the format described in the | |
| 240 SIM-data-formats document and uploads it into the named SIM phonebook, writing | |
| 241 each record from the data file into the SIM with an UPDATE RECORD command. | |
| 242 | |
| 243 Please note that this command does NOT include a built-in erase of those SIM | |
| 244 phonebook record positions which are not covered by the data file being uploaded | |
| 245 - any non-blank records in those positions will retain their previous content. | |
| 246 | |
| 247 pb-update-imm PBNAME rec phone-number [alpha-tag] | |
| 248 | |
| 249 This command writes a single phonebook entry directly from the command line, | |
| 250 without going through a data file. The specific record index to write into must | |
| 251 always be specified (there is no built-in "find first empty record" function), | |
| 252 and the entry format for both the phone number and the alpha tag is more relaxed | |
| 253 compared to the very strict format required in data files: | |
| 254 | |
| 255 * The phone number can begin with a '+' character for international format; | |
| 256 | |
| 257 * The comma-separated TON/NPI byte is optional and will usually be omitted in | |
| 258 ordinary usage - this byte will default to 0x91 if the number begins with '+' | |
| 259 or to 0x81 otherwise; | |
| 260 | |
| 261 * Double-quotes around the alpha tag argument are required only if it contains | |
| 262 spaces or other problematic characters, and can be omitted otherwise; | |
| 263 | |
| 264 * If the alpha tag is empty, the last argument can be omitted altogether. | |
| 265 | |
| 266 pb-update-imm-hex PBNAME rec phone-number alpha-tag-hex | |
| 267 | |
| 268 This command is like pb-update-imm, but the alpha tag argument (required for | |
| 269 this command) is given in hex - intended for creating phonebook entries with | |
| 270 UCS-2 alpha tags. | |
| 271 | |
| 272 pb-erase PBNAME | |
| 273 | |
| 274 This command fully erases the named phonebook. | |
| 275 | |
| 276 pb-erase-one PBNAME rec | |
| 277 | |
| 278 This command erases the specified individual record in the named phonebook. | |
| 279 | |
| 280 pb-erase-range PBNAME start-rec end-rec | |
| 281 | |
| 282 This command erases the specified range of records in the named phonebook. The | |
| 283 starting record must be identified by number (SIM record numbers are 1-based); | |
| 284 the ending record argument may be either as a number or the "end" keyword. | |
| 214 | 285 |
| 215 Last Number Dialed (LND) | 286 Last Number Dialed (LND) |
| 216 ======================== | 287 ======================== |
| 217 | 288 |
| 218 Manipulating stored SMS | 289 Manipulating stored SMS |