========= Tips for boot logo on ODROID-C2 =======

**ODROID-C2** can show a booting logo on the display till target O/S is started.

===== Logo File Format =====
The image format of ODROID-C2 logo file is as following.

<code>
Image Format : 24-bit Windows BMP image or 24-bit Windows Gzipped BMP image (Without meta-data)
Image Size : 1280 by 720
Color Depth : 24bpp
The file name should be 'boot-logo.bmp' or 'boot-logo.bmp.gz'
</code>

Here is the sample bmp file.
{{:en:boot-logo.bmp.gz|}}

We recommend using GIMP or KolourPaint.


If you're using "GIMP", keep the options as following.
<code>
- Export as Windows BMP
- Compatibility Options : Do not write Color Space Information
- Advanced Options : 24 bits
- Name : "boot-logo.bmp"
</code>

If you're using KolourPaint, refer to the following.
<code>
- Save Image as 
- Filter : Windows BMP image
- Convert to : 24-bit Color
</code>

And please keep the size of your bmp file must be under 2MB because the logo partition is limited to 2MB.
Gzip BMP format is supported, so if the size is over 2MB, you can use bmp.gz file.
<code>
$ gzip boot-logo.bmp 
$ ls 
boot-logo.bmp.gz
</code>

On ODROID-C2 uboot, **image scaling for boot logo** is supported, so displayed boot logo will be fixed automatically for output mode as described in boot.ini.


For example, in case of using the mode "1024x600p60hz", boot logo will be displayed as 1024x600 even though actual size of bmp file is 1280x720.

<WRAP left round tip 80%>
  * Logo scaling with 1280x720 bmp image is available with Android release, v1.9 or higher version.
  * On Ubuntu, it will be released.
  * You can show boot logo of 1280x720 bmp file with the current or old uboot but, to support another resolution of logo, you need to adjust bmp file size if you want to display native size of logo.
</WRAP>
===== How to replace boot logo with your custom image =====

=== Android ===
On Android, you can write your custom boot logo to 'FAT' area.


Or if you want to replace the default logo image in the android 'Logo' partition, follow the second instruction. But the first one with FAT area is easier and preferred.

== 1. VFAT ==
Copy the new boot-logo.bmp (or boot-logo.bmp.gz) to **VFAT** partition. 

== 2. Android Logo Partition ==
The logo partition is internally assigned in **U-boot** itself, please refer [[http://odroid.com/dokuwiki/doku.php?id=en:c2_partition_table#android_partition_table|this]] for detail. This works just for **Android Users**.

First, you must get into your **U-boot** command line while pressing any key when your **ODROID-C2** is powered up. And execute **fastboot** command from **U-boot** and connect with your desktop using USB cable.
<code>
odroidc2#fastboot
</code>
Next, run **fastboot** command from your desktop.
<code>
$ fastboot flash logo boot-logo.bmp.gz
or 
$ fastboot flash logo boot-logo.bmp
</code>

<WRAP center round important>
If you will use bmp data on logo partition, make sure there is NO boot-logo.bmp.gz file on your VFAT area, because U-Boot checks very first if there is boot-logo.bmp.gz on VFAT area and then check logo partition.\\

You need this special cable to access the U-boot command.\\
[[http://www.hardkernel.com/main/products/prdt_info.php?g_code=G134111883934]]

You also need a normal micro-USB cable for the fastboot/adb interface between C2 and your host PC too.\\
[[http://www.hardkernel.com/main/products/prdt_info.php?g_code=G134114594259]]

</WRAP>

=== Ubuntu ===
Copy the new boot-logo.bmp (or boot-logo.bmp.gz) with to **boot** partition. 

===== Add a command on boot.ini =====

You should add the commands to your **boot.ini** before **bootcmd** is executed.

Please check if there is 'showlogo' command in your boot.ini first.
If not so, refer to the following.

=== Android ===

<code>
showlogo ${hdmimode}
</code>

=== Ubuntu ===
<code>
showlogo ${m}
logoopt "osd1,loaded,0x3f800000,${m}"

# Boot Arguments - Add logo args on the existing bootargs parameter
setenv bootargs "root=UUID=e139ce78-9841-40fe-8823-96a304a09859 rootwait ro ${condev} no_console_suspend hdmimode=${m} m_bpp=${m_bpp} vout=${vout} fsck.repair=yes net.ifnames=0 elevator=noop disablehpd=${hpd} logo=${logoopt}"
</code>

===== [Optional] Additional instruction for VU7+/VU7 power and signal type =====

To turn on USB Host power on uboot stage for power of VU7+/VU7, you should add one command, **usb pwren** after showlogo command in boot.ini.

And you need to change the signal type of display to DVI interface.

<code>
setenv vout_mode "dvi"
showlogo ${hdmimode}
usb pwren
</code>




===== [Optional] How to use the custom image with Native resolution like 1024x600 or 800x480 except 1280x720 =====

If you want to use a native resolution of bmp image like 1920x1080, 1024x600 (for VU7+) or 800x480 (for VU7) except 1280x720, please set the arg[2]/arg[3] of **showlogo** command as following.

Copy the bmp file as an aforementioned instruction first and then modify 'showlogo' command in boot.ini.
The arg[2]/arg[3] of showlogo means image size of bmp file.

<code>
odroidc2#help showlogo
showlogo - Displaying BMP logo file to HDMI screen with the specified resolution

Usage:
showlogo <resolution> [<bmp_width> <bmp_height>]
        resolution - screen resoltuion on HDMI screen
                '1080p60hz' will be used by default if missing
        bmp_width (optional) - width of logo bmp file
                '1280' will be used by default if missing
        bmp_height (optional) - height of logo bmp file
                '720' will be used by default if missing
</code>

< Examples >

1. 1080p case

 
If your monitor's resolution is 1920by1080 and you want to set a bmp file in 1920x1080 not 1280x720 one as a boot logo file, set command in boot.ini as following.

<code>
setenv hdmimode "1080p60hz"
showlogo ${hdmimode} 1920 1080
</code>



2. 1024x600 case
<code>
setenv hdmimode "1024x600p60hz"
showlogo ${hdmimode} 1024 600
</code>


3. 800x480 case
<code>
setenv hdmimode "800x480p60hz"
showlogo ${hdmimode} 800 480
</code>