# WS2812CandyGame-EIDE

**Repository Path**: caraba/WS2812CandyGame-EIDE

## Basic Information

- **Project Name**: WS2812CandyGame-EIDE
- **Description**: 基于 STM32F103C8T6 的 WS2812 灯带消消乐游戏机
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-31
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# STM32F103C8T6 LED Candy Game

基于 STM32F103C8T6 的 WS2812 灯带消消乐游戏机。

## 功能

- **60 颗 WS2812 LED 灯带**：PWM+DMA 驱动，8 种光效模式
- **消消乐游戏**：颜色匹配消除，支持连击计分
- **OLED 显示**：SSD1306 I2C 屏幕，显示分数/生命/菜单
- **非阻塞按键**：4 个按键，状态机消抖

## 硬件

- MCU: STM32F103C8T6 (Cortex-M3, 72MHz)
- 调试: J-Link / ST-Link (SWD)
- 灯带: WS2812B 60 LEDs
- 显示: SSD1306 128x64 I2C OLED

## 快速开始

### 编译

需要 VS Code + EIDE 扩展。

```bash
# 在 VS Code 中按 Ctrl+F9 编译
# 或通过菜单: EIDE -> Build Project
```

### 烧录

支持 J-Link 和 ST-Link 两种调试器，通过 VS Code 的 EIDE 扩展进行烧录。

### 调试

在 VS Code 中按 `F5` 启动调试，支持 J-Link (SWD) 和 ST-Link (OpenOCD) 两种配置。

## 项目结构

```
├── HARDWARE/       # 硬件驱动
│   ├── WS2812/     # 灯带驱动 + 光效系统
│   ├── OLED/       # 显示屏驱动
│   ├── KEY/        # 按键驱动
│   └── LED/        # LED + 蜂鸣器
├── APP/            # 游戏逻辑
├── Doc/            # 文档
└── USER/           # 主程序入口
```

## 文档

- [STM32命令行工具链手册](Doc/STM32命令行工具链手册-编译烧录调试自动化指南.md) - 编译、烧录、调试自动化
- [从WS2812驱动到消消乐游戏](Doc/从WS2812驱动到消消乐游戏-嵌入式开发实战复盘.md) - 开发实战复盘
- [AI驱动嵌入式开发](Doc/AI驱动嵌入式开发-Harness-Engineering实践指南.md) - Harness Engineering 实践

## 按键功能

| 按键 | 菜单中 | 游戏中 |
|------|--------|--------|
| KEY1 | 上一个光效 | 发射红色炮弹 |
| KEY2 | 下一个光效 | 发射黄色炮弹 |
| KEY3 | 调节亮度 | 发射绿色炮弹 |
| KEY4 | 进入游戏 | 暂停/退出 |

## 许可

本项目采用 MIT License - 详见 [LICENSE](LICENSE) 文件。

## 贡献指南

欢迎贡献代码！请提交 Issue 或 Pull Request。

## 问题反馈

遇到问题？请 [提交 Issue](https://github.com/WMM321/WS2812CandyGame-EIDE-STM32/issues)。