Synology_HDD_db设备树处理：model.dtb文件的编辑机制

Synology_HDD_db设备树处理：model.dtb文件的编辑机制

【免费下载链接】Synology_HDD_db 项目地址: https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db

还在为群晖NAS无法识别第三方M.2扩展卡而烦恼吗？Synology_HDD_db项目的设备树编辑功能，让您的NAS轻松支持各种M.2 PCIe扩展卡！

什么是设备树（Device Tree）？

设备树是Linux系统中描述硬件配置的数据结构，群晖NAS使用model.dtb文件来定义硬件支持。当您安装非官方M.2扩展卡时，系统可能无法识别，这时就需要修改设备树文件。

设备树编辑的核心流程

1. 检测设备树模型

脚本首先检查是否存在 /etc.defaults/model.dtb 文件，确认是否为设备树模型：

if [[ -f /etc.defaults/model.dtb ]]; then
    # 获取硬件版本
    hwrevision=$(cat /proc/sys/kernel/syno_hw_revision)
    # 设置对应的dtb/dts文件路径
    dtb_file="/etc.defaults/model${hwrev}.dtb"
    dts_file="/tmp/model${hwrev}.dts"
fi

2. 设备树编译工具准备

脚本自动检测并安装设备树编译器（dtc）：

if [[ ! -x $(which dtc) ]]; then
    # 从GitHub下载dtc工具
    install_binfile dtc "$file_url" /usr/sbin/dtc "a+x" bin/dtc "$md5hash"
fi

3. 设备树转换与编辑

核心的编辑流程包括三个关键步骤：

步骤1：DTB转DTS 将二进制设备树文件转换为可读的文本格式：

dtc -q -I dtb -O dts -o "$dts_file" "$dtb_file"

步骤2：添加M.2卡节点 通过 dts_m2_card 函数向DTS文件添加扩展卡配置：

步骤3：DTS转DTB 将修改后的文本文件重新编译为二进制格式：

dtc -q -I dts -O dtb -o "$dtb_file" "$dts_file"

支持的M.2扩展卡类型

项目目前支持以下扩展卡的自动配置：

扩展卡型号	支持类型	功率限制
E10M20-T1	NVMe x2	14.85W x2
M2D20	NVMe x2	14.85W x2
M2D18	NVMe + SATA	9.9W x2
M2D17	SATA x2	9.9W x2

实际应用场景

场景1：添加E10M20-T1扩展卡

当检测到E10M20-T1卡时，脚本会自动添加以下设备树节点：

E10M20-T1 {
    compatible = "Synology";
    model = "synology_e10m20-t1";
    power_limit = "14.85,14.85";

    m2_card@1 {
        nvme {
            pcie_postfix = "00.0,08.0,00.0";
            port_type = "ssdcache";
        };
    };

    m2_card@2 {
        nvme {
            pcie_postfix = "00.0,04.0,00.0";
            port_type = "ssdcache";
        };
    };
};

场景2：恢复原始配置

如果您需要撤销修改，可以使用 --restore 参数：

sudo -s /path/to/syno_hdd_db.sh --restore

脚本会自动从备份文件中恢复原始的设备树配置。

安全备份机制

项目采用多重备份策略：

1. 自动创建 model.dtb.bak 备份文件
2. 在 /tmp 目录生成临时的DTS文件
3. 修改前验证dtc工具完整性
4. 支持一键恢复功能

使用建议

1. 定期运行：建议在每次DSM系统更新后重新运行脚本
2. 定时任务：通过任务计划设置实现开机自动运行
3. 谨慎操作：仅在确实需要时才使用设备树编辑功能
4. 备份重要数据：修改系统文件前确保数据安全

通过Synology_HDD_db的设备树编辑功能，您可以轻松扩展NAS的硬件兼容性，让第三方M.2扩展卡在群晖系统上完美工作！

提示: 如果您在M.2扩展卡使用中遇到问题，可以查看项目文档获取更多帮助信息。

【免费下载链接】Synology_HDD_db 项目地址: https://gitcode.com/GitHub_Trending/sy/Synology_HDD_db