ST / X_NUCLEO_IDB0XA1

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

Dependents:   Nucleo_Zumo_BLE_IDB04A1 contest_IOT5 contest_IOT6 contest_IOT_10 ... more

Fork of X_NUCLEO_IDB0XA1 by ST Expansion SW Team

Arduino Connector Compatibility Warning

X-NUCLEO-IDB04A1 and X-NUCLEO-IDB05A1 are Arduino compatible with an exception: instead of using pin D13 for the SPI clock, they use pin D3. The default configuration for this library is having the SPI clock on pin D3.

To be fully Arduino compatible, X-NUCLEO-IDB04A1 and X-NUCLEO-IDB05A1 need a small HW patch.

For X-NUCLEO-IDB04A1 this patch consists in removing zero resistor R10 and instead soldering zero resistor R11. For X-NUCLEO-IDB05A1 this patch consists in removing zero resistor R4 and instead soldering zero resistor R6.

In case you patch your board, then you also have to configure this library to use pin D13 to drive the SPI clock (see macro IDB0XA1_D13_PATCH in file x_nucleo_idb0xa1_targets.h).

If you use pin D13 for the SPI clock, please be aware that on STM32 Nucleo boards you may not drive the LED, otherwise you will get a conflict: the LED on STM32 Nucleo boards is connected to pin D13.

Referring to the current list of tested platforms (see X-NUCLEO-IDB04A1 and X-NUCLEO-IDB05A1 pages), the patch is required by ST-Nucleo-F103RB; ST-Nucleo-F302R8; ST-Nucleo-F411RE; and ST-Nucleo-F446RE.

source/BlueNRGDevice.cpp@273:00205952d841, 2016-09-15 (annotated)

Committer:
Vincent Coubard
Date:
Thu Sep 15 10:51:36 2016 +0100
Branch:
dc54644b61c51990e49672e5bbce3b95124d6364
Revision:
273:00205952d841
Parent:
264:1e754a01869e
Parent:
271:7dc6261c33e5
Child:
278:a5209d8cfd61
Sync with dc54644b61c51990e49672e5bbce3b95124d6364



Merge 83c30f290087a6f5a503812f507492e725a3b717 into e9fb3e390284c3f7ef8e1d21cc55deef7558ca3d

2016-07-20 08:50:37+01:00: Vincent Coubard

