Home · All Classes · Grouped Classes · Annotated · Functions

[Previous: Modem Emulator - Control and Status] [Next: Modem Emulator - Identification]

Modem Emulator - Phonebook Operations

Phonebook Operations

The AT commands in this section are used for accessing the SIM phone book.

AT+CPBF Find phonebook entries

The AT+CPBF command allows for searching the phonebook entries from the current phonebook memory storage selected with +CPBS.

CommandPossible Responses
AT+CPBF=<findtext>[+CPBF: <index1>,<number>,<type>,<text>[<hidden>][[...]<CR><LF> +CPBF: <index2>,<number>,<type>,<text>[<hidden>]]], +CME ERROR: <err>
AT+CPBF=?+CPBF: [<nlength>],[<tlength>], +CME ERROR: <err>

Test command returns the maximum length of <number> and <text> fields.

The set command returns a set of four parameters, each representing an entry in the phonebook memory. If the memory has several entries which alphanumeric field start with <findtext> each entry is returned on a separate line. The search is caseinsensitive.

<index1>, <index2>integer number indicating the location number of a phonebook entry
<number>string type phone number of format <type>
<type>string type, phone number of format <type>; default 145 when dialling string includes "+", otherwise 129
<text>string type, character set as specified by selected character set +CSCS

Conforms with: 3GPP TS 27.007.

AT+CPBR Read phonebook entries

The AT+CPBR command allows for reading the phonebook entries from the current phonebook memory storage selected with +CPBS.

CommandPossible Responses
AT+CBPR=<index1>[,<index2>][+CPBR: <index1>,<number>,<type>,<text>[[...]<CR><LF> +CPBR: <index2>,<number>,<type>,<text>]], +CME ERROR: <err>
AT+CPBR=?+CPBR (list of supported <index>s), [<nlength>], [<tlength>], +CME ERROR: <err>

Test command returns the available location indices, the maximum length of phone number fields and the maximum length of text fields.

The set command returns a set of four parameters, each representing an entry in the phonebook memory. If the memory has several entries each entry is returned on a separate line.

<index>, <index1>, <index2>integer number indicating the location number of a phonebook entry
<number>string type phone number of format <type>
<type>string type, phone number of format <type>; default 145 when dialling string includes "+", otherwise 129
<text>string type, character set as specified by selected character set +CSCS

Conforms with: 3GPP TS 27.007.

AT+CPBS Select phonebook memory storage

The AT+CPBS command allows for querying and selecting the phone book storage.

CommandPossible Responses
AT+CBPS=<storage>OK, +CME ERROR: <err>
AT+CPBS?+CPBS: <storage>,[<used>,<total>], +CME ERROR: <err>
AT+CPBS=?+CPBS (list of <storage>s)

The set command sets the selected phonebook memroy to <storage>. A list of available phonebook memories can be obtained when using the test command.

The Read command returns the currently selected storage and the used/total number of locations in the selected memory.

This implementation is not entirely conform with 3GPP TS 27.007. It is not possible to set a password for phone book stores.

AT+CPBW Write phonebook entry

The AT+CPBW command allows for writing of the phonebook entries from the current phonebook memory storage selected with +CPBS.

CommandPossible Responses
AT+CBPW=[<index>][,<number>[,<type>,<text>]]+CME ERROR: <err>
AT+CPBW=?
  • +CPBW (list of supported <index>s), [<nlength>], (list of supported <type>s), [<tlength>]
  • +CME ERROR: <err>

Test command returns the available location indices, the maximum length of phone number fields, the supported number formats of the storage and the maximum length of text fields.

The set command expects a set of four parameters. <index> determines the location where the current write operation takes place. In addition the entry field contains the phone number <number> (in the format <type>), and the text associated with the given number. If these fields are omitted the phonebook entry at <index> is deleted. If <index> is omitted but <number> is given the entry is saved at the first free location in the phonebook.

<index>integer number indicating the location number of a phonebook memory entry
<number>string type phone number of format <type>
<type>string type, phone number of format <type>; default 145 when dialling string includes "+", otherwise 129
<text>string type, character set as specified by selected character set +CSCS

Conforms with: 3GPP TS 27.007.

[Previous: Modem Emulator - Control and Status] [Next: Modem Emulator - Identification]


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3