Difference between revisions of "DESK-MX6-L/Deployment/Customizing the splash screen"

From DAVE Developer's Wiki
Jump to: navigation, search
(→‎U-Boot variables)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
<section begin=History/>
+
<section begin="History" />
 
{| style="border-collapse:collapse; "
 
{| style="border-collapse:collapse; "
−
!colspan="4" style="width:100%; text-align:left"; border-bottom:solid 2px #ededed"|History
+
! colspan="4" style="width:100%; text-align:left" ; border-bottom:solid 2px #ededed" |History
 
|-  
 
|-  
−
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Version
+
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white" |Issue Date
−
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Issue Date
+
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white" |Notes
−
!style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#73B2C7; padding:5px; color:white"|Notes
 
 
|-
 
|-
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|1.0.0
+
| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |{{oldid|14113|2021/07/16}}
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|Oct 2020
+
| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |First DESK release
−
|style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000"|New documentation layout
+
|-
 +
| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |{{oldid|16992|2022/03/04}}
 +
| style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#edf8fb; padding:5px; color:#000000" |DESK-MX6-L 3.0.0 release
 +
|-
 +
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |2023/04/11
 +
! style="border-left:solid 2px #73B2C7; border-right:solid 2px #73B2C7;border-top:solid 2px #73B2C7; border-bottom:solid 2px #73B2C7; background-color:#ededed; padding:5px; color:#000000" |DESK-MX6-L 4.0.0 release
 
|-
 
|-
 
|}
 
|}
−
<section end=History/>
+
<section end="History" />
−
<section begin=Body/>
+
<section begin="Body" />
  
 
==Customizing the splash screen==
 
==Customizing the splash screen==
Line 24: Line 28:
 
