指南针

bibo.compass 模块提供对板载电子指南针的访问。使用前应先校准，否则读数可能不准。

函数

calibrate()

启动校准流程：先滚动提示信息，再请用户旋转设备，在 LED 上绘制圆圈。

is_calibrated()

返回值：已成功校准时为 True，否则为 False。

clear_calibration()

清除校准数据，指南针回到未校准状态。

get_x()

返回值：X 轴磁场强度，单位纳特斯拉（nT），有符号整数。

get_y()

返回值：Y 轴磁场强度，单位 nT，有符号整数。

get_z()

返回值：Z 轴磁场强度，单位 nT，有符号整数。

heading()

返回值：根据三轴读数计算的航向角，0–360 的整数，顺时针，正北为 0°。

get_field_strength()

返回值：设备周围磁场强度的整数指示，单位 nT。

示例

from bibo import *

if not compass.is_calibrated():
    compass.calibrate()

while True:
    heading = compass.heading()
    display.scroll(str(heading))
    sleep(500)

将 micro:bit 平放并缓慢转动，可在比卜创造 Python 编辑器中观察航向变化。首次运行请按屏幕提示完成校准。