Productize / nRF51822

library for BLE_GAP_backpack

Dependencies:   nrf51-sdk

Fork of nRF51822 by Nordic Semiconductor

source/nRF5xn.cpp@587:596071444447, 2016-01-11 (annotated)

Committer:
vcoubard
Date:
Mon Jan 11 10:19:29 2016 +0000
Revision:
587:596071444447
Parent:
586:533fd7fdb0fe
Child:
588:65d256258533
Synchronized with git rev 65cb294f

Author: Andres Amaya Garcia

Fix comment typo

Who changed what in which revision?

UserRevisionLine numberNew contents of line
vcoubard 541:884f95bf5351 1 /* mbed Microcontroller Library
vcoubard 541:884f95bf5351 2 * Copyright (c) 2006-2013 ARM Limited
vcoubard 541:884f95bf5351 3 *
vcoubard 541:884f95bf5351 4 * Licensed under the Apache License, Version 2.0 (the "License");
vcoubard 541:884f95bf5351 5 * you may not use this file except in compliance with the License.
vcoubard 541:884f95bf5351 6 * You may obtain a copy of the License at
vcoubard 541:884f95bf5351 7 *
vcoubard 541:884f95bf5351 8 * http://www.apache.org/licenses/LICENSE-2.0
vcoubard 541:884f95bf5351 9 *
vcoubard 541:884f95bf5351 10 * Unless required by applicable law or agreed to in writing, software
vcoubard 541:884f95bf5351 11 * distributed under the License is distributed on an "AS IS" BASIS,
vcoubard 541:884f95bf5351 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
vcoubard 541:884f95bf5351 13 * See the License for the specific language governing permissions and
vcoubard 541:884f95bf5351 14 * limitations under the License.
vcoubard 541:884f95bf5351 15 */
vcoubard 541:884f95bf5351 16
vcoubard 578:78f69f1be114 17 #ifdef YOTTA_CFG_MBED_OS
vcoubard 578:78f69f1be114 18 #include "mbed-drivers/mbed.h"
vcoubard 578:78f69f1be114 19 #else
vcoubard 578:78f69f1be114 20 #include "mbed.h"
vcoubard 578:78f69f1be114 21 #endif
vcoubard 541:884f95bf5351 22 #include "nRF5xn.h"
vcoubard 541:884f95bf5351 23 #include "ble/blecommon.h"
vcoubard 541:884f95bf5351 24 #include "nrf_soc.h"
vcoubard 541:884f95bf5351 25
vcoubard 541:884f95bf5351 26 #include "btle/btle.h"
vcoubard 541:884f95bf5351 27 #include "nrf_delay.h"
vcoubard 541:884f95bf5351 28
vcoubard 549:3f782c64d014 29 extern "C" {
vcoubard 541:884f95bf5351 30 #include "softdevice_handler.h"
vcoubard 549:3f782c64d014 31 }
vcoubard 541:884f95bf5351 32
vcoubard 541:884f95bf5351 33 /**
vcoubard 541:884f95bf5351 34 * The singleton which represents the nRF51822 transport for the BLE.
vcoubard 541:884f95bf5351 35 */
vcoubard 541:884f95bf5351 36 static nRF5xn deviceInstance;
vcoubard 541:884f95bf5351 37
vcoubard 541:884f95bf5351 38 /**
vcoubard 541:884f95bf5351 39 * BLE-API requires an implementation of the following function in order to
vcoubard 541:884f95bf5351 40 * obtain its transport handle.
vcoubard 541:884f95bf5351 41 */
vcoubard 541:884f95bf5351 42 BLEInstanceBase *
vcoubard 541:884f95bf5351 43 createBLEInstance(void)
vcoubard 541:884f95bf5351 44 {
vcoubard 575:7023a8204a1b 45 return &nRF5xn::Instance(BLE::DEFAULT_INSTANCE);
vcoubard 575:7023a8204a1b 46 }
vcoubard 575:7023a8204a1b 47
vcoubard 575:7023a8204a1b 48 nRF5xn& nRF5xn::Instance(BLE::InstanceID_t instanceId)
vcoubard 575:7023a8204a1b 49 {
vcoubard 575:7023a8204a1b 50 return deviceInstance;
vcoubard 541:884f95bf5351 51 }
vcoubard 541:884f95bf5351 52
vcoubard 575:7023a8204a1b 53 nRF5xn::nRF5xn(void) :
vcoubard 575:7023a8204a1b 54 initialized(false),
vcoubard 575:7023a8204a1b 55 instanceID(BLE::DEFAULT_INSTANCE),
vcoubard 575:7023a8204a1b 56 _gapInstance(),
vcoubard 575:7023a8204a1b 57 gapInstance(NULL),
vcoubard 575:7023a8204a1b 58 gattServerInstance(NULL),
vcoubard 575:7023a8204a1b 59 gattClientInstance(NULL),
vcoubard 575:7023a8204a1b 60 securityManagerInstance(NULL)
vcoubard 541:884f95bf5351 61 {
vcoubard 541:884f95bf5351 62 }
vcoubard 541:884f95bf5351 63
vcoubard 541:884f95bf5351 64 nRF5xn::~nRF5xn(void)
vcoubard 541:884f95bf5351 65 {
vcoubard 541:884f95bf5351 66 }
vcoubard 541:884f95bf5351 67
vcoubard 541:884f95bf5351 68 const char *nRF5xn::getVersion(void)
vcoubard 541:884f95bf5351 69 {
vcoubard 541:884f95bf5351 70 if (!initialized) {
vcoubard 541:884f95bf5351 71 return "INITIALIZATION_INCOMPLETE";
vcoubard 541:884f95bf5351 72 }
vcoubard 541:884f95bf5351 73
vcoubard 541:884f95bf5351 74 static char versionString[32];
vcoubard 541:884f95bf5351 75 static bool versionFetched = false;
vcoubard 541:884f95bf5351 76
vcoubard 541:884f95bf5351 77 if (!versionFetched) {
vcoubard 541:884f95bf5351 78 ble_version_t version;
vcoubard 541:884f95bf5351 79 if ((sd_ble_version_get(&version) == NRF_SUCCESS) && (version.company_id == 0x0059)) {
vcoubard 541:884f95bf5351 80 switch (version.version_number) {
vcoubard 541:884f95bf5351 81 case 0x07:
vcoubard 541:884f95bf5351 82 case 0x08:
vcoubard 541:884f95bf5351 83 snprintf(versionString, sizeof(versionString), "Nordic BLE4.1 ver:%u fw:%04x", version.version_number, version.subversion_number);
vcoubard 541:884f95bf5351 84 break;
vcoubard 541:884f95bf5351 85 default:
vcoubard 541:884f95bf5351 86 snprintf(versionString, sizeof(versionString), "Nordic (spec unknown) ver:%u fw:%04x", version.version_number, version.subversion_number);
vcoubard 541:884f95bf5351 87 break;
vcoubard 541:884f95bf5351 88 }
vcoubard 541:884f95bf5351 89 versionFetched = true;
vcoubard 541:884f95bf5351 90 } else {
vcoubard 541:884f95bf5351 91 strncpy(versionString, "unknown", sizeof(versionString));
vcoubard 541:884f95bf5351 92 }
vcoubard 541:884f95bf5351 93 }
vcoubard 541:884f95bf5351 94
vcoubard 541:884f95bf5351 95 return versionString;
vcoubard 541:884f95bf5351 96 }
vcoubard 541:884f95bf5351 97
vcoubard 586:533fd7fdb0fe 98 /**************************************************************************/
vcoubard 586:533fd7fdb0fe 99 /*!
vcoubard 586:533fd7fdb0fe 100 @brief Initialize the BLE stack.
vcoubard 586:533fd7fdb0fe 101
vcoubard 586:533fd7fdb0fe 102 @returns ble_error_t
vcoubard 586:533fd7fdb0fe 103
vcoubard 586:533fd7fdb0fe 104 @retval BLE_ERROR_NONE if everything executed properly and
vcoubard 586:533fd7fdb0fe 105 BLE_ERROR_ALREADY_INITIALIZED if the stack has already
vcoubard 587:596071444447 106 been initialized (possibly through a call to nRF5xn::init()).
vcoubard 586:533fd7fdb0fe 107 BLE_ERROR_INTERNAL_STACK_FAILURE is returned if initialization
vcoubard 586:533fd7fdb0fe 108 of the internal stack (SoftDevice) failed.
vcoubard 586:533fd7fdb0fe 109
vcoubard 586:533fd7fdb0fe 110 */
vcoubard 586:533fd7fdb0fe 111 /**************************************************************************/
vcoubard 541:884f95bf5351 112 ble_error_t nRF5xn::init(BLE::InstanceID_t instanceID, FunctionPointerWithContext<BLE::InitializationCompleteCallbackContext *> callback)
vcoubard 541:884f95bf5351 113 {
vcoubard 541:884f95bf5351 114 if (initialized) {
vcoubard 541:884f95bf5351 115 BLE::InitializationCompleteCallbackContext context = {
vcoubard 541:884f95bf5351 116 BLE::Instance(instanceID),
vcoubard 541:884f95bf5351 117 BLE_ERROR_ALREADY_INITIALIZED
vcoubard 541:884f95bf5351 118 };
vcoubard 541:884f95bf5351 119 callback.call(&context);
vcoubard 541:884f95bf5351 120 return BLE_ERROR_ALREADY_INITIALIZED;
vcoubard 541:884f95bf5351 121 }
vcoubard 541:884f95bf5351 122
vcoubard 541:884f95bf5351 123 instanceID = instanceID;
vcoubard 541:884f95bf5351 124
vcoubard 541:884f95bf5351 125 /* ToDo: Clear memory contents, reset the SD, etc. */
vcoubard 586:533fd7fdb0fe 126 if (btle_init() != ERROR_NONE) {
vcoubard 586:533fd7fdb0fe 127 return BLE_ERROR_INTERNAL_STACK_FAILURE;
vcoubard 586:533fd7fdb0fe 128 }
vcoubard 541:884f95bf5351 129
vcoubard 541:884f95bf5351 130 initialized = true;
vcoubard 541:884f95bf5351 131 BLE::InitializationCompleteCallbackContext context = {
vcoubard 541:884f95bf5351 132 BLE::Instance(instanceID),
vcoubard 541:884f95bf5351 133 BLE_ERROR_NONE
vcoubard 541:884f95bf5351 134 };
vcoubard 541:884f95bf5351 135 callback.call(&context);
vcoubard 541:884f95bf5351 136 return BLE_ERROR_NONE;
vcoubard 541:884f95bf5351 137 }
vcoubard 541:884f95bf5351 138
vcoubard 575:7023a8204a1b 139 /**************************************************************************/
vcoubard 575:7023a8204a1b 140 /*!
vcoubard 575:7023a8204a1b 141 @brief Purge the BLE stack of GATT and GAP state.
vcoubard 575:7023a8204a1b 142
vcoubard 575:7023a8204a1b 143 @returns ble_error_t
vcoubard 575:7023a8204a1b 144
vcoubard 575:7023a8204a1b 145 @retval BLE_ERROR_NONE
vcoubard 575:7023a8204a1b 146 Everything executed properly
vcoubard 575:7023a8204a1b 147
vcoubard 575:7023a8204a1b 148 @note When using S110, GattClient::shutdown() will not be called
vcoubard 575:7023a8204a1b 149 since Gatt client features are not supported.
vcoubard 575:7023a8204a1b 150 */
vcoubard 575:7023a8204a1b 151 /**************************************************************************/
vcoubard 541:884f95bf5351 152 ble_error_t nRF5xn::shutdown(void)
vcoubard 541:884f95bf5351 153 {
vcoubard 541:884f95bf5351 154 if (!initialized) {
vcoubard 541:884f95bf5351 155 return BLE_ERROR_INITIALIZATION_INCOMPLETE;
vcoubard 541:884f95bf5351 156 }
vcoubard 541:884f95bf5351 157
vcoubard 575:7023a8204a1b 158 /*
vcoubard 575:7023a8204a1b 159 * Shutdown the SoftDevice first. This is because we need to disable all
vcoubard 575:7023a8204a1b 160 * interrupts. Otherwise if we clear the BLE API and glue code first there
vcoubard 575:7023a8204a1b 161 * will be many NULL references and no config information which could lead
vcoubard 575:7023a8204a1b 162 * to errors if the shutdown process is interrupted.
vcoubard 575:7023a8204a1b 163 */
vcoubard 582:37fd3190598e 164 if (softdevice_handler_sd_disable() != NRF_SUCCESS) {
vcoubard 541:884f95bf5351 165 return BLE_STACK_BUSY;
vcoubard 541:884f95bf5351 166 }
vcoubard 541:884f95bf5351 167
vcoubard 575:7023a8204a1b 168
vcoubard 575:7023a8204a1b 169 /* Shutdown the BLE API and nRF51 glue code */
vcoubard 575:7023a8204a1b 170 ble_error_t error;
vcoubard 575:7023a8204a1b 171
vcoubard 575:7023a8204a1b 172 if (gattServerInstance != NULL) {
vcoubard 575:7023a8204a1b 173 error = gattServerInstance->reset();
vcoubard 575:7023a8204a1b 174 if (error != BLE_ERROR_NONE) {
vcoubard 575:7023a8204a1b 175 return error;
vcoubard 575:7023a8204a1b 176 }
vcoubard 575:7023a8204a1b 177 }
vcoubard 575:7023a8204a1b 178
vcoubard 575:7023a8204a1b 179 if (securityManagerInstance != NULL) {
vcoubard 575:7023a8204a1b 180 error = securityManagerInstance->reset();
vcoubard 575:7023a8204a1b 181 if (error != BLE_ERROR_NONE) {
vcoubard 575:7023a8204a1b 182 return error;
vcoubard 575:7023a8204a1b 183 }
vcoubard 575:7023a8204a1b 184 }
vcoubard 575:7023a8204a1b 185
vcoubard 575:7023a8204a1b 186 /* S110 does not support BLE client features, nothing to reset. */
vcoubard 575:7023a8204a1b 187 #if !defined(TARGET_MCU_NRF51_16K_S110) && !defined(TARGET_MCU_NRF51_32K_S110)
vcoubard 575:7023a8204a1b 188 if (gattClientInstance != NULL) {
vcoubard 575:7023a8204a1b 189 error = gattClientInstance->reset();
vcoubard 575:7023a8204a1b 190 if (error != BLE_ERROR_NONE) {
vcoubard 575:7023a8204a1b 191 return error;
vcoubard 575:7023a8204a1b 192 }
vcoubard 575:7023a8204a1b 193 }
vcoubard 575:7023a8204a1b 194 #endif
vcoubard 575:7023a8204a1b 195
vcoubard 575:7023a8204a1b 196 /* Gap instance is always present */
vcoubard 575:7023a8204a1b 197 error = gapInstance->reset();
vcoubard 575:7023a8204a1b 198 if (error != BLE_ERROR_NONE) {
vcoubard 575:7023a8204a1b 199 return error;
vcoubard 575:7023a8204a1b 200 }
vcoubard 575:7023a8204a1b 201
vcoubard 541:884f95bf5351 202 initialized = false;
vcoubard 541:884f95bf5351 203 return BLE_ERROR_NONE;
vcoubard 541:884f95bf5351 204 }
vcoubard 541:884f95bf5351 205
vcoubard 541:884f95bf5351 206 void
vcoubard 541:884f95bf5351 207 nRF5xn::waitForEvent(void)
vcoubard 541:884f95bf5351 208 {
vcoubard 541:884f95bf5351 209 sd_app_evt_wait();
rgrover1 388:db85a09c27ef 210 }