Skill: seahi-mo/ai-thinker-code (version 1.0.0)

--- name: Ai-Thinker-Coder description: 安信可科技物联网模组开发助手 - 覆盖 WiFi、BLE、LoRa、Radar、NB-IoT、星闪等全系列模组的编程指南。子 skill 按芯片型号分组：BL602(Ai-WB2)、BL616/BL618(Ai-M61/M62) 等。使用 /skill Ai-Thinker-Coder-<chip> 加载特定芯片开发指南。 category: hardware tags: - 安信可 - Ai-Thinker - 物联网 - IoT - 无线模组 - WiFi - BLE - LoRa - Radar - NB-IoT - 星闪 - NearLink version: 1.0.0 author: 安信可科技 & Hermes Agent license: MIT-0 metadata: hermes: tags: [WiFi, BLE, LoRa, Radar, NB-IoT, 物联网, IoT, 模组开发] related_skills: [Ai-Thinker-Coder-bl602, Ai-Thinker-Coder-bl618, Ai-Thinker-Coder-lora, Ai-Thinker-Coder-radar] --- # 安信可科技 (Ai-Thinker) 物联网模组开发指南 安信可科技是专业的物联网无线连接模组厂商，产品涵盖 WiFi、BLE、LoRa、Radar、NB-IoT、星闪等多个系列。 **官网**: https://www.ai-thinker.com **技术支持论坛**: https://bbs.ai-thinker.com **文档中心**: https://docs.ai-thinker.com --- ## 产品线总览 | 产品系列 | 芯片平台 | 典型模组 | 协议 | 开发环境 | |---------|---------|---------|------|---------| | **Ai-WB2** | BL602 | Ai-WB2-01S/12F/32S | Wi-Fi 4 + BLE 5.0 | Linux/Windows | | **Ai-M61** | BL616/BL618 | Ai-M61-32S/32SU | Wi-Fi 6 + BLE 5.3 + Thread | Linux/Windows | | **Ai-M62** | BL616/BL618 | Ai-M62-12F/18F | Wi-Fi 6 + BLE 5.3 + Thread | Linux/Windows | | **BW/RTL87xx** | RTL8720/RTL8721 | BW-LP14 | 双频WiFi + BLE 5.0 | Linux | | **TG** | - | TG-01L | Wi-Fi (天猫精灵) | AT指令 | | **LoRa** | - | Ra-01/RA-01H | LoRa/LoRaWAN | Arduino | | **Radar** | - | RD-01/03/04/6x | 10GHz/24GHz/60GHz | Arduino | --- ## 子 Skill 列表 (按芯片平台) 加载特定芯片平台的开发指南： ```bash /skill Ai-Thinker-Coder-bl602 # Ai-WB2 系列 (BL602) /skill Ai-Thinker-Coder-bl618 # Ai-M61/M62 系列 (BL616/BL618) - 待发布 /skill Ai-Thinker-Coder-lora # LoRa 系列 - 待发布 /skill Ai-Thinker-Coder-radar # Radar 系列 - 待发布 ``` --- ## 开发环境快速搭建 ### 通用工具 | 工具 | 用途 | 下载 | |-----|------|-----| | VSCode | 代码编辑器 | https://code.visualstudio.com/ | | Git | 版本控制 | https://git-scm.com/ | | Python 3.8+ | 构建工具 | https://www.python.org/ | ### 串口驱动 | 芯片平台 | 驱动 | 说明 | |---------|------|-----| | CH340/CH341 | 点击下载 | USB转串口芯片驱动 | | CP2102 | 系统自带 | 通常免驱 | ### WSL 开发环境 (推荐) ```powershell # 安装 WSL2 wsl --install # 重启后安装 Ubuntu # 参考: /home/seahi/workspase/vitpress_docs_resoure/docs/zh/development/devel_env_setup/install_wsl.md ``` ### USB 转串口映射 (WSL2) ```powershell # 在 PowerShell (管理员) 中列出 USB 设备 usbipd list # 绑定设备 usbipd bind --busid <busid> # 附加到 WSL usbipd attach --wsl --busid <busid> # 在 WSL 中验证 ls /dev/ttyACM* ``` --- ## 常用链接 - **样品申请**: https://wj.qq.com/s2/18130629/6b69/ - **爱星物联云平台**: https://open.ai-things.com/ - **GitHub SDK**: https://github.com/Ai-Thinker-Open/ - **安信可论坛**: https://bbs.ai-thinker.com/ --- ## 使用说明 本 skill 是安信可模组开发的入口指南。使用 `/skill Ai-Thinker-Coder-<芯片平台>` 加载对应芯片的详细开发文档。 ### 安装子 Skill 加载主 skill 后，系统会自动提示可用的子 skill。安装子 skill 可以： **方式一：通过命令安装** ```bash # 安装 BL602 子 skill /skill install Ai-Thinker-Coder-bl602 ``` **方式二：通过 hermes 命令安装** ```bash hermes skills install Ai-Thinker-Coder-bl602 ``` ### 快速开始 1. 安装主 skill：`/skill install Ai-Thinker-Coder` 2. 安装目标芯片的子 skill：如 `/skill install Ai-Thinker-Coder-bl602` 3. 加载子 skill：`/skill Ai-Thinker-Coder-bl602` 详细安装和使用说明请参考: - [README.md](README.md) - 英文安装指南 - [README_Zh.md](README_Zh.md) - 中文安装指南 --- ## 许可证 本项目采用 MIT-0 许可证，详见 [LICENSE](LICENSE) 文件。

