查看: 10|回复: 0

[K10教程] 行空板K10 + PlatformIO + Trae IDE 开发指南

从零开始，使用 Trae IDE 和 PlatformIO 开发行空板 K10 项目

前言
行空板 K10 是一款面向创客教育的国产开发板，集成了屏幕、传感器、LED 等丰富的硬件资源。本文将介绍如何使用 Trae IDE（字节跳动推出的 AI 编程助手）配合 PlatformIO 进行，行空板K10 开发，体验 AI 辅助编程的便捷。

1. 环境准备

1.1 安装 Python

PlatformIO 依赖 Python 环境。

下载地址：https://www.python.org/downloads/

安装注意事项：
- 建议安装 Python 3.8 或更高版本
- 安装时勾选 "Add Python to PATH"选项

1.2 安装 Git

用于克隆项目和库管理。

下载地址：https://git-scm.com/downloads
Git就只管安装就好了

1.3 下载 Trae IDE

Trae 是字节跳动推出的 AI 编程 IDE，内置 PlatformIO 支持。

下载地址：https://www.trae.ai/

安装步骤：
1. 访问官网下载对应系统版本
2. 运行安装程序，按提示完成安装
3. 首次启动需要登录/注册账号
登录后，这些国产模型免费使用，只是高峰时间可能会需要排队，但排队程度挺快的。

2. 插件安装与网络配置

2.1 安装 PlatformIO 插件

Trae IDE 基于 VS Code，扩展安装方式相同：

1. 打开 Trae IDE
2. 点击左侧扩展图标（或按 `Ctrl+Shift+X`）

3. 搜索 "PlatformIO IDE"

4. 点击安装

很多人会卡在这一步，一直等着，没有反应。

2.2 网络问题解决方案

由于 PlatformIO 的平台和库托管在 GitHub 等海外服务器，国内用户可能遇到下载慢或失败的问题。

可以使用国内镜像（无需翻墙）

设置 PlatformIO 镜像：

退出时记得点保存

{ "platformio-ide.useBuiltinPython": false, "platformio-ide.customPythonPath": "python", "platformio-ide.pipExtraUrls": [ "https://pypi.tuna.tsinghua.edu.cn/simple/" ], "platformio-ide.pipTrustedHosts": [ "pypi.tuna.tsinghua.edu.cn" ], "platformio-ide.pipTimeout": 300 }```

3. 创建第一个工程

3.1 创建新项目

1. 打开 Trae IDE

2. 点击左侧PlatformIO 图像（外星人头像）

3. 选择 **"Create New Project"**

4. 填写项目信息：
- Name:项目名称（如：`k10-demo`）
- Board:搜索DFRobot中“选择Firebeetle 2 ESP32-S3` 或 `UNIHIKER_K10`第一次可能只有Firebeetle 2 ESP32-S3

- Framework:** 选择 `Arduino`
- Location:** 选择保存路径

5. 点击 "Finish"等待项目创建

到了这一步才是真正安装好PlatformIO，如果卡在这一步，请搜索“清理python环境、环境变量设置”相关关键词。或者闲鱼上搜索“远程安装platformIO”。跨过了这地狱级的环境安装后，所有的项目制作都会变得丝滑了。

3.2 项目目录结构

k10-demo/
├── .pio/             # 构建缓存（自动生成）
├── .vscode/          # IDE 配置
├── include/          # 头文件目录
├── lib/             # 本地库目录
├── src/             # 源代码目录
│ └── main.cpp    # 主程序
├── test/             # 测试代码
├── .gitignore       # Git 忽略规则
└── platformio.ini    # 项目配置文件
```

---

4. 配置文件详解
Platform IO - UNIHIKER Documentation
链接中找Vscode配置文档，和Trae一模一样

4.1 platformio.ini 核心配置

这是 PlatformIO 最重要的配置文件：

```ini
; PlatformIO 项目配置文件

[env:unihiker]
platform = https://github.com/DFRobot/platform-unihiker.git
board = unihiker_k10
framework = arduino
build_flags =
-DARDUINO_USB_CDC_ON_BOOT=1
-DARDUINO_USB_MODE=1
-DModel=None

4.2 配置项说明

| 配置项 | 说明 | 示例 |
|--------|------|------|
| `platform` | 开发平台 | `https://github.com/...` |
| `board` | 开发板型号 | `unihiker` |
| `framework` | 开发框架 | `arduino` |
| `lib_deps` | 库依赖 | `unihiker_k10@^1.0.0` |
| `monitor_speed` | 串口波特率 | `115200` |
| `upload_port` | 上传端口 | `COM3` |
| `build_flags` | 编译选项 | `-D DEBUG` |
| `lib_extra_dirs` | 额外库目录 | `./my_libs` |

4.3 添加参考文档

将 K10 的 API 文档放入 `lib/` 目录，方便查阅：

```
lib/
├── CodeReference_arduinoide.md # API 参考
└── examples_arduinoide.md # 示例代码
```
这些文件不参与编译，但可在开发时参考。
这个很重要，在与AI沟通的时候，需要AI参考这2个md文件

5. 简单项目演示

5.1 UNIHIKER 屏幕显示

将以下这段代码贴到main.cpp中

#include "unihiker_k10.h"

UNIHIKER_K10 k10;
uint8_t screen_dir = 2;

void setup() {
    k10.begin();
    k10.initScreen(screen_dir);
    k10.creatCanvas();
    k10.setScreenBackground(0xFFFFFF);
    k10.canvas->canvasText("UNIHIKER", 1, 0x0000FF);
    k10.canvas->updateCanvas();
    delay(1000);
    k10.canvas->canvasText("UNIHIKER", 2, 0xFF0000);
    k10.canvas->updateCanvas();
    delay(1000);
    k10.canvas->canvasText("UNIHIKER", 3, 0x00FF00);
    k10.canvas->updateCanvas();
    delay(1000);
    k10.canvas->canvasText("UNIHIKER", 4, 0x000000);
    k10.canvas->updateCanvas();
    delay(1000);
}

void loop() {
}

**src/main.cpp:**

```cpp
#include <Arduino.h>
#include "unihiker_k10.h"

UNIHIKER_K10 k10;

void setup() {
    // 初始化 K10
    k10.begin();
    
    // 初始化屏幕（2 = 竖屏）
    k10.initScreen(2);
    
    // 创建画布
    k10.creatCanvas();
    
    // 设置黑色背景
    k10.setScreenBackground(0x000000);
    
    // 显示绿色文字
    k10.canvas->canvasText("Hello K10!", 4, 0x00FF00);
    
    // 更新屏幕显示
    k10.canvas->updateCanvas();
}

void loop() {
    // 主循环
}
复制代码

5.2 编译与上传

**编译：** `Ctrl+Alt+B` 或点击底部 ✓ 图标

**上传：** `Ctrl+Alt+U` 或点击底部 → 图标

5.3 使用 AI 助手编程

Trae IDE 内置 AI 助手，可以：

示例对话：
先将2段md文件示例代码拖到lib中，在对话框中用“#”引用示例代码，第一次使用的时候，要加上“只修改main.cpp文件”防止ai修改示例代码。每次生成完毕后，要按Ctrl+S保存修改后再上传。

用户：“在K10上画一只猫”