8.14 Write phonebook entry +CPBW

27.0073GPPAT command set for User Equipment (UE)Release 18TS

Tools: ARFCN - Frequency Conversion for 5G NR/LTE/UMTS/GSM

Table 74: +CPBW parameter command syntax

Command	Possible response(s)
+CPBW=[<index>][,<number>[,<type>[,<text>[,<group>[,<adnumber>[,<adtype>[,<secondtext>[,<email>[,<sip_uri>[,<tel_uri>[,<hidden>]]]]]]]]]]]	+CPBW: <written_index> +CME ERROR: <err>
+CPBW?	+CPBW: <written_index>
+CPBW=?	+CPBW: (list of supported <index>s),[<nlength>],(list of supported <type>s),[<tlength>],[<glength>],[<slength>],[<elength>],[<siplength>],[<tellength>] +CME ERROR: <err>

Description

Execution command writes phonebook entry in location number <index> in the current phonebook memory storage selected with +CPBS. Entry fields written are phone number <number> (in the format <type>), text <text> associated with the number, if the selected phonebook supports hidden entries, <hidden> parameter, which indicates if the entry is hidden or not, <group> indicating a group the entry may belong to, <adnumber> an additional number (of format <adtype>), <secondtext> a second text field associated with the number, <email> an email field, <sip_uri> SIP number and <tel_uri> TEL number. If all those fields are omitted, the phonebook entry is deleted. If <index> is left out, but <number> is given, the entry is written to the first free location in the phonebook (the implementation of this feature is manufacturer specific). For successfull writes where <index> is not given, the intermediate result code +CPBW: <written_index> may be provded to indicate the location the entry was written to. If writing fails in an MT error, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.

Read command returns the last <written_index> value, or -1 if information about previous value is not available.

NOTE: Changing the current phonebook memory storage with +CPBS to another storage invalidates the last <written_index> value.

Test command returns location range supported by the current storage and types of address as compound values, the maximum length of <number> field, supported number formats of the storage, the maximum length of <text> field, the maximum length of <group>, the maximum length of <secondtext>, the maximum length of <email>, the maximum length of <sip_uri> and the maximum length of <tel_uri>. In case of SIM storage, the lengths may not be available. If MT is not currently reachable, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values. If storage does not offer format information, the format list should be empty parenthesis.

Defined values

<index>: integer type values in the range of location numbers of phonebook memory

<number>: string type phone number of format <type>

<type>: type of address octet in integer format (refer 3GPP TS 24.008 [8] clause 10.5.4.7) ; default 145 when dialling string includes international access code character "+", otherwise 129

<text>: string type field of maximum length <tlength>; character set as specified by command select TE character set +CSCS

<group>: string type field of maximum length <glength>; character set as specified by command select TE character set +CSCS

<adnumber>: string type phone number of format <adtype>

<adtype>: type of address octet in integer format (refer 3GPP TS 24.008 [8] clause 10.5.4.7)

<secondtext>: string type field of maximum length <slength>; character set as specified by command select TE character set +CSCS

<email>: string type field of maximum length <elength>; character set as specified by command select TE character set +CSCS

<sip_uri>: string type field of maximum length <siplength>; character set as specified by command select TE character set +CSCS

<tel_uri>: string type phone number of maximum length <tellength>; character set as specified by command select TE character set +CSCS

<nlength>: integer type value indicating the maximum length of field <number>

<tlength>: integer type value indicating the maximum length of field <text>

<glength>: integer type value indicating the maximum length of field <group>

<slength>: integer type value indicating the maximum length of field <secondtext>

<elength>: integer type value indicating the maximum length of field <email>

<siplength>: integer type value indicating the maximum length of field <sip_uri>

<tellength>: integer type value indicating the maximum length of field <tel_uri>

<hidden>: integer type value indicates if the entry is hidden or not

0: phonebook entry not hidden

1: phonebook entry hidden

<written_index>: integer type value indicating the last location number <index> of the written phonebook entry

Implementation

Optional.