At+Cpbw Write Into Phonebook - Multi-Tech MultiModem EDGE Reference Manual

•
The following call history rule applies to the phonebook types "LD", "MC" and "RC": When the same number is
dialed several times in direct succession the "LD" phonebook will store one single entry. When dialed several
times, but in a row with different numbers, the same number will be logged each time after dialing, resulting in
double or multiple "LD" phonebook entries related to this number.
Likewise, the "MC" or "RC" phonebook will store only a single entry when calls from the same number are
received in direct succession, and double or multiple entries when calls from the same number are received
several times, but amongst other incoming calls from different numbers.

15.5 AT+CPBW Write into Phonebook

Description:
Test Command Syntax:
Response:
Write Command Syntax:
Response:
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 dial_string 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). If <type> is not specified
the unknown <type>=129 is used. If <number> contains a leading "+" <type>=145 (international) is used.
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 Unknown number. If <type> is unknown and the <number> contains a leading "+", <type>=145
(international) is used.
<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.
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371G)
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.
AT+CPBW=?
+CPBW: (1-<maxloc>), <nlength>, (list of supported <type>s), <tlength>
OK
ERROR
+CME ERROR
AT+CPBW=[<location>][, <number>[[, <type>][, <text>]]]
OK
ERROR
+CME ERROR
Chapter 15 – Phonebook Commands
231