# xn_canbox

**Repository Path**: tom-embedded/xn_canbox

## Basic Information

- **Project Name**: xn_canbox
- **Description**: 开源国标直流充电桩测试仪（XN ExCHARGER）：以车端/BMS 视角模拟 GB/T 27930 充电通信。基于 STM32F405、FreeRTOS 与 LVGL，含固件、嘉立创 PCB、外壳与桌面模拟器。 
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-10-28
- **Last Updated**: 2026-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xn_canbox — 国标直流充电桩测试仪（开源）

基于 **STM32F405 + FreeRTOS + LVGL9 + ST7789/GT911** 的车端视角 GB/T 27930 充电过程模拟 / 测试仪开源工程（XN ExCHARGER）。

> **安全提示**：成品可能连接充电桩高压接口。使用前务必阅读 [`docs/SAFETY.md`](docs/SAFETY.md)。作者不承担误用后果。

本仓库按用途拆分目录，便于分别维护固件、嘉立创生产资料、外壳与桌面模拟器。

## 实物与演示

| 整机 | 接入直流桩 |
|------|------------|
| ![整机外观](docs/xn_canbox_img0.jpg) | ![接入直流桩](docs/xn_canbox_img1.jpg) |
| 现场接线 | 充电界面 |
| ![现场接线](docs/xn_canbox_img2.jpg) | ![充电界面](docs/xn_canbox_img3.jpg) |

演示视频（点击在 GitHub 中播放）：[docs/xn_canbox.mp4](docs/xn_canbox.mp4)

[![演示视频](docs/xn_canbox_img3.jpg)](docs/xn_canbox.mp4)

---

## 目录结构

```
xn_canbox/
├── firmware/           # STM32 固件源码、CubeMX (.ioc)、链接脚本
├── hardware/jlcpcb/    # 嘉立创 / EasyEDA 生产包
├── enclosure/          # 外壳 CadQuery / Fusion、薄膜、尺寸与参考资料
├── simulator/          # PC 端 LVGL 模拟器（SDL2）
├── tools/              # 字体生成等工具脚本
├── third_party/        # FreeRTOS / LVGL / STM32 HAL 子集（相对路径，无本机路径）
└── docs/               # 安全说明、编译、物料、实物照片与演示视频
```

| 目录 | 说明 |
|------|------|
| [`firmware/`](firmware/) | 应用代码：`Core/`、CMake、`f405_canbox.ioc` |
| [`hardware/jlcpcb/`](hardware/jlcpcb/) | 屏板 / 强电板 Gerber·BOM·CPL，见该目录 README |
| [`enclosure/`](enclosure/) | 3D 外壳、薄膜 PDF/DXF、禁布区、规格书与尺寸说明 |
| [`simulator/`](simulator/) | 与实机同 UI 的桌面预览 |
| [`tools/`](tools/) | `canfont.sh`；`tools/fonts/` 含 Maple Mono CN / Font Awesome |
| [`third_party/`](third_party/) | 构建依赖快照 |
| [`docs/`](docs/) | `SAFETY.md` · `BUILD.md` · `BOM_NOTES.md` |

---

## 快速开始

### 固件

见 [`docs/BUILD.md`](docs/BUILD.md)。

```bash
cd firmware
cmake --preset Debug
cmake --build --preset Debug
```

### LVGL 模拟器

```bash
./simulator/run.sh
```

### 外壳

- Fusion 脚本：`enclosure/fusion/`（见 `enclosure/README.md`）
- CadQuery 重建：`python3 enclosure/cadquery/enclosure_f405_canbox.py`
- 打印用 STL / STEP：`enclosure/exports/`
- 薄膜下单：`enclosure/exports/f405_canbox_membrane_panel_submit.pdf`

### 嘉立创 PCB

工程源码及生产资料：

- `hardware/jlcpcb/lcd_board/`
- `hardware/jlcpcb/power_board/`

模板说明见 [`hardware/jlcpcb/README.md`](hardware/jlcpcb/README.md)。

---

## 特殊物料采购清单

下列为不易在普通电阻电容库里凑齐、且影响外形/接口的关键件。完整贴片 BOM 与工艺注意见 [`docs/BOM_NOTES.md`](docs/BOM_NOTES.md)。

| 物料 | 型号 / 规格（参考） | 采购链接 | 备注 |
|------|---------------------|----------|------|
| 屏幕 | E3231BP-DCT 3.2" IPS，ST7789 + GT911 | [淘宝 · LVGL 屏幕套餐4 电容屏](https://item.taobao.com/item.htm?id=784378541041) | 规格书见 `enclosure/datasheets/` |
| 快充插座 | 国标直流充电接口车端母座 GB/T 20234.3 | [淘宝 · 直流充电口](https://item.taobao.com/item.htm?id=856807227623) | 与外壳正面 Ø72 D 型孔配合 |
| 输出插座 | 用电器插座（背面圆壁安装） | [淘宝 · 输出插座](https://item.taobao.com/item.htm?id=1007099848659) | 超出扁边部分需人工切削，见外壳说明 |
| MCU | STM32F405RGT6 / CKS32F405 LQFP64 | [立创商城](https://item.szlcsc.com/5855418.html) | 可咨询小牛采购 |
| EEPROM | AT24C512（或兼容） | [立创商城](https://item.szlcsc.com/12995.html) | I2C |
| 双面胶 | 屏-板连接 | [屏板双面胶](https://item.taobao.com/item.htm?id=547173088337) | 建议2mm |
| 安装螺丝 | 直流口安装 | [沉头M3*6](https://item.taobao.com/item.htm?id=599899192777) | 不能用其他规格 |

---

## 功能概要

- GB/T 27930 相关报文交互（BMS 视角模拟）
- 2.4"/3.2" 竖屏 LVGL UI：SOC、电压电流参数、日志、二维码等
- I2C EEPROM（AT24C512）持久化配置；`EPROM_PA_HALF46` 控制深/浅色背景（重启生效）
- SPI ST7789 + I2C GT911 电容触摸
- 桌面模拟器复用同一套 `lcd.c`，加快 UI 迭代

---

## 开源许可

| 内容 | 许可 |
|------|------|
| 固件、模拟器、工具脚本 | [MIT](LICENSE) |
| PCB / 外壳 / 薄膜等硬件设计 | [CERN-OHL-P-2.0](LICENSE.hardware) |
| 第三方库 | 见 [NOTICE](NOTICE) |

商标与品牌 Logo 不随 MIT/CERN-OHL 授权；商用请自行替换。

---

## 致谢与联系

- 原作者标注：`saico@mosf.cn` / http://www.mosf.cn/
- 构建栈：STM32Cube、FreeRTOS、LVGL

欢迎 Issue / PR；贡献说明见 [`CONTRIBUTING.md`](CONTRIBUTING.md)。