STMicroelectronics STEVAL-IDI004V2 868 MHz Wireless Bridge User manual
Werbung
Werbung
UM1990
User manual
Wireless Bridge 868 MHz
Introduction
This user manual explains the functionality of the STM32-based Wireless Bridge (STEVAL-IDI004V2), which can be used for various home building automation, Smart city, IoT and industrial applications.
Figure 1: Wireless Bridge 868 MHz
Figure 2: Wireless Bridge
The STEVAL-IDI004V2 board supports the following communication protocols, Wi-Fi module:
1. Wi-Fi communication @ 2.4 GHz IEEE 802.11 b/g/n using SPWF01SA module
2. Sub-GHz communication @ 868 MHz low power RF using SP1ML-868 6LoWPAN Contiki 3.0
3. Bluetooth communication @ 2.4 GHz, v3.0 compliant using STBT2632C2A module
4. NFC communication @ 13.56 MHz using CR95HF
May 2016 DocID028662 Rev 3 1/29
www.st.com
Contents
Contents
UM1990
1 System overview ............................................................................ 3
2 Getting started ................................................................................ 5
Power up sequence ......................................................................... 5
Application testing ............................................................................ 5
3 Android application ........................................................................ 6
Installing Android application............................................................ 6
Communication over Bluetooth ........................................................ 6
4 Configuration utility ..................................................................... 14
Wireless Bridge configuration utility installation.............................. 14
Features supported ........................................................................ 16
Utility usage.................................................................................... 16
Home page ...................................................................................... 16
Wireless bridge settings .................................................................. 18
Node registration ............................................................................. 18
Debug trace mode: .......................................................................... 20
5 Firmware Updating and Flashing ................................................ 22
STM32 MICROCONTROLLER (U4) .............................................. 22
Using SWD: ..................................................................................... 22
Using DFU through USB: ................................................................ 22
SPIRIT1 Module (U5) ..................................................................... 24
6 ST CloudBridge ............................................................................ 25
7 Reference documents .................................................................. 27
8 Revision history ........................................................................... 28
2/29 DocID028662 Rev 3
UM1990
1
System overview
System overview
The system STM32F103 microcontroller functions as the bridge between various communications modules. The Wi-Fi, Bluetooth and Sub GHz modules are connected via
UART to the STM32, while the NFC transceiver module is connected via SPI.
The board requires a 5 V, 1 A wall adapter for power, and a USB Micro B-Type connector can interface the board to the PC.
Figure 3: Wireless Bridge WiFi/NFC/BT/RFSubGHz scenario
When the board is connected to a PC via USB, Wi-Fi configuration parameters and the mesh node configuration can be programmed through a PC GUI application and debug log messages can be collected through the same GUI.
The sensor data from any node in the mesh network (Contiki 3.0 6LoWPAN) is accessible through the android application as well as through a Cloud based application at the website
(http://cloudbridge.azurewebsites.net/) using the Wi-Fi interface.
The board is powered through a 5 V, 1 A wall adapter, and the status of various communication interfaces is indicated by five LEDs on the board.
The RF nodes that can be connected by RF SubGHz 6LoWPAN in the Wireless Bridge are
STEVAL-IDI003V2+STEVAL-IDI002V2.
Figure 4: STEVAL-IDI003V2 + STEVAL-IDI002V2 boards
DocID028662 Rev 3 3/29
System overview
The Wireless Bridge board are embedding the following RF modules:
UM1990
Sub-GHz RF module: SP1ML-868
868 MHz ETSI-certified module
Based on sub-GHz SPIRIT1 transceiver, STM32L1 ULP MCU and balun (BALF-
SPI-01D3)
Chip antenna
Simple AT command
Wi-Fi module: SPWF01SA.11
2.4 GHz IEEE 802.11 b/g/n Wi-Fi
Pre-certified RF module (FCC, IC, CE)
Integrated TCP/IP
AT commands
TLS/SSL for end-to-end security
Over-the-air firmware updates
BT Classic module: SPBT2632
Bluetooth® Classic 3.0 version
Embedded firmware, including Bluetooth stack and profile, SPP and iAP profiles
AT commands
CE, FCC, IC, TELEC certified
Low-power mode supported
As alternative for RF node can be used x-NUCLEO board, using combination of NUCLEO-
L152RE, X-NUCLEO-IDS01A4 and, X-NUCLEO-IDB05A1.
Figure 5: X-NUCLEO RF 6LoWPAN node
4/29 DocID028662 Rev 3
UM1990
2 Getting started
2.1
Getting started
Power up sequence
Short pins 2 and 3 of jumper J13 (BOOT0 pin of STM32F103REx U4) using a 2 pin header.
Connect a 5 V adapter to the Power Jack (J3).
LED D4 (PWR/ERR) glows red for a second and then flashes red and orange every second. Also, LED D3 (Wi-Fi) starts blinking to indicate Wi-Fi communication.
Figure 6: Wireless Bridge board
2.2 Application testing
During correct initialization, LED D4 remains red for a few seconds and then start toggling every second between red and orange. If the LED stops toggling, it means the firmware is stuck in a routine, which the independent microcontroller watchdog will eventually reset and the firmware will reboot.
LED D3 (Wi-Fi) indicates Wi-Fi communication and flashes whenever there is some communication over the Wi-Fi.
LED D5, D7 and D8 remain off.
The SP1ML-868 module regularly seeks sensor nodes in the 6LoWPAN and, when one is detected, D5 turns on and continues to flash while a valid sensor node remains detected by the Wireless Bridge board. If D5 stays on without flashing, it indicates a stuck routine and the module will be reset by the watchdog routine.
The firmware regularly scans for any NFC tags in range and, as soon as one is detected, D8 turns on and remains on while the tag remains in the detectable range of the Wireless Bridge board.
DocID028662 Rev 3 5/29
Android application
3 Android application
3.1
3.2
UM1990
Installing Android application
1. Save the apk in the phone memory.
2. Download a file explorer from Google Play Store; an example is ES File Explorer
(https://play.google.com/store/apps/details?id=com.estrongs.android.pop&hl=en) .
3. Use the file explorer to locate and install the apk on the phone.
The application works best on Nexus S, Nexus 4 and Nexus 7 phones and tablets.
Communication over Bluetooth
Install the Wireless Bridge Android Application on the Android phone
(WirelessBridge.apk available on st.com)
Once installed, launch the application on the mobile phone as shown in
Figure 7: Wireless Bridge application
6/29
If the Bluetooth radio is not switched on, the application asks for permission to switch on the radio, otherwise the application will exit.
The figure below shows the Wireless Bridge Application. Click on the settings on the
Application or on the icon provided on the mobile (depending on the mobile version) to connect to the BT module of the Wireless Bridge.
DocID028662 Rev 3
UM1990
Figure 8: Wireless Bridge application main view
Android application
A dialog pops-up, asking the user to scan the BT modules available and select the
Wireless Bridge to connect with. If the BT module is has already been seen, then the user does not need to scan devices.
Figure 9: List of available BT devices
DocID028662 Rev 3 7/29
Android application
When the user selects the BT module, the application signals when the module
UM1990
connects.
As soon as the BT module on Wireless Bridge board is connected to the smart phone's BT interface, LED D7 turns on and stays on for as long as the connection between the Bluetooth devices remains live.
To proceed, the user needs to click on the center of the application, as shown in
Figure 10: Click to proceed
The Wireless Bridge provides nodes connected via 6LoWPAN and NFC protocols.
The application allows you to select the connectivity protocol and proceed as shown in
. Data exchange takes place over Bluetooth communication.
8/29 DocID028662 Rev 3
UM1990
Figure 11: User options
Android application
The user needs to set the channel ID for the Wireless Bridge board and Sensor Node.
The channel Id should be same for both sets of boards. The channel ID for the
Wireless Bridge board can be set by selecting the channel ID and pressing the "Write" button. To set the channel ID for the Sensor Node, the user needs to bring the sensor node near the NFC antenna. The figure below shows the option to set the channel ID for Wireless Bridge board and Sensor Nodes.
DocID028662 Rev 3 9/29
Android application
Figure 12: Channel settings
UM1990
When the user selects 6LoWPAN nodes, the Application lists the nodes connected to
the Wireless Bridge as shown in the
Figure 13: Sensor nodes discovered
10/29
The user needs to select the node's IP address to see the sensor values for each
Figure 13: "Sensor nodes discovered"
DocID028662 Rev 3
UM1990
Figure 14: Sensor nodes data
Android application
The user can also set the time interval for reading the sensor values of the nodes, as
Figure 14: "Sensor nodes data"
Figure 15: Setting of Interval
The application lets you name each sensor node. Just hold down over the IP address to reveal a dialog box to set the name, as show below.
DocID028662 Rev 3 11/29
Android application
Figure 16: Set Alias name
UM1990
Once set, the node is represented by its name, as shown below.
Figure 17: Alias name
12/29
You can choose to show nodes either by their assigned names or their IP addresses.
If you choose names, the IP address will still appear if the name has not been set.
DocID028662 Rev 3
UM1990
Figure 18: Different option to user
Android application
The Sensor nodes also have NFC Passive Tags. The passive tag stores the sensor values for each node. If the 6LoWPAN network is not available, you can read the
values of sensor nodes by selecting "NFC Nodes" in
Figure 18: "Different option to user"
. Communication between the Android App and the Wireless Bridge is via
Bluetooth.
Figure 19: Sensor data via NFC
DocID028662 Rev 3 13/29
Configuration utility
4 Configuration utility
UM1990
The configuration utility is a software application which you can use for initial configuration tasks and debugging the Wireless Bridge.
4.1 Wireless Bridge configuration utility installation
Figure 20: Start setup package installation
Figure 21: Accept the license agreement
14/29 DocID028662 Rev 3
UM1990
Figure 22: Enter your information
Configuration utility
Figure 23: Set the relevant path
Figure 24: Installation confirmation
DocID028662 Rev 3 15/29
Configuration utility
4.2 Features supported
UM1990
The configuration utility provides following features:
Node registration: is used to introduce new nodes in the system. The Wireless
Bridge gateway uploads the sensor data to the CloudBridge server. To upload this data, write keys from the CloudBridge system must sent with every request. Similarly, the gateway occasionally reads the sensor threshold data from the server. For reading, data read API keys are required. Each node has dedicated data. These streams and keys must be created on the CloudBridge account associated with the
Wireless Bridge and the keys must be programmed in the Wireless Bridge to allow it to communicate with the CloudBridge platform. The Wireless Bridge Configuration utility automates this process. The automatic generation of new channels for the new code along with generation and subsequent programming of new keys is called node registration.
Wi-Fi Settings: allows reading and writing SSID and Wi-Fi passwords from the
Wireless Bridge.
Debug Interface: in this mode, the utility enables trace mode and shows all the traces received from the Gateway to help in debugging/diagnostics.
Firmware Upgrade: this feature shall be supported in future versions of the Wireless
Bridge and the Configuration Utility and will allow the updating of the primary Gateway firmware or the firmware of various subsystems.
4.3
4.3.1
Utility usage
Home page
Once you have installed the Wireless Bridge Configuration utility, you can see the shortcut to start the application in the start menu. To start using this utility please follow these steps:
Install the STMicroelectronics Virtual COM Port Driver. You should find the setup file for the driver in the application installation folder.
Connect the Wireless Bridge to a free USB port. You need a USB-mini cable for this.
Power-up your Sensor nodes (sensors etc.)
Launch the Wireless Bridge Configuration Utility Tool
16/29 DocID028662 Rev 3
UM1990
Figure 25: Wireless bridge configuration utility tool
Configuration utility
Click on the plug icon to initiate the connection. The application will automatically detect the
VCOM port (virtual) on which your device is connected. If you have plugged in multiple devices using STMicroelectronics Virtual COM Port Driver, you will need to choose from a list of ports. Note that you can only connect one Wireless Bridge device at a time.
Once connected, the ID of the board is displayed at the top of the Utility page, as shown in the figure below.
Figure 26: Wireless bridge utility connected to board
DocID028662 Rev 3 17/29
Configuration utility
4.3.2 Wireless bridge settings
UM1990
Wi-Fi Configuration: you need to configure the Wireless Bridge with correct SSID and Password to access the internet via your home Wi-Fi router.
Click the Wi-Fi configuration buttonto show a screen like the figure below.
Enter the correct SSID and security key of your home Wi-Fi router, and click on the "Write" button . A confirmation message would be displayed if the values are
written successfully as shown in
Figure 28: "Node registration"
Similarly you can read the values programmed in the Wireless Bridge by clicking the "Read" button.
Sub-GHz Channel Configuration: the Sensor nodes and the Wireless Bridge must be on the same channel in order to communicate with each other and you need to ensure that your channel is not same as any other gateway operating in the vicinity.
First set the Wireless Bridge channel by selecting the gateway radio button
(Default selection) and clicking "Write".
Now align the NFC antenna of the Wireless Bridge with the sensor node.
Click the "Read" button to ensure that the communication is established.
Using the same channel number as used by gateway, select the "Node" radio box and click 'Write".
Now power on the sensor node for the changes to take effect.
Bluetooth Device Name: allows you to set the Bluetooth device name of your
Wireless Bridge. The Bluetooth device name is the name which is displayed when you search for Bluetooth devices from your phone/computer.
Figure 27: Read/Write gateway settings
4.3.3
18/29
Node registration
The Wireless Bridge logs your sensor values to the CloudBridge website for remote viewing. Before the gateway can affect these changes, data channels should be created for each node on the CloudBridge site. Also, the API Keys should be programmed into the
Gateway to enable identification and communication with the CloudBridge platform. The utility simplifies configuration by automating these actions.
Click on the "Node Registration" icon to open the page shown below.
DocID028662 Rev 3
UM1990
Figure 28: Node registration
Configuration utility
To configure your nodes:
Create an account on the CloudBridge platform website
(http://cloudbridge.azurewebsites.net)
Click read button to read all the active and registered nodes
Active nodes: are currently connected to the Wireless Bridge. The node automatically connects to the Wireless Bridge once powered on. You should power on the Wireless Bridge before the nodes during configuration.
Configured node: are the nodes which are linked to the CloudBridge platform and also have their access keys stored the Wireless Bridge.
When you connect your nodes for the first time, they appear as Active (New/Unregistered nodes).
Click the "Web Registration" button to automatically register the nodes, as per the figure below.
DocID028662 Rev 3 19/29
Configuration utility
Figure 29: CloudBridge Login
UM1990
4.3.4
Enter your CloudBridge platform credentials. If the login is successful, the nodes are registered.
Click on the tools icon to view the registration information of any node.
The current version of the utility does not support internet access through proxies, so you must ensure that the machine is not behind a proxy server for the
"Web Registration" feature to work. You may also need to configure your firewall to allow the application to access the internet.
The "Clear Node Data" button clears the Wireless Bridge, so if you run this command, you must perform the registration again. The bin icon option only deletes the local registration data stored on the Wireless Bridge. No data stored in the CloudBridge platform server is deleted.
Debug trace mode:
This mode is meant for advanced users, with the application showing the trace messages received from the Wireless Bridge.
Meanwhile the Debug Trace Mode is active, the sensor parameters will be NOT showed on BT connection (using APP Android) or ST-CLOUD. Please, close
Debug Trace Mode to use Android APP or CLOUD.
20/29 DocID028662 Rev 3
UM1990
Figure 30: Log data
Configuration utility
The About button option displays the application information, as depicted below.
Figure 31: About information screen
DocID028662 Rev 3 21/29
Firmware Updating and Flashing
5 Firmware Updating and Flashing
5.1
5.1.1
5.1.2
UM1990
STM32 MICROCONTROLLER (U4)
Using SWD:
Use the following steps to update the microcontroller firmware
Download and install STM32 ST-LINK utility on the PC
(http://www.st.com/web/en/catalog/tools/PF258168).
Connect an SWD connector on J11 and launch the ST Link utility.
Download both the microcontroller firmware (Wireless_Bridge_vxx.hex @ address
0x08003000 and Wireless_Bridge_DFU.hex @ address 0x0800000).
After successful programming, remove the SWD connector (Hex files are available with the release package).
Reset the microcontroller by pressing the SW2 (Reset) switch.
Using DFU through USB:
This option allows you to update the Wireless Bridge firmware through the configuration utility. Ensure that the ST DFU utility
(http://www.st.com/web/catalog/tools/FM147/CL1794/SC961/SS1533/PF257916#) is installed on the system before using this option. You need a .dfu firmware update file supplied by STMicroelectronics. Also ensure that the backup process is not interrupted by power failure or cable disconnection, as this would corrupt the Wireless
Bridge firmware and render it useless. If this occurs, you must reprogram the device through the SWD interface.
Only use this feature if you are confident that you know what you are doing.
Connect USB Cable - 2.0 A Male to Micro B between PC and board (J2).
Open the PC GUI and click on Connect/Disconnect Icon to connect the application to the board by opening the corresponding VCOM port.
22/29 DocID028662 Rev 3
UM1990
Firmware Updating and Flashing
Figure 32: Select the Firmware upgrade option
Select Firmware upgrade to show the following window.
Figure 33: Browse dfu file
Browse to the location of the .dfu file (provided with the package) and click Update to initiate the firmware update process.
DocID028662 Rev 3 23/29
Firmware Updating and Flashing
Figure 34: Updating firmware
UM1990
5.2
Reset the microcontroller by pressing the SW2 (Reset) switch.
SPIRIT1 Module (U5)
The spirit module SP1ML-868 is connected to U5.
A reset switch SW2 is provided to reset SPIRIT module firmware.
A SWD connector (J11) is provided to upgrade the SPIRIT firmware using ST link or J-
Link.
24/29 DocID028662 Rev 3
UM1990
6
ST CloudBridge
ST CloudBridge
ST-CloudBridge is a generic Internet of Things (IoT) platform to complement ST Wireless
Bridge. The application runs on the Microsoft® Azure cloud platform and allows users to quickly get started with the Wireless Bridge without requiring their own server implementation.
The key features are:
HTTP REST API
Data can be returned to the clients in XML/JSON formats
Can act as a backend for clients based on Web, Android and iOS
Web sockets for real-time data communication
Intuitive visualization of sensor data
Demonstrate the control of remote nodes via cloud
Users can create their own account at http://cloudbridge.azurewebsites.net.
Figure 35: New user account page
Users can then register their sensor nodes on the platform with the Wireless Bridge
Configuration Utility and subsequently log into the platform to view the data received from the sensors.
DocID028662 Rev 3 25/29
ST CloudBridge
Figure 36: Node list page
UM1990
After logging in, users are redirected to the Node list page where they can view all the nodes registered under the account.
Clicking on the View button associated with each node reveals the sensor data of that node. Similarly, the On and Off buttons send commands to each node (if supported by that node).
Figure 37: Sensor data feeds
26/29 DocID028662 Rev 3
UM1990
7
Reference documents
Reference documents
1. Serial-to-Wi-Fi b/g/n intelligent modules (DM00102124)
2. SPBT2632C2A data sheet (DM00050585.pdf)
3. SPIRIT1 868 and 915 MHz Low Power RF Modules preliminary datasheet
(SP1ML_DS_REV_0.8)
The above documents are available at www.st.com
DocID028662 Rev 3 27/29
Revision history
8 Revision history
Date
Table 1: Document revision history
Revision Changes
09-Dec-2015
18-Dec-2015
11-May-2016
1
2
3
UM1990
Initial release.
Updated title on the cover page. Added Wireless
Bridge 868 MHz.
Added:
Figure 4: "STEVAL-IDI003V2 + STEVAL-IDI002V2 boards"
Figure 5: "X-NUCLEO RF 6LoWPAN node"
28/29 DocID028662 Rev 3
UM1990
IMPORTANT NOTICE
– PLEASE READ CAREFULLY
STMicroelectronics NV and its subsidiaries (“ST”) reserve the right to make changes, corrections, enhancements, modifications, and improvements to ST products and/or to this document at any time without notice. Purchasers should obtain the latest relevant information on ST products before placing orders. ST products are sold pursuant to ST’s terms and conditions of sale in place at the time of order acknowledgement.
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’ products.
No license, express or implied, to any intellectual property right is granted by ST herein.
Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product.
ST and the ST logo are trademarks of ST. All other product or service names are the property of their respective owners.
Information in this document supersedes and replaces information previously supplied in any prior versions of this document.
© 2016 STMicroelectronics
– All rights reserved
DocID028662 Rev 3 29/29
Herunterladen
Öffentlicher Link aktualisiert
Der öffentliche Link zu Ihrem Chat wurde aktualisiert. Sie können Ihre Chat-Links nach der Registrierung hier einsehen und verwalten.
Öffentlicher Dokumentenlink
Werbung