#pragma once #ifndef HW_LIB_OLED_H #define HW_LIB_OLED_H #ifdef __cplusplus extern "C" { #endif #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设备指针 * @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