From 13b742236d631299ec31fb786d552407269b8f95 Mon Sep 17 00:00:00 2001 From: Gregory Nutt Date: Mon, 13 Nov 2017 15:49:38 -0600 Subject: [PATCH] Update some README files. --- Documentation/README.html | 3 ++- README.txt | 1 + configs/stm32f429i-disco/fb/README.txt | 36 ++++++++++++++------------ 3 files changed, 23 insertions(+), 17 deletions(-) diff --git a/Documentation/README.html b/Documentation/README.html index 8a2176d533..8b33f7bae7 100644 --- a/Documentation/README.html +++ b/Documentation/README.html @@ -8,7 +8,7 @@

NuttX README Files

-

Last Updated: November 6, 2017

+

Last Updated: November 13, 2017

@@ -285,6 +285,7 @@ nuttx/ | |- stm32f411e-disco/ | | `- README.txt | |- stm32f429i-disco/ + | | |- fb/README.txt | | |- ide/ltcd/uvision/README.txt | | `- README.txt | |- stm32f746g-disco/ diff --git a/README.txt b/README.txt index 2d4f5ea1fb..5d522e6a28 100644 --- a/README.txt +++ b/README.txt @@ -1827,6 +1827,7 @@ nuttx/ | |- stm32f411e-disco/ | | `- README.txt | |- stm32f429i-disco/ + | | |- fb/README.txt | | |- ide/ltcd/uvision/README.txt | | `- README.txt | |- stm32f746g-disco/ diff --git a/configs/stm32f429i-disco/fb/README.txt b/configs/stm32f429i-disco/fb/README.txt index 4e07cea392..33d1530e57 100644 --- a/configs/stm32f429i-disco/fb/README.txt +++ b/configs/stm32f429i-disco/fb/README.txt @@ -4,23 +4,25 @@ README.txt STM32F429I-DISCO LTDC Framebuffer demo example Configure and build ------------------------------------------------ +------------------- + cd tools -./configure -a stm32f429i-disco/ltdc +./configure -a stm32f429i-disco/fb cd .. make Note! In the current implementation the DMA2D driver only supports clut pixel format -if the LTDC driver it does. Otherwise it will not be compatible with the nx -framework. If CONFIG_FB_CMAP is configured, nx expects that any pixel format +if the LTDC driver it does. Otherwise it will not be compatible with the NX +framework. If CONFIG_FB_CMAP is configured, NX expects that any pixel format supports color lookup tables. This is also the case for non CLUT formats e.g. -FB_FMT_RGB16_565. This may result in wrong color representation by nx if the +FB_FMT_RGB16_565. This may result in wrong color representation by NX if the pixel format is unequal to FB_FMT_RGB8. On the other hand layers with CLUT pixel format are not supported by the DMA2D controller, in the case they will be used as destination layer for the following operations: + - blit - blend - fillarea @@ -29,21 +31,23 @@ To enable clut support in both LTDC and DMA2D driver the following configurations are valid: 1. + - Enable LTDC_INTERFACE and LAYER1/LAYER2 - Layer1 FB_FMT_RGB8 - Layer2 any non clut format But Layer2 can only be used as destination layer for dma2d operations above. -This configuration is not compatibly to nx because LAYER2 will be referenced +This configuration is not compatibly to NX because LAYER2 will be referenced by up_fbgetvplane and is an invalid CLUT pixel format. 2. + - Enable LTDC_INTERFACE and LAYER1/LAYER2 - Layer2 FB_FMT_RGB8 - Layer1 any non clut format But Layer1 can only be used as destination layer for dma2d operations above. -This configuration should be compatibly to nx because LAYER2 will be referenced +This configuration should be compatibly to NX because LAYER2 will be referenced by up_fbgetvplane and is an valid CLUT pixel format. All other non clut configuration work fine. @@ -54,17 +58,17 @@ specific configuration. Loading ------------------------------------------------ +------- + st-flash write nuttx.bin 0x8000000 Executing ------------------------------------------------ -The ltdc is initialized during boot up. -Interaction with NSH is via the serial console at 115200 8N1 baud. -From the nsh comandline execute one (or both) of the examples: -- nx (default nx example) -- ltdc (trivial ltdc interface test) +--------- -Note! The ltdc example ends in an infinite loop. To get control of the nsh -start this example in the background with 'ltdc &'. +The ltdc is initialized during boot up. Interaction with NSH is via the serial +console at 115200 8N1 baud. From the nsh comandline execute the fb example: + + nsh> fb + +The test will put a pattern of concentric squares in the framebuffer and terminate.