RZ/A3UL Microsoft Azure SDK

This is the RZ/A3UL Software Development Kit with Microsoft Azure Support. The SDK contains the RZ/A3UL Board Support Package and drivers for the RZ/A3UL target Processors, the Asure RTOS ( ThreadX ), Azure middleware ( FileX, GUIX, NetX duo, USBX ). In driver GPIO code generation has been integrated with the RZ/A3UL Flexible Software Package (FSP).

Microsoft Azure Libraries

The Microsoft Azure software is supported by the Azure Microsoft Team. This repository includes the library debug binaries. The full source code for the listed libraries can be found here.

License

• Threadx

  This is the Microsoft Azure RTOS.
  To learn more about Azure RTOS ThreadX.

• USBx

  This is the USB middleware. It support both Host and Device. USB Class support include HID, MSC, CDC, HUB, UVC, Audio, and printer.
  To learn more about Azure RTOS USBX.

• GUIx

  This the GUI middleware. It supports 16, 24 and 32 bit color space. Resolution is dependent on the amount of internal memory ( i.e. 4MB RZ/A3UL ) or external memory.
  To learn more about Azure RTOS GUIX.

• FileX

  This is the RTOS file system. Supports RAM disk, USB and SD.
  To learn more about Azure RTOS FileX.

• NetXDuo

  This middware supports the network for IP4, Ip6, TCP, UDP, HTTP, Secure Socket Layer, Crypto libraries, and many more.
  To learn more about Azure RTOS NetX Duo.

• Azure IoT

  As part of the NetxDuo the Azure IoT Cloud connectivity is included.

Getting Started

Sample Projects

No.	Program File	Descriptions
1	filex_demo_sdmmc_rza3_fsp	Sample project to check the function of FileX.
2	guix_demo_usbx_hhid_mouse_rza3_fsp	Sample project to check the function of GUIX and USBX.
3	netx_demo_http_server_rza3_fsp	Sample project to check the function of NetX duo.
4	usbx_demo_hcdc_rza3_fsp	Sample project to check the function of USBX HCDC.
5	usbx_demo_hhid_rza3_fsp	Sample project to check the function of USBX HHID.
6	usbx_demo_hmsc_rza3_fsp	Sample project to check the function of USBX HMSC.
7	usbx_demo_huvc_netx_http_server_rza3_fsp	Sample project to check the function of USBX HUVC.
8	usbx_demo_pcdc_rza3_fsp	Sample project to check the function of USBX PCDC.
9	RZA3UL_demo_azure_iot_pnp	Sample project to check the function of Azure IoT Middleware.

Development Environment

Software	Version
e2 studio	2024-04 (24.4.0)
GCC ARM A-Profile	13.2.1.20231009
RZ/A FSP	3.0.0

For more information to set up your development environment, refer to the following document.

• "Getting Started with RZ/A Flexible Software Package"

Microsoft Azure Demos

• filex_demo_sdmmc_rza3_fsp

  The "filex_demo_sdmmc_rza3_fsp" is a sample project of FileX.
  This sample project outputs the status to the console while verifying SD card read/write.

  How to Excute

  1. Set the SW1-2 on the board to ON.
  2. Start the terminal software.
  3. Download the project and start debugging.
  4. Insert micro SD card into CN2 connector on the board.
  5. Confirm the following message is displayed on the terminal.
     
     

• demo_usbx_hhid_mouse_rza3_fsp

  The "demo_usbx_hhid_mouse_rza3_fsp" is a sample project of GUIX and USBX.
  This sample project displays the GUI on the HDMI monitor and can be operated with the USB mouse.

  How to Excute

  1. Connect the HDMI monitor to CN5 connector on the board via Parallel to HDMI Conversion board.
  2. Download the project and start debugging.
  3. Connect the USB mouse to CN12 connector on the board.
  4. Confirm that the following screen is displayed on the HDMI monitor.
     
     

• netx_demo_http_server_rza3_fsp

  The "netx_demo_http_server_rza3_fsp" is a sample project of NetX duo.
  This sample project works as an HTTP server and responds to HTTP requests from browser.

  How to Excute

  1. Connect the Ethernet connector of the PC and CN8 connector on the board.
  2. Configure a static IP address for the board.
  3. Download the project and start debugging.
  4. Access the IP address “192.168.2.182” and confirm that following browser is displayed in the browser.
     
     

• usbx_demo_hcdc_rza3_fsp

  The "usbx_demo_hcdc_rza3_fsp" is a sample project of USBX HCDC.
  This sample project sends an AT command and displays the response in the log when connect a device that acts as a PCDC.

  How to Excute

  1. Run RZA3UL_USB_PCDC_2_0_Release project on one RZ/A3UL board to act as PCDC device.
  2. Start the terminal software.
  3. Download the project and start debugging.
  4. Connect the PCDC device to CN12 connector on the board.
  5. Confirm the following message is displayed on the terminal.
     
     

• usbx_demo_hhid_rza3_fsp

  The "usbx_demo_hhid_rza3_fsp" is a sample project of USBX HHID.
  This sample project detects the USB mouse and output the mouse position information.

  How to Excute

  1. Start the terminal software.
  2. Download the project and start debugging.
  3. Connect the USB mouse to CN12 connector on the board.
  4. Confirm the following mouse position information is displayed on the terminal.
     
     

• usbx_demo_hmsc_rza3_fsp

  The "usbx_demo_hmsc_rza3_fsp" is a sample project of USBX HMSC.
  This sample project creates, reads and writes files to the connected USB memory.

  How to Excute

  1. Download the project and start debugging.
  2. Connect the USB memory to CN12 connector on the board.
  3. Confirm that following information of the files in the connected USB memory is displayed on the terminal.
     
     

• usbx_demo_huvc_netx_http_server_rza3_fsp

  The "usbx_demo_huvc_netx_http_server_rza3_fsp" is a sample project of USBX HUVC.
  This sample project displays the camera image on the HTTP server in real time.

  How to Excute

  1. Connect the Ethernet connector of the PC and CN8 connector on the board.
  2. Connect the UVC camera to CN12 connector on the board.
  3. Configure a static IP address for the board.
  4. Download the project and start debugging.
  5. Access the IP address “192.168.2.182” and confirm that camera image is displayed in the browser.
     
     

• usbx_demo_pcdc_rza3_fsp

  The "usbx_demo_pcdc_rza3_fsp" is a sample project of USBX PCDC.
  This sample project echoes back the input characters on the terminal.

  How to Excute

  1. Connect the PC and CN11 connector on the board.
  2. Download the project and start debugging.
  3. Start the terminal software and connect to newly recognized COM port.
  4. Comfirm that input characters are echoed back on the terminal.
     
     

• RZA3UL_demo_azure_iot
  The "RZA3UL_demo_azure_iot" is a sample project to connect to Azure IoT Hub using Azure IoT Middleware for Azure RTOS.
  This sample project supports IoT Plug and Play with multiple components.

  Azure Certified Device is no longer in servise.
  Note: RZ/A3UL EVK is certified "Azure Certified Device" and "IoT Plug and Play" certifications, and is listed in "Azure Certified Device catalog".

  How to Excute

  Please refer to Get started guide.