User guide

Developers guidelines | AT commands
222 June 2010
AT+CPBW Phonebook write (ver. 4)
<tlength>: Integer. Maximum length of <findtext> field.
Description: Writes phonebook entry in location number <index> in the current
phonebook memory storage selected with AT+CPBS. Entry fields written
are phone number <number> (in the format <type>) and text <text>
associated with the number. If those fields are omitted the phonebook
entry is deleted.
Note:
• If MV, BC or HP is the currently selected phonebook storage, +CME
ERROR: <err> will be returned.
• DC, RC and MC storages are not supported.
• Flags may be used to indicate the contact field where the number
should be stored. If no flag is used, the phone number will be stored as
type “home”.
• A new phonebook entry will always use the first free position,
independent of what <index> has been set to.
• The <type> parameter is ignored, the + sign in <number> determines if
the number is international or national.
• If phone is the currently selected phonebook storage and AT+CPBW is
used with an <index> that is already used by another number, the old
number will be overwritten and removed from whatever contact it was
previously a part of.
The name of the contact will be changed if the phone is the currently
selected phonebook storage and the following criteria are met:
• AT+CPBW is used with an <index> that is part of a certain contact
• all other parameters except <text> are omitted
• the <text> parameter differs from the name of the contact in question
The <number> of the contact will be changed if:
• <number> parameter differs from the number of the contact in question
• <text> parameter is the same as the contacts <text> in question
• all the other parameters are omitted
Note: <type> is set to its default value, 129, if it is omitted.
Execution
command: AT+CPBW=[<index>][,<number>[,<type>[,<text>]]]
Test command: AT+CPBW=? Shows if the command is supported.
Test command
response: +CPBW: (list of supported <index>s),<nlength>,(list of supported
<type>s), <tlength>.
Parameters:
<index>: Integer. Values in the range of location numbers of phonebook memory.
<number>: String. Phone number of format <type>.
<type>: