docs(renesas): add a general introduction page (#5969)
This commit is contained in:
committed by
GitHub
parent
9b3e8eec6d
commit
fea8a97f5f
@@ -5,6 +5,7 @@ Chip vendors
|
|||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 2
|
:maxdepth: 2
|
||||||
|
|
||||||
nxp
|
|
||||||
stm32
|
|
||||||
espressif
|
espressif
|
||||||
|
nxp
|
||||||
|
renesas
|
||||||
|
stm32
|
||||||
|
|||||||
82
docs/integration/chip/renesas.rst
Normal file
82
docs/integration/chip/renesas.rst
Normal file
@@ -0,0 +1,82 @@
|
|||||||
|
=======
|
||||||
|
Renesas
|
||||||
|
=======
|
||||||
|
|
||||||
|
[Renesas](https://renesas.com/) is an official partner of LVGL.
|
||||||
|
Therefore, LVGL contains built-in support for [Dave2D](https://lpccs-docs.renesas.com/DA1470x/UM-B-157_DA1470x-GPU-API-Manual/files/doc/overview-txt.html) (the GPU of Renesas)
|
||||||
|
and LVGL also hosts ready-to-use Renesas projects.
|
||||||
|
|
||||||
|
Dave2D
|
||||||
|
------
|
||||||
|
|
||||||
|
Dave2D is capable of accelerating most of the drawing operations of LVGL:
|
||||||
|
|
||||||
|
- Rectangle drawing, even with gradients
|
||||||
|
- Image drawing, scaling, and rotation
|
||||||
|
- Letter drawing
|
||||||
|
- Triangle drawing
|
||||||
|
- Line drawing
|
||||||
|
|
||||||
|
As Dave2D works in the background, the CPU is free for other tasks. In practice, during rendering, Dave2D can reduce the CPU usage by half or to one-third, depending on the application.
|
||||||
|
|
||||||
|
Certified boards
|
||||||
|
----------------
|
||||||
|
|
||||||
|
LVGL has [certified](https://lvgl.io/certificate) one Renesas board so far (more will come soon).
|
||||||
|
|
||||||
|
.. raw:: html
|
||||||
|
|
||||||
|
<iframe width="560" height="315" src="https://www.youtube.com/embed/LHPIqBV_MGA?si=mtW3g-av56bCdR4k" 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>
|
||||||
|
|
||||||
|
Get started with the Renesas ecosystem
|
||||||
|
--------------------------------------
|
||||||
|
|
||||||
|
The official IDE of Renesas is called [e² studio](https://www.renesas.com/us/en/software-tool/e-studio?gad_source=1&gclid=CjwKCAjw5ImwBhBtEiwAFHDZx2V3lumaenbyJnc5Ctrclr_lEQM3G22iZgB-4F92OVLCI7xmzp1YQRoCcRgQAvD_BwE). As it's Eclipse-based, it runs on Windows, Linux, and Mac as well.
|
||||||
|
|
||||||
|
To get started, just download and install e² studio.
|
||||||
|
|
||||||
|
Getting started with LVGL
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
LVGL provides a ready-to-use project for the [EK-RA8D1](https://www.renesas.com/us/en/products/microcontrollers-microprocessors/ra-cortex-m-mcus/ek-ra8d1-evaluation-kit-ra8d1-mcu-group) development board. Its main features from the HMI's point of view are:
|
||||||
|
|
||||||
|
- 480MHz, Arm Cortex®-M85 core
|
||||||
|
- 2MB Code Flash, 1MB SRAM
|
||||||
|
- MIPI DSI & Parallel Graphics Expansion Ports
|
||||||
|
- 4.5 Inch backlit TFT display, 16.7M display colors
|
||||||
|
- 480x854 pixels resolution
|
||||||
|
|
||||||
|
To get a ready-to-use project, clone the [lv_renesas](https://github.com/lvgl/lv_renesas.git) repository:
|
||||||
|
|
||||||
|
..code:: shell
|
||||||
|
git clone https://github.com/lvgl/lv_renesas.git --recurse-submodules
|
||||||
|
|
||||||
|
After that, *Import* ``lv_ek_ra8d1`` into e² studio, build the project, and flash it.
|
||||||
|
|
||||||
|
Note that on the ``SW1`` DIP switch (middle of the board) 7 should be ON, all others are OFF.
|
||||||
|
|
||||||
|
Modify the project
|
||||||
|
------------------
|
||||||
|
|
||||||
|
Open a demo
|
||||||
|
~~~~~~~~~~~
|
||||||
|
|
||||||
|
In `LVGL_thread_entry <https://github.com/lvgl/lv_renesas/blob/master/lv_ek_ra8d1/src/LVGL_thread_entry.c>`__, the demos are automatically enabled based on the settings in `lv_conf.h <https://github.com/lvgl/lv_renesas/blob/master/lv_ek_ra8d1/src/lv_conf.h>`__.
|
||||||
|
|
||||||
|
You can disable all demos (or just comment them out) and call some ``lv_example_...()`` functions, or add your custom code.
|
||||||
|
|
||||||
|
Configuration
|
||||||
|
~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
lv_conf.h contains the most important settings for LVGL. Namely:
|
||||||
|
|
||||||
|
LV_COLOR_DEPTH to set LVGL's default color depth
|
||||||
|
LV_MEM_SIZE to set the maximum RAM available for LVGL
|
||||||
|
LV_USE_DAVE2D to enable the GPU
|
||||||
|
configuration.xml contains the settings for the board and the MCU. By opening this file, all the hardware and software components can be customized in a visual way.
|
||||||
|
|
||||||
|
|
||||||
|
Support
|
||||||
|
-------
|
||||||
|
|
||||||
|
In case of an problems or questions open an issue in the `lv_renesas <https://github.com/lvgl/lv_renesas/issues>`__ repository.
|
||||||
Reference in New Issue
Block a user