Updated description according to new firmware
New firmware for STM32 Nucleo (FP-CLD-AZURE1), released January 2017 (https://my.st.com/content/my_st_com/en/products/embedded-software/mcus-embedded-software/stm32-embedded-software/stm32-ode-function-pack-sw/fp-cld-azure1.license%3d1484564760538.html).
This commit is contained in:
EmanueleQuacchio
GitHub
Родитель
9e41b1728d
Коммит
300f9052ba
|
|
@ -16,7 +16,6 @@ Run a simple C sample on STM32 Nucleo
|
|||
- [Step 1: Prerequisites](#Prerequisites)
|
||||
- [Step 2: Prepare your Device](#PrepareDevice)
|
||||
- [Step 3: Build and Run the Sample](#Build)
|
||||
- [Tips](#tips)
|
||||
|
||||
|
||||
<a name="Introduction"></a>
|
||||
|
|
@ -29,6 +28,7 @@ This document describes how to connect STM32 Nucleo based sensor node to the Mic
|
|||
- Registering STM32 Nucleo to Azure IoT Hub
|
||||
- Build and deploy Azure IoT SDK on STM32 Nucleo
|
||||
|
||||
|
||||
<a name="Prerequisites"></a>
|
||||
# Step 1: Prerequisites
|
||||
|
||||
|
|
@ -46,9 +46,9 @@ You should have the following items ready before beginning the process.
|
|||
## 1.2 Hardware components
|
||||
- STM32 Nucleo development board ([NUCLEO-F401RE][lnk-nucleo-f4])
|
||||
- Wi-Fi expansion board for STM32 Nucleo ([X-NUCLEO-IDW01M1][lnk-nucleo-wifi])
|
||||
- Motion MEMS and environmental sensor expansion board for STM32 Nucleo ([X-NUCLEO-IKS01A1][lnk-nucleo-sensors])
|
||||
- Dynamic NFC tag expansion board for STM32 Nucleo ([X-NUCLEO-NFC01A1][lnk-nucleo-nfc])
|
||||
- NFC enabled Android phone to set SSID and Password of WiFi access point through a mobile application.
|
||||
- Motion MEMS and environmental sensor expansion board for STM32 Nucleo ([X-NUCLEO-IKS01A1][lnk-nucleo-sensors] or [X-NUCLEO-IKS01A2][lnk-nucleo-sensors2]).
|
||||
- Dynamic NFC tag expansion board for STM32 Nucleo (optional, [X-NUCLEO-NFC01A1][lnk-nucleo-nfc])
|
||||
- When the X-NUCLEO-NFC01A1 board is mounted, an NFC enabled Android phone is necessary to set SSID and Password of WiFi access point with a mobile application.
|
||||
|
||||
|
||||
<a name="PrepareDevice"></a>
|
||||
|
|
@ -66,45 +66,67 @@ Connect the STM32 Nucleo based sensor node to your PC using a mini USB cable.
|
|||
## 3.1 Build SDK and sample code
|
||||
|
||||
1. Download [FP-CLD-AZURE1 Function Pack][lnk-nucleo-fp]. The Function Pack contains all the required drivers to use the STM32 Nucleo board with Wi-Fi, Sensors and NFC expansion boards, together with pre-integrated Microsoft Azure IoT SDK.
|
||||
2. Unzip the package and open one of the pre-configured project files available in ```FP-CLD-AZURE1/Projects/Multi/Applications/HTTPS_AzureSDK_S2C```, according to the IDE installed. In [SystemWorkbench for STM32][lnk-ide-sw4stm32] select the project from menu ```File -> Import -> Existing Projects into Workspace```; browse folders and select as root directory ```FP-CLD-AZURE1/Projects/Multi/Applications/HTTPS_AzureSDK_S2C/SW4STM32/STM32F401RE-Nucleo```
|
||||
3. Open file AzureIOTSDKConfig.h and update AZUREIOTHUBCONNECTIONSTRING with the credentials retrieved when registering the device in IoT Hub as described in [Step 1.1][lnk-setup-iot-hub].
|
||||
4. Recompile the project, according to the chosen IDE, and flash the binary to the Nucleo board. In [SystemWorkbench for STM32][lnk-ide-sw4stm32] this can be done simply by clicking on Run button, as shown in picture below.
|
||||
2. Unzip the package and open one of the pre-configured project files available in ```AZURE1_F4_V2.0.0/Projects/Multi/Applications/HTTPS_Azure```, according to the IDE installed (for [SystemWorkbench for STM32][lnk-ide-sw4stm32] project files are inside folder ```SW4STM32```). In [SystemWorkbench for STM32][lnk-ide-sw4stm32] select the project from menu ```File -> Import -> Existing Projects into Workspace```; browse folders and select as root directory ```AZURE1_F4_V2.0.0/Projects/Multi/Applications/HTTPS_Azure/SW4STM32/STM32F401RE-Nucleo```.
|
||||
3. Open file ```AzureIOTSDKConfig.h``` (inside folder ```AZURE1_F4_V2.0.0/Projects/Multi/Applications/HTTPS_Azure/Inc```) and update ```AZUREIOTHUBCONNECTIONSTRING``` with the credentials retrieved after having registered the device in IoT Hub as described in [Step 1.1][lnk-setup-iot-hub].
|
||||
4. Build the project according to the selected IDE. In [SystemWorkbench for STM32][lnk-ide-sw4stm32], select the Build configuration with ```Project -> Build Configurations -> Set Active``` based on the sensors expansion board mounted; then select ```Project -> Build All``` (or shortcut ```Ctrl+B```).
|
||||
|
||||
![][2]
|
||||
|
||||
5. Flash the binary to Nucleo board according to the selected IDE. In [SystemWorkbench for STM32][lnk-ide-sw4stm32] select ```Run -> Run Configurations```; click on ```New launch configuration``` and select available configuration (X-NUCLEO-IKS01A1 or X-NUCLEO-IKS01A2); then in text box ```C/C++ Applications``` type in X-NUCLEO-IKS01A1\STM32F4xx-Nucleo.elf or X-NUCLEO-IKS01A2\STM32F4xx-Nucleo.elf depending on the configuration built; then click on Apply and Run.
|
||||
|
||||
![][5]
|
||||
|
||||
![][6]
|
||||
|
||||
|
||||
|
||||
## 3.2 Connect STM32 Nucleo board to a WiFi access point
|
||||
In order to set or to overwrite WiFi access point parameters (SSID and Password), keep pressed USER button in STM32 Nucleo after RESET. If SSID and Password were previously written to NFC, these will be read and used to connect with the Access Point. In order to pass parameters to NFC board, an Android mobile phone equipped with an NFC WriteTag application need to be used (i.e. you can install and use [ST25 application][lnk-android-st25] ). Alternatively WiFi parameters can be configured via Serial Terminal, or directly set in source code by replacing X_CLOUD_SSID, X_CLOUD_KEY in file AzureIOTSDKConfig.h.
|
||||
After first setting of WiFi parameters, these are permanently written to FLASH memory and used each time the board is RESET, unless USER button is kept pressed.
|
||||
|
||||
Configure your serial terminal with the following parameters to visualize log messages from Nucleo board:
|
||||
- BaudRate : 460800
|
||||
- Data : 8 bit
|
||||
- Parity : none
|
||||
- Stop : 1 bit
|
||||
- Flow Control : none
|
||||
|
||||
In order to set or to overwrite WiFi access point parameters (SSID and Password), keep pressed USER button in STM32 Nucleo after RESET. If NFC board is mounted and if SSID and Password were previously written to NFC with the mobile application, these will be read and used to connect with the Access Point. In order to copy parameters to NFC board, an Android mobile phone equipped with an NFC WriteTag application need to be used (i.e. you can install and use [ST25 application][lnk-android-st25] ).
|
||||
Alternatively WiFi parameters can be configured via serial terminal, or directly set in source code by replacing ```X_CLOUD_SSID```, ```X_CLOUD_KEY``` in file ```AzureIOTSDKConfig.h```.
|
||||
After first time WiFi parameters are set, these are permanently written to FLASH memory and used each time the board is RESET, unless USER button is kept pressed.
|
||||
|
||||
![][3]
|
||||
|
||||
LED2 onboard Nucleo is turned on once connection with Azure IoT Hub is established.
|
||||
|
||||
![][4]
|
||||
|
||||
## 3.3 Send Device Events to IoT Hub:
|
||||
|
||||
After connection with a WiFi Access Point, the application contacts Azure IoT Hub using HTTPS protocol and it starts to transmit sample data read from sensor board (motion MEMS, temperature, pressure, humidity).
|
||||
After having established the connection with Azure IoT Hub, the application starts to transmit sample data read from sensor board (motion MEMS, temperature, pressure, humidity) using HTTPS protocol. If neither X-NUCLEO-IKS01A1 or X-NUCLEO-IKS01A2 are mounted, the application will transmit dummy data to IoTHub.
|
||||
|
||||
See [Manage IoT Hub][lnk-manage-iot-hub] to learn how to observe the messages IoT Hub receives from the simplesample_http application running in STM32 Nucleo.
|
||||
See [Manage IoT Hub][lnk-manage-iot-hub] to learn how to observe the messages IoT Hub receives from the ```simplesample_http``` application running in STM32 Nucleo.
|
||||
|
||||
Messages sent to Azure IoT are also printed in Serial Terminal interface.
|
||||
Messages sent to Azure IoT are also printed in serial terminal interface.
|
||||
|
||||
|
||||
## 3.3 Receive messages from IoT Hub
|
||||
|
||||
See [Manage IoT Hub][lnk-manage-iot-hub] to learn how to send cloud-to-device messages to the application.
|
||||
Messages received by STM32 Nucleo are printed over Serial Terminal interface once received.
|
||||
Green LED2 on Nucleo alternatively turn on/turn off every time a message from Azure IoT Hub is received.
|
||||
|
||||
![][4]
|
||||
|
||||
|
||||
Messages received by STM32 Nucleo are printed over serial terminal interface once received.
|
||||
Some cloud-to-device messages are a interpreted by the embedded application:
|
||||
- quit : quit application
|
||||
- reset : reset board
|
||||
- led on : LED2 onboard Nucleo on
|
||||
- led off : LED2 off
|
||||
- delay <seconds> : change samples frequency
|
||||
|
||||
A QuickStart guide to setup and run the application can also be downloaded [here][lnk-quickstart-st].
|
||||
|
||||
[lnk-setup-iot-hub]: ../setup_iothub.md
|
||||
[lnk-manage-iot-hub]: ../manage_iot_hub.md
|
||||
[lnk-nucleo-f4]:http://www.st.com/content/st_com/en/products/evaluation-tools/product-evaluation-tools/mcu-eval-tools/stm32-mcu-eval-tools/stm32-mcu-nucleo/nucleo-f401re.html
|
||||
[lnk-nucleo-wifi]:http://www.st.com/content/st_com/en/products/ecosystems/stm32-open-development-environment/stm32-nucleo-expansion-boards/stm32-ode-connect-hw/x-nucleo-idw01m1.html
|
||||
[lnk-nucleo-sensors]:http://www.st.com/content/st_com/en/products/ecosystems/stm32-open-development-environment/stm32-nucleo-expansion-boards/stm32-ode-sense-hw/x-nucleo-iks01a1.html
|
||||
[lnk-nucleo-sensors2]:http://www.st.com/content/st_com/en/products/ecosystems/stm32-open-development-environment/stm32-nucleo-expansion-boards/stm32-ode-sense-hw/x-nucleo-iks01a2.html
|
||||
[lnk-nucleo-nfc]:http://www.st.com/content/st_com/en/products/ecosystems/stm32-open-development-environment/stm32-nucleo-expansion-boards/stm32-ode-connect-hw/x-nucleo-nfc01a1.html
|
||||
[lnk-nucleo-fp]:http://www.st.com/content/st_com/en/products/embedded-software/mcus-embedded-software/stm32-embedded-software/stm32-ode-function-pack-sw/fp-cld-azure1.html
|
||||
[lnk-ide-keil]:http://www.keil.com/
|
||||
|
|
@ -112,10 +134,13 @@ Green LED2 on Nucleo alternatively turn on/turn off every time a message from Az
|
|||
[lnk-ide-sw4stm32]:http://www.openstm32.org/System+Workbench+for+STM32
|
||||
[lnk-teraterm]:https://ttssh2.osdn.jp
|
||||
[lnk-android-st25]:https://play.google.com/store/apps/details?id=com.st.demo
|
||||
|
||||
[lnk-quickstart-st]:http://www.st.com/content/ccc/resource/sales_and_marketing/presentation/product_presentation/group0/1f/8c/03/3b/a4/da/49/b4/FP-CLD-AZURE1%20quick%20start%20guide/files/fp-cld-azure1_quick_start_guide.pdf/jcr:content/translations/en.fp-cld-azure1_quick_start_guide.pdf
|
||||
|
||||
[1]: ./media/nucleo1.png
|
||||
[2]: ./media/nucleo2.png
|
||||
[2]: ./media/nucleo2_setconf.png
|
||||
[3]: ./media/nucleo3.png
|
||||
[4]: ./media/nucleo4.png
|
||||
[5]: ./media/nucleo2_runconf.png
|
||||
[6]: ./media/nucleo6_runconfApply.png
|
||||
|
||||
|
||||
|
|
|
|||
Загрузка…
Ссылка в новой задаче