lua编程入门教程：用NodeMCU在OLED上显示温湿度

OLED模块介绍

OLED显示屏是指有机电激发光二极管（Organic Light－Emitting Diode，OLED），具备自发光，所以不需背光源，对比度高，厚度薄，视角广，反应速度快等特性，被认为是下一代的平面显示器新兴应用技术。

笔者使用的是0．96寸，白色，I2C总线的OLED模块显示屏，分辨率128x64，OLED常用接口有I2C和SPI。转接板自己画的，和某宝的上购买的模块接口基本一致。模块有5V转3．3V电路，可以兼容外接3．3V和5V电压。硬件部分这里就不多说了，购买oled模块后客服都会给模块相关资料。

注： 在购买OLED模块时，要查看该模块是否被 u8g2库 所支持，只有被 u8g2库 支持的OELD屏才能使用该库。

启用I2C和OLED模块

在往期文章《 ESP8266之NodeMCU固件编译 》中，其实已经介绍了如何启用NodeMCU所支持的各种模块，启用对应的模块后，需要重新编译固件，烧录到ESP8266才能使用，一般根据自己的需求开启对应的模块，以减少固件的大小。

1）启用I2C模块，需要打开 user＿modules．h 文件中的 LUA＿USE＿MODULES＿I2C ，使用笔者之前编译的固件，默认是已经开启了。

ESP8266芯片没有硬件I2C接口，所以模块使用软件接口驱动程序。可包括GPIO16在内的任何GPIO引脚上设置。模块支持主模式，每条总线上可具有不同速度，最多10条总线。
速度标准：

慢速：100kHz；

快速：400kHz；

FastPlus：1MHz
也可设置任意时钟。GPIO16引脚可以作为SCL引脚使用，但所选的总线将被限制为不超过FAST速度。
模块不支持高速模式（3．5MHz时钟）和10位寻址方案。

2）启用OLED模块，需要打开 user＿modules．h 文件中的 LUA＿USE＿MODULES＿U8G2 ，u8g2模块 已经将常见的OLED屏驱动都写好了，源码是开源的，可上GitHub查看。模块如下：

＃define LUA＿USE＿MODULES＿I2C ＃define LUA＿USE＿MODULES＿U8G2I2C相关接口

由于使用了u8g2库，这里就只需要了解 i2c．setup（） 接口。

i2c．setup（id， pinSDA， pinSCL， speed）

参数：

id：0～9，总线编号，NodeMCU支持10个I2C总线。

pinSDA：1～12，SDA的IO口编号

pinSCL：1～12， SCL的IO口编号

speed：i2c．SLOW （100kHz）， i2c．FAST （400kHz）， i2c．FASTPLUS （1MHz）或者在25000 ～ 1000000Hz之间的任意时钟频率。FASTPLUS模式在默认80MHz的CPU频率下产生600kHz的I2C时钟速度，要得到1MHz的I2C时钟速度，要使用接口 node．setcpufreq（node．CPU160MHZ） 改变CPU频率到160MHz。

返回值：

speed：成功则返回设置的speed；失败则返回0。

想了解其他接口，可见NodeMCU官方文档。

U8G2库相关接口SSD1306驱动的初始化

使用I2C接口，调用以下代码初始化：

sla ＝ 0x3c －－ oled的I2C地址 －－ id：I2C初始化时的id disp ＝ u8g2．ssd1306＿i2c＿128x64＿noname（id， sla）

其他驱动类型的OLED初始化，见NodeMCU官方文档。

u8g2．disp：drawStr（x， y， ＊str）

x：x轴坐标

y：y轴坐标

str：要显示的字符串

u8g2．disp：sendBuffer（void）

将内存帧缓冲区的内容发送到显示器，执行该函数，OLED才会显示设置的内容。

OLED字体设置

