# Avaota F1 (Tina Linux) 编译与开发完整指南

**版本**：v1.0  
**日期**：2025-11-21  
**主机环境**：Ubuntu 24.04 LTS  
**目标平台**：Avaota F1 (全志 V821 / 32-bit RISC-V)

---

## 第一部分：编译环境准备 (针对 Ubuntu 24.04)

由于 Tina Linux SDK 依赖较旧的 32 位库和 Python 2，而 Ubuntu 24.04 已移除这些支持，必须手动修复。

### 1. 开启 32 位架构支持
```bash
sudo dpkg --add-architecture i386
sudo apt-get update
```

### 2. 安装基础依赖

```
sudo apt-get install -y 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
sudo apt-get install -y libc6:i386 libstdc++6:i386
```

### 3. 手动安装 libncurses5 (关键)

Ubuntu 24.04 源中无此包，需手动下载安装：

```
wget [http://mirrors.kernel.org/ubuntu/pool/universe/n/ncurses/libtinfo5_6.3-2ubuntu0.1_i386.deb](http://mirrors.kernel.org/ubuntu/pool/universe/n/ncurses/libtinfo5_6.3-2ubuntu0.1_i386.deb)
wget [http://mirrors.kernel.org/ubuntu/pool/universe/n/ncurses/libncurses5_6.3-2ubuntu0.1_i386.deb](http://mirrors.kernel.org/ubuntu/pool/universe/n/ncurses/libncurses5_6.3-2ubuntu0.1_i386.deb)
sudo apt-get install ./libtinfo5_6.3-2ubuntu0.1_i386.deb ./libncurses5_6.3-2ubuntu0.1_i386.deb
```

### 4. 修复 Python 版本问题

SDK 脚本需要 `python` 命令（指向 Py2 或兼容 Py3）：

```
sudo apt-get install python-is-python3
# 或者安装 python2 并建立软链接
```

## 第二部分：SDK 全量编译

### 1. 解压 SDK

```
# 假设压缩包在 Downloads
mkdir -p ~/ProgramFiles/avaota_sdk
tar -xvf ~/Downloads/tina-v821-v1.2.tar.xz -C ~/ProgramFiles/avaota_sdk
```

### 2. 初始化环境

```
cd ~/ProgramFiles/avaota_sdk/tina-v821-release
source build/envsetup.sh
```

### 3. 选择板型

```
lunch
```

- 在菜单中选择包含 **`v821`** 和 **`avaota_f1`** 的选项（通常是数字 2）。
- 等待配置生成完成 (`configuration written to .config`)。

### 4. 执行编译

```
make -j8 或 make -j
```

- **耗时**：约 30-60 分钟。
- **成功标志**：无报错停止，最终出现命令行提示符。

### 5. 打包固件 (可选)

```
pack
```

- 生成可用于 PhoenixSuit 烧录的 `.img` 文件。

## 第三部分：C++ 应用程序开发 (核心)

### 1. 编写代码 (`main.cpp`)

在 SDK 外部建立目录：

```
mkdir -p ~/ProgramFiles/avaota_app_demo
cd ~/ProgramFiles/avaota_app_demo
nano main.cpp
```

写入测试代码：

```
#include <iostream>
#include <unistd.h>

int main() {
    std::cout << "Hello Avaota F1! Running on RISC-V 32-bit!" << std::endl;
    return 0;
}
```

### 2. 找到正确的编译器



注意：必须使用 32位 工具链，SDK 默认提供的 prebuilt/.../riscv64 是错误的。

正确路径通常在 out 目录下：

Bash

```
find ~/ProgramFiles/avaota_sdk/tina-v821-release/out -name "riscv32-unknown-linux-g++"
```

- *典型路径*：`.../out/toolchain/nds32le-linux-glibc-v5d/bin/riscv32-unknown-linux-g++`

### 3. 静态编译 (Static Linking)

为了避免板子上缺少动态库 (`ld-linux...so`)，**必须**加上 `-static` 参数。

```
# 请替换为实际查到的编译器路径
/path/to/riscv32-unknown-linux-g++ -static -o my_app main.cpp
```

### 4. 验证产物

```
file my_app
```

- **必须包含**：`ELF 32-bit LSB executable`, `UCB RISC-V`, `statically linked`。

## 第四部分：部署与运行 (SD卡方式)

由于板子默认未开启 SSH/ADB 网络传输，推荐使用 SD 卡搬运。

### 1. PC 端操作

将编译好的 `my_app` 复制到 SD 卡。

### 2. 板子端操作 (串口终端)

插入 SD 卡，在串口终端执行：

```
# 1. 挂载 SD 卡 (如未自动挂载)
mount /dev/mmcblk0p1 /mnt/extsd

# 2. 复制到内存 (SD卡不支持执行权限，必须拷出来)
cp /mnt/extsd/my_app /tmp/

# 3. 赋予权限
chmod +x /tmp/my_app

# 4. 运行
/tmp/my_app
```

