一、下载tinybit库
1.首先用microUSB数据线连接电脑与microbit主板。
2.把tinybit的库文件放在C:UsersAdministratormu_code文件夹下。
这里以V1.1版本的为例。
3.右键点击tinybit_micropython_V1.1.hex文件,然后选择发送到microbit主板上。
二、检测与验证
1.下载完成库文件完成后,打开MU软件,点击REPL按钮,在下方弹出的窗口中可以看到tinybit字样。如果没有看到tinybit的信息,请重新插拔一下microbit主板并重新下载tinybit的库文件。
2.下载了tinybit的库后,下次用MU下载程序不需要再次下载,重新插拔microbit主板也会保留库文件,但是当下载图形化的hex程序时,会刷新tinybit的库,变成官网的microbit的库,所以建议不要和图形化的程序混合下载。
三、Tinybit库API简介
A.导入tinybit_micropython库
import tinybit
tinybit.car_HeadRGB(a, b, c)
功能:设置车头大灯RGB值
参数:a:R值(0~255),b:G值(0~255),c:B值(0~255)
tinybit.car_run(s)
tinybit.car_run(a, b)
功能:控制小车前进
参数:单独一个参数s,设置小车两个电机前进速度值都为s(0~255)
两个参数,参数a设置左边电机前进速度(0~255),参数b设置右边电机前进速度(0~255)
tinybit.car_back(a)
tinybit.car_back(a, b)
功能:控制小车后退
参数:单独一个参数s,设置小车两个电机后退速度值都为s(0~255)
两个参数,参数a设置左边电机后退速度(0~255),参数b设置右边电机后退速度(0~255)
tinybit.car_left(a)
功能:控制小车左转(左轮不动,右轮前进)
参数:a:设置右边电机前进速度(0~255)
tinybit.car_right(a)
功能:控制小车右转(右轮不动,左轮前进)
参数:a:设置左边电机前进速度(0~255)
tinybit.car_spinleft(s)
tinybit.car_spinleft(a, b)
功能:控制小车左旋(左轮后退,右轮前进)
参数:单独一个参数s,设置小车左边电机后退速度为s(0~255),设置右边电机前进速度也为s(0~255)
两个参数,参数a设置左边电机后退速度(0~255),参数b设置右边电机前进速度(0~255)
tinybit.car_spinright(a)
tinybit.car_spinright(a, b)
功能:控制小车右旋(左轮前进,右轮后退)
参数:单独一个参数s,设置小车左边电机前进速度为s(0~255),设置右边电机后退速度也为s(0~255)
两个参数,参数a设置左边前进电机速度(0~255),参数b设置右边电机后退速度(0~255)
tinybit.car_stop()
功能:小车停止
tinybit.setMotorPWM(a, b, c)
功能:设置电机PWM值
参数:a:表示左边电机速度(-255~255),正数为前进,负数为后退,零为停止
b:表示右边电机速度(-255~255),正数为前进,负数为后退,零为停止
c:延迟时间(ms)
tinybit.ultrasonic()
功能:获取超声波当前距离数据(cm)
tinybit.traking_sensor_L()
功能:左边寻线传感器,黑线返回true,白线返回false
tinybit.traking_sensor_R()
功能:右边寻线传感器,黑线返回true,白线返回false
tinybit.getVoicedata()
功能:获取声音传感器的值
tinybit.init_IR(a)
功能:初始化红外遥控接收器
参数:a:红外接收器对应的引脚pin8
tinybit.get_IR(a)
功能:返回红外遥控按下的键值
参数:a:红外接收器对应的引脚pin8
B.手柄库ghandle
import ghandle
ghandle.B1_is_pressed()
功能:按键B1(红色),按下返回True,松开返回False
ghandle.B2_is_pressed()
功能:按键B2(绿色),按下返回True,松开返回False
ghandle.B3_is_pressed()
功能:按键B3(蓝色),按下返回True,松开返回False
ghandle.B4_is_pressed()
功能:按键B4(黄色),按下返回True,松开返回False
ghandle.rocker(state)
功能:检测摇杆方向,与参数一致返回True,不一致返回False
参数:state:ghandle.up(向上),ghandle.down(向下),ghandle.left(向左),ghandle.right(向右),ghandle.pressed(按下),ghandle.noState(无操作)
ghandle.get_value_x()
功能:返回摇杆X通道的模拟值,左右移动数值会有变化,向左增加,向右减少
ghandle.get_value_y()
功能:返回摇杆Y通道的模拟值,上下移动数值会有变化,向上减少,向下增加
注意:tinybit-micropython的库是在官方microbit-microPython的库上增加了tinybit小车的驱动,其他的API可以到microbit-microPython官网上查阅。
https://microbit-micropython.readthedocs.io/en/latest/