* [http://www.denx.de/wiki/DULG/UBootBitmapSupport U-Boot Bitmap Support]
 
* [http://www.denx.de/wiki/DULG/UBootBitmapSupport U-Boot Bitmap Support]
  
−
=== Instructions ===
+
=== Environment variables===
 +
 
 +
The following environment variables are used by U-Boot for loading a BMP image from the selected storage and displayed in the screen (read from framebuffer memory):
 +
 
 +
* <code>splashimage</code>: RAM address where the BMP image is loaded. Please note that it must be a 32-bit aligned address with a 0x2 offset (eg: 0x20000002)
 +
* <code>splashpos</code>: image position (eg: splashpos=m,m, for centering the image)
 +
* <code>splashsize</code>: image size in bytes (default value 0x400000)
  
−
The following U-Boot environment variables are required:
+
The following environment variables are used for reading the splash image from the network:
 +
* <code>splashfile</code>: the splash image filename (default value is <code>splash_image.bmp</code>) to be read from the network
 +
* <code>loadsplashfile</code> loads the splash file from ''tftp'' in order to store the image in the internal storage device
  
−
* splashimage: RAM address where the BMP image is loaded. Please note that it must be a 32-bit aligned address with a 0x2 offset (eg: 0x20000002)
+
Then, the following command is used for reading the image from the used storage device:
−
* loadsplash: comand for loading the BMP image from the storage device (e.g flash memory) to RAM. This command is automatically run by U-Boot at startup
+
* <code>loadsplash</code>: command for loading the BMP image from the storage device (e.g flash memory) to RAM. This command is automatically run by U-Boot when it executes <code>bootcmd</code>
−
* splashpos: image position (eg: splashpos=m,m, for centering the image)
 
  
−
==== Splash image in NOR SPI flash ====
+
=== Splash image in NOR SPI flash ===
  
−
===== U-Boot variables =====
+
The following command is used to store in NOR SPI flash a BMP image loaded via tftp:
  
 
<pre>
 
<pre>
−
loadsplash=run spi_loadsplash
 
−
spi_loadsplash=sf probe; sf read ${splashimage} 0xA00000 ${splashsize}
 
−
splashfile=splash_image.bmp
 
−
splashimage=0x20000002
 
−
splashpos=m,m
 
−
splashsize=0x400000
 
−
loadsplashfile=tftpboot ${loadaddr} axel/${splashfile}
 
 
spi_updatesplash=sf probe; sf erase 0xA00000 +${filesize}; sf write ${loadaddr} 0xA00000 ${filesize}
 
spi_updatesplash=sf probe; sf erase 0xA00000 +${filesize}; sf write ${loadaddr} 0xA00000 ${filesize}
 
</pre>
 
</pre>
  
−
===== Commands =====
+
so, it is possibile to read a splash image from ''tftp'' and store it in NOR SPI:
−
 
 
−
The following commands are used to store in NOR SPI flash a BMP image loaded via tftp:
 
  
 
<pre>
 
<pre>
Line 56: Line 58:
 
</pre>
 
</pre>
  
−
==== Splash image in NAND flash ====
+
=== Splash image in NAND flash ===
  
−
===== U-Boot variables =====
+
The following command is used to store in NAND flash a BMP image loaded via tftp (please note that the NAND mtd partition for the splash image ('''nand-splash''') is defined using the <code>mtdparts</code> parameter, and then referenced by the nand {erase,read,write} commands):
  
 
<pre>
 
<pre>
−
mtdparts=mtdparts=gpmi-nand:8M(nand-uboot),1M(nand-env1),1M(nand-env2),1M(nand-fdt),1M(nand-spare),8M(nand-kernel),4M(nand-splash),-(nand-ubi)
 
−
loadsplash=run nand_loadsplash
 
−
nand_loadsplash=nand read ${splashimage} nand-splash
 
−
splashfile=splash_image.bmp
 
−
splashimage=0x20000002
 
−
splashpos=m,m
 
−
splashsize=0x400000
 
−
loadsplashfile=tftpboot ${loadaddr} axel/${splashfile}
 
 
nand_updatesplash=nand erase.part nand-splash; nand write ${loadaddr} nand-splash ${filesize}
 
nand_updatesplash=nand erase.part nand-splash; nand write ${loadaddr} nand-splash ${filesize}
 
</pre>
 
</pre>
  
−
Please note that the NAND mtd partition for the splash image ('''nand-splash''') is defined using the <code>mtdparts</code> parameter, and then referenced by the nand {erase,read,write} commands.
+
so, it is possibile to read a splash image from ''tftp'' and store it in NAND:
 +
 
 +
<pre>
 +
run loadsplashfile
 +
run nand_updatesplash
 +
</pre>
 +
 
 +
=== Splash image in SD/eMMC ===
  
−
===== Commands =====
+
If an SD card or a eMMC device is used as boot device, the splashscreen image is directly loaded from the storage device.
  
−
The following commands are used to store in NAND flash a BMP image loaded via tftp:
+
In this example, the first partition - FAT format - is used directly reading the ''${splashimage}'' BMP file.
  
 
<pre>
 
<pre>
−
run loadsplashfile
+
mmc_loadsplash=fatload mmc ${mmcdev}:1 ${loadaddr} ${splashfile}; cp.b ${loadaddr} ${splashimage} ${filesize}
−
run nand_updatesplash
 
 
</pre>
 
</pre>
  
 +
so, it is possibile to read directly a splash image from the eMMC partition:
 +
 +
<pre>
 +
loadsplash=run mmc_loadsplash
 +
</pre>
  
 
----
 
----
  
 
[[Category:AXEL Lite]]
 
[[Category:AXEL Lite]]

Latest revision as of 16:57, 8 January 2024

HOME SOMs SBCs ToloMEO Embedded Assistant Sale-tag.pngGET A QUOTE Customer-service.pngONLINE HELPDESK
Roadmap IoT Services ML/AI services Embedded Design Services
History
Issue Date Notes

2021/07/16

First DESK release

2022/03/04

DESK-MX6-L 3.0.0 release
2023/04/11 DESK-MX6-L 4.0.0 release


Customizing the splash screen[edit | edit source]

Resources[edit | edit source]

For further details on splash screen support in U-Boot, please refer to:

Environment variables[edit | edit source]

The following environment variables are used by U-Boot for loading a BMP image from the selected storage and displayed in the screen (read from framebuffer memory):

  • splashimage: RAM address where the BMP image is loaded. Please note that it must be a 32-bit aligned address with a 0x2 offset (eg: 0x20000002)
  • splashpos: image position (eg: splashpos=m,m, for centering the image)
  • splashsize: image size in bytes (default value 0x400000)

The following environment variables are used for reading the splash image from the network:

  • splashfile: the splash image filename (default value is splash_image.bmp) to be read from the network
  • loadsplashfile loads the splash file from tftp in order to store the image in the internal storage device

Then, the following command is used for reading the image from the used storage device:

  • loadsplash: command for loading the BMP image from the storage device (e.g flash memory) to RAM. This command is automatically run by U-Boot when it executes bootcmd

Splash image in NOR SPI flash[edit | edit source]

The following command is used to store in NOR SPI flash a BMP image loaded via tftp: 

spi_updatesplash=sf probe; sf erase 0xA00000 +${filesize}; sf write ${loadaddr} 0xA00000 ${filesize}

so, it is possibile to read a splash image from tftp and store it in NOR SPI: 

run loadsplashfile
run spi_updatesplash

Splash image in NAND flash[edit | edit source]

The following command is used to store in NAND flash a BMP image loaded via tftp (please note that the NAND mtd partition for the splash image (nand-splash) is defined using the mtdparts parameter, and then referenced by the nand {erase,read,write} commands): 

nand_updatesplash=nand erase.part nand-splash; nand write ${loadaddr} nand-splash ${filesize}

so, it is possibile to read a splash image from tftp and store it in NAND: 

run loadsplashfile
run nand_updatesplash

Splash image in SD/eMMC[edit | edit source]

If an SD card or a eMMC device is used as boot device, the splashscreen image is directly loaded from the storage device.

In this example, the first partition - FAT format - is used directly reading the ${splashimage} BMP file. 

mmc_loadsplash=fatload mmc ${mmcdev}:1 ${loadaddr} ${splashfile}; cp.b ${loadaddr} ${splashimage} ${filesize}

so, it is possibile to read directly a splash image from the eMMC partition: 

loadsplash=run mmc_loadsplash
HOME SOMs SBCs ToloMEO Embedded Assistant Sale-tag.pngGET A QUOTE Customer-service.pngONLINE HELPDESK
Roadmap IoT Services ML/AI services Embedded Design Services
Retrieved from "https://wiki.dave.eu/index.php?title=DESK-MX6-L/Deployment/Customizing_the_splash_screen&oldid=19448"