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/platform/btle.h@281:bc99b05605cb, 2016-09-15 (annotated)

Committer:
Vincent Coubard
Date:
Thu Sep 15 10:51:48 2016 +0100
Branch:
5a8c536877c89e2aef63a0b02fd587ead0fd6fca
Revision:
281:bc99b05605cb
Parent:
273:00205952d841 
Sync with 5a8c536877c89e2aef63a0b02fd587ead0fd6fca



2016-07-28 15:34:16+02:00: Andrea Palmieri

Update include



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 #ifndef _BTLE_H_
Wolfgang Betz 132:51056160fa4a 19 #define _BTLE_H_
Wolfgang Betz 132:51056160fa4a 20
Wolfgang Betz 132:51056160fa4a 21
Wolfgang Betz 132:51056160fa4a 22 #ifdef __cplusplus
Wolfgang Betz 132:51056160fa4a 23 extern "C" {
Wolfgang Betz 132:51056160fa4a 24 #endif
Wolfgang Betz 132:51056160fa4a 25
Wolfgang Betz 132:51056160fa4a 26 #include <stdio.h>
Wolfgang Betz 132:51056160fa4a 27 #include <string.h>
Vincent Coubard 266:b49e28134d83 28
Vincent Coubard 281:bc99b05605cb 29 #include "ble_hci.h"
Vincent Coubard 266:b49e28134d83 30 #include "bluenrg_aci.h"
Vincent Coubard 281:bc99b05605cb 31 #include "ble_hci_const.h"
Wolfgang Betz 132:51056160fa4a 32 #include "bluenrg_hal_aci.h"
Vincent Coubard 266:b49e28134d83 33 #include "stm32_bluenrg_ble.h"
Wolfgang Betz 132:51056160fa4a 34 #include "bluenrg_gap.h"
Wolfgang Betz 132:51056160fa4a 35 #include "bluenrg_gatt_server.h"
Wolfgang Betz 132:51056160fa4a 36
Wolfgang Betz 132:51056160fa4a 37 extern uint16_t g_gap_service_handle;
Wolfgang Betz 132:51056160fa4a 38 extern uint16_t g_appearance_char_handle;
Wolfgang Betz 132:51056160fa4a 39 extern uint16_t g_device_name_char_handle;
Vincent Coubard 266:b49e28134d83 40 extern uint16_t g_preferred_connection_parameters_char_handle;
Vincent Coubard 266:b49e28134d83 41
Vincent Coubard 271:7dc6261c33e5 42 void btleInit(void);
Wolfgang Betz 132:51056160fa4a 43 void SPI_Poll(void);
Wolfgang Betz 132:51056160fa4a 44 void User_Process(void);
Wolfgang Betz 132:51056160fa4a 45 void setConnectable(void);
Andrea Palmieri 219:d8e8cd4d4521 46 void setVersionString(uint8_t hwVersion, uint16_t fwVersion);
Andrea Palmieri 219:d8e8cd4d4521 47 const char* getVersionString(void);
Andrea Palmieri 219:d8e8cd4d4521 48 tBleStatus btleStartRadioScan(uint8_t scan_type,
Andrea Palmieri 219:d8e8cd4d4521 49 uint16_t scan_interval,
Andrea Palmieri 219:d8e8cd4d4521 50 uint16_t scan_window,
Andrea Palmieri 219:d8e8cd4d4521 51 uint8_t own_address_type);
Wolfgang Betz 132:51056160fa4a 52
Vincent Coubard 264:1e754a01869e 53
Wolfgang Betz 134:d2f8d5898d04 54 extern int btle_handler_pending;
Wolfgang Betz 133:1bb8df697f7f 55 extern void btle_handler(void);
Wolfgang Betz 133:1bb8df697f7f 56
Wolfgang Betz 132:51056160fa4a 57 #ifdef __cplusplus
Wolfgang Betz 132:51056160fa4a 58 }
Wolfgang Betz 132:51056160fa4a 59 #endif
Wolfgang Betz 132:51056160fa4a 60
Vincent Coubard 266:b49e28134d83 61 #endif