当前位置：首页 > news >正文

创龙T113 SDK编译实战：从环境搭建到疑难排错

news 2026/5/11 22:47:28

1. 环境准备与依赖安装

在Ubuntu 20.04上编译创龙T113 SDK，首先要解决的就是环境依赖问题。我刚开始尝试时，以为直接按照官方文档操作就行，结果踩了不少坑。这里分享下我的完整配置过程。

先说说硬件环境，我用的是创龙TLT113-MiniEVM_V1.2开发板，但操作系统没有使用官方推荐的镜像，而是选择了更熟悉的Ubuntu 20.04。这个选择后来证明是个双刃剑——既带来了灵活性，也增加了一些兼容性问题。

第一步是解压SDK包。创龙的LinuxSDK-v1.2.tar.gz文件解压后，会得到一个T113-i_v1.0目录。这里有个小技巧：建议把解压路径放在用户主目录下，不要放在太深的目录层级里，因为后续编译时可能会遇到路径长度限制的问题。

依赖安装是最容易出问题的环节。官方手册列出的依赖项可能不够全面，我通过反复尝试整理出了完整清单：

sudo apt-get install -y build-essential bison flex \ python2.7 python-dev swig libncurses5-dev \ libssl-dev u-boot-tools device-tree-compiler \ gcc-arm-linux-gnueabihf g++-arm-linux-gnueabihf

特别注意python2.7的安装，这是个大坑。现代Ubuntu系统默认都是python3，但创龙SDK需要python2环境。我试过用python3兼容模式，结果各种报错，最后还是老老实实装了python2.7。

2. Python版本冲突解决方案

说到Python版本问题，这可能是最常遇到的坑。我第一次运行./build.sh config时就遇到了"python: command not found"错误。解决方法其实很简单，但需要理解背后的原理。

先检查系统现有的Python版本：

ls -l /usr/bin/python*

在Ubuntu 20.04上，你可能会发现只有python3的链接。这时需要手动创建python2的软链接：

sudo rm -f /usr/bin/python # 先删除已有链接 sudo ln -s /usr/bin/python2 /usr/bin/python

验证链接是否生效：

python --version

这里有个细节要注意：有些教程会建议用update-alternatives来管理Python版本，但在SDK编译环境下，直接创建软链接反而更可靠。我两种方法都试过，发现update-alternatives有时会导致脚本找不到python解释器。

3. 编译配置与内核选项

环境准备好后，就可以开始配置了。进入T113-i_v1.0目录，先清理之前的编译结果：

cd T113-i_v1.0/ ./build.sh distclean

配置环节很关键，它决定了后续编译的组件和功能：

./build.sh config

这里会出现一个交互式菜单，需要选择：

处理器型号：T113
开发板型号：tlt113-minievm-nand
显示输出方式（根据实际硬件选择）
编译器类型（一般选默认的arm-linux-gnueabihf）

配置完成后，建议先保存一份.config文件备份，因为后续如果编译出错需要重新配置时，可以直接恢复这个备份，不用再从头选择。

4. 常见编译错误及解决方法

4.1 gdbus编译错误

第一次完整编译时，我遇到了两个gdbus相关的错误：

gdbusauth.c:1302:11: error: '%s' directive argument is null gdbusmessage.c:2702:30: error: '%s' directive argument is null

这两个错误都是因为代码中没有对字符串指针做空值检查。解决方法是在对应行数添加判空逻辑：

在gdbusauth.c第1302行附近修改：

if (auth->credentials != NULL) { g_string_append_printf (debug, " credentials=%s", auth->credentials); }

在gdbusmessage.c第2702行附近修改：

if (signature_str != NULL) { g_string_append_printf (debug, " %s", signature_str); }

4.2 awk脚本语法错误

接下来遇到的是awk脚本问题：

`\#' is not a known regexp operator

这个错误出现在几个.awk文件中，包括：

mkerrnos.awk
mkerrcodes.awk
mkerrcodes1.awk
mkerrcodes2.awk
mkstrtable.awk

问题在于awk版本差异导致的语法不兼容。解决方法是将所有文件中的：

sub(/\#.+/, "");

修改为：

sub(/#.+/, "");

其实就是去掉反斜杠，因为新版本awk中#不需要转义。

4.3 缺失头文件问题

最棘手的一个错误是errnos-sym.h文件缺失：

errnos-sym.h: No such file or directory

这个文件是libgpg-error编译时需要的，但SDK里没有提供。我从其他开源项目中找到了解决方案，需要手动创建这个文件：

首先确定文件存放路径：

T113-i_v1.0/out/t113_i/tlt113-minievm-emmc/longan/buildroot/build/libgpg-error-1.33/src

创建errnos-sym.h文件，内容如下（篇幅所限，完整内容可以参考开源项目的实现）：

/* Output of mkstrtable.awk. DO NOT EDIT. */ static const char errnos_msgstr[] = "GPG_ERR_E2BIG\0" "GPG_ERR_EACCES\0"...; static const int errnos_msgidx[] = {0, 14, 29,...};