xref: /arm-trusted-firmware/tools/nxp/create_pbl/README (revision 91f16700b400a8c0651d24a598fc48ee2997a0d7)
1*91f16700SchasingluluDescription:
2*91f16700Schasinglulu------------
3*91f16700SchasingluluTool 'create_pbl' is a standalone tool to create the PBL images.
4*91f16700Schasinglulu	 where,
5*91f16700Schasinglulu	     On the basis of Chassis,
6*91f16700Schasinglulu	     RCW image is placed first followed by the,
7*91f16700Schasinglulu	     PBI commands to copy the,
8*91f16700Schasinglulu	     Input BL2 image stored on the,
9*91f16700Schasinglulu	     Specified boot source (QSPI or SD or NOR) to the,
10*91f16700Schasinglulu             Specified destination address.
11*91f16700Schasinglulu
12*91f16700Schasinglulu
13*91f16700SchasingluluUsage in standalone way:
14*91f16700Schasinglulu-----------------------
15*91f16700Schasinglulu
16*91f16700Schasinglulu./create_pbl [options] (mentioned below):
17*91f16700Schasinglulu
18*91f16700Schasinglulu	-r  <RCW file-name>         - name of RCW binary file.
19*91f16700Schasinglulu	-i  <BL2 Bin file-name>     - file to be added to rcw file.
20*91f16700Schasinglulu	-c  <SoC Number>            - SoC numeric identifier, may be one of
21*91f16700Schasinglulu                                  1012,1023,1026.1028,
22*91f16700Schasinglulu                                  1043,1046,1088,2080,
23*91f16700Schasinglulu                                  2088,2160
24*91f16700Schasinglulu	-b  <boot source id>        - Boot source id string, may be one of
25*91f16700Schasinglulu                                  "qspi", "nor", "nand", "sd", "emmc"
26*91f16700Schasinglulu	-d  <Address>               - Destination address where BL2
27*91f16700Schasinglulu	                              image is to be copied
28*91f16700Schasinglulu	-o  <output filename>	    - Name of PBL image generated
29*91f16700Schasinglulu	                              as an output of the tool.
30*91f16700Schasinglulu	-e  <Address>               - [Optional] Entry Point Address
31*91f16700Schasinglulu	                              of the BL2.bin
32*91f16700Schasinglulu	-f  <Address>               - BL2 image offset
33*91f16700Schasinglulu	                              on Boot Source for block copy.
34*91f16700Schasinglulu	                              command for chassis >=3.)
35*91f16700Schasinglulu				      (Must for Ch3, Ignored for Ch2)
36*91f16700Schasinglulu	-h  Help.
37*91f16700Schasinglulu	-s  Secure boot.
38*91f16700Schasinglulu
39*91f16700Schasinglulu		-s 	secure boot
40*91f16700Schasinglulu		-c	SoC Number (see description above)
41*91f16700Schasinglulu		-b	Boot source.
42*91f16700Schasinglulu		-r	RCW binary file.
43*91f16700Schasinglulu		-i	Input file that is to be added to rcw file.
44*91f16700Schasinglulu		-o	Name of output file
45*91f16700Schasinglulu		-f	Source Offset (Block Copy)
46*91f16700Schasinglulu		-d	Destination address to which file has to be copied
47*91f16700Schasinglulu		-h	Help.
48*91f16700Schasinglulu
49*91f16700SchasingluluExample:
50*91f16700Schasinglulu	./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*91f16700Schasinglulu
52*91f16700Schasinglulu
53*91f16700Schasinglulu
54*91f16700SchasingluluUsage at compilation time:
55*91f16700Schasinglulu--------------------------------
56*91f16700Schasinglulu
57*91f16700Schasinglulu	make <compilation command......> pbl RCW=<Path_to_RCW_File>/<rcw_file_name.bin>
58*91f16700Schasinglulu
59*91f16700SchasingluluExample: QSPI Boot For LS1046ARDB-
60*91f16700Schasinglulu
61*91f16700Schasinglulu	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*91f16700Schasinglulu
63*91f16700SchasingluluExample: QSPI Boot For LX2160ARDB-
64*91f16700Schasinglulu
65*91f16700Schasinglulu	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