|
Coming soon |
1. Demo description
The demo shows data from wireless sensors connected to a concentrator. The sensors and the concentrator are based on STM32WL boards. The concentrator is connected with serial port to STM32CubeMonitor to display the data from sensors.
There is one concentrator, and up to 15 sensors.
When the demo starts, the concentrator is configured with the region information to select the correct frequency to use.
Then, the concentrator will broadcast beacons and the the sensors will send the data (voltage, temperature).
Beacons are short messages sent periodically by the concentrator to synchronize the sensors. Beacons allow the sensors to identify which band should be used, and when the data should be sent.
2. How to use the Demo
2.1. Configuration
2.1.1. Board configuration
The software "Demo_Concentrator" must be loaded in the concentrator. The concentrator must be connected to computer with an usb cable.
The sensors devices must be loaded with software "Demo_Sensor".
The Nucleo software are available in STM32CubeWL FW Package, in the path Projects\NUCLEO-WL55JC\Demonstrations\LocalNetwork\Concentrator and Projects\NUCLEO-WL55JC\Demonstrations\LocalNetwork\Sensor.
2.1.2. STM32CubeMonitor configuration
- The version 1.1.0 or above of STM32CubeMonitor is required. It can be downloaded on www.st.com/stm32cubemonitor . Detailed instructions are in the wiki.
- Import the Wireless Long range Demo flow. Go in the top right menu, select import, then "select a file to import" and open the WLR_demo.json file.
- Remove the default flow (Basic_Flow). Double click on the "Basic_Flow" tab to open the properties, and click on "delete" button.
- Click on DEPLOY button
2.1.3. Connection to computer
Connect the concentrator board to the computer. Open the the "Serial port configuration" tab. This tab is used to configure the serial port
Open the « SERIAL IN » node and click on the pencil to edit the Serial Port configuration. Click on the search icon at right of “Serial Port” box to display the list of connected serial ports. Select the concentrator COM port. Set the baud rate to 9600 bps. Other parameters don’t need to be changed. Click on “Add/Update” button : the Serial-port configuration is ready. Open the “SERIAL OUT” node and check the Serial-port configuration. The serial port is configured. Click on DEPLOY button
2.2. Start the demo
Open the demo with “Dashboard” button.
Select the Region and subRegion and then press start. The sensor list is displayed and will be updated when data are received.
2.3. Data visualization
The list of detected sensors and the collected data are displayed in the Sensor List. For each sensor a "Sensor panel" will display charts. The serial log panel shows the AT commands exchanged with the concentrator.
2.3.1. The sensor List
For each sensor, the table shows :
- EUI : Sensor unique identifier
- Packets received : Number of packets received from this sensor
- Packets missed : The sensor increases the packet ID for each packet sent. If there is a gap between previous packet Id and the current one, it means some packets have been lost. This is counted in "missed packets".
- RSSI : Received Signal Strength Indicator : Shows the level of power received
- PER : Packet Error Rate : Gives the % of lost packets. 0 if perfect.
- SNR : Signal to Noise Ratio : Gives an indication of signal quality. An high value is better.
- Temp : Sensor temperature value. (Use STM32 internal temperature sensor)
- Voltage : Power supply voltage. Should be around 3.3V when board is USB powered.
The "COUNTER RESET" button sets to 0 the number of received packets, the missed packets and the PER.
The "RESTART" button allows to reset the concentrator and goes back to Region selection page.
2.3.2. Serial log panel :
The Serial port log shows the AT commands sent to the concentrator (left arrow), and the answers (right arrow). The time stamp is the local time.
When the Auto Scroll switch is on, the log scrolls down automatically to display the new lines received. The button clear Log empties the log windows.
2.3.3. Sensor panels :
The "Sensor x" panels are added when sensors are detected. The panels can be opened by clicking on the sensor list or with the blue arrows on the top right of the panels. Each Panel shows the temperature and the RSSI values in a chart and displays the voltage in a gauge.
3. Explaining the flow
The user don't need to understand how the flows works to use the demo : the only nodes to configure are the "serial in" and "serial out". Nevertheless, some users may need to change charts size or add elements. In this case, the flow can be modified freely. The flows and details to customize the demo are described in this page : How_to_customize_STM32_Wireless_Long_Range_demo
4. AT commands details
The AT commands listed below are used for the demo dashboard
4.1. Concentrator reset and config :
- ATZ : Resets the board.
- AT+REGION=x : Defines the region.
- AT+SUBREGION=x : Defines the subregion.
- AT+BEACON_ON : Starts the beacon broadcast.
4.2. sensor status :
The concentrator sends the data received from sensors in notifications : AT+RCV. Exemple : AT+RCV=0x00004e1c,0x10,1:0,-35,6,+30.00,3.30 Format of the message is :
- AT+RCV= : At command name
- 0x00004e1c : Sensor EUI
- 0x10 : number of packet transmitted by the sensor.
- 1:0 : sensor software version.
- -35 : RSSI level
- 6 : SNR
- +30.00 : sensor temperature (inside MCU)
- 3.30 : sensor voltage