# ecosclaw_mini

**Repository Path**: smetech/ecosclaw_mini

## Basic Information

- **Project Name**: ecosclaw_mini
- **Description**: openclaw clone to mini version for ECOS EP32103F dev-board MCU 64KB sram
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-28
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EcosClaw Mini Firmware

<p align="center">
  <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License">
  <img src="https://img.shields.io/badge/Hardware-GD32VF103-blue.svg" alt="Hardware">
  <img src="https://img.shields.io/badge/Architecture-RISC--V%20RV32IMAC-purple.svg" alt="Architecture">
  <img src="https://img.shields.io/badge/BMDC-Embedded-red.svg" alt="BMDC">
</p>

## 概述

EcosClaw Mini 是基于 **GD32VF103** (RISC-V RV32IMAC) 微控制器(MCU)的轻量级嵌入式固件项目。该固件实现了 USB CDC (Communication Device Class) 设备功能，可通过虚拟串口与上位机进行通信。

这是 BMDC 嵌入式事业部的开源项目，目标是打造一个轻量级 AI Agent 硬件固件框架。

## 硬件规格

| 参数 | 规格 |
|------|------|
| **MCU** | GD32VF103C8T6 |
| **架构** | RISC-V RV32IMAC |
| **主频** | 108 MHz |
| **Flash** | 64 KB |
| **SRAM 32 KB |
| **USB** | USB 2.0 Full Speed |

## 项目结构



## 源代码统计

| 类型 | 数量 |
|------|------|
| C 源文件 | 16 |
| 头文件 | 29 |
| 汇编文件 | 1 |
| **总计** | **46** |

## 快速开始

### 环境要求

- **RISC-V GCC 工具链**: 
- **Make**: GNU Make 3.81+

### 编译

rm -rf build *.elf *.bin *.map
mkdir -p build
/usr/bin/gcc -O2 -Wall -DGD32VF103 -DSTARRY_SKY_C -I./include -I./Libraries/gd32_std/Include -I./Libraries/CMSIS/Include -I./GD32VF103_usbfs_library/driver/Include -I./GD32VF103_usbfs_library/device/core/Include -I./GD32VF103_usbfs_library/device/class/cdc/Include -I./GD32VF103_usbfs_library/ustd/common -c src/main.c -o build/main.o
/usr/bin/gcc -O2 -Wall -DGD32VF103 -DSTARRY_SKY_C -I./include -I./Libraries/gd32_std/Include -I./Libraries/CMSIS/Include -I./GD32VF103_usbfs_library/driver/Include -I./GD32VF103_usbfs_library/device/core/Include -I./GD32VF103_usbfs_library/device/class/cdc/Include -I./GD32VF103_usbfs_library/ustd/common -c src/system_init.c -o build/system_init.o

### 烧录

使用 OpenOCD + CMSIS-DAP/J-Link 烧录：



**注意**: 烧录前需将 BOOT0 引脚拉高进入系统存储器模式。

## 功能特性

### 1. USB CDC 通信
- 虚拟串口通信 (CDC-ACM)
- 115200 bps 默认波特率
- 8N1 数据格式
- 自动应答机制

### 2. 命令处理
- 接收上位机命令
- 支持换行符结束
- 自动缓冲区管理

### 3. 诊断功能
- 系统状态报告
- 错误日志输出
- 心跳检测

### 4. LLM 代理 (扩展接口)
- LLM 请求转发
- 响应缓冲
- 超时处理

## 核心 API

### USB CDC 接口



### EcosClaw Core 接口



## 固件信息

| 项目 | 数值 |
|------|------|
| **固件大小** | ~50 KB |
| **RAM 使用** | ~8 KB |
| **启动时间** | < 100ms |

## 依赖

- GD32VF103 HAL (RISC-V)
- RISC-V CMSIS

## 技术备注

### RISC-V vs ARM

本项目使用 GD32VF103 (RISC-V) 而非 GD32F103 (ARM)：
- GD32VF103: GigaDevice 首款 RISC-V 内核 MCU
- 指令集: RV32IMAC (32位, 整数, 乘除, 原子操作, 压缩指令)
- 与 ARM Cortex-M3 兼容的 peripherals

### 编译参数



## 许可证

本项目基于 **MIT 许可证** 开源。详见 [LICENSE](LICENSE) 文件。

## 联系方式

---
*EcosClaw Mini - 轻量级嵌入式 AI Agent 固件*  
*Built by SME_TECH   嵌入式事业部*