大家可以用Google浏览器页面翻译浏览NodeMCU官方API来获取最新的API
一、PWM模块
在我的项目开发中我用到了PWM模块来操作SG90舵机,我来分享一下我的经验。
- PWM的函数
序号 | 函数名 | 参数 | 返回值 | 作用 |
---|---|---|---|---|
1 | pwm.close() | pin | nil | 退出指定GPIO引脚的PWM模式 |
2 | pwm.getclock() | pin | number | 获取引脚的选定PWM频率 |
3 | pwm.getduty() | pin | number | 获取引脚的选定占空比 |
4 | pwm.setclock() | pin, clock | nil | 设置PWM频率 |
5 | pwm.setduty() | pin, duty | nil | 设置引脚的占空比 |
6 | pwm.setup() | pin, clock, duty | nil | 将引脚设置为PWM模式 |
7 | pwm.start() | pin | nil | PWM启动,波形应用于GPIO引脚 |
8 | pwm.stop() | pin | nil | 暂停PWM波形的输出 |
注:
pwm的频率范围1~1000
pwm的占空比范围0~1024
-
SG90介绍
舵机的控制一般需要一个20ms左右的时基脉冲,该脉冲的高电平部分一般为0.5ms-2.5ms范围内的角度控制脉冲部分,总间隔为2ms。以180度角度伺服为例,那么对应的控制关系是这样的:
0.5ms------------0度;1.0ms------------45度;
1.5ms------------90度;
2.0ms-----------135度;
2.5ms-----------180度;
计算
如果要使用PWM就必须计算出频率和占空比
频率:以SG90为例,它的时基脉冲为20ms也就是周期为20ms,则频率=周期的倒数为50HZ,也就是1秒钟内可以转动50次。注意SG90 脉冲周期为20毫秒(millisecond) 不是20微秒(Microsecond),两者差1000倍呢!
-
占空比:以SG90为例,占空比的计算方法为=脉宽/周期,由此可以得出
0.5ms------------0度---------------2.5%;1.0ms------------45度--------------5%;
1.5ms------------90度--------------7.5%;
2.0ms-----------135度--------------10%;
2.5ms-----------180度--------------12.5%;
- 实践
实际上在操作中我们最常用到的函数为
pwm.setup(pin, clock, duty)--------------初始化pwm
pwm.start(pin)---------------------------启动pwm
pwm.close(pin)--------------------------退出pwm
pwm.stop(pin)---------------------------暂停pwm
pwm.setclock(pin,clock)-----------------设置pwm的频率1~1000
pwm.setduty(pin,duty)-------------------设置pwmd占空比0~1024
废话不多说,上代码
pin = 1 --输出引脚
pwm.setup(pin,50,77) --初始化引脚为50HZ,占空比为77=1024*7.5为90度
pwm.start(pin)
tmr.delay(1000000) --延时1秒
pwm.setduty(pin,52) --重新设置占空比为52=1024*5%为45度
tmr.delay(1000000)
pwm.setduty(pin,77) --返回初始化状态
pwm.stop(pin) --停止PWM
- 番外-呼吸灯程序
例子:呼吸灯
pin = 4
pwm.setup(pin,500,512)--初始化频率为500,占空比为512
pwm.start(pin)--启动pwm输出
while true do
for var=0,1023,1 do
pwm.setduty(pin, var)--调整占空比
tmr.delay(1000)
tmr.wdclr()--喂狗
end
for var=1023,0,-1 do
pwm.setduty(pin, var)
tmr.delay(1000)
tmr.wdclr()
end
end
注:
SG90有两个角度选择,一个是360度一个是180度,如果要控制角度就选择180度的舵机,如果要控制速度就选择360度的舵机
二、encoder模块
这个模块应该很不起眼,但是在我的项目开发中我非常需要它。我在使用nodemcu串口时发现,我别的模块向nodemcu发送hex数据时,nodemcu显示为乱码,这应该就是nodemcu串口不支持读取hex数据,所以我们需要将读取到的文件转换成hex在进行输出就可以了,现在我们先来看看encoder里都有什么函数。
序号 | 函数名 | 参数 | 返回值 | 作用 |
---|---|---|---|---|
1 | encoder.toBase64() | binarystr | Base64str | 提供(二进制)Lua字符串的Base64表示。 |
2 | encoder.fromBase64() | b64str | binarystr | 将(二进制)Lua字符串的Base64表示形式解码回原始字符串。 |
3 | encoder.toHex() | binarystr | hexstr | 提供(二进制)Lua字符串的ASCII十六进制表示。 |
4 | encoder.fromHex() | hexstr | Decodedstr | 返回ASCII十六进制字符串的Lua二进制字符串解码。 |
注:
encoder函数的参数和返回值都为字符串!!!,例子比较简单就不写出来了,可以点开对应的函数进行学习。
三、Timer模块
由于tmr模块中alarm发送改变,所以我这里写出最新的使用方法。alarm使用方法官方API
- 句法
tobj:alarm(interval_ms, mode, func()) - 参数
-
interval_ms
计时器间隔,以毫秒为单位。最大值为6870947(1:54:30.947)。 -
mode
定时器模式:-
tmr.ALARM_SINGLE
一次性报警(无需拨打电话unregister()
) -
tmr.ALARM_SEMI
手动重复报警(调用start()
重启) -
tmr.ALARM_AUTO
自动重复报警
-
-
func(timer)
使用timer对象作为参数调用的回调函数
-
- 返回值
true如果计时器启动,false则出错 - 例子
if not tmr.create():alarm(5000, tmr.ALARM_SINGLE, function()
print("hey there")
end)
then
print("whoopsie")
end
四、小贴士
- 直接使用init.lua写代码时若出现死循环或者无法进行操作时可以重新烧入固件(缺少代码中所用到的模块)就可以进行操作了。