Donal Morrissey / BLE_API_Native_blog

BLE API as used in the blog entry.

Dependents:   BLE_iBeacon_Exercise

Fork of BLE_API_Native by Kevin Townsend

hw/Gap.h@15:a854d49b3d25, 2014-02-20 (annotated)

Committer:
ktownsend
Date:
Thu Feb 20 17:23:17 2014 +0000
Revision:
15:a854d49b3d25
Parent:
0:4c3097c65247 
Prototype functions for GattServerEvents

Who changed what in which revision?

UserRevisionLine numberNew contents of line
ktownsend 0:4c3097c65247 1 /* mbed Microcontroller Library
ktownsend 0:4c3097c65247 2 * Copyright (c) 2006-2013 ARM Limited
ktownsend 0:4c3097c65247 3 *
ktownsend 0:4c3097c65247 4 * Licensed under the Apache License, Version 2.0 (the "License");
ktownsend 0:4c3097c65247 5 * you may not use this file except in compliance with the License.
ktownsend 0:4c3097c65247 6 * You may obtain a copy of the License at
ktownsend 0:4c3097c65247 7 *
ktownsend 0:4c3097c65247 8 * http://www.apache.org/licenses/LICENSE-2.0
ktownsend 0:4c3097c65247 9 *
ktownsend 0:4c3097c65247 10 * Unless required by applicable law or agreed to in writing, software
ktownsend 0:4c3097c65247 11 * distributed under the License is distributed on an "AS IS" BASIS,
ktownsend 0:4c3097c65247 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
ktownsend 0:4c3097c65247 13 * See the License for the specific language governing permissions and
ktownsend 0:4c3097c65247 14 * limitations under the License.
ktownsend 0:4c3097c65247 15 */
ktownsend 0:4c3097c65247 16
ktownsend 0:4c3097c65247 17 #ifndef __GAP_H__
ktownsend 0:4c3097c65247 18 #define __GAP_H__
ktownsend 0:4c3097c65247 19
ktownsend 0:4c3097c65247 20 #include "mbed.h"
ktownsend 0:4c3097c65247 21 #include "blecommon.h"
ktownsend 0:4c3097c65247 22 #include "GapAdvertisingData.h"
ktownsend 0:4c3097c65247 23 #include "GapAdvertisingParams.h"
ktownsend 0:4c3097c65247 24 #include "GapEvents.h"
ktownsend 0:4c3097c65247 25
ktownsend 0:4c3097c65247 26 /**************************************************************************/
ktownsend 0:4c3097c65247 27 /*!
ktownsend 0:4c3097c65247 28 \brief
ktownsend 0:4c3097c65247 29 The base class used to abstract GAP functionality to a specific radio
ktownsend 0:4c3097c65247 30 transceiver, SOC or BLE Stack.
ktownsend 0:4c3097c65247 31 */
ktownsend 0:4c3097c65247 32 /**************************************************************************/
ktownsend 0:4c3097c65247 33 class Gap
ktownsend 0:4c3097c65247 34 {
ktownsend 0:4c3097c65247 35 private:
ktownsend 0:4c3097c65247 36 GapEvents *m_pEventHandler;
ktownsend 0:4c3097c65247 37
ktownsend 0:4c3097c65247 38 public:
ktownsend 0:4c3097c65247 39 /* These functions must be defined in the sub-class */
ktownsend 0:4c3097c65247 40 virtual ble_error_t setAdvertisingData(GapAdvertisingData &, GapAdvertisingData &) = 0;
ktownsend 0:4c3097c65247 41 virtual ble_error_t startAdvertising(GapAdvertisingParams &) = 0;
ktownsend 0:4c3097c65247 42 virtual ble_error_t stopAdvertising(void) = 0;
ktownsend 0:4c3097c65247 43 virtual ble_error_t disconnect(void) = 0;
ktownsend 0:4c3097c65247 44
ktownsend 0:4c3097c65247 45 /* Describes the current state of the device (more than one bit can be set) */
ktownsend 0:4c3097c65247 46 typedef struct GapState_s
ktownsend 0:4c3097c65247 47 {
ktownsend 0:4c3097c65247 48 unsigned advertising : 1; /**< The device is current advertising */
ktownsend 0:4c3097c65247 49 unsigned connected : 1; /**< The peripheral is connected to a central device */
ktownsend 0:4c3097c65247 50 } GapState_t;
ktownsend 0:4c3097c65247 51
ktownsend 0:4c3097c65247 52 /* Event callback handlers */
ktownsend 0:4c3097c65247 53 void setEventHandler(GapEvents *pEventHandler) {m_pEventHandler = pEventHandler;}
ktownsend 15:a854d49b3d25 54 void handleEvent(GapEvents::gapEvent_e type) {
ktownsend 0:4c3097c65247 55 if (NULL == m_pEventHandler)
ktownsend 0:4c3097c65247 56 return;
ktownsend 0:4c3097c65247 57 switch(type) {
ktownsend 0:4c3097c65247 58 case GapEvents::GAP_EVENT_TIMEOUT:
ktownsend 0:4c3097c65247 59 state.advertising = 0;
ktownsend 0:4c3097c65247 60 m_pEventHandler->onTimeout();
ktownsend 0:4c3097c65247 61 break;
ktownsend 0:4c3097c65247 62 case GapEvents::GAP_EVENT_CONNECTED:
ktownsend 0:4c3097c65247 63 state.connected = 1;
ktownsend 0:4c3097c65247 64 m_pEventHandler->onConnected();
ktownsend 0:4c3097c65247 65 break;
ktownsend 0:4c3097c65247 66 case GapEvents::GAP_EVENT_DISCONNECTED:
ktownsend 0:4c3097c65247 67 state.connected = 0;
ktownsend 0:4c3097c65247 68 m_pEventHandler->onDisconnected();
ktownsend 0:4c3097c65247 69 break;
ktownsend 0:4c3097c65247 70 }
ktownsend 0:4c3097c65247 71 }
ktownsend 0:4c3097c65247 72
ktownsend 0:4c3097c65247 73 GapState_t state;
ktownsend 0:4c3097c65247 74 };
ktownsend 0:4c3097c65247 75
ktownsend 0:4c3097c65247 76 #endif