ST X-CUBE-ST67W61 User Manual
ST X-CUBE-ST67W61 User Manual

ST X-CUBE-ST67W61 User Manual

Table of Contents

Advertisement

Quick Links

UM3475
User manual
Getting started with X-CUBE-ST67W61
Introduction
This user manual briefly describes the
X-CUBE-ST67W61
Expansion Package. The X-CUBE-ST67W61 is a set of software
®
®
components implementing host applications driving a Wi‑Fi
and Bluetooth
LE coprocessor (ST67W611M1).
UM3475 - Rev 2 - June 2025
www.st.com
For further information, contact your local STMicroelectronics sales office.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the X-CUBE-ST67W61 and is the answer not in the manual?

Questions and answers

Summary of Contents for ST X-CUBE-ST67W61

  • Page 1 UM3475 User manual Getting started with X-CUBE-ST67W61 Introduction This user manual briefly describes the X-CUBE-ST67W61 Expansion Package. The X-CUBE-ST67W61 is a set of software ® ® components implementing host applications driving a Wi‑Fi and Bluetooth LE coprocessor (ST67W611M1). UM3475 - Rev 2 - June 2025 www.st.com...
  • Page 2: General Information

    UM3475 General information General information ® ® The ST67W611M1 Expansion Package runs on STM32 32-bit microcontrollers based on Arm Cortex processors. Note: Arm and TrustZone are registered trademarks of Arm Limited (or its subsidiaries) in the US and/or elsewhere. Acronyms and definitions Table 1 presents the definitions of the acronyms that are relevant for a better understanding of this document.
  • Page 3 UM3475 General information Acronym Definition LWIP Lightweight IP Media access control Microcontroller unit MEMS Micro-electro-mechanical systems Manufacturing MPDU MAC protocol data unit MQTT Message queuing telemetry transport MSDU MAC service data unit Maximum transmission unit MU-MIMO Multi-user multiple-input multiple-output Middleware ®...
  • Page 4 UM3475 General information Acronym Definition Uniform resource locator Universal serial bus Coordinated universal time UUID Universally unique identifier Wired equivalent privacy ® Wireless fidelity Wi‑Fi ® Wi‑Fi protected access ® WPA-EAP Wi‑Fi protected access - extensible authentication protocol ® Wi‑Fi protected setup XTAL Crystal oscillator...
  • Page 5: Cube-St67W61 Architecture Overview

    UM3475 X-CUBE-ST67W61 architecture overview X-CUBE-ST67W61 architecture overview ® The X-CUBE-ST67W61 is a set of software components implementing host applications driving a Wi‑Fi ® Bluetooth LE coprocessor. The coprocessor is controlled via AT command over SPI interface. The figure below illustrates the architecture of the solution: Figure 1.
  • Page 6: St67W611M1 Features

    UM3475 ST67W611M1 features ST67W611M1 features The ST67W611M1 device, which embeds a 4-Mbyte flash memory, features the following: • 2.4 GHz RF transceiver with integrated RF balun, PA, and LNA • External PA/LNA support with P version • Rx diversity with P version ®...
  • Page 7: Hardware Overview

    UM3475 Hardware overview Hardware overview For evaluation purposes, the ST67W611M1 is integrated into the X-NUCLEO-67W61M1 board. It is compatible ® with any STM32 Nucleo board via the ARDUINO connector. ® The system is composed of a host and the ST67W611M1 Wi‑Fi coprocessor.
  • Page 8: Nucleo-144 Main Board Overview

    UM3475 Hardware overview Figure 3. Pin mapping SPI_SCLK ST67W61M1 SPI SPI_MISO SPI_MOSI SPI_CS XTAL32K_IN BUTTON BOOT ST67W61M1 CTRL CHIP_EN XTAL32K_OUT LED1_SPI_RDY ST67W61M1 UART_Rx debug UART_Tx The user must ensure that JP1 and JP2 are closed. The pin description is listed below: •...
  • Page 9: How To Flash The St67W611M1 Device

    UM3475 Hardware overview Figure 4. NUCLEO-U575ZI-Q connections Zio connector supporting ARDUINO® Uno V3 PWR part (CN7) Zio connector supporting ARDUINO® Uno V3 PWR part (CN8) Zio connector supporting ARDUINO® Uno V3 PWR Zio connector supporting part (CN10) ARDUINO® Uno V3 PWR part (CN9) How to flash the ST67W611M1 device The ST67W611M1 network coprocessor requires to be loaded with either a mission binary (see...
  • Page 10: Table 2. 3-Step St67W611M1 Programming Process

    1. A PC running QConn_Flash tool 2. Any host STM32 board. X-CUBE-ST67W61 package contains binaries of the boards that are included in the package. Associated source code and project are located in \Projects\$BOARD_NAME\Utilities\NCP\NCP_Loader. If the host board is not included in the X-CUBE-ST67W61, the NCP_Loader project must be migrated.
  • Page 11: Figure 6. Step 1 - St67W611M1 Programming Process

    UM3475 Hardware overview Figure 6. Step 1 - ST67W611M1 programming process Note: After step 1, check that the red led has blinked on the Nucleo board indicating that the Bootloader.bin is properly running. UM3475 - Rev 2 page 11/48...
  • Page 12: Figure 7. Step 2 - St67W611M1 Programming Process

    UM3475 Hardware overview Figure 7. Step 2 - ST67W611M1 programming process UM3475 - Rev 2 page 12/48...
  • Page 13: Figure 8. Step 2 (Continued) - St67W611M1 Programming Process

    UM3475 Hardware overview Figure 8. Step 2 (continued) - ST67W611M1 programming process UM3475 - Rev 2 page 13/48...
  • Page 14: Manufacturing Mode

    The manufacturing mode is used to measure RF performance of the ST67W611M1. Figure 10. Manufacturing mode hardware setup NUCLEO-U575ZI-Q X-NUCLEO-67W61M1 ST-LINK STM32U575 ST67W611M1 UART The QConn_RCT tool can be used to perform RF testing. A screenshot of the tool is provided below:...
  • Page 15: Mission Mode

    The binary st67w611m_mission_t01_v2.0.75.bin has been loaded in ST67W611M1 device (see Section 4.3: How to flash the ST67W611M1 device). Any application in the project directory of X-CUBE-ST67W61 software package can be compiled and programmed in the STM32U575ZI to drive the ST67W611M1 in mission mode.
  • Page 16: Figure 13. St67W6X_Cli Tera Term Screenshot

    UM3475 Hardware overview For example, the ST67W6X_CLI project (described in Section 6.5: CLI application) is loaded by default by the script. It appears as shown below (refer to Section 6.2.3: HyperTerminal for terminal configuration): Figure 13. ST67W6X_CLI Tera Term screenshot UM3475 - Rev 2 page 16/48...
  • Page 17: Cube-St67W61 Architecture

    AT com spi_read() spi_write() SPI bus ST67W611M1 The X-CUBE-ST67W61 is composed of a set of applications running on top of ST67W6X_Network_Driver middleware and ST67W611M1 drivers. The middleware: • Exposes the generic API to applications offering: – System and OTA services ®...
  • Page 18: Framework

    There is no callback mechanism to notify when data is ready to be read. The dedicated Rx Thread at higher level is used to handle the received data and the messages. Nine applications are delivered as part of the X-CUBE-ST67W61: •...
  • Page 19: Freertos ™ Low-Power Application

    UM3475 X-CUBE-ST67W61 architecture • Output hardware choice left to application writer. For example, LogError() is called only when an error occurs, making it the least verbose, whereas LogDebug() is called more frequently to provide debug-level information. The application can output the logs on: •...
  • Page 20: Ota Services

    UM3475 X-CUBE-ST67W61 architecture Function Description W6X_FS_WriteFile This function writes a file (as a certificate) to the NCP file system. W6X_FS_ReadFile This function reads a file content from the NCP file system. W6X_FS_GetSizeFile This function gets the size of a file available in the NCP file system.
  • Page 21 UM3475 X-CUBE-ST67W61 architecture Function Description This function lists the available access points (AP) that the device can detect. This scan can be done actively or passively, on a specific channel or matching a W6X_WiFi_Scan specific SSID/BSSID. The results of the scan are processed by a callback provided as a parameter to the W6X_WiFi_Scan function.
  • Page 22: Wi-Fi ® Events

    UM3475 X-CUBE-ST67W61 architecture Function Description W6X_WiFi_GetAutoConnect This function returns the autoconnect state. W6X_WiFi_SetupTWT ® This function configures the target wake time (TWT) for the Wi‑Fi station. W6X_WiFi_SetTWT ® This function starts the target wake time (TWT) for the Wi‑Fi station.
  • Page 23: Figure 15. Wi-Fi ® Station (Sta) Fsm

    UM3475 X-CUBE-ST67W61 architecture ® Figure 15. Wi‑Fi station (STA) FSM INIT STA ON (not connected) Connect CONNECTING Credentials OK and AP in range Disconnect CONNECTED without IP address STA and AP DHCP are ON CONNECTED with IP Disconnect address The chart below shows the behavior of the system when the station and the SoftAP modes are enabled (the station mode is active by default and cannot be deactivated).
  • Page 24: Net Services

    UM3475 X-CUBE-ST67W61 architecture ® Figure 16. Wi‑Fi STA + SoftAP behavior chart Request to start the SoftAP Is STA connected? Stop STA Check that the two interfaces use the same channel Channel STA != (only one radio) Channel SoftAP Change SoftAP =...
  • Page 25: Net Apis Functions

    UM3475 X-CUBE-ST67W61 architecture Up to five sockets can be managed in parallel. 5.6.1 NET APIs functions The NET module offers an API set of functions needed to control TCP/IP stack features. The main functions available are as follows: Table 7.
  • Page 26: Net Events

    UM3475 X-CUBE-ST67W61 architecture 5.6.2 NET events The following NET events are sent back to the application layer: Table 8. NET events Event Description W6X_NET_EVT_SOCK_DATA_ID Event sent when data is received on a socket. 5.6.3 NET states The following figure shows the FSM for both TCP client and server socket.
  • Page 27: Bluetooth ® Le Services

    UM3475 X-CUBE-ST67W61 architecture Since UDP is a connectionless protocol, UDP sockets use a slightly different state machine. The state CONNECTED is used after the first call to sendto() to indicate that incoming data can be expected, as communication with a server has been initiated: Figure 18.
  • Page 28 UM3475 X-CUBE-ST67W61 architecture Function Description ® This function sets the Bluetooth LE device name. The device W6X_Ble_SetDeviceName name is applied in generic access profile and scan response packet. W6X_Ble_GetDeviceName ® This function gets the Bluetooth LE device name. W6X_Ble_SetAdvData ®...
  • Page 29: Bluetooth ® Le Events

    UM3475 X-CUBE-ST67W61 architecture Function Description This function notifies a characteristic value from the server to the W6X_Ble_ServerSendNotification remote client. The client must enable notification for this characteristic. This function indicates a characteristic value from the server to the W6X_Ble_ServerSendIndication remote client. The client must enable indication for this characteristic.
  • Page 30: Http Services

    UM3475 X-CUBE-ST67W61 architecture Event Description W6X_BLE_EVT_PAIRING_CONFIRM_ID ® Bluetooth LE pairing confirmation notification. W6X_BLE_EVT_PASSKEY_ENTRY_ID ® Bluetooth LE pairing passkey entry notification. W6X_BLE_EVT_PASSKEY_DISPLAY_ID ® Bluetooth LE pairing passkey display notification. W6X_BLE_EVT_PASSKEY_CONFIRM_ID ® Bluetooth LE pairing passkey confirmation notification. HTTP services The HTTP module offers HTTP GET requests and processes and interprets HTTP responses from servers.
  • Page 31: Mqtt Events

    UM3475 X-CUBE-ST67W61 architecture 5.9.2 MQTT events The following MQTT events are sent back to the application layer: Table 13. MQTT events Event Description W6X_MQTT_EVT_CONNECTED_ID Event received when the MQTT client is connected to the broker. Event received when the MQTT client is disconnected from the W6X_MQTT_EVT_DISCONNECTED_ID broker.
  • Page 32: Package Description

    UM3475 Package description Package description This section details the content of the X-CUBE-ST67W61 Expansion Package and how to use it. UM3475 - Rev 2 page 32/48...
  • Page 33: Project Directory

    UM3475 Package description Project directory After downloading and decompressing X-CUBE-ST67W61_Vx.y.z.zip (decompress to C:/), the directory should appear as shown below. Figure 19. X-CUBE-ST67W61 Expansion Package UM3475 - Rev 2 page 33/48...
  • Page 34: Requirements

    UM3475 Package description The X-CUBE-ST67W61 Expansion Package contains all necessary source code and projects to generate the binaries running on the STM32 host (NUCLEO-U575ZI-Q). The ST67W6X_CLI and ST67W6X_Echo projects are also available for the NUCLEO-H7S3L8, NUCLEO-H563ZI and NUCLEO-N657X0-Q STM32 hosts. It also contains the binaries to be loaded into the ST67W611M1 module.
  • Page 35: Build And Load A Project

    This application aims to demonstrate how to provision Wi‑Fi credentials via Bluetooth LE to establish a Wi‑Fi connection to an access point. ® The solution is using a vendor-specific, a dedicated Bluetooth LE profile, and a remote client interface (ST web ® ™ ™ Bluetooth , or Android /iOS ST BLE Toolbox Application).
  • Page 36: Bluetooth ® Le P2P Application

    The client device interfacing with the peer-to-peer server can be a ST67W611M1 platform with peer-to-peer client ™ ™ ® application, a smartphone using the ST BLE Toolbox Android /iOS application, or a laptop with a Bluetooth interface webpage. The description of the application is available on the following wiki page: https://wiki.st.com/stm32mcu/wiki/...
  • Page 37: Mqtt Demonstration

    By default, a timer is used to trigger the FOTA process. Additionally, an user button can also be used in this example to trigger the FOTA process. The description of the application is available on the following wiki page: https://wiki.st.com/stm32mcu/wiki/ Connectivity:Wifi_ST67W6X_FOTA_Application 6.11 MQTT demonstration 6.11.1...
  • Page 38: How To Measure Wi-Fi Throughput

    UM3475 How to measure Wi‑Fi® throughput ® How to measure Wi‑Fi throughput The CLI application described in Section 6.5: CLI application must be loaded onto the STM32 host. Overview iPerf is a widely used network testing tool that can create TCP and UDP data streams and measure the throughput of a network.
  • Page 39: Iperf Usage

    UM3475 How to measure Wi‑Fi® throughput ® To connect the two devices, either set up a Wi‑Fi hotspot on the smartphone or configure SoftAP on our device. Once connected, iPerf can be used on both devices as illustrated below: Figure 20. Iperf2 for Android screenshot Note: Android is a trademark of Google LLC.
  • Page 40: Table 15. Main Iperf Commands

    UM3475 How to measure Wi‑Fi® throughput Table 15. Main iperf commands Test AP command ST67W6X CLI command iperf -s -u -t 10 -i 1 -f m iperf -c <AP_IP> -u -b 50M -t 10 UDP Tx iperf -c <DUT_IP> -u -b 50M -t 10 -i 1 -f m iperf -s -u -t 10 UDP Rx iperf -s -t 10 -i 1 -f m...
  • Page 41: Cube-St67W61 Stm32Cubemx Pack

    To have the latest STM32CubeMX version installed (version 6.14.1 is minimum) • To have the latest X-CUBE-ST67W61 installed (version 1.0.0 is minimum) • It is recommended to choose an STM32 with 256 Kbytes of flash and 48 Kbytes of RAM minimum The picture below shows the pack content.
  • Page 42: Revision History

    UM3475 Revision history Table 16. Document revision history Date Version Changes 13-Mar-2025 Initial release. First public release. Updated: • Section 1: General information • Section 1.1: Acronyms and definitions • Section 3: ST67W611M1 features • Section 4: Hardware overview • Section 4.1: X-NUCLEO-67W61M1 mezzanine board overview •...
  • Page 43: Table Of Contents

    X-CUBE-ST67W61 architecture overview ........
  • Page 44 UM3475 Contents 5.8.1 HTTP APIs functions........... . . 30 MQTT services .
  • Page 45 X-CUBE-ST67W61 STM32CubeMX pack ........
  • Page 46: List Of Tables

    UM3475 List of tables List of tables Table 1. List of acronyms ..............2 Table 2.
  • Page 47: List Of Figures

    X-CUBE-ST67W61 host software architecture ........
  • Page 48 ST’s terms and conditions of sale in place at the time of order acknowledgment. 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’...

Table of Contents