STM32Cubemx-H7-7-OLED屏幕（直接调用.c.h文件直接可以用）

企业开发 2025-04-10 00:44
0 阅读

注：2025年4月5日有更新，更新后直接修改.h文件的引脚和主频就可以直接使用

如何把江科大的OLED标准库文件换成hal库的文件

前言

本文讲解如在hHAL库中使用OLED，其实江科大做的文件好已经很好了

只讲操作，不讲废话，默认大家都有32基本操作

创建工程

首先创建工程

 把那两个引脚设置成开漏

获取标准库文件

打开江科大OLED的文档，然后把这三个工程文件放到目录下

添加文件位置

然后打开魔法棒添加文件位置

然后把三个文件添加进来

总修改内容

把OLED.c的前面几个文件修改就可以用了

#include "gpio.h"
#include "OLED_Font.h"

/*引脚配置*/
#define OLED_W_SCL(x)		HAL_GPIO_WritePin(GPIOB, GPIO_PIN_8,(x))
#define OLED_W_SDA(x)		HAL_GPIO_WritePin(GPIOB, GPIO_PIN_9,(x))

/*引脚初始化*/
void OLED_I2C_Init(void)
{
	OLED_W_SCL(1);
	OLED_W_SDA(1);
}

只用改这里

这里说明下为什么这样改

理解为什么修改源文件的几行代码就可以在HAL中使用

首先是

#include "stm32f10x.h"

因为我们是用HAL库，而且都已经在Cubemx配置好了，引脚初始化都在gpio.c里面了，所以直接把gpio.h文件放进来就好

所以就修改成

#include "gpio.h"

然后是

#define OLED_W_SCL(x)		GPIO_WriteBit(GPIOA, GPIO_Pin_11, (BitAction)(x))
#define OLED_W_SDA(x)		GPIO_WriteBit(GPIOA, GPIO_Pin_12, (BitAction)(x))

因为标准库和HAL库的库不同，定义输出函数也不一样，里面的参数也不一样，所以要把函数修改

#define OLED_W_SCL(x)		HAL_GPIO_WritePin(GPIOB, GPIO_PIN_8,(x))
#define OLED_W_SDA(x)		HAL_GPIO_WritePin(GPIOB, GPIO_PIN_9,(x))

HAL库的GPIO_PIN是都大写，参数是不一样的，然后直接给0和1 就行

void OLED_I2C_Init(void)
{

	OLED_W_SCL(1);
	OLED_W_SDA(1);
}

因为已经在gpio.c里面初始化过了，所以直接开始给高就行

