跳到主要内容

快速开始使用

本章节介绍 T113_S4 SDK 的默认 AI 开发流程，覆盖从清理配置、编译打包到烧录与串口启动验证的完整闭环。

触发场景​

  • 首次搭建或切换 SDK 编译环境
  • 需要生成并烧录 t113_s4_linux_100ask_uart0.img
  • 需要验证固件是否正常启动进入 Linux shell
  • 需要统一团队的标准操作流程

目标产物​

  • 固件镜像：out/t113_s4_linux_100ask_uart0.img
  • 烧录结果：OpenixCLI 正常完成
  • 启动结果：串口进入 Linux shell，uname -a 可执行

基础环境准备​

A. 安装依赖包​

sudo apt update
sudo apt install build-essential subversion git-core libncurses5-dev zlib1g-dev gawk flex quilt \
  libssl-dev xsltproc libxml-parser-perl mercurial bzr ecj cvs unzip lib32z1 lib32z1-dev \
  lib32stdc++6 libstdc++6 bison -y

B. VMware 场景安装共享工具（可选）​

sudo apt install open-vm-tools open-vm-tools-desktop -y
sudo reboot

C. 环境连通性检查​

git --version
python3 --version

标准流程​

1) 进入 SDK 根目录并清理旧配置​

cd /home/ubuntu/T113-tina5v1.2-sdk
rm -f .buildconfig

2) 初始化环境​

source build/envsetup.sh

初始化成功后，确认快捷命令可用：croot cboot ckernel cbr cdts cout。

3) 配置编译选项（首次）​

./build.sh config

按以下选项选择：

  • platform: linux（输入 1）
  • linux_dev: buildroot（输入 1）
  • ic: t113_s4（输入 0）
  • board: 100ask（输入 0）
  • flash: default（输入 0）

4) 编译固件​

./build.sh

编译内容包括：U-Boot、Linux Kernel、Buildroot RootFS、C906 RTOS。

5) 打包镜像​

./build.sh pack
cout
ls -lh t113_s4_linux_100ask_uart0.img

6) 烧录前检查设备​

cd /home/ubuntu/T113-tina5v1.2-sdk/tools/OpenixCLI
lsusb
sudo ./target/release/openixcli scan -l

期望看到烧录设备：1f3a:efe8（FEL/FES）。

6.1) 若当前在 Tina Linux shell，直接切换烧录模式​

cd /home/ubuntu/T113-tina5v1.2-sdk/tools/serial_agent
sudo python3 trae_serial_terminal.py io \
  --auto-select --vid 1a86 --pid 55d4 \
  --baudrate 115200 \
  --send "reboot efex"

该命令会让板子自动重启并进入 FEL/FES 烧录模式。

7) 开启串口日志（建议新终端）​

cd /home/ubuntu/T113-tina5v1.2-sdk/tools/serial_agent
sudo python3 trae_serial_terminal.py terminal-raw \
  --auto-select --vid 1a86 --pid 55d4 \
  --baudrate 115200 \
  --log-file /tmp/openix_serial.log

8) 执行烧录​

cd /home/ubuntu/T113-tina5v1.2-sdk/tools/OpenixCLI
sudo ./target/release/openixcli flash /home/ubuntu/T113-tina5v1.2-sdk/out/t113_s4_linux_100ask_uart0.img \
  --reconnect-timeout-sec 240 \
  --reconnect-interval-ms 300 \
  -v

9) 启动验证​

烧录完成后通过串口观察启动，进入 Linux shell 后执行：

uname -a

出现内核版本信息即验证通过。

U-Boot 进入方式​

  • 若需要进入 U-Boot 命令行，在启动 auto 倒计时 3 秒内按 s 或 Ctrl+C
  • 进入 => 后可执行 efex 手动切回烧录通道

串口联动命令​

A. 串口实时透传 + 落盘​

cd /home/ubuntu/T113-tina5v1.2-sdk/tools/serial_agent
sudo python3 trae_serial_terminal.py terminal-raw \
  --auto-select --vid 1a86 --pid 55d4 \
  --baudrate 115200 \
  --log-file /tmp/openix_serial.log

B. 一次性串口验证​

cd /home/ubuntu/T113-tina5v1.2-sdk/tools/serial_agent
sudo python3 trae_serial_terminal.py io \
  --auto-select --vid 1a86 --pid 55d4 \
  --baudrate 115200 \
  --send "uname -a"

异常恢复​

A. U-Boot 停在 =>​

在串口输入：

efex

设备会重新进入烧录通道，然后重新执行烧录。

B. Device reconnect failed 或 USB 抖动​

  • 保持烧录参数不变（已包含重连窗口）
  • 再执行一次 scan -l 与 flash -v

C. 出现 cbw signature ... bad​

  • 先确认使用的是已修复版 OpenixCLI（包含 AWUC magic 修复）
  • 先在串口执行 reboot efex，再执行 scan -l 与 flash -v
  • 若仍失败，抓取 /tmp/openix_serial.log 和 dmesg 同步分析

D. 需要查看详细证据​

  • 串口日志：/tmp/openix_serial.log
  • 主机 USB 日志：sudo dmesg | tail -n 120

常用编译命令速查​

命令说明
./build.sh编译全部
./build.sh bootloader仅 U-Boot
./build.sh kernel仅内核
./build.sh buildroot_rootfs仅 Buildroot
./build.sh menuconfig内核配置
./build.sh buildroot_menuconfigBuildroot 配置
./build.sh clean清理产物
./build.sh distclean彻底清理