一、下载buildingbit库
1.首先用microUSB数据线连接电脑与microbit主板。
2.把buildingbit的库文件放在C:UsersAdministratormu_code文件夹下。
这里以V1.2版本的为例。
3.右键点击buildingbit_micropython_V1.2.hex文件,然后选择发送到microbit主板上。
二、检测与验证
1.下载完成库文件完成后,打开MU软件,点击REPL按钮,在下方弹出的窗口中可以看到buildingbit字样。如果没有看到buildingbit的信息,请重新插拔一下microbit主板并重新下载buildingbit的库文件。
2.下载了buildingbit的库后,下次用MU下载程序不需要再次下载,重新插拔microbit主板也会保留库文件,但是当下载图形化的hex程序时,会刷新buildingbit的库,变成官网的microbit的库,所以建议不要和图形化的程序混合下载。
三、buildingbit库API简介
导入库 :import buildingbit
1、小车前进 buildingbit.car_run(100, 100, 0)
参数: 左轮速度(0-255),右轮速度(0-255), 延时时间(ms)
2、小车后退 buildingbit.car_back(100, 100, 0)
参数: 左轮速度(0-255),右轮速度(0-255), 延时时间(ms)
3、小车左转 buildingbit.car_left(100, 0)
参数: 右轮速度(0-255), 延时时间(ms)
4、小车右转 buildingbit.car_right(100, 0)
参数: 左轮速度(0-255), 延时时间(ms)
5、小车左旋 buildingbit.car_spinleft(100, 100, 0)
参数: 左轮速度(0-255),右轮速度(0-255), 延时时间(ms)
6、小车右旋 buildingbit.car_spinright(100, 100, 0)
参数: 左轮速度(0-255),右轮速度(0-255), 延时时间(ms)
7、小车停止 buildingbit.car_stop()
8、小车大灯 buildingbit.car_HeadRGB(255, 255, 255)
参数: R(0-255) G(0-255) B(0-255)
9、超声波返回距离 buildingbit.ultrasonic()
返回距离值(cm)
10、避障传感器 buildingbit.avoid_sensor()
返回: 有障碍物返回true,无障碍返回false
注意:用此函数时,必须关闭点阵显示,否则会冲突(microbit.display.off())
11、左巡线传感器 buildingbit.traking_sensor_L()
返回: 黑线返回true,白线返回false (巡线指示灯会黑线会亮)
12、右巡线传感器 buildingbit.traking_sensor_R()
返回: 黑线返回true,白线返回false (巡线指示灯会黑线会亮)
13、舵机控制 buildingbit.servo(1, 180)
参数: 舵机编号(1-3)舵机角度(0-180)
14、红外遥控初始化 buildingbit.init_IR(pin8)
参数:红外接的引脚
15、 返回红外按键值 buildingbit.get_IR(pin8)
参数:红外接的引脚
B.导入手柄库
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通道的模拟值,上下移动数值会有变化,向上减少,向下增加
注意:buildingbit-micropython的库是在官方microbit-microPython的库上增加了buildingbit套件的驱动,其他的API可以到microbit-microPython官网上查阅。
https://microbit-micropython.readthedocs.io/en/latest/