stm32液晶显示程序

以下是一个基于STM32的SPI接口OLED（SSD1306驱动）显示程序的示例代码，使用HAL库开发（通用步骤适用于任何STM32型号）：

1. 硬件连接

OLED_SCK   → PA5 (SPI1 CLK)
OLED_MOSI  → PA7 (SPI1 MOSI)
OLED_RES   → PB0 (复位引脚)
OLED_DC    → PB1 (数据/命令选择)
OLED_CS    → PB2 (片选引脚，若未使用可接地)

2. 代码实现

步骤1：添加驱动文件

// oled.h
#ifndef __OLED_H
#define __OLED_H

#include "stm32f1xx_hal.h" // 根据型号修改头文件

void OLED_Init(void);
void OLED_Clear(void);
void OLED_ShowString(uint8_t x, uint8_t y, char *str);

#endif

步骤2：OLED驱动核心代码

// oled.c
#include "oled.h"
#include "font.h" // 包含字库数据（需自行提供）

// 引脚定义
#define OLED_RES_GPIO_Port    GPIOB
#define OLED_RES_Pin          GPIO_PIN_0
#define OLED_DC_GPIO_Port     GPIOB
#define OLED_DC_Pin           GPIO_PIN_1

// SPI句柄引用
extern SPI_HandleTypeDef hspi1;

// 写命令
void OLED_Write_Cmd(uint8_t cmd) {
  HAL_GPIO_WritePin(OLED_DC_GPIO_Port, OLED_DC_Pin, GPIO_PIN_RESET); // DC=0:命令模式
  HAL_SPI_Transmit(&hspi1, &cmd, 1, 10);
}

// 写数据
void OLED_Write_Data(uint8_t dat) {
  HAL_GPIO_WritePin(OLED_DC_GPIO_Port, OLED_DC_Pin, GPIO_PIN_SET); // DC=1:数据模式
  HAL_SPI_Transmit(&hspi1, &dat, 1, 10);
}

// 初始化OLED
void OLED_Init(void) {
  // 复位序列
  HAL_GPIO_WritePin(OLED_RES_GPIO_Port, OLED_RES_Pin, GPIO_PIN_RESET);
  HAL_Delay(100);
  HAL_GPIO_WritePin(OLED_RES_GPIO_Port, OLED_RES_Pin, GPIO_PIN_SET);

  // 初始化命令序列
  OLED_Write_Cmd(0xAE); // 关闭显示
  OLED_Write_Cmd(0xD5); // 设置时钟分频
  OLED_Write_Cmd(0x80);
  OLED_Write_Cmd(0xA8); // 多路复用率
  OLED_Write_Cmd(0x3F);
  OLED_Write_Cmd(0xD3); // 显示偏移
  OLED_Write_Cmd(0x00);
  OLED_Write_Cmd(0x40); // 起始行
  OLED_Write_Cmd(0x8D); // 电荷泵
  OLED_Write_Cmd(0x14);
  OLED_Write_Cmd(0x20); // 内存模式
  OLED_Write_Cmd(0x00);
  OLED_Write_Cmd(0xA1); // 段重定向
  OLED_Write_Cmd(0xC8); // 扫描方向
  OLED_Write_Cmd(0xDA); // COM引脚配置
  OLED_Write_Cmd(0x12);
  OLED_Write_Cmd(0x81); // 对比度
  OLED_Write_Cmd(0xCF);
  OLED_Write_Cmd(0xD9); // 预充电周期
  OLED_Write_Cmd(0xF1);
  OLED_Write_Cmd(0xDB); // VCOMH电压
  OLED_Write_Cmd(0x40);
  OLED_Write_Cmd(0xA4); // 整体显示开启
  OLED_Write_Cmd(0xA6); // 正常显示
  OLED_Write_Cmd(0xAF); // 开启显示
  OLED_Clear();
}

// 清屏
void OLED_Clear(void) {
  for(uint8_t page=0; page<8; page++) {
    OLED_Write_Cmd(0xB0 + page); // 设置页地址
    OLED_Write_Cmd(0x00);        // 列低地址
    OLED_Write_Cmd(0x10);        // 列高地址
    for(uint8_t col=0; col<128; col++) {
      OLED_Write_Data(0x00);     // 填充空白
    }
  }
}

// 显示字符串
void OLED_ShowString(uint8_t x, uint8_t y, char *str) {
  uint8_t j = 0;
  while (str[j] != '\0') {
    // 在字库中查找字符（16x8字体）
    for(uint8_t i=0; i<8; i++) {
      OLED_Write_Cmd(0xB0 + y);              // 页地址
      OLED_Write_Cmd(((x+j*8)&0x0F) | 0x00); // 列低地址
      OLED_Write_Cmd(((x+j*8)>>4) | 0x10);   // 列高地址
      OLED_Write_Data(Font8x16[str[j]-32][i]);// 写入字模数据
      OLED_Write_Data(Font8x16[str[j]-32][i+8]);
    }
    j++;
  }
}

步骤3：主函数调用

// main.c
#include "stm32f1xx_hal.h"
#include "oled.h"

int main(void) {
  HAL_Init();
  SystemClock_Config();
  MX_SPI1_Init(); // SPI初始化（需在CubeMX配置）

  OLED_Init();
  OLED_ShowString(0, 0, "Hello STM32!");
  OLED_ShowString(0, 2, "OLED Display Test");

  while(1) {
    // 主循环
  }
}