ST FP-LIT-BLEMESH1 User Manual

Function pack for iot nodes with bluetooth® low energy mesh connectivity and lighting mode

Hide thumbs

Table Of Contents

Table of Contents

Quick Links

Download this manual

UM2992

User manual

Getting started with FP-LIT-BLEMESH1 function pack for IoT nodes with

Bluetooth® Low Energy mesh connectivity and lighting mode

Introduction

FP-LIT-BLEMESH1

is an

STM32Cube

function pack, which lets you connect Bluetooth® Low Energy nodes to a smartphone via

Bluetooth

Low Energy, through a suitable Android™ or iOS™ application or use the Ambient Light Sensor on

X-

NUCLEO-6283A1

to set the HSL values and send the data to the lighting hardware using the Bluetooth® Low Energy mesh

lighting model.

The software lets you easily create your own application for extending Bluetooth

mesh networks (by offering a ready-to-use

mesh core library), a complete set of compatible APIs, and a lighting demo application running on either

X-NUCLEO-IDB05A2

or X-NUCLEO-BNRG2A1,

X-NUCLEO-LED12A1

and

X-NUCLEO-6283A1

expansion boards connected to a

NUCLEO-L476RG

development board.

The software runs on the STM32 microcontroller and includes all the necessary drivers to recognize the devices on the

STM32

Nucleo

development board and the expansion boards.

Need help?

Do you have a question about the FP-LIT-BLEMESH1 and is the answer not in the manual?

Questions and answers

Summary of Contents for ST FP-LIT-BLEMESH1

