2.导入tinybit库

您当前位置: 首页 > Tiny:bit Pro小车 > 7.Micro-python课程

2.导入tinybit库.zip  点击下载

一、下载tinybit库

1.首先用microUSB数据线连接电脑与microbit主板。

2.把tinybit的库文件放在C:UsersAdministratormu_code文件夹下。

这里以V1.1版本的为例。

image.png

3.右键点击tinybit_micropython_V1.1.hex文件,然后选择发送到microbit主板上。

image.png

二、检测与验证

1.下载完成库文件完成后,打开MU软件,点击REPL按钮,在下方弹出的窗口中可以看到tinybit字样。如果没有看到tinybit的信息,请重新插拔一下microbit主板并重新下载tinybit的库文件。

image.png

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/