开关(Switch)示例代码functionevent_handler(obj,event)ifevent==lvgl.EVENT_VALUE_CHANGEDthenprint("State",lvgl.switch_get_state(obj))endendsw1=lvgl.switch_create(lvgl.scr_act(),nil)lvgl.obj_align(sw1,nil,lvgl.

窗口(Window)分享导出pdf示例代码win=lvgl.win_create(lvgl.scr_act(),nil)lvgl.win_set_title(win,"Windowtitle")--close_btn=lvgl.win_add_btn_right(win,"\xef\x80\x8d")----lvgl.obj_set_event_cb(close_btn,lvgl.win_clos

加载器(Spinner)示例代码spinner=lvgl.spinner_create(lvgl.scr_act(),nil)lvgl.obj_set_size(spinner,100,100)lvgl.obj_align(spinner,nil,lvgl.ALIGN_CENTER,0,0)创建通过lvgl.spinner_create就可创建一个加载器，本身自带动画效果。spinner=lvgl

微调框(Spinbox)微调框用于数值调整，有时候我们希望获取一个用户输入的数值，但是又不希望弹出键盘，可以使用微调框。示例代码--回调函数functionspinbox_increment_event_cb(obj,event)ifevent==lvgl.EVENT_SHORT_CLICKEDthenlvgl.spinbox_increment(spinbox)endendfunctionspi

页面(Page)当控件内容过多，无法在屏幕内完整显示时，可让其在页面内显示。示例代码page=lvgl.page_create(lvgl.scr_act(),nil)lvgl.obj_set_size(page,150,200)lvgl.obj_align(page,nil,lvgl.ALIGN_CENTER,0,0)label=lvgl.label_create(page,nil)lvgl.la

滑动条(Slider)滑动条看起来和进度条是有些是有些像，但不同的是滑动条可以进行数值选择。示例代码--回调函数slider_event_cb=function(obj,event)ifevent==lvgl.EVENT_VALUE_CHANGEDthenlocalval=(lvgl.slider_get_value(obj)or"0").."%"lvgl.label_set_text(slide

页面(Page)当控件内容过多，无法在屏幕内完整显示时，可让其在页面内显示。示例代码page=lvgl.page_create(lvgl.scr_act(),nil)lvgl.obj_set_size(page,150,200)lvgl.obj_align(page,nil,lvgl.ALIGN_CENTER,0,0)label=lvgl.label_create(page,nil)lvgl.la

滑动条(Slider)滑动条看起来和进度条是有些是有些像，但不同的是滑动条可以进行数值选择。示例代码--回调函数slider_event_cb=function(obj,event)ifevent==lvgl.EVENT_VALUE_CHANGEDthenlocalval=(lvgl.slider_get_value(obj)or"0").."%"lvgl.label_set_text(slide

示例代码--创建图片控件img=lvgl.img_create(lvgl.scr_act(),nil)--设置图片显示的图像lvgl.img_set_src(img,"/lua/luatos.png")

标签(Label)标签是LVGL用来显示文字的控件。示例代码label=lvgl.label_create(lvgl.scr_act(),nil)lvgl.label_set_recolor(label,true)lvgl.label_set_text(label,"#0000ffRe-color##ff00ffwords##ff0000of\n#alignthelinesto\nthecente

键盘(Keyboard)LVGL可以添加触摸键盘，但是很明显，使用触摸键盘的话必须要使用触摸的输入方式，否则无法驱动键盘。示例代码functionkeyCb(obj,e)--默认处理事件lvgl.keyboard_def_event_cb(keyBoard,e)if(e==lvgl.EVENT_CANCEL)thenlvgl.keyboard_set_textarea(keyBoard,nil)-

下拉框(Dropdown)在显示选项过多时，可以通过下拉框收起多余选项。只为用户展示列表中的一项。示例代码--回调函数event_handler=function(obj,event)if(event==lvgl.EVENT_VALUE_CHANGED)thenprint("Option:",lvgl.dropdown_get_symbol(obj))endend--创建下拉框dd=lvgl.dr

LuatOSRC522官方示例官方示例没有针对具体开发板，现以ESP32C3开发板为例。选用的RC522模块ESP32C3-CORE开发板注意ESP32C3的SPI引脚位置，SPI的id=2示例代码--LuaTools需要PROJECT和VERSION这两个信息PROJECT="helloworld"VERSION="1.0.0"--引入必要的库文件(lua编写),内部库不需要requiresys

编写了字符串转16进制表函数--将字符串转换为十六进制表localfunctionstringToHexTable(str)localhexTable={}localmaxLength=16--最大长度为16个元素--将字符串转换为十六进制fori=1,#strdoifi>maxLengththenbreakendlocalhex=string.format("0x%02X",string.byt

NDK开发官方教程官方例程API下载软件下载官方NDK例程压缩包到本地，并解压。可以看到目录如下：doc:文档教程env:编译环境example:NDK示例platform:需要编译的平台（air72x/air8xx）tools:其他辅助软件VSCode使用VSCode打开NDK文件夹，并可以在VSCode中进行代码的编写和编译。编译打开终端，并进入到example/helloworld/c目录下

图表(Chart)一幅图胜过一千个字，通过图表展示出的数据内容能让用户更快速有效的了解数据特征。代码示例–创建图表chart=lvgl.chart_create(lvgl.scr_act(),nil)lvgl.obj_set_size(chart,200,150)lvgl.obj_align(chart,nil,lvgl.ALIGN_CENTER,0,0)–设置Chart的显示模式(折线图)lvg

容器(Container)容器是lvgl相当重要的一个控件了，可以设置布局，容器的大小也会自动进行调整，利用容器可以创建出自适应成都很高的界面布局。代码示例–创建容器cont=lvgl.cont_create(lvgl.scr_act(),nil)lvgl.obj_set_auto_realign(cont,true)lvgl.obj_align(cont,nil,lvgl.ALIGN_CENTE

复选框(Checkbox)复选框主要是让用户进行一些内容选择，或者同意用户协议。示例代码–复选框回调函数functionevent_handler(obj,event)ifevent==lvgl.EVENT_VALUE_CHANGEDthenprint(“State”,lvgl.checkbox_is_checked(obj))endend–创建复选框cb=lvgl.checkbox_create

进度条(Bar)Bar是进度条，可以用来显示数值，加载进度。示例代码–创建进度条bar=lvgl.bar_create(lvgl.scr_act(),nil)–设置尺寸lvgl.obj_set_size(bar,200,20);–设置位置居中lvgl.obj_align(bar,NULL,lvgl.ALIGN_CENTER,0,0)–设置加载完成时间lvgl.bar_set_anim_time(b

日历(Calendar)LVGL提供了一个用来选择和显示当前日期的日历控件。示例代码–高亮显示的日期highlightDate=lvgl.calendar_date_t()–日历点击的回调函数–将点击日期设置高亮functionevent_handler(obj,event)ifevent==lvgl.EVENT_VALUE_CHANGEDthendate=lvgl.calendar_get_pr

按钮(Button)按钮控件，这个就不用多说了，界面的基础控件之一。示例代码–按键回调函数event_handler=function(obj,event)ifevent==lvgl.EVENT_CLICKEDthenprint(“Clicked\n”)elseifevent==lvgl.EVENT_VALUE_CHANGEDthenprint(“Toggled\n”)endend–按键1btn1

曲线(Arc)曲线控件，也可以称为弧。因为Arc本身就是弧，弧形的意思。根据控件的样子也能推测出它的使用场景，一般用在加载器(就是等待界面转的圈圈)或者数值显示，数值调节这些场景。曲线控件分了两个部分，前景和背景，都可以分别进行设置。示例代码–创建曲线arc=lvgl.arc_create(lvgl.scr_act(),nil)–设置尺寸lvgl.obj_set_size(arc,150,150)

概念在LVGL中，用户界面的基本构建块是对象。例如，按钮，标签，图像，列表，图表或文本区域。属性基本属性所有对象类型都共享一些基本属性：Position(位置)Size(尺寸)Parent(父母)Clickenable(单击启用)我们可以使用lvgl.obj_set_…和lvgl.obj_get_…等前缀的函数设置或者获取这些属性。例如：–设置基础对象的属性lvgl.obj_set_size(bt

术语英文解释说明arc曲线曲线控件bar进度条进度条控件button按钮按钮控件calendar日历日历控件checkbox复选框复选框控件container容器容器控件chart图表图表控件dropdown下拉框下拉框控件imagebutton图片按钮图片按钮控件keyboard键盘键盘控件label标签标签控件list列表列表控件image图片图片控件page页面页面控件slider滑动条滑动

硬件准备可以使用724A13开发板+ST7735S屏幕或者iCool开发板软件准备底层固件底层固件需要支持LVGL，通常选用的固件是LuatOS-Air_VXXXX_RDA8910_BT_FLOAT.pac

对象概念在LVGL中，用户界面的基本构建块是对象。例如，按钮，标签，图像，列表，图表或文本区域。属性基本属性所有对象类型都共享一些基本属性：Position(位置)Size(尺寸)Parent(父母)Clickenable(单击启用)我们可以使用lvgl.obj_set_…和lvgl.obj_get_…等前缀的函数设置或者获取这些属性。例如：–设置基础对象的属性lvgl.obj_set_size(

为何是LVGLLVGL是一个开源的图形库，它提供了创建嵌入式GUI所需的一切，具有易于使用的图形元素、漂亮的视觉效果和低内存占用的特点。LVGL特点：强大的控件：按钮、图表、列表、滑动条、图像等高级图形引擎：动画、抗锯齿、不透明、平滑滚动、混合模式等支持各种输入设备：触摸屏、鼠标、键盘、编码器、按钮等支持多个显示器硬件独立，可与任何微控制器和显示器一起使用可扩展，可在小内存下操作（64kBROM，

一、LuatOS-HMI项目演示演示视频通过演示视频了解LuatOS-HMI的实际应用，以及模块支持的功能，以及实际效果下图视频演示包括5个示例，LVGL便捷UI设计，中控仪表盘，农业大棚可视化DTU，

合宙在9月初首发推出MCU产品线Air101系列，搭载LuatOS开发助力快速量产，在业界引发广泛反响。

合宙LuatOS公网对讲机方案，开发周期可比同行业缩短60%，软件业务逻辑完全开源，具备极好的

搭载LuatOS-iRTU软件解决方案的DTU，不仅仅是一种传统DTU，更是一种"硬件成本大幅降低、业务功能扩充方便、脚本源码免费开放"的系统级主控DTU。合宙DTU-S401核心板，全新来袭！

物联网技术的发展激发了HMI（人机交互）应用市场的广泛需求，然而项目的落地仍面临着软硬件开发、成本投入及运维管理等层层考验，合宙LuatOS-HMI系列方案带来全新可能。

合宙LuatOS-iRTU以强大功能及开源特性得到广泛应用，经过百万级装机设备的验证，目前系统日均访问量超60W。今天将和大家简要分享LuatOS-iRTU功能特色及应用优势。

TableofContentswifiScanwifiScan.request(cbFnc,timeout)wifiScan模块功能：wifi扫描功能支持wifi热点扫描wifiScan.request(cbFnc,timeout)wifi扫描热点请求参数名称传入值类型释义cbFncfunction扫描到热点返回或者超时未返回的回调函数，回调函数的调用形式为：cbFnc(result,cnt,in

wifiRilTableofContentswifiRilwifiRil.regRsp(head,fnc,typ,formt)wifiRil.regUrc(prefix,handler)wifiRil.deRegUrc(prefix)wifiRil.request(cmd,arg,onrsp,delay,param)wifiRil模块功能：esp8266wifi模块AT命令交互管理wifiRil.

websocketTableofContentswebsocketwebsocket.new(url,cert)ws:on(event,callback)ws:connect(timeout)ws:sendFrame(fin,opcode,data)ws:recv()ws:close(code,reason)websocket.exit(ws)ws:state()ws:online()ws:sta

TableofContentsuiWinuiWin.add(wnd)uiWin.remove(winId)uiWin.isActive(winId)uiWin模块功能：UI窗口管理uiWin.add(wnd)新增一个窗口参数名称传入值类型释义wndtable窗口的元素以及消息处理函数表返回值number，窗口ID例子uiWin.add({onUpdate=refresh})示例参考：示例uiWin

TableofContentsupdateupdate.request(cbFnc,url,period,redir)update.setDownloadProcessCbFnc(cbFnc)update.getUpdateMsg()update模块功能：远程升级.update.request(cbFnc,url,period,redir)启动远程升级功能参数名称传入值类型释义cbFncfunct

utilsTableofContentsutilsstring.toHex(str,separator)string.fromHex(hex)string.utf8Len(str)string.utf8ToTable(str)string.rawurlEncode(str)string.urlEncode(str)table.gsort(t,f)table.rconcat(l)string.for

Air001基于Keil环境点灯和调试输出工程配置官方环境搭建教程介绍：https://wiki.luatos.com/chips/air001/Air001-MDK.html本人使用的是基于HAL库环境搭建的

socket4GTableofContentssocket4Gsocket4G.tcp(ssl,cert,tCoreExtPara)socket4G.udp()mt:connect(address,port,timeout)mt:asyncSelect(keepAlive,pingreq)mt:asyncSend(data,timeout)mt:asyncRecv()mt:send(data,ti

Air001基于Arduino点灯实验Arduino平台环境搭建可以参考：https://wiki.luatos.com/chips/air001/Air001-Arduino.html使用国内的json

recordTableofContentsrecordrecord.start(seconds,cbFnc,type,quality,rcdType,format,streamRptLen)record.stop(cbFnc)record.getFilePath()record.getData(offset,len)record.getSize()record.delete()record.exi

pins模块功能：GPIO功能配置，包括输入输出IO和上升下降沿中断IOpins.setup(pin,val,pull)配置GPIO模式参数名称传入值类型释义pinnumberGPIO，IDGPIO0到GPIO31表示为pio.P0_0到pio.P0_31GPIO32到GPIOXX表示为pio.P1_0到pio.P1_(XX-32)，例如GPIO33表示为pio.P1_1GPIO64到GPIOXX

powerKeyTableofContentspowerKeypowerKey.setup(longPrd,longCb,shortCb)powerKey模块功能：开机键功能配置powerKey.setup(longPrd,longCb,shortCb)配置开机键长按弹起和短按弹起的功能.如何定义长按键和短按键，例如长按键判断时长为3秒：按下大于等于3秒再弹起判定为长按键；按下后，在3秒内弹起，判

rilTableofContentsrilril.regRsp(head,fnc,typ,formt)ril.regUrc(prefix,handler)ril.deRegUrc(prefix)ril.request(cmd,arg,onrsp,delay)ril模块功能：虚拟串口AT命令交互管理ril.regRsp(head,fnc,typ,formt)注册某个AT命令应答的处理函数参数名称传入

pbpb.setStorage(storage,cb)pb.read(index,cb)pb.write(index,name,num,cb)pb.delete(index,cb)pb模块功能：电话簿管理pb.setStorage(storage,cb)设置电话本存储区域参数名称传入值类型释义storagestring存储区域字符串，仅支持"SM"cbparam设置后的回调函数回调方式为cb(re

ntpTableofContentsntpntp.timeSync(period,fnc,fun)ntp模块功能：网络授时.重要提醒！！！！！！本功能模块采用多个免费公共的NTP服务器来同步时间并不能保证任何时间任何地点都能百分百同步到正确的时间所以，如果用户项目中的业务逻辑严格依赖于时间同步功能则不要使用使用本功能模块，建议使用自己的应用服务器来同步时间参考http://ask.openluat

nvmTableofContentsnvmnvm.init(defaultCfgFile,burnSave)nvm.set(k,v,r,s)nvm.sett(k,kk,v,r,s)nvm.flush()nvm.get(k)nvm.gett(k,kk)nvm.restore()nvm.remove()nvm模块功能：参数管理nvm.init(defaultCfgFile,burnSave)初始化参数

patchTableofContentspatchpatch.safeJsonDecode(s)(local函数无法被外部调用)patch模块功能：Lua补丁patch.safeJsonDecode(s)(local函数无法被外部调用)封装自定义的json.decode接口参数名称传入值类型释义sstringjson格式的字符串返回值table,第一个返回值为解析json字符串后的tableboo