With Azure RTOS complementing the extensive STM32Cube ecosystem providing free development tools, software bricks, and software expansion packages, STM32 users can also leverage the rich services of Azure RTOS, which meet the needs of tiny, smart, connected devices.
X-CUBE-AZRTOS-H7 (Azure RTOS Software Expansion for STM32Cube) provides a full integration of Microsoft Azure RTOS in the STM32Cube environment for the STM32H7 series of microcontrollers. Ready-to-run applicative examples are also provided for the NUCLEO-H723ZG and STM32H735G-DK evaluation boards, thus reducing the learning curve and ensuring a smooth application development experience with Azure RTOS and STM32H7 MCUs.
The scope of this package covers the following Azure RTOS middleware: RTOS (ThreadX), USB Device and Host (USBX), File System including NOR/NAND memories support (FileX and LevelX) and Networking including Ethernet and WiFi media (NetXDuo).
As the very first milestone of ST's Azure RTOS integration in the STM32Cube Ecosystem, the current X-CUBE-AZRTOS-H7 package is a first Beta release and more features will be available in Q1 2021.
Azure RTOS is a professional grade, highly reliable and market proven Middleware suite:
- Integrated and full featured RTOS. Learn more ThreadX.
- Industrial grade networking stack: optimized for performance coming with many IoT protocols. Learn more Netx Duo
- Advanced FS/FTL: fully featured to support NAND/NOR Flash memories. Learn more FileX and LevelX
- USB Host and Device stacks coming with multiple classes. Learn more USBX
- Safety pre-certifications (from Microsoft): IEC 61508 SIL4, IEC 62304 Class C and ISO 26262 ASIL D
- Security pre-certifications (from Microsoft): EAL4+ for TLS/DTLS, FIPS 140-2 for SW crypto lib
- STM32 granted production license: here
- USBX, FileX and NetXDuo building require ThreadX as they are based on RTOS model.
- USBX Host MSC requires FileX Middleware usage
- USBX Device ECM/RNDIS classes require NetXDuo usage
One of the following toolchains:
- IAR Embedded Workbench for ARM (EWARM) 8.50.6 + ST-LINKV3. Using patch available here for supporting STM32H723x devices.
- STM32CubeIDE V1.5.0 + ST-LINKV3
- NUCLEO-H723ZG (MB1364-E01)
- STM32H735G-DK (MB1520-B02)
The STMicroelectronics GitHub X-CUBE-AZRTOS repository consists of the following repositories:
- Drivers: contains STM32H7 CMSIS, HAL and BSP drivers
- Middlewares: contains ThreadX, NetX Duo, FileX, LevelX and USBX stacks including porting on STM32 hardware
- Projects: provides ready-to-run applicative examples for Azure RTOS on the supported boards
More comprehensive documentation will be available in Q1 2021.
Azure RTOS is distributed by Microsoft under GitHub and under Microsoft license. ST include Azure RTOS in selected STM32Cube software packages, on www.st.com and ST GitHub Whether delivered by Microsoft under GitHub, or by ST through STM32 CubeFW packages on www.st.com or GitHub, proprietary license terms are the same between Microsoft and User:
- Source code is available
- User is granted modification
- User is granted redistribution of source (modified or not) and/or binary, provided he develops on an MCU/MPU that is listed officially by Microsoft
- User is granted production, provided he develops on an MCU that is listed officially by Microsoft: Licensed Hardware
- User is forbidden to reuse provided software to create a competing offer Whenever a new STM32 series includes support for Azure RTOS, it is added by Microsoft in the official list
By using STM32H7 Series you inherit the “Distribution and Production Use” rights in Section 2 of the Microsoft Software License Terms for Azure RTOS.
For more details about license information relative to each component in this package, please refer to LICENSE
| Middleware | Applications | Short Description |
|---|---|---|
| ThreadX | Tx_Thread_Creation | It demonstrates how to create and destroy multiple threads using Azure RTOS ThreadX APIs. In addition, it shows how to use preemption threshold between threads and change priorities on-fly. readme |
| ThreadX | Tx_Thread_Sync | It demonstrates how to synchronize between threads using binary semaphores or mutexes. readme |
| ThreadX | Tx_Thread_MsgQueue | It demonstrates how to exchange message between threads using Message Queue API and how to handle message from different queues using event queue chaining feature. readme |
| ThreadX | Tx_FreeRTOS_Wrapper | It demonstrates how to create threads using the FreeRTOS wrapper APIs. readme |
| USBX | Ux_Host_MSC | It demonstrates how to develop USB Host Mass Storage "MSC" able to enumerate and communicates with a removable usb flash disk. The application is designed to behave as an USB MSC Host able to operate with an USB flash disk using the Bulk Only Transfer (BOT) and Small Computer System Interface (SCSI) transparent commands combined with a file system AzureRTOS FileX. readme |
| USBX | Ux_Host_HID | It demonstrates how to develop USB Host Human Interface "HID" able to enumerate and communicates with a mouse or a keyboard. The application is designed to behave as an USB HID Host, the code provides required requests to properly enumerate HID devices , HID Class APIs to decode HID reports received from a mouse or a keyboard and display data on uart HyperTerminal. readme |
| USBX | Ux_Device_MSC | It demonstrates how to develop USB Device mass storage class based application. The application is designed to emulate an USB MSC device, the code provides all required device descriptors framework and the associated Class descriptor report to build a compliant USB MSC device readme |
| USBX | Ux_Device_CDC_ACM | It demonstrates how to develop USB Device communication Class "CDC_ACM" based application. The application is designed to emulate an USB-to-UART bridge following the Virtual COM Port (VCP) implementation, the code provides all required device descriptors framework and associated Class descriptor report to build a compliant USB CDC_ACM device. readme. |
| USBX | Ux_Device_HID | It demonstrates how to develop USB Device Human Interface "HID" mouse based application. The application is designed to emulate an USB HID mouse device, the code provides all required device descriptors framework and associated Class descriptor report to build a compliant USB HID mouse device. readme |
| FileX | Fx_uSD_File_Edit | It demonstrates how to develop a basic SD card file operations application. The application is designed to handle SD card insertion/removal events, and depending on that state, it starts and stops file operations from and into the SD card. readme |
| FileX | Fx_MultiAccess | It demonstrates the FileX's concurrent file access capabilities. The application is designed to execute file operations on the SD card device, the code provides all required software code for handling SD card I/O operations. readme |
| FileX | Fx_NoR_Write_Read_File | It demonstrates how to create a Fat File system on the NOR flash using FileX alongside LevelX. The application is designed to execute file operations on the MX25LM51245G NOR flash device, the code provides all required software code for properly managing it. readme |
| NetXDuo | Nx_TCP_Echo_Server | It demonstrates how to develop a NetX TCP server to communicate with a a remote client using the NetX TCP socket API. readme |
| NetXDuo | Nx_TCP_Echo_Client | It demonstrates how to develop a NetX TCP client to communicate with a remote sever using the NetX TCP socket API. readme |
| NetXDuo | Nx_UDP_Echo_Server | It demonstrates how to develop a NetX UDP server to communicate with a a remote client using the NetX UDP socket API. readme |
| NetXDuo | Nx_UDP_Echo_Client | It demonstrates how to develop a NetX UDP client to communicate with a remote sever using the NetX UDP socket API. readme |
| NetXDuo | Nx_WebServer | It demonstrates how to develop Web HTTP server based application.It is designed to load files and static web pages stored in SD card using a Web HTTP server, the code provides all required features to build a compliant Web HTTP Server. readme |
None.
Caution : The issues are strictly limited to submit problems or suggestions related to the software delivered in this repository.
For any other question related to the product, the hardware performance or characteristics, the tools, the environment, you can submit it to the ST Community on the STM32 MCUs related page.