316 lines
8.8 KiB
C
316 lines
8.8 KiB
C
#pragma once
|
||
#ifndef HW_LIB_OLED_H
|
||
#define HW_LIB_OLED_H
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
#include "stdbool.h"
|
||
#include "stdint.h"
|
||
|
||
|
||
#define REFRESH_CALL_ENABLE 1 //使用DMA或者整体刷新函数
|
||
#define HZK_FONT //使用HZK 12/16 字体 tools下可自由生成
|
||
#define UTF8_TO_UNICODE //启用UTF8转换显示
|
||
//#define LVGL_FONT //启用LVGL字体
|
||
|
||
/**
|
||
* @brief OLED设备结构体
|
||
*/
|
||
typedef struct OLED_Dev OLED_T;
|
||
|
||
/**
|
||
* @brief OLED命令处理函数指针类型
|
||
* @param data: [输入] 数据指针
|
||
* @param len: [输入] 数据长度
|
||
* @return uint8_t 返回值
|
||
*/
|
||
typedef uint8_t (*OLED_CMD_t)(uint8_t* data, size_t len);
|
||
|
||
/**
|
||
* @brief OLED数据处理函数指针类型
|
||
* @param data: [输入] 数据指针
|
||
* @param len: [输入] 数据长度
|
||
* @return uint8_t 返回值
|
||
*/
|
||
typedef uint8_t (*OLED_DATA_t)(uint8_t* data, size_t len);
|
||
|
||
#if REFRESH_CALL_ENABLE
|
||
|
||
/**
|
||
* @brief OLED刷新函数指针类型
|
||
*/
|
||
typedef void (*OLED_REFRESH_t)(OLED_T* dev);
|
||
|
||
#endif
|
||
|
||
/**
|
||
* @brief OLED状态枚举
|
||
*/
|
||
typedef enum
|
||
{
|
||
IDLE, /**< 空闲状态 */
|
||
WRITE, /**< 写入状态 */
|
||
REFRESH, /**< 刷新状态 */
|
||
} OLED_STATE_T;
|
||
|
||
/**
|
||
* @brief OLED设备结构体
|
||
*/
|
||
struct OLED_Dev
|
||
{
|
||
uint8_t* buf; /**< 显示缓冲区指针 */
|
||
uint8_t width; /**< 显示宽度 */
|
||
uint8_t height; /**< 显示高度 */
|
||
OLED_STATE_T state; /**< OLED状态 */
|
||
OLED_CMD_t cmd; /**< OLED命令处理函数指针 */
|
||
OLED_DATA_t data; /**< OLED数据处理函数指针 */
|
||
#if REFRESH_CALL_ENABLE
|
||
OLED_REFRESH_t call; /**< OLED刷新函数指针 */
|
||
#endif
|
||
};
|
||
|
||
// OLED初始化指令数组
|
||
//const uint8_t initCmd[] = {
|
||
// 1, 0xAE, // 关闭显示
|
||
// 2, 0xD5, 0x80, // 设置显示时钟分频比/振荡器频率
|
||
// 2, 0xA8, 0x3F, // 设置多路复用比率
|
||
// 2, 0xD3, 0x00, // 设置显示偏移
|
||
// 2, 0x40, 0x00, // 设置显示起始行
|
||
// 2, 0x8D, 0x14, // 电荷泵设置
|
||
// 2, 0x20, 0x00, // 设置内存寻址模式
|
||
// 1, 0xA0, // 设置段重映射
|
||
// 1, 0xC0, // 设置COM输出扫描方向
|
||
// 2, 0xDA, 0x12, // 设置COM引脚硬件配置
|
||
// 2, 0x81, 0xCF, // 设置对比度控制
|
||
// 2, 0xD9, 0xF1, // 设置预充电周期
|
||
// 2, 0xDB, 0x20, // 设置VCOMH取消电平
|
||
// 2, 0xA4, 0xA6, // 整个显示打开
|
||
// 1, 0xAF // 打开显示
|
||
//};
|
||
|
||
|
||
/**
|
||
* @brief OLED初始化
|
||
* @param dev: [输入] OLED设备指针
|
||
* @return void
|
||
* @example OLED_Init(&oled_dev);
|
||
*/
|
||
void OLED_Init(OLED_T *dev);
|
||
|
||
/**
|
||
* @brief OLED初始化
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param cmd: [输入] OLED初始化指令表
|
||
* @param len: [输入] OLED初始化指令表长度
|
||
* @return void
|
||
* @example OLED_Init(&oled_dev);
|
||
*/
|
||
void OLED_Init_CMD(OLED_T *dev, uint8_t *cmd, uint16_t len);
|
||
/**
|
||
* @brief 打开OLED显示
|
||
* @param dev: [输入] OLED设备指针
|
||
* @return void
|
||
* @example OLED_ON(&oled_dev);
|
||
*/
|
||
void OLED_ON(OLED_T* dev);
|
||
|
||
/**
|
||
* @brief 关闭OLED显示
|
||
* @param dev: [输入] OLED设备指针
|
||
* @return void
|
||
* @example OLED_OFF(&oled_dev);
|
||
*/
|
||
void OLED_OFF(OLED_T* dev);
|
||
|
||
/**
|
||
* @brief 打开或关闭OLED显示
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param e: [输入] true表示打开，false表示关闭
|
||
* @return void
|
||
* @example OLED_Turn(&oled_dev, true);
|
||
*/
|
||
void OLED_Turn(OLED_T* dev, bool e);
|
||
|
||
/**
|
||
* @brief 刷新OLED显示
|
||
* @param dev: [输入] OLED设备指针
|
||
* @return void
|
||
* @example OLED_Refresh(&oled_dev);
|
||
*/
|
||
void OLED_Refresh(OLED_T* dev);
|
||
|
||
/**
|
||
* @brief 设置OLED显示开关
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param e: [输入] true表示显示，false表示关闭
|
||
* @return void
|
||
* @example OLED_DisplayTurn(&oled_dev, true);
|
||
*/
|
||
void OLED_DisplayTurn(OLED_T* dev, bool e);
|
||
|
||
/**
|
||
* @brief 设置显示位置
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] X坐标
|
||
* @param y: [输入] Y坐标
|
||
* @return void
|
||
* @example OLED_Set(&oled_dev, 0, 0);
|
||
*/
|
||
void OLED_Set(OLED_T* dev, uint8_t x, uint8_t y);
|
||
|
||
/**
|
||
* @brief 取消显示位置
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] X坐标偏移量
|
||
* @param y: [输入] Y坐标偏移量
|
||
* @return void
|
||
* @example OLED_RSet(&oled_dev, 10, 10);
|
||
*/
|
||
void OLED_RSet(OLED_T* dev, uint8_t x, uint8_t y);
|
||
|
||
/**
|
||
* @brief 绘制直线
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x1: [输入] 起始点X坐标
|
||
* @param y1: [输入] 起始点Y坐标
|
||
* @param x2: [输入] 结束点X坐标
|
||
* @param y2: [输入] 结束点Y坐标
|
||
* @return void
|
||
* @example OLED_DrawLine(&oled_dev, 0, 0, 20, 20);
|
||
*/
|
||
void OLED_DrawLine(OLED_T* dev, uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2);
|
||
|
||
/**
|
||
* @brief 在 OLED 上绘制矩形
|
||
* @param dev: [输入] OLED 设备指针
|
||
* @param x1: [输入] 矩形左上角 x 坐标
|
||
* @param y1: [输入] 矩形左上角 y 坐标
|
||
* @param x2: [输入] 矩形右下角 x 坐标
|
||
* @param y2: [输入] 矩形右下角 y 坐标
|
||
* @return void
|
||
* @example OLED_DrawRect(&oledDevice, 10, 10, 50, 30);
|
||
**/
|
||
void OLED_DrawRect(OLED_T* dev, uint8_t x1, uint8_t y1, uint8_t x2, uint8_t y2);
|
||
|
||
/**
|
||
* @brief 绘制圆
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] 圆心X坐标
|
||
* @param y: [输入] 圆心Y坐标
|
||
* @param r: [输入] 圆半径
|
||
* @return void
|
||
* @example OLED_DrawCircle(&oled_dev, 30, 30, 10);
|
||
*/
|
||
void OLED_DrawCircle(OLED_T* dev, uint8_t x, uint8_t y, uint8_t r);
|
||
|
||
/**
|
||
* @brief 显示字符
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] X坐标
|
||
* @param y: [输入] Y坐标
|
||
* @param chr: [输入] 要显示的字符
|
||
* @param size1: [输入] 字体大小
|
||
* @return void
|
||
* @example OLED_ShowChar(&oled_dev, 0, 0, 'A', 16);
|
||
*/
|
||
void OLED_ShowChar(OLED_T* dev, uint8_t x, uint8_t y, uint8_t chr, uint8_t size1);
|
||
|
||
/**
|
||
* @brief 显示字符串
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] X坐标
|
||
* @param y: [输入] Y坐标
|
||
* @param chr: [输入] 要显示的字符串
|
||
* @param size1: [输入] 字体大小
|
||
* @return void
|
||
* @example OLED_ShowString(&oled_dev, 0, 0, "Hello", 16);
|
||
*/
|
||
void OLED_ShowString(OLED_T* dev, uint8_t x, uint8_t y, uint8_t* chr, uint8_t size1);
|
||
#ifdef HZK_FONT
|
||
|
||
/**
|
||
* @brief 在OLED上显示指定大小的中文字符串
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] X坐标
|
||
* @param y: [输入] Y坐标
|
||
* @param str: [输入] 中文字符串指针
|
||
* @return void
|
||
* @example OLED_ShowCHString(&oled_device, 0, 0, chinese_str);
|
||
**/
|
||
void OLED_ShowCHString(OLED_T* dev, uint8_t x, uint8_t y, uint8_t* str);
|
||
#endif
|
||
/**
|
||
* @brief 在OLED屏幕上显示数字
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] 数字显示的起始横坐标
|
||
* @param y: [输入] 数字显示的起始纵坐标
|
||
* @param num: [输入] 要显示的数字
|
||
* @param len: [输入] 数字长度
|
||
* @param size1: [输入] 字体大小
|
||
* @return void
|
||
* @example OLED_ShowNum(&oled_dev, 0, 0, 12345, 5, 12);
|
||
**/
|
||
void OLED_ShowNum(OLED_T* dev, uint8_t x, uint8_t y, uint32_t num, uint8_t len, uint8_t size1);
|
||
|
||
/**
|
||
* @brief 在OLED屏幕上显示图片
|
||
* @param dev: [输入] OLED设备结构体指针
|
||
* @param x0: [输入] 图片左上角x坐标
|
||
* @param y0: [输入] 图片左上角y坐标
|
||
* @param w: [输入] 图片宽度
|
||
* @param h: [输入] 图片高度
|
||
* @param bmp: [输入] 图片数据指针
|
||
* @return void
|
||
* @example OLED_ShowPic(&oled_dev, 0, 0, 128, 64, bmp_data);
|
||
**/
|
||
void OLED_ShowPic(OLED_T* dev, uint8_t x0, uint8_t y0, uint8_t w, uint8_t h, uint8_t* bmp);
|
||
|
||
/**
|
||
* @brief 设置显示起始坐标
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param x: [输入] X坐标
|
||
* @param y: [输入] Y坐标
|
||
* @return void
|
||
* @example OLED_SPos(&oled_dev, 0, 0);
|
||
*/
|
||
void OLED_SPos(OLED_T* dev, uint8_t x, uint8_t y);
|
||
|
||
/**
|
||
* @brief 填充OLED显示缓冲区
|
||
* @param dev: [输入] OLED设备指针
|
||
* @param data: [输入] 填充数据
|
||
* @return void
|
||
* @example OLED_Fill(&oled_dev, 0xFF);
|
||
*/
|
||
void OLED_Fill(OLED_T* dev, uint8_t data);
|
||
|
||
/**
|
||
* @brief 清空OLED显示缓冲区
|
||
* @param dev: [输入] OLED设备指针
|
||
* @return void
|
||
* @example OLED_CLS(&oled_dev);
|
||
*/
|
||
void OLED_CLS(OLED_T* dev);
|
||
|
||
#ifdef LVGL_FONT
|
||
|
||
#include "lvgl_font.h"
|
||
|
||
/**
|
||
* @brief 在OLED上显示字符串
|
||
* @param dev: [输入] OLED设备结构体指针
|
||
* @param font: [输入] 字体信息
|
||
* @param s: [输入] 要显示的字符串
|
||
* @param x: [输入] 字符串左上角 x 坐标
|
||
* @param y: [输入] 字符串左上角 y 坐标
|
||
* @return void
|
||
* @example OLED_DisplayString(&oled_device, &font_arial_16, "Hello World", 10, 20);
|
||
**/
|
||
void OLED_DisplayString(OLED_T *dev, const lv_font_t *font, uint8_t *s, uint16_t x, uint16_t y);
|
||
|
||
#endif
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
#endif //HW_LIB_OLED_H
|