At^spbw Write Into Phonebook With Location Report - Multi-Tech MultiModem EDGE Reference Manual

15.6 AT^SPBW Write into Phonebook with Location
Report
The AT^SPBW write command can be used to create, edit and delete a phonebook entry at a
Description:
<location> of the active storage selected with AT+CPBS. After having written the phonebook entry
<location> is shown.
If <storage>="FD" (SIM fixed dialing numbers) is selected, PIN2 authentication has to be performed
prior to any write access.
The AT^SPBW 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.
Note: 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:
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.
<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.
Multi-Tech Systems, Inc. AT Commands for EDGE Modems (S000371G)
AT^SPBW=?
^SPBW: (1-<maxloc>), <nlength>, (list of supported <type>s), <tlength>
OK
ERROR
+CME ERROR
AT^SPBW=[<location>][, <number>[[, <type>][, <text>]]]
^SPBW: <location>
OK
ERROR
+CME ERROR
Chapter 15 – Phonebook Commands
233