跳到主要内容

2.3 config.txt 文件配置

注意
  • 所有配置文件内的配置，均可以在 Uboot 内手动覆盖。Uboot 内手动配置（在 Uboot 命令行使用 setenv）的优先级高于配置文件内的配置。完整环境变量优先级：setenv > 配置文件 > 上一次启动saveenv；
  • 本章内容均以“配置文件”指代默认路径为/boot/config.txt的配置文件；
  • 使用配置文件时，会需要修改启动分区的内容，这与AVB的要求是冲突的，所以本功能在使能 AVB 时（AVB 功能默认不使能）不能使用；

使用指南​

提示
  • 配置文件默认格式为<key>=<value>，第一个=后面的所有内容均为=前的<key>的配置值；
  • 配置文件单行配置不能超过1024字符；
  • 配置文件内的配置默认不会被保存为 Uboot 的默认配置；

配置内核 bootargs（内核 cmdline）​

修改配置文件，添加：bootargs=<自定义bootargs>，例如：

# Add cpu isolation configuration
bootargs=isolcpus=1-2

修改内核启动打印等级​

修改配置文件，添加：loglevel=<自定义打印等级>，例如：

# Add kernel loglevel configuration
loglevel=8

临时修改 dts​

使能或失能特定节点​

修改配置文件，添加：fdt-enable=<dts节点1全路径>;<dts节点2全路径>;；fdt-disable=<dts节点1全路径>;<dts节点2全路径>;，例如：

# Enable kernel dts node
fdt-enable=/soc/uart@394C0000;

# Disable kernel dts node
fdt-disable=/soc/uart@394C0000;
提示
  • 示例中配置行末尾的“;”不可省略；
  • dts 节点全路径可以在板端/proc/device-tree下获取，例如： 
      root@ubuntu:~# realpath --relative-to=/proc/device-tree/ /proc/device-tree/soc/uart@394C0000
      soc/uart@394C0000
    注意命令获取到的路径需要添加行首的"/"；

配置 DTB Overlay 文件​

DTB Overlay 相关说明如下：

  1. Kernel V6.1 官方文档：Devicetree Overlay Notes;
  2. Uboot V2022.10 官方文档：Device Tree Overlays;

简单介绍：DTB Overlay 文件，是可以在不修改当前启动使用的 dts 文件的情况下，对当前启动使用的 dtb 文件进行增/改（不支持删减）的功能。

DTB Overlay 示例文件如下：

/*
 * Sample dtb overlay source file
 * spi0_cs1_dev.dtso
*/
/dts-v1/;
/plugin/;

&spi0 {
	slave@1 {
		compatible = "sample-compatible-str";
		spi-max-frequency = <32000000>;
		reg = <1>;
	};
};

提示

需要根据从设备实际情况修改：

  1. compatible字段：需要修改为从设备实际驱动的compatible字段；
  2. spi-max-frequency字段：需要修改为从设备实际支持的最高速度；

DTB Overlay 编译示例，以下命令可以在 Host 端/RDK 板端执行，假设spi0_cs1_dev.dtso文件路径位于~/rdk_dtbo/spi0_cs1_dev.dtso：

# Install device-tree-compiler
sudo apt install device-tree-compiler -y

# Compile dtbo files
dtc -I dts -O dtb -o ~/rdk_dtbo/spi0_cs1_dev.dtbo ~/rdk_dtbo/spi0_cs1_dev.dtso

# Copy generated dtbo file to /boot for further usage
sudo cp ~/rdk_dtbo/spi0_cs1_dev.dtbo /boot

编译示例输出：

sunrise@ubuntu:~/rdk_dtbo$ dtc -I dts -O dtb -o ~/rdk_dtbo/spi0_cs1_dev.dtbo ~/rdk_dtbo/spi0_cs1_dev.dtso
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtso:12.3-13: Warning (reg_format): /fragment@0/__overlay__/slave@1:reg: property has invalid length (4 bytes) (#address-cells == 2, #size-cells == 1)
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtbo: Warning (pci_device_reg): Failed prerequisite 'reg_format'
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtbo: Warning (pci_device_bus_num): Failed prerequisite 'reg_format'
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtbo: Warning (simple_bus_reg): Failed prerequisite 'reg_format'
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtbo: Warning (i2c_bus_reg): Failed prerequisite 'reg_format'
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtbo: Warning (spi_bus_reg): Failed prerequisite 'reg_format'
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtso:9.10-13.4: Warning (avoid_default_addr_size): /fragment@0/__overlay__/slave@1: Relying on default #address-cells value
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtso:9.10-13.4: Warning (avoid_default_addr_size): /fragment@0/__overlay__/slave@1: Relying on default #size-cells value
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtbo: Warning (avoid_unnecessary_addr_size): Failed prerequisite 'avoid_default_addr_size'
/home/sunrise/rdk_dtbo/spi0_cs1_dev.dtbo: Warning (unique_unit_address): Failed prerequisite 'avoid_default_addr_size'
sunrise@ubuntu:~/rdk_dtbo$ ls
spi0_cs1_dev.dtbo  spi0_cs1_dev.dtso
提示

一般来说，编译中报的Warning级别的打印可以忽略。

修改配置文件，添加：dtbo_file_path=</boot分区下的相对路径>，例如：

# Set dtbo file path relative to /boot partition
dtbo_file_path=/spi0_cs1_dev.dtbo

重启后，可以看到设备树 SPI0(spi@39800000)的路径下，新的从设备节点生成了：

sunrise@ubuntu:~$ ls /proc/device-tree/soc/spi@39800000/slave@1/
compatible  name  reg  spi-max-frequency

如果想要自定义 dtbo 文件所在分区，则可以添加：dtbo_dev_part=<设备号>:<16进制分区号>，RDK S100默认设备号为"0"，分区号可以通过/dev/block/platform/by-name/路径获取，以下以userdata分区为例：

# Set dtbo file device number and partition number:
dtbo_dev_part=0:0x10

获取分区号的方法：ls -l /dev/block/platform/by-name/<分区名>，例如：

root@ubuntu:~# ls -l /dev/block/platform/by-name/userdata
lrwxrwxrwx 1 root root 15 Jun  4 22:17 /dev/block/platform/by-name/userdata -> /dev/mmcblk0p16

自定义 config.txt 指南​

地瓜 Uboot 会根据当前启动使用的储存介质和分区，自动获取默认的配置文件所在分区。

客户可以通过 Uboot 内的环境变量来自定义下一次启动使用的配置文件的储存介质和分区，步骤如下：

  1. 启动过程中停止并进入 Uboot 命令行；
  2. 以下环境变量可以用于自定义配置文件，每个变量均可单独使用：
    1. boot_config_f：改变默认寻找的配置文件名称，例如setenv boot_config_f test.txt，下一次启动的配置文件获取，就会去寻找文件名为test.txt的文件，而不是config.txt
    2. boot_config_dev_part：改变默认寻找配置文件的分区，例如setenv boot_config_dev_part 0:0xd，下一次启动的配置文件获取，就会去当前启动介质的第13个分区(0xd)寻找配置文件；
    3. boot_config_intf：改变默认寻找配置文件的储存介质，例如setenv boot_config_intf scsi。
  3. 保存环境变量：saveenv

config.txt 解析开发指南​

配置文件的解析功能代码路径位于 Uboot 目录的：board/hobot/common/drobot_boot_config.c文件内。

最后于 更新