ARM Trusted Firmware分析——编译选项

 

参考文档：《Build Options》

1. 通用部分

BL2/BL31/BL31：指定生成fip文件的BL2/BL31/BL32镜像路径，指定后则不需要编译BL2镜像。

BL2_AT_EL3：使能后BL2镜像会运行在EL3异常等级。

BL2_IN_XIP_MEM：使能后BL2会运行在XIP存储设备上。只需要在RAM上初始化读写段，RO代码段不需要拷贝。

BL32_EXTRA1/BL32_EXTRA2：生成fip的TOS Extra1/Extra2镜像路径。

DISABLE_BIN_GENERATION：禁止生成二进制镜像，默认为0。如果为1，则默认只输出ELF格式镜像。

EL3_PAYLOAD_BASE：指定EL3镜像的入口地址，跳过后面镜像读取加载流程。

ENABLE_ASSERTIONS：配置编译时是否使能assert()。1表示将assert()编译在版本内；0表示关闭assert()。

ENABLE_BACKTRACE：配置编译版本是否支持backtrace dump功能。

ENABLE_LTO：仅在AARch64平台可用，配置是否支持链接时优化(Link Time Optimization)功能。

ENABLE_PIE：配置是否使能位置无关可执行代码功能，默认为0。仅支持BL2_AT_EL3、BL31、BL32。

ENABLE_STACK_PROTECTOR：配置GCC stack protection选项，允许值为all、strong、default、none。

FIP_NAME：指定FIP文件名称，默认为fip.bin。

FWU_FIP_NAME：指定FWU FIP文件名称，默认为fwu_fip.bin。

LDFLAGS：用户添加链接命令选项。

PLAT：指定编译ATF的平台配置，必须要plat/下的对应目录匹配，并包含一个platform.mk文件。

PRELOADED_BL33_BASE：从预加载的BL33镜像启动，入口地址由此配置指定。

PROGRAMMABLE_RESET_ADDRESS：1允许复位vector address可配置，0是固定。默认为0。

RESET_TO_BL31：使用BL31作为复位vector，而不是使用BL1入口。0使用BL1入口地址，1使用BL31入口地址。默认为0。

SPD：指定ATF中编译的Secure Payload Dispatcher名称，跟services/spd下目录一致。目录下需要包含一个同名的<spd-value>.mk文件。

SPIN_ON_BL1_EXIT：1表示BL1退出时进入无限循环，0表示不使用无限循环。使用1可以在镜像加载完成、MMU和Cache都关闭的时候，接入调试器进行调试。

2. 安全相关

ROT_KEY：指定包含ROT PEM格式私钥的文件并且强制生成公钥hash。

SAVE_KEYS：告诉证书生成工具将秘钥保存到指定文件。

GENERATE_COT：决定是否编译并执行TBB中对每个COT生成认证信息的工具cert_create。默认为0。

• TRUSTED_BOARD_BOOT=1且GENERATE_COT=1：
• TRUSTED_BOARD_BOOT=0且GENERATE_COT=1：
• TRUSTED_BOARD_BOOT=1且GENERATE_COT=0：

COT：如果使能Trusted Boot，选择意向Chain of Trust，默认为tbbr。

CREATE_KEYS：在GENERATE_COT=1时，告诉证书生成工具生成新key，以免遇到未指定或无效key的情况。可选0或1，默认为1。

DYN_DISABLE_AUTH：具备在运行时关闭TBB镜像验证功能，仅在开发阶段有意义。

OPENSSL_DIR：提供用来做镜像签名和加密工具的openssl安装目录。

2.1 签名

通过KEY_ALG和KEY_SIZE选择签名算法和秘钥位宽，哈希算法由HASH_ALG指定。

KEY_ALG：允许用于选择生成PKCS秘钥以及签名所使用的算法，支持选项有rsa、rsa_1_5、ecdsa。默认为rsa，兼容TBBR的PKCS#1 RSA2.1。

KEY_SIZE：允许用户选择KEY_ALG指定算法的秘钥大小。

KEY_ALG	Possible key sizes
rsa	1024, 2048(default), 3072, 4096
ecdsa	unavailable

BL31_KEY/BL32_KEY/BL33_KEY：在GENERATE_COT=1使能后，指定BL31/BL32/BL33 PEM格式私钥文件。如果指定SAVE_KEYS=1，则用于保存key。

NON_TRUSTED_WORLD_KEY：在GENERATE_COT=1时生效，指定Non-Trusted World PEM格式私钥文件。

TRUSTED_WORLD_KEY：在GENERATE_COT=1时生效，指定Trusted World PEM格式私钥文件。

2.2 加密相关

通过DECRYPTION_SUPPORT选择加密算法，以及ENC_KEY选择秘钥，ENCRYPT_BL31/ENCRYPT_BL32选择加密镜像。

DECRYPTION_SUPPORT：允许用户使用经过验证的解密算法来对启动过程中的镜像解密。两种选项aes_gcm或none。none表示关闭解密功能。是否支持其他aes模式扩展，取得性能和安全平衡？

ENC_KEY：一个32字节(256位)的对称秘钥，可以是SSK或BSSK方式。

ENC_NONCE：一个12字节(96位)的nonce或IV秘钥。nonce是一个只被使用一次的任意或非重复的随机数值。

ENCRYPT_BL31/ENCRYPT_BL32：在DECRYPTION_SUPPORT打开后，表示是否对BL31/BL32镜像进行加密。


FW_ENC_STATUS：指定镜像加密秘钥管理方式。0，一类设备使用相同的SSK(Secrete Symmetric Key)；1，每个设备使用独有的BSSK(Binding Secret Symmetric Key)。

2.3 哈希

HASH_ALG：选择hash算法选项，可选sha256、sha384、sha512。默认为sha256。

2.4 中断

EL3_EXCEPTION_HANDLING：设置为1时，异常处理将由EL3进行处理；设置为0时，EL3将不会进行异常处理，结果是进行panic。

SEC_INT_DESC_IN_FCONF：用于决定是否使用关键配置框架配置Group 0和Group 1位安全中断。

GICV2_G0_FOR_EL3：不同于GICv3，GICv2没有EL3专用中断。将GICV2_G0_FOR_EL3置为1，则表示期望GICv2 Group 0中断发送到EL3。这意味着所有GICv2 Group 0中断被送到EL3，并且Secure Payload中断需要被同步送到S.EL1处理。默认值为0，表示Group 0中断默认被S.EL1处理。

HANDLE_EA_EL3_FIRST：置为1，则外部异常和SError中断会被EL3捕获。置为0，异常则会陷入当前EL(如果当前EL是EL0，则会陷入EL1。)

SP_MIN_WITH_SECURE_FIQ：

TSP_NS_INTR_ASYNC_PREEMPT：

3. 调试

编译调试版本：

make PLAT=<platform> DEBUG=1 V=1 all

DEBUG：选择编译调试版本还是发布版本，0发布版本，1调试版本。

ARM GCC默认使用DWARF 4调试符号。某些工具可能不支持，可以通过-gdwarf-<version>来指定DWARF版本，比如为2或3。

某些时候甚至需要关闭编译优化来定位问题，使用-O0。

CFLAGS='-O0 -gdwarf-2'                                     \
make PLAT=<platform> DEBUG=1 V=1 all