path: README.md
content: # Ai-Thinker-Coder

Hermes Agent skill for Ai-Thinker IoT module development.

## Overview

This is a comprehensive skill collection for Ai-Thinker IoT modules, covering WiFi, BLE, LoRa, Radar, NB-IoT, and NearLink modules. Sub-skills are organized by chip platform.

## Installation

### Method 1: Via Hermes Agent (Recommended)

```
/skill install Ai-Thinker-Coder
```

### Method 2: Manual Installation

```bash
# Clone the skill repository to your Hermes skills directory
git clone <repo-url> ~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/Ai-Thinker-Coder

# Or copy the skill directory manually
cp -r Ai-Thinker-Coder ~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/
```

### Method 3: Install Sub-Skills Individually

```bash
# Install specific chip skill
/skill install Ai-Thinker-Coder-bl602    # Ai-WB2 (BL602)

# Or manually
cp -r Ai-Thinker-Coder-bl602 ~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/
```

## Usage

### Load Main Skill

```
/skill Ai-Thinker-Coder
```

Displays product overview and links to sub-skills.

### Load Chip-Specific Skill

First install the sub-skill, then load it:

```bash
# Install sub-skill
/skill install Ai-Thinker-Coder-bl602    # Ai-WB2 series (BL602 chip)

# Load sub-skill
/skill Ai-Thinker-Coder-bl602
```

### Available Sub-Skills

| Skill | Chip Platform | Product Series | Status |
|-------|-------------|----------------|--------|
| Ai-Thinker-Coder-bl602 | BL602 | Ai-WB2-01S/12F/32S | Available |
| Ai-Thinker-Coder-bl618 | BL616/BL618 | Ai-M61/M62 series | Coming soon |
| Ai-Thinker-Coder-lora | - | Ra-01/RA-01H LoRa | Coming soon |
| Ai-Thinker-Coder-radar | - | RD-01/03/04 Radar | Coming soon |

## Development Workflow

1. **Install main skill** - `/skill install Ai-Thinker-Coder`
2. **Install sub-skill** - `/skill install Ai-Thinker-Coder-bl602` (for your chip)
3. **Load sub-skill** - `/skill Ai-Thinker-Coder-bl602`
4. **Follow setup guide** - Configure development environment
5. **Build and flash** - Use provided Makefile and flash commands

## Quick Start Example (BL602/Ai-WB2)

```bash
# 1. Load the skill
/skill Ai-Thinker-Coder-bl602

# 2. Clone SDK
cd /home/seahi/workspase
git clone https://github.com/Ai-Thinker-Open/Ai-Thinker-WB2.git
cd Ai-Thinker-WB2
git submodule update --init --recursive

# 3. Build example
cd applications/get-started/helloworld
make

# 4. Flash firmware
make flash p=/dev/ttyUSB0 b=921600
```

## Documentation Structure

```
Ai-Thinker-Coder/
├── SKILL.md              # Main entry (Chinese)
├── README.md             # English installation guide
├── README_Zh.md         # Chinese installation guide
└── Ai-Thinker-Coder-bl602/
    └── SKILL.md          # BL602 detailed guide
```

## Requirements

- Hermes Agent with skill management enabled
- For hardware development: USB serial connection to module
- For WSL development: usbipd configured for device passthrough

## Troubleshooting

- **Skill not found**: Ensure skill is in `~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/`
- **Build errors**: Check git submodules are initialized (`git submodule update --init --recursive`)
- **Flash failures**: Verify BOOT pin pulled low and serial port correct

