1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
/**
@page MAC 802.14.4 FFD example
@verbatim
******************************************************************************
* @file Mac_802_15_4/Mac_802_15_4_FFD/readme.txt
* @author MCD Application Team
* @brief Example of application using MAC 802.15.4 protocols implementing
light 802.15.4 Coordinator services - FFD
******************************************************************************
*
* Copyright (c) 2019 STMicroelectronics. All rights reserved.
*
* This software component is licensed by ST under Ultimate Liberty license
* SLA0044, the "License"; You may not use this file except in compliance with
* the License. You may obtain a copy of the License at:
* www.st.com/SLA0044
*
******************************************************************************
@endverbatim
@par Application Description
How to use MAC 802.15.4 Association and Data exchange.
This application requires two STM32WB55xx-Nucleo boards. One device will act as
802.15.4 coordinator ensuring association response and network establishment.
The other device will act as a MAC 802.15.4 EFD - Node. The Node request
association on startup and send data to the coordinator.
Below example implements the FFD Devices.
@par Keywords
MAC, 802.15.4, association
@par Directory contents
Mac_802_15_4/Mac_802_15_4_FFD/
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/app_common.h Header for all modules with common definition
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/app_conf.h Parameters configuration file of the application
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/app_entry.h Parameters configuration file of the application
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/hw_conf.h Configuration file of the HW
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/main.h Header for main.c module
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/stm_logging.h Application header file for logging
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/stm32wbxx_hal_conf.h STM32 HAL configuration file.
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/stm32wbxx_it.h Interrupt handlers header file
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/utilities_conf.h Header for Configuration of utilities
- Mac_802_15_4/Mac_802_15_4_FFD/STM32_WPAN/App/app_ffd_mac_802_15_4_process.h Header for FFD MAC 802.15.4 processing tasks
- Mac_802_15_4/Mac_802_15_4_FFD/STM32_WPAN/App/app_ffd_mac_802_15_4.h Header for FFD MAC 802.15.4 Core Mac Device implementation
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/app_entry.c Parameters configuration file of the application
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/stm32_lpm_if.c Low Power Manager Interface
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/hw_uart.c UART Driver
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/main.c Main program
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/stm_logging.c Logging Implementation
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/stm32wbxx_it.c exceptions handler and peripherals interrupt service routine
- Mac_802_15_4/Mac_802_15_4_FFD/Core/Inc/system_stm32wbxx.c CMSIS Cortex Device Peripheral Access Layer implementation
- Mac_802_15_4/Mac_802_15_4_FFD/STM32_WPAN/App/app_ffd_mac_802_15_4_process.c FFD MAC 802.15.4 processing tasks implementation
- Mac_802_15_4/Mac_802_15_4_FFD/STM32_WPAN/App/app_ffd_mac_802_15_4.c FFD MAC 802.15.4 Core Mac Device implementation
@par Hardware and Software environment
- This example runs on STM32WB55xx devices.
- This example has been tested with an STMicroelectronics STM32WB55RG-Nucleo
board and can be easily tailored to any other supported device
and development board.
- On STM32WB55RG-Nucleo, the jumpers must be configured as described
in this section. Starting from the top left position up to the bottom
right position, the jumpers on the Board must be set as follows:
CN11: GND [OFF]
JP4: VDDRF [ON]
JP6: VC0 [ON]
JP2: +3V3 [ON]
JP1: USB_STL [ON] All others [OFF]
CN12: GND [OFF]
CN7: <All> [OFF]
JP3: VDD_MCU [ON]
JP5: GND [OFF] All others [ON]
CN10: <All> [OFF]
@par How to use it ?
This application requests having the stm32wb5x_Mac_802_15_4_fw.bin binary flashed on the Wireless Coprocessor.
If it is not the case, you need to use STM32CubeProgrammer to load the appropriate binary.
All available binaries are located under /Projects/STM32_Copro_Wireless_Binaries directory.
Refer to UM2237 to learn how to use/install STM32CubeProgrammer.
Refer to /Projects/STM32_Copro_Wireless_Binaries/ReleaseNote.html for the detailed procedure to change the
Wireless Coprocessor binary.
Minimum requirements for the demo:
- 1 STM32WB55xx-Nucleo board in MAC 802.15.4 FFD mode
using current generated binary.
(This device will be referred as COORDINATOR )
- 1 STM32WB55xx-Nucleo board in MAC 802.15.4 Node - EFD
(see MAC 802.14.4 EFD example)
(This device will be referred as NODE )
In order to make the program work, you must do the following:
- Connect 2 STM32WB55xx-Nucleo boards to your PC
COORDINATOR :
- Open your preferred toolchain
- Rebuild all files and load your image into
COORDINATOR target memory
- The example run on Reset
NODE :
- Refers to MAC 802.14.4 EFD example to build
and load generated image
if you want to get the traces in real time, you can connects an HyperTerminal
via an UART RS232 cable using the following connections :
RXD : CN10(Pin35)
TXD : CN10(Pin37)
The Serial interface must be configured as follows:
- BaudRate = 115200 baud
- Word Length = 8 Bits
- Stop Bit = 1 bit
- Parity = none
- Flow control = none
You can also use an MAC 802.15.4 other the air sniffer on channel 21 to spy
MAC 802.15.4 frames exchanged between the devices.
**** START DEMO ****
By default, after a reset, both board starts. Coordinator must be started firstly to be able to answer
to the node association request.
This MAC 802.15.4 example is to demonstrate Point-to-Point communication using MAC components between
a FFD (ie.: the COORDINATOR) and an EFD (ie.: the NODE).
Upon COORDINATOR start, the device initializes the MAC 802.15.4 and associates resources in non-beaconned
enable mode.
MAC PIB is then configured as follow :
PanID : 0x1AAA
Coordinator Extended Address : 0xACDE480000000001
Coordinator Short Address : 0x1122
Once MAC PIB is initialized, FFD is started on channel 21 as an association capable coordinator.
At this stage the COORDINATOR is waiting for an association request. Blue LED (ID 1) is switch on once
the coordinator is started.
On NODE side, the MAC layer is initialized on startup. In this state, blue LED (ID 1) is switch on.
EFD issues an association request to the COORDINATOR to retrieve its short address.
On in coming association request FFD's green LED (ID 2) blinks.
Once the association between two devices is completed, RFD's green LED (ID 2) is switch on to indicate the node
is associated to the coordinator.
The NODE sends data to the coordinator that issues a Data Indication.
On both devices side, on data transmission red led (ID 3) blinked.
User can issue data from EFD to FFD, by pressing the button 1 (SW1). Data transmission can be then observe using OTA sniffer,
UART logs and LED status.
If you want to restart the demo, simply reset the NODE.
* <h3><center>© COPYRIGHT STMicroelectronics</center></h3>
*/
|
