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.

x-nucleo-idb0xa1/utils/ble_utils.h@280:fbee0e3444be, 2016-09-15 (annotated)

Committer:
Vincent Coubard
Date:
Thu Sep 15 10:51:47 2016 +0100
Branch:
34e2f6254ad7de7fc7f377a0614c3a672cf7cd5c
Revision:
280:fbee0e3444be
Parent:
x-nucleo-idb0xa1/utils/Utils.h@278:a5209d8cfd61
Child:
294:fd19310b086d
Sync with 34e2f6254ad7de7fc7f377a0614c3a672cf7cd5c



2016-07-28 15:27:24+02:00: Andrea Palmieri

Add ble_ prefix to filename



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

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Wolfgang Betz 132:51056160fa4a 1 /* mbed Microcontroller Library
Wolfgang Betz 132:51056160fa4a 2 * Copyright (c) 2006-2013 ARM Limited
Wolfgang Betz 132:51056160fa4a 3 *
Wolfgang Betz 132:51056160fa4a 4 * Licensed under the Apache License, Version 2.0 (the "License");
Wolfgang Betz 132:51056160fa4a 5 * you may not use this file except in compliance with the License.
Wolfgang Betz 132:51056160fa4a 6 * You may obtain a copy of the License at
Wolfgang Betz 132:51056160fa4a 7 *
Wolfgang Betz 132:51056160fa4a 8 * http://www.apache.org/licenses/LICENSE-2.0
Wolfgang Betz 132:51056160fa4a 9 *
Wolfgang Betz 132:51056160fa4a 10 * Unless required by applicable law or agreed to in writing, software
Wolfgang Betz 132:51056160fa4a 11 * distributed under the License is distributed on an "AS IS" BASIS,
Wolfgang Betz 132:51056160fa4a 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Wolfgang Betz 132:51056160fa4a 13 * See the License for the specific language governing permissions and
Wolfgang Betz 132:51056160fa4a 14 * limitations under the License.
Wolfgang Betz 132:51056160fa4a 15 */
Wolfgang Betz 132:51056160fa4a 16
Wolfgang Betz 132:51056160fa4a 17
Wolfgang Betz 132:51056160fa4a 18 // utility functions
Wolfgang Betz 132:51056160fa4a 19
Wolfgang Betz 132:51056160fa4a 20 #ifndef __UTIL_H__
Wolfgang Betz 132:51056160fa4a 21 #define __UTIL_H__
Wolfgang Betz 132:51056160fa4a 22
Andrea Palmieri 226:be2f4e1d0515 23 #include "ble_status.h"
Wolfgang Betz 132:51056160fa4a 24 #include "hal_types.h"
Vincent Coubard 278:a5209d8cfd61 25 #ifdef YOTTA_CFG_MBED_OS
Vincent Coubard 278:a5209d8cfd61 26 #include "mbed-drivers/mbed.h"
Vincent Coubard 278:a5209d8cfd61 27 #else
Vincent Coubard 278:a5209d8cfd61 28 #include "mbed.h"
Vincent Coubard 278:a5209d8cfd61 29 #endif
Wolfgang Betz 132:51056160fa4a 30
Wolfgang Betz 132:51056160fa4a 31 #define STORE_LE_16(buf, val) ( ((buf)[0] = (uint8_t) (val) ) , \
Wolfgang Betz 132:51056160fa4a 32 ((buf)[1] = (uint8_t) (val>>8) ) )
Wolfgang Betz 132:51056160fa4a 33
Wolfgang Betz 132:51056160fa4a 34 #define STORE_LE_32(buf, val) ( ((buf)[0] = (uint8_t) (val) ) , \
Wolfgang Betz 132:51056160fa4a 35 ((buf)[1] = (uint8_t) (val>>8) ) , \
Wolfgang Betz 132:51056160fa4a 36 ((buf)[2] = (uint8_t) (val>>16) ) , \
Wolfgang Betz 132:51056160fa4a 37 ((buf)[3] = (uint8_t) (val>>24) ) )
Wolfgang Betz 132:51056160fa4a 38
Wolfgang Betz 132:51056160fa4a 39 #define COPY_UUID_128(uuid_struct, uuid_15, uuid_14, uuid_13, uuid_12, uuid_11, uuid_10, uuid_9, uuid_8, uuid_7, uuid_6, uuid_5, uuid_4, uuid_3, uuid_2, uuid_1, uuid_0) \
Wolfgang Betz 132:51056160fa4a 40 do {\
Wolfgang Betz 132:51056160fa4a 41 uuid_struct[0] = uuid_0; uuid_struct[1] = uuid_1; uuid_struct[2] = uuid_2; uuid_struct[3] = uuid_3; \
Wolfgang Betz 132:51056160fa4a 42 uuid_struct[4] = uuid_4; uuid_struct[5] = uuid_5; uuid_struct[6] = uuid_6; uuid_struct[7] = uuid_7; \
Wolfgang Betz 132:51056160fa4a 43 uuid_struct[8] = uuid_8; uuid_struct[9] = uuid_9; uuid_struct[10] = uuid_10; uuid_struct[11] = uuid_11; \
Wolfgang Betz 132:51056160fa4a 44 uuid_struct[12] = uuid_12; uuid_struct[13] = uuid_13; uuid_struct[14] = uuid_14; uuid_struct[15] = uuid_15; \
Wolfgang Betz 132:51056160fa4a 45 }while(0)
Wolfgang Betz 132:51056160fa4a 46
Wolfgang Betz 132:51056160fa4a 47
Andrea Palmieri 226:be2f4e1d0515 48 tBleStatus getHighPowerAndPALevelValue(int8_t dBMLevel, int8_t& EN_HIGH_POWER, int8_t& PA_LEVEL);
Wolfgang Betz 132:51056160fa4a 49
Wolfgang Betz 132:51056160fa4a 50 #endif // __UTIL_H__
Vincent Coubard 278:a5209d8cfd61 51