# Release note for FP-CLD-WATSON1 Software Copyright 2015 STMicroelectronics
FP-CLD-WATSON1 is an expansion software package for STM32Cube. The software runs on the STM32 microcontroller and includes drivers that recognize Wi-Fi module (SPWF01SA), sensor devices (HTS221, LPS25HB, LSM6DS0, LIS3MDL) and dynamic NFC/RFID tag (M24SR64-Y); it also includes a middleware package implementing the MQTT protocol for easy interaction of STM32 Nucleo based microsystem with Cloud services. The expansion software is built on STM32Cube software technology to ease portability across different STM32 microcontrollers. The software comes with examples for registering the device and sending sensors data to the IBM WATSON IOT Platform service. Some key features of the FP-CLD-WATSON1 package: Complete middleware to build applications based on Wi-Fi connectivity (SPW01SA) and to connect STM32 Nucleo boards with Cloud based services Provide software interface to access temperature and humidity sensor (HTS221), pressure sensor (LPS25HB), motion sensors (LIS3MDL and LSM6DS0) and to write and read the RFID/NFC tag (M24SR64-Y) Integrated MQTT protocol middleware Sample implementation available on board X-NUCLEO-IKS01A1, X-NUCLEO-IDW01M1, and X-NUCLEO-NFC01A1, when both connected to NUCLEO-F401RE Easy access to IBM Watson IOT platform services for sensors data visualization and processing FP-CLD-WATSON1 hardware combination: Related information and documentation: FP-CLD-WATSON1 STM32Cube: www.st.com/stm32cube STM32 Nucleo boards: www.st.com/stm32nucleo STM32 Nucleo expansion boards: www.st.com/x-nucleo Please refer to readme.txt for more information for running this demo. ## Update History ### V2.1.0 / 16-January-2017 Main Changes Correction in ODR setting of LSM303AGR Changed Raw data sent to IBM Watson cloud Updated binaries in Binary folder Release notes for expansion software used by FP-CLD-WATSON1 can be found here: X-NUCLEO-IKS01A1. The X-NUCLEO-IKS01A1 is a motion MEMS and environmental sensor evaluation board system. It is compatible with the Arduino UNO R3 connector layout, and is designed around ST’s latest sensors (release notes). X-NUCLEO-IDW01M1. X-NUCLEO-IDW01M1 is a Wi-Fi evaluation board based on the SPWF01SA module. Compatible with STM32 Nucleo boards. Equipped both with ST morpho connector and Arduino UNO R3 connectors (release notes). X-NUCLEO-NFC01A1. The X-NUCLEO-NFC01A1 is a Dynamic NFC tag evaluation board. Compatible with STM32 Nucleo boards. Equipped with Arduino UNO R3 connector (release notes). Contents Documentation Doxygen Documentation (FP-CLD-WATSON1.chm) Drivers STM32F4xx HAL V1.5.2 (release notes) STM32F4xx CMSIS V2.5.1 (release notes) Cortex-M CMSIS V4.5.0(release notes) BSP STM32F4xx_NUCLEO V1.2.5(release notes) BSP X-NUCLEO-IDW01M1 V2.1.0 (release notes) BSP X-NUCLEO-IKS01A2 V3.0.0 (release notes) BSP X-NUCLEO-NFC01A1 V1.0.0 (release notes) BSP Common V4.0.1 (release notes) Development Toolchains and Compilers IAR Embedded Workbench for ARM (EWARM) toolchain V7.70.2 + ST-Link RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.16a + ST-LINK System Workbench for STM32 (SW4STM32) V1.3.0 + ST-LINK + ST-LINK Tested with TeraTerm V4.89 Supported Devices and EVAL boards STM32F401RE NUCLEO-F401RE Board RevC X-NUCLEO-IDW01M1 Board X-NUCLEO-IKS01A2 Board X-NUCLEO-NFC01A1 Board Known Limitations None ### V2.0.0 / 21-November-2016 Main Changes Added support for X-NUCLEO-IKS01A2 Registered/Quickstart mode MQTT connection to IBM Watson IOT Platform service are now supported. (Note: Registered mode requires valid account on IBM Watson IOT platform) Added support for vibration analysis using LSM303AGR/IIS2DH sensors Release notes for expansion software used by FP-CLD-WATSON1 can be found here: X-NUCLEO-IKS01A1. The X-NUCLEO-IKS01A1 is a motion MEMS and environmental sensor evaluation board system. It is compatible with the Arduino UNO R3 connector layout, and is designed around ST’s latest sensors (release notes). X-NUCLEO-IDW01M1. X-NUCLEO-IDW01M1 is a Wi-Fi evaluation board based on the SPWF01SA module. Compatible with STM32 Nucleo boards. Equipped both with ST morpho connector and Arduino UNO R3 connectors (release notes). X-NUCLEO-NFC01A1. The X-NUCLEO-NFC01A1 is a Dynamic NFC tag evaluation board. Compatible with STM32 Nucleo boards. Equipped with Arduino UNO R3 connector (release notes). Contents Documentation Doxygen Documentation (FP-CLD-WATSON1.chm) Drivers STM32F4xx HAL V1.5.2 (release notes) STM32F4xx CMSIS V2.5.1 (release notes) Cortex-M CMSIS V4.5.0(release notes) BSP STM32F4xx_NUCLEO V1.2.5(release notes) BSP X-NUCLEO-IDW01M1 V2.1.0 (release notes) BSP X-NUCLEO-IKS01A2 V3.0.0 (release notes) BSP X-NUCLEO-NFC01A1 V1.0.0 (release notes) BSP Common V4.0.1 (release notes) Development Toolchains and Compilers IAR Embedded Workbench for ARM (EWARM) toolchain V7.70.2 + ST-Link RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.16a + ST-LINK System Workbench for STM32 (SW4STM32) V1.3.0 + ST-LINK + ST-LINK Tested with TeraTerm V4.89 Supported Devices and EVAL boards STM32F401RE NUCLEO-F401RE Board RevC X-NUCLEO-IDW01M1 Board X-NUCLEO-IKS01A2 Board X-NUCLEO-NFC01A1 Board Known Limitations None ### V1.1.1 / 26-August-2016 Main Changes Corrected client ID being used for publishing sensor data in Quickstart mode. Now 12 byte WI-FI MAC address is used as client ID. Contents STM32Cube HAL and Middlewares drivers STM32F4xx drivers aligned to STM32CubeF4 V1.11.0 Documentation Doxygen Documentation (FP-CLD-WATSON1.chm) Drivers BSP X-NUCLEO-IDW01M1 (release notes) BSP X-NUCLEO-IKS01A1 (release notes) BSP X-NUCLEO-NFC01A1 (release notes) Development Toolchains and Compilers IAR Embedded Workbench for ARM (EWARM) toolchain V7.30 + ST-Link RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.16a + ST-LINK System Workbench for STM32 (SW4STM32) V1.3.0 + ST-LINK + ST-LINK Tested with TeraTerm V4.89 Supported Devices and EVAL boards STM32F401RE NUCLEO-F401RE Board RevC X-NUCLEO-IDW01M1 Board X-NUCLEO-IKS01A1 Board X-NUCLEO-NFC01A1 Board Known Limitations WARNING SPI peripheral can go in timeout for F4 MCU families, due to a bug in the HAL_SPI_TransmitReceive() function In case of problems, you can call the __HAL_SPI_CLEAR_OVRFLAG() macro to clear the overrun flag before using the HAL_SPI_TransmitReceive() function. ### V1.1.0 / 29-June-2016 Main Changes Updated CUBE drivers for F401RE platform Updated X-CUBE drivers for X-NUCLEO-IKS01A1 and X-NUCLEO-IDW01M1 expansion boards WiFi Access Point configuration: WiFi parameters can be set via serial terminal or written to NFC using an Android app. Once set, SSID/PWD are saved to Nucleo FLASH memory so that it is not necessary to insert them manually after each reset of the board. Added support for LED2 based Indications: LED2 on the Nucleo board is turned ON when the Nucleo is connected to MQTT broker, and it blinks each time sensors data are trasnmitted to MQTT broker. In case of disconnection from MQTT broker LED2 is turned off. Support for intermittent WiFi connectivity: If WiFi signal is lost, firmware tries to reconnect to Access Point. Once reconnection to AP is recovered the application reconnects to the MQTT broker. Contents STM32Cube HAL and Middlewares drivers STM32F4xx drivers aligned to STM32CubeF4 V1.11.0 Documentation Doxygen Documentation (FP-CLD-WATSON1.chm) Drivers BSP X-NUCLEO-IDW01M1 (release notes) BSP X-NUCLEO-IKS01A1 (release notes) BSP X-NUCLEO-NFC01A1 (release notes) Development Toolchains and Compilers IAR Embedded Workbench for ARM (EWARM) toolchain V7.30 + ST-Link RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.16a + ST-LINK System Workbench for STM32 (SW4STM32) V1.3.0 + ST-LINK + ST-LINK Tested with TeraTerm V4.89 Supported Devices and EVAL boards STM32F401RE NUCLEO-F401RE Board RevC X-NUCLEO-IDW01M1 Board X-NUCLEO-IKS01A1 Board X-NUCLEO-NFC01A1 Board Known Limitations WARNING SPI peripheral can go in timeout for F4 MCU families, due to a bug in the HAL_SPI_TransmitReceive() function In case of problems, you can call the __HAL_SPI_CLEAR_OVRFLAG() macro to clear the overrun flag before using the HAL_SPI_TransmitReceive() function. ### V1.0.0 / 26-November-2015 Main Features This application reads the sensor data values from the accelerometer, magnetometer and Gyroscope, which are transmitted to the IBM IoT Cloud through Wi-Fi. The URL of the web page where sensors data can be visualized is also written in NFC tag. The application is configured by default to run in Quickstart mode for data visualization only, but can be quickly modified in order to register and control the device in IBM Cloud (the latter mode requires an account on IBM Bluemix Cloud). Release notes for expansion software used by FP-CLD-BLUEXMI1 can be found here: X-NUCLEO-IKS01A1: The X-NUCLEO-IKS01A1 is a motion MEMS and environmental sensor evaluation board system. It is compatible with the Arduino UNO R3 connector layout, and is designed around ST’s latest sensors. (release notes) X-NUCLEO-IDW01M1: X-NUCLEO-IDW01M1 is a Wi-Fi evaluation board based on the SPWF01SA module. Compatible with STM32 Nucleo boards. Equipped both with ST morpho connector and Arduino UNO R3 connectors. (release notes) X-NUCLEO-NFC01A1: The X-NUCLEO-NFC01A1 is a Dynamic NFC tag evaluation board. Compatible with STM32 Nucleo boards. Equipped with Arduino UNO R3 connector. (release notes) Development Toolchains and Compilers IAR Embedded Workbench for ARM (EWARM) toolchain V7.40 + ST-LINK RealView Microcontroller Development Kit (MDK-ARM) toolchain V5.16a + ST-LINK System Workbench for STM32 V1.3.0.20150724 + ST-LINK Supported Devices and EVAL boards STM32F401RE devices: (resources) NUCLEO-F401RE Board RevC: (resources) X-NUCLEO-IKS01A1 Board: (resources) X-NUCLEO-IDW01M1 Board: (resources) X-NUCLEO-NFC01A1 Board: (resources) Known Limitations NA ## License Licensed under MCD-ST Liberty SW License Agreement V2, (the "License"); You may not use this package except in compliance with the License. You may obtain a copy of the License at: http://www.st.com/software_license_agreement_liberty_v2 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. For complete documentation on STM32 Microcontrollers visit www.st.com/STM32