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屏显示信息了。如下图：