Merge branch 'workshop-july' into rtos

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 ******************************************************************************
Wolfgang Betz 130:770ce14d3d15 19 * @file BlueNRGDevice.cpp
Wolfgang Betz 130:770ce14d3d15 20 * @author STMicroelectronics
Wolfgang Betz 130:770ce14d3d15 21 * @brief Implementation of BLEDeviceInstanceBase
Wolfgang Betz 130:770ce14d3d15 22 ******************************************************************************
Wolfgang Betz 130:770ce14d3d15 23 * @copy
Wolfgang Betz 130:770ce14d3d15 24 *
Wolfgang Betz 130:770ce14d3d15 25 * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
Wolfgang Betz 130:770ce14d3d15 26 * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
Wolfgang Betz 130:770ce14d3d15 27 * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
Wolfgang Betz 130:770ce14d3d15 28 * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
Wolfgang Betz 130:770ce14d3d15 29 * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
Wolfgang Betz 130:770ce14d3d15 30 * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
Wolfgang Betz 130:770ce14d3d15 31 *
Wolfgang Betz 130:770ce14d3d15 32 * <h2><center>&copy; COPYRIGHT 2013 STMicroelectronics</center></h2>
Wolfgang Betz 130:770ce14d3d15 33 */
Wolfgang Betz 130:770ce14d3d15 34
Wolfgang Betz 130:770ce14d3d15 35 /** @defgroup BlueNRGDevice
Wolfgang Betz 130:770ce14d3d15 36 * @brief BlueNRG BLE_API Device Adaptation
Wolfgang Betz 130:770ce14d3d15 37 * @{
Wolfgang Betz 130:770ce14d3d15 38 */
Wolfgang Betz 130:770ce14d3d15 39
Vincent Coubard 253:9665a6f8bbdb 40 #include "mbed-drivers/mbed.h"
Wolfgang Betz 130:770ce14d3d15 41 #include "BlueNRGDevice.h"
Wolfgang Betz 130:770ce14d3d15 42 #include "BlueNRGGap.h"
Wolfgang Betz 130:770ce14d3d15 43 #include "BlueNRGGattServer.h"
Wolfgang Betz 130:770ce14d3d15 44
Wolfgang Betz 130:770ce14d3d15 45 #include "btle.h"
Wolfgang Betz 130:770ce14d3d15 46 #include "Utils.h"
Wolfgang Betz 130:770ce14d3d15 47 #include "osal.h"
Wolfgang Betz 130:770ce14d3d15 48
Wolfgang Betz 130:770ce14d3d15 49 #include "debug.h"
Wolfgang Betz 130:770ce14d3d15 50 #include "stm32_bluenrg_ble.h"
Wolfgang Betz 130:770ce14d3d15 51
Wolfgang Betz 130:770ce14d3d15 52 extern "C" {
Wolfgang Betz 130:770ce14d3d15 53 #include "hci.h"
Antonio Vilei 245:6830f71c197c 54 #include "bluenrg_utils.h"
Wolfgang Betz 130:770ce14d3d15 55 }
Wolfgang Betz 130:770ce14d3d15 56
Wolfgang Betz 130:770ce14d3d15 57 #define HEADER_SIZE 5
Wolfgang Betz 130:770ce14d3d15 58 #define MAX_BUFFER_SIZE 255
Wolfgang Betz 130:770ce14d3d15 59
Wolfgang Betz 130:770ce14d3d15 60 /**
Wolfgang Betz 130:770ce14d3d15 61 * The singleton which represents the BlueNRG transport for the BLEDevice.
Wolfgang Betz 130:770ce14d3d15 62 *
Wolfgang Betz 130:770ce14d3d15 63 * See file 'x_nucleo_idb0xa1_targets.h' for details regarding the peripheral pins used!
Wolfgang Betz 130:770ce14d3d15 64 */
Wolfgang Betz 130:770ce14d3d15 65 #include "x_nucleo_idb0xa1_targets.h"
Wolfgang Betz 130:770ce14d3d15 66
Wolfgang Betz 130:770ce14d3d15 67 BlueNRGDevice bluenrgDeviceInstance(IDB0XA1_PIN_SPI_MOSI,
Wolfgang Betz 130:770ce14d3d15 68 IDB0XA1_PIN_SPI_MISO,
Wolfgang Betz 130:770ce14d3d15 69 IDB0XA1_PIN_SPI_SCK,
Wolfgang Betz 130:770ce14d3d15 70 IDB0XA1_PIN_SPI_nCS,
Wolfgang Betz 130:770ce14d3d15 71 IDB0XA1_PIN_SPI_RESET,
Wolfgang Betz 130:770ce14d3d15 72 IDB0XA1_PIN_SPI_IRQ);
Wolfgang Betz 130:770ce14d3d15 73
Wolfgang Betz 130:770ce14d3d15 74 /**
Wolfgang Betz 130:770ce14d3d15 75 * BLE-API requires an implementation of the following function in order to
Wolfgang Betz 130:770ce14d3d15 76 * obtain its transport handle.
Wolfgang Betz 130:770ce14d3d15 77 */
Wolfgang Betz 130:770ce14d3d15 78 BLEInstanceBase *
Wolfgang Betz 130:770ce14d3d15 79 createBLEInstance(void)
Wolfgang Betz 130:770ce14d3d15 80 {
Wolfgang Betz 130:770ce14d3d15 81 return (&bluenrgDeviceInstance);
Wolfgang Betz 130:770ce14d3d15 82 }
Wolfgang Betz 130:770ce14d3d15 83
Wolfgang Betz 130:770ce14d3d15 84 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 85 /**
Wolfgang Betz 130:770ce14d3d15 86 @brief Constructor
Wolfgang Betz 130:770ce14d3d15 87 * @param mosi mbed pin to use for MOSI line of SPI interface
Wolfgang Betz 130:770ce14d3d15 88 * @param miso mbed pin to use for MISO line of SPI interface
Wolfgang Betz 130:770ce14d3d15 89 * @param sck mbed pin to use for SCK line of SPI interface
Wolfgang Betz 130:770ce14d3d15 90 * @param cs mbed pin to use for not chip select line of SPI interface
Wolfgang Betz 130:770ce14d3d15 91 * @param rst mbed pin to use for BlueNRG reset
Wolfgang Betz 130:770ce14d3d15 92 * @param irq mbed pin for BlueNRG IRQ
Wolfgang Betz 130:770ce14d3d15 93 */
Wolfgang Betz 130:770ce14d3d15 94 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 95 BlueNRGDevice::BlueNRGDevice(PinName mosi,
Wolfgang Betz 130:770ce14d3d15 96 PinName miso,
Wolfgang Betz 130:770ce14d3d15 97 PinName sck,
Wolfgang Betz 130:770ce14d3d15 98 PinName cs,
Wolfgang Betz 130:770ce14d3d15 99 PinName rst,
Wolfgang Betz 168:ad1dff5dca1f 100 PinName irq) :
Wolfgang Betz 168:ad1dff5dca1f 101 isInitialized(false), spi_(mosi, miso, sck), nCS_(cs), rst_(rst), irq_(irq)
Wolfgang Betz 130:770ce14d3d15 102 {
Wolfgang Betz 130:770ce14d3d15 103 // Setup the spi for 8 bit data, low clock polarity,
Wolfgang Betz 130:770ce14d3d15 104 // 1-edge phase, with an 8MHz clock rate
Wolfgang Betz 130:770ce14d3d15 105 spi_.format(8, 0);
Wolfgang Betz 130:770ce14d3d15 106 spi_.frequency(8000000);
Wolfgang Betz 130:770ce14d3d15 107
Wolfgang Betz 130:770ce14d3d15 108 // Deselect the BlueNRG chip by keeping its nCS signal high
Wolfgang Betz 130:770ce14d3d15 109 nCS_ = 1;
Wolfgang Betz 130:770ce14d3d15 110
Wolfgang Betz 130:770ce14d3d15 111 wait_us(500);
Antonio Vilei 245:6830f71c197c 112
Antonio Vilei 246:d73c4f798379 113 // Prepare communication between the host and the BlueNRG SPI interface
Antonio Vilei 246:d73c4f798379 114 HCI_Init();
Antonio Vilei 246:d73c4f798379 115
Antonio Vilei 245:6830f71c197c 116 // Set the interrupt handler for the device
Antonio Vilei 245:6830f71c197c 117 irq_.mode(PullDown); // set irq mode
Antonio Vilei 245:6830f71c197c 118 irq_.rise(&HCI_Isr);
Wolfgang Betz 130:770ce14d3d15 119 }
Wolfgang Betz 130:770ce14d3d15 120
Wolfgang Betz 130:770ce14d3d15 121 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 122 /**
Wolfgang Betz 130:770ce14d3d15 123 @brief Destructor
Wolfgang Betz 130:770ce14d3d15 124 */
Wolfgang Betz 130:770ce14d3d15 125 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 126 BlueNRGDevice::~BlueNRGDevice(void)
Wolfgang Betz 130:770ce14d3d15 127 {
Wolfgang Betz 130:770ce14d3d15 128 }
Wolfgang Betz 130:770ce14d3d15 129
Antonio Vilei 245:6830f71c197c 130 /**
Antonio Vilei 245:6830f71c197c 131 * @brief Get BlueNRG HW version in bootloader mode
Antonio Vilei 245:6830f71c197c 132 * @param hw_version The HW version is written to this parameter
Antonio Vilei 245:6830f71c197c 133 * @retval It returns BLE_STATUS_SUCCESS on success or an error code otherwise
Antonio Vilei 245:6830f71c197c 134 */
Antonio Vilei 245:6830f71c197c 135 uint8_t BlueNRGDevice::getUpdaterHardwareVersion(uint8_t *hw_version)
Antonio Vilei 245:6830f71c197c 136 {
Antonio Vilei 245:6830f71c197c 137 uint8_t status;
Antonio Vilei 245:6830f71c197c 138
Antonio Vilei 245:6830f71c197c 139 status = getBlueNRGUpdaterHWVersion(hw_version);
Antonio Vilei 245:6830f71c197c 140
Antonio Vilei 245:6830f71c197c 141 return (status);
Antonio Vilei 245:6830f71c197c 142 }
Wolfgang Betz 130:770ce14d3d15 143
Wolfgang Betz 130:770ce14d3d15 144 /**
Antonio Vilei 245:6830f71c197c 145 * @brief Flash a new firmware using internal bootloader.
Antonio Vilei 245:6830f71c197c 146 * @param fw_image Pointer to the firmware image (raw binary data,
Antonio Vilei 245:6830f71c197c 147 * little-endian).
Antonio Vilei 245:6830f71c197c 148 * @param fw_size Size of the firmware image. The firmware image size shall
Antonio Vilei 245:6830f71c197c 149 * be multiple of 4 bytes.
Antonio Vilei 245:6830f71c197c 150 * @retval int It returns BLE_STATUS_SUCCESS on success, or a number
Antonio Vilei 245:6830f71c197c 151 * not equal to 0 in case of error
Antonio Vilei 245:6830f71c197c 152 * (ACI_ERROR, UNSUPPORTED_VERSION, WRONG_IMAGE_SIZE, CRC_ERROR)
Antonio Vilei 245:6830f71c197c 153 */
Antonio Vilei 245:6830f71c197c 154 int BlueNRGDevice::updateFirmware(const uint8_t *fw_image, uint32_t fw_size)
Antonio Vilei 245:6830f71c197c 155 {
Antonio Vilei 245:6830f71c197c 156 int status = program_device(fw_image, fw_size);
Antonio Vilei 245:6830f71c197c 157
Antonio Vilei 245:6830f71c197c 158 return (status);
Antonio Vilei 245:6830f71c197c 159 }
Antonio Vilei 245:6830f71c197c 160
Antonio Vilei 245:6830f71c197c 161
Antonio Vilei 245:6830f71c197c 162 /**
Antonio Vilei 245:6830f71c197c 163 * @brief Initialises anything required to start using BLE
Antonio Vilei 245:6830f71c197c 164 * @param[in] instanceID
Antonio Vilei 245:6830f71c197c 165 * The ID of the instance to initialize.
Antonio Vilei 245:6830f71c197c 166 * @param[in] callback
Antonio Vilei 245:6830f71c197c 167 * A callback for when initialization completes for a BLE
Antonio Vilei 245:6830f71c197c 168 * instance. This is an optional parameter set to NULL when not
Antonio Vilei 245:6830f71c197c 169 * supplied.
Antonio Vilei 245:6830f71c197c 170 *
Antonio Vilei 245:6830f71c197c 171 * @return BLE_ERROR_NONE if the initialization procedure was started
Antonio Vilei 245:6830f71c197c 172 * successfully.
Antonio Vilei 245:6830f71c197c 173 */
Andrea Palmieri 167:abc42e7158a6 174 ble_error_t BlueNRGDevice::init(BLE::InstanceID_t instanceID, FunctionPointerWithContext<BLE::InitializationCompleteCallbackContext *> callback)
Wolfgang Betz 130:770ce14d3d15 175 {
Andrea Palmieri 167:abc42e7158a6 176 if (isInitialized) {
Andrea Palmieri 167:abc42e7158a6 177 BLE::InitializationCompleteCallbackContext context = {
Andrea Palmieri 167:abc42e7158a6 178 BLE::Instance(instanceID),
Andrea Palmieri 167:abc42e7158a6 179 BLE_ERROR_ALREADY_INITIALIZED
Andrea Palmieri 167:abc42e7158a6 180 };
Andrea Palmieri 167:abc42e7158a6 181 callback.call(&context);
Andrea Palmieri 167:abc42e7158a6 182 return BLE_ERROR_ALREADY_INITIALIZED;
Andrea Palmieri 167:abc42e7158a6 183 }
Vincent Coubard 271:7dc6261c33e5 184
Antonio Vilei 245:6830f71c197c 185 // Init the BlueNRG/BlueNRG-MS stack
Vincent Coubard 271:7dc6261c33e5 186 btleInit();
Wolfgang Betz 130:770ce14d3d15 187
Wolfgang Betz 130:770ce14d3d15 188 isInitialized = true;
Andrea Palmieri 167:abc42e7158a6 189 BLE::InitializationCompleteCallbackContext context = {
Andrea Palmieri 167:abc42e7158a6 190 BLE::Instance(instanceID),
Andrea Palmieri 167:abc42e7158a6 191 BLE_ERROR_NONE
Andrea Palmieri 167:abc42e7158a6 192 };
Andrea Palmieri 167:abc42e7158a6 193 callback.call(&context);
Wolfgang Betz 130:770ce14d3d15 194
Wolfgang Betz 130:770ce14d3d15 195 return BLE_ERROR_NONE;
Wolfgang Betz 130:770ce14d3d15 196 }
Wolfgang Betz 130:770ce14d3d15 197
Wolfgang Betz 130:770ce14d3d15 198
Wolfgang Betz 130:770ce14d3d15 199 /**
Wolfgang Betz 130:770ce14d3d15 200 @brief Resets the BLE HW, removing any existing services and
Wolfgang Betz 130:770ce14d3d15 201 characteristics
Wolfgang Betz 130:770ce14d3d15 202 @param[in] void
Andrea Palmieri 229:9981f62cdb1a 203 @returns void
Wolfgang Betz 130:770ce14d3d15 204 */
Andrea Palmieri 229:9981f62cdb1a 205 void BlueNRGDevice::reset(void)
Wolfgang Betz 130:770ce14d3d15 206 {
Wolfgang Betz 130:770ce14d3d15 207 wait_us(500);
Wolfgang Betz 130:770ce14d3d15 208
Wolfgang Betz 130:770ce14d3d15 209 /* Reset BlueNRG SPI interface */
Wolfgang Betz 130:770ce14d3d15 210 rst_ = 0;
Wolfgang Betz 130:770ce14d3d15 211 wait_us(5);
Wolfgang Betz 130:770ce14d3d15 212 rst_ = 1;
Wolfgang Betz 130:770ce14d3d15 213 wait_us(5);
Wolfgang Betz 130:770ce14d3d15 214
Wolfgang Betz 130:770ce14d3d15 215 /* Wait for the radio to come back up */
Wolfgang Betz 130:770ce14d3d15 216 wait_us(500);
Wolfgang Betz 130:770ce14d3d15 217
Wolfgang Betz 130:770ce14d3d15 218 }
Wolfgang Betz 130:770ce14d3d15 219
Wolfgang Betz 130:770ce14d3d15 220 /*!
Wolfgang Betz 130:770ce14d3d15 221 @brief Wait for any BLE Event like BLE Connection, Read Request etc.
Wolfgang Betz 130:770ce14d3d15 222 @param[in] void
Wolfgang Betz 130:770ce14d3d15 223 @returns char *
Wolfgang Betz 130:770ce14d3d15 224 */
Wolfgang Betz 130:770ce14d3d15 225 void BlueNRGDevice::waitForEvent(void)
Wolfgang Betz 130:770ce14d3d15 226 {
Wolfgang Betz 130:770ce14d3d15 227 bool must_return = false;
Wolfgang Betz 130:770ce14d3d15 228
Wolfgang Betz 130:770ce14d3d15 229 do {
Vincent Coubard 264:1e754a01869e 230 bluenrgDeviceInstance.processEvents();
Wolfgang Betz 130:770ce14d3d15 231
Wolfgang Betz 130:770ce14d3d15 232 if(must_return) return;
Wolfgang Betz 130:770ce14d3d15 233
Wolfgang Betz 130:770ce14d3d15 234 __WFE(); /* it is recommended that SEVONPEND in the
Wolfgang Betz 130:770ce14d3d15 235 System Control Register is NOT set */
Wolfgang Betz 130:770ce14d3d15 236 must_return = true; /* after returning from WFE we must guarantee
Wolfgang Betz 130:770ce14d3d15 237 that conrol is given back to main loop before next WFE */
Wolfgang Betz 130:770ce14d3d15 238 } while(true);
Wolfgang Betz 130:770ce14d3d15 239
Wolfgang Betz 139:3a75965fd389 240 }
Wolfgang Betz 130:770ce14d3d15 241
Wolfgang Betz 130:770ce14d3d15 242 /*!
Wolfgang Betz 130:770ce14d3d15 243 @brief get GAP version
Andrea Palmieri 216:7aa807180321 244 @brief Get the BLE stack version information
Wolfgang Betz 130:770ce14d3d15 245 @param[in] void
Wolfgang Betz 130:770ce14d3d15 246 @returns char *
Andrea Palmieri 216:7aa807180321 247 @returns char *
Wolfgang Betz 130:770ce14d3d15 248 */
Wolfgang Betz 130:770ce14d3d15 249 const char *BlueNRGDevice::getVersion(void)
Wolfgang Betz 130:770ce14d3d15 250 {
Andrea Palmieri 216:7aa807180321 251 return getVersionString();
Wolfgang Betz 130:770ce14d3d15 252 }
Wolfgang Betz 130:770ce14d3d15 253
Wolfgang Betz 130:770ce14d3d15 254 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 255 /*!
Wolfgang Betz 130:770ce14d3d15 256 @brief get reference to GAP object
Wolfgang Betz 130:770ce14d3d15 257 @param[in] void
Wolfgang Betz 130:770ce14d3d15 258 @returns Gap&
Wolfgang Betz 130:770ce14d3d15 259 */
Wolfgang Betz 130:770ce14d3d15 260 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 261 Gap &BlueNRGDevice::getGap()
Wolfgang Betz 130:770ce14d3d15 262 {
Wolfgang Betz 130:770ce14d3d15 263 return BlueNRGGap::getInstance();
Wolfgang Betz 130:770ce14d3d15 264 }
Wolfgang Betz 130:770ce14d3d15 265
Wolfgang Betz 130:770ce14d3d15 266 const Gap &BlueNRGDevice::getGap() const
Wolfgang Betz 130:770ce14d3d15 267 {
Wolfgang Betz 130:770ce14d3d15 268 return BlueNRGGap::getInstance();
Wolfgang Betz 130:770ce14d3d15 269 }
Wolfgang Betz 130:770ce14d3d15 270
Wolfgang Betz 130:770ce14d3d15 271 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 272 /*!
Wolfgang Betz 130:770ce14d3d15 273 @brief get reference to GATT server object
Wolfgang Betz 130:770ce14d3d15 274 @param[in] void
Wolfgang Betz 130:770ce14d3d15 275 @returns GattServer&
Wolfgang Betz 130:770ce14d3d15 276 */
Wolfgang Betz 130:770ce14d3d15 277 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 278 GattServer &BlueNRGDevice::getGattServer()
Wolfgang Betz 130:770ce14d3d15 279 {
Wolfgang Betz 130:770ce14d3d15 280 return BlueNRGGattServer::getInstance();
Wolfgang Betz 130:770ce14d3d15 281 }
Wolfgang Betz 130:770ce14d3d15 282
Wolfgang Betz 130:770ce14d3d15 283 const GattServer &BlueNRGDevice::getGattServer() const
Wolfgang Betz 130:770ce14d3d15 284 {
Wolfgang Betz 130:770ce14d3d15 285 return BlueNRGGattServer::getInstance();
Wolfgang Betz 130:770ce14d3d15 286 }
Wolfgang Betz 130:770ce14d3d15 287
Wolfgang Betz 130:770ce14d3d15 288 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 289 /*!
Andrea Palmieri 216:7aa807180321 290 @brief shut down the BLE device
Wolfgang Betz 130:770ce14d3d15 291 @param[out] error if any
Wolfgang Betz 130:770ce14d3d15 292 */
Wolfgang Betz 130:770ce14d3d15 293 /**************************************************************************/
Wolfgang Betz 130:770ce14d3d15 294 ble_error_t BlueNRGDevice::shutdown(void) {
Andrea Palmieri 216:7aa807180321 295 if (!isInitialized) {
Andrea Palmieri 216:7aa807180321 296 return BLE_ERROR_INITIALIZATION_INCOMPLETE;
Andrea Palmieri 216:7aa807180321 297 }
Andrea Palmieri 216:7aa807180321 298
Andrea Palmieri 229:9981f62cdb1a 299 /* Reset the BlueNRG device first */
Andrea Palmieri 229:9981f62cdb1a 300 reset();
Andrea Palmieri 229:9981f62cdb1a 301
Andrea Palmieri 229:9981f62cdb1a 302 /* Shutdown the BLE API and BlueNRG glue code */
Andrea Palmieri 229:9981f62cdb1a 303 ble_error_t error;
Andrea Palmieri 229:9981f62cdb1a 304
Andrea Palmieri 229:9981f62cdb1a 305 /* GattServer instance */
Andrea Palmieri 229:9981f62cdb1a 306 error = BlueNRGGattServer::getInstance().reset();
Andrea Palmieri 229:9981f62cdb1a 307 if (error != BLE_ERROR_NONE) {
Andrea Palmieri 229:9981f62cdb1a 308 return error;
Andrea Palmieri 229:9981f62cdb1a 309 }
Andrea Palmieri 229:9981f62cdb1a 310
Andrea Palmieri 229:9981f62cdb1a 311 /* GattClient instance */
Andrea Palmieri 229:9981f62cdb1a 312 error = BlueNRGGattClient::getInstance().reset();
Andrea Palmieri 229:9981f62cdb1a 313 if (error != BLE_ERROR_NONE) {
Andrea Palmieri 229:9981f62cdb1a 314 return error;
Andrea Palmieri 229:9981f62cdb1a 315 }
Andrea Palmieri 229:9981f62cdb1a 316
Andrea Palmieri 229:9981f62cdb1a 317 /* Gap instance */
Andrea Palmieri 229:9981f62cdb1a 318 error = BlueNRGGap::getInstance().reset();
Andrea Palmieri 229:9981f62cdb1a 319 if (error != BLE_ERROR_NONE) {
Andrea Palmieri 229:9981f62cdb1a 320 return error;
Andrea Palmieri 229:9981f62cdb1a 321 }
Andrea Palmieri 229:9981f62cdb1a 322
Andrea Palmieri 229:9981f62cdb1a 323 isInitialized = false;
Andrea Palmieri 229:9981f62cdb1a 324
Andrea Palmieri 229:9981f62cdb1a 325 return BLE_ERROR_NONE;
Andrea Palmieri 229:9981f62cdb1a 326
Wolfgang Betz 130:770ce14d3d15 327 }
Wolfgang Betz 130:770ce14d3d15 328
Wolfgang Betz 130:770ce14d3d15 329 /**
Wolfgang Betz 130:770ce14d3d15 330 * @brief Reads from BlueNRG SPI buffer and store data into local buffer.
Wolfgang Betz 130:770ce14d3d15 331 * @param buffer : Buffer where data from SPI are stored
Wolfgang Betz 130:770ce14d3d15 332 * @param buff_size: Buffer size
Wolfgang Betz 130:770ce14d3d15 333 * @retval int32_t : Number of read bytes
Wolfgang Betz 130:770ce14d3d15 334 */
Wolfgang Betz 130:770ce14d3d15 335 int32_t BlueNRGDevice::spiRead(uint8_t *buffer, uint8_t buff_size)
Wolfgang Betz 130:770ce14d3d15 336 {
Wolfgang Betz 130:770ce14d3d15 337 uint16_t byte_count;
Wolfgang Betz 130:770ce14d3d15 338 uint8_t len = 0;
Wolfgang Betz 130:770ce14d3d15 339 uint8_t char_ff = 0xff;
Wolfgang Betz 130:770ce14d3d15 340 volatile uint8_t read_char;
Wolfgang Betz 130:770ce14d3d15 341
Wolfgang Betz 130:770ce14d3d15 342 uint8_t i = 0;
Wolfgang Betz 130:770ce14d3d15 343 volatile uint8_t tmpreg;
Wolfgang Betz 130:770ce14d3d15 344
Wolfgang Betz 130:770ce14d3d15 345 uint8_t header_master[HEADER_SIZE] = {0x0b, 0x00, 0x00, 0x00, 0x00};
Wolfgang Betz 130:770ce14d3d15 346 uint8_t header_slave[HEADER_SIZE];
Wolfgang Betz 130:770ce14d3d15 347
Wolfgang Betz 130:770ce14d3d15 348 /* Select the chip */
Wolfgang Betz 130:770ce14d3d15 349 nCS_ = 0;
Wolfgang Betz 130:770ce14d3d15 350
Wolfgang Betz 130:770ce14d3d15 351 /* Read the header */
Wolfgang Betz 130:770ce14d3d15 352 for (i = 0; i < 5; i++)
Wolfgang Betz 130:770ce14d3d15 353 {
Wolfgang Betz 130:770ce14d3d15 354 tmpreg = spi_.write(header_master[i]);
Wolfgang Betz 130:770ce14d3d15 355 header_slave[i] = (uint8_t)(tmpreg);
Wolfgang Betz 130:770ce14d3d15 356 }
Wolfgang Betz 130:770ce14d3d15 357
Wolfgang Betz 130:770ce14d3d15 358 if (header_slave[0] == 0x02) {
Wolfgang Betz 130:770ce14d3d15 359 /* device is ready */
Wolfgang Betz 130:770ce14d3d15 360 byte_count = (header_slave[4]<<8)|header_slave[3];
Wolfgang Betz 130:770ce14d3d15 361
Wolfgang Betz 130:770ce14d3d15 362 if (byte_count > 0) {
Wolfgang Betz 130:770ce14d3d15 363
Wolfgang Betz 130:770ce14d3d15 364 /* avoid to read more data that size of the buffer */
Wolfgang Betz 130:770ce14d3d15 365 if (byte_count > buff_size){
Wolfgang Betz 130:770ce14d3d15 366 byte_count = buff_size;
Wolfgang Betz 130:770ce14d3d15 367 }
Wolfgang Betz 130:770ce14d3d15 368
Wolfgang Betz 130:770ce14d3d15 369 for (len = 0; len < byte_count; len++){
Wolfgang Betz 130:770ce14d3d15 370 read_char = spi_.write(char_ff);
Wolfgang Betz 130:770ce14d3d15 371 buffer[len] = read_char;
Wolfgang Betz 130:770ce14d3d15 372 }
Wolfgang Betz 130:770ce14d3d15 373 }
Wolfgang Betz 130:770ce14d3d15 374 }
Wolfgang Betz 130:770ce14d3d15 375 /* Release CS line to deselect the chip */
Wolfgang Betz 130:770ce14d3d15 376 nCS_ = 1;
Wolfgang Betz 130:770ce14d3d15 377
Wolfgang Betz 130:770ce14d3d15 378 // Add a small delay to give time to the BlueNRG to set the IRQ pin low
Wolfgang Betz 130:770ce14d3d15 379 // to avoid a useless SPI read at the end of the transaction
Wolfgang Betz 130:770ce14d3d15 380 for(volatile int i = 0; i < 2; i++)__NOP();
Wolfgang Betz 130:770ce14d3d15 381
Wolfgang Betz 130:770ce14d3d15 382 #ifdef PRINT_CSV_FORMAT
Wolfgang Betz 130:770ce14d3d15 383 if (len > 0) {
Wolfgang Betz 130:770ce14d3d15 384 print_csv_time();
Wolfgang Betz 130:770ce14d3d15 385 for (int i=0; i<len; i++) {
Wolfgang Betz 130:770ce14d3d15 386 PRINT_CSV(" %02x", buffer[i]);
Wolfgang Betz 130:770ce14d3d15 387 }
Wolfgang Betz 130:770ce14d3d15 388 PRINT_CSV("\n");
Wolfgang Betz 130:770ce14d3d15 389 }
Wolfgang Betz 130:770ce14d3d15 390 #endif
Wolfgang Betz 130:770ce14d3d15 391
Wolfgang Betz 130:770ce14d3d15 392 return len;
Wolfgang Betz 130:770ce14d3d15 393 }
Wolfgang Betz 130:770ce14d3d15 394
Wolfgang Betz 130:770ce14d3d15 395 /**
Wolfgang Betz 130:770ce14d3d15 396 * @brief Writes data from local buffer to SPI.
Wolfgang Betz 130:770ce14d3d15 397 * @param data1 : First data buffer to be written
Wolfgang Betz 130:770ce14d3d15 398 * @param data2 : Second data buffer to be written
Wolfgang Betz 130:770ce14d3d15 399 * @param Nb_bytes1: Size of first data buffer to be written
Wolfgang Betz 130:770ce14d3d15 400 * @param Nb_bytes2: Size of second data buffer to be written
Wolfgang Betz 130:770ce14d3d15 401 * @retval Number of read bytes
Wolfgang Betz 130:770ce14d3d15 402 */
Wolfgang Betz 130:770ce14d3d15 403 int32_t BlueNRGDevice::spiWrite(uint8_t* data1,
Wolfgang Betz 130:770ce14d3d15 404 uint8_t* data2, uint8_t Nb_bytes1, uint8_t Nb_bytes2)
Wolfgang Betz 130:770ce14d3d15 405 {
Wolfgang Betz 130:770ce14d3d15 406 int32_t result = 0;
Wolfgang Betz 130:770ce14d3d15 407 uint32_t i;
Wolfgang Betz 130:770ce14d3d15 408 volatile uint8_t tmpreg;
Wolfgang Betz 130:770ce14d3d15 409
Wolfgang Betz 130:770ce14d3d15 410 unsigned char header_master[HEADER_SIZE] = {0x0a, 0x00, 0x00, 0x00, 0x00};
Wolfgang Betz 130:770ce14d3d15 411 unsigned char header_slave[HEADER_SIZE] = {0xaa, 0x00, 0x00, 0x00, 0x00};
Wolfgang Betz 130:770ce14d3d15 412
Wolfgang Betz 130:770ce14d3d15 413 disable_irq();
Wolfgang Betz 130:770ce14d3d15 414
Wolfgang Betz 130:770ce14d3d15 415 /* CS reset */
Wolfgang Betz 130:770ce14d3d15 416 nCS_ = 0;
Wolfgang Betz 130:770ce14d3d15 417
Wolfgang Betz 130:770ce14d3d15 418 /* Exchange header */
Wolfgang Betz 130:770ce14d3d15 419 for (i = 0; i < 5; i++)
Wolfgang Betz 130:770ce14d3d15 420 {
Wolfgang Betz 130:770ce14d3d15 421 tmpreg = spi_.write(header_master[i]);
Wolfgang Betz 130:770ce14d3d15 422 header_slave[i] = tmpreg;
Wolfgang Betz 130:770ce14d3d15 423 }
Wolfgang Betz 130:770ce14d3d15 424
Wolfgang Betz 130:770ce14d3d15 425 if (header_slave[0] == 0x02) {
Wolfgang Betz 130:770ce14d3d15 426 /* SPI is ready */
Wolfgang Betz 130:770ce14d3d15 427 if (header_slave[1] >= (Nb_bytes1+Nb_bytes2)) {
Wolfgang Betz 130:770ce14d3d15 428
Wolfgang Betz 130:770ce14d3d15 429 /* Buffer is big enough */
Wolfgang Betz 130:770ce14d3d15 430 for (i = 0; i < Nb_bytes1; i++) {
Wolfgang Betz 130:770ce14d3d15 431 spi_.write(*(data1 + i));
Wolfgang Betz 130:770ce14d3d15 432 }
Wolfgang Betz 130:770ce14d3d15 433 for (i = 0; i < Nb_bytes2; i++) {
Wolfgang Betz 130:770ce14d3d15 434 spi_.write(*(data2 + i));
Wolfgang Betz 130:770ce14d3d15 435 }
Wolfgang Betz 130:770ce14d3d15 436 } else {
Wolfgang Betz 130:770ce14d3d15 437 /* Buffer is too small */
Wolfgang Betz 130:770ce14d3d15 438 result = -2;
Wolfgang Betz 130:770ce14d3d15 439 }
Wolfgang Betz 130:770ce14d3d15 440 } else {
Wolfgang Betz 130:770ce14d3d15 441 /* SPI is not ready */
Wolfgang Betz 130:770ce14d3d15 442 result = -1;
Wolfgang Betz 130:770ce14d3d15 443 }
Wolfgang Betz 130:770ce14d3d15 444
Wolfgang Betz 130:770ce14d3d15 445 /* Release CS line */
Wolfgang Betz 130:770ce14d3d15 446 //HAL_GPIO_WritePin(BNRG_SPI_CS_PORT, BNRG_SPI_CS_PIN, GPIO_PIN_SET);
Wolfgang Betz 130:770ce14d3d15 447 nCS_ = 1;
Wolfgang Betz 130:770ce14d3d15 448
Wolfgang Betz 130:770ce14d3d15 449 enable_irq();
Wolfgang Betz 130:770ce14d3d15 450
Wolfgang Betz 130:770ce14d3d15 451 return result;
Wolfgang Betz 130:770ce14d3d15 452 }
Wolfgang Betz 130:770ce14d3d15 453
Wolfgang Betz 130:770ce14d3d15 454 bool BlueNRGDevice::dataPresent()
Wolfgang Betz 130:770ce14d3d15 455 {
Wolfgang Betz 130:770ce14d3d15 456 return (irq_ == 1);
Wolfgang Betz 130:770ce14d3d15 457 }
Wolfgang Betz 130:770ce14d3d15 458
Wolfgang Betz 130:770ce14d3d15 459 void BlueNRGDevice::disable_irq()
Wolfgang Betz 130:770ce14d3d15 460 {
Wolfgang Betz 130:770ce14d3d15 461 irq_.disable_irq();
Wolfgang Betz 130:770ce14d3d15 462 }
Wolfgang Betz 130:770ce14d3d15 463
Wolfgang Betz 130:770ce14d3d15 464 void BlueNRGDevice::enable_irq()
Wolfgang Betz 130:770ce14d3d15 465 {
Wolfgang Betz 130:770ce14d3d15 466 irq_.enable_irq();
Wolfgang Betz 130:770ce14d3d15 467 }
Vincent Coubard 264:1e754a01869e 468
Vincent Coubard 264:1e754a01869e 469 void BlueNRGDevice::processEvents() {
Vincent Coubard 264:1e754a01869e 470 btle_handler();
Vincent Coubard 271:7dc6261c33e5 471 }