非常详细的51单片机引脚介绍
单片机&嵌入式
单片机应用
嵌入式操作系统
学习工具&教程
学习和开发单片机的必备工具
(有问必答)
(带你轻松入门)
电子元件&电路模块
当前位置： >>
>> 浏览文章
非常详细的51单片机引脚介绍
AT89C2051是精简版的51单片机，精简掉了P0口和P2口，只有20引脚，但其内部集成了一个很实用的模拟比较器，特别适合开发精简的51应用系统，毕竟很多时候我们开发简单的产品时用不了全部32个I/O口，用AT89C2051更合适，芯片体积更小，而且AT89C2051的工作电压最低为2.7V，因此可以用来开发两节5号电池供电的便携式产品。
本文以ATMEL公司生产的51系列家族的AT89S51和AT89C2051两种单片机来讲解，两种单片机是目前最常用的单片机，其中AT89S51为标准51单片机，当然其功能比早期的51单片机更强大，支持ISP在系统编程技术，内置硬件看门狗。。。一、AT89S51单片机引脚介绍AT89S51有PDIP、PLCC、TQFP三种封装方式，其中最常见的就是采用40Pin封装的双列直接PDIP封装，外形结构下图。
芯片共有40个引脚，引脚的排列顺序为从靠芯片的缺口（见右图）左边那列引脚逆时针数起，依次为1、2、3、4。。。40，其中芯片的1脚顶上有个凹点（见右图）。在单片机的40个引脚中，电源引脚2根，外接晶体振荡器引脚2根，控制引脚4根以及4组8位可编程I/O引脚32根。1、主电源引脚（2根）VCC(Pin40)：电源输入，接＋5V电源GND(Pin20)：接地线2、外接晶振引脚（2根）XTAL1(Pin19)：片内振荡电路的输入端XTAL2(Pin20)：片内振荡电路的输出端3、控制引脚（4根）RST/VPP(Pin9)：复位引脚，引脚上出现2个机器周期的高电平将使单片机复位。ALE/PROG(Pin30)：地址锁存允许信号PSEN(Pin29)：外部存储器读选通信号EA/VPP(Pin31)：程序存储器的内外部选通，接低电平从外部程序存储器读指令，如果接高电平则从内部程序存储器读指令。
芯片实物图片
芯片引脚功能
4、可编程输入/输出引脚（32根） AT89S51单片机有4组8位的可编程I/O口，分别位P0、P1、P2、P3口，每个口有8位（8根引脚），共32根。每一根引脚都可以编程，比如用来控制电机、交通灯、霓虹灯等，开发产品时就是利用这些可编程引脚来实现我们想要的功能，尽情发挥你的想象力吧，实现你想要的：） 强大无比。。。 PO口（Pin39～Pin32）：8位双向I/O口线，名称为P0.0～P0.7 P1口（Pin1～Pin8）：8位准双向I/O口线，名称为P1.0～P1.7
P2口（Pin21～Pin28）：8位准双向I/O口线，名称为P2.0～P2.7
P3口（Pin10～Pin17）：8位准双向I/O口线，名称为P3.0～P3.7上面就是AT89S51单片机引脚的简单介绍，其它51系列家族的单片机、89C51等引脚和89S51兼容，只是个别引脚功能定义不同。二、AT89C2051单片机引脚介绍AT89C2051为20引脚小型封装，2K内部程序存储器，15个可编程I/O口线，没有P0口和P2口的16根I/O线，内部集成了一个模拟比较器。AT89C2051单片机的引脚排列如下图所示。
芯片实物图片
芯片引脚功能
芯片共有20个引脚，引脚的排列顺序为从靠芯片的缺口（见上图）左边那列引脚逆时针数起，依次为1、2、3。。。20，在单片机的20个引脚中，电源引脚2根，外接晶体振荡器引脚2根，复位引脚1根以及P1、P3口可编程I/O引脚15根。1、主电源引脚（2根） VCC(Pin20)：电源输入，接＋5V电源 GND(Pin10)：接地线2、外接晶振引脚（2根） XTAL1(Pin5)：片内振荡电路的输入端 XTAL2(Pin4)：片内振荡电路的输出端3、控制引脚（1根） RST/VPP(Pin1)：复位引脚，引脚上出现2个机器周期的高电平将使单片机复位。4、可编程输入/输出引脚（15根） P1口： 8位准双向I/O口线，P1.0～P1.7 ，共8根
P3口： 8位准双向I/O口线，P3.0～P3.5、P3.7，共7根
聪明的你一定会发现：标准51单片机有32根可编程I/O口线，89C2051精简掉P0、P2口16根I/O线后，应该还有16根I/O口线，现在只有15根，另一根跑那里去了呢？！前面讲到AT89C2051内部集成了一个模拟比较器，正是因为集成了模拟比较器把另一根引线占用了，比较器的输出端占用了一个I/O口，它就是P3.6口，引脚P3.6没有接出来的，所以少一根I/O口线。在编程时，P3.6就只能用来读比较器的状态了，不能象其它I/O口一样用来驱动外部指示灯等设备了，不过模拟比较器很实用的，在开发中就可以省去外加比较器的麻烦，右图为比较器的原理。
三、主要性能参数介绍
·与MCS-51产品指令系统完全兼容·4k字节在系统编程（ISP）Flash闪速存储器·1000次擦写周期·4.0－5.5V的工作电压范围·全静态工作模式：0Hz－33MHz·三级程序加密锁·128×8字节内部RAM·32个可编程I／O口线·2个16位定时／计数器·6个中断源·全双工串行UART通道·低功耗空闲和掉电模式·中断可从空闲模唤醒系统·看门狗（WDT）及双数据指针·掉电标识和快速编程特性·灵活的在系统编程（ISP字节或页写模式）
·与MCS-51产品指令系统完全兼容·2k字节可重擦写闪速存储器·1000次擦写周期·2.7V－6V的工作电压范围·全静态操作：0Hz－24MHz·两级加密程序存储器·128×8字节内部RAM·15个可编程I／O口线·2个l6位定时／计数器·6个中断源·可编程串行UART通道·可直接驱动LED的输出端口 ·内置一个模拟比较器·低功耗空闲和掉电模式
【】【】【】【】
上一篇:下一篇:
CopyRight @
单片机教程网 51hei.com , All Rights ReservedNODEMCU-DEVKIT中文_百度文库
两大类热门资源免费畅读
续费一年阅读会员，立省24元！
NODEMCU-DEVKIT中文
阅读已结束，下载本文需要
想免费下载本文？
定制HR最喜欢的简历
你可能喜欢nodeMcu 中文API说明
nodeMcu API说明&###version 0.9.5 build ##索引&###node 模块&--deprecated&--deprecated&--deprecated, moved to adc.readvdd33()&--Added on 07/04/2015###file 模块###wifi 模块&--Added on 06/16/2015&--Added on 06/16/2015&--Added on 06/16/2015###wifi.sta 子模块&--Added on 06/16/2015&--Updated on 06/16/2015&--Updated on 06/16/2015&--Updated on 06/16/2015&--Updated on 06/16/2015###wifi.ap 子模块&--Updated on 06/16/2015###timer 模块###gpio 模块###pwm 模块###net 模块###net.server 子模块###net.socket 子模块###i2c 模块###adc 模块###uart 模块###1-wire 模块###bit 模块###spi 模块###mqtt 模块###mqtt.client 子模块###WS2812 模块###cjson 模块###crypto 模块###u8g 模块###u8g.disp 子模块###dht 模块-###变更日志: 修改uart.on接口，如果run_input 设置为 0, 串口能读取二进制数据.串口输入现在能输入非ascii字符了.修正开发板对应的引脚定义增加 setip, setmac, sleeptype 接口.&增加 tmr.time() 接口修正uart readline 的bug.升级到 sdk 0.9.4开源重要&根据开发板重新定义GPIO引脚索引号。增加位操作模块。修改net.socket:connect() 接口，接受域名作为参数，自动DNS。修改wifi.xx.getip() 当ip为0.0.0.0时，返回nil，否则返回IP。修正uart.setup(), 当引脚被设置为其他用途时，可以恢复uart功能。增加wifi.sta.status() 接口，获取sta模式的当前状态。&修改tmr.now() 返回值为uint31，uint32 返回到lua会出现负值。增加tmr.alarm 的个数到7个增加uart.setup(), uart.write() 接口。增加ow（1-wire）接口，来自arduino，接口相似。增加一个18b20的示例.修改net.socket.send() 的payload最大值，由256改为1460.修改gpio.mode() 接口，增加内部上拉参数选项。修正串口输入lua时，存在的内存泄漏问题。修正作为server时，内存恢复很慢的问题。恢复速度从几分钟到几秒钟。修改file.open的返回值，打开失败返回nil，成功返回true。修改开机版本号显示顺序，在执行init.lua之前显示版本号。修改wifi.ap.config()，成功后不自动重启。修改pwm的最大频率为1000。修改pwm的占空比最大为1023。增加uart模块，提供uart.on(&data&)接口从串口接收数据。修正tmr.delay小于1s无效的问题。修正PWM模块频率小于77Hz无法工作问题。修正dns接口内存泄露问题。修正配置wifi长密码问题，密码最大64字节，ssid最大32字节。修正dns问题，wiki里增加了dns的简单例子。修正重启问题，短暂的解决方案：在tcp server状态下，如果系统内存不足，将不接受来自客户端的连接。修改file.list() ，不再直接在串口输出，只返回一个table。修正tmr.delay，支持2s以上的延时，但是长延时可能会引起beacon timer out，导致与AP之间重新连接。增加tmr.wdclr()，用来重置看门狗计数器，用在长循环中，以防芯片因看门狗重启。修正net模块UDP无法连接问题。createServer(net.TCP, timeout)函数增加连接超时参数设置。增加adc模块，adc.read(0)读取adc的值。wifi模块增加wifi.sta.getap() 函数，用于获取ap列表。修正tcp服务器不能使用:close()函数关闭tcp连接的问题。tcp服务器: 服务器将关闭30s内未使用的闲置的连接。（修正前为180s）增加了函数node.input()用来向lua解释器输入lua代码段, 支持多行输入。增加了函数node.ouput(function)用来将串口输出重定向于回调函数。file.readline()函数返回值包含了EOL'\n', 当读到EOF时，返回nil。全功能版本固件文件模块中增加了file.seek()函数。最多支持6个PWM输出。log模块更名为file模块文件操作支持多次读写。当前仅支持打开一个文件进行操作。node模块中删除了log函数。增加了log模块。修改wifi模块的函数。修改了node.key长按与短按的默认回调函数。只有当按钮被松开后，key才会被触发。###flash 错误 注意：有些模块在烧写之后启动，串口输出 ERROR in flash_read: r=。。。这是因为模块原来的flash内部没有擦除。可使用blank512k.bin，内容为全0xFF，从0x00000开始烧入。烧入之后可以正常运行。概述快速、自动连接无线路由器基于Lua 5.1.4，使用者需了解最简单的Lua语法采用事件驱动的编程模型内置file, timer, pwm, i2c, net, gpio, wifi, uart, adc模块串口波特率:对模块的引脚进行编号；gpio，i2c，pwm等模块需要使用引脚编号进行索引目前的编号对应表格:##新Gpio索引 (及以后的版本采用)IO indexESP8266 pinIO indexESP8266 pin0 [*]GPIO168GPIO151GPIO59GPIO32GPIO410GPIO13GPIO011GPIO94GPIO212GPIO105GPIO146GPIO127GPIO13#### [*] D0(GPIO16) 只能用作gpio读写，不支持中断，i2c/pwm/ow##旧Gpio索引 (及以前的版本采用)IO indexESP8266 pinIO indexESP8266 pin0GPIO128GPIO01GPIO139GPIO22GPIO1410GPIO43GPIO1511GPIO54GPIO35GPIO16GPIO97GPIO10#固件烧写 ###地址 nodemcu_512k.bin: 0x00000参考 NodeMCU flash tool:#node模块node.restart()####描述 重新启动####语法node.restart()####参数 nil####返回值 nil####示例&&&&node.restart();####参见&-node.dsleep()####描述进入睡眠模式，计时时间之后唤醒####语法node.dsleep(us)-注意:&如需使用此功能，需要将esp8266的PIN32(RST)和PIN8(XPD_DCDC)短接。####参数 us: 睡眠时间，单位：us####返回值 nil####示例&&&&node.dsleep(us);####参见&-node.info()####描述 返回NodeMCU版本信息, 包括：chipid, flashid, flash size, flash mode, flash speed.####语法 node.info()####参数nil####返回值majorVer&(number)minorVer&(number)devVer&(number)chipid&(number)flashid&(number)flashsize&(number)flashmode&(number)flashspeed&(number)####示例&&&&majorVer,&minorVer,&devVer,&chipid,&flashid,&flashsize,&flashmode,&flashspeed&=&node.info();&&&&print(&NodeMCU&&..majorVer..&.&..minorVer..&.&..devVer)####参见&-node.chipid()####描述 返回芯片ID####语法 node.chipid()####参数 nil####返回值 number:芯片ID####示例&&&&id&=&node.chipid();####参见&-node.flashid()####描述 返回flashid####语法 node.flashid()####参数 nil####返回值 number:flash ID####示例&&&&flashid&=&node.flashid();####参见&-node.heap()####描述 返回当前系统剩余内存大小，单位：字节####语法 node.heap()####参数 nil####返回值 number: 系统剩余内存字节数####示例&&&&heap_size&=&node.heap();####参见&-node.key()####描述 定义按键的功能函数, 按键与GPIO16相连。####语法 node.key(type, function())####参数 type: type取字符串&long&或者&short&. long:按下按键持续3s以上, short: 短按按键(时间短于3s)function(): 用户自定义的按键回调函数。 如果为nil, 则取消用户定义的回调函数。默认函数：long：改变LED闪烁频率，short：重新启动。####返回值 nil####示例&&&&node.key(&long&,&function()&print('hello&world')&end)####参见&-node.led()####描述 设置LED的亮/暗时间, LED连接到GPIO16, 与node.key()复用。####语法 node.led(low, high)####参数 Low: LED关闭时间，如设置为0，则LED处于常亮状态。单位：毫秒，时间分辨率：80100msHigh: LED打开时间，单位：毫秒，时间分辨率：80100ms####返回值 nil####示例&&&&--&LED常亮.
&&&&node.led(0);####参见&-node.input()####描述 接收字符串并将字符串传入lua解释器。功能同pcall(loadstring(str))，增加了支持多行输入的功能。####语法 node.input(str)####参数 str: Lua代码段####返回值 nil####示例&&&&--&注意：该函数不支持在命令行中使用。
&&&&sk:on(&receive&,&function(conn,&payload)&node.input(payload)&end)####参见&-node.output()####描述 将lua解释器输出重定向于回调函数。####语法 node.output(function(str), serial_debug)####参数 function(str): 接收lua解释器输出的str作为输入，可以将该输出通过socket发送。serial_debug: 1：将输出送至串口； 0：输出不送至串口####返回值 nil####示例&&&&function&tonet(str)
&&&&&&sk:send(str)&&&&&&--&print(str)&错误!!!&千万不要在此函数中再使用print函数
&&&&&&--&因为这样会导致函数的嵌套调用！！
&&&&node.ouput(tonet,&1)&&--&serial&also&get&the&lua&output.####参见&-node.readvdd33()####描述 读取vdd33管脚电压.####语法 node.readvdd33()####参数 nil####返回值 电压数值，单位：毫伏.####示例&&&&print(node.readvdd33())output3345&&&&v&=&node.readvdd33()&/&1000
&&&&print(v)
&&&&v=niloutput3.315####参见&-node.compile()####描述 将.lua文本文件编译为字节码文件，并保存为.lc文件.####语法 node.compile(&file.lua&)####参数 字符串：lua文件名.####返回值 nil####示例&&file.open(&hello.lua&,&w+&)
&&file.writeline([[print(&hello&nodemcu&)]])
&&file.writeline([[print(node.heap())]])
&&file.close()
&&node.compile(&hello.lua&)&&dofile(&hello.lua&)&&dofile(&hello.lc&)####参见&-#file 模块file.remove()####描述 删除文件。####语法 file.remove(filename)####参数 filename: 需要删除的文件。####返回值 nil####示例&&&&--&删除foo.lua文件
&&&&file.remove(&foo.lua&)####参见&-&-&file.open()####描述 打开文件。####语法 file.open(filename, mode)####参数 filename: 需要打开的文件，不支持文件夹。mode:&r&: read mode (the default)&w&: write mode&a&: append mode&r+&: update mode, 文件内的数据保留&w+&: update mode, 文件内的数据清除&a+&: append update mode, 文件内的数据保留，要写入的数据仅能增加在文件最后。####返回值 nil: 文件打开失败，不存在 true: 文件打开成功####示例&&&&--&打开'init.lua'，并打印文件的第一行。
&&&&file.open(&init.lua&,&&r&)&&&&print(file.readline())
&&&&file.close()####参见&-&-&file.close()####描述 关闭文件。####语法 file.close()####参数 nil####返回值 nil####示例&&&&--&打开'init.lua'，并打印文件的第一行，然后关闭文件。
&&&&file.open(&init.lua&,&&r&)&&&&print(file.readline())
&&&&file.close()####参见&-&-&file.readline()####描述 读取文件的一行。####语法 file.readline()####参数 nil####返回值 逐行返回文件内容。返回值末尾包含EOL('\n')如果读到EOF返回nil。####示例&&&&--&打开'init.lua'，读取并打印文件的第一行，然后关闭文件。
&&&&file.open(&init.lua&,&&r&)&&&&print(file.readline())
&&&&file.close()####参见&-&-&file.writeline()####描述 向文件写入一行，行末尾增加'\n'。####语法 file.writeline(string)####参数 string: 需要写入的字符串####返回值 true: 写入成功nil: 写入失败####示例&&&&--&以'a+'的模式打开'init.lua'
&&&&file.open(&init.lua&,&&a+&)&&&&--&将'foo&bar'写到文件的末尾
&&&&file.writeline('foo&bar')
&&&&file.close()####参见&-&-&file.write()####描述 向文件写入字符串。####语法 file.write(string)####参数 string: 需要写入的字符串####返回值 true: 写入成功nil: 写入失败####示例&&&&--&以'a+'的模式打开'init.lua'
&&&&file.open(&init.lua&,&&a+&)&&&&--&将'foo&bar'写到文件的末尾
&&&&file.writeline('foo&bar')
&&&&file.close()####参见&-&-&file.flush()####描述 清空缓存写入文件。####语法 file.flush()####参数 nil####返回值 nil####示例&&&&--&以'a+'的模式打开'init.lua'
&&&&file.open(&init.lua&,&&a+&)&&&&--&将'foo&bar'写到文件的末尾
&&&&file.write('foo&bar')
&&&&file.flush()
&&&&file.close()####参见&-&-&file.seek()####描述 设置或者读取文件的读写位置，位置等于whence加上offset的值。####语法 file.seek(whence, offset)####参数 whence:&set&: base is position 0 (beginning of the file);&cur&: base(default value)&end&:offset: default 0####返回值 成功: 返回当前的文件读写位置失败: 返回nil####示例&&&&--&以'a+'的模式打开'init.lua'
&&&&file.open(&init.lua&,&&a+&)&&&&--&将'foo&bar'写到文件的末尾
&&&&file.write('foo&bar')
&&&&file.flush()&&&&--将文件读写位置设置在文件开始
&&&&file.seek(&set&)&&&&--读取并打印文件的第一行
&&&&print(file.readline())
&&&&file.close()####参见&-&-&file.list()####描述 显示所有文件。####语法 file.list()####参数 nil####返回值 返回包含{文件名：文件大小}的lua table####示例&&&&l&=&file.list();&&&&for&k,v&in&pairs(l)&do
&&&&&&print(&name:&..k..&,&size:&..v)&&&&end####参见&-&#wifi模块 ##常量 wifi.STATION, wifi.SOFTAP, wifi.STATIONAPwifi.setmode(mode)####描述 设置wifi的工作模式。####语法 wifi.setmode(mode)####参数 mode: 取值为：wifi.STATION, wifi.SOFTAP or wifi.STATIONAP####返回值 返回设置之后的mode值####示例&&&&wifi.setmode(wifi.STATION)####参见&-&wifi.getmode(mode)####描述 获取wifi的工作模式。####语法 wifi.getmode()####参数 nil####返回值 返回wifi的工作模式####示例&&&&print(wifi.getmode())####参见&-&wifi.startsmart()####描述 开始自动配置，如果配置成功自动设置ssid和密码。####语法 wifi.startsmart(channel, function succeed_callback())####参数channel: 1~13, 启动寻找的初始频段，如果为nil默认值为6频段。每个频段搜寻20s。succeed_callback: 配置成功的回调函数，配置成功并连接至AP后调用此函数。####返回值 nil####示例&&&&wifi.startsmart(6,&function()&end)####参见&-&wifi.stopsmart()####描述 停止配置。####语法 wifi.stopsmart()####参数 nil####返回值 nil####示例&&&&wifi.stopsmart()####参见&-&#wifi.sta 子模块wifi.sta.config()####描述 设置station模式下的ssid和password。####语法 wifi.sta.config(ssid, password)####参数ssid: 字符串，长度小于32字节。password: 字符串，长度小于64字节。####返回值 nil####示例&&&&wifi.sta.config(&myssid&,&mypassword&)####参见&-&-&wifi.sta.connect()####描述 station模式下连接AP。####语法 wifi.sta.connect()####参数 nil####返回值 nil####示例&&&&wifi.sta.connect()####参见&-&-&wifi.sta.disconnect()####描述 station模式下与AP断开连接。####语法 wifi.sta.disconnect()####参数 nil####返回值 nil####示例&&&&wifi.sta.disconnect()####参见&-&-&wifi.sta.autoconnect()####描述 station模式下自动连接。####语法 wifi.sta.autoconnect(auto)####参数 auto: 0：取消自动连接，1：使能自动连接。####返回值 nil####示例&&&&wifi.sta.autoconnect()####参见&-&-&-&wifi.sta.getip()####描述 station模式下获取ip####语法 wifi.sta.getip()####参数 nil####返回值 ip地址字符串，如:&192.168.0.111&若ip地址为0.0.0.0，则返回nil####示例&&&&--&print&current&ip
&&&&print(wifi.sta.getip())####参见&-&wifi.sta.getmac()####描述 station模式下获取mac地址。####语法 wifi.sta.getmac()####参数 nil####返回值 mac地址字符串，如:&18-33-44-FE-55-BB&####示例&&&&--&打印当前的mac地址
&&&&print(wifi.sta.getmac())####参见&-&wifi.sta.getap()####描述 扫描并列出ap，结果以一个lua table为参数传递给回调函数。####语法 wifi.sta.getap(function(table))####参数 function(table): 当扫描结束时，调用此回调函数扫描结果是一个lua table，key为ap的ssid，value为其他信息，格式：authmode,rssi,bssid,channel####返回值 nil####示例&&&&--&print&ap&list
&&&&function&listap(t)&&&&&&for&k,v&in&pairs(t)&do
&&&&&&&&print(k..&&:&&..v)&&&&&&end
&&&&wifi.sta.getap(listap)####参见&-&wifi.sta.status()####描述 station模式下获取当前连接状态。####语法 wifi.sta.status()####参数 nil####返回值 number： 0~5 0: STATION_IDLE, 1: STATION_CONNECTING, 2: STATION_WRONG_PASSWORD, 3: STATION_NO_AP_FOUND, 4: STATION_CONNECT_FAIL, 5: STATION_GOT_IP.####参见&-#wifi.ap 子模块wifi.ap.config()####描述 设置ap模式下的ssid和password####语法 wifi.ap.config(cfg)####参数 cfg: 设置AP的lua table####示例:&&&&&cfg={}
&&&&&cfg.ssid=&myssid&
&&&&&cfg.pwd=&mypwd&
&&&&&wifi.ap.config(cfg)####返回值 nil####示例&&&&wifi.ap.config(ssid,&'password')####参见&-wifi.ap.getip()####描述 ap模式下获取ip####语法 wifi.ap.getip()####参数 nil####返回值 ip地址字符串，如:&192.168.0.111&若ip地址为0.0.0.0，则返回nil####示例&&&&wifi.ap.getip()####参见&-&wifi.ap.getmac()####描述 ap模式下获取mac地址。####语法 wifi.ap.getmac()####参数 nil####返回值 mac地址字符串，如:&1A-33-44-FE-55-BB&####示例&&&&wifi.ap.getmac()####参见&-&#timer 模块tmr.delay()####描述 延迟us微秒。####语法 tmr.delay(us)####参数 us: 延迟时间，单位：微秒####返回值 nil####示例&&&&--&delay&100us
&&&&tmr.delay(100)####参见&-&tmr.now()####描述 返回系统计数器的当前值，uint31，单位：us。####语法 tmr.now()####参数 nil####返回值 uint31: value of counter####示例&&&&--&打印计数器的当前值。
&&&&print(tmr.now())####参见&-&tmr.alarm()####描述 闹钟函数。####语法 tmr.alarm(id, interval, repeat, function do())####参数 id: 定时器的id，0~6. Interval: 定时时间，单位：毫秒。repeat: 0：一次性闹钟；1：重复闹钟。function do(): 定时器到时回调函数。####返回值 nil####示例&&&&--&每1000ms输出一个hello&world
&&&&tmr.alarm(0,&1000,&1,&function()&print(&hello&world&)&end&)####参见&-&tmr.stop()####描述 停止闹钟功能。####语法 tmr.stop(id)####参数 id: 定时器的id，0~6.####返回值 nil####示例&&&&--&每隔1000ms打印hello&world
&&&&tmr.alarm(1,&1000,&1,&function()&print(&hello&world&)&end&)&&&&--&其它代码
&&&&--&停止闹钟
&&&&tmr.stop(1)####参见&-&tmr.wdclr()####描述 清除看门狗计数器。####语法 tmr.wdclr()####参数 nil.####返回值 nil####示例&&&&for&i=1,10000&do&
&&&&&&print(i)
&&&&&&tmr.wdclr()&&&--&一个长时间的循环或者事务，需内部调用tmr.wdclr()&清除看门狗计数器，防止重启。
&&&&end####参见&-&#GPIO 模块 ##常量 gpio.OUTPUT, gpio.INPUT, gpio.INT, gpio.HIGH, gpio.LOWgpio.mode()####描述 将pin初始化为GPIO并设置输入输出模式, 内部上拉方式。####语法 gpio.mode(pin, mode, pullup)####参数 pin: 0~12, IO编号mode: 取值为：gpio.OUTPUT or gpio.INPUT, or gpio.INT(中断模式) pullup: 取值为：gpio.PULLUP or gpio.FLOAT, 默认为gpio.FLOAT####返回值 nil####示例&&&&--&将GPIO0设置为输出模式
&&&&gpio.mode(0,&gpio.OUTPUT)####参见&-&gpio.read()####描述 读取管脚电平高低。####语法 gpio.read(pin)####参数 pin: 0~12, IO编号####返回值 number:0：低电平, 1：高电平。####示例&&&&--&读取GPIO0的电平
&&&&gpio.read(0)####参见&-&gpio.write()####描述 设置管脚电平####语法 gpio.write(pin)####参数 pin: 0~12, IO编号level: gpio.HIGH or gpio.LOW####返回值 nil####示例&&&&--&设置GPIO&1为输出模式，并将输出电平设置为高
&&&&gpio.mode(pin,&gpio.OUTPUT)
&&&&gpio.write(pin,&gpio.HIGH)####参见&-&-&gpio.trig()####描述 设置管脚中断模式的回调函数。####语法 gpio.trig(pin, type, function(level))####参数 pin:&1~12, IO编号。注意 pin0 不支持中断。type: 取值为&up&, &down&, &both&, &low&, &high&, 分别代表上升沿、下降沿、双边沿、低电平、高电平触发方式。function(level): 中断触发的回调函数，GPIO的电平作为输入参数。如果此处没有定义函数，则使用之前定义的回调函数。####返回值 nil####示例&&&&--&使用GPIO0检测输入脉冲宽度
&&&&pulse1&=&0
&&&&du&=&0
&&&&gpio.mode(1,gpio.INT)&&&&function&pin1cb(level)
&&&&&du&=&tmr.now()&–&pulse1&&&&&print(du)
&&&&&pulse1&=&tmr.now()&&&&&if&level&==&1&then&gpio.trig(1,&&down&&)&else&gpio.trig(1,&&up&&)&end
&&&&gpio.trig(1,&&down&&,pin1cb)####参见&-&-&#PWM模块pwm.setup()####描述 设置管脚为pwm模式，最多支持6个pwm。####语法 pwm.setup(pin, clock, duty)####参数 pin: 112, IO编号clock: 11000, pwm频率duty: 0~1023, pwm占空比，最大1023（10bit）。####返回值 nil####示例&&&&--&将管脚1设置为pwm输出模式，频率100Hz，占空比50-50
&&&&pwm.setup(1,&100,&512)####参见&-&pwm.close()####描述 退出pwm模式。####语法 pwm.close(pin)####参数 pin: 1~12, IO编号####返回值 nil####示例&&&&pwm.close(1)####参见&-&pwm.start()####描述 pwm启动，可以在对应的GPIO检测到波形。####语法 pwm.start(pin)####参数 pin: 1~12, IO编号####返回值 nil####示例&&&&pwm.start(1)####参见&-&pwm.stop()####描述 暂停pwm输出波形。####语法 pwm.stop(pin)####参数 pin: 1~12, IO编号####返回值 nil####示例&&&&pwm.stop(1)####参见&-&pwm.setclock()####描述 设置pwm的频率-Note:&设置pwm频率将会同步改变其他pwm输出的频率，当前版本的所有pwm仅支持同一频率输出。####语法 pwm.setclock(pin, clock)####参数 pin: 112, IO编号clock: 11000, pwm周期####返回值 nil####示例&&&&pwm.setclock(1,&100)####参见&-&pwm.getclock()####描述 获取pin的pwm工作频率####语法 pwm.getclock(pin)####参数 pin: 1~12, IO编号####返回值 number:pin的pwm工作频率####示例&&&&print(pwm.getclock(1))####参见&-&pwm.setduty()####描述 设置pin的占空比。####语法 pwm.setduty(pin, duty)####参数 pin: 112, IO编号duty: 01023, pwm的占空比, 最大为1023.####返回值 nil####示例&&&&pwm.setduty(1,&512)####参见&-&pwm.getduty()####描述 获取pin的pwm占空比。####语法 pwm.getduty(pin)####参数 pin: 1~12, IO编号####返回值 number: 该pin的pwm占空比，最大为1023.####示例&&&&--&D1&连接绿色led
&&&&--&D2&连接蓝色led
&&&&--&D3&连接红色led
&&&&pwm.setup(1,500,512)
&&&&pwm.setup(2,500,512)
&&&&pwm.setup(3,500,512)
&&&&pwm.start(1)
&&&&pwm.start(2)
&&&&pwm.start(3)&&&&function&led(r,g,b)
&&&&&&pwm.setduty(1,g)
&&&&&&pwm.setduty(2,b)
&&&&&&pwm.setduty(3,r)&&&&end
&&&&led(512,0,0)&--&&led显示红色
&&&&led(0,0,512)&--&led显示蓝色####参见&-&#net 模块 ##常量 net.TCP, net.UDPnet.createServer()####描述 创建一个server。####语法 net.createServer(type, timeout)####参数 type: 取值为：net.TCP 或者 net.UDPtimeout: 1~28800, 当为tcp服务器时，客户端的超时时间设置。####返回值 net.server子模块####示例&&&&net.createServer(net.TCP,&30)####参见&-&net.createConnection()####描述 创建一个client。####语法 net.createConnection(type, secure)####参数 type: 取值为：net.TCP 或者 net.UDPsecure: 设置为1或者0, 1代表安全连接，0代表普通连接。####返回值 net.server子模块####示例&&&&net.createConnection(net.UDP,&0)####参见&-&#net.server 子模块listen()####描述 侦听指定ip地址的端口。####语法 net.server.listen(port,[ip],function(net.socket))####参数 port: 端口号ip:ip地址字符串，可以省略function(net.socket): 连接创建成功的回调函数，可以作为参数传给调用函数。####返回值 nil####示例&&&&--&创建一个server
&&&&sv=net.createServer(net.TCP,&30)&&--&30s&超时
&&&&--&server侦听端口80，如果收到数据将数据打印至控制台，并向远端发送‘hello&world’
&&&&sv:listen(80,function(c)
&&&&&&c:on(&receive&,&function(c,&pl)&print(pl)&end)
&&&&&&c:send(&hello&world&)&&&&&&end)####参见&-&close()####描述 关闭server####语法 net.server.close()####参数 nil####返回值 nil####示例&&&&--&创建server
&&&&sv=net.createServer(net.TCP,&5)&&&&--&关闭server
&&&&sv:close()####参见&-&#net.socket 子模块connect()####描述 连接至远端。####语法 connect(port, ip/domain)####参数 port: 端口号ip: ip地址或者是域名字符串####返回值 nil####参见&-&send()####描述 通过连接向远端发送数据。####语法 send(string, function(sent))####参数 string: 待发送的字符串function(sent): 发送字符串后的回调函数。####返回值 nil####参见&-&on()####描述 向事件注册回调函数。####语法 on(event, function cb())####参数 event: 字符串，取值为: &connection&, &reconnection&, &disconnection&, &receive&, &sent&function cb(net.socket, [string]): 回调函数。第一个参数是socket.如果事件是&receive&, 第二个参数则为接收到的字符串。####返回值 nil####示例&&&&sk=net.createConnection(net.TCP,&0)
&&&&sk:on(&receive&,&function(sck,&c)&print(c)&end&)
&&&&sk:connect(80,&192.168.0.66&)
&&&&sk:send(&GET&/&HTTP/1.1\r\nHost:&192.168.0.66\r\nConnection:&keep-alive\r\nAccept:&*/*\r\n\r\n&)####参见&-&close()####描述 关闭socket。####语法 close()####参数 nil####返回值 nil####参见&-&dns()####描述 获取当前域的ip####语法 dns(domain, function(net.socket, ip))####参数 domain: 当前域的名称function (net.socket, ip): 回调函数。第一个参数是socket，第二个参数是当前域的ip字符串。####返回值 nil####示例&&&&sk=net.createConnection(net.TCP,&0)
&&&&sk:dns(&www.nodemcu.com&,function(conn,ip)&print(ip)&end)
&&&&sk&=&nil####参见&-&#i2c模块 ##常量 i2c.SLOW, i2c.TRANSMITTER, i2c. RECEIVER. FAST（400k）模式目前不支持。i2c.setup()####描述 初始化i2c。####语法 i2c.setup(id, pinSDA, pinSCL, speed)####参数 id = 0pinSDA: 112, IO编号pinSCL: 112, IO编号speed: i2c.SLOW####返回值 返回设置的速度####参见&-&i2c.start()####描述 启动i2c传输。####语法 i2c.start(id)####参数 id = 0####返回值 nil####参见&-&i2c.stop()####描述 停止i2c传输。####语法 i2c.stop(id)####参数 id = 0####返回值 nil####参见&-&i2c.address()####描述 设置i2c地址以及读写模式。####语法 i2c.address(id, device_addr, direction)####参数 id=0device_addr: 设备地址。direction: i2c.TRANSMITTER：写模式；i2c. RECEIVER：读模式。####返回值 true: 收到ack false：没有收到ack####参见&-&i2c.write()####描述 向i2c写数据。数据可以是多个数字, 字符串或者lua table。####语法 i2c.write(id, data1, data2,...)####参数 id=0data: 数据可以是多个数字, 字符串或者lua table。####返回值 number：成功写入的字节个数####示例&&&&i2c.write(0,&&hello&,&&world&)####参见&-&i2c.read()####描述 读取len个字节的数据。####语法 i2c.read(id, len)####参数 id=0len: 数据长度。####返回值 string:接收到的数据。####示例&&&&id=0
&&&&--&初始化i2c,&将pin1设置为sda,&将pin2设置为scl
&&&&i2c.setup(id,sda,scl,i2c.SLOW)&&&&--&用户定义函数:读取地址dev_addr的寄存器reg_addr中的内容。
&&&&function&read_reg(dev_addr,&reg_addr)
&&&&&&i2c.start(id)
&&&&&&i2c.address(id,&dev_addr&,i2c.TRANSMITTER)
&&&&&&i2c.write(id,reg_addr)
&&&&&&i2c.stop(id)
&&&&&&i2c.start(id)
&&&&&&i2c.address(id,&dev_addr,i2c.RECEIVER)
&&&&&&c=i2c.read(id,1)
&&&&&&i2c.stop(id)&&&&&&return&c&&&&end
&&&&--&读取0x77的寄存器0xAA中的内容。
&&&&reg&=&read_reg(0x77,&0xAA)&&&&print(string.byte(reg))####参见&-&#adc 模块 ##常量 无adc.read()####描述 读取adc的值，esp8266只有一个10bit adc，id为0，引脚为TOUT，最大值1024####语法 adc.read(id)####参数 id = 0####返回值 adc 值 10bit，最大1024.####参见&-#uart 模块 ##常量 无uart.setup()####描述 设置uart的波特率，字节长度，校验，停止位，是否echo。####语法 uart.setup( id, baud, databits, parity, stopbits, echo )####参数 id = 0, 只支持一个串口baud = 300, 600, , , 1, 5, , 40databits = 5, 6, 7, 8。表示字节长度。parity = 0(none)。stopbits = 1(1 stopbit), 2(2 stopbit).echo = 0(关闭回显)。####返回值 返回波特率####参见&-uart.on()####描述 设置uart的事件回调函数，目前支持&data&事件，表示uart收到了数据，以行为单位。####语法 uart.on(method, function, [run_input])####参数 method = &data&, 表示uart接收到了数据function 为回调函数，&data& 的回调函数签名为function(data) endrun_input: 0或1，0表示从uart输入的data不经过lua解释器执行，1表示输入的行会被送到lua解释器执行。####返回值 nil####示例&&&&uart.on(&data&,&&&&&&function(data)&&&&&&&&print(&receive&from&uart:&,&data)&&&&&&&&if&data==&quit&&then&
&&&&&&&&&&uart.on(&data&)&
&&&&&&&&end
&&&&end,&0)####参见&-uart.write()####描述 向串口写入数据。####语法 uart.write( id, string1, string2... )####参数 id = 0, 只支持一个串口string1：需要写入的字符串。####返回值 nil####参见&-#onewire 模块 ##常量 无ow.setup()####描述 将pin设置为one wire模式。####语法 ow.setup(pin)####参数 pin: 1~12, IO 编号。####返回值 nil####参见&-ow.reset()####描述 执行一次1-wire复位操作。&####语法 ow.reset(pin)####参数 pin: 1~12, IO 编号####返回值 number: 如果有器件响应返回1，如果没有器件响应或者总线被拉低超过250us返回0。####参见&-ow.skip()####描述 发送一个1-wire“忽略rom”的命令，可以用来寻址总线上的所有器件。&####语法 ow.skip(pin)####参数 pin: 1~12, IO 编号####返回值 nil####参见&-ow.select()####描述 发送一个1-Wire“选择rom”的命令，执行此函数前请务必先执行ow.reset()函数。&####语法 ow.select(pin,rom)####参数 pin: 1~12, IO 编号rom: 包含slave器件rom内容的8个字节长度的string。####返回值 nil####示例--&18b20&Examplepin&=&9ow.setup(pin)
count&=&0repeat
&&count&=&count&+&1
&&addr&=&ow.reset_search(pin)
&&addr&=&ow.search(pin)
&&tmr.wdclr()until((addr&~=&nil)&or&(count&&&100))if&(addr&==&nil)&then
&&print(&No&more&addresses.&)else
&&print(addr:byte(1,8))
&&crc&=&ow.crc8(string.sub(addr,1,7))&&if&(crc&==&addr:byte(8))&then
&&&&if&((addr:byte(1)&==&0x10)&or&(addr:byte(1)&==&0x28))&then
&&&&&&print(&Device&is&a&DS18S20&family&device.&)&&&&&&&&repeat
&&&&&&&&&&ow.reset(pin)
&&&&&&&&&&ow.select(pin,&addr)
&&&&&&&&&&ow.write(pin,&0x44,&1)
&&&&&&&&&&tmr.delay(1000000)
&&&&&&&&&&present&=&ow.reset(pin)
&&&&&&&&&&ow.select(pin,&addr)
&&&&&&&&&&ow.write(pin,0xBE,1)&&&&&&&&&&print(&P=&..present)&&
&&&&&&&&&&data&=&nil
&&&&&&&&&&data&=&string.char(ow.read(pin))&&&&&&&&&&for&i&=&1,&8&do
&&&&&&&&&&&&data&=&data&..&string.char(ow.read(pin))&&&&&&&&&&end
&&&&&&&&&&print(data:byte(1,9))
&&&&&&&&&&crc&=&ow.crc8(string.sub(data,1,8))&&&&&&&&&&print(&CRC=&..crc)&&&&&&&&&&if&(crc&==&data:byte(9))&then
&&&&&&&&&&&&&t&=&(data:byte(1)&+&data:byte(2)&*&256)&*&625
&&&&&&&&&&&&&t1&=&t&/&10000
&&&&&&&&&&&&&t2&=&t&%&10000
&&&&&&&&&&&&&print(&Temperature=&..t1..&.&..t2..&Centigrade&)&&&&&&&&&&end&&&&&&&&&&&&&&&&&&&
&&&&&&&&&&tmr.wdclr()&&&&&&&&until&false
&&&&&&print(&Device&family&is&not&recognized.&)&&&&end
&&&&print(&CRC&is&not&valid!&)&&endend####参见&-ow.write()####描述 向选定的slave写一个字节。&####语法 ow.write(pin, v, power)####参数 pin: 1~12, IO 编号&v: 向slave器件发送的字节&power: 1，用于向寄生供电器件供电；0，不需要寄生供电。注意：请务必调用ow.depower()或者发起新的读写操作来取消寄生供电。####返回值 nil####参见&-ow.write_bytes()####描述 向选定的slave写多个字节。####语法 ow.write_bytes(pin, buf, power)####参数 pin: 1~12, IO 编号&buf: 向slave发送的多个字节的字符串&power: 1，用于向寄生供电器件供电；0，不需要寄生供电。注意：请务必调用ow.depower()或者发起新的读写操作来取消寄生供电。####返回值 nil####参见&-ow.read()####描述 从选定的slave读取一个字节。&####语法 ow.read(pin)####参数 pin: 1~12, IO 编号&####返回值 从slave读取的一个字节。####参见&-ow.read_bytes()####描述 从选定的slave读取多个字节。&####语法 ow.read_bytes(pin, size)####参数 pin: 1~12, IO 编号&size: 需要从slave读取的字节的个数####返回值 从slave返回的多个字节的字符串。####参见&-ow.depower()####描述 取消向总线供电。仅需在ow.write()或者ow.write_bytes()中的'power=1' 且 不再进行读写slave的情况下使用。####语法 ow.depower(pin)####参数 pin: 1~12, IO 编号&####返回值 nil####参见&-ow.reset_search()####描述 清除查找状态用于重新开始进行查找操作。####语法 ow.reset_search(pin)####参数 pin: 1~12, IO 编号&####返回值 nil####参见&-ow.target_search()####描述 设置查找选项'family_code'，用于在下次调用ow.search()时查找该'family_code'的器件。####语法 ow.target_search(pin, family_code)####参数 pin: 1~12, IO 编号&family_code: family_code字节####返回值 nil####参见&-ow.search()####描述 寻找下一个slave器件。&####语法 ow.search(pin)####参数 pin: 1~12, IO 编号&####返回值 查找成功则返回slave器件的8个字节的rom code字符串；&查找失败则返回nil####参见&-ow.crc8()####描述 计算Dallas Semiconductor的8位CRC, 用于与ROM或者暂存器中的内容进行比较。&####语法 ow.crc8(buf)####参数 buf: 需要进行crc8计算的字符串&####返回值 crc结果字节####参见&-ow.check_crc16()####描述 计算1-Wire的CRC16并与接收的CRC结果进行比较。&####语法 ow.check_crc16(buf, inverted_crc0, inverted_crc1, crc)####参数 buf: 需要进行crc8计算的字符串&inverted_crc0: 接收到的CRC结果的低字节&inverted_crc1: 接收到的CRC结果的高字节&crc: crc初始值 (可选)####返回值 布尔值: true, crc结果相符; false，crc结果不相符。####参见&-ow.crc16()####描述 计算Dallas Semiconductor的16位的CRC值。用于1-wire总线中多器件通信的数据完整性校验。请注意：这里的CRC计算结果并不一定是1-wire总线中获得的CRC，原因如下：1) 1-wire总线传输的CRC是低位先传输的。2) 另外由于因处理器而异的字节顺序，ow.crc16()返回结果的MSB和LSB顺序可能不同于1-wire总线中获取的MSB和LSB顺序。&####语法 ow.crc16(buf, crc)####参数 buf: 需要进行crc8计算的字符串&crc: crc初始值 (可选)####返回值 返回16位的Dallas Semiconductor CRC计算结果####参见&-#bit 模块 ##常量 nonebit.bnot()####描述 按位取反, 相当于C语言中的'~value'。####语法 bit.bnot(value)####参数 value: 取反操作数####返回值 number: 按位取反后的结果####参见&-bit.band()####描述 按位与, 相当于C语言中的'val1 & val2 & ... & valn'。####语法 bit.band(val1, val2, ... valn)####参数 val1: 第一个'与'操作数val2: 第二个'与'操作数valn: 第n个'与'操作数####返回值 number: 所有操作数按位'与'操作的结果####参见&-bit.bor()####描述 按位或, 相当于C语言中的val1 | val2 | ... | valn。####语法 bit.bor(val1, val2, ... valn)####参数 val1: 第一个'或'操作数val2: 第二个'或'操作数valn: 第n个'或'操作数####返回值 number: 所有操作数按位'或'操作的结果####参见&-bit.bxor()####描述 按位异或, 相当于C语言中的val1 ^ val2 ^ ... ^ valn。####语法 bit.bxor(val1, val2, ... valn)####参数 val1: 第一个'异或'操作数val2: 第二个'异或'操作数valn: 第n个'异或'操作数####返回值 number: 所有操作数按位'异或'操作的结果####参见&-bit.lshift()####描述 按位左移一个操作数, 相当于C语言中的 value&&shift。####语法 bit.lshift(value, shift)####参数 value: 按位左移的操作数shift: 左移的偏移量####返回值 number: 按位左移的结果####参见&-bit.rshift()####描述 逻辑右移一个操作数, 相当于C语言中的无符号数 value&&shift。####语法 bit.rshift(value, shift)####参数 value: 按位右移的操作数shift: 右移的偏移量####返回值 number: 按位右移的结果（按无符号数处理）####参见&-bit.arshift()####描述 算术右移一个操作数, 相当于C语言中的 value&&shift。####语法 bit.arshift(value, shift)####参数 value: 按位右移的操作数shift: 右移的偏移量####返回值 number: 按位右移的结果（算术右移）####参见&-bit.bit()####描述 将某一个位设置为1，相当于C语言中的1 && position。####语法 bit.bit(position)####参数 position: 需要设置为1的位序。####返回值 number: 某位设置为1的结果 (其余位设为0)####参见&-bit.set()####描述 将某些位设置为1。####语法 bit.set(value, pos1, pos2, ..., posn)####参数 value: 操作数pos1: 第一个需要设置为1的位序pos2: 第二个需要设置为1的位序posn: 第n个需要设置为1的位序####返回值 number: 将特定位设置为1的结果####参见&-bit.clear()####描述 将某些位设置为0。####语法 bit.clear(value, pos1, pos2, ..., posn)####参数 value: 操作数pos1: 第一个需要设置为0的位序pos2: 第二个需要设置为0的位序posn: 第n个需要设置为0的位序####返回值 number: 将特定位设置为0的结果####参见&-bit.isset()####描述 测试特定位是否为1。####语法 bit.isset(value, position)####参数 value: 需要测试的操作数position: 需要测试的位序####返回值 boolean: 如果指定位序为1，返回true，否则返回false####参见&-bit.isclear()####描述 测试特定位是否为0。####语法 bit.isclear(value, position)####参数 value: 需要测试的操作数position: 需要测试的位序####返回值 boolean: 如果指定位序为0，返回true，否则返回false####参见&-#spi 模块 ##常量 MASTER, SLAVE, CPHA_LOW, CPHA_HIGH, CPOL_LOW, CPOL_HIGH, DATABITS_8, DATABITS_16spi.setup()####描述 配置spi.####语法 spi.setup( id, mode, cpol, cpha, databits, clock )####参数 id: spi id号.mode: MASTER 或者 SLAVE(目前不支持).cpol: CPOL_LOW 或者 CPOL_HIGH, 时钟极性.cpha: CPHA_HIGH 或者 CPHA_LOW, 时钟相位.databits: DATABITS_8 或者 DATABITS_16.clock: spi时钟 (目前不支持).####返回值 number: 1.####示例####参见&--&spi.send()####描述 向spi设备发送数据.####语法 wrote = spi.send( id, data1, [data2], ..., [datan] )####参数 id: spi id号.data: data可以是字符串、Lua table或者8位数值.####返回值 number: 发送数据的字节数.####示例####参见&--&spi.recv()####描述 从spi设备接收数据.####语法 read = spi.recv( id, size )####参数 id: spi id号.size: 需要读取数据的字节数.####返回值 string: 读取的字符串（字节形式）.####示例####参见&--&#mqtt 模块 ##常量mqtt.Client()####描述 创建一个mqtt client.####语法 mqtt.Client(clientid, keepalive, user, pass)####参数 clientid: mqtt客户端id.keepalive: 保持连接的时间，单位：秒.user: 用户名，字符串.pass: 密码，字符串.####返回值 mqtt客户端.####示例--&创建一个mqtt&client，保持连接包时间120s.m&=&mqtt.Client(&clientid&,&120,&&user&,&&password&)--设置Last&Will和Testament&(可选).--如果mqtt&client不发送保持连接包，服务器会向标题&/lwt&发送一个qos&=&0,&retain&=&0,&data&=&&offline&的消息.m:lwt(&/lwt&,&&offline&,&0,&0)
m:on(&connect&,&function(con)&print&(&connected&)&end)
m:on(&offline&,&function(con)&print&(&offline&)&end)--&接收到消息事件m:on(&message&,&function(conn,&topic,&data)&
&&print(topic&..&&:&&)&
&&if&data&~=&nil&then
&&&&print(data)&&endend)--&如果需要安全连接，则m:connect(&192.168.11.118&,&1880,&1)m:connect(&192.168.11.118&,&1880,&0,&function(conn)&print(&connected&)&end)--&订阅&/topic&消息，qos&=&0m:subscribe(&/topic&,0,&function(conn)&print(&subscribe&success&)&end)--&向&/topic&标题发送消息，消息设置：data&=&hello,&QoS&=&0,&retain&=&0m:publish(&/topic&,&hello&,0,0,&function(conn)&print(&sent&)&end)
m:close();--&或者可以再次调用m:connect()####参见&--&#mqtt client子模块mqtt:lwt()####描述 设置Last Will和Testament (可选)如果mqtt client不发送保持连接包，服务器会向标题&/lwt&发送一个qos = 0, retain = 0, data = &offline&的消息.&####语法 mqtt:lwt(topic, message, qos, retain)####参数 topic: 需要发布消息的标题，字符串类型.message: 需要发布的消息， Buffer或者字符串.qos: qos值， 默认值为0.retain: 保留标志，默认值为0.####返回值 nil.####示例####参见&--&mqtt:connect()####描述 连接到mqtt服务器.####语法 mqtt:connect( host, port, secure, function(client) )####参数 host: 主机域名或者ip地址，字符串类型.port: 服务器端口号.secure: 0 或者 1, 默认值为0.function(client): 连接成功的回调函数.####返回值 nil.####示例####参见&--&mqtt:close()####描述 关闭mqtt连接.####语法 mqtt:close()####参数 nil####返回值 nil.####示例####参见&--&mqtt:publish()####描述 发布一个消息.####语法 mqtt:publish( topic, payload, qos, retain, function(client) )####参数 topic: 需要发布消息的标题, 字符串类型.message: 需要发布的消息, 字符串类型.qos: qos值, 默认值为0.retain: 保留标志, 默认值为0.function(client): 发送成功的回调函数，如果接收到PUBACK回调函数解除.####返回值 nil.####示例####参见&--&mqtt:subscribe()####描述 订阅一个或者多个标题的消息.####语法 mqtt:subscribe(topic, qos, function(client, topic, message))####参数 topic: 需要订阅消息的标题.qos: 订阅消息的qos值, 默认值为0function(client, topic, message): 接收消息的回调函数，接收后即解除.####返回值 nil.####示例####参见&--&mqtt:on()####描述 注册mqtt事件的回调函数.####语法 mqtt:on(event, function(client, [topic], [message]))####参数 event: 字符串，取值为: &connect&, &message&, &offline&function cb(client, [topic], [message]): 事件触发的回调函数. 第一个参数是mqtt client.如果事件是&message&, 第二个和第三个参数分别是标题和消息内容，字符串类型.####返回值 nil.####示例####参见&-&#WS2812 模块 ##常量 无ws2812.writergb()####描述 将RGB编码成8bit数据发送至WS2812####语法 ws2812.writeegb(pin, string.char(R1,G1,B1(,R2,G2,B2...)) )####参数 pin = 支持所有PIN(0,1,2...)R1 = 级联的第一个WS2812的红色通道（0-255）G1 = 级联的第一个WS2812的绿色通道（0-255）B1 = 级联的第一个WS2812的蓝色通道（0-255）... 可几乎无限级联,R2,G2,B2为下一个级联的LED的红绿蓝参数####返回值 nil####参见&-&-&
上一篇：下一篇：
<div class="ds-thread" data-thread-key="162" data-title="nodeMcu 中文API说明" data-url="http://tongxinmao.com/Article/Detail/id/162"}