LuatOS-SOC接口文档(air780E)--lcd - lcd驱动模块

常量

lcd.init(tp, args)

lcd显示屏初始化

参数

返回值

无

例子

-- 初始化spi0的st7735s 注意:lcd初始化之前需要先初始化spi
spi_lcd = spi.deviceSetup(0,20,0,0,8,2000000,spi.MSB,1,1)
log.info("lcd.init",
lcd.init("st7735s",{port = "device",pin_dc = 17, pin_pwr = 7,pin_rst = 19,direction = 2,w = 160,h = 80,xoffset = 1,yoffset = 26},spi_lcd))

---

lcd.close()

关闭lcd显示屏

参数

无

返回值

无

例子

-- 关闭lcd
lcd.close()

---

lcd.on()

开启lcd显示屏背光

参数

无

返回值

无

例子

-- 开启lcd显示屏背光
lcd.on()

---

lcd.off()

关闭lcd显示屏背光

参数

无

返回值

无

例子

-- 关闭lcd显示屏背光
lcd.off()

---

lcd.sleep()

lcd睡眠

参数

无

返回值

无

例子

-- lcd睡眠
lcd.sleep()

---

lcd.wakeup()

lcd唤醒

参数

无

返回值

无

例子

-- lcd唤醒
lcd.wakeup()

---

lcd.invon()

lcd反显

参数

无

返回值

无

例子

-- lcd反显
lcd.invon()

---

lcd.invoff()

lcd反显关闭

参数

无

返回值

无

例子

-- lcd反显关闭
lcd.invoff()

---

lcd.cmd(cmd)

lcd命令

参数

返回值

无

例子

-- lcd命令
lcd.cmd(0x21)

---

lcd.data(data)

lcd数据

参数

返回值

无

例子

-- lcd数据
lcd.data(0x21)

---

lcd.setColor(back,fore)

lcd颜色设置

参数

返回值

无

例子

-- lcd颜色设置
lcd.setColor(0xFFFF,0x0000)

---

lcd.draw(x1, y1, x2, y2,color)

lcd颜色填充

参数

返回值

无

例子

-- lcd颜色填充
local buff = zbuff.create({201,1,16},0x001F)
lcd.draw(20,30,220,30,buff)

---

lcd.clear(color)

lcd清屏

参数

返回值

无

例子

-- lcd清屏
lcd.clear()

---

lcd.fill(x1, y1, x2, y2,color)

lcd颜色填充

参数

返回值

无

例子

-- lcd颜色填充
lcd.fill(20,30,220,30,0x0000)

---

lcd.drawPoint(x0,y0,color)

画一个点.

参数

返回值

无

例子

lcd.drawPoint(20,30,0x001F)

---

lcd.drawLine(x0,y0,x1,y1,color)

在两点之间画一条线.

参数

返回值

无

例子

lcd.drawLine(20,30,220,30,0x001F)

---

lcd.drawRectangle(x0,y0,x1,y1,color)

从x / y位置（左上边缘）开始绘制一个框

参数

返回值

无

例子

lcd.drawRectangle(20,40,220,80,0x001F)

---

lcd.drawCircle(x0,y0,r,color)

从x / y位置（圆心）开始绘制一个圆

参数

返回值

无

例子

lcd.drawCircle(120,120,20,0x001F)

---

lcd.drawQrcode(x, y, str, size)

缓冲区绘制QRCode

参数

返回值

例子

无

---

lcd.setFont(font)

设置字体

参数

返回值

无

例子

-- 设置为字体,对之后的drawStr有效,调用lcd.drawStr前一定要先设置

-- 若提示 "only font pointer is allow" , 则代表当前固件不含对应字体, 可使用云编译服务免费定制
-- 云编译文档: https://wiki.luatos.com/develop/compile/Cloud_compilation.html

-- lcd库的默认字体均以 lcd.font_ 开头
lcd.setFont(lcd.font_opposansm12)
lcd.drawStr(40,10,"drawStr")
sys.wait(2000)
lcd.setFont(lcd.font_opposansm12_chinese) -- 具体取值可参考api文档的常量表
lcd.drawStr(40,40,"drawStr测试")

---

lcd.drawStr(x,y,str,fg_color)

显示字符串

参数

返回值

无

例子

