Skip to main content

Device Management

本文档介绍如何通过EEPROM实现自适应设备(板型)，包括如何添加新板型支持和实现自适应启动。

后续文档描述的设备和板型等效

添加新设备​

以下以新增k1-x_MUSE-Pi板型为例说明

kernel设备树​

如参考deb1硬件设计，则拷贝k1-x_deb1.dts到如下文件，修改相应内容

target/linux/spacemit/dts/k1-x_MUSE-Pi.dts

对于新增的版型，dts文件均存放在以上目录。编译的时候打包进bootfs分区，uboot启动kernel前加载设备树文件。

uboot设备树​

新增板型需要在uboot源码仓库修改，如下：

  1. 添加uboot设备树u-boot-2022.10/arch/riscv/dts/k1-x_MUSE-Pi.dts
  2. 修改Makefile，将k1-x_MUSE-Pi.dtb添加到里面，如下：(注意后缀改成dtb)
 11 dtb-$(CONFIG_TARGET_SPACEMIT_K1X) += k1-x_evb.dtb k1-x_deb2.dtb k1-x_deb1.dtb k1-x_hs450.dtb \
 12                      k1-x_kx312.dtb k1-x_MINI-PC.dtb k1-x_mingo.dtb k1-x_MUSE-N1.dtb \
 13                      k1-x_MUSE-Pi.dtb k1-x_spl.dtb k1-x_milkv-jupiter.dtb \
 14                      k1-x_MUSE-Book.dtb
 15
  1. 修改uboot-2022.10/board/spacemit/k1-x/configs/uboot_fdt.its，添加新节点。
@@ -46,15 +46,6 @@
 				algo = "crc32";
 			};
 		};
+		fdt_4 {
+                        description = "k1-x_MUSE-Pi";
+                        type = "flat_dt";
+                        compression = "none";
+                        data = /incbin/("../dtb/1-x_MUSE-Pi.dtb");
+                        hash-1 {
+                                algo = "crc32";
+                        };
+                };
 	};
 
 	configurations {
@@ -74,10 +65,5 @@
 			loadables = "uboot";
 			fdt = "fdt_3";
 		};
+		conf_4 {
+                        description = "k1-x_MUSE-Pi";
+                        loadables = "uboot";
+                        fdt = "fdt_4";
+                };
 	};
 };
  1. 修改uboot-2022.10/include/configs/k1-x.h，更新DEFAULT_PRODUCT_NAME，FSBL和u-boot将默认根据DEFAULT_PRODUCT_NAME加载dtb。如果板子有EEPROM记录product_name等信息，则优先级更高，FSBL和u-boot将使用EEPROM的信息实现自适应启动。
@@ -25,7 +25,7 @@
 #define CONFIG_GATEWAYIP	10.0.92.1
 #define CONFIG_NETMASK		255.255.255.0

-#define DEFAULT_PRODUCT_NAME	"k1_deb1"
+#define DEFAULT_PRODUCT_NAME	"k1-x_MUSE-Pi"

 #define K1X_SPL_BOOT_LOAD_ADDR	(0x20200000)
 #define DDR_TRAINING_DATA_BASE	(0xc0829000)

加入方案​

如是开发板形态，则修改openwrt/target/linux/spacemit/image/k1-sbc.mk，添加k1-x_MUSE-Pi板型支持

DEVICE_DTS := k1-x_deb1 k1-x_MUSE-Pi

如果需要新增方案，请参考方案管理

支持单CS DDR​

FSBL默认支持双CS DDR，修改uboot-2022.10/arch/riscv/dts/k1-x_spl.dts可以支持单CS DDR。

@@ -79,7 +79,7 @@
 	ddr@c0000000 {
 		/* dram data rate, should be 1200, 1600, or 2400 */
 		datarate = <2400>;
-		cs-num = <2>;
+		cs-num = <1>;
 		u-boot,dm-spl;
 	};

如果设备有EEPROM，支持通过EEPROM实现自适应，待更新。

通过EEPROM实现自适应​

通过进迭Titanflasher工具给板子eeprom写号，实现启动的自适应，即一个固件支持多个板子。

系统启动时读取eeprom的信息，匹配uboot_fdt.its中信息，从而实现多板型支持。

相关文件：

uboot-2022.10/arch/riscv/dts/k1-x_spl.dts
uboot-2022.10/arch/riscv/dts/k1-x_*.dts

EEPROM支持列表​

  • atmel,24c02

添加新EEPROM​

  1. 修改uboot-2022.10/arch/riscv/dts/k1-x_spl.dts，更新EEPROM的I2C地址，例如新地址为0xA0。

    @@ -121,7 +121,7 @@
     		eeprom@50{
     			compatible = "atmel,24c02";
     			u-boot,dm-spl;
    -			reg = <0x50>;
    +			reg = <0xA0>;
     			bus = <6>;
     			#address-cells = <1>;
     			#size-cells = <1>;

  2. 修改uboot-2022.10/arch/riscv/dts/k1-x_*.dts，添加新EEPROM的配置。

    @@ -60,9 +60,9 @@
     	pinctrl-0 = <&pinctrl_i2c2_0>;
     	status = "okay";
     
    -	eeprom@50{
    -		compatible = "atmel,24c02";
    -		reg = <0x50>;
    +	eeprom@A0{
    +		compatible = "atmel,24c04";
    +		reg = <0xA0>;
     		vin-supply-names = "eeprom_1v8";
     		status = "okay";
     	};

使用tlv_eeprom写号​

写号是指将product_name等信息写入EEPROM。目前，在EEPROM中的信息是按照TLV编码的，可以使用u-boot的tlv_eeprom命令写号。

  1. PC接上设备的调试串口，设备启动时，在PC串口终端按下键盘的s键，直到进入u-boot shell。

    Autoboot in 0 seconds
    =>

  2. 烧写product_name，例如k1-x_MUSE-Pi。

    => tlv_eeprom set 0x21 k1-x_MUSE-Pi
    => tlv_eeprom write
    Programming passed.

    Programming passed.表示写入成功。

    请以设备dts的文件名（不带后缀）命名，方便u-boot自动加载dtb。

  3. reset检查是否可以加载k1-x_MUSE-Pi的dtb，正常的话u-boot有如下打印。

    product_name: k1-x_MUSE-Pi
    detect dtb_name: k1-x_MUSE-Pi.dtb

SDK还支持从EEPROM读取以下信息：

  • Serial Number：0x23
  • Base MAC Address：0x24
  • Manufacture Date：0x25
  • Device Version：0x26
  • MAC Addresses：0x2A
  • Manufacturer：0x2B
  • SDK Version：0x40

其中MAC Address会更新到dtb，作为网卡物理地址。