管脚接口(Python)
概要
小龟主控板拥有一套非常简洁的管脚端口操作语法。
查询触摸状态(is_pressed)
语法:
- Pin.is_pressed()
- car.pin.is_pressed(pin)
说明:
查询指定的管脚是否处于被触摸中。
参数:
- pin 管脚名称
- 返回值 返回是否被触摸
范例:
#查询按键A是否被按下
A.is_pressed()
car.pin.is_pressed(A)
GPIO功能(gpio)
语法:
- car.gpio(pin) #读管脚
- car.gpio(pin, val) #写管脚
说明:
设置或者读取指定管脚的状态。
参数:
- pin 管脚名称
- val 设置管脚状态 0-设置管脚为低位,1-设置管脚为高位,缺省为读取管脚当前状态
- 返回值 返回管脚状态
范例:
#查询A1管脚的状态
car.gpio(A1)
打开管脚(on)
语法:
- car.on(pin)
- Pin.on()
说明:
设置指定管脚输出高位信号。
参数:
- pin 管脚名称
范例:
#打开D3管脚
car.on(D3)
关闭管脚(off)
语法:
- car.off(pin)
- Pin.off()
说明:
设置指定管脚输出低位信号。
参数:
- pin 管脚名称
范例:
#关闭管脚SCL
car.off(SCL)
查询管脚状态(val)
语法:
- car.val(pin)
- Pin.val()
说明:
查询管脚当前状态。
参数:
- pin 管脚名称
- 返回值 返回管脚状态
范例:
#查询管脚SDA的状态
car.val(SDA)
发送脉冲(pulse)
语法:
- Pin.pulse(level, keep)
- car.pin.pulse(pin, level, keep)
说明:
输出指定高低位指定时长的脉冲信号。
参数:
- pin 管脚名称
- level 脉冲信号状态,0-低位,1-高位
- keep 脉冲持续时长
范例:
#在A1管脚上发送10毫秒的高位脉冲信息
car.pin.pulse(A1, 1, 0.01)
操控舵机(servo)
语法:
- car.pin.servo(pin, 目标角度, 耗时)
- car.pin.servo(pin)
- Pin.servo(angle)
说明:
设置接在指定管脚上的舵机角度。
参数:
- pin 管脚名称
- angle 舵机角度 0 - 180,代表0到180度。
- 耗时 期望用多少秒实现舵机旋转到指定角度。
- 返回值 返回管脚状态
范例:
#控制接在A1管脚上的舵机旋转到90度
car.pin.servo(A1, 90)
#另一种写法
A1.servo(90)
设置PWM信号频率(pwm_freq)
语法:
- car.pin.pwm_freq(pin, freq)
- car.pin.pwm_freq(pin)
说明:
设置整块主控板的PWM输出频率。
参数:
- pin 管脚名称
- freq PWM输出频率
范例:
#设置主控板PWM信号频率为100Hz
car.pin.pwm_freq(A1, 100)
设置PWM信号占空比(pwm_duty)
语法:
- car.pin.pwm_duty(pin, duty)
- car.pin.pwm_duty(pinl)
说明:
设置指定管脚输出的PWM信号的占空比。
参数:
- pin 管脚名称
- duty PWM信号的占空比,0 - 100,代表0%到100%
范例:
#设置A1管脚发送50%占空比的PWM信号
car.pin.pwm_duty(A1, 50)