ON Semiconductor / mbed-os

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Dependents:   mbed-TFT-example-NCS36510 mbed-Accelerometer-example-NCS36510 mbed-Accelerometer-example-NCS36510

features/FEATURE_BLE/source/BLE.cpp@1:f30bdcd2b33b, 2017-02-27 (annotated)

Committer:
jacobjohnson
Date:
Mon Feb 27 17:45:05 2017 +0000
Revision:
1:f30bdcd2b33b
Parent:
0:098463de4c5d 
changed the inputscale from 1 to 7 in analogin_api.c.  This will need to be changed later, and accessed from the main level, but for now this allows the  adc to read a value from 0 to 3.7V, instead of just up to 1V.;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
group-onsemi 0:098463de4c5d 1 /* mbed Microcontroller Library
group-onsemi 0:098463de4c5d 2 * Copyright (c) 2006-2013 ARM Limited
group-onsemi 0:098463de4c5d 3 *
group-onsemi 0:098463de4c5d 4 * Licensed under the Apache License, Version 2.0 (the "License");
group-onsemi 0:098463de4c5d 5 * you may not use this file except in compliance with the License.
group-onsemi 0:098463de4c5d 6 * You may obtain a copy of the License at
group-onsemi 0:098463de4c5d 7 *
group-onsemi 0:098463de4c5d 8 * http://www.apache.org/licenses/LICENSE-2.0
group-onsemi 0:098463de4c5d 9 *
group-onsemi 0:098463de4c5d 10 * Unless required by applicable law or agreed to in writing, software
group-onsemi 0:098463de4c5d 11 * distributed under the License is distributed on an "AS IS" BASIS,
group-onsemi 0:098463de4c5d 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
group-onsemi 0:098463de4c5d 13 * See the License for the specific language governing permissions and
group-onsemi 0:098463de4c5d 14 * limitations under the License.
group-onsemi 0:098463de4c5d 15 */
group-onsemi 0:098463de4c5d 16
group-onsemi 0:098463de4c5d 17 #include "ble/BLE.h"
group-onsemi 0:098463de4c5d 18 #include "ble/BLEInstanceBase.h"
group-onsemi 0:098463de4c5d 19
group-onsemi 0:098463de4c5d 20 #if defined(TARGET_OTA_ENABLED)
group-onsemi 0:098463de4c5d 21 #include "ble/services/DFUService.h"
group-onsemi 0:098463de4c5d 22 #endif
group-onsemi 0:098463de4c5d 23
group-onsemi 0:098463de4c5d 24 #ifdef YOTTA_CFG_MBED_OS
group-onsemi 0:098463de4c5d 25 #include <minar/minar.h>
group-onsemi 0:098463de4c5d 26 #endif
group-onsemi 0:098463de4c5d 27
group-onsemi 0:098463de4c5d 28 #if !defined(YOTTA_CFG_MBED_OS)
group-onsemi 0:098463de4c5d 29 #include <mbed_error.h>
group-onsemi 0:098463de4c5d 30 #include <toolchain.h>
group-onsemi 0:098463de4c5d 31 #endif
group-onsemi 0:098463de4c5d 32
group-onsemi 0:098463de4c5d 33 ble_error_t
group-onsemi 0:098463de4c5d 34 BLE::initImplementation(FunctionPointerWithContext<InitializationCompleteCallbackContext*> callback)
group-onsemi 0:098463de4c5d 35 {
group-onsemi 0:098463de4c5d 36 ble_error_t err = transport->init(instanceID, callback);
group-onsemi 0:098463de4c5d 37 if (err != BLE_ERROR_NONE) {
group-onsemi 0:098463de4c5d 38 return err;
group-onsemi 0:098463de4c5d 39 }
group-onsemi 0:098463de4c5d 40
group-onsemi 0:098463de4c5d 41 /* Platforms enabled for DFU should introduce the DFU Service into
group-onsemi 0:098463de4c5d 42 * applications automatically. */
group-onsemi 0:098463de4c5d 43 #if defined(TARGET_OTA_ENABLED)
group-onsemi 0:098463de4c5d 44 static DFUService dfu(*this); // defined static so that the object remains alive
group-onsemi 0:098463de4c5d 45 #endif // TARGET_OTA_ENABLED
group-onsemi 0:098463de4c5d 46
group-onsemi 0:098463de4c5d 47 return BLE_ERROR_NONE;
group-onsemi 0:098463de4c5d 48 }
group-onsemi 0:098463de4c5d 49
group-onsemi 0:098463de4c5d 50 /**
group-onsemi 0:098463de4c5d 51 * BLE::Instance() and BLE constructor rely upon a static array of initializers
group-onsemi 0:098463de4c5d 52 * to create actual BLE transport instances. A description of these instances
group-onsemi 0:098463de4c5d 53 * and initializers is supposed to be put in some .json file contributing to
group-onsemi 0:098463de4c5d 54 * yotta's configuration (typically in the target definition described by
group-onsemi 0:098463de4c5d 55 * target.json). Here's a sample:
group-onsemi 0:098463de4c5d 56 *
group-onsemi 0:098463de4c5d 57 * "config": {
group-onsemi 0:098463de4c5d 58 * ...
group-onsemi 0:098463de4c5d 59 * "ble_instances": {
group-onsemi 0:098463de4c5d 60 * "count": 1,
group-onsemi 0:098463de4c5d 61 * "0" : {
group-onsemi 0:098463de4c5d 62 * "initializer" : "createBLEInstance"
group-onsemi 0:098463de4c5d 63 * }
group-onsemi 0:098463de4c5d 64 * }
group-onsemi 0:098463de4c5d 65 * ...
group-onsemi 0:098463de4c5d 66 * }
group-onsemi 0:098463de4c5d 67 *
group-onsemi 0:098463de4c5d 68 * The following macros result in translating the above config into a static
group-onsemi 0:098463de4c5d 69 * array: instanceConstructors.
group-onsemi 0:098463de4c5d 70 */
group-onsemi 0:098463de4c5d 71 #ifdef YOTTA_CFG_BLE_INSTANCES_COUNT
group-onsemi 0:098463de4c5d 72 #define CONCATENATE(A, B) A ## B
group-onsemi 0:098463de4c5d 73 #define EXPAND(X) X /* this adds a level of indirection needed to allow macro-expansion following a token-paste operation (see use of CONCATENATE() below). */
group-onsemi 0:098463de4c5d 74
group-onsemi 0:098463de4c5d 75 #define INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_1 YOTTA_CFG_BLE_INSTANCES_0_INITIALIZER
group-onsemi 0:098463de4c5d 76 #define INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_2 INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_1, YOTTA_CFG_BLE_INSTANCES_1_INITIALIZER
group-onsemi 0:098463de4c5d 77 #define INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_3 INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_2, YOTTA_CFG_BLE_INSTANCES_2_INITIALIZER
group-onsemi 0:098463de4c5d 78 #define INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_4 INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_3, YOTTA_CFG_BLE_INSTANCES_3_INITIALIZER
group-onsemi 0:098463de4c5d 79 #define INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_5 INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_4, YOTTA_CFG_BLE_INSTANCES_4_INITIALIZER
group-onsemi 0:098463de4c5d 80 /* ... add more of the above if ever needed */
group-onsemi 0:098463de4c5d 81
group-onsemi 0:098463de4c5d 82 #define INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS(N) EXPAND(CONCATENATE(INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS_, N))
group-onsemi 0:098463de4c5d 83 #elif !defined(INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS)
group-onsemi 0:098463de4c5d 84 /*
group-onsemi 0:098463de4c5d 85 * The following applies when building without yotta. By default BLE_API provides
group-onsemi 0:098463de4c5d 86 * a trivial initializer list containing a single constructor: createBLEInstance.
group-onsemi 0:098463de4c5d 87 * This may be overridden.
group-onsemi 0:098463de4c5d 88 */
group-onsemi 0:098463de4c5d 89 #define INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS createBLEInstance
group-onsemi 0:098463de4c5d 90
group-onsemi 0:098463de4c5d 91 // yotta unlike mbed-cli has proper dependency mechanisms
group-onsemi 0:098463de4c5d 92 // It is not required to defined a stub for createBLEInstance
group-onsemi 0:098463de4c5d 93 #if !defined(YOTTA_CFG_MBED_OS)
group-onsemi 0:098463de4c5d 94
group-onsemi 0:098463de4c5d 95 // this stub is required by ARMCC otherwise link will systematically fail
group-onsemi 0:098463de4c5d 96 MBED_WEAK BLEInstanceBase* createBLEInstance() {
group-onsemi 0:098463de4c5d 97 error("Please provide an implementation for mbed BLE");
group-onsemi 0:098463de4c5d 98 return NULL;
group-onsemi 0:098463de4c5d 99 }
group-onsemi 0:098463de4c5d 100
group-onsemi 0:098463de4c5d 101 #endif
group-onsemi 0:098463de4c5d 102
group-onsemi 0:098463de4c5d 103
group-onsemi 0:098463de4c5d 104 #endif /* YOTTA_CFG_BLE_INSTANCES_COUNT */
group-onsemi 0:098463de4c5d 105
group-onsemi 0:098463de4c5d 106 typedef BLEInstanceBase *(*InstanceConstructor_t)(void);
group-onsemi 0:098463de4c5d 107 static const InstanceConstructor_t instanceConstructors[BLE::NUM_INSTANCES] = {
group-onsemi 0:098463de4c5d 108 #ifndef YOTTA_CFG_BLE_INSTANCES_COUNT
group-onsemi 0:098463de4c5d 109 INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS
group-onsemi 0:098463de4c5d 110 #else
group-onsemi 0:098463de4c5d 111 INITIALIZER_LIST_FOR_INSTANCE_CONSTRUCTORS(YOTTA_CFG_BLE_INSTANCES_COUNT)
group-onsemi 0:098463de4c5d 112 #endif
group-onsemi 0:098463de4c5d 113 };
group-onsemi 0:098463de4c5d 114
group-onsemi 0:098463de4c5d 115 BLE &
group-onsemi 0:098463de4c5d 116 BLE::Instance(InstanceID_t id)
group-onsemi 0:098463de4c5d 117 {
group-onsemi 0:098463de4c5d 118 static BLE *singletons[NUM_INSTANCES];
group-onsemi 0:098463de4c5d 119 if (id < NUM_INSTANCES) {
group-onsemi 0:098463de4c5d 120 if (singletons[id] == NULL) {
group-onsemi 0:098463de4c5d 121 singletons[id] = new BLE(id); /* This object will never be freed. */
group-onsemi 0:098463de4c5d 122 }
group-onsemi 0:098463de4c5d 123
group-onsemi 0:098463de4c5d 124 return *singletons[id];
group-onsemi 0:098463de4c5d 125 }
group-onsemi 0:098463de4c5d 126
group-onsemi 0:098463de4c5d 127 /* we come here only in the case of a bad interfaceID. */
group-onsemi 0:098463de4c5d 128 static BLE badSingleton(NUM_INSTANCES /* this is a bad index; and will result in a NULL transport. */);
group-onsemi 0:098463de4c5d 129 return badSingleton;
group-onsemi 0:098463de4c5d 130 }
group-onsemi 0:098463de4c5d 131
group-onsemi 0:098463de4c5d 132 #ifdef YOTTA_CFG_MBED_OS
group-onsemi 0:098463de4c5d 133 void defaultSchedulingCallback(BLE::OnEventsToProcessCallbackContext* params) {
group-onsemi 0:098463de4c5d 134 minar::Scheduler::postCallback(&params->ble, &BLE::processEvents);
group-onsemi 0:098463de4c5d 135 }
group-onsemi 0:098463de4c5d 136 #else
group-onsemi 0:098463de4c5d 137 #define defaultSchedulingCallback NULL
group-onsemi 0:098463de4c5d 138 #endif
group-onsemi 0:098463de4c5d 139
group-onsemi 0:098463de4c5d 140
group-onsemi 0:098463de4c5d 141 BLE::BLE(InstanceID_t instanceIDIn) : instanceID(instanceIDIn), transport(),
group-onsemi 0:098463de4c5d 142 whenEventsToProcess(defaultSchedulingCallback)
group-onsemi 0:098463de4c5d 143 {
group-onsemi 0:098463de4c5d 144 static BLEInstanceBase *transportInstances[NUM_INSTANCES];
group-onsemi 0:098463de4c5d 145
group-onsemi 0:098463de4c5d 146 if (instanceID < NUM_INSTANCES) {
group-onsemi 0:098463de4c5d 147 if (!transportInstances[instanceID]) {
group-onsemi 0:098463de4c5d 148 transportInstances[instanceID] = instanceConstructors[instanceID](); /* Call the stack's initializer for the transport object. */
group-onsemi 0:098463de4c5d 149 }
group-onsemi 0:098463de4c5d 150 transport = transportInstances[instanceID];
group-onsemi 0:098463de4c5d 151 } else {
group-onsemi 0:098463de4c5d 152 transport = NULL;
group-onsemi 0:098463de4c5d 153 }
group-onsemi 0:098463de4c5d 154 }
group-onsemi 0:098463de4c5d 155
group-onsemi 0:098463de4c5d 156 bool BLE::hasInitialized(void) const
group-onsemi 0:098463de4c5d 157 {
group-onsemi 0:098463de4c5d 158 if (!transport) {
group-onsemi 0:098463de4c5d 159 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 160 }
group-onsemi 0:098463de4c5d 161
group-onsemi 0:098463de4c5d 162 return transport->hasInitialized();
group-onsemi 0:098463de4c5d 163 }
group-onsemi 0:098463de4c5d 164
group-onsemi 0:098463de4c5d 165 ble_error_t BLE::shutdown(void)
group-onsemi 0:098463de4c5d 166 {
group-onsemi 0:098463de4c5d 167 if (!transport) {
group-onsemi 0:098463de4c5d 168 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 169 }
group-onsemi 0:098463de4c5d 170
group-onsemi 0:098463de4c5d 171 return transport->shutdown();
group-onsemi 0:098463de4c5d 172 }
group-onsemi 0:098463de4c5d 173
group-onsemi 0:098463de4c5d 174 const char *BLE::getVersion(void)
group-onsemi 0:098463de4c5d 175 {
group-onsemi 0:098463de4c5d 176 if (!transport) {
group-onsemi 0:098463de4c5d 177 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 178 }
group-onsemi 0:098463de4c5d 179
group-onsemi 0:098463de4c5d 180 return transport->getVersion();
group-onsemi 0:098463de4c5d 181 }
group-onsemi 0:098463de4c5d 182
group-onsemi 0:098463de4c5d 183 const Gap &BLE::gap() const
group-onsemi 0:098463de4c5d 184 {
group-onsemi 0:098463de4c5d 185 if (!transport) {
group-onsemi 0:098463de4c5d 186 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 187 }
group-onsemi 0:098463de4c5d 188
group-onsemi 0:098463de4c5d 189 return transport->getGap();
group-onsemi 0:098463de4c5d 190 }
group-onsemi 0:098463de4c5d 191
group-onsemi 0:098463de4c5d 192 Gap &BLE::gap()
group-onsemi 0:098463de4c5d 193 {
group-onsemi 0:098463de4c5d 194 if (!transport) {
group-onsemi 0:098463de4c5d 195 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 196 }
group-onsemi 0:098463de4c5d 197
group-onsemi 0:098463de4c5d 198 return transport->getGap();
group-onsemi 0:098463de4c5d 199 }
group-onsemi 0:098463de4c5d 200
group-onsemi 0:098463de4c5d 201 const GattServer& BLE::gattServer() const
group-onsemi 0:098463de4c5d 202 {
group-onsemi 0:098463de4c5d 203 if (!transport) {
group-onsemi 0:098463de4c5d 204 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 205 }
group-onsemi 0:098463de4c5d 206
group-onsemi 0:098463de4c5d 207 return transport->getGattServer();
group-onsemi 0:098463de4c5d 208 }
group-onsemi 0:098463de4c5d 209
group-onsemi 0:098463de4c5d 210 GattServer& BLE::gattServer()
group-onsemi 0:098463de4c5d 211 {
group-onsemi 0:098463de4c5d 212 if (!transport) {
group-onsemi 0:098463de4c5d 213 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 214 }
group-onsemi 0:098463de4c5d 215
group-onsemi 0:098463de4c5d 216 return transport->getGattServer();
group-onsemi 0:098463de4c5d 217 }
group-onsemi 0:098463de4c5d 218
group-onsemi 0:098463de4c5d 219 const GattClient& BLE::gattClient() const
group-onsemi 0:098463de4c5d 220 {
group-onsemi 0:098463de4c5d 221 if (!transport) {
group-onsemi 0:098463de4c5d 222 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 223 }
group-onsemi 0:098463de4c5d 224
group-onsemi 0:098463de4c5d 225 return transport->getGattClient();
group-onsemi 0:098463de4c5d 226 }
group-onsemi 0:098463de4c5d 227
group-onsemi 0:098463de4c5d 228 GattClient& BLE::gattClient()
group-onsemi 0:098463de4c5d 229 {
group-onsemi 0:098463de4c5d 230 if (!transport) {
group-onsemi 0:098463de4c5d 231 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 232 }
group-onsemi 0:098463de4c5d 233
group-onsemi 0:098463de4c5d 234 return transport->getGattClient();
group-onsemi 0:098463de4c5d 235 }
group-onsemi 0:098463de4c5d 236
group-onsemi 0:098463de4c5d 237 const SecurityManager& BLE::securityManager() const
group-onsemi 0:098463de4c5d 238 {
group-onsemi 0:098463de4c5d 239 if (!transport) {
group-onsemi 0:098463de4c5d 240 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 241 }
group-onsemi 0:098463de4c5d 242
group-onsemi 0:098463de4c5d 243 return transport->getSecurityManager();
group-onsemi 0:098463de4c5d 244 }
group-onsemi 0:098463de4c5d 245
group-onsemi 0:098463de4c5d 246 SecurityManager& BLE::securityManager()
group-onsemi 0:098463de4c5d 247 {
group-onsemi 0:098463de4c5d 248 if (!transport) {
group-onsemi 0:098463de4c5d 249 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 250 }
group-onsemi 0:098463de4c5d 251
group-onsemi 0:098463de4c5d 252 return transport->getSecurityManager();
group-onsemi 0:098463de4c5d 253 }
group-onsemi 0:098463de4c5d 254
group-onsemi 0:098463de4c5d 255 void BLE::waitForEvent(void)
group-onsemi 0:098463de4c5d 256 {
group-onsemi 0:098463de4c5d 257 if (!transport) {
group-onsemi 0:098463de4c5d 258 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 259 }
group-onsemi 0:098463de4c5d 260
group-onsemi 0:098463de4c5d 261 transport->waitForEvent();
group-onsemi 0:098463de4c5d 262 }
group-onsemi 0:098463de4c5d 263
group-onsemi 0:098463de4c5d 264 void BLE::processEvents()
group-onsemi 0:098463de4c5d 265 {
group-onsemi 0:098463de4c5d 266 if (!transport) {
group-onsemi 0:098463de4c5d 267 error("bad handle to underlying transport");
group-onsemi 0:098463de4c5d 268 }
group-onsemi 0:098463de4c5d 269
group-onsemi 0:098463de4c5d 270 transport->processEvents();
group-onsemi 0:098463de4c5d 271 }
group-onsemi 0:098463de4c5d 272
group-onsemi 0:098463de4c5d 273 void BLE::onEventsToProcess(const BLE::OnEventsToProcessCallback_t& callback)
group-onsemi 0:098463de4c5d 274 {
group-onsemi 0:098463de4c5d 275 whenEventsToProcess = callback;
group-onsemi 0:098463de4c5d 276 }
group-onsemi 0:098463de4c5d 277
group-onsemi 0:098463de4c5d 278 void BLE::signalEventsToProcess()
group-onsemi 0:098463de4c5d 279 {
group-onsemi 0:098463de4c5d 280 if (whenEventsToProcess) {
group-onsemi 0:098463de4c5d 281 OnEventsToProcessCallbackContext params = {
group-onsemi 0:098463de4c5d 282 *this
group-onsemi 0:098463de4c5d 283 };
group-onsemi 0:098463de4c5d 284 whenEventsToProcess(&params);
group-onsemi 0:098463de4c5d 285 }
group-onsemi 0:098463de4c5d 286 }