# led32x64_wifi_clock

**Repository Path**: wenhuafeng/led32x64_wifi_clock

## Basic Information

- **Project Name**: led32x64_wifi_clock
- **Description**: 基于STM32F103C8T6的WiFi/GPS时钟项目，使用32x64 RGB三色LED点阵显示屏（HUB75D接口），支持多种实用功能和低功耗设计。
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 8
- **Forks**: 3
- **Created**: 2022-03-20
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: hardware

**Tags**: None

## README

# LED32X64 WiFi时钟项目

## 项目概述
基于STM32F103C8T6的WiFi/GPS时钟项目，使用32x64 RGB三色LED点阵显示屏（HUB75D接口），支持多种实用功能和低功耗设计。

## 主要功能

### 显示功能
- **LED显示屏**：32X64 RGB三色LED点阵，HUB75D接口
- **显示内容**：时钟、万年历、星期、农历、温湿度
- **亮度调节**：支持多级亮度调节

### 系统特性
- **MCU**：STM32F103C8T6
- **操作系统**：FreeRTOS系统，CMSIS2封装接口
- **低功耗模式**：关显示后RTC低功耗运行（非FreeRTOS版本特有）

### 智能功能
- **人体感应**：红外感应点亮显示，5分钟无人自动关闭（触发红外重新计时）
- **WiFi校时**：通过SNTP自动更新时间和日期，成功后关闭WiFi电源（宏开关控制）
- **GPS校时**：通过GPS方式更新时间和日期，成功后关闭GPS模块（宏开关控制）

## 项目结构

```
led32x64_wifi_clock/
├── stm32f103c8t6/      # STM32F103C8T6项目文件
│   ├── cmake/          # CMake构建文件
│   ├── Core/           # 核心代码
│   ├── Drivers/        # 驱动库
│   ├── Middlewares/    # 中间件
│   ├── EWARM/          # IAR项目文件
│   └── MDK-ARM/        # MDK项目文件
├── user/               # 用户应用代码
│   ├── common/         # 通用功能模块
│   ├── display/        # 显示相关代码
│   ├── gps/            # GPS模块代码
│   ├── oled/           # OLED显示代码
│   ├── openocd/        # OpenOCD配置文件
│   ├── output/         # 编译输出目录
│   ├── temp_humi/      # 温湿度传感器代码
│   ├── time/           # 时间相关代码
│   ├── trace/          # 调试跟踪代码
│   └── wifi/           # WiFi模块代码
├── auto_build/         # 自动编译构建子模块
└── document/           # 项目文档
```

## 编译与构建

本项目使用新的`auto_build`子模块进行编译构建，支持多种编译工具链和烧录器。

### 编译工具要求
- Python 3.6及以上版本
- 根据需要安装编译工具：
  - MDK (Keil)：需确保UV4.exe在系统路径中
  - GCC：需安装ARM GCC工具链和CMake
  - IAR：需安装IAR Embedded Workbench

### 编译命令

进入项目根目录执行以下命令：

```bash
# 使用MDK编译应用程序
python auto_build/build.py build -c stm32f103c8t6 -t mdk

# 使用MDK全量编译（clean模式）
python auto_build/build.py build -c stm32f103c8t6 -t mdk --clean

# 编译Bootloader（如果需要）
python auto_build/build.py build -c stm32f103c8t6 -t mdk --boot --clean

# mdk，iar，gcc，三个编译软件可选择
```

## 烧录与调试

### 烧录器要求
- 根据需要安装烧录工具：
  - J-Link：需安装J-Link软件包
  - ST-Link：需安装ST-Link Utility或OpenOCD
  - DAP-Link：支持OpenOCD或PyOCD（可选）

### 烧录命令

```bash
# 使用J-Link烧录应用程序
python auto_build/build.py program -c stm32f103c8t6 -p j-link --app

# 使用ST-Link烧录应用程序
python auto_build/build.py program -c stm32f103c8t6 -p st-link --app

# 使用DAP-Link烧录应用程序
python auto_build/build.py program -c stm32f103c8t6 -p dap-link --app

# 烧录Bootloader
python auto_build/build.py program -c stm32f103c8t6 -p j-link --boot
```

## 配置说明

主要配置文件位于`auto_build/build_config.json`，可根据需要修改：
- 项目路径配置
- 编译工具链配置
- 烧录器配置
- 芯片型号扩展

## 注意事项

1. 确保所有依赖工具都已正确安装并添加到系统路径
2. 首次使用前请检查`auto_build/build_config.json`中的路径配置
3. WiFi和GPS校时功能可通过宏开关控制
4. 烧录前请确保目标设备已正确连接
5. 详细的编译和烧录选项可参考`auto_build/readme.md`

## 显示效果
![显示效果](./document/image/clock.jpg)

## 许可证

本项目采用 MIT 许可证开源。

```
MIT License

Copyright (c) [2024] [LED32X64 WiFi时钟项目]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```