全志T113开发实战：从menuconfig到固件打包，详解Root密码配置全流程

1. 全志T113开发板Root密码配置实战指南

第一次拿到全志T113开发板时，我最头疼的就是如何安全地配置Root密码。作为一款广泛应用于智能硬件领域的处理器，T113的Linux系统定制化需求非常普遍。今天我就来分享从menuconfig配置到固件打包的完整流程，手把手教你实现"一次配置，永久生效"的Root密码设置方案。

在实际项目中，很多开发者会遇到这样的困扰：明明在系统里用passwd命令改了密码，重新烧录固件后又恢复默认了。这是因为没有在系统构建阶段就固化密码配置。通过Buildroot的menuconfig系统，我们可以从根本上解决这个问题。下面我会用最直白的语言，配合详细的操作步骤，让你彻底掌握这个实用技能。

2. 开发环境准备

2.1 硬件与软件需求

在开始之前，我们需要准备好以下环境：

• 全志T113开发板（任何型号均可）
• 安装好Linux系统的开发主机（推荐Ubuntu 18.04+）
• 全志官方SDK（本文以T113-i_v1.2为例）
• 基础的编译工具链（gcc, make等）

建议先执行以下命令检查基础环境：

sudo apt update sudo apt install build-essential git ncurses-dev

2.2 SDK目录结构解析

全志的SDK通常包含多个关键目录：

T113_SDK/ ├── buildroot/ # Buildroot构建系统 ├── linux/ # Linux内核源码 ├── out/ # 编译输出目录 └── build.sh # 全志专用编译脚本

特别要注意的是buildroot目录，这是我们今天操作的重点区域。它包含了系统构建的所有配置项和定制脚本。

3. 通过menuconfig配置Root密码

3.1 进入配置界面

首先我们需要进入Buildroot的配置系统：

cd T113_SDK/T113-i_v1.2/buildroot/buildroot-201902/ make menuconfig

这个命令会启动一个基于ncurses的图形配置界面。如果你遇到"Unable to find the ncurses libraries"错误，请先安装ncurses开发库：

sudo apt install libncurses5-dev

3.2 密码配置详解

在menuconfig界面中，按以下路径找到密码设置项：

System configuration → Root password

这里有几点需要注意：

1. 密码会以明文形式保存，但最终生成的系统中会转为加密格式
2. 密码长度建议8位以上，包含大小写字母和数字
3. 避免使用特殊字符，某些特殊字符可能导致登录问题

配置完成后，选择<Save>保存配置，通常会生成一个.config文件。我建议同时备份这个文件：

cp .config ../configs/t113_root_password_defconfig

4. 深度定制post-build脚本

4.1 脚本位置与作用

Buildroot在完成系统构建后，会执行target/post_build.sh脚本。这是我们进行深度定制的绝佳机会。该脚本位于：

T113_SDK/T113-i_v1.2/buildroot/buildroot-201902/target/

4.2 典型定制内容

除了设置密码外，我们通常还会在这个脚本中添加以下配置：

• 创建默认用户和用户组
• 设置SSH密钥
• 配置网络参数
• 安装必要的启动服务

一个完整的post-build.sh示例片段：

#!/bin/sh # 设置root密码（如果menuconfig已设置，这里可以省略） echo 'root:$1$xyz$abcdefg123456789' > ${TARGET_DIR}/etc/shadow # 创建默认用户 echo 'testuser:x:1000:1000:Test User:/home/testuser:/bin/sh' >> ${TARGET_DIR}/etc/passwd mkdir -p ${TARGET_DIR}/home/testuser

5. 完整编译与打包流程

5.1 编译前的准备工作

在开始编译前，建议先清理之前的构建结果：

make clean

然后初始化全志的编译环境：

cd ~/T113_SDK/T113-i_v1.2 source ./build/envsetup.sh

5.2 编译与验证

执行完整编译：

./build.sh

编译完成后，重点检查以下文件：

1. output/target/etc/shadow- 确认root密码已正确加密
2. output/target/etc/passwd- 确认root用户配置正确
3. output/target/etc/inittab- 确认终端登录配置

5.3 生成可烧写镜像

最后一步是打包系统镜像：

./build.sh pack

这个命令会生成位于out/目录下的固件镜像，通常命名为t113_linux_xxx.img。你可以使用全志提供的PhoenixSuit工具将其烧录到开发板。

6. 常见问题排查

6.1 密码不生效的几种可能

1. 配置未保存：确保在menuconfig中正确保存了配置
2. 编译缓存问题：尝试make clean后重新编译
3. 脚本执行顺序问题：检查post-build.sh是否有覆盖密码的操作

6.2 登录失败的解决方案

如果新密码无法登录，可以通过以下方式恢复：

1. 通过SD卡启动救援系统
2. 挂载原系统分区
3. 直接编辑/etc/shadow文件
4. 或者使用单用户模式修改密码

7. 安全增强建议

7.1 密码存储优化

虽然menuconfig方便，但直接将密码明文保存在配置文件中存在安全隐患。更安全的做法是：

1. 在post-build.sh中动态生成密码
2. 使用加密工具处理密码
3. 首次启动时强制修改密码

7.2 SSH安全配置

建议配套修改SSH配置：

1. 禁用root直接登录
2. 启用密钥认证
3. 修改默认SSH端口

这些配置同样可以通过Buildroot的menuconfig或post-build.sh实现。

8. 工程实践中的经验分享

在实际量产项目中，我总结出几个关键点：

1. 密码配置要尽早确定，后期修改成本高
2. 建议使用CI/CD自动化整个构建流程
3. 保留多个版本的.config文件以便回溯
4. 测试阶段可以使用简单密码，量产前必须改为复杂密码

记得有一次，我们团队因为忘记在post-build.sh中更新密码，导致1000台设备出厂密码不一致，造成了严重的现场维护问题。从那以后，我养成了在多个环节验证密码配置的习惯。