# 克隆项目
git clone https://github.com/aitersmam888/freertos_mcp.git
cd embedded_freertos_mcp

# 安装Python依赖
pip install -r requirements.txt

# 安装开发依赖（可选）
pip install -r requirements-dev.txt

# 安装MSYS2（如果尚未安装）
# 下载地址: https://www.msys2.org/

# 在MSYS2中安装GCC ARM工具链
pacman -S mingw-w64-x86_64-arm-none-eabi-gcc
pacman -S make

# Ubuntu/Debian
sudo apt-get install gcc-arm-none-eabi make

# CentOS/RHEL
sudo yum install arm-none-eabi-gcc make

# 使用Homebrew安装
brew install arm-none-eabi-gcc make

{
  "mcpServers": {
    "embedded-freertos": {
      "command": "python",
      "args": ["-m", "src.embedded_freertos_mcp"]
    }
  }
}

# 验证Python模块导入
python -c "from src.embedded_freertos_mcp.models.chip_analysis import ChipCapabilities; print('✅ 模型导入成功')"

# 验证知识库加载
python -c "from src.embedded_freertos_mcp.knowledge.knowledge_loader import KnowledgeLoader; print('✅ 知识库加载成功')"

# 验证项目生成器
python -c "from src.embedded_freertos_mcp.generators.project_generator import ProjectGenerator; print('✅ 项目生成器就绪')"

创建一个基于BK7252的智能家居网关项目
- 项目名称: smart_home_gateway
- 芯片型号: BK7252N
- 功能需求: WiFi连接、BLE通信、传感器数据采集
- 输出路径: ./my_projects

查看BK7252芯片的详细规格和外设支持

为BK7252生成UART和GPIO驱动代码
- 波特率: 115200
- GPIO引脚: PA0, PA1

python -m src.embedded_freertos_mcp

from src.embedded_freertos_mcp.generators.project_generator import ProjectGenerator

# 初始化生成器
generator = ProjectGenerator("knowledge_base", "memory.db")

# 生成项目结构
project = generator.generate_project(
    project_name="test_project",
    chip_family="bk7252",
    output_path="./output"
)

from src.embedded_freertos_mcp.models.chip_analysis import ChipCapabilities

# 创建芯片能力模型
chip = ChipCapabilities(
    chip_family="BK7252",
    core="Cortex-M4",
    frequency=200000000,
    flash_size=2097152,
    ram_size=524288,
    peripherals=["UART", "SPI", "I2C", "GPIO", "PWM"]
)

from src.embedded_freertos_mcp.knowledge.knowledge_loader import KnowledgeLoader

loader = KnowledgeLoader("knowledge_base")
chip_info = loader.load_chip_config("bk7252")

src/
├── embedded_freertos_mcp/     # 主包
│   ├── __init__.py           # 包初始化
│   ├── server.py             # MCP服务器主程序
│   ├── main.py               # 命令行入口
│   ├── generators/           # 代码生成器
│   │   └── project_generator.py
│   ├── knowledge/           # 知识库管理
│   │   └── knowledge_loader.py
│   ├── memory/              # 记忆库管理
│   │   └── memory_manager.py
│   ├── models/              # 数据模型
│   │   └── chip_analysis.py
│   ├── templates/           # 代码模板
│   │   ├── projects/
│   │   │   ├── generic_template/
│   │   │   └── bk7252n_iot_gateway/
│   │   ├── drivers/
│   │   └── freertos/
│   └── tools/               # 工具集
│       ├── project_tools.py
│       ├── chip_analyzer.py
│       └── code_validator.py
├── generators/              # 独立生成器
│   └── template_manager.py
└── tools/                  # 独立工具
    └── code_validator.py

knowledge_base/
├── datasheets/             # 芯片规格书
│   ├── bk/                # BK系列芯片文档
│   │   ├── bk7252_summary.txt
│   │   └── parameters.yaml
│   ├── stm32/             # STM32系列文档
│   └── esp32/             # ESP32系列文档
├── sdks/                  # 原厂SDK
│   ├── bk7252_sdk/        # BK7252 SDK文档
│   └── stm32f4_sdk/       # STM32F4 SDK文档
├── requirements/           # 项目需求文档
│   ├── 项目需求.txt        # 总体需求规范
│   └── functional_docs/   # 功能详细文档
└── freertos/              # FreeRTOS文档
    ├── api_reference/
    └── best_practices/

config/
├── mcu_configs/           # 芯片配置文件
│   ├── bk7252.yaml       # BK7252配置
│   └── stm32f4.yaml      # STM32F4配置
├── compiler_configs/      # 编译器配置
│   └── gcc_arm.yaml      # GCC ARM配置
└── validation_rules/      # 验证规则
    └── memory_rules.yaml # 内存验证规则

smart_home_gateway/           # 项目根目录
├── src/                      # 源代码目录
│   ├── main.c               # 应用程序主入口
│   ├── system.c             # 系统初始化和配置
│   ├── system.h             # 系统头文件
│   ├── tasks/               # FreeRTOS任务代码
│   │   ├── wifi_task.c      # WiFi连接任务
│   │   ├── ble_task.c       # BLE通信任务
│   │   └── sensor_task.c    # 传感器数据采集任务
│   └── drivers/             # 外设驱动
│       ├── uart_driver.c    # UART驱动
│       ├── gpio_driver.c    # GPIO驱动
│       └── i2c_driver.c     # I2C驱动
├── inc/                      # 头文件目录
│   ├── config.h             # 项目配置头文件
│   ├── task_config.h         # 任务配置
│   └── peripheral_config.h  # 外设配置
├── freertos/                 # FreeRTOS源码
│   ├── Config/              # FreeRTOS配置
│   ├── Source/              # FreeRTOS核心源码
│   └── portable/            # 移植层代码
├── build/                    # 构建输出目录
├── scripts/                 # 构建脚本
├── Makefile                 # 主构建文件
├── linker_script.ld         # 链接脚本
└── README.md                # 项目说明文档

#ifndef CONFIG_H
#define CONFIG_H

// FreeRTOS配置
#define configUSE_PREEMPTION        1
#define configCPU_CLOCK_HZ          200000000
#define configTICK_RATE_HZ          1000
#define configTOTAL_HEAP_SIZE       (50 * 1024)

// 外设配置
#define UART_BAUD_RATE              115200
#define WIFI_SSID                   "MyNetwork"
#define SENSOR_UPDATE_INTERVAL      1000

#endif

pip install pyyaml
# 或者使用内置的JSON备选方案（已实现容错）

# 检查工具链安装
which arm-none-eabi-gcc

# 添加环境变量（Linux/macOS）
export PATH=$PATH:/path/to/gcc-arm/bin

# Windows系统路径设置
set PATH=%PATH%;C:\msys64\mingw64\bin

# 检查知识库结构
ls knowledge_base/datasheets/

# 添加缺失的芯片配置
cp config/mcu_configs/template.yaml config/mcu_configs/new_chip.yaml

# 设置环境变量
export EMBEDDED_FREERTOS_DEBUG=1

# 或直接运行调试模式
python -m src.embedded_freertos_mcp --debug

# 1. Fork项目
git clone https://github.com/your-fork/embedded_freertos_mcp.git

# 2. 创建开发分支
git checkout -b feature/new-feature

# 3. 安装开发依赖
pip install -r requirements-dev.txt

# 4. 运行测试
python -m pytest tests/

# 5. 提交更改
git commit -m "添加新功能"
git push origin feature/new-feature