modify readme
This commit is contained in:
funshine
parent
d59719fdb7
commit
ebbd1c2ed3
|
|
@ -0,0 +1,291 @@
|
|||
nodeMcu API说明
|
||||
=======
|
||||
version 0.1 2014-10-11
|
||||
|
||||
flash 错误
|
||||
----
|
||||
注意：有些模块在烧写之后启动，串口输出 ERROR in flash_read: r=。。。
|
||||
这是因为模块原来的flash内部没有擦除。
|
||||
可使用blank.bin(4k)，
|
||||
重复烧入起始地址0x47000, 0x48000, 0x49000, 0x4a000扇区.
|
||||
或者生成一个512k大小的blank512k.bin, 内容为全0xFF，从0x00000开始烧入。
|
||||
烧入之后可以正常运行。
|
||||
|
||||
概述
|
||||
------
|
||||
支持一键配置
|
||||
|
||||
基于Lua 5.1.4，使用者需了解最简单的Lua语法。
|
||||
|
||||
采用事件驱动的编程模型。
|
||||
|
||||
内置 timer，pwm，i2c，net，gpio，wifi module。
|
||||
|
||||
对模块的引脚进行编号；gpio，i2c，pwm等模块需要使用引脚编号进行索引。
|
||||
|
||||
###目前的编号对应表格：
|
||||
|
||||
IO索引编号 ESP8266实际IO IO索引编号 ESP8266实际IO
|
||||
0 GPIO12 8 GPIO0
|
||||
1 GPIO13 9 GPIO2
|
||||
2 GPIO14 10 GPIO4
|
||||
3 GPIO15 11 GPIO5
|
||||
4 GPIO3
|
||||
5 GPIO1
|
||||
6 GPIO9
|
||||
7 GPIO10
|
||||
|
||||
###串口波特率
|
||||
9600
|
||||
|
||||
###固件烧写地址：
|
||||
|
||||
eagle.app.v6.flash.bin：0x00000
|
||||
eagle.app.v6.irom0text.bin：0x10000
|
||||
esp_init_data_default.bin：0x7c000
|
||||
blank.bin：0x7e000
|
||||
|
||||
第一次使用建议将blank512k.bin烧写在地址0x00000
|
||||
|
||||
node module
|
||||
------
|
||||
node.restart()
|
||||
|
||||
描述：重新启动
|
||||
|
||||
node.dsleep( us )
|
||||
|
||||
描述：深度睡眠 us 微秒，时间到之后将重新启动
|
||||
us：时间，单位微秒
|
||||
|
||||
node.chipid()
|
||||
|
||||
描述：返回芯片id
|
||||
返回：number
|
||||
|
||||
node.heap()
|
||||
|
||||
描述：返回可用内存 in bytes
|
||||
返回：系统heap剩余
|
||||
|
||||
node.format()
|
||||
|
||||
描述：格式化用户flash区
|
||||
|
||||
node.startlog( filename, noparse)
|
||||
|
||||
描述：开始记录输入
|
||||
filename：log所保存的文件名，不支持目录
|
||||
noparse：1表示lua虚拟机不对输入进行解析，0表示lua虚拟机对输入进行解析
|
||||
|
||||
node.stoplog()
|
||||
|
||||
描述：结束log
|
||||
|
||||
例子：录制log到init.lua文件，可以在系统启动之后自动调用该文件。
|
||||
|
||||
node.format()
|
||||
node.startlog("init.lua", 1)
|
||||
print("hello world")
|
||||
node.stoplog()
|
||||
|
||||
此时，文件init.lua内部将含有内容，重启之后，系统执行print("hello world")
|
||||
|
||||
node.readlog( filename)
|
||||
|
||||
描述：读取文件
|
||||
filename：log文件名，不支持目录
|
||||
返回：读取的内容，字符串形式
|
||||
|
||||
node.list()
|
||||
|
||||
描述：返回所有文件
|
||||
返回：一个包含 <文件名：文件大小> pair 的map
|
||||
|
||||
wifi module
|
||||
-----------
|
||||
|
||||
常量：wifi.STATION, wifi.SOFTAP, wifi.STATIONAP
|
||||
|
||||
wifi.setmode(mode)
|
||||
|
||||
描述：设置wifi的工作模式
|
||||
mode：取值：wifi.STATION, wifi.SOFTAP或wifi.STATIONAP
|
||||
返回设置之后的当前mode
|
||||
|
||||
wifi.getmode()
|
||||
|
||||
描述：获取wifi的工作模式
|
||||
返回：wifi.STATION, wifi.SOFTAP或wifi.STATIONAP
|
||||
|
||||
wifi.startconfig( channel, function succeed_callback )
|
||||
|
||||
描述：开始智能配置，若成功自动设置ssid和pwd并退出
|
||||
channel：1~13，起始搜索信道。若不指定，默认为6，每个信道搜索20秒
|
||||
succeed_callback：配置成功后的回调函数，将在获取密码正确并连接上ap之后调用
|
||||
|
||||
wifi.stopconfig()
|
||||
|
||||
描述：中断智能配置
|
||||
|
||||
wifi.station module
|
||||
-----------------
|
||||
wifi.station.setconfig(ssid, password)
|
||||
|
||||
描述：设置station模式下的ssid和password
|
||||
ssid：字符串形式，长度小于32
|
||||
password：字符串形式，长度小于64
|
||||
|
||||
wifi.station.connect()
|
||||
|
||||
描述：station模式下连接至ap
|
||||
|
||||
wifi.station.disconnect()
|
||||
|
||||
描述：station模式下断开与ap的连接
|
||||
|
||||
wifi.station.autoconnect(auto)
|
||||
|
||||
描述：station模式下设置自动连接至ap
|
||||
auto：0表示设置为不自动连，1表示设置为自动连接
|
||||
|
||||
wifi.station.getip()
|
||||
|
||||
描述：station模式下获取ip
|
||||
返回：字符串形式的ip，如"192.168.0.2"
|
||||
|
||||
wifi.station.getmac()
|
||||
|
||||
描述：station模式下获取mac
|
||||
返回：字符串形式的mac，如"18-33-44-FE-55-BB"
|
||||
|
||||
wifi.ap module
|
||||
---------------
|
||||
wifi.ap.setconfig(cfg)
|
||||
|
||||
描述：设置station模式下的ssid和password
|
||||
cfg：设置需要的map
|
||||
|
||||
例子：
|
||||
|
||||
cfg={}
|
||||
cfg.ssid="myssid"
|
||||
cfg.pwd="mypwd"
|
||||
wifi.ap.setconfig(cfg)
|
||||
|
||||
wifi.ap.getip()
|
||||
|
||||
描述：ap模式下获取ip
|
||||
返回：字符串形式的ip，如"192.168.0.2"
|
||||
|
||||
wifi.ap.getmac()
|
||||
|
||||
描述：ap模式下获取mac
|
||||
返回：字符串形式的mac，如"1A-33-44-FE-55-BB"
|
||||
|
||||
gpio module
|
||||
-----------
|
||||
常量：gpio.OUTPUT, gpio.INPUT, gpio.HIGH, gpio.LOW
|
||||
|
||||
gpio.mode( pin, mode)
|
||||
|
||||
描述：设置对应pin的输入输出模式，将该pin初始化为gpio模式。
|
||||
pin：0~11，IO索引编号
|
||||
mode：gpio.OUTPUT或者gpio.INPUT
|
||||
|
||||
gpio.read(pin)
|
||||
|
||||
描述：读取对应pin的值
|
||||
pin：0~11，IO索引编号
|
||||
返回：0表示低，1表示高
|
||||
|
||||
gpio.write(pin, level)
|
||||
|
||||
描述：设置对应pin的值
|
||||
pin：0~11，IO索引编号
|
||||
level：gpio.HIGH或者gpio.LOW
|
||||
|
||||
例子：
|
||||
|
||||
pin=1
|
||||
gpio.mode(pin, gpio.OUTPUT)
|
||||
gpio.write(pin, gpio.HIGH)
|
||||
|
||||
将索引1的pin设置为GPIO模式，并设置为高电平。
|
||||
|
||||
net module
|
||||
---------------
|
||||
常量：net.TCP, net.UDP
|
||||
|
||||
net.createServer(type)
|
||||
|
||||
描述：建立一个服务器
|
||||
type：net.TCP或 net.UDP
|
||||
返回：net.server子模块
|
||||
|
||||
net.createConnection(type)
|
||||
|
||||
描述：建立一个客户端
|
||||
type：net.TCP或 net.UDP
|
||||
返回：net.socket子模块
|
||||
|
||||
net.server module
|
||||
-------------
|
||||
listen(port,[ip],function(net.socket))
|
||||
|
||||
描述：监听某端口
|
||||
port：端口号
|
||||
ip：可忽略，ip字符串
|
||||
function(net.socket): 回调函数，当有连接建立的时候，作为参数传给回调函数。
|
||||
|
||||
例子：
|
||||
|
||||
sv=net.createServer(net.TCP, false)
|
||||
sv:listen(80,function(c)
|
||||
c:on("receive", function(sck, pl) print(pl) end)
|
||||
c:send("hello world")
|
||||
end)
|
||||
|
||||
close()
|
||||
|
||||
描述：关闭服务器
|
||||
|
||||
net.socket module
|
||||
-------
|
||||
connect(port, ip)
|
||||
|
||||
描述：连接到某ip和端口
|
||||
port：端口号
|
||||
ip：ip字符串
|
||||
|
||||
send( string, function(sent) )
|
||||
|
||||
描述：向连接发送数据
|
||||
string：需要发送的数据字符串
|
||||
|
||||
on(event, function cb())
|
||||
|
||||
描述：注册事件的回调函数
|
||||
event：字符串
|
||||
可为："connection","reconnection","disconnection","receive","sent"
|
||||
function cb(net.socket, [string])：回调函数。第一个参数为socket连接。
|
||||
若event为"receive"， 第二个参数为接收到数据，字符串形式。
|
||||
|
||||
例子：
|
||||
|
||||
sk=net.createConnection(net.TCP, false)
|
||||
sk:on("receive", function(sck, pl) print(pl) end )
|
||||
sk:connect(80,"115.239.210.27")
|
||||
sk:send("GET / HTTP/1.1\r\nHost: 115.239.210.27\r\n
|
||||
Connection: keep-alive\r\nAccept: */*\r\n\r\n")
|
||||
|
||||
close()
|
||||
|
||||
描述：关闭socket
|
||||
|
||||
dns(domain, function cb(net.socket, ip) )
|
||||
|
||||
描述：获取domain的ip
|
||||
domain：字符串
|
||||
function cb(net.socket, ip)：回调函数。
|
||||
第一个参数为socket连接本身， 第二个为获取的ip, 字符串形式。
|
||||
Loading…
Reference in New Issue