add readme

This commit is contained in:
Hong 2014-10-13 20:44:26 +08:00
parent 994c550b15
commit 35ad738f8c
1 changed files with 85 additions and 85 deletions

170
README.md
View File

@ -12,7 +12,7 @@ version 0.1 2014-10-11
nodeMcu对模块的引脚进行编号gpioi2cpwm等模块需要使用引脚编号进行索引。 nodeMcu对模块的引脚进行编号gpioi2cpwm等模块需要使用引脚编号进行索引。
目前的编号对应表格: ###目前的编号对应表格:
IO索引编号 ESP8266实际IO IO索引编号 ESP8266实际IO IO索引编号 ESP8266实际IO IO索引编号 ESP8266实际IO
0 GPIO12 8 GPIO0 0 GPIO12 8 GPIO0
@ -24,7 +24,8 @@ version 0.1 2014-10-11
6 GPIO9 6 GPIO9
7 GPIO10 7 GPIO10
串口波特率74880 ###串口波特率
74880
###固件烧写地址: ###固件烧写地址:
@ -37,30 +38,30 @@ version 0.1 2014-10-11
node module node module
------ ------
node.restart() node.restart()
描述:重新启动 描述:重新启动
node.dsleep( us ) node.dsleep( us )
描述:深度睡眠 us 微秒,时间到之后将重新启动 描述:深度睡眠 us 微秒,时间到之后将重新启动
us时间单位微秒 us时间单位微秒
node.chipid() node.chipid()
描述返回芯片id 描述返回芯片id
返回number 返回number
node.heap() node.heap()
描述:返回可用内存 in bytes 描述:返回可用内存 in bytes
返回系统heap剩余 返回系统heap剩余
node.format() node.format()
描述格式化用户flash区 描述格式化用户flash区
node.startlog( filename, noparse) node.startlog( filename, noparse)
描述:开始记录输入 描述:开始记录输入
filenamelog所保存的文件名不支持目录 filenamelog所保存的文件名不支持目录
noparse1表示lua虚拟机不对输入进行解析0表示lua虚拟机对输入进行解析 noparse1表示lua虚拟机不对输入进行解析0表示lua虚拟机对输入进行解析
node.stoplog() node.stoplog()
描述结束log 描述结束log
例子录制log到init.lua文件可以在系统启动之后自动调用该文件。 例子录制log到init.lua文件可以在系统启动之后自动调用该文件。
node.format() node.format()
@ -71,13 +72,13 @@ node.stoplog()
此时文件init.lua内部将含有内容重启之后系统执行print(“hello world”) 此时文件init.lua内部将含有内容重启之后系统执行print(“hello world”)
node.readlog( filename) node.readlog( filename)
描述:读取文件 描述:读取文件
filenamelog文件名不支持目录 filenamelog文件名不支持目录
返回:读取的内容,字符串形式 返回:读取的内容,字符串形式
node.list() node.list()
描述:返回所有文件 描述:返回所有文件
返回:一个包含 <文件名文件大小> pair 的map 返回:一个包含 <文件名文件大小> pair 的map
wifi module wifi module
----------- -----------
@ -85,52 +86,52 @@ wifi module
常量wifi. STATION, wifi.SOFTAP, wifi.STATIONAP 常量wifi. STATION, wifi.SOFTAP, wifi.STATIONAP
wifi.setmode(mode) wifi.setmode(mode)
描述设置wifi的工作模式 描述设置wifi的工作模式
mode取值wifi. STATION, wifi.SOFTAP或wifi.STATIONAP mode取值wifi. STATION, wifi.SOFTAP或wifi.STATIONAP
返回设置之后的当前mode 返回设置之后的当前mode
wifi.getmode() wifi.getmode()
描述获取wifi的工作模式 描述获取wifi的工作模式
返回wifi. STATION, wifi.SOFTAP或wifi.STATIONAP 返回wifi. STATION, wifi.SOFTAP或wifi.STATIONAP
wifi.startconfig( channel, function succeed_callback ) wifi.startconfig( channel, function succeed_callback )
描述开始智能配置若成功自动设置ssid和pwd并退出 描述开始智能配置若成功自动设置ssid和pwd并退出
channel1~13起始搜索信道。若不指定默认为6每个信道搜索20秒 channel1~13起始搜索信道。若不指定默认为6每个信道搜索20秒
succeed_callback配置成功后的回调函数将在获取密码正确并连接上ap之后调用 succeed_callback配置成功后的回调函数将在获取密码正确并连接上ap之后调用
wifi.stopconfig() wifi.stopconfig()
描述:中断智能配置 描述:中断智能配置
wifi.station module wifi.station module
----------------- -----------------
wifi.station.setconfig(ssid, password) wifi.station.setconfig(ssid, password)
描述设置station模式下的ssid和password 描述设置station模式下的ssid和password
ssid字符串形式长度小于32 ssid字符串形式长度小于32
password字符串形式长度小于64 password字符串形式长度小于64
wifi.station.connect() wifi.station.connect()
描述station模式下连接至ap 描述station模式下连接至ap
wifi.station.disconnect() wifi.station.disconnect()
描述station模式下断开与ap的连接 描述station模式下断开与ap的连接
wifi.station.autoconnect(auto) wifi.station.autoconnect(auto)
描述station模式下设置自动连接至ap 描述station模式下设置自动连接至ap
auto0表示设置为不自动连1表示设置为自动连接 auto0表示设置为不自动连1表示设置为自动连接
wifi.station.getip() wifi.station.getip()
描述station模式下获取ip 描述station模式下获取ip
返回字符串形式的ip如“192.168.0.2” 返回字符串形式的ip如“192.168.0.2”
wifi.station.getmac() wifi.station.getmac()
描述station模式下获取mac 描述station模式下获取mac
返回字符串形式的mac如“18-33-44-FE-55-BB” 返回字符串形式的mac如“18-33-44-FE-55-BB”
wifi.ap module wifi.ap module
--------------- ---------------
wifi.ap.setconfig(cfg) wifi.ap.setconfig(cfg)
描述设置station模式下的ssid和password 描述设置station模式下的ssid和password
cfg设置需要的map cfg设置需要的map
例子: 例子:
cfg={} cfg={}
@ -139,33 +140,31 @@ cfg设置需要的map
wifi.ap.setconfig(cfg) wifi.ap.setconfig(cfg)
wifi.ap.getip() wifi.ap.getip()
描述ap模式下获取ip 描述ap模式下获取ip
返回字符串形式的ip如“192.168.0.2” 返回字符串形式的ip如“192.168.0.2”
wifi. ap.getmac() wifi. ap.getmac()
描述ap模式下获取mac 描述ap模式下获取mac
返回字符串形式的mac如“1A-33-44-FE-55-BB” 返回字符串形式的mac如“1A-33-44-FE-55-BB”
gpio module gpio module
----------- -----------
模块名gpio
常量gpio.OUTPUT, gpio.INPUT, gpio.HIGH, gpio.LOW 常量gpio.OUTPUT, gpio.INPUT, gpio.HIGH, gpio.LOW
gpio.mode( pin, mode) gpio.mode( pin, mode)
描述设置对应pin的输入输出模式将该pin初始化为gpio模式。 描述设置对应pin的输入输出模式将该pin初始化为gpio模式。
pin0~11IO索引编号 pin0~11IO索引编号
modegpio.OUTPUT或者gpio.INPUT modegpio.OUTPUT或者gpio.INPUT
gpio.read(pin) gpio.read(pin)
描述读取对应pin的值 描述读取对应pin的值
pin0~11IO索引编号 pin0~11IO索引编号
返回0表示低1表示高 返回0表示低1表示高
gpio.write(pin, level) gpio.write(pin, level)
描述设置对应pin的值 描述设置对应pin的值
pin0~11IO索引编号 pin0~11IO索引编号
levelgpio.HIGH或者gpio.LOW levelgpio.HIGH或者gpio.LOW
例子: 例子:
pin=1 pin=1
@ -179,36 +178,36 @@ net module
常量net.TCP, net.UDP 常量net.TCP, net.UDP
net.createServer(type, secure) net.createServer(type, secure)
描述:建立一个服务器 描述:建立一个服务器
typenet.TCP或 net.UDP typenet.TCP或 net.UDP
securetrue 或者 false表示是否为安全连接 securetrue 或者 false表示是否为安全连接
返回net.server子模块 返回net.server子模块
net.createConnection(type, secure) net.createConnection(type, secure)
描述:建立一个客户端 描述:建立一个客户端
typenet.TCP或 net.UDP typenet.TCP或 net.UDP
securetrue 或者 false表示是否为安全连接 securetrue 或者 false表示是否为安全连接
返回net. socket子模块 返回net. socket子模块
net.server module net.server module
listen(port,[ip]) listen(port,[ip])
描述:监听某端口 描述:监听某端口
port端口号 port端口号
ip可忽略ip字符串 ip可忽略ip字符串
例子: 例子:
sv=net.createServer(net.TCP, false) sv=net.createServer(net.TCP, false)
sv:listen(80) sv:listen(80)
send( string, function(sent) ) send( string, function(sent) )
描述:向连接的客户端发送数据 描述:向连接的客户端发送数据
string需要发送的数据字符串 string需要发送的数据字符串
on(event, function cb()) on(event, function cb())
描述:注册事件的回调函数 描述:注册事件的回调函数
event字符串可为"connection""reconnection""disconnection""receive""sent" event字符串可为"connection""reconnection""disconnection""receive""sent"
function cb(net.server sv, [string]):回调函数。第一个参数为服务器本身。 function cb(net.server sv, [string]):回调函数。第一个参数为服务器本身。
若event为”receive” 第二个参数为接收到数据,字符串形式。 若event为”receive” 第二个参数为接收到数据,字符串形式。
例子: 例子:
sv=net.createServer(net.TCP, false) sv=net.createServer(net.TCP, false)
@ -216,23 +215,24 @@ function cb(net.server sv, [string]):回调函数。第一个参数为服务
sv:on("receive", function(s,c) s:send("Hello, world.") print(c) end ) sv:on("receive", function(s,c) s:send("Hello, world.") print(c) end )
close() close()
描述:关闭服务器 描述:关闭服务器
net.socket module net.socket module
-------
connect(port, ip) connect(port, ip)
描述连接到某ip和端口 描述连接到某ip和端口
port端口号 port端口号
ipip字符串 ipip字符串
send( string, function(sent) ) send( string, function(sent) )
描述:向连接发送数据 描述:向连接发送数据
string需要发送的数据字符串 string需要发送的数据字符串
on(event, function cb()) on(event, function cb())
描述:注册事件的回调函数 描述:注册事件的回调函数
event字符串可为"connection""reconnection""disconnection""receive""sent" event字符串可为"connection""reconnection""disconnection""receive""sent"
function cb(net.socket, [string])回调函数。第一个参数为socket连接本身。 function cb(net.socket, [string])回调函数。第一个参数为socket连接本身。
若event为”receive” 第二个参数为接收到数据,字符串形式。 若event为”receive” 第二个参数为接收到数据,字符串形式。
例子: 例子:
sk=net.createConnection(net.TCP, false) sk=net.createConnection(net.TCP, false)
@ -241,5 +241,5 @@ function cb(net.socket, [string])回调函数。第一个参数为socket连
sk:send("GET / HTTP/1.1\r\nHost: 192.168.0.66\r\nConnection: keep-alive\r\nAccept: */*\r\n\r\n") sk:send("GET / HTTP/1.1\r\nHost: 192.168.0.66\r\nConnection: keep-alive\r\nAccept: */*\r\n\r\n")
close() close()
描述关闭socket 描述关闭socket