xref: /OK3568_Linux_fs/tools/linux/Firmware_Merger/user_manual.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1    firmware_merger read setting.ini to get partition info and create firmware.firmware_merger can generate
2three kinds of firmware(1.flat rk firmware 2.flat gpt firmware 3.compact gpt firmware).flat firmware can be
3directly written into flash by 'wl'command.Compact firmware can only be written by productiontool. when SPL
4is rk miniloader,firmware use flat rk format.when SPL is u-boot,firmware use flat gpt.
5
6follow us to config settting.ini:
71.set format of firmware
8Gpt_Enable= /*flat rk firmware*/
9Gpt_Enable=0 /*flat gpt firmware*/
10Gpt_Enable=1 /*compact gpt firmware*/
11
122.backup header of firmware or not
13Backup_Partition_Enable=1 /*backup firmware header*/
14Backup_Partition_Enable= /*default,no backup firmware header,when you don't know flash size,no backup*/
15
163.idblock partition (must be first partition)
17Name=IDBlock /*partition name,fixed 'IDBlock'*/
18Type=0x2     /*partition type,fixed=2*/
19PartOffset=0x40 /*partition offset,fixed=0x40*/
20PartSize=0x400  /*partition size,must be smaller than 2M*/
21Flag=           /*partition flag,default value*/
22File=Image/FlashData.bin,Image/FlashBoot.bin /*ddr_init.bin,loader.bin*/
23
244.layout other partition sequentially,four case to config
25a.written partition file and fill up to partition size
26Flag=
27File=partition file
28
29b.partition be filled up to partition size
30Flag=0x2
31File=/*do not set*/
32
33c.skip,none of data be written to partition
34Flag=0x1
35File=/*do not set*/
36
37d.last partition,partition size be set at runtime,alloc all of remain flash to it
38Flag=0x4
39File=/*set file as required*/
40
415.fix partition uuid
42a.add Type_Guid=UuidKeyName into partition section
43b.add uuid item into PARTITION_TYPE_GUID section
44example:
45[userPart1]
46Name=rootfs
47Type_Guid=rootfs_uuid
48[PARTITION_TYPE_GUID]
49rootfs_uuid=00000000-0000-0000-0000-000000000000