PBAPΒΆ
Audio Agent includes a generic access to downloading the phonebook with PBAP(v1.1.1). To download the phonebook the following command can be used.
PB_PULL (link_id) [repository] [phonebook] [max_list] [start] [filter]
PB_ABORT can be used to stop downloading the phonebook.
LINK ID
Audio Agent PBAP link id, this will be 16, 26, 36, etc., and it can be retrieved from the STATUS command.
REPOSITORY
Value |
Description |
|---|---|
0 |
Current repository |
1 |
Local repository: the phonebook will be retrieved from the phones local memory |
2 |
Sim repository: the phonebook will be retrieved from the SIM card |
3 |
Any: the phone will select which repository to select |
PHONEBOOK
Value |
Description |
|---|---|
0 |
Not used, will default to 1 |
1 |
Main Phonebook folder |
2 |
Incoming calls history |
3 |
Outgoing calls history |
4 |
Missed calls history |
5 |
Combined call history: |
MAX LIST
The maximum number of entries to download from the remote device. If the remote device number of entries is lower than MAX LIST, then the download will finish.
START
The index of the entry to start download from. To download the whole phonebook, this should be set to 0.
FILTER
The filter defines what information to download. The filter is a 32 bit value where each bit represents a phonebook entry attribute (bits 29-31 are ignored).
Bit |
Name |
Description |
|---|---|---|
0 |
VERSION |
vCard Version |
1 |
FN |
Formatted Name |
2 |
N |
Structured Presentation of Name |
3 |
PHOTO |
Associated Image or Photo |
4 |
DAY |
Birthday |
5 |
ADR |
Delivery Address |
6 |
LABEL |
Delivery |
7 |
TEL |
Telephone Number |
8 |
Electronic Mail Address |
|
9 |
MAILER |
Electronic Mail |
10 |
TZ |
Time Zone |
11 |
GEO |
Geographic Position |
12 |
TITLE |
Job |
13 |
ROLE |
Role within the Organization |
14 |
LOGO |
Organization Logo |
15 |
AGENT |
vCard of Person Representing |
16 |
ORG |
Name of Organization |
17 |
NOTE |
Comments |
18 |
REV |
Revision |
19 |
SOUND |
Pronunciation of Name |
20 |
URL |
Uniform Resource Locator |
21 |
UID |
Unique ID |
22 |
KEY |
Public Encryption Key |
23 |
NICKNAME |
Nickname |
24 |
CATEGORIES |
Categories |
25 |
PROID |
Product ID |
26 |
CLASS |
Class information |
27 |
SORT-STRING |
String used for sorting operations |
28 |
X-IRMC-CALL-DATETIME |
vCard |
Mandatory attributes that should be enabled all the time are:
VERSION, N, and TEL.
Audio Agent defaults are:
VERSION, N, FN, TEL which from the table are bits 0, 1, 2, and 7. This turns into 135 decimal, 0x87 hex or 10000111 binary.
Note that the phonebook download requires a baud rate of 115200 or above. Lower baud rates can cause the UART to stall and lose phonebook data.