📄 readme.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>ReadMe for Phonebook Access Profile Server 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 Server 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="#AdditionalNotes">Additional Notes</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 Server library (<code>pbaps</code>) to demonstrate basic Phonebook access server functionality.
</p>
<p>
>A PBAP client (see <code>pbap_client</code>) should be available to browse the example Phonebook, vCard and Incoming call history records.</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 e.g. CaSiRa endpoint device with BlueCore module, DEV-PC-1645B BlueTunes2 development board etc</li>
<li>A Bluetooth PBAP Client device (see <code>pbap_client</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>
<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_server</code> example project (<code>pbap_server.xip</code>) in xIDE.</li>
<li>Build (<b>F7</b>) and Run (<b>F5</b>) the application from within xIDE.</li>
</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 by the PBAP client</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="AdditionalNotes">Additional Notes</a></h2>
<h3>Supported phonebooks</h3>
<p>The server does not contain a SIM1 repository. Each phonebook is stored in a file in the image directory of the project. The filename identifies the phonebook:</p>
<table border="1">
<tr><th width=200>Filename</th><th width=300>Description</th></tr>
<tr><td><code>pb.dat</code></td><td>Main Phonebook</td></tr>
<tr><td><code>ich.dat</code></td><td>Incoming Call History</td></tr>
<tr><td><code>och.dat</code></td><td>Outgoing Call History</td></tr>
<tr><td><code>mch.dat</code></td><td>Missed Call History</td></tr>
<tr><td><code>cch.dat</code></td><td>Combined Call History</td></tr>
</table>
<p>
This example application contains only a sample of the main phonebook (pb.dat) and incoming call history (ich.dat).
</p>
<h3>Phonebook File Format</h3
<p>A phonebook file is textual and only stores Name and Phone number entries. Each entry may contain a name field. It may also contain up to three phone numbers (default phone number, mobile number and business number). It does not need to contain any phone numbers.
Each field contains an identifier and the data. The field is terminated by a newline character <code>'\n'</code>. The data is non-NULL terminated string. The entry is terminated by a <code>'n'</code> without an entry.
</p>
<table border="1">
<tr><th width=100>Identifier</th><th width=300>Description</th></tr>
<tr><td><code>N</code></td><td>Name</td></tr>
<tr><td><code>P</code></td><td>Phone number</td></tr>
<tr><td><code>M</code></td><td>Mobile number</td></tr>
<tr><td><code>B</code></td><td>Business number</td></tr>
</table>
<p><b>Example:</b>
<br>Name: <b>Cardoso;Jose</b>
<br>Phone number: <b>+44156986333</b>
<br>This is represented as: <p><code>
NCardoso;Jose'\n'P+44156986333'\n\n'</code></p>
</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_server.xip</code></td><td>Project file</td></tr>
<tr><td><code>main.h, .c</code></td><td>Main <code>pbabp_server</code> application</td></tr>
<tr><td><code>handle_pbap.h, .c</code></td><td>Main message 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>buffer.h, .c</code></td><td>Buffer functionality</td></tr>
<tr><td><code>folder.h, .c</code></td><td>Folder functionality</td></tr>
<tr><td><code>vcard_gen.h, .c</code></td><td>vCard generator</td></tr>
<tr><td><code>state.h, .c</code></td><td>State machine definitions</td></tr>
<tr><td><code>pb_access.h, .c</code></td><td>Phonebook access functions</td></tr>
<tr><td><code>pbap_client_parse.parse</code></td><td>AT-command format definitions</td></tr>
<tr><td><code>pbap_server.psr</code></td><td>Application PS Keys</td></tr>
<tr><td><code>pbap_server_vmprops.xml</code></td><td>Additional project properties (see above)</td></tr>
<tr><td><code>ich.dat</code></td><td>Sample Incoming Call History record file</td></tr>
<tr><td><code>pb.dat</code></td><td>Sample Phonebook record file</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 PIN matches that used by the client device
</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 + -