在main.c中加入头文件

  OLED_Init();
  while (1)
  {
      OLED_ShowString(1,1,"Hellow World!");

试试Hellow函数

结果验证

成功实现输出！

OLED.c

#include "OLED.h"
#include "OLED_Font.h"
 

void OLED_delay_us(uint32_t us) {
    uint32_t i;
    for (i = 0; i < us * OLED_SYSTEM_MAX ; i++) {
        __asm("nop");
    }
}


void  OLED_W_SCL(uint8_t BitValue) {
    if (BitValue) {
        HAL_GPIO_WritePin(OLED_IIC_SCL_PORT, OLED_IIC_SCL_PIN, GPIO_PIN_SET);	
    }	
	else {
		HAL_GPIO_WritePin(OLED_IIC_SCL_PORT, OLED_IIC_SCL_PIN, GPIO_PIN_RESET);	
	}
	OLED_delay_us(1);
}

void  OLED_W_SDA(uint8_t BitValue) {
    if (BitValue) {
        HAL_GPIO_WritePin(OLED_IIC_SDA_PORT, OLED_IIC_SDA_PIN, GPIO_PIN_SET);	
    }
	else {
		HAL_GPIO_WritePin(OLED_IIC_SDA_PORT, OLED_IIC_SDA_PIN, GPIO_PIN_RESET);	
	}
	OLED_delay_us(1);
}
void OLED_I2C_Init(void)
{
	GPIO_InitTypeDef GPIO_InitStruct = {0};

    // 使能 SCL 和 SDA 引脚所在端口的时钟
    __HAL_RCC_GPIOB_CLK_ENABLE();  // 请根据实际情况修改

    // 配置 SCL 引脚
    GPIO_InitStruct.Pin = OLED_IIC_SCL_PIN;
    GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD;
    GPIO_InitStruct.Pull = GPIO_PULLUP;
    GPIO_InitStruct.Speed =GPIO_SPEED_FREQ_MEDIUM ;
    HAL_GPIO_Init(OLED_IIC_SCL_PORT, &GPIO_InitStruct);

    // 配置 SDA 引脚
    GPIO_InitStruct.Pin = OLED_IIC_SDA_PIN;
    HAL_GPIO_Init(OLED_IIC_SDA_PORT, &GPIO_InitStruct);
	
	OLED_W_SCL(1);
	OLED_W_SDA(1);
}

/**
  * @brief  I2C寮€濮�
  * @param  鏃�
  * @retval 鏃�
  */
void OLED_I2C_Start(void)
{
	OLED_W_SDA(1);
	OLED_W_SCL(1);
	OLED_W_SDA(0);
	OLED_W_SCL(0);
}

/**
  * @brief  I2C鍋滄
  * @param  鏃�
  * @retval 鏃�
  */
void OLED_I2C_Stop(void)
{
	OLED_W_SDA(0);
	OLED_W_SCL(1);
	OLED_W_SDA(1);
}

/**
  * @brief  I2C鍙戦€佷竴涓瓧鑺�
  * @param  Byte 瑕佸彂閫佺殑涓€涓瓧鑺�
  * @retval 鏃�
  */
void OLED_I2C_SendByte(uint8_t Byte)
{
	uint8_t i;
	for (i = 0; i < 8; i++)
	{
		OLED_W_SDA(Byte & (0x80 >> i));
		OLED_W_SCL(1);
		OLED_W_SCL(0);
	}
	OLED_W_SCL(1);	//棰濆鐨勪竴涓椂閽燂紝涓嶅鐞嗗簲绛斾俊鍙�
	OLED_W_SCL(0);
}

/**
  * @brief  OLED鍐欏懡浠�
  * @param  Command 瑕佸啓鍏ョ殑鍛戒护
  * @retval 鏃�
  */
void OLED_WriteCommand(uint8_t Command)
{
	OLED_I2C_Start();
	OLED_I2C_SendByte(0x78);		//浠庢満鍦板潃
	OLED_I2C_SendByte(0x00);		//鍐欏懡浠�
	OLED_I2C_SendByte(Command); 
	OLED_I2C_Stop();
}

/**
  * @brief  OLED鍐欐暟鎹�
  * @param  Data 瑕佸啓鍏ョ殑鏁版嵁
  * @retval 鏃�
  */
void OLED_WriteData(uint8_t Data)
{
	OLED_I2C_Start();
	OLED_I2C_SendByte(0x78);		//浠庢満鍦板潃
	OLED_I2C_SendByte(0x40);		//鍐欐暟鎹�
	OLED_I2C_SendByte(Data);
	OLED_I2C_Stop();
}

/**
  * @brief  OLED璁剧疆鍏夋爣浣嶇疆
  * @param  Y 浠ュ乏涓婅涓哄師鐐癸紝鍚戜笅鏂瑰悜鐨勫潗鏍囷紝鑼冨洿锛�0~7
  * @param  X 浠ュ乏涓婅涓哄師鐐癸紝鍚戝彸鏂瑰悜鐨勫潗鏍囷紝鑼冨洿锛�0~127
  * @retval 鏃�
  */
void OLED_SetCursor(uint8_t Y, uint8_t X)
{
	OLED_WriteCommand(0xB0 | Y);					//璁剧疆Y浣嶇疆
	OLED_WriteCommand(0x10 | ((X & 0xF0) >> 4));	//璁剧疆X浣嶇疆楂�4浣�
	OLED_WriteCommand(0x00 | (X & 0x0F));			//璁剧疆X浣嶇疆浣�4浣�
}

/**
  * @brief  OLED娓呭睆
  * @param  鏃�
  * @retval 鏃�
  */
void OLED_Clear(void)
{  
	uint8_t i, j;
	for (j = 0; j < 8; j++)
	{
		OLED_SetCursor(j, 0);
		for(i = 0; i < 128; i++)
		{
			OLED_WriteData(0x00);
		}
	}
}

/**
  * @brief  OLED鏄剧ず涓€涓瓧绗�
  * @param  Line 琛屼綅缃紝鑼冨洿锛�1~4
  * @param  Column 鍒椾綅缃紝鑼冨洿锛�1~16
  * @param  Char 瑕佹樉绀虹殑涓€涓瓧绗︼紝鑼冨洿锛欰SCII鍙瀛楃
  * @retval 鏃�
  */
void OLED_ShowChar(uint8_t Line, uint8_t Column, char Char)
{      	
	uint8_t i;
	OLED_SetCursor((Line - 1) * 2, (Column - 1) * 8);		//璁剧疆鍏夋爣浣嶇疆鍦ㄤ笂鍗婇儴鍒�
	for (i = 0; i < 8; i++)
	{
		OLED_WriteData(OLED_F8x16[Char - ' '][i]);			//鏄剧ず涓婂崐閮ㄥ垎鍐呭
	}
	OLED_SetCursor((Line - 1) * 2 + 1, (Column - 1) * 8);	//璁剧疆鍏夋爣浣嶇疆鍦ㄤ笅鍗婇儴鍒�
	for (i = 0; i < 8; i++)
	{
		OLED_WriteData(OLED_F8x16[Char - ' '][i + 8]);		//鏄剧ず涓嬪崐閮ㄥ垎鍐呭
	}
}

/**
  * @brief  OLED鏄剧ず瀛楃涓�
  * @param  Line 璧峰琛屼綅缃紝鑼冨洿锛�1~4
  * @param  Column 璧峰鍒椾綅缃紝鑼冨洿锛�1~16
  * @param  String 瑕佹樉绀虹殑瀛楃涓诧紝鑼冨洿锛欰SCII鍙瀛楃
  * @retval 鏃�
  */
void OLED_ShowString(uint8_t Line, uint8_t Column, char *String)
{
	uint8_t i;
	for (i = 0; String[i] != '\0'; i++)
	{
		OLED_ShowChar(Line, Column + i, String[i]);
	}
}

/**
  * @brief  OLED娆℃柟鍑芥暟
  * @retval 杩斿洖鍊肩瓑浜嶺鐨刌娆℃柟
  */
uint32_t OLED_Pow(uint32_t X, uint32_t Y)
{
	uint32_t Result = 1;
	while (Y--)
	{
		Result *= X;
	}
	return Result;
}

/**
  * @brief  OLED鏄剧ず鏁板瓧锛堝崄杩涘埗锛屾鏁帮級
  * @param  Line 璧峰琛屼綅缃紝鑼冨洿锛�1~4
  * @param  Column 璧峰鍒椾綅缃紝鑼冨洿锛�1~16
  * @param  Number 瑕佹樉绀虹殑鏁板瓧锛岃寖鍥达細0~4294967295
  * @param  Length 瑕佹樉绀烘暟瀛楃殑闀垮害锛岃寖鍥达細1~10
  * @retval 鏃�
  */
void OLED_ShowNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length)
{
	uint8_t i;
	for (i = 0; i < Length; i++)							
	{
		OLED_ShowChar(Line, Column + i, Number / OLED_Pow(10, Length - i - 1) % 10 + '0');
	}
}

