📄 readme.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>ReadMe for Phonebook Access Profile Client Example</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<style type="text/css">
h1,h2,h3,h4{font-family: arial;color: #0060a9}
body,a{font-family: arial}
</style>
</head>
<body>
<h1>ReadMe for Phonebook Access Profile Client Example</h1>
<hr>
<p>
<a href="#Description">Description</a>
<br><a href="#Prerequisites">Prerequisites</a>
<br><a href="#RunningApplication">Running the Application</a>
<br><a href="#ConfigurationDetails">Configuration Details</a>
<br><a href="#IncludedFiles">Files Included in the Project</a>
<br><a href="#Troubleshooting">Troubleshooting</a>
</p>
<h2><a name="Description">Description</a></h2>
<p>
This example uses the PBAP client library (<code>pbapc</code>) to demonstrate basic Phonebook access client functionality
and uses a Win32 application to control the VM application over the UART using AT-Commands to invoke:
</p>
<ul>
<li>Pull vCard List</li>
<li>Pull vCard Entries</li>
<li>Download phonebook</li>
</ul>
<p>
A PBAP server should be made available to provide Phonebook browse and vCard download functionality (see <code>pbap_server</code> project).</p>
<p>
This ReadMe is not intended to describe procedures that are covered in the xIDE user guide such as building projects in xIDE etc.
</p>
<p>
For further information, please read the support documentation supplied with BlueLab or visit the CSR technical newsgroups (see <a href="http://www.csr.com/forum.htm"> http://www.csr.com/forum.htm</a>)
</p>
<h2><a name="Prerequisites">Prerequisites</a></h2>
<h3>Hardware requirements</h3>
The following are required:
<ul>
<li>A CSR BlueCore development board with UART connection e.g. CaSiRa endpoint device with BlueCore module </li>
<li>A host PC with an available COM port</li>
<li>A 9-pin serial cable</li>
<li>A Bluetooth PBAP Server device (see <code>pbap_server</code> project)</li>
</ul>
<p>
To download the application to the BlueCore chip, an SPI connection is required
between the development hardware and the PC hosting xIDE.
</p>
<h3>Software requirements</h3>
<p>
The Win32 Phonebook Access Client application (<code>pbap_client.exe</code>) is required to run on the host PC and can be found in the <code>\tools\bin</code> folder.
</p>
<h2><a name="RunningApplication">Running the application</a></h2>
The following details include steps which are valid for Windows XP Service Pack 2 but may vary on other systems and/or different Bluetooth stacks.
<ol>
<li>Open the <code>pbap_client</code> example project (<code>pbap_client.xip</code>) in xIDE.</li>
<li>Build (<b>F7</b>) and Run (<b>F5</b>) the application from within xIDE.</li>
<li>Launch the Win32 PBAP client application and select the correct COM port and Bluetooth address of the PBAP server device.</li>
<li>Press the <b>Connect to BlueCore</b> button and monitor the messages in the <code>Phonebook Log</code> window.</li>
<li>Press the <b>Connect to PBAP Server</b> button.</li>
</ol>
<h3>Download and Browse the Phonebook</h3>
<ol>
<li>Press the <b>Download Phonebook</b> button.</li>
<li>Press the <b>Browse Phonebook</b> button.</li>
<li>Select the repository and phonebook using the check boxes on the dialog.</li>
<li>Enter the Start position and Maximum number of returned entries.</li>
<li>The filter can be used to display a list of all non-mandatory fields. Vendor Specific filters and Mandatory fields are not displayed.</li>
<li>The selected phonebook will be displayed in the results list box.
</ol>
<h3>Downloading vCard entries</h3>
<ol>
<li>Enter the Start position and Maximum number of returned entries.</li>
<li>The filtered vCard entries will be displayed in the results list box.
<li>Enter the vCard index in the filter.</li>
<li>The vCard will be displayed in the results list box.
</ol>
<h2><a name="ConfigurationDetails">Configuration Details</a></h2>
<h3>PS Keys</h3>
<p>
It is not required to use the PSTool to set these PSKEY settings since the <code>pbabp_client.psr</code> file sets the following PSKEY Settings while executing the project:
</p>
<table border="1">
<tr><th width=200>PS Key</th><th width=400>PS Key Description</th><th width=200>Value</th></tr>
<tr><td>PSKEY_FIXED_PIN</td><td>PIN used for pairing with the PBAP server</td><td>8888</td></tr>
</table>
<p>
Please use the 'Describe' feature in the supplied PSTool application for
more details about PS Keys.
</p>
<h2><a name="FilesIncluded">Files Included in the Project</a></h2>
<table border="1">
<tr><th width=300>File(s)</th><th width=600>Description</th></tr>
<tr><td><code>pbap_client.xip</code></td><td>Project file</td></tr>
<tr><td><code>main.h, .c</code></td><td>Main <code>pbabp_client</code> application</td></tr>
<tr><td><code>handle_pbap.h, .c</code></td><td>Main message handler</td></tr>
<tr><td><code>handle_command.c</code></td><td>AT-command handler</td></tr>
<tr><td><code>handle_connection.h, .c</code></td><td>BT connection handler</td></tr>
<tr><td><code>handle_system.h, .c</code></td><td>Generic message handler</td></tr>
<tr><td><code>generate_at_resp.h, .c</code></td><td>AT-command response generator</td></tr>
<tr><td><code>state.h, .c</code></td><td>State machine definitions</td></tr>
<tr><td><code>pbap_client_parse.parse</code></td><td>AT-command format definitions</td></tr>
<tr><td><code>pbap_client.psr</code></td><td>Application PS Keys</td></tr>
<tr><td><code>pbap_client_vmprops.xml</code></td><td>Additional project properties (see above)</td></tr>
</table>
<h2><a name="Troubleshooting">Troubleshooting</a></h2>
<table border="1">
<tr><th width=450>Symptom</th><th width=450>Suggested actions</th></tr>
<tr><td>No connection</td><td>
Ensure that the Bluetooth address and PIN matches that of the server device
</td></tr>
<tr><td>Failed to browse PBAP records</td><td>
Ensure that the PBAP server is running</td></tr>
</table>
<p>
See <a href="..\..\TroubleshootingTheVMAndDSP.html">Troubleshooting the VM and DSP</a>.
</p>
<br><br><hr>
Copyright © Cambridge Silicon Radio Limited 2006-2009.<br>Part of BlueLab 4.1-Release
</body>
</html>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -