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_U8G2

I2C相关接口

由于使用了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初始化时的iddisp = 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 Pin	ESP8266 Pin
D0	GPIO16
D1	GPIO5
D2	GPIO4
D3	GPIO0
D4	GPIO2
D5	GPIO14
…	…

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

OLED模块	NodeMCU Pin	ESP8266
VCC(带3.3V稳压)	VCC(3.3V或5V)	VCC
GND	GND	GND
SCL	D6	GPIO12
SDA	D5	GPIO14

注：

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 Pin	NodeMCU Pin	ESP8266
VCC	3.3V	VCC
GND	GND	GND
DATA	D4	GPIO2

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

代码如下：

    -- 管脚定义local sda = 5 -- GPIO14local scl = 6 -- GPIO12local 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")-- 将内容发送到oleddisp:sendBuffer()end-- 主函数function main()init_oled()oled_show_msg()end-- 运行程序main()

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

实际显示效果：

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

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