/**
  * @brief  OLED鏄剧ず鏁板瓧锛堝崄杩涘埗锛屽甫绗﹀彿鏁帮級
  * @param  Line 璧峰琛屼綅缃紝鑼冨洿锛�1~4
  * @param  Column 璧峰鍒椾綅缃紝鑼冨洿锛�1~16
  * @param  Number 瑕佹樉绀虹殑鏁板瓧锛岃寖鍥达細-2147483648~2147483647
  * @param  Length 瑕佹樉绀烘暟瀛楃殑闀垮害锛岃寖鍥达細1~10
  * @retval 鏃�
  */
void OLED_ShowSignedNum(uint8_t Line, uint8_t Column, int32_t Number, uint8_t Length)
{
	uint8_t i;
	uint32_t Number1;
	if (Number >= 0)
	{
		OLED_ShowChar(Line, Column, '+');
		Number1 = Number;
	}
	else
	{
		OLED_ShowChar(Line, Column, '-');
		Number1 = -Number;
	}
	for (i = 0; i < Length; i++)							
	{
		OLED_ShowChar(Line, Column + i + 1, Number1 / OLED_Pow(10, Length - i - 1) % 10 + '0');
	}
}

/**
  * @brief  OLED鏄剧ず鏁板瓧锛堝崄鍏繘鍒讹紝姝ｆ暟锛�
  * @param  Line 璧峰琛屼綅缃紝鑼冨洿锛�1~4
  * @param  Column 璧峰鍒椾綅缃紝鑼冨洿锛�1~16
  * @param  Number 瑕佹樉绀虹殑鏁板瓧锛岃寖鍥达細0~0xFFFFFFFF
  * @param  Length 瑕佹樉绀烘暟瀛楃殑闀垮害锛岃寖鍥达細1~8
  * @retval 鏃�
  */
void OLED_ShowHexNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length)
{
	uint8_t i, SingleNumber;
	for (i = 0; i < Length; i++)							
	{
		SingleNumber = Number / OLED_Pow(16, Length - i - 1) % 16;
		if (SingleNumber < 10)
		{
			OLED_ShowChar(Line, Column + i, SingleNumber + '0');
		}
		else
		{
			OLED_ShowChar(Line, Column + i, SingleNumber - 10 + 'A');
		}
	}
}

