Amlogic Customization Tool User Guide V0.5
Amlogic Customization Tool User Guide V0.5
l!
tia
en
Customization Tool User Guide fid
Revision 0.5
on
C
c
gi
AMLOGIC, Inc.
lo
U.S.A.
www.amlogic.com
AMLOGIC reserves the right to change any information described herein at any time without notice.
AMLOGIC assumes no responsibility or liability from use of such information.
Revision history
Revision Date Owner Changes
0.1 September 13, 2013 Pei Pei Initial version release
0.2 November 18, 2013 Pei Pei Modify the name of the program for picture
modification, installation and execution. Add
description for adding wall paper, file replacement
and upgrade. Modify functions for settings loading,
Key, advanced configuration, etc.
0.3 December 12, 2013 Pei Pei Add function for wifi configuration and data, Media
partition settings
0.4 January 14, 2014 Pei Pei Modify tool details
l!
0.5 April 17, 2014 Pei Pei Modify tool extraction options which is divided to four
tia
levels. Different actions can be run at each level.
Separate the parse of Key and DTD.
en
fid
on
C
c
gi
lo
m
A
Tablet of Content
1. Intro ................................................................................................................................................................................ 4
2. Tool and Environment Setup ...................................................................................................................................... 5
2.1 Tool Installation..................................................................................................................................................... 5
2. 2 JDK Development Environment Installation ....................................................................................................... 6
2.2.1 Download JDK ........................................................................................................................................ 6
2.2.2 Install JDK ................................................................................................................................................ 6
2.2.3 Enter System Variable Interface ........................................................................................................... 6
2.2.4 Set System Variable JAVA_HOME ...................................................................................................... 6
2.2.5 Set System Variable PATH .................................................................................................................... 6
2.2.6 Set System Variable CLASSPATH ....................................................................................................... 7
l!
2.2.7 Verify Working Environment .................................................................................................................. 7
3. Run the Tool .................................................................................................................................................................. 8
tia
4. Open Image Package .................................................................................................................................................. 9
4.1 Unpack Image Package ......................................................................................................................................... 9
en
5. Modify Product Information ....................................................................................................................................... 12
5.1 Modify Product Name and Vendor ...................................................................................................................... 12
5.2 Modify Wallpaper................................................................................................................................................ 12
fid
5.3 Modify Power-on Logo ....................................................................................................................................... 13
5.4 Modify Boot-up Logo ......................................................................................................................................... 13
on
l!
tia
en
fid
on
C
c
gi
lo
m
A
2. Tool and Environment Setup
2.1 Tool Installation
Click the CustomizationTool.msi in the installation package to start installing the customization tool and simply
choose Next to proceed. The user can manually select the installation path. The selected disc needs at least
2GB free space.
l!
tia
en
fid
on
If the info “can not open file for writing msvcrt.dll” pops up during installing, please quit antivirus software and
c
try again.
gi
lo
m
A
The Windows users can download the 32bit/64bit version JDK according to their platforms respectively.
l!
2.2.3 Enter System Variable Interface
tia
To enter the environment variable interface:
Windows XP: My computer -> Property -> Advanced -> System variable
Windows7 (32bit): My computer -> Property -> Advanced System Settings -> System variable
en
2.2.4 Set System Variable JAVA_HOME
Click the New button in “System Variable” and enter the interface for “New User Variable” (Figure 2.1);
fid
Enter JAVA_HOME in textbox “Variable name”;
Enter JDK installation path in textbox “Variable value” (e.g., F:\jdk) ;
on
Double clock the system variable PATH and enter “Edit System Variable” interface (Figure 2.2);
In the end of textbox “Variable Value”, add ;%JAVA_HOME%\bin;
Click “OK” to exit “Edit System Variable” interface.
Figure 2.2 Set system variable PATH
l!
tia
en
Figure 2.3 Set System Variable CLASSPATH
Please do not skip the “.” At the beginning of variable value.
fid
2.2.7 Verify Working Environment
Start Run, Enter cmd, pree Enter and enter DOS. Type javac and press Enter. If the java help info is shown,
it means the environment has been successfully set, otherwise it needs to be reconfigured.
on
C
c
gi
lo
m
A
3. Run the Tool
After finishing the installation, click the shortcut of CustomizationTool.exe, the main interface of the tool will be
popped up (Figure 3.1). At this moment, all the tabs are un-editable except for image loading.
l!
tia
en
fid
on
C
c
gi
In the tool main (Figure 3.1), click “load” and the unpack option dialog (Figure 4.1) is popped up. After loading
the original image pack, it will enter the following unpack interface (Figure 4.2), which will show it is under
unpacking. According to the different options, it will take 30 seconds to several minutes.
l!
tia
en
fid
on
In the unpack option dialog, there are four options: Among them,
C
When choosing the option “Show the first level of image”, the tool will unpack the first level. After successfully
done, it will show tabs such as “Basic Info”, “Kernel DTD”, “Keys”, “DDR”, and “Advanced”. The user can edit
c
DTD, DDR, modify partition table, set key to be burned and replace Uboot/Kernel, etc. (Figure 4.2).
gi
lo
m
A
l!
tia
en
fid
on
When choosing the option “Show Product Information”, the tool will unpack the system image based on the
first level unpacking. After successfully done, it will show “Product Info”, “System APK” tabs and activate part
C
of buttons in “Advanced” tab. The user can modify product information, replace Poweron, bootup logo, boot
animation, add/remove system APK, and edit files manually etc.
c
gi
lo
m
A
l!
tia
en
fid
on
C
c
In the Product Info tab, enter the value in Model edit box to change the model name; enter the value in the
Vendor edit box to change the system product vendor and enter the value in Product edit box to change the
system product name.
The contents in android version and disk name edit box cannot be modified.
l!
tia
en
fid
Figure 5.1 Modify product information
on
Click the Wallpaper tab (Figure 4.2) ,click <Set> at the bottom and open the wallpaper setting dialog (Figure
5.3). It will show the system default wallpapers. The user can choose one of the picture as the default
c
wallpaper or add/remove the user defined pictures. The pictures need to be in jpg format. It is preferred to use
high resolution pictures which will provides a better effect.
gi
lo
m
A
en
5.3 Modify Power-on Logo
Click the Power-on Logo tab (Figure 5.4), click <Open> at the bottom and load the power-on logo picture,
fid
which is in bmp format.
on
C
c
gi
lo
m
A
Click the boot-up logo (Figure 5.5), click <Open> at the bottom and load the new boot-up logo picture, which is
in jpg or bmp format.
l!
tia
en
fid
Figure 5.5 Modify boot-up logo
on
Click the animation tab (Figure 5.6), click <Open> at the bottom and load the new boot-up animation pack,
which is in zip format.
c
gi
lo
m
A
l!
tia
en
fid
Figure 6.1 Modify default parameters
on
l!
tia
6.4 Import and Export Settings
When selecting ExportSetting in the Setting pull-down menu, the export setting option dialog will be popped
en
up. Choose the required export options including product information, default setting and partition size and
then compress the setting info into a zip file; fid
When selecting ImportSetting in the Setting pull-down menu, the import setting option dialog will be popped
up. The user can decompress the zip fle and load the setting info into the current setting. The settings to be
on
l!
Figure 6.6 Extract default device settings
tia
en
fid
on
C
c
gi
lo
m
A
7.Partition Table Info
In the partition table info, it lists three items including table name, image size and partition size. The user can
edit the partition size (Figure 7.1). After editing, click “Save” to save the modification. In addition, the partition
can be also add or remove. Click “Add Partition” (Figure 7.2) and enter the name, size, offset and device
location (1: code device, 2: data device) of the partition to be added.
l!
tia
en
fid
Figure 7.1 Partition table settings
on
C
c
gi
lo
m
A
l!
tia
en
fid
on
l!
tia
en
fid
Figure 9.1 Replace APK signature file
on
C
c
gi
lo
m
A
10.Edit Dtd File
The user can view and modify Dtd file in KernelDtd tab where the left category tree is divided into three levels,
Module, Device and Property. Each modules contains several Device and each devices contains several
Property. When clicking one Module, the right panel will show the status of all Device under this Module
(Figure 10.1), such as Uart. It will also show whether the Device is able to set up and whether it is enabled,
etc.
l!
tia
en
fid
on
C
When clicking one of the devices, the property names and related descriptions of this device will be shown in
c
When click one of the properties or double click in the right panel, it will show the specific settings of this
property (Figure 10.3). To modify the property, click Modify and the dialog will pop up (Figure 10.4), where the
user can modify the values, such as String, U32. For property in Choice type, it is also possible to jump into
the related property to set up.
l!
tia
en
Figure 10.3 Property settings
fid
on
C
c
gi
lo
m
By clicking “Edit DTD”, the user can manually edit the DTD file and by clicking “Edit DTS”, the user can
A
manually edit the DTS file generated by the DTS (Figure 10.5).
l!
tia
Figure 10.5 Manually edit DTD, DTS file
en
If the user has modified the DTD or DTS, DTB file will need to be re-generated by clicking “Gen DTB”. If
successful, it will show as Figure 10.6.
fid
on
C
c
gi
l!
tia
en
fid
on
l!
Figure 12.1Add Data partition and Media partition
tia
Double clicking “DataFile” button will open the corresponding Data partition file folder. Then the user can add
the file here (Figure 12.2) or simply drag the files in the “Data File” table.
en
fid
on
C
c
gi
lo
Before adding Media partition, the user needs to make Media partition exist in the partition table. Otherwise
A
Figure 12.3 Unable to create actual Media partition when not existing in partition table
Double clicking “MediaFile” button will open the corresponding Media partition file folder. Then the user can
add the file here (Figure 12.4) or simply drag the files in the “Media File” table.
l!
tia
en
Figure 12.4 Add Media partition files
fid
on
C
c
gi
lo
m
A
13.Advance
The advance tab is for manually editing the configuration file to change the system settings (Figure 13.1).
l!
tia
Figure 13.1 Advanced configurations
en
Clicking Build prop button will open the Build.prop for manual edit (Figure 13.2).
fid
on
C
c
gi
lo
m
A
Clicking the Keyboard map button will open the \tmp\level2\system\usr\keylayout folder under the executive
file folder (Figure 13.3).
Figure 13.3 Open \tmp\level2\system\usr\keylayout folder
l!
Clicking open work dir button will open the installation directory (Figure 13.4).
tia
en
fid
on
C
c
gi
Click “Init.rc”, “Init.amlogic.rc”, “Init.amlogic.board.rc” will open Init.rc, Init.amlogic.rc, Init.amlogic.board.rc file
m
l!
tia
en
Figure 13.6 Replace file in Uboot
fid
on
C
c
gi
lo
When “WifiConfig” button is activated, click it will pop up the customization page for WIFI device configuration.
The user can select the corresponding module of the target device and assign the driver and lib files. For
A
example for K200-A device, checking rtl8188eu device status checkbox will replace the driver and lib files
under system/wifi/, which implements the wWIFI device customization (Figure 13.8).
l!
tia
Figure 13.8 Choose the corresponding WIFI module of the target device
en
fid
on
C
c
gi
lo
m
A
14.Generate New Image Package
After finish the system customization, new image package needs to be generated. Click Pack button (Figure
14.1), enter the new customization image pack in the pop-up directory section dialog and start the new image
packing. According to different options, the whole packing time will take 30 second to 2 minutes.
l!
tia
en
fid
on
C
c
l!
tia
en
Figure 15.2 Set to Chinese
fid
on
C
c
gi
lo
m
A
16. Online Upgrade
By selecting Upgrade under the Help menu, the tool will connect to Amlogic FTP server to obtain the latest
version of customization tool (Figure 16.1). Make sure the network is connected (Figure 16.2).
l!
tia
Figure 16.1 Choose to upgrading to the latest version
en
fid
on