Antonio Vilei / X_NUCLEO_IDB0XA1

BLE_API wrapper library for STMicroelectronics' BlueNRG Bluetooth Low Energy expansion board shield

Fork of X_NUCLEO_IDB0XA1 by ST Expansion SW Team

x-nucleo-idb0xa1/BlueNRGGattServer.h@219:9981f62cdb1a, 2016-05-16 (annotated)

Committer:
Andrea Palmieri
Date:
Mon May 16 17:22:03 2016 +0200
Revision:
219:9981f62cdb1a
Parent:
198:6a6d2f041905
Child:
231:b94d080127c7
Fix issues and add features



- Fix handles management

- Fix UUIDs management

- Implement API to read random address

- Fix clearing/setting of ADV payload

- Fix scanning behaviour

- Fix scanning while a connection is ongoing

- Implement Char Descriptor discovery

- Implement scanning/advertising filter policy (White List partial management)

- Update underlying BlueNRG stack

- Cosmetics



Signed-off-by: Andrea Palmieri <andrea.palmieri@st.com>

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Wolfgang Betz 130:770ce14d3d15 1 /* mbed Microcontroller Library
Wolfgang Betz 130:770ce14d3d15 2 * Copyright (c) 2006-2013 ARM Limited
Wolfgang Betz 130:770ce14d3d15 3 *
Wolfgang Betz 130:770ce14d3d15 4 * Licensed under the Apache License, Version 2.0 (the "License");
Wolfgang Betz 130:770ce14d3d15 5 * you may not use this file except in compliance with the License.
Wolfgang Betz 130:770ce14d3d15 6 * You may obtain a copy of the License at
Wolfgang Betz 130:770ce14d3d15 7 *
Wolfgang Betz 130:770ce14d3d15 8 * http://www.apache.org/licenses/LICENSE-2.0
Wolfgang Betz 130:770ce14d3d15 9 *
Wolfgang Betz 130:770ce14d3d15 10 * Unless required by applicable law or agreed to in writing, software
Wolfgang Betz 130:770ce14d3d15 11 * distributed under the License is distributed on an "AS IS" BASIS,
Wolfgang Betz 130:770ce14d3d15 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Wolfgang Betz 130:770ce14d3d15 13 * See the License for the specific language governing permissions and
Wolfgang Betz 130:770ce14d3d15 14 * limitations under the License.
Wolfgang Betz 130:770ce14d3d15 15 */
Wolfgang Betz 130:770ce14d3d15 16 /**
Wolfgang Betz 130:770ce14d3d15 17 ******************************************************************************
Wolfgang Betz 130:770ce14d3d15 18 * @file BlueNRGGattServer.cpp
Wolfgang Betz 130:770ce14d3d15 19 * @author STMicroelectronics
Wolfgang Betz 130:770ce14d3d15 20 * @brief Header file for BLE_API GattServer Class
Wolfgang Betz 130:770ce14d3d15 21 ******************************************************************************
Wolfgang Betz 130:770ce14d3d15 22 * @copy
Wolfgang Betz 130:770ce14d3d15 23 *
Wolfgang Betz 130:770ce14d3d15 24 * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
Wolfgang Betz 130:770ce14d3d15 25 * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
Wolfgang Betz 130:770ce14d3d15 26 * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
Wolfgang Betz 130:770ce14d3d15 27 * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
Wolfgang Betz 130:770ce14d3d15 28 * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
Wolfgang Betz 130:770ce14d3d15 29 * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
Wolfgang Betz 130:770ce14d3d15 30 *
Wolfgang Betz 130:770ce14d3d15 31 * <h2><center>&copy; COPYRIGHT 2013 STMicroelectronics</center></h2>
Andrea Palmieri 219:9981f62cdb1a 32 */
Wolfgang Betz 130:770ce14d3d15 33
Wolfgang Betz 130:770ce14d3d15 34 #ifndef __BLUENRG_GATT_SERVER_H__
Wolfgang Betz 130:770ce14d3d15 35 #define __BLUENRG_GATT_SERVER_H__
Wolfgang Betz 130:770ce14d3d15 36
Wolfgang Betz 144:bdf5e8432131 37 #include "mbed-drivers/mbed.h"
Wolfgang Betz 131:e09947216ccb 38 #include "ble/blecommon.h"
Wolfgang Betz 130:770ce14d3d15 39 #include "btle.h"
Wolfgang Betz 131:e09947216ccb 40 #include "ble/GattService.h"
Wolfgang Betz 130:770ce14d3d15 41 #include "ble/GattServer.h"
Wolfgang Betz 130:770ce14d3d15 42 #include <vector>
Wolfgang Betz 130:770ce14d3d15 43 #include <map>
Wolfgang Betz 130:770ce14d3d15 44
Wolfgang Betz 130:770ce14d3d15 45 #define BLE_TOTAL_CHARACTERISTICS 10
Wolfgang Betz 130:770ce14d3d15 46
Wolfgang Betz 130:770ce14d3d15 47 using namespace std;
Wolfgang Betz 130:770ce14d3d15 48
Wolfgang Betz 130:770ce14d3d15 49 class BlueNRGGattServer : public GattServer
Wolfgang Betz 130:770ce14d3d15 50 {
Wolfgang Betz 130:770ce14d3d15 51 public:
Wolfgang Betz 130:770ce14d3d15 52 static BlueNRGGattServer &getInstance() {
Wolfgang Betz 130:770ce14d3d15 53 static BlueNRGGattServer m_instance;
Wolfgang Betz 130:770ce14d3d15 54 return m_instance;
Wolfgang Betz 130:770ce14d3d15 55 }
Wolfgang Betz 130:770ce14d3d15 56
Wolfgang Betz 130:770ce14d3d15 57 enum HandleEnum_t {
Wolfgang Betz 130:770ce14d3d15 58 CHAR_HANDLE = 0,
Wolfgang Betz 130:770ce14d3d15 59 CHAR_VALUE_HANDLE,
Wolfgang Betz 130:770ce14d3d15 60 CHAR_DESC_HANDLE
Wolfgang Betz 130:770ce14d3d15 61 };
Wolfgang Betz 130:770ce14d3d15 62
Wolfgang Betz 130:770ce14d3d15 63 /* Functions that must be implemented from GattServer */
Wolfgang Betz 130:770ce14d3d15 64 virtual ble_error_t addService(GattService &);
Andrea Palmieri 198:6a6d2f041905 65 virtual ble_error_t read(GattAttribute::Handle_t attributeHandle, uint8_t buffer[], uint16_t *lengthP);
Andrea Palmieri 198:6a6d2f041905 66 virtual ble_error_t read(Gap::Handle_t connectionHandle, GattAttribute::Handle_t attributeHandle, uint8_t buffer[], uint16_t *lengthP);
Wolfgang Betz 130:770ce14d3d15 67 virtual ble_error_t write(GattAttribute::Handle_t, const uint8_t[], uint16_t, bool localOnly = false);
Wolfgang Betz 130:770ce14d3d15 68 virtual ble_error_t write(Gap::Handle_t connectionHandle, GattAttribute::Handle_t, const uint8_t[], uint16_t, bool localOnly = false);
Wolfgang Betz 130:770ce14d3d15 69 virtual ble_error_t initializeGATTDatabase(void);
Wolfgang Betz 130:770ce14d3d15 70
Wolfgang Betz 130:770ce14d3d15 71 virtual bool isOnDataReadAvailable() const {
Wolfgang Betz 130:770ce14d3d15 72 return true;
Wolfgang Betz 130:770ce14d3d15 73 }
Andrea Palmieri 219:9981f62cdb1a 74
Andrea Palmieri 219:9981f62cdb1a 75 virtual ble_error_t reset(void);
Wolfgang Betz 130:770ce14d3d15 76
Wolfgang Betz 130:770ce14d3d15 77 /* BlueNRG Functions */
Wolfgang Betz 130:770ce14d3d15 78 void eventCallback(void);
Wolfgang Betz 130:770ce14d3d15 79 //void hwCallback(void *pckt);
Andrea Palmieri 219:9981f62cdb1a 80 ble_error_t Read_Request_CB(uint16_t attributeHandle);
Wolfgang Betz 130:770ce14d3d15 81 GattCharacteristic* getCharacteristicFromHandle(uint16_t charHandle);
Wolfgang Betz 130:770ce14d3d15 82 void HCIDataWrittenEvent(const GattWriteCallbackParams *params);
Wolfgang Betz 130:770ce14d3d15 83 void HCIDataReadEvent(const GattReadCallbackParams *params);
Wolfgang Betz 130:770ce14d3d15 84 void HCIEvent(GattServerEvents::gattEvent_e type, uint16_t charHandle);
Wolfgang Betz 130:770ce14d3d15 85 void HCIDataSentEvent(unsigned count);
Wolfgang Betz 130:770ce14d3d15 86
Wolfgang Betz 130:770ce14d3d15 87 private:
Wolfgang Betz 130:770ce14d3d15 88 static const int MAX_SERVICE_COUNT = 10;
Wolfgang Betz 130:770ce14d3d15 89 uint8_t serviceCount;
Wolfgang Betz 130:770ce14d3d15 90 uint8_t characteristicCount;
Wolfgang Betz 130:770ce14d3d15 91 uint16_t servHandle, charHandle;
Wolfgang Betz 130:770ce14d3d15 92
Andrea Palmieri 219:9981f62cdb1a 93 std::map<uint16_t, uint16_t> bleCharHandleMap; // 1st argument is characteristic, 2nd argument is service
Wolfgang Betz 130:770ce14d3d15 94 GattCharacteristic *p_characteristics[BLE_TOTAL_CHARACTERISTICS];
Wolfgang Betz 130:770ce14d3d15 95 uint16_t bleCharacteristicHandles[BLE_TOTAL_CHARACTERISTICS];
Wolfgang Betz 130:770ce14d3d15 96
Wolfgang Betz 130:770ce14d3d15 97 BlueNRGGattServer() {
Wolfgang Betz 130:770ce14d3d15 98 serviceCount = 0;
Wolfgang Betz 130:770ce14d3d15 99 characteristicCount = 0;
Wolfgang Betz 130:770ce14d3d15 100 };
Wolfgang Betz 130:770ce14d3d15 101
Wolfgang Betz 130:770ce14d3d15 102 BlueNRGGattServer(BlueNRGGattServer const &);
Wolfgang Betz 130:770ce14d3d15 103 void operator=(BlueNRGGattServer const &);
Wolfgang Betz 130:770ce14d3d15 104
Wolfgang Betz 130:770ce14d3d15 105 static const int CHAR_DESC_TYPE_16_BIT=0x01;
Wolfgang Betz 130:770ce14d3d15 106 static const int CHAR_DESC_TYPE_128_BIT=0x02;
Wolfgang Betz 130:770ce14d3d15 107 static const int CHAR_DESC_SECURITY_PERMISSION=0x00;
Wolfgang Betz 130:770ce14d3d15 108 static const int CHAR_DESC_ACCESS_PERMISSION=0x03;
Wolfgang Betz 130:770ce14d3d15 109 static const int CHAR_ATTRIBUTE_LEN_IS_FIXED=0x00;
Wolfgang Betz 130:770ce14d3d15 110 };
Wolfgang Betz 130:770ce14d3d15 111
Wolfgang Betz 130:770ce14d3d15 112 #endif