Lancaster University / BLE_API

Dependents:   microbit-dal microbit-dal microbit-ble-open microbit-dal ... more

Fork of BLE_API by Bluetooth Low Energy

Committer:
vcoubard
Date:
Mon Jan 11 08:52:02 2016 +0000
Revision:
1118:88af68f0226b
Parent:
803:50c9096035b1
Synchronized with git rev 42a202e0
Author: Andres Amaya Garcia
Finilise Whitelisting experimental API

This is the finilised experimental API that introduces support for
whitelisting. The changes are focused in Gap and introduces the following
functions, that are expected to be implemented by each of the vendor specific
glue code (e.g. ble-nrf51822 module):

- getMaxWhitelistSize(): Get the maximum whitelist size, this can be set by
using a yotta config definition.
- getWhitelist(): Gets a copy of the internal whitelist containing BLE
addresses.
- setWhitelist(): Replace the whitelist with new addresses.
- setAdvertisingPolicyMode(), setScanningPolicyMode() and
setInitiatorPolicyMode(): Functions used to set the relevan policy filter
mode as described in the BLE Specification v4.2 Vol 6, Part B, Section 4.2.1.
- getAdvertisingPolicyMode(), getScanningPolicyMode() and
getInitiatorPolicyMode(): Functions used to get the relevan policy filter
mode as described in the BLE Specification v4.2 Vol 6, Part B, Section 4.2.1.

The following enumerators were added to Gap to describe the desired policy
filter mode:

- AdvertisingPolicyMode_t
- ScanningPolicyMode_t
- InitiatorPolicyMode_t

Finally, the following typedef was added to provide a view of the
underlying implementation's internal whitelist:

- Whitelist_t

**NOTE:** Clearly, these API additions require changes to the underlying
implementation!

Who changed what in which revision?

UserRevisionLine numberNew contents of line
rgrover1 803:50c9096035b1 1 Copyright (c) 2015 ARM Limited
rgrover1 803:50c9096035b1 2
rgrover1 803:50c9096035b1 3 Licensed under the Apache License, Version 2.0 (the "License");
rgrover1 803:50c9096035b1 4 you may not use this file except in compliance with the License.
rgrover1 803:50c9096035b1 5 You may obtain a copy of the License at
rgrover1 803:50c9096035b1 6
rgrover1 803:50c9096035b1 7 http://www.apache.org/licenses/LICENSE-2.0
rgrover1 803:50c9096035b1 8
rgrover1 803:50c9096035b1 9 Unless required by applicable law or agreed to in writing, software
rgrover1 803:50c9096035b1 10 distributed under the License is distributed on an "AS IS" BASIS,
rgrover1 803:50c9096035b1 11 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
rgrover1 803:50c9096035b1 12 See the License for the specific language governing permissions and
rgrover1 803:50c9096035b1 13 limitations under the License.