Multi-Tech Systems MMCModem GPRS (MTMMC-G) - Manual (Page 49)

Chapter 8 – Phonebook Commands
Multi-Tech Systems, Inc. Wireless GSM/GPRS AT Commands (Document Number S000293I) 49
Write Phonebook Entry +CPBW
Description: This command writes a phonebook entry in location number <index> in the current phonebook memory
storage.
Notes:
• “RC” and “MC” phonebooks could be erased only by +CPBW. Adding a field and/or modifying a
field is not allowed for these phonebooks.
• This command is not allowed for “EN”, “LD”, “MC”, “RC”, “MT”, and “SN” phonebooks (they
cannot be written).
• If the AT+WCOS=1 command was used, the request would include the “Contact” structure.
Values: <index> Integer type value depending on the capacity of the phonebook memory.
<number> Phone number in ASCII format.
<type> TON/NPI (Type of address octet in integer format).
Note: The value is 145 if the dialing string (<number> response value) includes the
international access code character +; otherwise, the value is 129 (Example: a <type>
value of 17 will be written as 145).
<text> String type. Maximum length of <text> field is:
• For the Mobile Equipment phonebook, 30 ASCII characters.
•
For the ADN phonebook, SIM dependent (use AT+CPBW=?)
Notes:
• For the <text> parameter all strings starting with “80”, “81” or “81” are
considered in UCS2 format.
• The +CSCS (Select Character Set) command does not affect the format for
phonebook entries.
<contact> Contact structure.
<Phb_Group> Phonebook group number in which the entry should be saved.
The range is 1 to 10. If the entry must not be saved in a group, <Phb_Group> = 0 or
can be omitted.
Syntax: Command Syntax:
• For ADN phonebook with AT+WCOS=0
AT+CPBW=<index>[,<number>[,<type>[,<text>]]]
• For ADN phonebook with AT+WCOS=1
AT+CPBW=<index>[,<number>[,<type>[,<text> [,Phb_group>]]]]
• For the Mobile Equipment phonebook with AT+WCOS=0
AT+CPBW=<index>[,<number>[,<type>[,<text>]]]
•
For the Mobile Equipment phonebook with AT+WCOS=1
AT+CPBW=<index>[,<number>[,<type>[,<text> [<contact> [,Phb_group>]]]]]
Command Possible responses
AT+CPBS=”SM”
Note: ADN phonebook OK
AT+CPBS?
Note: Which phonebook is selected +CPBS:”SM”,1,10
OK
Note: ADN phonebook is selected, 1 location is
used and 10 locations are available.
AT+WCOS=0
Note: phonebook not extended OK
AT+CPBW=?
Note: Test command +CPBW: (1-50),20,(129,145),10
OK
Note: 50 locations, phone number = 20 digits max,
TON/NPI of 129 or 145, text length = 10
AT+CPBW=5,”112”,129,”SOS”
Note: Write at location 5 OK
Note: Location 5 written
AT+CPBR=5
Note: Read the entry at location 5 +CPBR=5,”112”,129,”SOS”
Note: Location 5 written
AT+CPBS?
Note: Which phonebook is selected +CPBS:”SM”,2,10
OK
Note: ADN phonebook is selected, 2 locations are
used and 10 locations are available.