]>
Commit | Line | Data |
---|---|---|
0187c985 SB |
1 | High Assurance Boot (HAB) for i.MX6 CPUs |
2 | ||
3 | To authenticate U-Boot only by the CPU there is no code required in | |
4 | U-Boot itself. However, the U-Boot image to be programmed into the | |
5 | boot media needs to be properly constructed, i.e. it must contain a | |
6 | proper Command Sequence File (CSF). | |
7 | ||
8 | The Initial Vector Table contains a pointer to the CSF. Please see | |
9 | doc/README.imximage for how to prepare u-boot.imx. | |
10 | ||
11 | The CSF itself is being generated by Freescale HAB tools. | |
12 | ||
13 | mkimage will output additional information about "HAB Blocks" | |
14 | which can be used in the Freescale tooling to authenticate U-Boot | |
15 | (entries in the CSF file). | |
16 | ||
17 | Image Type: Freescale IMX Boot Image | |
18 | Image Ver: 2 (i.MX53/6 compatible) | |
19 | Data Size: 327680 Bytes = 320.00 kB = 0.31 MB | |
20 | Load Address: 177ff420 | |
21 | Entry Point: 17800000 | |
22 | HAB Blocks: 177ff400 00000000 0004dc00 | |
93e14596 | 23 | ^^^^^^^^ ^^^^^^^^ ^^^^^^^^ |
0187c985 SB |
24 | | | | |
25 | | | -------- (1) | |
26 | | | | |
27 | | ------------------- (2) | |
28 | | | |
29 | --------------------------- (3) | |
30 | ||
31 | (1) Size of area in file u-boot.imx to sign | |
32 | This area should include the IVT, the Boot Data the DCD | |
33 | and U-Boot itself. | |
34 | (2) Start of area in u-boot.imx to sign | |
35 | (3) Start of area in RAM to authenticate | |
36 | ||
37 | CONFIG_SECURE_BOOT currently enables only an additional command | |
38 | 'hab_status' in U-Boot to retrieve the HAB status and events. This | |
39 | can be useful while developing and testing HAB. | |
40 | ||
41 | Commands to generate a signed U-Boot using Freescale HAB tools: | |
42 | cst --o U-Boot_CSF.bin < U-Boot.CSF | |
43 | objcopy -I binary -O binary --pad-to 0x2000 --gap-fill=0x00 \ | |
44 | U-Boot_CSF.bin U-Boot_CSF_pad.bin | |
45 | cat u-boot.imx U-Boot_CSF_pad.bin > u-boot-signed.imx | |
46 | ||
47 | NOTE: U-Boot_CSF.bin needs to be padded to the value specified in | |
48 | the imximage.cfg file. | |
0200020b RC |
49 | |
50 | Setup U-Boot Image for Encrypted Boot | |
51 | ------------------------------------- | |
52 | An authenticated U-Boot image is used as starting point for | |
53 | Encrypted Boot. The image is encrypted by Freescale's Code | |
54 | Signing Tool (CST). The CST replaces only the image data of | |
55 | u-boot.imx with the encrypted data. The Initial Vector Table, | |
56 | DCD, and Boot data, remains in plaintext. | |
57 | ||
58 | The image data is encrypted with a Encryption Key (DEK). | |
59 | Therefore, this key is needed to decrypt the data during the | |
60 | booting process. The DEK is protected by wrapping it in a Blob, | |
61 | which needs to be appended to the U-Boot image and specified in | |
62 | the CSF file. | |
63 | ||
64 | The DEK blob is generated by an authenticated U-Boot image with | |
65 | the dek_blob cmd enabled. The image used for DEK blob generation | |
66 | needs to have the following configurations enabled: | |
67 | ||
68 | CONFIG_SECURE_BOOT | |
69 | CONFIG_SYS_FSL_SEC_COMPAT 4 /* HAB version */ | |
70 | CONFIG_FSL_CAAM | |
71 | CONFIG_CMD_DEKBLOB | |
72 | ||
73 | Note: The encrypted boot feature is only supported by HABv4 or | |
74 | greater. | |
75 | ||
76 | The dek_blob command then can be used to generate the DEK blob of | |
77 | a DEK previously loaded in memory. The command is used as follows: | |
78 | ||
79 | dek_blob <DEK address> <Output Address> <Key Size in Bits> | |
80 | example: dek_blob 0x10800000 0x10801000 192 | |
81 | ||
82 | The resulting DEK blob then is used to construct the encrypted | |
83 | U-Boot image. Note that the blob needs to be transferred back | |
84 | to the host.Then the following commands are used to construct | |
85 | the final image. | |
86 | ||
87 | objcopy -I binary -O binary --pad-to 0x2000 --gap-fill=0x00 \ | |
88 | U-Boot_CSF.bin U-Boot_CSF_pad.bin | |
89 | cat u-boot.imx U-Boot_CSF_pad.bin > u-boot-signed.imx | |
90 | objcopy -I binary -O binary --pad-to <blob_dst> --gap-fill=0x00 \ | |
91 | u-boot-signed.imx u-boot-signed-pad.bin | |
92 | cat u-boot-signed-pad.imx DEK_blob.bin > u-boot-encrypted.imx | |
93 | ||
94 | NOTE: u-boot-signed.bin needs to be padded to the value | |
95 | equivalent to the address in which the DEK blob is specified | |
96 | in the CSF. |