-- 显示之前先设置为中文字体,对之后的drawStr有效
lcd.setFont(lcd.font_opposansm12)
lcd.drawStr(40,10,"drawStr")
sys.wait(2000)
lcd.setFont(lcd.font_opposansm16_chinese)
lcd.drawStr(40,40,"drawStr测试")

---

lcd.drawGtfontGb2312(str,size,x,y)

使用gtfont显示gb2312字符串

参数

返回值

无

例子

-- 注意, gtfont是额外的字体芯片硬件, 需要外挂在SPI总线才能调用本函数的
lcd.drawGtfontGb2312("啊啊啊",32,0,0)

---

lcd.drawGtfontGb2312Gray(str,size,gray,x,y)

使用gtfont灰度显示gb2312字符串

参数

返回值

无

例子

-- 注意, gtfont是额外的字体芯片硬件, 需要外挂在SPI总线才能调用本函数的
lcd.drawGtfontGb2312Gray("啊啊啊",32,4,0,40)

---

lcd.drawGtfontUtf8(str,size,x,y)

使用gtfont显示UTF8字符串

参数

返回值

无

例子

lcd.drawGtfontUtf8("啊啊啊",32,0,0)

---

lcd.drawGtfontUtf8Gray(str,size,gray,x,y)

使用gtfont灰度显示UTF8字符串

参数

返回值

无

例子

lcd.drawGtfontUtf8Gray("啊啊啊",32,4,0,40)

---

lcd.getSize()

获取屏幕尺寸

参数

无

返回值

例子

log.info("lcd", "size", lcd.getSize())

---

lcd.drawXbm(x, y, w, h, data)

绘制位图

参数

返回值

无

例子

-- 取模使用PCtoLCD2002软件即可 阴码 逐行 逆向
-- 在(0,0)为左上角,绘制 16x16 "今" 的位图
lcd.drawXbm(0, 0, 16,16, string.char(
    0x80,0x00,0x80,0x00,0x40,0x01,0x20,0x02,0x10,0x04,0x48,0x08,0x84,0x10,0x83,0x60,
    0x00,0x00,0xF8,0x0F,0x00,0x08,0x00,0x04,0x00,0x04,0x00,0x02,0x00,0x01,0x80,0x00
))

---

lcd.showImage(x, y, file)

显示图片,当前只支持jpg,jpeg

参数

返回值

无

例子

lcd.showImage(0,0,"/luadb/logo.jpg")

---

lcd.flush()

主动刷新数据到界面, 仅设置buff且禁用自动属性后使用

参数

无

返回值

例子

无

---

lcd.setupBuff(conf, onheap)

设置显示缓冲区, 所需内存大小为 2×宽×高 字节. 请衡量内存需求与业务所需的刷新频次.

参数

返回值

例子

-- 初始化lcd的buff缓冲区, 可理解为FrameBuffer区域.
lcd.setupBuff()

---

lcd.autoFlush(enable)

设置自动刷新, 需配合lcd.setupBuff使用

参数

返回值

无

例子

-- 设置buff 并禁用自动更新
lcd.setupBuff()
lcd.autoFlush(false)
-- 禁止自动更新后, 需要使用 lcd.flush() 主动刷新数据到屏幕

---

lcd.rgb565(r, g, b, swap)

RGB565颜色生成

参数

返回值

例子

-- 本API支持多种模式, 参数数量分别是 1, 2, 3, 4
-- 1. 单参数形式, 24bit RGB值, swap = true, 推荐
local red =   lcd.rgb565(0xFF0000)
local green = lcd.rgb565(0x00FF00)
local blue =  lcd.rgb565(0x0000FF)

-- 2. 两参数形式, 24bit RGB值, 增加swap的设置
local red =   lcd.rgb565(0xFF0000, true)
local green = lcd.rgb565(0x00FF00, true)
local blue =  lcd.rgb565(0x0000FF, true)

-- 3. 三参数形式, 红/绿/蓝, 各8bit
local red = lcd.rgb565(0xFF, 0x00, 0x00)
local green = lcd.rgb565(0x00, 0xFF, 0x00)
local blue = lcd.rgb565(0x00, 0x00, 0xFF)

-- 4. 四参数形式, 红/绿/蓝, 各8bit, 增加swap的设置
local red = lcd.rgb565(0xFF, 0x00, 0x00, true)
local green = lcd.rgb565(0x00, 0xFF, 0x00, true)
local blue = lcd.rgb565(0x00, 0x00, 0xFF, true)