/**
  * @brief  OLED鏄剧ず鏁板瓧锛堜簩杩涘埗锛屾鏁帮級
  * @param  Line 璧峰琛屼綅缃紝鑼冨洿锛�1~4
  * @param  Column 璧峰鍒椾綅缃紝鑼冨洿锛�1~16
  * @param  Number 瑕佹樉绀虹殑鏁板瓧锛岃寖鍥达細0~1111 1111 1111 1111
  * @param  Length 瑕佹樉绀烘暟瀛楃殑闀垮害锛岃寖鍥达細1~16
  * @retval 鏃�
  */
void OLED_ShowBinNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length)
{
	uint8_t i;
	for (i = 0; i < Length; i++)							
	{
		OLED_ShowChar(Line, Column + i, Number / OLED_Pow(2, Length - i - 1) % 2 + '0');
	}
}

/**
  * @brief  OLED鍒濆鍖�
  * @param  鏃�
  * @retval 鏃�
  */
void OLED_Init(void)
{
	uint32_t i, j;
	
	for (i = 0; i < 1000; i++)			//涓婄數寤舵椂
	{
		for (j = 0; j < 1000; j++);
	}
	
	OLED_I2C_Init();			//绔彛鍒濆鍖�
	
	OLED_WriteCommand(0xAE);	//鍏抽棴鏄剧ず
	
	OLED_WriteCommand(0xD5);	//璁剧疆鏄剧ず鏃堕挓鍒嗛姣�/鎸崱鍣ㄩ鐜�
	OLED_WriteCommand(0x80);
	
	OLED_WriteCommand(0xA8);	//璁剧疆澶氳矾澶嶇敤鐜�
	OLED_WriteCommand(0x3F);
	
	OLED_WriteCommand(0xD3);	//璁剧疆鏄剧ず鍋忕Щ
	OLED_WriteCommand(0x00);
	
	OLED_WriteCommand(0x40);	//璁剧疆鏄剧ず寮€濮嬭
	
	OLED_WriteCommand(0xA1);	//璁剧疆宸﹀彸鏂瑰悜锛�0xA1姝ｅ父 0xA0宸﹀彸鍙嶇疆
	
	OLED_WriteCommand(0xC8);	//璁剧疆涓婁笅鏂瑰悜锛�0xC8姝ｅ父 0xC0涓婁笅鍙嶇疆

	OLED_WriteCommand(0xDA);	//璁剧疆COM寮曡剼纭欢閰嶇疆
	OLED_WriteCommand(0x12);
	
	OLED_WriteCommand(0x81);	//璁剧疆瀵规瘮搴︽帶鍒�
	OLED_WriteCommand(0xCF);

	OLED_WriteCommand(0xD9);	//璁剧疆棰勫厖鐢靛懆鏈�
	OLED_WriteCommand(0xF1);

	OLED_WriteCommand(0xDB);	//璁剧疆VCOMH鍙栨秷閫夋嫨绾у埆
	OLED_WriteCommand(0x30);

	OLED_WriteCommand(0xA4);	//璁剧疆鏁翠釜鏄剧ず鎵撳紑/鍏抽棴

	OLED_WriteCommand(0xA6);	//璁剧疆姝ｅ父/鍊掕浆鏄剧ず

	OLED_WriteCommand(0x8D);	//璁剧疆鍏呯數娉�
	OLED_WriteCommand(0x14);

	OLED_WriteCommand(0xAF);	//寮€鍚樉绀�
		
	OLED_Clear();				//OLED娓呭睆
}

OLED.h

#ifndef __OLED_H
#define __OLED_H
#include "main.h"

#define OLED_IIC_SCL_PORT GPIOB  // 请根据实际情况修改
#define OLED_IIC_SCL_PIN GPIO_PIN_8  // 请根据实际情况修改
#define OLED_IIC_SDA_PORT GPIOB  // 请根据实际情况修改
#define OLED_IIC_SDA_PIN GPIO_PIN_9 // 请根据实际情况修改
#define OLED_SYSTEM_MAX 80 // 延时倍数

void OLED_delay_us(uint32_t us);
void OLED_W_SCL(uint8_t BitValue);
void OLED_W_SDA(uint8_t BitValue);
void OLED_Init(void);
void OLED_Clear(void);
void OLED_ShowChar(uint8_t Line, uint8_t Column, char Char);
void OLED_ShowString(uint8_t Line, uint8_t Column, char *String);
void OLED_ShowNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length);
void OLED_ShowSignedNum(uint8_t Line, uint8_t Column, int32_t Number, uint8_t Length);
void OLED_ShowHexNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length);
void OLED_ShowBinNum(uint8_t Line, uint8_t Column, uint32_t Number, uint8_t Length);

#endif

 #include "OLED_Font.h"不变

猜你喜欢

目录

热门文章