chore(NemaGFX): add missing header, correct the docs, provided HAL is optional (#7174)

This commit is contained in:
Liam
2024-11-06 16:52:51 +01:00
committed by GitHub
parent 9d80bfa780
commit 17d0169e50
7 changed files with 48 additions and 25 deletions

View File

@@ -292,4 +292,4 @@ If ``LV_USE_DRAW_DMA2D_INTERRUPT`` is enabled then you are required to call
:cpp:expr:`lv_draw_dma2d_transfer_complete_interrupt_handler` whenever the DMA2D
"transfer complete" global interrupt is received.
If your STM device has a Nema GPU, you can use the :ref:`Nema GFX renderer <stm32_nema_gfx>` instead.
If your STM device has a NeoChrom GPU, you can use the :ref:`Nema GFX renderer <nema_gfx>` instead.

View File

@@ -95,8 +95,8 @@ See the :ref:`DMA2D support <dma2d>`.
.. admonition:: Further Reading
You may be interested in enabling the :ref:`Nema GFX renderer <stm32_nema_gfx>`
if your STM32 has a GPU which is supported by Nema GFX.
You may be interested in enabling the :ref:`Nema GFX renderer <nema_gfx>`
if your STM32 has a NeoChrom GPU.
`lv_port_riverdi_stm32u5 <https://github.com/lvgl/lv_port_riverdi_stm32u5>`__
is a way to quick way to get started with LTDC on LVGL.

View File

@@ -1,12 +1,12 @@
.. _stm32_nema_gfx:
.. _nema_gfx:
===================================
NemaGFX Acceleration (AKA NeoChrom)
===================================
====================
NemaGFX Acceleration
====================
Some of the more powerful STM32 MCUs such as the
STM32U5 feature a 2.5D GPU which can natively draw most
LVGL primitives.
NemaGFX is a high-level graphics API supported
by many embedded 2.5D GPUs. LVGL can use it to
natively render LVGL graphics.
Get Started with the Riverdi STM32U5 5-inch Display
***************************************************
@@ -48,11 +48,10 @@ At the time of writing, :c:macro:`LV_USE_OS` support is experimental
and not yet working in
`lv_port_riverdi_stm32u5 <https://github.com/lvgl/lv_port_riverdi_stm32u5>`__
"src/draw/nema_gfx/lv_draw_nema_gfx_hal.c" implements the HAL functionality
required by Nema to allocate memory and lock resources (in this implementation,
no locking is done). It may conflict with existing definitions
if you have an existing Nema HAL implementation. You may
simply be able to remove yours.
NemaGFX requires a simple HAL implementation to allocate memory and optionally
lock resources. You may use a custom HAL implementation for your platform or use one of the
provided implementations by setting :c:macro:`LV_USE_NEMA_HAL` to a value other than
:c:macro:`LV_NEMA_HAL_CUSTOM`.
TSC Images
**********