# gd32f10x-epd-base

**Repository Path**: csg-baiyuan-juhui/gd32f10x-epd-base

## Basic Information

- **Project Name**: gd32f10x-epd-base
- **Description**: GD32+墨水屏项目基础，带UI绘制
- **Primary Language**: C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-26
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GD32F10x EPD Base 工程

## 项目简介
本工程基于 GD32F10x 系列 MCU，支持电子纸（EPD）显示、字体渲染、二维码生成、CAN 通信、USB 设备等功能，适用于嵌入式显示应用开发。

## 目录结构

- **Epaper/**  
  电子纸相关驱动与库  
  - **EPD/** 电子纸 SPI 驱动及演示  
  - **Fonts/** 字体文件及头文件  
  - **GUI/** 图形绘制库  
  - **QRLib/** 二维码生成库

- **Firmware/**  
  芯片底层库与外设驱动  
  - **CMSIS/** ARM Cortex-M3 内核支持包  
  - **GD32F10x_standard_peripheral/** 标准外设库  
  - **GD32F10x_usbd_library/** USB 设备库  
  - **GD32F10x_usbfs_library/** USB FS 库  
  - **Inc/** 用户头文件（如 board.h、can.h、main.h 等）

- **Src/**  
  用户主程序与外设实现  
  - board.c、can.c、main.c、systick.c、gd32f10x_it.c

- **MDK-ARM/**  
  Keil 工程文件、编译输出、配置等  
  - prj3.uvprojx、prj3.uvoptx、.vscode/、Objects/、Listings/

## 编译环境

- **Keil MDK-ARM 5.06**
- **ARMCC 编译器**
- **GD32F10x DFP 2.3.0**
- 推荐使用 VS Code 进行辅助编辑

## 主要功能

- 电子纸显示驱动（SPI 接口）
- 字体渲染（多种点阵字体，支持中文）
- 二维码生成（QRLib）
- CAN 总线通信
- USB 设备功能
- 板级支持包与中断管理

## 快速开始

1. 使用 Keil 打开 `MDK-ARM/prj3.uvprojx` 工程文件。
2. 选择目标板（GD32F103RG），编译并下载程序。
3. 代码入口在 [`main.c`](Src/main.c)。

## 参考文件

- 电子纸驱动：[Epaper/EPD/Display_EPD_W21_spi.c](Epaper/EPD/Display_EPD_W21_spi.c)
- 字体头文件：[Epaper/Fonts/fonts.h](Epaper/Fonts/fonts.h)
- 图形绘制：[Epaper/GUI/GUI_Paint.c](Epaper/GUI/GUI_Paint.c)
- 二维码库：[Epaper/QRLib/qr_encode.c](Epaper/QRLib/qr_encode.c)
- CAN 驱动：[Src/can.c](Src/can.c)
- 板级初始化：[Src/board.c](Src/board.c)

## License

请遵循各文件头部声明的许可协议（如 NXP 字体版权等）。

---

如需详细开发文档或遇到问题，请查阅各模块源码及头文件说明。