## Links

- **Ai-Thinker Website**: https://www.ai-thinker.com
- **Forum**: https://bbs.ai-thinker.com
- **Docs**: https://docs.ai-thinker.com
- **GitHub**: https://github.com/Ai-Thinker-Open/

## License

MIT-0 License - See [LICENSE](LICENSE) file for details.


path: README_Zh.md
content: # Ai-Thinker-Coder

Hermes Agent 安信可科技物联网模组开发助手。

## 概述

本 skill 集合涵盖安信可全系列模组开发指南，包括 WiFi、BLE、LoRa、Radar、NB-IoT、星闪等。子 skill 按芯片平台分组，便于针对性开发。

## 安装方法

### 方法一：通过 Hermes Agent 安装（推荐）

```
/skill install Ai-Thinker-Coder
```

### 方法二：手动安装

```bash
# 克隆 skill 仓库到 Hermes skills 目录
git clone <仓库地址> ~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/Ai-Thinker-Coder

# 或手动复制
cp -r Ai-Thinker-Coder ~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/
```

### 方法三：单独安装子 skill

```bash
# 安装特定芯片的 skill
/skill install Ai-Thinker-Coder-bl602    # Ai-WB2 (BL602)

# 或手动复制
cp -r Ai-Thinker-Coder-bl602 ~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/
```

## 使用方法

### 加载主 skill

```
/skill Ai-Thinker-Coder
```

显示产品总览和子 skill 链接。

### 加载芯片专属 skill

首先安装子 skill，然后加载：

```bash
# 安装子 skill
/skill install Ai-Thinker-Coder-bl602    # Ai-WB2 系列 (BL602 芯片)

# 加载子 skill
/skill Ai-Thinker-Coder-bl602
```

### 可用子 skill

| Skill | 芯片平台 | 产品系列 | 状态 |
|-------|---------|---------|------|
| Ai-Thinker-Coder-bl602 | BL602 | Ai-WB2-01S/12F/32S | 可用 |
| Ai-Thinker-Coder-bl618 | BL616/BL618 | Ai-M61/M62 系列 | 待发布 |
| Ai-Thinker-Coder-lora | - | Ra-01/RA-01H LoRa | 待发布 |
| Ai-Thinker-Coder-radar | - | RD-01/03/04 Radar | 待发布 |

## 开发流程

1. **安装主 skill** - `/skill install Ai-Thinker-Coder`
2. **安装子 skill** - `/skill install Ai-Thinker-Coder-bl602` (根据芯片型号)
3. **加载子 skill** - `/skill Ai-Thinker-Coder-bl602`
4. **按照指南搭建环境** - 配置开发工具链
5. **编译并烧录** - 使用提供的 Makefile 和烧录命令

## 快速开始示例 (BL602/Ai-WB2)

```bash
# 1. 加载 skill
/skill Ai-Thinker-Coder-bl602

# 2. 克隆 SDK
cd /home/seahi/workspase
git clone https://github.com/Ai-Thinker-Open/Ai-Thinker-WB2.git
cd Ai-Thinker-WB2
git submodule update --init --recursive

# 3. 编译示例
cd applications/get-started/helloworld
make

# 4. 烧录固件
make flash p=/dev/ttyUSB0 b=921600
```

## 目录结构

```
Ai-Thinker-Coder/
├── SKILL.md              # 主入口（中文）
├── README.md             # 英文安装指南
├── README_Zh.md         # 中文安装指南
└── Ai-Thinker-Coder-bl602/
    └── SKILL.md          # BL602 详细开发指南
```

## 前置要求

- 已启用 skill 管理的 Hermes Agent
- 硬件开发：USB 串口连接模组
- WSL 开发：配置 usbipd 进行设备穿透

## 常见问题

- **Skill 找不到**：确认 skill 位于 `~/.hermes/profiles/<YOUR_PROFILE>/skills/hardware/` 目录
- **编译报错**：检查 git 子模块是否已初始化 (`git submodule update --init --recursive`)
- **烧录失败**：确认 BOOT 引脚拉低，串口选择正确

## 相关链接

- **安信可官网**: https://www.ai-thinker.com
- **技术支持论坛**: https://bbs.ai-thinker.com
- **文档中心**: https://docs.ai-thinker.com
- **GitHub**: https://github.com/Ai-Thinker-Open/

## 许可证

MIT-0 许可证 - 详见 [LICENSE](LICENSE) 文件。


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)