预期输出：

Hello Avaota F1! Running on RISC-V 32-bit!



# Avaota F1 开发环境搭建踩坑与解决方案总结

**日期**：2025-11-21  
**平台**：Avaota F1 (全志 V821 / 32-bit RISC-V)  
**主机环境**：Ubuntu 24.04 LTS

---

## 1. 核心架构与编译错误（最致命）

### ❌ 错误：CPU 架构位数不匹配（64-bit vs 32-bit）

* **现象**：在电脑上编译出的程序，传到板子上运行报错 `/tmp/my_app: line 1: syntax error: unterminated quoted string`。
* **原因**：我们一开始使用了 SDK 自带的 **64位** 编译器 (`riscv64-unknown-linux-gnu-g++`)，但 Avaota F1 (V821) 的这个固件运行的是 **32位** 的 RISC-V 系统。内核无法识别 64 位程序，Shell 尝试把它当脚本读，导致乱码报错。
* **✅ 解决**：找到了构建系统生成的 **32位** 编译器。
  * **正确编译器路径**：`out/toolchain/nds32le-linux-glibc-v5d/bin/riscv32-unknown-linux-g++`

### ❌ 错误：动态链接库缺失（Dynamic Linking）

* **现象**：程序在板子上找不到 `ld-linux...so` 或其他库，或者运行报错。
* **原因**：电脑上的编译环境（glibc 版本）与板子上的精简运行环境（可能为 musl 或旧版 glibc）不一致。
* **✅ 解决**：编译时加上 **`-static`** 参数，把所有依赖打包进一个文件，不再依赖板子系统库。
  * **命令示例**：`.../riscv32-unknown-linux-g++ -static -o my_app main.cpp`

---

## 2. Ubuntu 编译环境配置错误

### ❌ 错误：缺少 32 位兼容库

* **现象**：安装 `libc6:i386` 等库时提示找不到包。
* **原因**：Ubuntu 64位系统默认未开启 32 位架构支持。
* **✅ 解决**：执行 `sudo dpkg --add-architecture i386` 并更新源。

### ❌ 错误：依赖库版本过旧（libncurses5）

* **现象**：Ubuntu 24.04 已移除 `libncurses5`，但 SDK 工具链强制需要它。
* **✅ 解决**：手动下载并安装了旧版 Ubuntu (22.04) 的 `.deb` 包（`libtinfo5` 和 `libncurses5`）。

### ❌ 错误：Python 版本冲突

* **现象**：SDK 脚本报错 `python: command not found`。
* **原因**：Ubuntu 24.04 只有 `python3`，而旧 SDK 脚本还在调用 `python`（默认为 Py2）。
* **✅ 解决**：安装 `python-is-python3` 包，或手动建立 `/usr/bin/python` 指向 `python3` 的软链接。

### ❌ 错误：缺少构建工具

* **现象**：配置内核 (`lunch` 后自动配置) 时报错 `bison: not found`。
* **✅ 解决**：安装 `bison` 和 `flex`。

---

## 3. 板端运行与传输错误

### ❌ 错误：网络传输工具缺失

* **现象**：板子有网，但没有 `ssh` (dropbear没启动), `wget`, `nc`, `adb` (网络模式未开)。
* **原因**：固件被极度精简（BusyBox），文件系统只读，且未预装常用网络工具。
* **✅ 解决**：放弃网络传输，改用 **物理 SD 卡** 搬运文件。

### ❌ 错误：SD 卡权限问题

* **现象**：直接在 `/mnt/extsd` (SD卡挂载点) 下运行程序报错 `Permission denied`。
* **原因**：SD 卡通常是 FAT32 格式，不支持 Linux 的 `chmod +x`（可执行权限）。
* **✅ 解决**：
  1.  将程序 `cp` 复制到内存目录 `/tmp/` 下。
  2.  `chmod +x /tmp/my_app` 赋予权限。
  3.  运行 `/tmp/my_app`。

---

## 4. 经验教训

### ❌ 风险操作：`make -j`

* **问题**：执行不带数字的 `make -j` 会无限开启编译进程。
* **后果**：在内存较小的电脑上极易导致死机或内存耗尽。
* **建议**：始终指定并发数，如 `make -j8` 或 `make -j16`。

---

## 🏆 最终验证通过的开发路径

现在你已经拥有了一套**经过实战验证的、坚不可摧的开发流程**：

1.  **编写代码**：在 PC 上编写 C++ 代码 (`main.cpp`)。
2.  **编译**：使用 **32位编译器** (`nds32le...riscv32-g++`) 加上 **`-static`** 参数。
3.  **传输**：PC -> 复制到 SD 卡 -> 插板子 -> 板子终端 `cp /mnt/extsd/my_app /tmp/`。
4.  **运行**：板子终端 `chmod +x /tmp/my_app` -> `./tmp/my_app`。