View source for How to use a splash screen with VisionSOM-6ULL

{{PageHeader|How to use a splash screen with VisionSOM-6ULL}}


[[Image:sl_wiki_new_version_600x180.jpg|center|link=VisionSOM-6ULL]]


== Prerequisites ==
* PC with Microsoft Windows 10 64-bit OS or Linux Ubuntu 16.04+ (only for flashing NAND memory)
* A complete package with NXP UUU application (only for flashing NAND memory) - [http://ftp.somlabs.com/Tools/somlabs-visionsom-flasher.zip ftp.somlabs.com/Tools/somlabs-visionsom-flasher.zip]
* splash.bmp - splash screen bitmap file (from the complete package above or generated by yourself)

== Information ==
* SoMLabs solution is based on NXP UUU tool (Universal Update Utility), with some extensions added on top of it to easly handle SoMLabs boards.
* Please note also, that file can be located in any directory - you need to specify complete file path then.
* If you are using VisionSOM module with i.MX6UL processor, please change in commands given below '6ull' to '6ul'
* Default NAND paritions layout for 4M boot variant (remaining NAND area is used for root file system by default):
[[File:VCB_UUU_flasher_NAND_map.png|center|200px]]

== Splash screen bitmap file ==
A maximum size of splash image file is 800x480px (equal to SL-TFT7-TP-800-480-P display resolution), bpp shall be 24-bit or 8-bit with pallete.
Image shall be stored as .bmp file. Please ensure that file size must be smaller than 1MB.

== Preparing for flashing splash screen to NAND memory ==
For programming NAND memory of VisionSOM-6ULL, switch boot selector to mode: SERIAL.
{| class="wikitable"
! colspan="2" style="text-align: center; font-weight: bold;" | BOOTx
! rowspan="2" style="text-align: center; font-weight: bold;" | Boot Mode
|-
| BOOT1
| BOOT0
|-
| 1
| 1
|Reserved
|-
| 1
| 0
|Internal
|-
|'''0
|'''1
|'''Serial
|-
| 0
| 0
|Fuses
|}

Connect the VisionCB-6ULL-STD board to the host PC using microUSB cable connected to the USB-OTG connector. To observe progress/error reports during programming, please use serial console. If you are using standard VisionSOM carrier board (VisionCB-6ULL-STD), this can be done by using build in serial/usb converter.

== Flashing splash screen to NAND (from Windows host machine) ==
Run command:
<pre>uuu.exe -b vsom_6ull_nand_splash splash.bmp</pre>

== Flashing splash screen to NAND (from Linux host machine) ==
Make UUU executable:
<pre>chmod 755 uuu</pre>
Run command:
<pre>sudo ./uuu -b vsom_6ull_nand_splash splash.bmp</pre>

{| class="frame-green"
|-
|Be aware if any of erase blocks in 'splash' partition are bad, then max. size of splash screen will be smaller. To meet the size limit, it is possible to compress a bitmap file with gzip and write compressed file to NAND.
|}

== Flashing splash screen to eMMC/SD card ==
There is no need to perform any additional step to program custom splash image - for applying a splash screen, simply put prepared 'splash.bmp' file into '/boot' directory of the root file system. Please ensure if u-boot on your SD card image supports splash screen displaying.