@@ -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 2d4f5ea1fb9..5d522e6a28e 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 4e07cea3925..33d1530e570 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.