设备管理

本文档介绍如何通过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)

dtb-$(CONFIG_TARGET_SPACEMIT_K1X) += k1-x_evb.dtb k1-x_deb2.dtb k1-x_deb1.dtb k1-x_hs450.dtb \
                    k1-x_kx312.dtb k1-x_MINI-PC.dtb k1-x_mingo.dtb k1-x_MUSE-N1.dtb \
                    k1-x_MUSE-Pi.dtb k1-x_spl.dtb k1-x_milkv-jupiter.dtb \
                    k1-x_MUSE-Book.dtb


3.修改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";
+                };
   };
 };

4.修改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实现自适应，对应的key_name为ddr_cs_num,可用titantools工具写号。刷机工具的时候请参考文档刷机工具使用

通过EEPROM实现自适应

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

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

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命令写号。

PC接上设备的调试串口，设备启动时，在PC串口终端按下键盘的s键，直到进入u-boot shell。
```
Autoboot in 0 seconds
=> 
```
烧写product_name，例如k1-x_MUSE-Pi。
```
=> tlv_eeprom set 0x21 k1-x_MUSE-Pi
=> tlv_eeprom write
Programming passed.
```
Programming passed.表示写入成功。

请以设备dts的文件名（不带后缀，如k1-x_MUSE-Pi）命名，方便u-boot自动加载dtb。
重启设备，检查是否可以加载k1-x_MUSE-Pi的dtb，正常的话u-boot有如下打印。
```
product_name: k1-x_MUSE-Pi
```

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，作为网卡物理地址。

添加新设备​

kernel设备树​

uboot设备树​

加入方案​

支持单CS DDR​

通过EEPROM实现自适应​

EEPROM支持列表​

添加新EEPROM​

使用tlv_eeprom写号​