# 基于STM32F1的0.96寸OLED显示屏驱动程序，支持硬件/软件I2C **URL:** \ **Category:** 开源项目 / Open-Source Project\ **Tags:** IIC, STM32, OLED, Open-Source\ **Created:** [2025 年10 月 30 日 14:52 UTC](https://bbs.eeclub.top/t/topic/107 "2025-10-30T14:52:05Z")\ **Posts on this page:** 1\ **Page:** 1

作者： ![zeruns](https://bbs.eeclub.top/user_avatar/bbs.eeclub.top/zeruns/32/7_2.png) [@zeruns](https://bbs.eeclub.top/u/zeruns)\ 发布日期： [2025 年10 月 30 日 14:52 UTC](https://bbs.eeclub.top/t/topic/107/1 "2025-10-30T14:52:05Z")

**基于[STM32](https://blog.zeruns.com/tag/stm32/)F103的0.96寸OLED显示屏驱动程序（4针脚[I2C](https://blog.zeruns.com/tag/I2C/)接口），支持硬件IIC/软件IIC。** **这款驱动程序比较完善，可以实现英文、整数、浮点数、汉字、图像、二进制数、十六进制数等内容显示，可以画点、直线、矩形、圆、椭圆、三角形等，支持多种字体，差不多相当于一个简易版[图形库](https://blog.zeruns.com/tag/%E5%9B%BE%E5%BD%A2%E5%BA%93/)了。** 该程序是基于江协科技的代码二次修改的，原版程序只支持软件I2C，我修改后支持硬件I2C，也可以修改宏定义改成使用软件I2C。程序是使用ST标准库写的。测试硬件为STM32F103C8T6和[AIR32](https://blog.zeruns.com/tag/AIR32/)F103CBT6，在这两款单片机上都测试过能跑，其中使用硬件I2C时STM32通信速率最高可以跑到1.3Mbit/s，AIR32最高只能跑600kbit/s。关于OLED的驱动原理，以及驱动程序的使用教程可以看江协科技的视频：[https://url.zeruns.com/L7j6y](https://www.bilibili.com/video/BV1EN41177Pc) STM32使用硬件I2C读取SHTC3温湿度传感器：[https://blog.zeruns.com/archives/692.html](https://blog.zeruns.com/archives/692.html) 移植好U8g2图形库的STM32F407标准库工程模板：[https://blog.zeruns.com/archives/722.html](https://blog.zeruns.com/archives/722.html) 电子/单片机技术交流群：[2169025065](https://qm.qq.com/q/ZmTfBbFM4Y) ## 效果图 ![](https://s3.eeclub.top/original/1X/5588ee85f761b540322e2c10fc0343b972138a95.gif) ![](https://s3.eeclub.top/original/1X/b213e682337975ff4352cda17d6e000ba11dcc93.jpeg) ![](https://s3.eeclub.top/original/1X/bbdb406c763fdc49ee625370fa2b166004eeb12f.jpeg) ## I2C协议简介 I2C 通讯协议(Inter－Integrated Circuit)是由 Phiilps 公司开发的，由于它引脚少，硬件实现简单，可扩展性强，不需要 USART、CAN 等通讯协议的外部收发设备（那些电平转化芯片），现在被广泛地使用在系统内多个集成电路(IC)间的通讯。 I2C只有一跟数据总线 SDA(Serial Data Line)，串行数据总线，只能一位一位的发送数据，属于串行通信，采用半双工通信。半双工通信：可以实现双向的通信，但不能在两个方向上同时进行，必须轮流交替进行，其实也可以理解成一种可以切换方向的单工通信，同一时刻必须只能一个方向传输，只需一根数据线。对于I2C通讯协议把它分为物理层和协议层物理层规定通讯系统中具有机械、电子功能部分的特性（硬件部分），确保原始数据在物理媒体的传输。协议层主要规定通讯逻辑，统一收发双方的数据打包、解包标准（软件层面）。 ## I2C物理层 **I2C 通讯设备之间的常用连接方式** ![](https://s3.eeclub.top/original/1X/77fe02e0e0021026a253cbb54aed717d2d80730a.png) (1) 它是一个支持多设备的总线。“总线”指多个设备共用的信号线。在一个 I2C 通讯总线中，可连接多个 I2C 通讯设备，支持多个通讯主机及多个通讯从机。 (2) 一个 I2C 总线只使用两条总线线路，一条双向串行数据线SDA（Serial Data Line ），一条串行时钟线SCL（Serial Clock Line ）。数据线即用来表示数据，时钟线用于数据收发同步 (3) 总线通过上拉电阻接到电源。 **当 I2C 设备空闲时会输出高阻态** ，而当所有设备都空闲，都输出高阻态时， **由上拉电阻把总线拉成高电平** 。 I2C通信时单片机GPIO口必须设置为开漏输出，否则可能会造成短路。关于更多STM32的I2C相关信息和使用方法可以看这篇文章：[https://url.zeruns.com/JC0Ah](https://url.zeruns.com/JC0Ah) 还有江协科技的STM32入门教程：[https://www.bilibili.com/video/BV1th411z7sn?p=31](https://url.zeruns.com/1zvY1) 我这里就不详细讲解了。 ## 需要用的元件 - STM32开发板入门套件：[https://u.jd.com/fQS0YAe](https://union-click.jd.com/jdc?e=618%7Cpc%7C&p=JF8BARAJK1olXwQFXFpVCkofBV8IGlocXA8KVV9eD00RAV9MRANLAjZbERscSkAJHTdNTwcKBlMdBgABFksWAmYJElMUXAUFUlhfFxJSXzI4Wz5BI19ZKz44aRtJVG11QlpGC3pENFJROEonA24JGloSWgAAXG5tCEwnQgEIGVkRWgYDXG5cOEsRAmYBHVwdXAQEVFttD0seM20IGFgQWgQLUUJUDEoUAGY4K2sWbQECXUpbegpFF2l6K2sVbQUyVF9dAEgSBmYKE14JXQYDV1lVFEsRAmYBHVwcWw4BXFZtCkoWB2Y4K2tOGm0GLCA7dk1xZy19eQZFJ0JhEh8_bBl5AWsLHz9CB05XUiBaSiphUTl6Kw) - STM32F103最小系统板：[https://s.click.taobao.com/TsFFvwt](https://s.click.taobao.com/t?e=m%3D2%26s%3Dcm75%2B7kIZhRw4vFB6t2Z2ueEDrYVVa64g3vZOarmkFi53hKxp7mNFhiPRfK6WZZb%2B8iL1yU5PSb0JlhLk0Jl4QTquP0kWxBLBDnvz6xo38xspWc9%2BCL4bTGF1ceZMhPo8mL8HhJ3EdVrH4ks4QyiY4z4rjZDGVMAhscfsB2%2FyzZJq71CBMBeP%2F1SarTXhIOTsgIpc1WFZiJNubylQlnZt1WwZa%2ByxDeBHWEvUDT1PmgEGxUy6oiwijYvxlRG3H0BW%2BXVkiV2vuKe6taMCBua%2BKM70AliNjwJcn7ARWQ6ocV0hb0k2TPv%2BG5KHOQOD12OTSR%2Be%2BJ7m1dALXBP%2BJGkZ8Yl7w3%2FA2kb&union_lens=lensId%3APUB%401708876977%40213fc5dc_0d80_18de10155c1_99a6%40027J3ScRMTFVVHBR48I6V2yn%40eyJmbG9vcklkIjo4MDY3NCwiic3BtQiiI6Il9wb3J0YWxfdjJfcGFnZXNfcHJvbW9fZ29vZHNfaW5kZXhfaHRtIiiwiic3JjRmxvb3JJZCI6IjgwNjc0In0ie%3Bscm%3A1007.30148.329090.pub_search-item_decf073c-5ed2-4029-9e1c-fc539dee6b40_) - OLED模块：[https://s.click.taobao.com/EF0Evwt](https://s.click.taobao.com/t?e=m%3D2%26s%3DBQQVS9oR8Wlw4vFB6t2Z2ueEDrYVVa64YUrQeSeIhnK53hKxp7mNFhiPRfK6WZZb%2BC8Fbl5oDyj0JlhLk0Jl4QTquP0kWxBLBDnvz6xo38xspWc9%2BCL4bTGF1ceZMhPo8mL8HhJ3EdVrH4ks4QyiY4z4rjZDGVMA8m%2BLYM2fkTL05J9EjZ4Cg6Q6sZp7gNLmb4%2BNtrBbTSxS1m9mhvByKBrMnaCVX7KBW7PNt0F7tu%2Bj2MnLlaGxOywInitlNLjeJEXD0Db1Cgm0zvIVVx%2BPc2%2F51BzEHetfxglKFrfPmkzgk553RHFrozHRcMhx5lEYXaWKN4mTpfzGDF1NzTQoPw%3D%3D&union_lens=lensId%3APUB%401708877132%402132b6c1_0d4d_18de103b431_7176%40023tYsbj43IzfeR7s373UeL0%40eyJmbG9vcklkIjo4MDY3NCwiic3BtQiiI6Il9wb3J0YWxfdjJfcGFnZXNfcHJvbW9fZ29vZHNfaW5kZXhfaHRtIiiwiic3JjRmxvb3JJZCI6IjgwNjc0In0ie%3Bscm%3A1007.30148.329090.pub_search-item_cfd89e5a-6719-4e0b-9631-719f1e445d1b_) - 杜邦线：[https://s.click.taobao.com/VMkDvwt](https://s.click.taobao.com/t?e=m%3D2%26s%3DNAQNF5W5JbZw4vFB6t2Z2ueEDrYVVa64g3vZOarmkFi53hKxp7mNFhiPRfK6WZZbOdGYsaoillH0JlhLk0Jl4QTquP0kWxBLBDnvz6xo38xspWc9%2BCL4bTGF1ceZMhPo8mL8HhJ3EdVrH4ks4QyiY4z4rjZDGVMAhscfsB2%2FyzZJq71CBMBeP%2F1SarTXhIOTsgIpc1WFZiJNubylQlnZt9XuJrvisfUaLg8yhgHrwuW0bEeio6m796ZlQTRAZFsjdATSYpxt2P0VoXLgisw42qM70AliNjwJcn7ARWQ6ocV0hb0k2TPv%2BG5KHOQOD12OUoYNCSEtOZtWO1Zo39Y1p8Yl7w3%2FA2kb&union_lens=lensId%3APUB%401708877204%402104c34a_0d04_18de104cdd7_2053%40023jT5YfQJHA0mMOCZCKibC7%40eyJmbG9vcklkIjo4MDY3NCwiic3BtQiiI6Il9wb3J0YWxfdjJfcGFnZXNfcHJvbW9fZ29vZHNfaW5kZXhfaHRtIiiwiic3JjRmxvb3JJZCI6IjgwNjc0In0ie%3Bscm%3A1007.30148.329090.pub_search-item_9377ad37-ef13-44ca-8eea-bb37827b0d66_) - 面包板：[https://s.click.taobao.com/bhg8Txt](https://s.click.taobao.com/t?e=m%3D2%26s%3DGUrId01gcUhw4vFB6t2Z2ueEDrYVVa64g3vZOarmkFi53hKxp7mNFhiPRfK6WZZbGlx1ZdvmWmb0JlhLk0Jl4QTquP0kWxBLBDnvz6xo38xspWc9%2BCL4bTGF1ceZMhPo8mL8HhJ3EdVrH4ks4QyiY4z4rjZDGVMA%2FXC6lFkCpYM56ZoUzm0cdkhUSIdDrY3ktWAKfhx9%2FCLZz2VyWhvCA7kq3xPS4D6oQhyywG7R2aIIas13MCLHCTVP5mUBCPs0MuvUHnPLiLAjTjU2N3HfFqM70AliNjwJcn7ARWQ6ocV0hb0k2TPv%2BG5KHOQOD12Onw4oeBHKRI6DInB1KCeXWcYl7w3%2FA2kb&union_lens=lensId%3APUB%401708877311%4021049f66_0d0d_18de1066ebf_e6c4%4002pOznnaNIB3wQbFtUC5sTM%40eyJmbG9vcklkIjo4MDY3NCwiic3BtQiiI6Il9wb3J0YWxfdjJfcGFnZXNfcHJvbW9fZ29vZHNfaW5kZXhfaHRtIiiwiic3JjRmxvb3JJZCI6IjgwNjc0In0ie%3Bscm%3A1007.30148.329090.pub_search-item_99474595-28e3-4d3b-8fa6-da3aa5a181ff_) - DAPLink（可代替ST-Link，带虚拟串口）：[https://s.click.taobao.com/QVQ8Txt](https://s.click.taobao.com/t?e=m%3D2%26s%3DBRVDjoJNnqRw4vFB6t2Z2ueEDrYVVa64YUrQeSeIhnK53hKxp7mNFhiPRfK6WZZb9FlOLwLkNcT0JlhLk0Jl4QTquP0kWxBLBDnvz6xo38xspWc9%2BCL4bTGF1ceZMhPo8mL8HhJ3EdVrH4ks4QyiY4z4rjZDGVMAFBcM8wkWlGmBPeR%2FUFCetKLWMw3EOEsyJN2owMjhufwDudUsQ2T%2BdgqUOiHk7KHwCwr%2FNmk5d2u0vpJh576mRP8Cws%2FCg%2Fq0X%2FWmX2FNRIIYFRtWIu5mcU%2FuprW1TdmBLeMqtJBmsqDjUTeuQ%2BdMdzrtJLjN8V3%2FcSpj5qSCmbA%3D&union_lens=lensId%3APUB%401708877363%40210878e1_0d79_18de10737c0_d525%400238Bsi4blTj5vTJ7imyRHwg%40eyJmbG9vcklkIjo4MDY3NCwiic3BtQiiI6Il9wb3J0YWxfdjJfcGFnZXNfcHJvbW9fZ29vZHNfaW5kZXhfaHRtIiiwiic3JjRmxvb3JJZCI6IjgwNjc0In0ie%3Bscm%3A1007.30148.329090.pub_search-item_70c3e4a4-c44d-44a0-99c5-7136c519295e_) **江协科技的STM32入门套件：[https://s.click.taobao.com/NTn9Txt](https://s.click.taobao.com/t?e=m%3D2%26s%3DFFF3WUPg2cpw4vFB6t2Z2ueEDrYVVa64g3vZOarmkFi53hKxp7mNFhiPRfK6WZZbuxz4Yx4FsL70JlhLk0Jl4QTquP0kWxBLBDnvz6xo38xspWc9%2BCL4bTGF1ceZMhPo8mL8HhJ3EdVrH4ks4QyiY4z4rjZDGVMAKhtnqJaQX2MflpVAuAy2VaLWMw3EOEsyJN2owMjhufwDudUsQ2T%2BdmTsy6cLY11yYexwAYiaHs2oS4Ml8iY1%2FxbzASfWQb%2B%2BKVVqWC8XTCluQ0m97%2BtRF0%2FuprW1TdmBLeMqtJBmsqAWDmQQxG5ZNlu9MBEPTelNcSpj5qSCmbA%3D&union_lens=lensId%3APUB%401708877026%40212c03c4_0d06_18de1021304_c90d%40024r1i4wvnsmoOt3Tx4i0nrb%40eyJmbG9vcklkIjo4MDY3NCwiic3BtQiiI6Il9wb3J0YWxfdjJfcGFnZXNfcHJvbW9fZ29vZHNfaW5kZXhfaHRtIiiwiic3JjRmxvb3JJZCI6IjgwNjc0In0ie%3Bscm%3A1007.30148.329090.pub_search-item_381225b4-c5f9-4e6b-ba67-2f9d1293b8c3_)** ## 程序 **完整工程下载地址：** 百度网盘：[https://url.zeruns.com/kSxoe](https://url.zeruns.com/kSxoe) 提取码: wgc3 123网盘(不限速)：[https://www.123pan.com/s/2Y9Djv-HGcvH.html](https://www.123pan.com/s/2Y9Djv-HGcvH.html) 提取码:m7sp 工程使用Keil5创建，用Vscode+EIDE开发，两个软件都可以打开此工程。工程文件全部使用UTF-8编码，如果打开显示乱码需要修改编辑器编码为UTF-8。 **main.c文件：** ```c #include "stm32f10x.h" // Device header #include "Delay.h" #include "OLED.h" /** * @brief 翻转指定GPIO端口的电平状态。 * * @param GPIOx 指向GPIO端口的指针，例如GPIOA, GPIOB等。 * @param GPIO_Pin 要翻转的GPIO引脚，可以是单个引脚如GPIO_Pin_0，也可以是多个引脚的组合如GPIO_Pin_0 | GPIO_Pin_1。 * * 这个函数首先读取指定GPIO端口的指定引脚的输出电平状态。如果引脚当前为低电平（Bit_RESET），则函数将其设置为高电平（Bit_SET）。 * 反之，如果引脚当前为高电平，则函数将其设置为低电平。这样实现了电平的翻转。 */ void GPIO_TogglePin(GPIO_TypeDef* GPIOx, uint16_t GPIO_Pin) { // 读取GPIO电平状态 if (GPIO_ReadOutputDataBit(GPIOx, GPIO_Pin) == Bit_RESET) { // 如果当前电平为低，则设置为高电平 GPIO_SetBits(GPIOx, GPIO_Pin); } else { // 如果当前电平为高，则设置为低电平 GPIO_ResetBits(GPIOx, GPIO_Pin); } } int main(void) { RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE);//使能GPIOC时钟 // 初始化GPIO引脚 GPIO_InitTypeDef GPIO_InitStructure; // 定义结构体配置GPIO GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP; // 设置GPIO模式为复用开漏模式，需接上拉电阻 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 设置GPIO速度为50MHz GPIO_InitStructure.GPIO_Pin = GPIO_Pin_13; // 设置引脚为OLED_SCL和OLED_SDA GPIO_Init(GPIOC, &GPIO_InitStructure); // 初始化GPIO GPIO_TogglePin(GPIOC, GPIO_Pin_13); // LED闪烁 /*OLED初始化*/ OLED_Init(); /*在(0, 0)位置显示字符'A'，字体大小为8*16点阵*/ //OLED_ShowChar(0, 0, 'A', OLED_8X16); /*在(16, 0)位置显示字符串"Hello World!"，字体大小为8*16点阵*/ OLED_ShowString(0, 0, "blog.zeruns.com", OLED_8X16); /*在(0, 18)位置显示字符'A'，字体大小为6*8点阵*/ OLED_ShowChar(0, 18, 'A', OLED_6X8); /*在(16, 18)位置显示字符串"Hello World!"，字体大小为6*8点阵*/ OLED_ShowString(16, 18, "Hello World!", OLED_6X8); /*在(0, 28)位置显示数字12345，长度为5，字体大小为6*8点阵*/ OLED_ShowNum(0, 28, 12345, 5, OLED_6X8); /*在(40, 28)位置显示有符号数字-66，长度为2，字体大小为6*8点阵*/ OLED_ShowSignedNum(40, 28, -66, 2, OLED_6X8); /*在(70, 28)位置显示十六进制数字0xA5A5，长度为4，字体大小为6*8点阵*/ OLED_ShowHexNum(70, 28, 0xA5A5, 4, OLED_6X8); /*在(0, 38)位置显示二进制数字0xA5，长度为8，字体大小为6*8点阵*/ OLED_ShowBinNum(0, 38, 0xA5, 8, OLED_6X8); /*在(60, 38)位置显示浮点数字123.45，整数部分长度为3，小数部分长度为2，字体大小为6*8点阵*/ OLED_ShowFloatNum(60, 38, 123.45, 3, 2, OLED_6X8); /*在(0, 48)位置显示汉字串"你好，世界。"，字体大小为固定的16*16点阵*/ OLED_ShowChinese(0, 48, "你好，世界。"); /*在(96, 48)位置显示图像，宽16像素，高16像素，图像数据为Diode数组*/ OLED_ShowImage(96, 48, 16, 16, Diode); /*在(96, 18)位置打印格式化字符串，字体大小为6*8点阵，格式化字符串为"[%02d]"*/ OLED_Printf(96, 18, OLED_6X8, "[%02d]", 6); /*调用OLED_Update函数，将OLED显存数组的内容更新到OLED硬件进行显示*/ OLED_Update(); /*延时3000ms，观察现象*/ Delay_ms(3000); GPIO_TogglePin(GPIOC, GPIO_Pin_13); // LED闪烁 /*清空OLED显存数组*/ OLED_Clear(); /*在(5, 8)位置画点*/ OLED_DrawPoint(5, 8); /*获取(5, 8)位置的点*/ if (OLED_GetPoint(5, 8)) { /*如果指定点点亮，则在(10, 4)位置显示字符串"YES"，字体大小为6*8点阵*/ OLED_ShowString(10, 4, "YES", OLED_6X8); } else { /*如果指定点未点亮，则在(10, 4)位置显示字符串"NO "，字体大小为6*8点阵*/ OLED_ShowString(10, 4, "NO ", OLED_6X8); } /*在(40, 0)和(127, 15)位置之间画直线*/ OLED_DrawLine(40, 0, 127, 15); /*在(40, 15)和(127, 0)位置之间画直线*/ OLED_DrawLine(40, 15, 127, 0); /*在(0, 20)位置画矩形，宽12像素，高15像素，未填充*/ OLED_DrawRectangle(0, 20, 12, 15, OLED_UNFILLED); /*在(0, 40)位置画矩形，宽12像素，高15像素，填充*/ OLED_DrawRectangle(0, 40, 12, 15, OLED_FILLED); /*在(20, 20)、(40, 25)和(30, 35)位置之间画三角形，未填充*/ OLED_DrawTriangle(20, 20, 40, 25, 30, 35, OLED_UNFILLED); /*在(20, 40)、(40, 45)和(30, 55)位置之间画三角形，填充*/ OLED_DrawTriangle(20, 40, 40, 45, 30, 55, OLED_FILLED); /*在(55, 27)位置画圆，半径8像素，未填充*/ OLED_DrawCircle(55, 27, 8, OLED_UNFILLED); /*在(55, 47)位置画圆，半径8像素，填充*/ OLED_DrawCircle(55, 47, 8, OLED_FILLED); /*在(82, 27)位置画椭圆，横向半轴12像素，纵向半轴8像素，未填充*/ OLED_DrawEllipse(82, 27, 12, 8, OLED_UNFILLED); // https://blog.zeruns.com /*在(82, 47)位置画椭圆，横向半轴12像素，纵向半轴8像素，填充*/ OLED_DrawEllipse(82, 47, 12, 8, OLED_FILLED); /*在(110, 18)位置画圆弧，半径15像素，起始角度25度，终止角度125度，未填充*/ OLED_DrawArc(110, 18, 15, 25, 125, OLED_UNFILLED); /*在(110, 38)位置画圆弧，半径15像素，起始角度25度，终止角度125度，填充*/ OLED_DrawArc(110, 38, 15, 25, 125, OLED_FILLED); /*调用OLED_Update函数，将OLED显存数组的内容更新到OLED硬件进行显示*/ OLED_Update(); /*延时1500ms，观察现象*/ Delay_ms(1500); GPIO_TogglePin(GPIOC, GPIO_Pin_13); // LED闪烁 while (1) { for (uint8_t i = 0; i < 4; i ++) { /*将OLED显存数组部分数据取反，从(0, i * 16)位置开始，宽128像素，高16像素*/ OLED_ReverseArea(0, i * 16, 128, 16); /*调用OLED_Update函数，将OLED显存数组的内容更新到OLED硬件进行显示*/ OLED_Update(); /*延时1000ms，观察现象*/ Delay_ms(1000); /*把取反的内容翻转回来*/ OLED_ReverseArea(0, i * 16, 128, 16); GPIO_TogglePin(GPIOC, GPIO_Pin_13); // LED闪烁 } // https://blog.zeruns.com /*将OLED显存数组全部数据取反*/ OLED_Reverse(); /*调用OLED_Update函数，将OLED显存数组的内容更新到OLED硬件进行显示*/ OLED_Update(); /*延时1000ms，观察现象*/ Delay_ms(1000); GPIO_TogglePin(GPIOC, GPIO_Pin_13); // LED闪烁 } } ``` **OLED.c文件：** ```c / *************************************************************************************** * 本程序由江协科技创建并免费开源共享 * 你可以任意查看、使用和修改，并应用到自己的项目之中 * 程序版权归江协科技所有，任何人或组织不得将其据为己有 * * 程序名称： 0.96寸OLED显示屏驱动程序（4针脚I2C接口） * 程序创建时间： 2023.10.24 * 当前程序版本： V1.1 * 当前版本发布时间： 2023.12.8 * * 江协科技官方网站： jiangxiekeji.com * 江协科技官方淘宝店： jiangxiekeji.taobao.com * 程序介绍及更新动态： jiangxiekeji.com/tutorial/oled.html * * 如果你发现程序中的漏洞或者笔误，可通过邮件向我们反馈：feedback@jiangxiekeji.com * 发送邮件之前，你可以先到更新动态页面查看最新程序，如果此问题已经修改，则无需再发邮件 *************************************************************************************** */ /* * 本程序由zeruns二次修改 * 修改内容：增加支持硬件I2C，可通过修改宏定义来选择是否启用硬件I2C * 修改日期： 2024.2.25 * 博客： https://blog.zeruns.com * B站主页： https://space.bilibili.com/8320520 */ #include "stm32f10x.h" #include "OLED.h" #include #include #include #include // 如果用到中文，编译器附加选项需要加 --no-multibyte-chars /* 选择OLED驱动方式，默认使用硬件I2C。如果要用软件I2C就将硬件I2C那行的宏定义注释掉，将软件I2C那行的注释取消。不能同时两个都同时取消注释！ */ #define OLED_USE_HW_I2C // 硬件I2C //#define OLED_USE_SW_I2C // 软件I2C /*引脚定义，可在此处修改I2C通信引脚*/ #define OLED_SCL GPIO_Pin_6 // SCL #define OLED_SDA GPIO_Pin_7 // SDA #define OLED_GPIO GPIOB #define OLED_RCC RCC_APB2Periph_GPIOB /*STM32F103芯片的硬件I2C1: PB6 -- SCL; PB7 -- SDA */ /*I2C接口，定义OLED屏使用哪个I2C接口*/ #define OLED_I2C I2C1 #define OLED_I2C_RCC RCC_APB1Periph_I2C1 /*OLED从机地址*/ #define OLED_ADDRESS 0x3C << 1 // 0x3C是OLED的7位地址，左移1位最后位做读写位变成0x78 /*I2C超时时间*/ #define OLED_I2C_TIMEOUT 1000 /** * 数据存储格式： * 纵向8点，高位在下，先从左到右，再从上到下 * 每一个Bit对应一个像素点 * * B0 B0 B0 B0 * B1 B1 B1 B1 * B2 B2 B2 B2 * B3 B3 -------------> B3 B3 -- * B4 B4 B4 B4 | * B5 B5 B5 B5 | * B6 B6 B6 B6 | * B7 B7 B7 B7 | * | * ----------------------------------- * | * | B0 B0 B0 B0 * | B1 B1 B1 B1 * | B2 B2 B2 B2 * --> B3 B3 -------------> B3 B3 * B4 B4 B4 B4 * B5 B5 B5 B5 * B6 B6 B6 B6 * B7 B7 B7 B7 * * 坐标轴定义： * 左上角为(0, 0)点 * 横向向右为X轴，取值范围：0~127 * 纵向向下为Y轴，取值范围：0~63 * * 0 X轴 127 * .-------------------------------> * 0 | * | * | * | * Y轴 | * | * | * | * 63 | * v * */ /*全局变量 ********************* / /** * OLED显存数组 * 所有的显示函数，都只是对此显存数组进行读写 * 随后调用OLED_Update函数或OLED_UpdateArea函数 * 才会将显存数组的数据发送到OLED硬件，进行显示 */ uint8_t OLED_DisplayBuf[8][128]; / ********************* 全局变量*/ #ifdef OLED_USE_SW_I2C /** * 函数：OLED写SCL高低电平 * 参数：要写入SCL的电平值，范围：0/1 * 返回值：无 * 说明：当上层函数需要写SCL时，此函数会被调用 * 用户需要根据参数传入的值，将SCL置为高电平或者低电平 * 当参数传入0时，置SCL为低电平，当参数传入1时，置SCL为高电平 */ void OLED_W_SCL(uint8_t BitValue) { /*根据BitValue的值，将SCL置高电平或者低电平*/ GPIO_WriteBit(OLED_GPIO, OLED_SCL, (BitAction)BitValue); /*如果单片机速度过快，可在此添加适量延时，以避免超出I2C通信的最大速度*/ //... } /** * 函数：OLED写SDA高低电平 * 参数：要写入SDA的电平值，范围：0/1 * 返回值：无 * 说明：当上层函数需要写SDA时，此函数会被调用 * 用户需要根据参数传入的值，将SDA置为高电平或者低电平 * 当参数传入0时，置SDA为低电平，当参数传入1时，置SDA为高电平 */ void OLED_W_SDA(uint8_t BitValue) { /*根据BitValue的值，将SDA置高电平或者低电平*/ GPIO_WriteBit(OLED_GPIO, OLED_SDA, (BitAction)BitValue); /*如果单片机速度过快，可在此添加适量延时，以避免超出I2C通信的最大速度*/ //... } #endif /** * 函数：OLED引脚初始化 * 参数：无 * 返回值：无 * 说明：当上层函数需要初始化时，此函数会被调用 * 用户需要将SCL和SDA引脚初始化为开漏模式，并释放引脚 */ void OLED_GPIO_Init(void) { uint32_t i, j; /*在初始化前，加入适量延时，待OLED供电稳定*/ for (i = 0; i < 1000; i++) { for (j = 0; j < 1000; j++) ; } #ifdef OLED_USE_HW_I2C RCC_APB1PeriphClockCmd(OLED_I2C_RCC, ENABLE); // 使能I2C1时钟 #endif RCC_APB2PeriphClockCmd(OLED_RCC, ENABLE); // 使能GPIO时钟 GPIO_InitTypeDef GPIO_InitStructure; // 定义结构体配置GPIO #ifdef OLED_USE_HW_I2C GPIO_InitStructure.GPIO_Mode = GPIO_Mode_AF_OD; // 设置GPIO模式为复用开漏模式，需接上拉电阻 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; // 设置GPIO速度为50MHz GPIO_InitStructure.GPIO_Pin = OLED_SCL | OLED_SDA; // 设置引脚为OLED_SCL和OLED_SDA GPIO_Init(OLED_GPIO, &GPIO_InitStructure); // 初始化GPIO #elif defined(OLED_USE_SW_I2C) GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_OD; // 设置GPIO模式为开漏输出模式，需接上拉电阻 GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Pin = OLED_SCL | OLED_SDA;// 设置引脚为OLED_SCL和OLED_SDA GPIO_Init(OLED_GPIO, &GPIO_InitStructure); /*释放SCL和SDA*/ OLED_W_SCL(1); OLED_W_SDA(1); #endif #ifdef OLED_USE_HW_I2C I2C_DeInit(OLED_I2C); // 将外设I2C寄存器重设为缺省值 I2C_InitTypeDef I2C_InitStructure; // 定义结构体配置I2C I2C_InitStructure.I2C_Mode = I2C_Mode_I2C; // 工作模式 I2C_InitStructure.I2C_DutyCycle = I2C_DutyCycle_2; // 时钟占空比，Tlow/Thigh = 2 I2C_InitStructure.I2C_OwnAddress1 = 0x30; // 主机的I2C地址,用不到则随便写，无影响 I2C_InitStructure.I2C_Ack = I2C_Ack_Enable; // 使能应答位 I2C_InitStructure.I2C_AcknowledgedAddress = I2C_AcknowledgedAddress_7bit; // 设置地址长度7位 I2C_InitStructure.I2C_ClockSpeed = 600000;// 设置I2C时钟频率，600kHz，建议设置400kHz(比较稳定)，实测在STM32F103上最高可以跑1.3MHz，在AIR32F103上最高只能跑600kHz。 I2C_Init(OLED_I2C, &I2C_InitStructure); // 初始化I2C I2C_Cmd(OLED_I2C, ENABLE); // 使能I2C #endif } // https://blog.zeruns.com /*通信协议 ********************* / /** * 函数：I2C起始 * 参数：无 * 返回值：无 */ void OLED_I2C_Start(void) { #ifdef OLED_USE_HW_I2C for(uint16_t i = 0; I2C_GetFlagStatus(OLED_I2C, I2C_FLAG_BUSY) && i < OLED_I2C_TIMEOUT; i++); // 判断IIC总线是否忙碌 I2C_GenerateSTART(OLED_I2C, ENABLE); // 发送起始信号 // 检查I2C的事件。事件（Event）是指I2C1状态发生变化时产生的信号。这里检查EV5（表示主模式）事件，直到其发生。这表示I2C已经成功切换到Master模式。 for(uint16_t i = 0; !I2C_CheckEvent(OLED_I2C, I2C_EVENT_MASTER_MODE_SELECT) && i < OLED_I2C_TIMEOUT; i++); I2C_Send7bitAddress(OLED_I2C, OLED_ADDRESS, I2C_Direction_Transmitter); // 发送7位地址，I2C通信进入发送模式。 for(uint16_t i = 0; !I2C_CheckEvent(OLED_I2C, I2C_EVENT_MASTER_TRANSMITTER_MODE_SELECTED) && i < OLED_I2C_TIMEOUT; i++); // 检测EV6事件，判断I2C通信是否进入发送模式 #elif defined(OLED_USE_SW_I2C) OLED_W_SDA(1); //释放SDA，确保SDA为高电平 OLED_W_SCL(1); //释放SCL，确保SCL为高电平 OLED_W_SDA(0); //在SCL高电平期间，拉低SDA，产生起始信号 OLED_W_SCL(0); //起始后把SCL也拉低，即为了占用总线，也为了方便总线时序的拼接 #endif } /** * 函数：I2C终止 * 参数：无 * 返回值：无 */ void OLED_I2C_Stop(void) { #ifdef OLED_USE_HW_I2C I2C_GenerateSTOP(OLED_I2C, ENABLE); // 关闭I2C1总线 #elif defined(OLED_USE_SW_I2C) OLED_W_SDA(0); //拉低SDA，确保SDA为低电平 OLED_W_SCL(1); //释放SCL，使SCL呈现高电平 OLED_W_SDA(1); //在SCL高电平期间，释放SDA，产生终止信号 #endif } /** * 函数：I2C发送一个字节 * 参数：Byte 要发送的一个字节数据，范围：0x00~0xFF * 返回值：无 */ void OLED_I2C_SendByte(uint8_t Byte) { #ifdef OLED_USE_HW_I2C I2C_SendData(OLED_I2C, Byte); // 发送一个字节 // 检测EV8_2事件，判断I2C是否发送完成 for(uint16_t i = 0; I2C_CheckEvent(I2C1, I2C_EVENT_MASTER_BYTE_TRANSMITTED) != 1 && i < OLED_I2C_TIMEOUT; i++); #elif defined(OLED_USE_SW_I2C) uint8_t i; /*循环8次，主机依次发送数据的每一位*/ for (i = 0; i < 8; i++) { /*使用掩码的方式取出Byte的指定一位数据并写入到SDA线*/ /*两个!的作用是，让所有非零的值变为1*/ OLED_W_SDA(!!(Byte & (0x80 >> i))); OLED_W_SCL(1); //释放SCL，从机在SCL高电平期间读取SDA OLED_W_SCL(0); //拉低SCL，主机开始发送下一位数据 } OLED_W_SCL(1); //额外的一个时钟，不处理应答信号 OLED_W_SCL(0); #endif } /** * 函数：OLED写命令 * 参数：Command 要写入的命令值，范围：0x00~0xFF * 返回值：无 */ void OLED_WriteCommand(uint8_t Command) { OLED_I2C_Start(); // I2C起始 #ifdef OLED_USE_SW_I2C OLED_I2C_SendByte(0x78); //发送OLED的I2C从机地址 #endif OLED_I2C_SendByte(0x00); //控制字节，给0x00，表示即将写命令 OLED_I2C_SendByte(Command); // 写入指定的命令 OLED_I2C_Stop(); // I2C终止 } /** * 函数：OLED写数据 * 参数：Data 要写入数据的起始地址 * 参数：Count 要写入数据的数量 * 返回值：无 */ void OLED_WriteData(uint8_t *Data, uint8_t Count) { uint8_t i; OLED_I2C_Start(); // I2C起始 #ifdef OLED_USE_SW_I2C OLED_I2C_SendByte(0x78); //发送OLED的I2C从机地址 #endif OLED_I2C_SendByte(0x40); // 控制字节，给0x40，表示即将写数据 /*循环Count次，进行连续的数据写入*/ for (i = 0; i < Count; i++) { OLED_I2C_SendByte(Data[i]); // 依次发送Data的每一个数据 } OLED_I2C_Stop(); // I2C终止 } / ********************* 通信协议*/ /*硬件配置 ********************* / /** * 函数：OLED初始化 * 参数：无 * 返回值：无 * 说明：使用前，需要调用此初始化函数 */ void OLED_Init(void) { OLED_GPIO_Init(); // 先调用底层的端口初始化 /*写入一系列的命令，对OLED进行初始化配置*/ OLED_WriteCommand(0xAE); // 设置显示开启/关闭，0xAE关闭，0xAF开启 OLED_WriteCommand(0xD5); // 设置显示时钟分频比/振荡器频率 OLED_WriteCommand(0x80); // 0x00~0xFF OLED_WriteCommand(0xA8); // 设置多路复用率 OLED_WriteCommand(0x3F); // 0x0E~0x3F OLED_WriteCommand(0xD3); // 设置显示偏移 OLED_WriteCommand(0x00); // 0x00~0x7F OLED_WriteCommand(0x40); // 设置显示开始行，0x40~0x7F OLED_WriteCommand(0xA1); // 设置左右方向，0xA1正常，0xA0左右反置 OLED_WriteCommand(0xC8); // 设置上下方向，0xC8正常，0xC0上下反置 OLED_WriteCommand(0xDA); // 设置COM引脚硬件配置 OLED_WriteCommand(0x12); OLED_WriteCommand(0x81); // 设置对比度 OLED_WriteCommand(0xCF); // 0x00~0xFF OLED_WriteCommand(0xD9); // 设置预充电周期 OLED_WriteCommand(0xF1); OLED_WriteCommand(0xDB); // 设置VCOMH取消选择级别 OLED_WriteCommand(0x30); OLED_WriteCommand(0xA4); // 设置整个显示打开/关闭 OLED_WriteCommand(0xA6); // 设置正常/反色显示，0xA6正常，0xA7反色 OLED_WriteCommand(0x8D); // 设置充电泵 OLED_WriteCommand(0x14); OLED_WriteCommand(0xAF); // 开启显示 OLED_Clear(); // 清空显存数组 OLED_Update(); // 更新显示，清屏，防止初始化后未显示内容时花屏 } /** * 函数：OLED设置显示光标位置 * 参数：Page 指定光标所在的页，范围：0~7 * 参数：X 指定光标所在的X轴坐标，范围：0~127 * 返回值：无 * 说明：OLED默认的Y轴，只能8个Bit为一组写入，即1页等于8个Y轴坐标 */ void OLED_SetCursor(uint8_t Page, uint8_t X) { /*如果使用此程序驱动1.3寸的OLED显示屏，则需要解除此注释*/ /*因为1.3寸的OLED驱动芯片（SH1106）有132列*/ /*屏幕的起始列接在了第2列，而不是第0列*/ /*所以需要将X加2，才能正常显示*/ // X += 2; /*通过指令设置页地址和列地址*/ OLED_WriteCommand(0xB0 | Page); // 设置页位置 OLED_WriteCommand(0x10 | ((X & 0xF0) >> 4)); // 设置X位置高4位 OLED_WriteCommand(0x00 | (X & 0x0F)); // 设置X位置低4位 } / ********************* 硬件配置*/ /*工具函数 ********************* / /*工具函数仅供内部部分函数使用*/ /** * 函数：次方函数 * 参数：X 底数 * 参数：Y 指数 * 返回值：等于X的Y次方 */ uint32_t OLED_Pow(uint32_t X, uint32_t Y) { uint32_t Result = 1; // 结果默认为1 while (Y--) // 累乘Y次 { Result *= X; // 每次把X累乘到结果上 } return Result; } /** * 函数：判断指定点是否在指定多边形内部 * 参数：nvert 多边形的顶点数 * 参数：vertx verty 包含多边形顶点的x和y坐标的数组 * 参数：testx testy 测试点的X和y坐标 * 返回值：指定点是否在指定多边形内部，1：在内部，0：不在内部 */ uint8_t OLED_pnpoly(uint8_t nvert, int16_t *vertx, int16_t *verty, int16_t testx, int16_t testy) { int16_t i, j, c = 0; /*此算法由W. Randolph Franklin提出*/ /*参考链接：https://wrfranklin.org/Research/Short_Notes/pnpoly.html*/ for (i = 0, j = nvert - 1; i < nvert; j = i++) { if (((verty[i] > testy) != (verty[j] > testy)) && (testx < (vertx[j] - vertx[i]) * (testy - verty[i]) / (verty[j] - verty[i]) + vertx[i])) { c = !c; } } return c; } /** * 函数：判断指定点是否在指定角度内部 * 参数：X Y 指定点的坐标 * 参数：StartAngle EndAngle 起始角度和终止角度，范围：-180~180 * 水平向右为0度，水平向左为180度或-180度，下方为正数，上方为负数，顺时针旋转 * 返回值：指定点是否在指定角度内部，1：在内部，0：不在内部 */ uint8_t OLED_IsInAngle(int16_t X, int16_t Y, int16_t StartAngle, int16_t EndAngle) { int16_t PointAngle; PointAngle = atan2(Y, X) / 3.14 * 180; // 计算指定点的弧度，并转换为角度表示 if (StartAngle < EndAngle) // 起始角度小于终止角度的情况 { /*如果指定角度在起始终止角度之间，则判定指定点在指定角度*/ if (PointAngle >= StartAngle && PointAngle <= EndAngle) { return 1; } } else // 起始角度大于于终止角度的情况 { /*如果指定角度大于起始角度或者小于终止角度，则判定指定点在指定角度*/ if (PointAngle >= StartAngle || PointAngle <= EndAngle) { return 1; } } return 0; // 不满足以上条件，则判断判定指定点不在指定角度 } / ********************* 工具函数*/ /*功能函数 ********************* / /** * 函数：将OLED显存数组更新到OLED屏幕 * 参数：无 * 返回值：无 * 说明：所有的显示函数，都只是对OLED显存数组进行读写 * 随后调用OLED_Update函数或OLED_UpdateArea函数 * 才会将显存数组的数据发送到OLED硬件，进行显示 * 故调用显示函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_Update(void) { uint8_t j; /*遍历每一页*/ for (j = 0; j < 8; j++) { /*设置光标位置为每一页的第一列*/ OLED_SetCursor(j, 0); /*连续写入128个数据，将显存数组的数据写入到OLED硬件*/ OLED_WriteData(OLED_DisplayBuf[j], 128); } } /** * 函数：将OLED显存数组部分更新到OLED屏幕 * 参数：X 指定区域左上角的横坐标，范围：0~127 * 参数：Y 指定区域左上角的纵坐标，范围：0~63 * 参数：Width 指定区域的宽度，范围：0~128 * 参数：Height 指定区域的高度，范围：0~64 * 返回值：无 * 说明：此函数会至少更新参数指定的区域 * 如果更新区域Y轴只包含部分页，则同一页的剩余部分会跟随一起更新 * 说明：所有的显示函数，都只是对OLED显存数组进行读写 * 随后调用OLED_Update函数或OLED_UpdateArea函数 * 才会将显存数组的数据发送到OLED硬件，进行显示 * 故调用显示函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_UpdateArea(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height) { uint8_t j; /*参数检查，保证指定区域不会超出屏幕范围*/ if (X > 127) { return; } if (Y > 63) { return; } if (X + Width > 128) { Width = 128 - X; } if (Y + Height > 64) { Height = 64 - Y; } /*遍历指定区域涉及的相关页*/ /*(Y + Height - 1) / 8 + 1的目的是(Y + Height) / 8并向上取整*/ for (j = Y / 8; j < (Y + Height - 1) / 8 + 1; j++) { /*设置光标位置为相关页的指定列*/ OLED_SetCursor(j, X); /*连续写入Width个数据，将显存数组的数据写入到OLED硬件*/ OLED_WriteData(&OLED_DisplayBuf[j][X], Width); } } /** * 函数：将OLED显存数组全部清零 * 参数：无 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_Clear(void) { uint8_t i, j; for (j = 0; j < 8; j++) // 遍历8页 { for (i = 0; i < 128; i++) // 遍历128列 { OLED_DisplayBuf[j][i] = 0x00; // 将显存数组数据全部清零 } } } /** * 函数：将OLED显存数组部分清零 * 参数：X 指定区域左上角的横坐标，范围：0~127 * 参数：Y 指定区域左上角的纵坐标，范围：0~63 * 参数：Width 指定区域的宽度，范围：0~128 * 参数：Height 指定区域的高度，范围：0~64 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ClearArea(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height) { uint8_t i, j; /*参数检查，保证指定区域不会超出屏幕范围*/ if (X > 127) { return; } if (Y > 63) { return; } if (X + Width > 128) { Width = 128 - X; } if (Y + Height > 64) { Height = 64 - Y; } for (j = Y; j < Y + Height; j++) // 遍历指定页 { for (i = X; i < X + Width; i++) // 遍历指定列 { OLED_DisplayBuf[j / 8][i] &= ~(0x01 << (j % 8)); // 将显存数组指定数据清零 } } } /** * 函数：将OLED显存数组全部取反 * 参数：无 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_Reverse(void) { uint8_t i, j; for (j = 0; j < 8; j++) // 遍历8页 { for (i = 0; i < 128; i++) // 遍历128列 { OLED_DisplayBuf[j][i] ^= 0xFF; // 将显存数组数据全部取反 } } } /** * 函数：将OLED显存数组部分取反 * 参数：X 指定区域左上角的横坐标，范围：0~127 * 参数：Y 指定区域左上角的纵坐标，范围：0~63 * 参数：Width 指定区域的宽度，范围：0~128 * 参数：Height 指定区域的高度，范围：0~64 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ReverseArea(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height) { uint8_t i, j; /*参数检查，保证指定区域不会超出屏幕范围*/ if (X > 127) { return; } if (Y > 63) { return; } if (X + Width > 128) { Width = 128 - X; } if (Y + Height > 64) { Height = 64 - Y; } for (j = Y; j < Y + Height; j++) // 遍历指定页 { for (i = X; i < X + Width; i++) // 遍历指定列 { OLED_DisplayBuf[j / 8][i] ^= 0x01 << (j % 8); // 将显存数组指定数据取反 } } } /** * 函数：OLED显示一个字符 * 参数：X 指定字符左上角的横坐标，范围：0~127 * 参数：Y 指定字符左上角的纵坐标，范围：0~63 * 参数：Char 指定要显示的字符，范围：ASCII码可见字符 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowChar(uint8_t X, uint8_t Y, char Char, uint8_t FontSize) { if (FontSize == OLED_8X16) // 字体为宽8像素，高16像素 { /*将ASCII字模库OLED_F8x16的指定数据以8*16的图像格式显示*/ OLED_ShowImage(X, Y, 8, 16, OLED_F8x16[Char - ' ']); } else if (FontSize == OLED_6X8) // 字体为宽6像素，高8像素 { /*将ASCII字模库OLED_F6x8的指定数据以6*8的图像格式显示*/ OLED_ShowImage(X, Y, 6, 8, OLED_F6x8[Char - ' ']); } } /** * 函数：OLED显示字符串 * 参数：X 指定字符串左上角的横坐标，范围：0~127 * 参数：Y 指定字符串左上角的纵坐标，范围：0~63 * 参数：String 指定要显示的字符串，范围：ASCII码可见字符组成的字符串 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowString(uint8_t X, uint8_t Y, char *String, uint8_t FontSize) { uint8_t i; for (i = 0; String[i] != '\0'; i++) // 遍历字符串的每个字符 { /*调用OLED_ShowChar函数，依次显示每个字符*/ OLED_ShowChar(X + i * FontSize, Y, String[i], FontSize); } } /** * 函数：OLED显示数字（十进制，正整数） * 参数：X 指定数字左上角的横坐标，范围：0~127 * 参数：Y 指定数字左上角的纵坐标，范围：0~63 * 参数：Number 指定要显示的数字，范围：0~4294967295 * 参数：Length 指定数字的长度，范围：0~10 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowNum(uint8_t X, uint8_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize) { uint8_t i; for (i = 0; i < Length; i++) // 遍历数字的每一位 { /*调用OLED_ShowChar函数，依次显示每个数字*/ /*Number / OLED_Pow(10, Length - i - 1) % 10 可以十进制提取数字的每一位*/ /*+ '0' 可将数字转换为字符格式*/ OLED_ShowChar(X + i * FontSize, Y, Number / OLED_Pow(10, Length - i - 1) % 10 + '0', FontSize); } } /** * 函数：OLED显示有符号数字（十进制，整数） * 参数：X 指定数字左上角的横坐标，范围：0~127 * 参数：Y 指定数字左上角的纵坐标，范围：0~63 * 参数：Number 指定要显示的数字，范围：-2147483648~2147483647 * 参数：Length 指定数字的长度，范围：0~10 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowSignedNum(uint8_t X, uint8_t Y, int32_t Number, uint8_t Length, uint8_t FontSize) { uint8_t i; uint32_t Number1; if (Number >= 0) // 数字大于等于0 { OLED_ShowChar(X, Y, '+', FontSize); // 显示+号 Number1 = Number; // Number1直接等于Number } else // 数字小于0 { OLED_ShowChar(X, Y, '-', FontSize); // 显示-号 Number1 = -Number; // Number1等于Number取负 } for (i = 0; i < Length; i++) // 遍历数字的每一位 { /*调用OLED_ShowChar函数，依次显示每个数字*/ /*Number1 / OLED_Pow(10, Length - i - 1) % 10 可以十进制提取数字的每一位*/ /*+ '0' 可将数字转换为字符格式*/ OLED_ShowChar(X + (i + 1) * FontSize, Y, Number1 / OLED_Pow(10, Length - i - 1) % 10 + '0', FontSize); } } /** * 函数：OLED显示十六进制数字（十六进制，正整数） * 参数：X 指定数字左上角的横坐标，范围：0~127 * 参数：Y 指定数字左上角的纵坐标，范围：0~63 * 参数：Number 指定要显示的数字，范围：0x00000000~0xFFFFFFFF * 参数：Length 指定数字的长度，范围：0~8 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowHexNum(uint8_t X, uint8_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize) { uint8_t i, SingleNumber; for (i = 0; i < Length; i++) // 遍历数字的每一位 { /*以十六进制提取数字的每一位*/ SingleNumber = Number / OLED_Pow(16, Length - i - 1) % 16; if (SingleNumber < 10) // 单个数字小于10 { /*调用OLED_ShowChar函数，显示此数字*/ /*+ '0' 可将数字转换为字符格式*/ OLED_ShowChar(X + i * FontSize, Y, SingleNumber + '0', FontSize); } else // 单个数字大于10 { /*调用OLED_ShowChar函数，显示此数字*/ /*+ 'A' 可将数字转换为从A开始的十六进制字符*/ OLED_ShowChar(X + i * FontSize, Y, SingleNumber - 10 + 'A', FontSize); } } } /** * 函数：OLED显示二进制数字（二进制，正整数） * 参数：X 指定数字左上角的横坐标，范围：0~127 * 参数：Y 指定数字左上角的纵坐标，范围：0~63 * 参数：Number 指定要显示的数字，范围：0x00000000~0xFFFFFFFF * 参数：Length 指定数字的长度，范围：0~16 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowBinNum(uint8_t X, uint8_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize) { uint8_t i; for (i = 0; i < Length; i++) // 遍历数字的每一位 { /*调用OLED_ShowChar函数，依次显示每个数字*/ /*Number / OLED_Pow(2, Length - i - 1) % 2 可以二进制提取数字的每一位*/ /*+ '0' 可将数字转换为字符格式*/ OLED_ShowChar(X + i * FontSize, Y, Number / OLED_Pow(2, Length - i - 1) % 2 + '0', FontSize); } } /** * 函数：OLED显示浮点数字（十进制，小数） * 参数：X 指定数字左上角的横坐标，范围：0~127 * 参数：Y 指定数字左上角的纵坐标，范围：0~63 * 参数：Number 指定要显示的数字，范围：-4294967295.0~4294967295.0 * 参数：IntLength 指定数字的整数位长度，范围：0~10 * 参数：FraLength 指定数字的小数位长度，范围：0~9，小数进行四舍五入显示 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowFloatNum(uint8_t X, uint8_t Y, double Number, uint8_t IntLength, uint8_t FraLength, uint8_t FontSize) { uint32_t PowNum, IntNum, FraNum; if (Number >= 0) // 数字大于等于0 { OLED_ShowChar(X, Y, '+', FontSize); // 显示+号 } else // 数字小于0 { OLED_ShowChar(X, Y, '-', FontSize); // 显示-号 Number = -Number; // Number取负 } /*提取整数部分和小数部分*/ IntNum = Number; // 直接赋值给整型变量，提取整数 Number -= IntNum; // 将Number的整数减掉，防止之后将小数乘到整数时因数过大造成错误 PowNum = OLED_Pow(10, FraLength); // 根据指定小数的位数，确定乘数 FraNum = round(Number * PowNum); // 将小数乘到整数，同时四舍五入，避免显示误差 IntNum += FraNum / PowNum; // 若四舍五入造成了进位，则需要再加给整数 /*显示整数部分*/ OLED_ShowNum(X + FontSize, Y, IntNum, IntLength, FontSize); /*显示小数点*/ OLED_ShowChar(X + (IntLength + 1) * FontSize, Y, '.', FontSize); /*显示小数部分*/ OLED_ShowNum(X + (IntLength + 2) * FontSize, Y, FraNum, FraLength, FontSize); } /** * 函数：OLED显示汉字串 * 参数：X 指定汉字串左上角的横坐标，范围：0~127 * 参数：Y 指定汉字串左上角的纵坐标，范围：0~63 * 参数：Chinese 指定要显示的汉字串，范围：必须全部为汉字或者全角字符，不要加入任何半角字符 * 显示的汉字需要在OLED_Data.c里的OLED_CF16x16数组定义 * 未找到指定汉字时，会显示默认图形（一个方框，内部一个问号） * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowChinese(uint8_t X, uint8_t Y, char *Chinese) { uint8_t pChinese = 0; uint8_t pIndex; uint8_t i; char SingleChinese[OLED_CHN_CHAR_WIDTH + 1] = {0}; // UTF8编码是3个字节，+1是为了加上\0结束符 for (i = 0; Chinese[i] != '\0'; i++) // 遍历汉字串 { SingleChinese[pChinese] = Chinese[i]; // 提取汉字串数据到单个汉字数组 pChinese++; // 计次自增 /*当提取次数到达OLED_CHN_CHAR_WIDTH时，即代表提取到了一个完整的汉字*/ if (pChinese >= OLED_CHN_CHAR_WIDTH) { SingleChinese[pChinese + 1] = '\0'; // 在汉字后面补上空字符串，表示结束 pChinese = 0; // 计次归零 /*遍历整个汉字字模库，寻找匹配的汉字*/ /*如果找到最后一个汉字（定义为空字符串），则表示汉字未在字模库定义，停止寻找*/ for (pIndex = 0; strcmp(OLED_CF16x16[pIndex].Index, "") != 0; pIndex++) { /*找到匹配的汉字*/ if (strcmp(OLED_CF16x16[pIndex].Index, SingleChinese) == 0) { break; // 跳出循环，此时pIndex的值为指定汉字的索引 } } /*将汉字字模库OLED_CF16x16的指定数据以16*16的图像格式显示*/ OLED_ShowImage(X + ((i + 1) / OLED_CHN_CHAR_WIDTH - 1) * 16, Y, 16, 16, OLED_CF16x16[pIndex].Data); } } } /** * 函数：OLED显示图像 * 参数：X 指定图像左上角的横坐标，范围：0~127 * 参数：Y 指定图像左上角的纵坐标，范围：0~63 * 参数：Width 指定图像的宽度，范围：0~128 * 参数：Height 指定图像的高度，范围：0~64 * 参数：Image 指定要显示的图像 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_ShowImage(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height, const uint8_t *Image) { uint8_t i, j; /*参数检查，保证指定图像不会超出屏幕范围*/ if (X > 127) { return; } if (Y > 63) { return; } /*将图像所在区域清空*/ OLED_ClearArea(X, Y, Width, Height); /*遍历指定图像涉及的相关页*/ /*(Height - 1) / 8 + 1的目的是Height / 8并向上取整*/ for (j = 0; j < (Height - 1) / 8 + 1; j++) { /*遍历指定图像涉及的相关列*/ for (i = 0; i < Width; i++) { /*超出边界，则跳过显示*/ if (X + i > 127) { break; } if (Y / 8 + j > 7) { return; } /*显示图像在当前页的内容*/ OLED_DisplayBuf[Y / 8 + j][X + i] |= Image[j * Width + i] << (Y % 8); /*超出边界，则跳过显示*/ /*使用continue的目的是，下一页超出边界时，上一页的后续内容还需要继续显示*/ if (Y / 8 + j + 1 > 7) { continue; } /*显示图像在下一页的内容*/ OLED_DisplayBuf[Y / 8 + j + 1][X + i] |= Image[j * Width + i] >> (8 - Y % 8); } } } /** * 函数：OLED使用printf函数打印格式化字符串 * 参数：X 指定格式化字符串左上角的横坐标，范围：0~127 * 参数：Y 指定格式化字符串左上角的纵坐标，范围：0~63 * 参数：FontSize 指定字体大小 * 范围：OLED_8X16 宽8像素，高16像素 * OLED_6X8 宽6像素，高8像素 * 参数：format 指定要显示的格式化字符串，范围：ASCII码可见字符组成的字符串 * 参数：... 格式化字符串参数列表 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_Printf(uint8_t X, uint8_t Y, uint8_t FontSize, char *format, ...) { char String[30]; // 定义字符数组 va_list arg; // 定义可变参数列表数据类型的变量arg va_start(arg, format); // 从format开始，接收参数列表到arg变量 vsprintf(String, format, arg); // 使用vsprintf打印格式化字符串和参数列表到字符数组中 va_end(arg); // 结束变量arg OLED_ShowString(X, Y, String, FontSize); // OLED显示字符数组（字符串） } /** * 函数：OLED在指定位置画一个点 * 参数：X 指定点的横坐标，范围：0~127 * 参数：Y 指定点的纵坐标，范围：0~63 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_DrawPoint(uint8_t X, uint8_t Y) { /*参数检查，保证指定位置不会超出屏幕范围*/ if (X > 127) { return; } if (Y > 63) { return; } /*将显存数组指定位置的一个Bit数据置1*/ OLED_DisplayBuf[Y / 8][X] |= 0x01 << (Y % 8); } /** * 函数：OLED获取指定位置点的值 * 参数：X 指定点的横坐标，范围：0~127 * 参数：Y 指定点的纵坐标，范围：0~63 * 返回值：指定位置点是否处于点亮状态，1：点亮，0：熄灭 */ uint8_t OLED_GetPoint(uint8_t X, uint8_t Y) { /*参数检查，保证指定位置不会超出屏幕范围*/ if (X > 127) { return 0; } if (Y > 63) { return 0; } /*判断指定位置的数据*/ if (OLED_DisplayBuf[Y / 8][X] & 0x01 << (Y % 8)) { return 1; // 为1，返回1 } return 0; // 否则，返回0 } /** * 函数：OLED画线 * 参数：X0 指定一个端点的横坐标，范围：0~127 * 参数：Y0 指定一个端点的纵坐标，范围：0~63 * 参数：X1 指定另一个端点的横坐标，范围：0~127 * 参数：Y1 指定另一个端点的纵坐标，范围：0~63 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_DrawLine(uint8_t X0, uint8_t Y0, uint8_t X1, uint8_t Y1) { int16_t x, y, dx, dy, d, incrE, incrNE, temp; int16_t x0 = X0, y0 = Y0, x1 = X1, y1 = Y1; uint8_t yflag = 0, xyflag = 0; if (y0 == y1) // 横线单独处理 { /*0号点X坐标大于1号点X坐标，则交换两点X坐标*/ if (x0 > x1) { temp = x0; x0 = x1; x1 = temp; } /*遍历X坐标*/ for (x = x0; x <= x1; x++) { OLED_DrawPoint(x, y0); // 依次画点 } } else if (x0 == x1) // 竖线单独处理 { /*0号点Y坐标大于1号点Y坐标，则交换两点Y坐标*/ if (y0 > y1) { temp = y0; y0 = y1; y1 = temp; } /*遍历Y坐标*/ for (y = y0; y <= y1; y++) { OLED_DrawPoint(x0, y); // 依次画点 } } else // 斜线 { /*使用Bresenham算法画直线，可以避免耗时的浮点运算，效率更高*/ /*参考文档：https://www.cs.montana.edu/courses/spring2009/425/dslectures/Bresenham.pdf*/ /*参考教程：https://www.bilibili.com/video/BV1364y1d7Lo*/ if (x0 > x1) // 0号点X坐标大于1号点X坐标 { /*交换两点坐标*/ /*交换后不影响画线，但是画线方向由第一、二、三、四象限变为第一、四象限*/ temp = x0; x0 = x1; x1 = temp; temp = y0; y0 = y1; y1 = temp; } if (y0 > y1) // 0号点Y坐标大于1号点Y坐标 { /*将Y坐标取负*/ /*取负后影响画线，但是画线方向由第一、四象限变为第一象限*/ y0 = -y0; y1 = -y1; /*置标志位yflag，记住当前变换，在后续实际画线时，再将坐标换回来*/ yflag = 1; } if (y1 - y0 > x1 - x0) // 画线斜率大于1 { /*将X坐标与Y坐标互换*/ /*互换后影响画线，但是画线方向由第一象限0~90度范围变为第一象限0~45度范围*/ temp = x0; x0 = y0; y0 = temp; temp = x1; x1 = y1; y1 = temp; /*置标志位xyflag，记住当前变换，在后续实际画线时，再将坐标换回来*/ xyflag = 1; } /*以下为Bresenham算法画直线*/ /*算法要求，画线方向必须为第一象限0~45度范围*/ dx = x1 - x0; dy = y1 - y0; incrE = 2 * dy; incrNE = 2 * (dy - dx); d = 2 * dy - dx; x = x0; y = y0; /*画起始点，同时判断标志位，将坐标换回来*/ if (yflag && xyflag) { OLED_DrawPoint(y, -x); } else if (yflag) { OLED_DrawPoint(x, -y); } else if (xyflag) { OLED_DrawPoint(y, x); } else { OLED_DrawPoint(x, y); } while (x < x1) // 遍历X轴的每个点 { x++; if (d < 0) // 下一个点在当前点东方 { d += incrE; } else // 下一个点在当前点东北方 { y++; d += incrNE; } /*画每一个点，同时判断标志位，将坐标换回来*/ if (yflag && xyflag) { OLED_DrawPoint(y, -x); } else if (yflag) { OLED_DrawPoint(x, -y); } else if (xyflag) { OLED_DrawPoint(y, x); } else { OLED_DrawPoint(x, y); } } } } /** * 函数：OLED矩形 * 参数：X 指定矩形左上角的横坐标，范围：0~127 * 参数：Y 指定矩形左上角的纵坐标，范围：0~63 * 参数：Width 指定矩形的宽度，范围：0~128 * 参数：Height 指定矩形的高度，范围：0~64 * 参数：IsFilled 指定矩形是否填充 * 范围：OLED_UNFILLED 不填充 * OLED_FILLED 填充 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_DrawRectangle(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height, uint8_t IsFilled) { uint8_t i, j; if (!IsFilled) // 指定矩形不填充 { /*遍历上下X坐标，画矩形上下两条线*/ for (i = X; i < X + Width; i++) { OLED_DrawPoint(i, Y); OLED_DrawPoint(i, Y + Height - 1); } /*遍历左右Y坐标，画矩形左右两条线*/ for (i = Y; i < Y + Height; i++) { OLED_DrawPoint(X, i); OLED_DrawPoint(X + Width - 1, i); } } else // 指定矩形填充 { /*遍历X坐标*/ for (i = X; i < X + Width; i++) { /*遍历Y坐标*/ for (j = Y; j < Y + Height; j++) { /*在指定区域画点，填充满矩形*/ OLED_DrawPoint(i, j); } } } } /** * 函数：OLED三角形 * 参数：X0 指定第一个端点的横坐标，范围：0~127 * 参数：Y0 指定第一个端点的纵坐标，范围：0~63 * 参数：X1 指定第二个端点的横坐标，范围：0~127 * 参数：Y1 指定第二个端点的纵坐标，范围：0~63 * 参数：X2 指定第三个端点的横坐标，范围：0~127 * 参数：Y2 指定第三个端点的纵坐标，范围：0~63 * 参数：IsFilled 指定三角形是否填充 * 范围：OLED_UNFILLED 不填充 * OLED_FILLED 填充 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_DrawTriangle(uint8_t X0, uint8_t Y0, uint8_t X1, uint8_t Y1, uint8_t X2, uint8_t Y2, uint8_t IsFilled) { uint8_t minx = X0, miny = Y0, maxx = X0, maxy = Y0; uint8_t i, j; int16_t vx[] = {X0, X1, X2}; int16_t vy[] = {Y0, Y1, Y2}; if (!IsFilled) // 指定三角形不填充 { /*调用画线函数，将三个点用直线连接*/ OLED_DrawLine(X0, Y0, X1, Y1); OLED_DrawLine(X0, Y0, X2, Y2); OLED_DrawLine(X1, Y1, X2, Y2); } else // 指定三角形填充 { /*找到三个点最小的X、Y坐标*/ if (X1 < minx) { minx = X1; } if (X2 < minx) { minx = X2; } if (Y1 < miny) { miny = Y1; } if (Y2 < miny) { miny = Y2; } /*找到三个点最大的X、Y坐标*/ if (X1 > maxx) { maxx = X1; } if (X2 > maxx) { maxx = X2; } if (Y1 > maxy) { maxy = Y1; } if (Y2 > maxy) { maxy = Y2; } /*最小最大坐标之间的矩形为可能需要填充的区域*/ /*遍历此区域中所有的点*/ /*遍历X坐标*/ for (i = minx; i <= maxx; i++) { /*遍历Y坐标*/ for (j = miny; j <= maxy; j++) { /*调用OLED_pnpoly，判断指定点是否在指定三角形之中*/ /*如果在，则画点，如果不在，则不做处理*/ if (OLED_pnpoly(3, vx, vy, i, j)) { OLED_DrawPoint(i, j); } } } } } /** * 函数：OLED画圆 * 参数：X 指定圆的圆心横坐标，范围：0~127 * 参数：Y 指定圆的圆心纵坐标，范围：0~63 * 参数：Radius 指定圆的半径，范围：0~255 * 参数：IsFilled 指定圆是否填充 * 范围：OLED_UNFILLED 不填充 * OLED_FILLED 填充 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_DrawCircle(uint8_t X, uint8_t Y, uint8_t Radius, uint8_t IsFilled) { int16_t x, y, d, j; /*使用Bresenham算法画圆，可以避免耗时的浮点运算，效率更高*/ /*参考文档：https://www.cs.montana.edu/courses/spring2009/425/dslectures/Bresenham.pdf*/ /*参考教程：https://www.bilibili.com/video/BV1VM4y1u7wJ*/ d = 1 - Radius; x = 0; y = Radius; /*画每个八分之一圆弧的起始点*/ OLED_DrawPoint(X + x, Y + y); OLED_DrawPoint(X - x, Y - y); OLED_DrawPoint(X + y, Y + x); OLED_DrawPoint(X - y, Y - x); if (IsFilled) // 指定圆填充 { /*遍历起始点Y坐标*/ for (j = -y; j < y; j++) { /*在指定区域画点，填充部分圆*/ OLED_DrawPoint(X, Y + j); } } while (x < y) // 遍历X轴的每个点 { x++; if (d < 0) // 下一个点在当前点东方 { d += 2 * x + 1; } else // 下一个点在当前点东南方 { y--; d += 2 * (x - y) + 1; } /*画每个八分之一圆弧的点*/ OLED_DrawPoint(X + x, Y + y); OLED_DrawPoint(X + y, Y + x); OLED_DrawPoint(X - x, Y - y); OLED_DrawPoint(X - y, Y - x); OLED_DrawPoint(X + x, Y - y); OLED_DrawPoint(X + y, Y - x); OLED_DrawPoint(X - x, Y + y); OLED_DrawPoint(X - y, Y + x); if (IsFilled) // 指定圆填充 { /*遍历中间部分*/ for (j = -y; j < y; j++) { /*在指定区域画点，填充部分圆*/ OLED_DrawPoint(X + x, Y + j); OLED_DrawPoint(X - x, Y + j); } /*遍历两侧部分*/ for (j = -x; j < x; j++) { /*在指定区域画点，填充部分圆*/ OLED_DrawPoint(X - y, Y + j); OLED_DrawPoint(X + y, Y + j); } } } } /** * 函数：OLED画椭圆 * 参数：X 指定椭圆的圆心横坐标，范围：0~127 * 参数：Y 指定椭圆的圆心纵坐标，范围：0~63 * 参数：A 指定椭圆的横向半轴长度，范围：0~255 * 参数：B 指定椭圆的纵向半轴长度，范围：0~255 * 参数：IsFilled 指定椭圆是否填充 * 范围：OLED_UNFILLED 不填充 * OLED_FILLED 填充 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_DrawEllipse(uint8_t X, uint8_t Y, uint8_t A, uint8_t B, uint8_t IsFilled) { int16_t x, y, j; int16_t a = A, b = B; float d1, d2; /*使用Bresenham算法画椭圆，可以避免部分耗时的浮点运算，效率更高*/ /*参考链接：https://blog.csdn.net/myf_666/article/details/128167392*/ x = 0; y = b; d1 = b * b + a * a * (-b + 0.5); if (IsFilled) // 指定椭圆填充 { /*遍历起始点Y坐标*/ for (j = -y; j < y; j++) { /*在指定区域画点，填充部分椭圆*/ OLED_DrawPoint(X, Y + j); OLED_DrawPoint(X, Y + j); } } /*画椭圆弧的起始点*/ OLED_DrawPoint(X + x, Y + y); OLED_DrawPoint(X - x, Y - y); OLED_DrawPoint(X - x, Y + y); OLED_DrawPoint(X + x, Y - y); /*画椭圆中间部分*/ while (b * b * (x + 1) < a * a * (y - 0.5)) { if (d1 <= 0) // 下一个点在当前点东方 { d1 += b * b * (2 * x + 3); } else // 下一个点在当前点东南方 { d1 += b * b * (2 * x + 3) + a * a * (-2 * y + 2); y--; } x++; if (IsFilled) // 指定椭圆填充 { /*遍历中间部分*/ for (j = -y; j < y; j++) { /*在指定区域画点，填充部分椭圆*/ OLED_DrawPoint(X + x, Y + j); OLED_DrawPoint(X - x, Y + j); } } /*画椭圆中间部分圆弧*/ OLED_DrawPoint(X + x, Y + y); OLED_DrawPoint(X - x, Y - y); OLED_DrawPoint(X - x, Y + y); OLED_DrawPoint(X + x, Y - y); } /*画椭圆两侧部分*/ d2 = b * b * (x + 0.5) * (x + 0.5) + a * a * (y - 1) * (y - 1) - a * a * b * b; while (y > 0) { if (d2 <= 0) // 下一个点在当前点东方 { d2 += b * b * (2 * x + 2) + a * a * (-2 * y + 3); x++; } else // 下一个点在当前点东南方 { d2 += a * a * (-2 * y + 3); } y--; if (IsFilled) // 指定椭圆填充 { /*遍历两侧部分*/ for (j = -y; j < y; j++) { /*在指定区域画点，填充部分椭圆*/ OLED_DrawPoint(X + x, Y + j); OLED_DrawPoint(X - x, Y + j); } } /*画椭圆两侧部分圆弧*/ OLED_DrawPoint(X + x, Y + y); OLED_DrawPoint(X - x, Y - y); OLED_DrawPoint(X - x, Y + y); OLED_DrawPoint(X + x, Y - y); } } /** * 函数：OLED画圆弧 * 参数：X 指定圆弧的圆心横坐标，范围：0~127 * 参数：Y 指定圆弧的圆心纵坐标，范围：0~63 * 参数：Radius 指定圆弧的半径，范围：0~255 * 参数：StartAngle 指定圆弧的起始角度，范围：-180~180 * 水平向右为0度，水平向左为180度或-180度，下方为正数，上方为负数，顺时针旋转 * 参数：EndAngle 指定圆弧的终止角度，范围：-180~180 * 水平向右为0度，水平向左为180度或-180度，下方为正数，上方为负数，顺时针旋转 * 参数：IsFilled 指定圆弧是否填充，填充后为扇形 * 范围：OLED_UNFILLED 不填充 * OLED_FILLED 填充 * 返回值：无 * 说明：调用此函数后，要想真正地呈现在屏幕上，还需调用更新函数 */ void OLED_DrawArc(uint8_t X, uint8_t Y, uint8_t Radius, int16_t StartAngle, int16_t EndAngle, uint8_t IsFilled) { int16_t x, y, d, j; /*此函数借用Bresenham算法画圆的方法*/ d = 1 - Radius; x = 0; y = Radius; /*在画圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/ if (OLED_IsInAngle(x, y, StartAngle, EndAngle)) { OLED_DrawPoint(X + x, Y + y); } if (OLED_IsInAngle(-x, -y, StartAngle, EndAngle)) { OLED_DrawPoint(X - x, Y - y); } if (OLED_IsInAngle(y, x, StartAngle, EndAngle)) { OLED_DrawPoint(X + y, Y + x); } if (OLED_IsInAngle(-y, -x, StartAngle, EndAngle)) { OLED_DrawPoint(X - y, Y - x); } if (IsFilled) // 指定圆弧填充 { /*遍历起始点Y坐标*/ for (j = -y; j < y; j++) { /*在填充圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/ if (OLED_IsInAngle(0, j, StartAngle, EndAngle)) { OLED_DrawPoint(X, Y + j); } } } while (x < y) // 遍历X轴的每个点 { x++; if (d < 0) // 下一个点在当前点东方 { d += 2 * x + 1; } else // 下一个点在当前点东南方 { y--; d += 2 * (x - y) + 1; } /*在画圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/ if (OLED_IsInAngle(x, y, StartAngle, EndAngle)) { OLED_DrawPoint(X + x, Y + y); } if (OLED_IsInAngle(y, x, StartAngle, EndAngle)) { OLED_DrawPoint(X + y, Y + x); } if (OLED_IsInAngle(-x, -y, StartAngle, EndAngle)) { OLED_DrawPoint(X - x, Y - y); } if (OLED_IsInAngle(-y, -x, StartAngle, EndAngle)) { OLED_DrawPoint(X - y, Y - x); } if (OLED_IsInAngle(x, -y, StartAngle, EndAngle)) { OLED_DrawPoint(X + x, Y - y); } if (OLED_IsInAngle(y, -x, StartAngle, EndAngle)) { OLED_DrawPoint(X + y, Y - x); } if (OLED_IsInAngle(-x, y, StartAngle, EndAngle)) { OLED_DrawPoint(X - x, Y + y); } if (OLED_IsInAngle(-y, x, StartAngle, EndAngle)) { OLED_DrawPoint(X - y, Y + x); } if (IsFilled) // 指定圆弧填充 { /*遍历中间部分*/ for (j = -y; j < y; j++) { /*在填充圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/ if (OLED_IsInAngle(x, j, StartAngle, EndAngle)) { OLED_DrawPoint(X + x, Y + j); } if (OLED_IsInAngle(-x, j, StartAngle, EndAngle)) { OLED_DrawPoint(X - x, Y + j); } } /*遍历两侧部分*/ for (j = -x; j < x; j++) { /*在填充圆的每个点时，判断指定点是否在指定角度内，在，则画点，不在，则不做处理*/ if (OLED_IsInAngle(-y, j, StartAngle, EndAngle)) { OLED_DrawPoint(X - y, Y + j); } if (OLED_IsInAngle(y, j, StartAngle, EndAngle)) { OLED_DrawPoint(X + y, Y + j); } } } } } / ********************* 功能函数*/ / *****************江协科技|版权所有**************** / / *****************jiangxiekeji.com***************** / ``` **OLED.h文件：** ```c #ifndef __OLED_H #define __OLED_H #include #include "OLED_Data.h" /*参数宏定义 ********************* / /*FontSize参数取值*/ /*此参数值不仅用于判断，而且用于计算横向字符偏移，默认值为字体像素宽度*/ #define OLED_8X16 8 #define OLED_6X8 6 /*IsFilled参数数值*/ #define OLED_UNFILLED 0 #define OLED_FILLED 1 / ********************* 参数宏定义*/ /*函数声明 ********************* / /*初始化函数*/ void OLED_Init(void); /*更新函数*/ void OLED_Update(void); void OLED_UpdateArea(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height); /*显存控制函数*/ void OLED_Clear(void); void OLED_ClearArea(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height); void OLED_Reverse(void); void OLED_ReverseArea(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height); /*显示函数*/ void OLED_ShowChar(uint8_t X, uint8_t Y, char Char, uint8_t FontSize); void OLED_ShowString(uint8_t X, uint8_t Y, char *String, uint8_t FontSize); void OLED_ShowNum(uint8_t X, uint8_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize); void OLED_ShowSignedNum(uint8_t X, uint8_t Y, int32_t Number, uint8_t Length, uint8_t FontSize); void OLED_ShowHexNum(uint8_t X, uint8_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize); void OLED_ShowBinNum(uint8_t X, uint8_t Y, uint32_t Number, uint8_t Length, uint8_t FontSize); void OLED_ShowFloatNum(uint8_t X, uint8_t Y, double Number, uint8_t IntLength, uint8_t FraLength, uint8_t FontSize); void OLED_ShowChinese(uint8_t X, uint8_t Y, char *Chinese); void OLED_ShowImage(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height, const uint8_t *Image); void OLED_Printf(uint8_t X, uint8_t Y, uint8_t FontSize, char *format, ...); /*绘图函数*/ void OLED_DrawPoint(uint8_t X, uint8_t Y); uint8_t OLED_GetPoint(uint8_t X, uint8_t Y); void OLED_DrawLine(uint8_t X0, uint8_t Y0, uint8_t X1, uint8_t Y1); void OLED_DrawRectangle(uint8_t X, uint8_t Y, uint8_t Width, uint8_t Height, uint8_t IsFilled); void OLED_DrawTriangle(uint8_t X0, uint8_t Y0, uint8_t X1, uint8_t Y1, uint8_t X2, uint8_t Y2, uint8_t IsFilled); void OLED_DrawCircle(uint8_t X, uint8_t Y, uint8_t Radius, uint8_t IsFilled); void OLED_DrawEllipse(uint8_t X, uint8_t Y, uint8_t A, uint8_t B, uint8_t IsFilled); void OLED_DrawArc(uint8_t X, uint8_t Y, uint8_t Radius, int16_t StartAngle, int16_t EndAngle, uint8_t IsFilled); / ********************* 函数声明*/ #endif / *****************江协科技|版权所有**************** / / *****************jiangxiekeji.com***************** / ``` **OLED\_Data.c文件：** ```c #include "OLED_Data.h" /** * 数据存储格式： * 纵向8点，高位在下，先从左到右，再从上到下 * 每一个Bit对应一个像素点 * * B0 B0 B0 B0 * B1 B1 B1 B1 * B2 B2 B2 B2 * B3 B3 -------------> B3 B3 -- * B4 B4 B4 B4 | * B5 B5 B5 B5 | * B6 B6 B6 B6 | * B7 B7 B7 B7 | * | * ----------------------------------- * | * | B0 B0 B0 B0 * | B1 B1 B1 B1 * | B2 B2 B2 B2 * --> B3 B3 -------------> B3 B3 * B4 B4 B4 B4 * B5 B5 B5 B5 * B6 B6 B6 B6 * B7 B7 B7 B7 * */ /*ASCII字模数据 ********************* / /*宽8像素，高16像素*/ const uint8_t OLED_F8x16[][16] = { 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// 0 0x00,0x00,0x00,0xF8,0x00,0x00,0x00,0x00, 0x00,0x00,0x00,0x33,0x30,0x00,0x00,0x00,// ! 1 0x00,0x16,0x0E,0x00,0x16,0x0E,0x00,0x00, 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// " 2 0x40,0xC0,0x78,0x40,0xC0,0x78,0x40,0x00, 0x04,0x3F,0x04,0x04,0x3F,0x04,0x04,0x00,// # 3 0x00,0x70,0x88,0xFC,0x08,0x30,0x00,0x00, 0x00,0x18,0x20,0xFF,0x21,0x1E,0x00,0x00,// $ 4 0xF0,0x08,0xF0,0x00,0xE0,0x18,0x00,0x00, 0x00,0x21,0x1C,0x03,0x1E,0x21,0x1E,0x00,// % 5 0x00,0xF0,0x08,0x88,0x70,0x00,0x00,0x00, 0x1E,0x21,0x23,0x24,0x19,0x27,0x21,0x10,// & 6 0x00,0x00,0x00,0x16,0x0E,0x00,0x00,0x00, 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// ' 7 0x00,0x00,0x00,0xE0,0x18,0x04,0x02,0x00, 0x00,0x00,0x00,0x07,0x18,0x20,0x40,0x00,// ( 8 0x00,0x02,0x04,0x18,0xE0,0x00,0x00,0x00, 0x00,0x40,0x20,0x18,0x07,0x00,0x00,0x00,// ) 9 0x40,0x40,0x80,0xF0,0x80,0x40,0x40,0x00, 0x02,0x02,0x01,0x0F,0x01,0x02,0x02,0x00,// * 10 0x00,0x00,0x00,0xF0,0x00,0x00,0x00,0x00, 0x01,0x01,0x01,0x1F,0x01,0x01,0x01,0x00,// + 11 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x00,0xB0,0x70,0x00,0x00,0x00,0x00,0x00,// , 12 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x00,0x01,0x01,0x01,0x01,0x01,0x01,0x01,// - 13 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x00,0x30,0x30,0x00,0x00,0x00,0x00,0x00,// . 14 0x00,0x00,0x00,0x00,0x80,0x60,0x18,0x04, 0x00,0x60,0x18,0x06,0x01,0x00,0x00,0x00,// / 15 0x00,0xE0,0x10,0x08,0x08,0x10,0xE0,0x00, 0x00,0x0F,0x10,0x20,0x20,0x10,0x0F,0x00,// 0 16 0x00,0x10,0x10,0xF8,0x00,0x00,0x00,0x00, 0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// 1 17 0x00,0x70,0x08,0x08,0x08,0x88,0x70,0x00, 0x00,0x30,0x28,0x24,0x22,0x21,0x30,0x00,// 2 18 0x00,0x30,0x08,0x88,0x88,0x48,0x30,0x00, 0x00,0x18,0x20,0x20,0x20,0x11,0x0E,0x00,// 3 19 0x00,0x00,0xC0,0x20,0x10,0xF8,0x00,0x00, 0x00,0x07,0x04,0x24,0x24,0x3F,0x24,0x00,// 4 20 0x00,0xF8,0x08,0x88,0x88,0x08,0x08,0x00, 0x00,0x19,0x21,0x20,0x20,0x11,0x0E,0x00,// 5 21 0x00,0xE0,0x10,0x88,0x88,0x18,0x00,0x00, 0x00,0x0F,0x11,0x20,0x20,0x11,0x0E,0x00,// 6 22 0x00,0x38,0x08,0x08,0xC8,0x38,0x08,0x00, 0x00,0x00,0x00,0x3F,0x00,0x00,0x00,0x00,// 7 23 0x00,0x70,0x88,0x08,0x08,0x88,0x70,0x00, 0x00,0x1C,0x22,0x21,0x21,0x22,0x1C,0x00,// 8 24 0x00,0xE0,0x10,0x08,0x08,0x10,0xE0,0x00, 0x00,0x00,0x31,0x22,0x22,0x11,0x0F,0x00,// 9 25 0x00,0x00,0x00,0xC0,0xC0,0x00,0x00,0x00, 0x00,0x00,0x00,0x30,0x30,0x00,0x00,0x00,// : 26 0x00,0x00,0x00,0xC0,0xC0,0x00,0x00,0x00, 0x00,0x00,0x80,0xB0,0x70,0x00,0x00,0x00,// ; 27 0x00,0x00,0x80,0x40,0x20,0x10,0x08,0x00, 0x00,0x01,0x02,0x04,0x08,0x10,0x20,0x00,// < 28 0x40,0x40,0x40,0x40,0x40,0x40,0x40,0x00, 0x04,0x04,0x04,0x04,0x04,0x04,0x04,0x00,// = 29 0x00,0x08,0x10,0x20,0x40,0x80,0x00,0x00, 0x00,0x20,0x10,0x08,0x04,0x02,0x01,0x00,// > 30 0x00,0x70,0x48,0x08,0x08,0x08,0xF0,0x00, 0x00,0x00,0x00,0x30,0x36,0x01,0x00,0x00,// ? 31 0xC0,0x30,0xC8,0x28,0xE8,0x10,0xE0,0x00, 0x07,0x18,0x27,0x24,0x23,0x14,0x0B,0x00,// @ 32 0x00,0x00,0xC0,0x38,0xE0,0x00,0x00,0x00, 0x20,0x3C,0x23,0x02,0x02,0x27,0x38,0x20,// A 33 0x08,0xF8,0x88,0x88,0x88,0x70,0x00,0x00, 0x20,0x3F,0x20,0x20,0x20,0x11,0x0E,0x00,// B 34 0xC0,0x30,0x08,0x08,0x08,0x08,0x38,0x00, 0x07,0x18,0x20,0x20,0x20,0x10,0x08,0x00,// C 35 0x08,0xF8,0x08,0x08,0x08,0x10,0xE0,0x00, 0x20,0x3F,0x20,0x20,0x20,0x10,0x0F,0x00,// D 36 0x08,0xF8,0x88,0x88,0xE8,0x08,0x10,0x00, 0x20,0x3F,0x20,0x20,0x23,0x20,0x18,0x00,// E 37 0x08,0xF8,0x88,0x88,0xE8,0x08,0x10,0x00, 0x20,0x3F,0x20,0x00,0x03,0x00,0x00,0x00,// F 38 0xC0,0x30,0x08,0x08,0x08,0x38,0x00,0x00, 0x07,0x18,0x20,0x20,0x22,0x1E,0x02,0x00,// G 39 0x08,0xF8,0x08,0x00,0x00,0x08,0xF8,0x08, 0x20,0x3F,0x21,0x01,0x01,0x21,0x3F,0x20,// H 40 0x00,0x08,0x08,0xF8,0x08,0x08,0x00,0x00, 0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// I 41 0x00,0x00,0x08,0x08,0xF8,0x08,0x08,0x00, 0xC0,0x80,0x80,0x80,0x7F,0x00,0x00,0x00,// J 42 0x08,0xF8,0x88,0xC0,0x28,0x18,0x08,0x00, 0x20,0x3F,0x20,0x01,0x26,0x38,0x20,0x00,// K 43 0x08,0xF8,0x08,0x00,0x00,0x00,0x00,0x00, 0x20,0x3F,0x20,0x20,0x20,0x20,0x30,0x00,// L 44 0x08,0xF8,0xF8,0x00,0xF8,0xF8,0x08,0x00, 0x20,0x3F,0x00,0x3F,0x00,0x3F,0x20,0x00,// M 45 0x08,0xF8,0x30,0xC0,0x00,0x08,0xF8,0x08, 0x20,0x3F,0x20,0x00,0x07,0x18,0x3F,0x00,// N 46 0xE0,0x10,0x08,0x08,0x08,0x10,0xE0,0x00, 0x0F,0x10,0x20,0x20,0x20,0x10,0x0F,0x00,// O 47 0x08,0xF8,0x08,0x08,0x08,0x08,0xF0,0x00, 0x20,0x3F,0x21,0x01,0x01,0x01,0x00,0x00,// P 48 0xE0,0x10,0x08,0x08,0x08,0x10,0xE0,0x00, 0x0F,0x18,0x24,0x24,0x38,0x50,0x4F,0x00,// Q 49 0x08,0xF8,0x88,0x88,0x88,0x88,0x70,0x00, 0x20,0x3F,0x20,0x00,0x03,0x0C,0x30,0x20,// R 50 0x00,0x70,0x88,0x08,0x08,0x08,0x38,0x00, 0x00,0x38,0x20,0x21,0x21,0x22,0x1C,0x00,// S 51 0x18,0x08,0x08,0xF8,0x08,0x08,0x18,0x00, 0x00,0x00,0x20,0x3F,0x20,0x00,0x00,0x00,// T 52 0x08,0xF8,0x08,0x00,0x00,0x08,0xF8,0x08, 0x00,0x1F,0x20,0x20,0x20,0x20,0x1F,0x00,// U 53 0x08,0x78,0x88,0x00,0x00,0xC8,0x38,0x08, 0x00,0x00,0x07,0x38,0x0E,0x01,0x00,0x00,// V 54 0xF8,0x08,0x00,0xF8,0x00,0x08,0xF8,0x00, 0x03,0x3C,0x07,0x00,0x07,0x3C,0x03,0x00,// W 55 0x08,0x18,0x68,0x80,0x80,0x68,0x18,0x08, 0x20,0x30,0x2C,0x03,0x03,0x2C,0x30,0x20,// X 56 0x08,0x38,0xC8,0x00,0xC8,0x38,0x08,0x00, 0x00,0x00,0x20,0x3F,0x20,0x00,0x00,0x00,// Y 57 0x10,0x08,0x08,0x08,0xC8,0x38,0x08,0x00, 0x20,0x38,0x26,0x21,0x20,0x20,0x18,0x00,// Z 58 0x00,0x00,0x00,0xFE,0x02,0x02,0x02,0x00, 0x00,0x00,0x00,0x7F,0x40,0x40,0x40,0x00,// [ 59 0x00,0x0C,0x30,0xC0,0x00,0x00,0x00,0x00, 0x00,0x00,0x00,0x01,0x06,0x38,0xC0,0x00,// \ 60 0x00,0x02,0x02,0x02,0xFE,0x00,0x00,0x00, 0x00,0x40,0x40,0x40,0x7F,0x00,0x00,0x00,// ] 61 0x00,0x20,0x10,0x08,0x04,0x08,0x10,0x20, 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// ^ 62 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x80,0x80,0x80,0x80,0x80,0x80,0x80,0x80,// _ 63 0x00,0x02,0x04,0x08,0x00,0x00,0x00,0x00, 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,// ` 64 0x00,0x00,0x80,0x80,0x80,0x80,0x00,0x00, 0x00,0x19,0x24,0x22,0x22,0x22,0x3F,0x20,// a 65 0x08,0xF8,0x00,0x80,0x80,0x00,0x00,0x00, 0x00,0x3F,0x11,0x20,0x20,0x11,0x0E,0x00,// b 66 0x00,0x00,0x00,0x80,0x80,0x80,0x00,0x00, 0x00,0x0E,0x11,0x20,0x20,0x20,0x11,0x00,// c 67 0x00,0x00,0x00,0x80,0x80,0x88,0xF8,0x00, 0x00,0x0E,0x11,0x20,0x20,0x10,0x3F,0x20,// d 68 0x00,0x00,0x80,0x80,0x80,0x80,0x00,0x00, 0x00,0x1F,0x22,0x22,0x22,0x22,0x13,0x00,// e 69 0x00,0x80,0x80,0xF0,0x88,0x88,0x88,0x18, 0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// f 70 0x00,0x00,0x80,0x80,0x80,0x80,0x80,0x00, 0x00,0x6B,0x94,0x94,0x94,0x93,0x60,0x00,// g 71 0x08,0xF8,0x00,0x80,0x80,0x80,0x00,0x00, 0x20,0x3F,0x21,0x00,0x00,0x20,0x3F,0x20,// h 72 0x00,0x80,0x98,0x98,0x00,0x00,0x00,0x00, 0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// i 73 0x00,0x00,0x00,0x80,0x98,0x98,0x00,0x00, 0x00,0xC0,0x80,0x80,0x80,0x7F,0x00,0x00,// j 74 0x08,0xF8,0x00,0x00,0x80,0x80,0x80,0x00, 0x20,0x3F,0x24,0x02,0x2D,0x30,0x20,0x00,// k 75 0x00,0x08,0x08,0xF8,0x00,0x00,0x00,0x00, 0x00,0x20,0x20,0x3F,0x20,0x20,0x00,0x00,// l 76 0x80,0x80,0x80,0x80,0x80,0x80,0x80,0x00, 0x20,0x3F,0x20,0x00,0x3F,0x20,0x00,0x3F,// m 77 0x00,0x80,0x80,0x00,0x80,0x80,0x00,0x00, 0x00,0x20,0x3F,0x21,0x00,0x20,0x3F,0x20,// n 78 0x00,0x00,0x80,0x80,0x80,0x80,0x00,0x00, 0x00,0x1F,0x20,0x20,0x20,0x20,0x1F,0x00,// o 79 0x80,0x80,0x00,0x80,0x80,0x00,0x00,0x00, 0x80,0xFF,0xA1,0x20,0x20,0x11,0x0E,0x00,// p 80 0x00,0x00,0x00,0x80,0x80,0x80,0x80,0x00, 0x00,0x0E,0x11,0x20,0x20,0xA0,0xFF,0x80,// q 81 0x80,0x80,0x80,0x00,0x80,0x80,0x80,0x00, 0x20,0x20,0x3F,0x21,0x20,0x00,0x01,0x00,// r 82 0x00,0x00,0x80,0x80,0x80,0x80,0x80,0x00, 0x00,0x33,0x24,0x24,0x24,0x24,0x19,0x00,// s 83 0x00,0x80,0x80,0xE0,0x80,0x80,0x00,0x00, 0x00,0x00,0x00,0x1F,0x20,0x20,0x00,0x00,// t 84 0x80,0x80,0x00,0x00,0x00,0x80,0x80,0x00, 0x00,0x1F,0x20,0x20,0x20,0x10,0x3F,0x20,// u 85 0x80,0x80,0x80,0x00,0x00,0x80,0x80,0x80, 0x00,0x01,0x0E,0x30,0x08,0x06,0x01,0x00,// v 86 0x80,0x80,0x00,0x80,0x00,0x80,0x80,0x80, 0x0F,0x30,0x0C,0x03,0x0C,0x30,0x0F,0x00,// w 87 0x00,0x80,0x80,0x00,0x80,0x80,0x80,0x00, 0x00,0x20,0x31,0x2E,0x0E,0x31,0x20,0x00,// x 88 0x80,0x80,0x80,0x00,0x00,0x80,0x80,0x80, 0x80,0x81,0x8E,0x70,0x18,0x06,0x01,0x00,// y 89 0x00,0x80,0x80,0x80,0x80,0x80,0x80,0x00, 0x00,0x21,0x30,0x2C,0x22,0x21,0x30,0x00,// z 90 0x00,0x00,0x00,0x00,0x80,0x7C,0x02,0x02, 0x00,0x00,0x00,0x00,0x00,0x3F,0x40,0x40,// { 91 0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00, 0x00,0x00,0x00,0x00,0xFF,0x00,0x00,0x00,// | 92 0x00,0x02,0x02,0x7C,0x80,0x00,0x00,0x00, 0x00,0x40,0x40,0x3F,0x00,0x00,0x00,0x00,// } 93 0x00,0x80,0x40,0x40,0x80,0x00,0x00,0x80, 0x00,0x00,0x00,0x00,0x00,0x01,0x01,0x00,// ~ 94 }; /*宽6像素，高8像素*/ const uint8_t OLED_F6x8[][6] = { 0x00,0x00,0x00,0x00,0x00,0x00,// 0 0x00,0x00,0x00,0x2F,0x00,0x00,// ! 1 0x00,0x00,0x07,0x00,0x07,0x00,// " 2 0x00,0x14,0x7F,0x14,0x7F,0x14,// # 3 0x00,0x24,0x2A,0x7F,0x2A,0x12,// $ 4 0x00,0x23,0x13,0x08,0x64,0x62,// % 5 0x00,0x36,0x49,0x55,0x22,0x50,// & 6 0x00,0x00,0x00,0x07,0x00,0x00,// ' 7 0x00,0x00,0x1C,0x22,0x41,0x00,// ( 8 0x00,0x00,0x41,0x22,0x1C,0x00,// ) 9 0x00,0x14,0x08,0x3E,0x08,0x14,// * 10 0x00,0x08,0x08,0x3E,0x08,0x08,// + 11 0x00,0x00,0x00,0xA0,0x60,0x00,// , 12 0x00,0x08,0x08,0x08,0x08,0x08,// - 13 0x00,0x00,0x60,0x60,0x00,0x00,// . 14 0x00,0x20,0x10,0x08,0x04,0x02,// / 15 0x00,0x3E,0x51,0x49,0x45,0x3E,// 0 16 0x00,0x00,0x42,0x7F,0x40,0x00,// 1 17 0x00,0x42,0x61,0x51,0x49,0x46,// 2 18 0x00,0x21,0x41,0x45,0x4B,0x31,// 3 19 0x00,0x18,0x14,0x12,0x7F,0x10,// 4 20 0x00,0x27,0x45,0x45,0x45,0x39,// 5 21 0x00,0x3C,0x4A,0x49,0x49,0x30,// 6 22 0x00,0x01,0x71,0x09,0x05,0x03,// 7 23 0x00,0x36,0x49,0x49,0x49,0x36,// 8 24 0x00,0x06,0x49,0x49,0x29,0x1E,// 9 25 0x00,0x00,0x36,0x36,0x00,0x00,// : 26 0x00,0x00,0x56,0x36,0x00,0x00,// ; 27 0x00,0x08,0x14,0x22,0x41,0x00,// < 28 0x00,0x14,0x14,0x14,0x14,0x14,// = 29 0x00,0x00,0x41,0x22,0x14,0x08,// > 30 0x00,0x02,0x01,0x51,0x09,0x06,// ? 31 0x00,0x3E,0x49,0x55,0x59,0x2E,// @ 32 0x00,0x7C,0x12,0x11,0x12,0x7C,// A 33 0x00,0x7F,0x49,0x49,0x49,0x36,// B 34 0x00,0x3E,0x41,0x41,0x41,0x22,// C 35 0x00,0x7F,0x41,0x41,0x22,0x1C,// D 36 0x00,0x7F,0x49,0x49,0x49,0x41,// E 37 0x00,0x7F,0x09,0x09,0x09,0x01,// F 38 0x00,0x3E,0x41,0x49,0x49,0x7A,// G 39 0x00,0x7F,0x08,0x08,0x08,0x7F,// H 40 0x00,0x00,0x41,0x7F,0x41,0x00,// I 41 0x00,0x20,0x40,0x41,0x3F,0x01,// J 42 0x00,0x7F,0x08,0x14,0x22,0x41,// K 43 0x00,0x7F,0x40,0x40,0x40,0x40,// L 44 0x00,0x7F,0x02,0x0C,0x02,0x7F,// M 45 0x00,0x7F,0x04,0x08,0x10,0x7F,// N 46 0x00,0x3E,0x41,0x41,0x41,0x3E,// O 47 0x00,0x7F,0x09,0x09,0x09,0x06,// P 48 0x00,0x3E,0x41,0x51,0x21,0x5E,// Q 49 0x00,0x7F,0x09,0x19,0x29,0x46,// R 50 0x00,0x46,0x49,0x49,0x49,0x31,// S 51 0x00,0x01,0x01,0x7F,0x01,0x01,// T 52 0x00,0x3F,0x40,0x40,0x40,0x3F,// U 53 0x00,0x1F,0x20,0x40,0x20,0x1F,// V 54 0x00,0x3F,0x40,0x38,0x40,0x3F,// W 55 0x00,0x63,0x14,0x08,0x14,0x63,// X 56 0x00,0x07,0x08,0x70,0x08,0x07,// Y 57 0x00,0x61,0x51,0x49,0x45,0x43,// Z 58 0x00,0x00,0x7F,0x41,0x41,0x00,// [ 59 0x00,0x02,0x04,0x08,0x10,0x20,// \ 60 0x00,0x00,0x41,0x41,0x7F,0x00,// ] 61 0x00,0x04,0x02,0x01,0x02,0x04,// ^ 62 0x00,0x40,0x40,0x40,0x40,0x40,// _ 63 0x00,0x00,0x01,0x02,0x04,0x00,// ` 64 0x00,0x20,0x54,0x54,0x54,0x78,// a 65 0x00,0x7F,0x48,0x44,0x44,0x38,// b 66 0x00,0x38,0x44,0x44,0x44,0x20,// c 67 0x00,0x38,0x44,0x44,0x48,0x7F,// d 68 0x00,0x38,0x54,0x54,0x54,0x18,// e 69 0x00,0x08,0x7E,0x09,0x01,0x02,// f 70 0x00,0x18,0xA4,0xA4,0xA4,0x7C,// g 71 0x00,0x7F,0x08,0x04,0x04,0x78,// h 72 0x00,0x00,0x44,0x7D,0x40,0x00,// i 73 0x00,0x40,0x80,0x84,0x7D,0x00,// j 74 0x00,0x7F,0x10,0x28,0x44,0x00,// k 75 0x00,0x00,0x41,0x7F,0x40,0x00,// l 76 0x00,0x7C,0x04,0x18,0x04,0x78,// m 77 0x00,0x7C,0x08,0x04,0x04,0x78,// n 78 0x00,0x38,0x44,0x44,0x44,0x38,// o 79 0x00,0xFC,0x24,0x24,0x24,0x18,// p 80 0x00,0x18,0x24,0x24,0x18,0xFC,// q 81 0x00,0x7C,0x08,0x04,0x04,0x08,// r 82 0x00,0x48,0x54,0x54,0x54,0x20,// s 83 0x00,0x04,0x3F,0x44,0x40,0x20,// t 84 0x00,0x3C,0x40,0x40,0x20,0x7C,// u 85 0x00,0x1C,0x20,0x40,0x20,0x1C,// v 86 0x00,0x3C,0x40,0x30,0x40,0x3C,// w 87 0x00,0x44,0x28,0x10,0x28,0x44,// x 88 0x00,0x1C,0xA0,0xA0,0xA0,0x7C,// y 89 0x00,0x44,0x64,0x54,0x4C,0x44,// z 90 0x00,0x00,0x08,0x7F,0x41,0x00,// { 91 0x00,0x00,0x00,0x7F,0x00,0x00,// | 92 0x00,0x00,0x41,0x7F,0x08,0x00,// } 93 0x00,0x08,0x04,0x08,0x10,0x08,// ~ 94 }; / ********************* ASCII字模数据*/ /*汉字字模数据 ********************* / /*相同的汉字只需要定义一次，汉字不分先后顺序*/ /*必须全部为汉字或者全角字符，不要加入任何半角字符*/ /*宽16像素，高16像素*/ const ChineseCell_t OLED_CF16x16[] = { "，", 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x00,0x00,0x58,0x38,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, "。", 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, 0x00,0x00,0x18,0x24,0x24,0x18,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00, "你", 0x00,0x80,0x60,0xF8,0x07,0x40,0x20,0x18,0x0F,0x08,0xC8,0x08,0x08,0x28,0x18,0x00, 0x01,0x00,0x00,0xFF,0x00,0x10,0x0C,0x03,0x40,0x80,0x7F,0x00,0x01,0x06,0x18,0x00, "好", 0x10,0x10,0xF0,0x1F,0x10,0xF0,0x00,0x80,0x82,0x82,0xE2,0x92,0x8A,0x86,0x80,0x00, 0x40,0x22,0x15,0x08,0x16,0x61,0x00,0x00,0x40,0x80,0x7F,0x00,0x00,0x00,0x00,0x00, "世", 0x20,0x20,0x20,0xFE,0x20,0x20,0xFF,0x20,0x20,0x20,0xFF,0x20,0x20,0x20,0x20,0x00, 0x00,0x00,0x00,0x7F,0x40,0x40,0x47,0x44,0x44,0x44,0x47,0x40,0x40,0x40,0x00,0x00, "界", 0x00,0x00,0x00,0xFE,0x92,0x92,0x92,0xFE,0x92,0x92,0x92,0xFE,0x00,0x00,0x00,0x00, 0x08,0x08,0x04,0x84,0x62,0x1E,0x01,0x00,0x01,0xFE,0x02,0x04,0x04,0x08,0x08,0x00, /*按照上面的格式，在这个位置加入新的汉字数据*/ //... /*未找到指定汉字时显示的默认图形（一个方框，内部一个问号），请确保其位于数组最末尾*/ "", 0xFF,0x01,0x01,0x01,0x31,0x09,0x09,0x09,0x09,0x89,0x71,0x01,0x01,0x01,0x01,0xFF, 0xFF,0x80,0x80,0x80,0x80,0x80,0x80,0x96,0x81,0x80,0x80,0x80,0x80,0x80,0x80,0xFF, }; / ********************* 汉字字模数据*/ /*图像数据 ********************* / /*测试图像（一个方框，内部一个二极管符号），宽16像素，高16像素*/ const uint8_t Diode[] = { 0xFF,0x01,0x81,0x81,0x81,0xFD,0x89,0x91,0xA1,0xC1,0xFD,0x81,0x81,0x81,0x01,0xFF, 0xFF,0x80,0x80,0x80,0x80,0x9F,0x88,0x84,0x82,0x81,0x9F,0x80,0x80,0x80,0x80,0xFF, }; /*按照上面的格式，在这个位置加入新的图像数据*/ //... / ********************* 图像数据*/ / *****************江协科技|版权所有**************** / / *****************jiangxiekeji.com***************** / ``` **OLED\_Data.h文件：** ```c #ifndef __OLED_DATA_H #define __OLED_DATA_H #include /*中文字符字节宽度*/ #define OLED_CHN_CHAR_WIDTH 3 //UTF-8编码格式给3，GB2312编码格式给2 /*字模基本单元*/ typedef struct { char Index[OLED_CHN_CHAR_WIDTH + 1]; //汉字索引 uint8_t Data[32]; //字模数据 } ChineseCell_t; /*ASCII字模数据声明*/ extern const uint8_t OLED_F8x16[][16]; extern const uint8_t OLED_F6x8[][6]; /*汉字字模数据声明*/ extern const ChineseCell_t OLED_CF16x16[]; /*图像数据声明*/ extern const uint8_t Diode[]; /*按照上面的格式，在这个位置加入新的图像数据声明*/ //... #endif / *****************江协科技|版权所有**************** / / *****************jiangxiekeji.com***************** / ``` ## 推荐阅读 - **高性价比和便宜的VPS/云服务器推荐:** [https://blog.zeruns.com/archives/383.html](https://blog.zeruns.com/archives/383.html) - 云服务器搭建Typecho个人博客网站，保姆级建站教程：[https://blog.zeruns.com/archives/749.html](https://blog.zeruns.com/archives/749.html) - 我的世界开服教程：[https://blog.zeruns.com/tag/mc/](https://blog.zeruns.com/tag/mc/) - 幻兽帕鲁开服教程：[https://blog.zeruns.com/tag/PalWorld/](https://blog.zeruns.com/tag/PalWorld/) - 睿登RD6012P数控可调电源简单开箱评测，60V 12A数控直流电源：[https://blog.zeruns.com/archives/740.html](https://blog.zeruns.com/archives/740.html) - 3D打印机拓竹A1 Combo 开箱体验：[https://blog.zeruns.com/archives/754.html](https://blog.zeruns.com/archives/754.html) - 不同品牌和种类的电容与电感实测对比（D值、Q值、ESR、X）：[https://blog.zeruns.com/archives/765.html](https://blog.zeruns.com/archives/765.html)