parrot --- 掌控拓展板驱动

../../_images/extboard_back.png

掌控拓展板parrot是mPython掌控板衍生的一款体积小巧、易于携带。支持电机驱动、语音播放、语音合成等功能的IO引脚扩展板,可扩展12路IO接口和2路I2C接口。 该库为掌控拓展板提供电机驱动,LED驱动等功能。

电机控制I2C通讯协议数据格式:

Type Command motor_no speed(int)
控制电机 0x01 0x01/0x02 -100~100

当 'speed' 为负值,反转;当为正值,正转。


parrot.MOTOR_1

M1电机编号,0x01

parrot.MOTOR_2

M2电机编号,0x02

parrot.set_speed(motor_no, speed)[源代码]

设置电机速度

参数:
  • motor_no (int) -- 控制电机编号,可以使用 MOTOR_1, MOTOR_2 ,或者直接写入电机编号。
  • speed (int) -- 电机速度,范围-100~100,负值代表反转。
parrot.get_speed(motor_no)[源代码]

返回电机速度

参数:motor_no (int) -- 控制电机编号,可以使用 MOTOR_1, MOTOR_2,或者直接写入电机编号。
返回类型:int
返回:返回该电机速度
parrot.led_on(no, brightness=50)[源代码]

打开灯。电机接口,除了可以驱动电机,还能做灯的控制。

参数:
  • no (int) -- 控制电机编号,可以使用 MOTOR_1, MOTOR_2,或者直接写入电机编号。
  • brightness (int) -- 设置亮度,范围0~100
parrot.led_off(no)[源代码]

关闭灯。

参数:no (int) -- 控制电机编号,可以使用 MOTOR_1, MOTOR_2,或者直接写入电机编号。
parrot.get_battery_level()[源代码]

获取拓展板的电压值。

返回:返回电量,单位mV。
class parrot.IR_encode[源代码]

红外编码类

encode_raw(carry_freq, len, repeat_pos, code, data)[源代码]

制作任意编码。

参数:
  • carry_freq (int) -- 载波频率,单位hz。
  • len (int) -- 加上循环码后的单次发码的code总数
  • repeat_pos (int) -- 循环码位置
  • code (int) -- code列表,16个成员,记录8组不同的高低电平波形
  • data (char) -- 编码波形数据,最长64字节
返回:

返回编码后的红外脉冲数据buff

encode_nec(user_code, command_code)[源代码]

NEC编码。

参数:
  • user_code (int) -- 用户码
  • command_code (int) -- 命令码
返回:

返回编码后的红外脉冲数据buff

class parrot.IR[源代码]

红外收发管的抽象类,用于红外发射和学习。

send(buff, repeat_en=0)[源代码]

发送红外脉冲数据buff

参数:
  • buff (bytes) -- 可以是 IR_encode.encode_nec 返回的buff。或,学习后的buff。
  • repeat_en (init) -- 重复码。用于表示按键常按。当repeat_en为1时,会不断发送重复码,直至 stop_send 停止发送。
stop_send()[源代码]

停止发送,当发送重复码后,使用该函数来停止发送。

learn(wait=True)[源代码]

红外学习。默认下wait为True,此时为阻塞函数。learn()开始后,须在5秒内,常按住被学习对象按键。当学习完成后,会返回学习结果,成功True,失败Fail。wait 为 False,则为非阻塞,此时不返回结果。

参数:wait (bool) -- 是否阻塞。
返回:bool类型,返回结果
get_learn_data()[源代码]

返回学习后的,红外编码数据。该函数须在 learn 函数后使用。

返回:返回编码后的红外脉冲数据buff
电机驱动示例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import parrot
from mpython import sleep_ms,sleep

# 可设置速度范围为-100到100。
# 当值为正值时,电机正转;为负值时,电机反转;


while True:

    # 设置正转速度100
    parrot.set_speed(parrot.MOTOR_1,100)   
    parrot.set_speed(parrot.MOTOR_2,100)   
    print("current motor speend: %d,%d" %(parrot.get_speed(parrot.MOTOR_1),parrot.get_speed(parrot.MOTOR_2)))    #获取电机速度
    sleep(5)
    # 设置反转速度100
    parrot.set_speed(parrot.MOTOR_1,-100)   
    parrot.set_speed(parrot.MOTOR_2,-100)   
    print("current motor speend: %d,%d" %(parrot.get_speed(parrot.MOTOR_1),parrot.get_speed(parrot.MOTOR_2)))    #获取电机速度
    sleep(5)
    # 停止  
    parrot.set_speed(parrot.MOTOR_1,0)   
    parrot.set_speed(parrot.MOTOR_2,0)   
    print("current motor speend: %d,%d" %(parrot.get_speed(parrot.MOTOR_1),parrot.get_speed(parrot.MOTOR_2)))    #获取电机速度
    sleep(2)
NEC编码红外发码示例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
import parrot
import time

ir_code = parrot.IR_encode()

ir = parrot.IR()
ir_buff = ir_code.encode_nec(1, 85)
while True:
    ir.send(ir_buff, 1)
    time.sleep(3)
    ir.stop_send()
    time.sleep(3)
NEC编码红外学习示例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
from mpython import *
import parrot
import time

def on_button_a_pressed(_):
    global data
    ir.learn()
    time.sleep(4)
    if 0 == ir.__get_learn_status():
        data = ir.get_learn_data()
        print(data)
    else:
        print('什么都没学到...')

button_a.event_pressed = on_button_a_pressed

def on_button_b_pressed(_):
    global data
    print(data)
    ir.send(data, 0)

button_b.event_pressed = on_button_b_pressed

ir = parrot.IR()
data = None