php 网站进入后台,猪八戒网网站开发需求,扬中网站建设多少钱,广州专业网站改版目录 OLED设备层驱动开发
如何抽象一个OLED
完成OLED的功能
初始化OLED
清空屏幕
刷新屏幕与光标设置1
刷新屏幕与光标设置2
刷新屏幕与光标设置3
绘制一个点
反色
区域化操作
区域置位
区域反色
区域更新
区域清空
测试我们的抽象
整理一下#xff0c;我们应…目录 OLED设备层驱动开发
如何抽象一个OLED
完成OLED的功能
初始化OLED
清空屏幕
刷新屏幕与光标设置1
刷新屏幕与光标设置2
刷新屏幕与光标设置3
绘制一个点
反色
区域化操作
区域置位
区域反色
区域更新
区域清空
测试我们的抽象
整理一下我们应该如何使用 在上一篇博客从0开始使用面对对象C语言搭建一个基于OLED的图形显示框架2-CSDN博客中我们完成了协议层的抽象现在让我们更近一步完成对设备层的抽象。
OLED设备层驱动开发
现在我们终于来到了最难的设备层驱动开发。在这里我们抽象出来了一个叫做OLED_Device的东西我们终于可以关心的是一块OLED他可以被打开被设置被关闭可以绘制点可以绘制面可以清空可以反色等等。画画不是这个层次该干的事情要知道绘制一个图形需要从这个设备可以被绘制开始也就是他可以画点画面开始
所以离我在这篇总览中从0开始使用面对对象C语言搭建一个基于OLED的图形显示框架-CSDN博客提到的绘制一个多级菜单还是有一些遥远的。饭一口口吃事情一步步做这急不得一着急反而会把我们精心维护的抽象破坏掉。
代码在MCU_Libs/OLED/library/OLED at main · Charliechen114514/MCU_Libs (github.com)两个文件夹都有所涉及所以本篇的代码量会非常巨大。请各位看官合理安排。
如何抽象一个OLED
协议层上我们抽象了一个IIC协议。现在在设备层上我们将进一步抽象一个OLED。上面笔者提到了一个OLED可以被开启关闭画点画面反色等等操作他能干他如何干是我们马上要做的事情。现在我们需要一个OLED句柄。这个OLED句柄代表了背后使用的通信协议和它自身相关的属性信息而不必要外泄到其他模块上去。所以封装一个这样的抽象变得很有必要。
OLED的品种很多分法也很多笔者顺其自然打算封装一个这样的结构体
typedef struct __OLED_Handle_Type{/* driver types announced the way we explain the handle */OLED_Driver_Type stored_handle_type;/* handle data types here */OLED_Handle_Private private_handle;
}OLED_Handle;
让我来解释一下首先我们的OLED品种很多程序如何知道你的OLED如何被解释呢stored_handle_type标识的类型来决定采取何种行动解释。。。什么呢解释我们的private_handle。
typedef enum {OLED_SOFT_IIC_DRIVER_TYPE,OLED_HARD_IIC_DRIVER_TYPE,OLED_SOFT_SPI_DRIVER_TYPE,OLED_HARD_SPI_DRIVER_TYPE
}OLED_Driver_Type;
/* to abstract the private handle base this is to isolate the dependencies ofthe real implementations
*/
typedef void* OLED_Handle_Private;
也就是说笔者按照采取的协议进行抽象将OLED本身的信息属性差异封装到文件内部去作为使用不同的片子只需要使用编译宏编译不同的文件就好了。现在OLED_Handle就是我们的OLED拿到这个结构体我们就掌握了整个OLED。所以整个OLED结构体必然可以做到如下的事情
#ifndef OLED_BASE_DRIVER_H
#define OLED_BASE_DRIVER_H
#include oled_config.h
typedef struct __OLED_Handle_Type{/* driver types announced the way we explain the handle */OLED_Driver_Type stored_handle_type;/* handle data types here */OLED_Handle_Private private_handle;
}OLED_Handle;
/*oled_init_hardiic_handle registers the hardiic commnications
handle: Pointer to an OLED_Handle structure that represents the handle for the OLED display, used for managing and controlling the OLED device.programmers should pass a blank one!
config: Pointer to an OLED_HARD_IIC_Private_Config structure that contains the configuration settings for initializing the hardware interface, typically related to the I2C communication parameters for the OLED display.
*/
// 按照硬件IIC进行初始化
void oled_init_hardiic_handle(OLED_Handle* handle, OLED_HARD_IIC_Private_Config* config);
/*oled_init_hardiic_handle registers the hardiic commnications
handle: Pointer to an OLED_Handle structure that represents the handle for the OLED display, used for managing and controlling the OLED device.programmers should pass a blank one!
config: Pointer to an OLED_SOFT_IIC_Private_Config structure that contains the configuration settings for initializing the hardware interface, typically related to the I2C communication parameters for the OLED display.
*/
// 按照软件IIC进行初始化
void oled_init_softiic_handle(OLED_Handle* handle,OLED_SOFT_IIC_Private_Config* config
);
/* 可以清空 */
void oled_helper_clear_frame(OLED_Handle* handle);
void oled_helper_clear_area(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height);
/* 需要刷新这里采用了缓存机制 */
void oled_helper_update(OLED_Handle* handle);
void oled_helper_update_area(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height);
/* 可以反色 */
void oled_helper_reverse(OLED_Handle* handle);
void oled_helper_reversearea(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height);
/* 可以绘制 */
void oled_helper_setpixel(OLED_Handle* handle, uint16_t x, uint16_t y);
void oled_helper_draw_area(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint8_t* sources);
/* 自身的属性接口是我们之后要用的 */
uint8_t oled_support_rgb(OLED_Handle* handle);
uint16_t oled_width(OLED_Handle* handle);
uint16_t oled_height(OLED_Handle* handle);
#endif
说完了接口下面就是实现了。
完成OLED的功能
初始化OLED
整个事情我们终于开始翻开我们的OLED手册了。我们的OLED需要一定的初始化。让我们看看江科大代码是如何进行OLED的初始化。
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清屏
}
好长一大串麻了代码真的不好看。我们为什么不使用数组进行初始化呢
uint8_t oled_init_commands[] {0xAE, // Turn off OLED panel0xFD, 0x12, // Set display clock divide ratio/oscillator frequency0xD5, // Set display clock divide ratio0xA0, // Set multiplex ratio0xA8, // Set multiplex ratio (1 to 64)0x3F, // 1/64 duty0xD3, // Set display offset0x00, // No offset0x40, // Set start line address0xA1, // Set SEG/Column mapping (0xA0 for reverse, 0xA1 for normal)0xC8, // Set COM/Row scan direction (0xC0 for reverse, 0xC8 for normal)0xDA, // Set COM pins hardware configuration0x12, // COM pins configuration0x81, // Set contrast control register0xBF, // Set SEG output current brightness0xD9, // Set pre-charge period0x25, // Set pre-charge as 15 clocks discharge as 1 clock0xDB, // Set VCOMH0x34, // Set VCOM deselect level0xA4, // Disable entire display on0xA6, // Disable inverse display on0xAF // Turn on the display
};
#define CMD_TABLE_SZ ( (sizeof(oled_init_commands)) / sizeof(oled_init_commands[0]) )
现在我们只需要按部就班的按照顺序发送我们的指令。以hardiic的初始化为例子
void oled_init_hardiic_handle(OLED_Handle* handle, OLED_HARD_IIC_Private_Config* config)
{// 传递使用的协议句柄, 以及告知我们的句柄类型 handle-private_handle config;handle-stored_handle_type OLED_HARD_IIC_DRIVER_TYPE;// 按部就班的发送命令表for(uint8_t i 0; i CMD_TABLE_SZ; i)// 这里我们协议的send_command就发力了, 现在我们完全不关心他是如何发送命令的config-operation.command_sender(config, oled_init_commands[i]);// 把frame清空掉oled_helper_clear_frame(handle);// 把我们的frame commit上去oled_helper_update(handle);
}
这里我们还剩下最后两行代码没解释为什么是oled_helper_clear_frame和update要分离开来呢我们知道频繁的刷新OLED屏幕非常占用我们的单片机内核也不利于我们合并绘制操作。比如说我想绘制两个圆为什么不画完一起更新上去呢比起来画一个点更新一下这个操作显然更合理。所以为了完成这样的技术我们需要一个Buffer缓冲区。
uint8_t OLED_GRAM[OLED_HEIGHT][OLED_WIDTH];
他就承担了我们的缓存区。多大呢这个事情跟OLED的种类有关系一些OLED的大小是128 x 64另一些是144 x 64无论如何我们需要根据chip的种类来选择我们的OLED的大小更加严肃的说是OLED的属性和它的功能。
所以这就是为什么笔者在MCU_Libs/OLED/library/OLED/Driver/oled_config.h at main · Charliechen114514/MCU_Libs (github.com)文件中引入了这样的控制宏
#ifndef SSD1306_H
#define SSD1306_H
/* hardware level defines */
#define PORT_SCL GPIOB
#define PORT_SDA GPIOB
#define PIN_SCL GPIO_PIN_8
#define PIN_SDA GPIO_PIN_9
#define OLED_ENABLE_GPIO_SCL_CLK() __HAL_RCC_GPIOB_CLK_ENABLE()
#define OLED_ENABLE_GPIO_SDA_CLK() __HAL_RCC_GPIOB_CLK_ENABLE()
#define OLED_WIDTH (128)
#define OLED_HEIGHT (8)
#define POINT_X_MAX (OLED_WIDTH)
#define POINT_Y_MAX (OLED_HEIGHT * 8)
#endif
这个文件是ssd1306.h这个文件专门承载了关于SSD1306配置的一切。现在我们将OLED的配置系统建立起来了当我们的chip是SSD1306的时候只需要定义SSD1306的宏
#ifndef OLED_CONFIG_H
#define OLED_CONFIG_H
...
/* oled chips selections */
#ifdef SSD1306
#include configs/ssd1306.h
#elif SSD1309
#include configs/ssd1309.h
#else
#error Unknown chips, please select in compile time using define!
#endif
#endif
现在我们的configure就完整了我们只需要依赖config文件就能知道OLED自身的全部信息。如果你有IDE现在就可以看到当我们定义了SSD1306的时候我们的OLED_GRAM自动调整为OLED_GRAM[8][128]的数组另一放面如果我们使用了SSD1309我们自动会更新为OLED_GRAM[8][144],此事在ssd1309.h中亦有记载
清空屏幕
显然我们有一些人对C库并不太了解memset函数负责将一块内存设置为给定的值。一般而言编译器实现将会使用独有的硬件加速优化使用上绝对比手动设置值只快不慢。 软件工程的一大原则复用能不自己手搓就不自己手搓编译器提供了就优先使用编译器提供的 void oled_helper_clear_frame(OLED_Handle* handle)
{memset(OLED_GRAM, 0, sizeof(OLED_GRAM));
}
刷新屏幕与光标设置1
设置涂写光标就像我们使用Windows的绘图软件一样鼠标在哪里左键嗯下就从那里开始绘制我们的set_cursor函数就是干设置鼠标在哪里的工作。查询手册我们可以这样书写笔者是直接参考了江科大的实现
/*set operating cursor
*/
void __pvt_oled_set_cursor(OLED_Handle* handle, const uint8_t y,const uint8_t x)
{ // 笔者提示下面这一行是修正ssd1309的ssd1306并不需要 2// 也就是说SSD1306的OLED不需要下面这一行但是SSD1309需要这一点可以去我的github仓库上看的// 更加的明白 const uint8_t new_x x 2;OLED_Operations op_table;__on_fetch_oled_table(handle, op_table);op_table.command_sender(handle-private_handle, 0xB0 | y);op_table.command_sender(handle-private_handle,0x10 | ((new_x 0xF0) 4)); //设置X位置高4位op_table.command_sender(handle-private_handle,0x00 | (new_x 0x0F)); //设置X位置低4位
}
刷新屏幕与光标设置2
不对这个代码没有看懂其一原因是我没有给出__on_fetch_oled_table是什么。
static void __on_fetch_oled_table(const OLED_Handle* handle, OLED_Operations* blank_operations)
{switch (handle-stored_handle_type){case OLED_HARD_IIC_DRIVER_TYPE:{OLED_HARD_IIC_Private_Config* config (OLED_HARD_IIC_Private_Config*)(handle-private_handle);blank_operations-command_sender config-operation.command_sender;blank_operations-data_sender config-operation.data_sender;}break;case OLED_SOFT_IIC_DRIVER_TYPE:{OLED_SOFT_IIC_Private_Config* config (OLED_SOFT_IIC_Private_Config*)(handle-private_handle);blank_operations-command_sender config-operation.command_sender;blank_operations-data_sender config-operation.data_sender;}break;... // ommited spi seletctions}break;default:break;}
}
这是干什么呢答案是根据OLED的类型选择我们的操作句柄。这是因为C语言没法自动识别void*的原貌是如何的我们必须将C中的虚表选择手动的完成 题外话接触过C的朋友都知道继承这个操作实际上这里就是一种继承。无论是何种IIC操作都是IIC操作。他都必须遵守可以发送字节的接口操作现在的问题是他到底是哪样的IIC需要执行的是哪样IIC的操作呢所以__on_fetch_oled_table就是把正确的操作函数根据OLED的类型给筛选出来。也就是C中的虚表选择操作 /*set operating cursor
*/
void __pvt_oled_set_cursor(OLED_Handle* handle, const uint8_t y,const uint8_t x)
{ const uint8_t new_x x 2;OLED_Operations op_table;__on_fetch_oled_table(handle, op_table);op_table.command_sender(handle-private_handle, 0xB0 | y);op_table.command_sender(handle-private_handle,0x10 | ((new_x 0xF0) 4)); //设置X位置高4位op_table.command_sender(handle-private_handle,0x00 | (new_x 0x0F)); //设置X位置低4位
}
现在回到上面的代码我们将正确的操作句柄选择出来之后可以发送设置“鼠标”的指令了。 复习一下位操作的基本组成 是一种萃取操作任何数0就是01则是本身说明可以通过对应1保留对应位0抹除对应位 |是一种赋值操作任何数1就是1|0是本身所以|可以起到对应位置1的操作。 所以保留高4位只需要 0xF00b11110000保留低四位只需要0x0F就好了0b00001111 刷新屏幕与光标设置3
现在让我们看看刷新屏幕是怎么做的
void oled_helper_update(OLED_Handle* handle)
{OLED_Operations op_table;__on_fetch_oled_table(handle, op_table);for (uint8_t j 0; j OLED_HEIGHT; j ){/*设置光标位置为每一页的第一列*/__pvt_oled_set_cursor(handle, j, 0);/*连续写入128个数据将显存数组的数据写入到OLED硬件*/// 有趣的是,这里笔者埋下了一个伏笔,我为什么没写OLED_WIDTH呢?尽管在SSD1306这样做是正确的// 但那也是偶然,笔者在移植SSD1309的时候就发现了这样的不一致性,导致OLED死机.// 笔者提示: OLED长宽和可绘制区域的大小不一致性op_table.data_sender(handle-private_handle, OLED_GRAM[j], 128);}
}
刷新整个屏幕就是将鼠标设置到开头然后直接向后面写入128个数据结束我们的事情这比一个个写要快得多
绘制一个点
实际上就是将对应的数组的位置放上1就好了这需要牵扯到的是OLED独特的显示方式。
OLED自身分有页这个概念一个页8个像素由传递的比特控制。举个例子我想显示的是第一个像素亮起来就需要在一个字节的第一个比特置1余下置0这就是为什么OLED_HEIGHT的大小不是64而是8也就意味着setpixel函数不是简单的
OLED[height][width] val
而实需要进行一个复杂的计算。我们分析一下给定一个Y的值。它落在的页就是 Y / 8。比如说Y为5的时候落在第0页的第六个比特上Y为9的时候落在第一个页的第一个第二个比特上注意我们的Y从0开始计算我们设置的位置也就是OLED_GRAM[y / 8][x]设置的值就是Y给定的比特是0x01 (y % 8)
void oled_helper_setpixel(OLED_Handle* handle, uint16_t x, uint16_t y)
{// current unused(void)handle;if( 0 x x POINT_X_MAX 0 y y POINT_Y_MAX)OLED_GRAM[y / 8][x] | 0x01 (y % 8);
} (void)T是一种常见的放置maybe_unused的写法现代编译器支持[[maybe_unused]]的指示符表达的是这个参数可能不被用到编译器不需要为此警告我这在复用中很常见一些接口的参数可能不被使用这样的可读性会比传递空更加的好读为了遵循ISO C笔者没有采取保证任何编译器都可以正确的理解我们的意图。 反色
反色就很简单了。只需要异或即可首先当给定的比特是0的时候我们异或1得到的就是相异的比较所以结果是1即0变成了1。我们给定的比特是1的时候我们还是异或1得到了相同的结果所以结果是0即1变成了0这样不就实现了一个像素的反转吗
void oled_helper_reverse(OLED_Handle* handle)
{for(uint8_t i 0; i OLED_HEIGHT; i){for(uint8_t j 0; j OLED_WIDTH; j){OLED_GRAM[i][j] ^ 0xFF;}}
} 能使用memset吗为什么所以memset是在什么情况下能使用呢 我都这样问了那显然不能因为设置的值跟每一个字节的内存强相关memset的值必须跟内存的值没有关系。 区域化操作
我们还有区域化操作没有实现。基本的步骤是 思考需要的参数需要知道对 哪个OLEDOLED_Handle* handle, 起头在哪里uint16_t x, uint16_t y, 长宽如何uint16_t width, uint16_t height 对于置位则需要一个连续的数组进行置位它的大小就是描述了区域矩形的大小 我们先来看置位函数
区域置位
void oled_helper_draw_area(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height, uint8_t* sources)
{// 确保绘制区域的起点坐标在有效范围内如果超出最大显示坐标则直接返回if(x POINT_X_MAX) return;if(y POINT_Y_MAX) return;
// 在设置图像前先清空绘制区域oled_helper_clear_area(handle, x, y, width, height);
// 遍历绘制区域的高度以8像素为单位划分区域for(uint16_t j 0; j (height - 1) / 8 1; j){for(uint16_t i 0; i width; i){// 如果绘制超出屏幕宽度则跳出循环if(x i OLED_WIDTH) { break; }// 如果绘制超出屏幕高度则直接返回if(y / 8 j OLED_HEIGHT - 1) { return; }
// 将sources中的数据按位移方式写入OLED显存GRAM// 当前行显示低8位数据左移与显存当前内容进行按位或OLED_GRAM[y / 8 j][x i] | sources[j * width i] (y % 8);
// 如果绘制数据跨页8像素一页处理下一页的数据写入if(y / 8 j 1 OLED_HEIGHT - 1) { continue; }
// 将高8位数据右移后写入下一页显存OLED_GRAM[y / 8 j 1][x i] | sources[j * width i] (8 - y % 8);}}
}
我们正
常来讲传递的会是一个二维数组C语言对于二维数组的处理是连续的。也就是说。对于一个被声明为OLED[WIDTH][HEIGHT]的数组访问OLED[i][j]本质上等价于OLED i * WIDTH j这个事情如果还是不能理解可以查照专门的博客进行学习。笔者默认在这里看我写的东西已经不会被这样基础的知识所困扰了。所以我们的所作的就是将出于低页的内容拷贝到底页上 OLED_GRAM[y / 8 j][x i]这是显存二维数组的索引访问。 y / 8 j 计算出当前数据位于哪个页OLED通常按8个像素一页分块存储通过整除将 y 坐标映射到显存页。 x i 表示横向的列位置。 sources[j * width i]这是源图像数据数组的索引访问。 j * width i 计算当前像素在 sources 数据中的位置偏移。 (y % 8)将当前像素数据向左移动 (y % 8) 位以确保源数据对齐到目标位置。 y % 8 获取绘制的起点在当前页中的垂直偏移。 |按位或运算符将偏移后的数据合并到 OLED_GRAM 中现有内容。 如果 y 5那么 y % 8 5表示当前像素从第5位开始绘制。例如 如果 sources[j * width i] 的值是 0b11000000经过 5 位移后变为 0b00000110再与 OLED_GRAM 的原有数据合并从而只影响目标位置上的两个像素。 先试一下分析OLED_GRAM[y / 8 j 1][x i] | sources[j * width i] (8 - y % 8);笔者的分析如下 OLED_GRAM[y / 8 j 1][x i] 这是下一页显存中的对应位置。 y / 8 j 1 表示当前绘制位置的下一页。 x i 仍为当前列位置。 sources[j * width i] 源图像数据中当前像素的数据。 j * width i 计算出当前像素在源数据中的位置。 (8 - y % 8) 将数据右移 (8 - y % 8) 位将超出当前页的高位部分对齐到下一页。 8 - y % 8 计算需要移入下一页的位数。 | 按位或将偏移后的数据合并到下一页显存中以保留已有内容。 假设 y 5那么 8 - y % 8 3。如果 sources[j * width i] 为 0b10110000右移 3 位得到 0b00010110这部分数据写入下一页显存。 区域反色
void oled_helper_reversearea(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height)
{// 确认起点坐标是否超出有效范围if(x POINT_X_MAX) return;if(y POINT_Y_MAX) return;
// 确保绘制区域不会超出最大范围如果超出则调整宽度和高度if(x width POINT_X_MAX) width POINT_X_MAX - x;if(y height POINT_Y_MAX) height POINT_Y_MAX - y;
// 遍历高度范围中的每个像素行for(uint8_t i y; i y height; i){for(uint8_t j x; j x width; j){// 反转显存GRAM中的指定像素位按位异或OLED_GRAM[i / 8][j] ^ (0x01 (i % 8));}}
}
区域更新
void oled_helper_update_area(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height)
{// 检查起点坐标是否超出有效范围if(x POINT_X_MAX) return;if(y POINT_Y_MAX) return;
// 确认绘制区域不超出最大范围if(x width POINT_X_MAX) width POINT_X_MAX - x;if(y height POINT_Y_MAX) height POINT_Y_MAX - y;
// 定义OLED操作表变量OLED_Operations op_table;// 获取对应的操作函数表__on_fetch_oled_table(handle, op_table);
// 遍历绘制区域中的每个页8像素一页for(uint8_t i y / 8; i (y height - 1) / 8 1; i){// 设置光标到指定页及列的位置__pvt_oled_set_cursor(handle, i, x);// 从显存中读取指定页和列的数据通过data_sender发送到OLED硬件op_table.data_sender(handle, OLED_GRAM[i][x], width); }
}
也就是将光标对应到位置上刷新width个数据完事
区域清空
void oled_helper_clear_area(OLED_Handle* handle, uint16_t x, uint16_t y, uint16_t width, uint16_t height)
{// 检查起点坐标是否超出有效范围if(x POINT_X_MAX) return;if(y POINT_Y_MAX) return;
// 确保绘制区域不超出最大范围if(x width POINT_X_MAX) width POINT_X_MAX - x;if(y height POINT_Y_MAX) height POINT_Y_MAX - y;
// 遍历高度范围内的所有像素for(uint8_t i y; i y height; i){for(uint8_t j x; j x width; j){// 清除显存中的指定像素位按位与非操作OLED_GRAM[i / 8][j] ~(0x01 (i % 8));}}
} OLED_GRAM[i / 8][j] 访问显存缓冲区中指定位置的字节。 i / 8 确定当前像素所在的页因为 OLED 每页存储 8 个垂直像素。 j 为水平方向的列位置。 0x01 (i % 8) 生成一个掩码将 0x01 左移 (i % 8) 位。 i % 8 计算出在当前页中的垂直位偏移。 ~(0x01 (i % 8)) 对掩码取反生成一个用于清零的掩码。例如如果 i % 8 2则 0x01 2 为 0b00000100取反后得到 0b11111011。 按位与运算将显存当前位置对应的像素清零而其他位保持不变。 假设 i 10j 5 i / 8 1 表示访问第 2 页页索引为 1 i % 8 2 表示需要清除该页第 3 位的像素 0x01 2 0b00000100取反得到 0b11111011 OLED_GRAM[1][5] 0b11111011 会将第 3 位清零其余位保持不变。 测试我们的抽象
现在我们终于可以开始测试我们的抽象了。完成了既可以使用软件IIC又可以使用硬件IIC进行通信的OLED抽象我们当然迫不及待的想要测试一下我们的功能是否完善。笔者这里刹住车耐下性子听几句话。
首先测试不是一番风顺的我们按照我们的期望对着接口写出了功能代码基本上不会一番风顺的得到自己想要的结果往往需要我们进行调试找到其中的问题修正然后继续测试。
整理一下我们应该如何使用
首先回顾接口。我们需要指定一个协议按照我们期望的方式进行通信。在上一篇博客中我们做完了协议层次的抽象在这里我们只需要老老实实的注册接口就好了。 指引如果你忘记了我们上一篇博客在做什么的话请参考从0开始使用面对对象C语言搭建一个基于OLED的图形显示框架2-CSDN博客! 笔者建议新建一个Test文件夹书写一个文件叫:oled_test_hard_iic.c和oled_test_soft_iic.c测试我们的设备层和协议层是正确工作的。笔者这里以测试硬件IIC的代码为例子。
新建一个CubeMX工程只需要简单的配置一下IIC就好了笔者选择的是Fast Mode为了方便以后测试我们的组件刷新之后只需要
#include OLED/Driver/hard_iic/hard_iic.h
#include Test/OLED_TEST/oled_test.h
#include i2c.h
/* configs should be in persist way */
OLED_HARD_IIC_Private_Config config;
void user_init_hard_iic_oled_handle(OLED_Handle* handle)
{bind_hardiic_handle(config, hi2c1, 0x78, HAL_MAX_DELAY);oled_init_hardiic_handle(handle, config);
}
bind_hardiic_handle注册了使用硬件IIC通信的协议实体,我们将一个空白的config注册了配置好的iic的HAL库句柄提供了IIC地址和最大可接受的延迟时间
oled_init_hardiic_handle则是进一步的从协议层飞跃到设备层完成一个OLED设备的注册即我们注册了一个使用硬件IIC通信的OLED。现在我们就可以直接拿这个OLED进行绘点了。
void test_set_pixel_line(OLED_Handle* handle, uint8_t xoffset, uint8_t y_offset)
{for(uint8_t i 0; i 20; i)oled_helper_setpixel(handle,xoffset * i, y_offset * i);oled_helper_update(handle);
}
void test_oled_iic_functionalities()
{OLED_Handle handle;// 注册了一个使用硬件IIC通信的OLEDuser_init_hard_iic_oled_handle(handle);// 绘制一个test_set_pixel_line(handle, 1, 2);HAL_Delay(1000);test_clear(handle);test_set_pixel_line(handle, 2, 1);HAL_Delay(1000);test_clear(handle);
}
这个测试并不全面自己可以做修改。效果就是在导言当中的视频开始的两条直线所示。
笔者的OLED设备层的代码已经全部开源到MCU_Libs/OLED/library/OLED at main · Charliechen114514/MCU_Libs (github.com)感兴趣的朋友可以进一步研究。
目录导览
总览
协议层封装
OLED设备封装
绘图设备抽象
基础图形库封装
基础组件实现
动态菜单组件实现 文章转载自： http://www.morning.mqwdh.cn.gov.cn.mqwdh.cn http://www.morning.rmdsd.cn.gov.cn.rmdsd.cn http://www.morning.wqfrd.cn.gov.cn.wqfrd.cn http://www.morning.rxdsq.cn.gov.cn.rxdsq.cn http://www.morning.cjmmt.cn.gov.cn.cjmmt.cn http://www.morning.dskmq.cn.gov.cn.dskmq.cn http://www.morning.dbnpz.cn.gov.cn.dbnpz.cn http://www.morning.qxwgx.cn.gov.cn.qxwgx.cn http://www.morning.lfbsd.cn.gov.cn.lfbsd.cn http://www.morning.qpljg.cn.gov.cn.qpljg.cn http://www.morning.rqrh.cn.gov.cn.rqrh.cn http://www.morning.kjjbz.cn.gov.cn.kjjbz.cn http://www.morning.kcypc.cn.gov.cn.kcypc.cn http://www.morning.bpmdr.cn.gov.cn.bpmdr.cn http://www.morning.nfpct.cn.gov.cn.nfpct.cn http://www.morning.mpszk.cn.gov.cn.mpszk.cn http://www.morning.qlckc.cn.gov.cn.qlckc.cn http://www.morning.mhnd.cn.gov.cn.mhnd.cn http://www.morning.qinhuangdjy.cn.gov.cn.qinhuangdjy.cn http://www.morning.c7496.cn.gov.cn.c7496.cn http://www.morning.znlhc.cn.gov.cn.znlhc.cn http://www.morning.xcdph.cn.gov.cn.xcdph.cn http://www.morning.dnqlba.cn.gov.cn.dnqlba.cn http://www.morning.tnqk.cn.gov.cn.tnqk.cn http://www.morning.ktlxk.cn.gov.cn.ktlxk.cn http://www.morning.jxdhc.cn.gov.cn.jxdhc.cn http://www.morning.jqmmf.cn.gov.cn.jqmmf.cn http://www.morning.fksrg.cn.gov.cn.fksrg.cn http://www.morning.skcmt.cn.gov.cn.skcmt.cn http://www.morning.chjnb.cn.gov.cn.chjnb.cn http://www.morning.kgqpx.cn.gov.cn.kgqpx.cn http://www.morning.rwzmz.cn.gov.cn.rwzmz.cn http://www.morning.qmmfr.cn.gov.cn.qmmfr.cn http://www.morning.ygqhd.cn.gov.cn.ygqhd.cn http://www.morning.kzcfr.cn.gov.cn.kzcfr.cn http://www.morning.ktcfl.cn.gov.cn.ktcfl.cn http://www.morning.myfwb.cn.gov.cn.myfwb.cn http://www.morning.mhbcy.cn.gov.cn.mhbcy.cn http://www.morning.mprpx.cn.gov.cn.mprpx.cn http://www.morning.snyqb.cn.gov.cn.snyqb.cn http://www.morning.jzsgn.cn.gov.cn.jzsgn.cn http://www.morning.stcds.cn.gov.cn.stcds.cn http://www.morning.qcwrm.cn.gov.cn.qcwrm.cn http://www.morning.tnhqr.cn.gov.cn.tnhqr.cn http://www.morning.rcfwr.cn.gov.cn.rcfwr.cn http://www.morning.wcyr.cn.gov.cn.wcyr.cn http://www.morning.msgrq.cn.gov.cn.msgrq.cn http://www.morning.ymrq.cn.gov.cn.ymrq.cn http://www.morning.rgxf.cn.gov.cn.rgxf.cn http://www.morning.sflnx.cn.gov.cn.sflnx.cn http://www.morning.rknsp.cn.gov.cn.rknsp.cn http://www.morning.llsrg.cn.gov.cn.llsrg.cn http://www.morning.jopebe.cn.gov.cn.jopebe.cn http://www.morning.mggwr.cn.gov.cn.mggwr.cn http://www.morning.dmthy.cn.gov.cn.dmthy.cn http://www.morning.hnmbq.cn.gov.cn.hnmbq.cn http://www.morning.qhfdl.cn.gov.cn.qhfdl.cn http://www.morning.ptzf.cn.gov.cn.ptzf.cn http://www.morning.qmmfr.cn.gov.cn.qmmfr.cn http://www.morning.knlyl.cn.gov.cn.knlyl.cn http://www.morning.ptlwt.cn.gov.cn.ptlwt.cn http://www.morning.zxhpx.cn.gov.cn.zxhpx.cn http://www.morning.ctqlq.cn.gov.cn.ctqlq.cn http://www.morning.dwyyf.cn.gov.cn.dwyyf.cn http://www.morning.kpwcx.cn.gov.cn.kpwcx.cn http://www.morning.dzgmj.cn.gov.cn.dzgmj.cn http://www.morning.ldqrd.cn.gov.cn.ldqrd.cn http://www.morning.mytmx.cn.gov.cn.mytmx.cn http://www.morning.wmrgp.cn.gov.cn.wmrgp.cn http://www.morning.dmwjl.cn.gov.cn.dmwjl.cn http://www.morning.nlysd.cn.gov.cn.nlysd.cn http://www.morning.mfmrg.cn.gov.cn.mfmrg.cn http://www.morning.jxwhr.cn.gov.cn.jxwhr.cn http://www.morning.skdhm.cn.gov.cn.skdhm.cn http://www.morning.fldsb.cn.gov.cn.fldsb.cn http://www.morning.cwgt.cn.gov.cn.cwgt.cn http://www.morning.xmnlc.cn.gov.cn.xmnlc.cn http://www.morning.rwcw.cn.gov.cn.rwcw.cn http://www.morning.tpyrn.cn.gov.cn.tpyrn.cn http://www.morning.bnbtp.cn.gov.cn.bnbtp.cn
