# HAL_I2C_0.96_OLED_Driver

**Repository Path**: lczhuigz/hal_i2c_0.96_oled_driver

## Basic Information

- **Project Name**: HAL_I2C_0.96_OLED_Driver
- **Description**: 江协科技标准库移植HAL库模拟I2C，0.96寸OLED驱动，cmake工程
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-05-14
- **Last Updated**: 2025-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# STM32 HAL库 0.96寸 OLED显示屏驱动 (CMake版)

基于 STM32 HAL 库的 0.96 寸 OLED 显示屏驱动程序，使用 CMake 构建系统。

## 开发环境

- 编译器: ARM GCC
- 构建系统: CMake 3.15+
- IDE: Visual Studio Code
- 调试器: OpenOCD/J-Link

## 目录结构

```
.
├── CMakeLists.txt          # 主CMake配置文件
├── Hardware/              # 硬件相关代码
│   ├── Inc/              # 头文件
│   └── Src/              # 源文件
├── Core/                  # STM32核心代码
│   ├── Inc/              # 头文件
│   └── Src/              # 源文件
└── build/                # 构建输出目录
```

## 硬件连接

| OLED引脚 | STM32引脚 |
|----------|-----------|
| SCL      | PB8      |
| SDA      | PB9      |
| VCC      | 3.3V     |
| GND      | GND      |

## 主要功能

- 支持字符显示(6x8, 8x16点阵)
- 支持中文显示(16x16点阵)
- 支持数字显示(十进制、十六进制、二进制)
- 支持浮点数显示
- 支持基本图形绘制(点、线、矩形、圆形、椭圆等)
- 支持图片显示
- 支持整屏缓存更新

## 使用示例

```c
// 初始化OLED
OLED_Init();

// 显示文本
OLED_ShowString(0, 0, "Hello World", OLED_8X16);

// 更新显示
OLED_Update();
```

## CMake 配置说明

项目使用 CMake 作为构建系统，主要配置包括：
- 交叉编译工具链设置
- STM32 HAL 库路径配置
- 编译选项设置
- 链接脚本配置

详细配置请参考 `CMakeLists.txt`。

## 调试说明

VS Code 调试配置位于 `.vscode/launch.json`，支持：
- OpenOCD 调试
- J-Link 调试
- SWD 下载

## 注意事项

- 确保正确安装 ARM GCC 工具链并添加到系统PATH
- CMake 版本需要 3.15 或更高
- 使用前检查 `CMakeLists.txt` 中的工具链路径配置

## 许可证

MIT License