2.导入buildingbit库

您当前位置: 首页 > Building:bit积木套件 > 1.课前准备

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

一、下载buildingbit库

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

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

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

image.png

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

image.png

二、检测与验证

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

image.png

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/