xref: /rk3399_ARM-atf/tools/nxp/create_pbl/README (revision 9719e19a977df3e8bf7567b3c0e1d6b2ebc5b46f)
1*32669476SPankaj GuptaDescription:
2*32669476SPankaj Gupta------------
3*32669476SPankaj GuptaTool 'create_pbl' is a standalone tool to create the PBL images.
4*32669476SPankaj Gupta	 where,
5*32669476SPankaj Gupta	     On the basis of Chassis,
6*32669476SPankaj Gupta	     RCW image is placed first followed by the,
7*32669476SPankaj Gupta	     PBI commands to copy the,
8*32669476SPankaj Gupta	     Input BL2 image stored on the,
9*32669476SPankaj Gupta	     Specified boot source (QSPI or SD or NOR) to the,
10*32669476SPankaj Gupta             Specified destination address.
11*32669476SPankaj Gupta
12*32669476SPankaj Gupta
13*32669476SPankaj GuptaUsage in standalone way:
14*32669476SPankaj Gupta-----------------------
15*32669476SPankaj Gupta
16*32669476SPankaj Gupta./create_pbl [options] (mentioned below):
17*32669476SPankaj Gupta
18*32669476SPankaj Gupta	-r  <RCW file-name>         - name of RCW binary file.
19*32669476SPankaj Gupta	-i  <BL2 Bin file-name>     - file to be added to rcw file.
20*32669476SPankaj Gupta	-c  <SoC Number>            - SoC numeric identifier, may be one of
21*32669476SPankaj Gupta                                  1012,1023,1026.1028,
22*32669476SPankaj Gupta                                  1043,1046,1088,2080,
23*32669476SPankaj Gupta                                  2088,2160
24*32669476SPankaj Gupta	-b  <boot source id>        - Boot source id string, may be one of
25*32669476SPankaj Gupta                                  "qspi", "nor", "nand", "sd", "emmc"
26*32669476SPankaj Gupta	-d  <Address>               - Destination address where BL2
27*32669476SPankaj Gupta	                              image is to be copied
28*32669476SPankaj Gupta	-o  <output filename>	    - Name of PBL image generated
29*32669476SPankaj Gupta	                              as an output of the tool.
30*32669476SPankaj Gupta	-e  <Address>               - [Optional] Entry Point Address
31*32669476SPankaj Gupta	                              of the BL2.bin
32*32669476SPankaj Gupta	-f  <Address>               - BL2 image offset
33*32669476SPankaj Gupta	                              on Boot Source for block copy.
34*32669476SPankaj Gupta	                              command for chassis >=3.)
35*32669476SPankaj Gupta				      (Must for Ch3, Ignored for Ch2)
36*32669476SPankaj Gupta	-h  Help.
37*32669476SPankaj Gupta	-s  Secure boot.
38*32669476SPankaj Gupta
39*32669476SPankaj Gupta		-s 	secure boot
40*32669476SPankaj Gupta		-c	SoC Number (see description above)
41*32669476SPankaj Gupta		-b	Boot source.
42*32669476SPankaj Gupta		-r	RCW binary file.
43*32669476SPankaj Gupta		-i	Input file that is to be added to rcw file.
44*32669476SPankaj Gupta		-o	Name of output file
45*32669476SPankaj Gupta		-f	Source Offset (Block Copy)
46*32669476SPankaj Gupta		-d	Destination address to which file has to be copied
47*32669476SPankaj Gupta		-h	Help.
48*32669476SPankaj Gupta
49*32669476SPankaj GuptaExample:
50*32669476SPankaj Gupta	./create_pbl -r <RCW file> -i <bl2.bin> -c <chassis_no> -b <boot_source = sd/qspi/nor> -d <Destination_Addr> -o <pbl_image_name>
51*32669476SPankaj Gupta
52*32669476SPankaj Gupta
53*32669476SPankaj Gupta
54*32669476SPankaj GuptaUsage at compilation time:
55*32669476SPankaj Gupta--------------------------------
56*32669476SPankaj Gupta
57*32669476SPankaj Gupta	make <compilation command......> pbl RCW=<Path_to_RCW_File>/<rcw_file_name.bin>
58*32669476SPankaj Gupta
59*32669476SPankaj GuptaExample: QSPI Boot For LS1046ARDB-
60*32669476SPankaj Gupta
61*32669476SPankaj Gupta	make PLAT=ls1046rdb all fip BOOT_MODE=qspi SPD=opteed BL32=tee.bin BL33=u-boot-ls1046.bin pbl RCW=/home/pankaj/flexbuild/packages/firmware/dash-rcw/ls1046ardb/RR_FFSSPPPN_1133_5506/rcw_1600_qspiboot.bin
62*32669476SPankaj Gupta
63*32669476SPankaj GuptaExample: QSPI Boot For LX2160ARDB-
64*32669476SPankaj Gupta
65*32669476SPankaj Gupta	make PLAT=lx2160ardb all fip BOOT_MODE=flexspi_nor SPD=opteed BL32=tee_lx2.bin BL33=u-boot_lx2160.bin pbl RCW=plat/nxp/soc-lx2160/lx2160ardb/rcw_1900_600_1600_19_5_2.bin
66