cybird-watching: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

项目概述

这是一个名为"CybirdWatching"的嵌入式项目，基于ESP32平台开发。该项目是一个智能显示设备，集成了多种传感器、显示模块、网络连接和用户界面功能。项目使用Arduino框架和PlatformIO进行开发。

开发环境

• 平台: ESP32 (pico32)
• 框架: Arduino
• 构建系统: PlatformIO
• 串口速度: 115200
• 上传端口: COM3（在 platformio.ini 中配置）

构建和开发命令

常用PlatformIO命令

# 编译项目
platformio run

# 上传到设备
platformio run --target upload

# 监控串口输出
platformio device monitor

# 清理构建文件
platformio run --target clean

# 上传并监控（推荐）
platformio run --target upload && platformio device monitor

Windows快捷脚本（在 scripts/ 目录）

# 编译项目
.\pio_run.bat

# 上传并监控
.\upload_and_monitor.bat

# CLI工具（交互式串口命令）
.\cybird_cli.bat

项目架构

v3.0 双核FreeRTOS架构

项目采用双核分离设计，充分利用ESP32的双核优势：

┌─────────────────────────────────────────────────────┐
│                     ESP32                           │
├─────────────────────┬───────────────────────────────┤
│   Core 0 (UI)       │   Core 1 (System)             │
│   优先级: 2         │   优先级: 1                    │
│   栈: 8KB           │   栈: 8KB                      │
│   频率: 200Hz       │   频率: 100Hz                  │
├─────────────────────┼───────────────────────────────┤
│ • LVGL GUI          │ • IMU 传感器                   │
│ • Display 刷新      │ • 串口命令                     │
│ • 小鸟动画          │ • WiFi 通信                    │
│ • 图片解码          │ • SD 卡操作                    │
│                     │ • 业务逻辑                     │
└─────────────────────┴───────────────────────────────┘
           ↕                        ↕
    ┌──────────────────────────────────────┐
    │   消息队列 + LVGL 互斥锁              │
    └──────────────────────────────────────┘

关键要点:

• UI任务运行在Core 0，专注于渲染，保证界面流畅
• 系统任务运行在Core 1，处理传感器、IO和业务逻辑
• 通过LVGL互斥锁保证线程安全
• 通过消息队列实现任务间通信
• 详见: 双核架构文档

目录结构

src/
├── main.cpp                           # 主程序入口
├── drivers/                           # 硬件驱动层
│   ├── display/                       # 显示驱动 (TFT_eSPI)
│   ├── sensors/                       # 传感器驱动
│   │   ├── imu/                       # IMU传感器 (MPU6050)
│   │   └── ambient/                   # 环境传感器
│   ├── communication/network/         # 网络通信 (WiFi)
│   ├── storage/sd_card/               # SD卡存储
│   └── io/rgb_led/                    # RGB LED控制 (FastLED)
├── system/                            # 系统服务层
│   ├── logging/                       # 日志管理系统
│   ├── commands/                      # 串口命令系统
│   └── lvgl/ports/                    # LVGL端口层
└── applications/                      # 应用层
    └── gui/                           # 图形用户界面
        ├── core/                      # 核心GUI组件
        └── screens/                   # GUI屏幕