字体设置在 app／include 目录下的 u8g2＿fonts．h 文件，需要什么字体，只需在 U8G2＿FONT＿TABLE＿ENTRY（font＿wqy16＿t＿chinese3） 后面加入对应的字体宏即可，由于全中文字库很大，编译出的固件大小将会很大，可能会导致烧录失败或者ESP8266启动不了。笔者就直接使用默认的字体了。u8g2的字体设计又是一门技术，网上也有大佬出教程，有兴趣的可以搜搜。

／／ Add a U8G2＿FONT＿TABLE＿ENTRY for each font you want to compile into the image ／／ See https：／／github．com／olikraus／u8g2／wiki／fntlistall for a complete list of ／／ available fonts． Drop the ＇u8g2＿＇ prefix when you add them here． ＃define U8G2＿FONT＿TABLE U8G2＿FONT＿TABLE＿ENTRY（font＿6x10＿tf） U8G2＿FONT＿TABLE＿ENTRY（font＿unifont＿t＿symbols） U8G2＿FONT＿TABLE＿ENTRY（font＿wqy16＿t＿chinese3）

u8g2支持的字体见u8g2官网。

点亮OLED模块

首先要搞清楚ESP8266和NodeMCU引脚之间的关系，很多新手容易搞混。ESP8266和NodeMCU对应引脚关系如下图：

对应关系，比如下表：

NodeMCU PinESP8266 PinD0GPIO16D1GPIO5D2GPIO4D3GPIO0D4GPIO2D5GPIO14……

笔者的OLED模块引出脚是4个（有的是IIC和SPI兼容模块可能是7个引脚），OLED模块和NodeMCU之间连接关系如下：

OLED模块NodeMCU PinESP8266VCC（带3．3V稳压）VCC（3．3V或5V）VCCGNDGNDGNDSCLD6GPIO12SDAD5GPIO14

注：

ESP8266单模块的VCC是3．3V的。

若OLED模块还有RES，DC，CS引脚，可按照说明在程序中控制，或直接在硬件上配置好，具体看oled模块资料。

若OLED模块不带3．3V稳压，则OLED的VCC连接到NodeMCU的3．3V引脚上，因为0．96寸OLED屏大多是3．3V电源，具体以OLED屏规格书为准。

DHT11模块和NodeMCU之间连接关系：

DHT11 PinNodeMCU PinESP8266VCC3．3VVCCGNDGNDGNDDATAD4GPIO2

先将OLED和NodeMCU开发板连接好，然后接上将usb接到电脑端，上传点亮oled的lua代码。

代码如下：

－－ 管脚定义 local sda ＝ 5 －－ GPIO14 local scl ＝ 6 －－ GPIO12 local sla ＝ 0x3c －－ oled的地址，一般为0x3c －－ 初始化 function init＿oled（） －－ iic总线 和 oled初始化 i2c．setup（0， sda， scl， i2c．SLOW） disp ＝ u8g2．ssd1306＿i2c＿128x64＿noname（0， sla） －－ 设置字体 disp：setFont（u8g2．font＿unifont＿t＿symbols） disp：setFontRefHeightExtendedText（） －－disp：setDrawColor（1） disp：setFontPosTop（） －－disp：setFontDirection（0） －－ 画边框 －－disp：drawFrame（0， 0， 128， 64） end －－ 显示函数 function oled＿show＿msg（） －－ 设置显示内容 disp：drawStr（0， 0， ＂1 Hello OLED＂） disp：drawStr（0， 16， ＂2234567890ABCDEF＂） disp：drawStr（0， 32， ＂3234567890ABCDEF＂） disp：drawStr（0， 48， ＂4234567890ABCDEF＂） －－ 将内容发送到oled disp：sendBuffer（） end －－ 主函数 function main（） init＿oled（） oled＿show＿msg（） end －－ 运行程序 main（）

将代码保存到 oled．lua 文件，通过 ESPlorer工具 上传到ESP8266模块，刷新ESPlorer文件列表，点击 oled．lua 就可以看到oled屏显示信息了。如下图：

实际显示效果：

将温湿度动态的显示在OLED上

温湿度模块使用的是DHT11模块，关于DHT11模块的使用，之前写过一篇文章。这里就直接使用了

审核编辑：符乾江