docs(Renesas): Add Renesas RZ/G3E and RA8D2 to docs (#9253)
Arduino Lint / lint (push) Has been cancelled
Build Examples with C++ Compiler / build-examples (push) Has been cancelled
MicroPython CI / Build esp32 port (push) Has been cancelled
MicroPython CI / Build rp2 port (push) Has been cancelled
MicroPython CI / Build stm32 port (push) Has been cancelled
MicroPython CI / Build unix port (push) Has been cancelled
C/C++ CI / Build OPTIONS_16BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_24BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_FULL_32BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_NORMAL_8BIT - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_SDL - Ubuntu (push) Has been cancelled
C/C++ CI / Build OPTIONS_16BIT - cl - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_16BIT - gcc - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_24BIT - cl - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_24BIT - gcc - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_FULL_32BIT - cl - Windows (push) Has been cancelled
C/C++ CI / Build OPTIONS_FULL_32BIT - gcc - Windows (push) Has been cancelled
C/C++ CI / Build ESP IDF ESP32S3 (push) Has been cancelled
C/C++ CI / Run tests with 32bit build (push) Has been cancelled
C/C++ CI / Run tests with 64bit build (push) Has been cancelled
BOM Check / bom-check (push) Has been cancelled
Verify that lv_conf_internal.h matches repository state / verify-conf-internal (push) Has been cancelled
Verify the widget property name / verify-property-name (push) Has been cancelled
Verify code formatting / verify-formatting (push) Has been cancelled
Compare file templates with file names / template-check (push) Has been cancelled
Build docs / build-and-deploy (push) Has been cancelled
Test API JSON generator / Test API JSON (push) Has been cancelled
Install LVGL using CMake / build-examples (push) Has been cancelled
Check Makefile / Build using Makefile (push) Has been cancelled
Check Makefile for UEFI / Build using Makefile for UEFI (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Script Check (scripts/perf/tests/benchmark_results_comment/test.sh) (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Script Check (scripts/perf/tests/filter_docker_logs/test.sh) (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Script Check (scripts/perf/tests/serialize_results/test.sh) (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark 32b - lv_conf_perf32b (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark 64b - lv_conf_perf64b (push) Has been cancelled
Emulated Performance Test / ARM Emulated Benchmark - Save PR Number (push) Has been cancelled
Hardware Performance Test / Hardware Performance Benchmark (push) Has been cancelled
Hardware Performance Test / HW Benchmark - Save PR Number (push) Has been cancelled
Performance Tests CI / Perf Tests OPTIONS_TEST_PERF_32B - Ubuntu (push) Has been cancelled
Performance Tests CI / Perf Tests OPTIONS_TEST_PERF_64B - Ubuntu (push) Has been cancelled
Port repo release update / run-release-branch-updater (push) Has been cancelled
Verify Font License / verify-font-license (push) Has been cancelled
Verify Kconfig / verify-kconfig (push) Has been cancelled
Close stale issues and PRs / stale (push) Has been cancelled

This commit is contained in:
Liam Howatt
2025-11-17 15:04:32 +01:00
committed by GitHub
parent dd827489d6
commit b8efebe63a
4 changed files with 120 additions and 22 deletions
@@ -46,3 +46,9 @@ fbdev
-----
The LVGL ``fbdev`` (frame buffer) display driver can almost always be used.
OpenGL
------
The constantly evolving OpenGL driver in LVGL has proven to be the most performant driver
in at least one case and can be used wherever the prerequisites are satisfied.
@@ -11,6 +11,7 @@ Supported boards in the RA Family:
- **EK-RA8D1**
- **EK-RA8P1**
- **EK-RA6M3G**
- **EK-RA8D2**
Run the Project
@@ -18,7 +19,7 @@ Run the Project
- The official IDE of Renesas is called e\ |sup2| studio. Because it's Eclipse-based,
it runs on Windows, Linux, and Mac as well. Members of the RA family require
certain minimum versions of the Flexible Software Package (FSP). See the individual
certain versions of the Flexible Software Package (FSP). See the individual
README.md files in the applicable repositories for info. FSPs can be downloaded
`here <https://www.renesas.com/us/en/software-tool/flexible-software-package-fsp>`__.
Please notice from FSP version 6.0 and above, LVGL is now part of the middleware section
@@ -30,17 +31,17 @@ Run the Project
- Clone the ready-to-use repository for your selected board, for FSP version prior to 6.0:
.. code-block:: shell
.. code-block:: shell
git clone https://github.com/lvgl/lv_port_renesas_ek-ra8d1.git --recurse-submodules
git clone https://github.com/lvgl/lv_port_renesas_ek-ra8d1.git --recurse-submodules
Downloading the `.zip` from GitHub doesn't work as it doesn't download the submodules.
- Clone the ready-to-use repository for your selected board, for FSP version from 6.0 and above:
.. code-block:: shell
.. code-block:: shell
git clone https://github.com/lvgl/lv_port_renesas_ek-ra8d1.git
git clone https://github.com/lvgl/lv_port_renesas_ek-ra8d1.git
- Open e\ |sup2| studio, go to ``File`` -> ``Import project`` and select
``General`` / ``Existing projects into workspace``.
@@ -6,13 +6,16 @@ Supported boards in the RZ/G Family:
- **RZ/G2L-EVKIT**
- **RZ/G2UL-EVKIT**
- **RZ/G3E-EVKIT**
G2L and G2UL
************
Run the Project
***************
---------------
- The RZ/G boards are MPUs with support for running Linux. Projects are built for them
- The RZ/G2L and RZ/G2UL are MPUs with support for running Linux. Projects are built for them
using a cross-compiler CLI toolchain SDK in a Linux PC environment (WSL, Docker,
etc. can be used on Windows).
- The G2L has a Wayland desktop and the project appears as a Wayland window. The G2UL
@@ -22,29 +25,29 @@ Run the Project
See the `v8-to-v9 Migration Guide <https://docs.lvgl.io/9.0/CHANGELOG.html#migration-guide>`__ for things you will need to address.
- Clone the ready-to-use repository for your selected board:
.. code-block:: shell
.. code-block:: shell
git clone https://github.com/lvgl/lv_port_renesas_rz-g2l-evkit --recurse-submodules
git clone https://github.com/lvgl/lv_port_renesas_rz-g2l-evkit --recurse-submodules
Downloading the `.zip` from GitHub doesn't work as it doesn't download the submodules.
- Follow the instructions in the project README.md to obtain the SD Card image and toolchain installer,
build, and upload the project to the board.
- Stop any automatically started demos (on G2UL run ``systemctl stop demo-launcher`` in the terminal).
- Run the project
- Run the project:
.. code-block:: shell
.. code-block:: shell
./lvgl_demo_benchmark
./lvgl_demo_benchmark
Modify the project
******************
------------------
Open a demo
-----------
~~~~~~~~~~~
The entry point is contained in ``src/main.c``.
@@ -53,13 +56,70 @@ and call some ``lv_example_...()`` functions, or add your own custom code.
Configuration
-------------
~~~~~~~~~~~~~
Edit ``lv_conf.h`` and ``lv_drv_conf.h`` to configure LVGL. The board image
contains LVGL and lv_drivers as dynamically linkable libraries. This project builds
LVGL statically for customizability and to port the LVGL v9 benchmark from LVGL v8.3.
G3E
***
Run the Project
---------------
- The RZ/G3E is a high-performance quad-core MPU. Projects are built for it using an
SDK that was generated with Yocto. You can customize a Yocto image+SDK or use the
pre-built ones. The SDK is intended for a Linux PC environment (WSL, Docker,
etc. can be used on Windows).
- The G3E has a Wayland desktop but it should be stopped with ``systemctl stop weston``
before running the default project since it runs in fullscreen using the OpenGL EGL+DRM driver.
- LVGL is not included in the SDK so you should build whichever version you need. Later
versions of LVGL include the optimal OpenGL driver.
- Clone the ready-to-use repository:
.. code-block:: shell
git clone https://github.com/lvgl/lv_port_renesas_rz-g3e-evkit --recurse-submodules
Downloading the `.zip` from GitHub doesn't work as it doesn't download the submodules.
- Follow the instructions in the project README.md to flash the board bootloader and obtain the
Yocto SD Card image and SDK (pre-built or custom-built), build, and upload the project to the board.
- Stop the Wayland desktop if using the OpenGL, DRM, or fbdev drivers. Run ``systemctl stop weston`` in the terminal.
- Run the project:
.. code-block:: shell
./lvglsim
Modify the project
------------------
Open a demo
~~~~~~~~~~~
The entry point is contained in ``lv_port_linux/src/main.c``.
You can disable the LVGL demos (``lv_demo_benchmark()``) (or just comment them out)
and call some ``lv_example_...()`` functions, or add your own custom code.
Configuration
~~~~~~~~~~~~~
Edit ``lv_conf.h`` to configure LVGL. You can edit ``lv_conf.defaults`` --- a sparse
version of ``lv_conf.h`` which you can use to regenerate ``lv_conf.h`` by running
.. code-block:: shell
python3 lv_port_linux/lvgl/scripts/generate_lv_conf.py
Support
*******
@@ -25,7 +25,7 @@ Supported Boards
| 2-lane MIPI
- .. raw:: html
<iframe width="320" height="180" src="https://www.youtube.com/embed/WkJPB8wto_U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<iframe width="160" height="90" src="https://www.youtube.com/embed/WkJPB8wto_U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas_ek-ra8d1>`__
* - **EK-RA8P1**
@@ -42,7 +42,7 @@ Supported Boards
| Parallel RGB888
- .. raw:: html
<iframe width="320" height="180" src="https://www.youtube.com/embed/PoxDoQp51G8" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<iframe width="160" height="90" src="https://www.youtube.com/embed/PoxDoQp51G8" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas_ek_ra8p1>`__
* - **EK-RA6M3G**
@@ -59,7 +59,7 @@ Supported Boards
| Parallel RGB565
- .. raw:: html
<iframe width="320" height="180" src="https://www.youtube.com/embed/0kar4Ee3Qic" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<iframe width="160" height="90" src="https://www.youtube.com/embed/0kar4Ee3Qic" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
-
| `Demo repository <https://github.com/lvgl/lv_port_renesas_ek-ra6m3g>`__
@@ -77,7 +77,7 @@ Supported Boards
| Parallel RGB565
- .. raw:: html
<iframe width="320" height="180" src="https://www.youtube.com/embed/__56v8DsfH0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<iframe width="160" height="90" src="https://www.youtube.com/embed/__56v8DsfH0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas_rx72n-envision-kit>`__
* - **RZ/G2L-EVKIT**
@@ -91,7 +91,7 @@ Supported Boards
| Micro-HDMI
- .. raw:: html
<iframe width="320" height="180" src="https://www.youtube.com/embed/oeuVvB7y-QA" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<iframe width="160" height="90" src="https://www.youtube.com/embed/oeuVvB7y-QA" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas_rz-g2l-evkit>`__
* - **RZ/G2UL-EVKIT**
@@ -106,7 +106,7 @@ Supported Boards
| with Micro-HDMI bridge
- .. raw:: html
<iframe width="320" height="180" src="https://www.youtube.com/embed/VnynDLR36Xc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<iframe width="160" height="90" src="https://www.youtube.com/embed/VnynDLR36Xc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas_rz-g2ul-evkit>`__
* - **RZ/A3M**
@@ -124,6 +124,37 @@ Supported Boards
| MIPI
- .. raw:: html
<iframe width="320" height="180" src="https://www.youtube.com/embed/IEjBGgrR_mk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
<iframe width="160" height="90" src="https://www.youtube.com/embed/IEjBGgrR_mk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas-ek-rz_a3m>`__
* - **EK-RA8D2**
-
| 1 GHz
| Arm Cortex-M85
-
| 1872KB internal
| 128MB external
| 1MB internal flash
-
| 7”
| 1024x600
| Parallel RGB888
- .. raw:: html
<iframe width="160" height="90" src="https://www.youtube.com/embed/a8eLdqC7rZk" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas_ek-ra8d2>`__
* - **RZ/G3E-EVKIT**
-
| 1.8 GHz
| Arm Cortex-A55
-
| 4GB LPDDR4X SDRAM
-
| 1920x1080
| Micro-HDMI
- .. raw:: html
<iframe width="160" height="90" src="https://www.youtube.com/embed/0vzvV9nKW4Q" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
- `Demo repository <https://github.com/lvgl/lv_port_renesas_rz-g3e-evkit>`__