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
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/bluenrg-hci/bluenrg_updater_aci.h@307:fa98703ece8e, 2016-09-16 (annotated)
- Committer:
- Andrea Palmieri
- Date:
- Fri Sep 16 12:03:25 2016 +0200
- Revision:
- 307:fa98703ece8e
- Parent:
- 288:875b6f77d213
Sync with 21bfd161ace255bb6214d6b74cae1fd30b3e24c9
2016-09-16 11:53:47+02:00: Andrea Palmieri
Get rid of warnings
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
Wolfgang Betz |
132:51056160fa4a | 1 | /******************** (C) COPYRIGHT 2014 STMicroelectronics ******************** |
Wolfgang Betz |
132:51056160fa4a | 2 | * File Name : bluenrg_updater_aci.h |
Wolfgang Betz |
132:51056160fa4a | 3 | * Author : AMS - HEA&RF BU |
Wolfgang Betz |
132:51056160fa4a | 4 | * Version : V1.0.0 |
Wolfgang Betz |
132:51056160fa4a | 5 | * Date : 26-Jun-2014 |
Wolfgang Betz |
132:51056160fa4a | 6 | * Description : Header file with updater commands for BlueNRG FW6.3. |
Wolfgang Betz |
132:51056160fa4a | 7 | ******************************************************************************** |
Wolfgang Betz |
132:51056160fa4a | 8 | * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS |
Wolfgang Betz |
132:51056160fa4a | 9 | * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE TIME. |
Wolfgang Betz |
132:51056160fa4a | 10 | * AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY DIRECT, |
Wolfgang Betz |
132:51056160fa4a | 11 | * INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING FROM THE |
Wolfgang Betz |
132:51056160fa4a | 12 | * CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE CODING |
Wolfgang Betz |
132:51056160fa4a | 13 | * INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS. |
Wolfgang Betz |
132:51056160fa4a | 14 | *******************************************************************************/ |
Wolfgang Betz |
132:51056160fa4a | 15 | |
Wolfgang Betz |
132:51056160fa4a | 16 | #ifndef __BLUENRG_UPDATER_ACI_H__ |
Wolfgang Betz |
132:51056160fa4a | 17 | #define __BLUENRG_UPDATER_ACI_H__ |
Wolfgang Betz |
132:51056160fa4a | 18 | |
Vincent Coubard |
288:875b6f77d213 | 19 | #include <ble_compiler.h> |
Wolfgang Betz |
132:51056160fa4a | 20 | |
Wolfgang Betz |
132:51056160fa4a | 21 | /** |
Wolfgang Betz |
132:51056160fa4a | 22 | * @defgroup Updater Updater |
Wolfgang Betz |
132:51056160fa4a | 23 | * @brief Updater. |
Wolfgang Betz |
132:51056160fa4a | 24 | * @{ |
Wolfgang Betz |
132:51056160fa4a | 25 | */ |
Wolfgang Betz |
132:51056160fa4a | 26 | |
Wolfgang Betz |
132:51056160fa4a | 27 | /** |
Wolfgang Betz |
132:51056160fa4a | 28 | * @defgroup Updater_Functions Updater functions |
Wolfgang Betz |
132:51056160fa4a | 29 | * @brief API for BlueNRG Updater. |
Wolfgang Betz |
132:51056160fa4a | 30 | * @{ |
Wolfgang Betz |
132:51056160fa4a | 31 | */ |
Wolfgang Betz |
132:51056160fa4a | 32 | |
Wolfgang Betz |
132:51056160fa4a | 33 | tBleStatus aci_updater_start(void); |
Wolfgang Betz |
132:51056160fa4a | 34 | |
Wolfgang Betz |
132:51056160fa4a | 35 | tBleStatus aci_updater_reboot(void); |
Wolfgang Betz |
132:51056160fa4a | 36 | |
Wolfgang Betz |
132:51056160fa4a | 37 | tBleStatus aci_get_updater_version(uint8_t *version); |
Wolfgang Betz |
132:51056160fa4a | 38 | |
Wolfgang Betz |
132:51056160fa4a | 39 | tBleStatus aci_get_updater_buffer_size(uint8_t *buffer_size); |
Wolfgang Betz |
132:51056160fa4a | 40 | |
Wolfgang Betz |
132:51056160fa4a | 41 | tBleStatus aci_erase_blue_flag(void); |
Wolfgang Betz |
132:51056160fa4a | 42 | |
Wolfgang Betz |
132:51056160fa4a | 43 | tBleStatus aci_reset_blue_flag(void); |
Wolfgang Betz |
132:51056160fa4a | 44 | |
Wolfgang Betz |
132:51056160fa4a | 45 | tBleStatus aci_updater_erase_sector(uint32_t address); |
Wolfgang Betz |
132:51056160fa4a | 46 | |
Wolfgang Betz |
132:51056160fa4a | 47 | tBleStatus aci_updater_program_data_block(uint32_t address, uint16_t len, const uint8_t *data); |
Wolfgang Betz |
132:51056160fa4a | 48 | |
Wolfgang Betz |
132:51056160fa4a | 49 | tBleStatus aci_updater_read_data_block(uint32_t address, uint16_t data_len, uint8_t *data); |
Wolfgang Betz |
132:51056160fa4a | 50 | |
Wolfgang Betz |
132:51056160fa4a | 51 | tBleStatus aci_updater_calc_crc(uint32_t address, uint8_t num_sectors, uint32_t *crc); |
Wolfgang Betz |
132:51056160fa4a | 52 | |
Wolfgang Betz |
132:51056160fa4a | 53 | tBleStatus aci_updater_hw_version(uint8_t *version); |
Wolfgang Betz |
132:51056160fa4a | 54 | |
Wolfgang Betz |
132:51056160fa4a | 55 | /** |
Wolfgang Betz |
132:51056160fa4a | 56 | * @} |
Wolfgang Betz |
132:51056160fa4a | 57 | */ |
Wolfgang Betz |
132:51056160fa4a | 58 | |
Wolfgang Betz |
132:51056160fa4a | 59 | /** |
Wolfgang Betz |
132:51056160fa4a | 60 | * @defgroup Updater_Events Updater events |
Wolfgang Betz |
132:51056160fa4a | 61 | * @{ |
Wolfgang Betz |
132:51056160fa4a | 62 | */ |
Wolfgang Betz |
132:51056160fa4a | 63 | /** HCI vendor specific event, raised at BlueNRG power-up or reboot. */ |
Wolfgang Betz |
132:51056160fa4a | 64 | #define EVT_BLUE_INITIALIZED (0x0001) |
Wolfgang Betz |
132:51056160fa4a | 65 | typedef __packed struct _evt_blue_initialized{ |
Wolfgang Betz |
132:51056160fa4a | 66 | uint8_t reason_code; |
Wolfgang Betz |
132:51056160fa4a | 67 | } PACKED evt_blue_initialized; |
Wolfgang Betz |
132:51056160fa4a | 68 | /** |
Wolfgang Betz |
132:51056160fa4a | 69 | * @} |
Wolfgang Betz |
132:51056160fa4a | 70 | */ |
Wolfgang Betz |
132:51056160fa4a | 71 | |
Wolfgang Betz |
132:51056160fa4a | 72 | /** |
Wolfgang Betz |
132:51056160fa4a | 73 | * @} |
Wolfgang Betz |
132:51056160fa4a | 74 | */ |
Wolfgang Betz |
132:51056160fa4a | 75 | |
Wolfgang Betz |
132:51056160fa4a | 76 | |
Wolfgang Betz |
132:51056160fa4a | 77 | |
Vincent Coubard |
288:875b6f77d213 | 78 | #endif /* __BLUENRG_UPDATER_ACI_H__ */ |