RZA3UL Evaluation board: Difference between revisions

From Renesas.info
(→‎TES GUILIANI: Added link for RES Guiliani demo support)
(→‎Software Packages: Moved the RZA3UL example demos to Software demos)
 
(10 intermediate revisions by 2 users not shown)
Line 18: Line 18:
* Octo Flash, Octo RAM, and DDR
* Octo Flash, Octo RAM, and DDR


= Software Packages =
The RZA3UL Software packages provide the BSP, Driver Firmware, middleware ( USB, Ethernet, GUI, etc) and RTOS. RZA3UL supports the Amazon FreeRTOS and Microsoft Azure. Both software packages are included in the FSP 2.0 and later.
* '''[https://www.renesas.com/us/en/software-tool/rza3ul-software-package#overview Official Renesas RZA3UL Software Package]  .'''
* '''[https://github.com/renesas/rza-fsp/releases Renesas RZA FSP Github repository]'''
=== Software Package Features ===
{| class="wikitable"
|+
!Package
!Package Type
!RTOS
!GUI
!File System
!USB
!Network
|-
|FreeRTOS
|FSP, github
|Amazon FreeRTOS
|Tes Guiliani <sup>*1</sup>
|[https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_FAT/FreeRTOS_Windows_Port_Examples.html FreeRTOS + FAT]
|Renesas USB <sup>*2</sup>
|[https://www.freertos.org/FreeRTOS-Plus/FreeRTOS_Plus_TCP/index.html FreeRTOS Plus TCP]
|-
|Microsoft Azure
|FSP, github
|Threadx
|GUIX
|FileX
|USBX
|NetX Duo
|}
1* Tes Guiliani is not included in the standard Renesas FSP. The Software can be found on [https://www.guiliani.de/mediawiki/index.php?title=Downloads:SDK_for_your_Evaluation_Kit Tes Guiliani Site]
2* Renesas USB Supports HID host, MSC host, PCDC
= Software Demos =
Beside the demos offered in the FSP, Renesas offers the following demos
=== Microsoft Asure RTOS ===
'''Please contact your FAE or Sales Representative for these demos.'''
{| class="wikitable"
|+
! Program Name
! Description
|-
| filex_demo_sdmmx_rza3_fsp_1.0
| This sample project outputs the status to the console while verifying SD card read/write.
|-
| guix_demo_usbx_hhid_mouse_rza3_fsp_1.0
| This sample project displays the GUI on the HDMI monitor and can be operated with the USB mouse.
|-
| netx_demo_http_server_rza3_fsp_1.0
| This sample project works as an HTTP server and responds to HTTP requests from browser
|-
| usbx_demo_hcdc_rza3_fsp_1.0
| This sample project sends an AT command and displays the response in the log when connect a device that acts as a PCDC
|-
| usb_demo_hhid_rza3_fsp_1.0
| This sample project detect the USB mouse and output the mouse position information.
|-
| usb_demo_hmsc_rza3_fsp_1.0
| This sample project create and read/write files to the connected USB memory.
|-
| usb_demo_huvc_netx_http_server_rza3_fsp_1.0
| Demonstration of the USB Camera Network Streaming Device
|}
=== RZ/A3UL EVK Example Projects ===
The RZA3UL Example Projects shows examples of each of the RZ/A3UL Peripherals ( DMAC, USB, CAN, I2S, I2C, ...).
'''[https://www.renesas.com/us/en/document/apn/rza3ul-evk-example-projects-bundle?r=1625071 RZ/A3UL EVK Example Project Document]'''
'''[https://www.renesas.com/us/en/document/scd/rza3ul-evk-example-projects RZ/A3UL EVK Example Project Software]'''
= Getting Started =
= Getting Started =


=== Linux and Windows IDE Installation ===
=== Linux and Windows IDE Installation ===
[https://www.renesas.com/us/en/document/qsg/getting-started-rza-flexible-software-package-v100?language=en&r=1619651 RZ/V3UL Getting Started Document (Link)]
[https://www.renesas.com/us/en/document/qsg/getting-started-rza-flexible-software-package-v100?language=en&r=1619651 RZA3UL Getting Started Document (Link)]


=== Linux FSP Installation ===
=== Linux FSP Installation ===
Line 43: Line 118:


* [https://www.renesas.com/us/en/software-tool/rza3ul-software-package#document RZ/A3UL Flexible Software Package Website (Link)]
* [https://www.renesas.com/us/en/software-tool/rza3ul-software-package#document RZ/A3UL Flexible Software Package Website (Link)]
* [https://www.renesas.com/us/en/document/qsg/getting-started-rza-flexible-software-package-v100?r=1619651 RZ/A3UL e2studio IDE and FSP Installation Document (Link)]
* [https://www.renesas.com/us/en/document/qsg/getting-started-rza-flexible-software-package-v100?r=1619651 RZ/A3UL e2studio IDE and FSP Installation Document on Windows OS (Link)]
** Must Select "'''''Renesas FSP Smart Configurator Core'''''" in the Customize Feature installation dialog .
** Must Select "'''''Renesas FSP Smart Configurator Core'''''" in the Customize Feature installation dialog .
** In the Addition Software installation dialog, under the <u>'''Renesas FSP Tab'''</u>, do not install the Renesas FSP. These FSP versions are for RZ Only.
** In the Addition Software installation dialog, under the <u>'''Renesas FSP Tab'''</u>, do not install the Renesas FSP. These FSP versions are for RZ Only.
* [https://github.com/renesas/rza-fsp/releases RZ/A3UL Flexible Software Package Release]
**This is the Renesas Repository for the RZ/A3UL FSP
** [https://github.com/renesas/rza-fsp/releases/download/v1.2.1/RZA_FSP_Packs_v1.2.1.zip RZ/A3UL Flexible Software Package (Archive)]
***Use this for Linux Installation (see below).
* Renesas e2studio Version 2022-07 or later
* Renesas e2studio Version 2022-07 or later
* GCC ARM A-Profile (AArch64 bare-metal) 10.3.2021.07
* GCC ARM A-Profile (AArch64 bare-metal) 10.3.2021.07
== FSP Installation for Linux ==
1) Download the RZ/A3UL FSP Archive (see above)
2) Extract the FSP to the e2studio installation directory. (i.e. /home/<user>/.local/share/renesas/e2studio)
3) The Extracted file should look like this
renesas
└── e2_studio
    ├── eclipse
    ├── fsp_documentation
    ├── internal
    │   ├── devassist
    │   └── projectgen
    │      ├── ra
    │      │   └── packs
    │      └── rz_fsp
    │          ├── rza


= Initial Program Loader ( IPL ) =
= Initial Program Loader ( IPL ) =
Line 86: Line 183:


=== TES GUILIANI ===
=== TES GUILIANI ===
The RZA3UL Tes Guiliani GUI Framework uses Free RTOS and GNU GCC compiler. The RZA3UL GUI project uses the FSP for peripheral configuration  However the  RZA3UL FSP does not include the TES Guiliani Framework. To start development with GUI Framework please start with the demo posed in the link below.
The RZA3UL Tes Guiliani GUI Framework uses Free RTOS and GNU GCC compiler. The RZA3UL GUI project uses the FSP for peripheral configuration  However the  RZA3UL FSP does not include the TES Guiliani Framework. To start development with GUI Framework please start with the demo posted in the link below.


[https://www.guiliani.de/mediawiki/index.php?title=Downloads:SDK_for_your_Evaluation_Kit '''Official RZA3UL FreeRTOS TES Guiliani Website link''']
[https://www.guiliani.de/mediawiki/index.php?title=Downloads:SDK_for_your_Evaluation_Kit '''Official RZA3UL FreeRTOS TES Guiliani Website link''']


[[Renesas TES Guiliani Support Page]]
[[Renesas TES Guiliani Support Page|'''Renesas TES Guiliani Support Page''']]
 
Information on the Prepaid License for the Tes Guiliani-Lite GUI Framework for RZA Products can be found below.
 
[https://www.renesas.com/us/en/software-tool/tes-guiliani '''Renesas TES Guiliani Prepaid License Website Link''']
 
The Renesas Prepaid License for Tes Guiliani-Lite offers the following resources. For access to  Full Version Contact [https://www.guiliani.de/mediawiki/index.php?title=The_C%2B%2B_GUI_framework_for_all_embedded_engineers Tes Guiliani.]
[[File:Tes Guiliani License.png|left|frameless|900x900px|Tes Guiliaini License Comparison]]

Latest revision as of 23:53, 15 November 2023

RZ/A3UL Evaluation Board Contents

General Information

Package Versions

RZ/V2UL has two parts that support different external memory configurations.

  • QSPI and DDR
  • Octo Flash, Octo RAM, and DDR

Software Packages

The RZA3UL Software packages provide the BSP, Driver Firmware, middleware ( USB, Ethernet, GUI, etc) and RTOS. RZA3UL supports the Amazon FreeRTOS and Microsoft Azure. Both software packages are included in the FSP 2.0 and later.

Software Package Features

Package Package Type RTOS GUI File System USB Network
FreeRTOS FSP, github Amazon FreeRTOS Tes Guiliani *1 FreeRTOS + FAT Renesas USB *2 FreeRTOS Plus TCP
Microsoft Azure FSP, github Threadx GUIX FileX USBX NetX Duo

1* Tes Guiliani is not included in the standard Renesas FSP. The Software can be found on Tes Guiliani Site

2* Renesas USB Supports HID host, MSC host, PCDC

Software Demos

Beside the demos offered in the FSP, Renesas offers the following demos

Microsoft Asure RTOS

Please contact your FAE or Sales Representative for these demos.

Program Name Description
filex_demo_sdmmx_rza3_fsp_1.0 This sample project outputs the status to the console while verifying SD card read/write.
guix_demo_usbx_hhid_mouse_rza3_fsp_1.0 This sample project displays the GUI on the HDMI monitor and can be operated with the USB mouse.
netx_demo_http_server_rza3_fsp_1.0 This sample project works as an HTTP server and responds to HTTP requests from browser
usbx_demo_hcdc_rza3_fsp_1.0 This sample project sends an AT command and displays the response in the log when connect a device that acts as a PCDC
usb_demo_hhid_rza3_fsp_1.0 This sample project detect the USB mouse and output the mouse position information.
usb_demo_hmsc_rza3_fsp_1.0 This sample project create and read/write files to the connected USB memory.
usb_demo_huvc_netx_http_server_rza3_fsp_1.0 Demonstration of the USB Camera Network Streaming Device

RZ/A3UL EVK Example Projects

The RZA3UL Example Projects shows examples of each of the RZ/A3UL Peripherals ( DMAC, USB, CAN, I2S, I2C, ...).

RZ/A3UL EVK Example Project Document

RZ/A3UL EVK Example Project Software

Getting Started

Linux and Windows IDE Installation

RZA3UL Getting Started Document (Link)

Linux FSP Installation

NOTE: The FSP installation section in the Getting Started Document is for Window Host machines. Use the following steps for Linux machines.

Official Linux and Windows FSP Website

  1. Download the zip archive file from the above link
  2. Find the installation directory for the FSP.
    1. Open e2studio IDE.
    2. Select Help and about e2studio in the drop down menu
    3. In the Dialog press the "Installation Details" Button.
    4. In the next dialog there are several tabs at the top of the dialog. Select the "Supported Folders" tab.
    5. Click the link "e2 studio support area"
    6. This will open the linux Nautilus file manager.
  3. Extract the archive file to the e2studio support area folder. This is the directory you found in the prefiious step For example the folder may look be this ~/.eclipse/com.renesas.platform_1458492943.
  4. e2studio Linux

Renesas Flexible Software Package ( FSP )

RZ/A3UL is supported by the Renesas Flexible Software Package. Supported links.

FSP Installation for Linux

1) Download the RZ/A3UL FSP Archive (see above)

2) Extract the FSP to the e2studio installation directory. (i.e. /home/<user>/.local/share/renesas/e2studio)

3) The Extracted file should look like this

renesas
└── e2_studio
    ├── eclipse
    ├── fsp_documentation
    ├── internal
    │   ├── devassist
    │   └── projectgen
    │       ├── ra
    │       │   └── packs
    │       └── rz_fsp
    │           ├── rza

Initial Program Loader ( IPL )

IPL is a boot program sample code for RZ/A Series. When the RZ/A MPU is started, the IPL initializes peripheral I/O modules, Flash memory, DDR SDRAM etc., and starts the application software developed in Renesas FSP environment with the execution state of AARch64, Exception Level EL3. IPL consists of functions such as PLL and clock control driver, peripheral I/O module driver, and Serial Flash Memory driver, etc.

Initial Program Loader (IPL) for Renesas RZ/A Series Source Code

JTAG Setup

Supported ICE

Linux Installation

Required Software

Linux packages

sudo apt-get install libncursesw5 libpython2.7

GCC Compiler : GCC ARM A-Profile (AArch64 bare-metal) 10.3.2021.07

Installation

  1. Open the Debug Configurations for the project
  2. The project debug configuration is under Renesas GDB Hardware
  3. Select the Debugger Tab for this configuration
  4. In the GDB Settings set the GDB Command to aarch64-none-elf-gdb

HMI and Camera Support

Supported HMI Resolutions

  • RZA3UL + DDR
    • Maximum Resolution 1280 x 720
  • RZA3UL OctoRAM (no DDR)
    • Maximum Resolution VGA

TES GUILIANI

The RZA3UL Tes Guiliani GUI Framework uses Free RTOS and GNU GCC compiler. The RZA3UL GUI project uses the FSP for peripheral configuration However the RZA3UL FSP does not include the TES Guiliani Framework. To start development with GUI Framework please start with the demo posted in the link below.

Official RZA3UL FreeRTOS TES Guiliani Website link

Renesas TES Guiliani Support Page