Page 1 UM2992 User manual Getting started with FP-LIT-BLEMESH1 function pack for IoT nodes with Bluetooth® Low Energy mesh connectivity and lighting mode Introduction FP-LIT-BLEMESH1 is an STM32Cube function pack, which lets you connect Bluetooth® Low Energy nodes to a smartphone via ®...
Page 2: Acronyms And Abbreviations
UM2992 Acronyms and abbreviations Acronyms and abbreviations Table 1. List of acronyms Acronym Description GATT Generic attribute profile Board support package Hardware abstraction layer Serial peripheral interface CMSIS Cortex® microcontroller software interface standard Hue saturation lighting UM2992 - Rev 2 page 2/20...
Page 3: Fp-Lit-Blemesh1 Software Expansion For Stm32Cube
UM2992 FP-LIT-BLEMESH1 software expansion for STM32Cube FP-LIT-BLEMESH1 software expansion for STM32Cube Overview FP-LIT-BLEMESH1 software package expands STM32Cube functionality. The key features of the package are: • Complete software to build a mesh network with Bluetooth® Low Energy nodes supporting the Bluetooth®...
Page 4: Folder Structure
STM32 Nucleo development board NUCLEO-L476RG Folder structure Figure 2. FP-LIT-BLEMESH1 package folder structure The following folders are included in the software package: • Documentation: contains a compiled HTML file generated from the source code, which details the software components and APIs.
Page 5: Sample Application Description
UM2992 Sample application description Sample application description 2.5.1 Initialization of application callbacks The "Projects" directory provides an example application using the X-NUCLEO-IDB05A2 X-NUCLEO- BNRG2A1, X-NUCLEO-6283A1 X-NUCLEO-LED12A1 expansion boards with the NUCLEO-L476RG development board. Ready to be built projects are available for multiple IDEs. This application starts by initializing the callbacks required for the different events and functionalities.
Page 6: Initialization And Main Application Loop
UM2992 Sample application description The Model_SIG_cb structure is used to initialize the SIG models for the application implementation. The BluenrgMesh_SetSIGModelsCbMap(Model_SIG_cb, MODEL_SIG_COUNT); function is used to initialize the different callbacks in the library. 2.5.2 Initialization and main application loop This procedure develops an application for mesh over Bluetooth® Low Energy on the BlueNRG platforms. Step 1.
Page 7: Gatt Connection/Disconnection Node
UM2992 Sample application description Step 12. Initialize the ALS drivers and the GPIO mounted on the X-NUCLEO-6283A1. Process MX_X_CUBE_ALS_Process() is called in while(1) loop after the ALS is initialized and provisioning of node is done. The refresh rate of ALS is kept as ~5sec. For other nodes in the mesh network which do not use ALS expansion board X-NUCLEO-6283A1, MX_X_CUBE_ALS_Process(), will not be called.
Page 8: External Mac Address Utilities
UM2992 Sample application description Figure 3. Lighting model message flow The number of octets depends on the parameters dedicated for the model. They are different for each lighting model. The middle layer receives messages from the library. It then checks for the opcode according to the different application of the light model.
Page 9: System Setup Guide
STM32 microcontroller line. The Arduino connectivity support and ST morpho connectors make it easy to expand the functionality of the STM32 Nucleo open development platform with a wide range of specialized expansion boards to choose from.
Page 10: X-Nucleo-Idb05A2 Expansion Board
RF platform in a tiny form factor, with integrated radio, antenna, high frequency, and LPO oscillators. X-NUCLEO-IDB05A2 is compatible with the ST morpho (not mounted) and Arduino UNO R3 connector layout. X-NUCLEO-IDB05A2 interfaces with the STM32 microcontroller via the SPI pin and allows changing the default SPI clock, SPI chip select, and SPI IRQ by replacing a resistor on the expansion board.
Page 11: X-Nucleo-Bnrg2A1 Expansion Board
The expansion board features the Bluetooth v5.2 compliant and FCC certified BlueNRG-M2SP application processor module based on the ST BlueNRG-2 System-on-Chip. This SoC manages the complete Bluetooth® Low Energy stack and protocols on its Cortex-M0 core and programmable flash memory, which can accommodate custom applications developed using the SDK.
Page 12: X-Nucleo-Led12A1 Expansion Board
UM2992 Hardware description 3.1.4 X-NUCLEO-LED12A1 expansion board X-NUCLEO-LED12A1 LED driver expansion board for STM32 Nucleo features four LED1202 devices that can drive up to 48 LEDs. LED1202 is a 12-channel low quiescent current LED driver, which guarantees a 5 V output driving capability. Each channel is able to provide up to 20 mA with a headroom voltage of 350 mV (typical) only.
Page 13: Hardware Setup
• FP-LIT-BLEMESH1: an STM32Cube function pack for IoT node with Bluetooth® Low Energy mesh connectivity and lighting model. The firmware and related documentation are available on www.st.com. • Development tool-chain and compilers. The STM32Cube expansion software supports the three following environments to select from: ®...
Page 14: System Setup
UM2992 System setup System setup STM32 Nucleo board integrates the ST-LINK/V2-1 debugger/programmer. The developer can download the ST-LINK/V2-1 USB driver by looking for the STSW-LINK009 software on www.st.com. You can easily connect the X-NUCLEO-LED12A1 LED expansion board to the STM32 Nucleo through the Arduino UNO R3 extension connector.
Page 15: Appendix A References
UM2992 References Appendix A References Mesh over Bluetooth® Low Energy: STSW-BNRG-Mesh Bluetooth mesh networking specifications: https://www.bluetooth.com/specifications/mesh-specifications Bluetooth mesh model specification: https://www.bluetooth.com/specifications/adopted-specifications UM2992 - Rev 2 page 15/20...
Page 16: Revision History
UM2992 Revision history Table 2. Document revision history Date Revision Changes 25-Feb-2022 Initial release. Added reference to X-NUCLEO-6283A1. Updated Section Introduction, Section 2.1 Overview, Section 2.2 Architecture, Section 2.3 Folder structure, Section 2.5.1 Initialization of application 21-Jun-2023 callbacks, Section 2.5.2 Initialization and main application loop, Section 3.4 System setup.
Page 17: Table Of Contents
Acronyms and abbreviations ............2 FP-LIT-BLEMESH1 software expansion for STM32Cube ......3 Overview .
Page 18: List Of Tables
UM2992 List of tables List of tables Table 1. List of acronyms ..............2 Table 2.
Page 19: List Of Figures
FP-LIT-BLEMESH1 package folder structure ........
Page 20 ST’s terms and conditions of sale in place at the time of order acknowledgment. Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of purchasers’...