Specifications

Chapter 17 – Audio Commands
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371B) 205
16.5 AT+CPBW Write into Phonebook
Description: The AT+CPBW write command can be used to create, edit and delete a phonebook entry
at a <location> of the active storage selected with AT+CPBS.
If <storage>=”FD” (SIM fixed dialing numbers) is selected, PIN2 authentication has to be
performed prior to any write access.
The test command returns the location range supported by the current storage, the
maximum length of the <number> field, the range of supported <type> values and the
maximum length of the <text> field.
The length may not be available while SIM storage is selected. If storage does not offer
format information, the format list contains empty parenthesizes.
Test Command Syntax: AT+CPBW=?
Response: +CPBW: (1-<maxloc>), <nlength>, (list of supported <type>s), <tlength>
OK
ERROR
+CME ERROR
Write Command Syntax: AT+CPBW=[<location>][, <number>[[, <type>][, <text>]]]
Response: OK
ERROR
+CME ERROR
Parameter Description:
<location>
Location number within phonebook memory. The maximum range supported by each storage type is indicated in
the test command response. If <location> is not given, the first free entry will be used.
If <location> is given as the only parameter, the phonebook entry specified by <location> is deleted.
<number>
Phone number in format specified by <type>. Parameter must be present, although it may be an empty string.
Alphabetic characters are not permitted. <number> may contain dialstring modifiers “*”, “#” or “+”.
If other printable non-alphabetic characters are used the entry needs to be saved with <type>=209. Otherwise, if
<type>=209 is not used any non-digit characters other than “*”, “#” or “+” will be removed from the string and only
accepted modifiers from the GSM alphabet will be saved.
A <number> saved with <type>=209 requires double memory. In order to fit into a standard location, the number
needs to be reduced to a maximum length of <nlength>/2, including all digits and dial string modifiers.
Extended locations may be used as stated below for <nlength>.
<type>
Type of address octet, which defines the used type of number (ton) and the numbering plan identification (npi).
Please consider that for types other than 129 or 145 dialing from phonebook with ATD><mem><n> is, depending
on the network, not always possible (refer GSM 04.08 subclause 10.5.4.7 for details). Supported values are:
145 Dialing string <number> includes international access code character ‘+’
161 National number. The network support for this type is optional.
209 Dialing string <number> will be saved as ASCII string.
This is the default value, if <type> is not specified explicitly and characters other than “*”, “#” or
“+” are included in <number>.
Note that phonebook entries saved with this type cannot be dialed.
255 Dialing string <number> is a command to control a Supplementary Service; i.e., “*”, “#” codes are
contained. Network support of this type is optional.
129 Otherwise
This is the default value, if <type> is not specified explicitly and characters other than “*”, “#” or
“+” are not included in <number>.
<text>
Text assigned to the phone number. The maximum length of this parameter is given in the test command
response <tlength>. When using an ASCII terminal, characters which are coded differently in ASCII and GSM
have to be entered via escape sequences as described in Section 1.5, Supported character sets.
<maxloc>
Maximum number of locations supported by the currently selected storage. For phonebooks located on SIM, this
value varies depending on the SIM card. See AT+CPBS for typical values.
<nlength>
Maximum length of phone number for “normal” locations. Depending on the storage, a limited number of
locations with extended memory is available per phonebook. These locations allow storing numbers with twice
the standard length, which is 2*<nlength> digits for normal numbers, but only <nlength> digits for numbers saved
with parameter <type>= 209. If all extended locations of the selected phonebook are used up, then any attempt
to write a number which requires extended memory will be denied with CME ERROR 260: INVALID DIAL
STRING.