Microbit Micropython API
microbit 的模块
所有直接与硬件相关的microbit模块，为方便使用，可将其全部导包进来：
from microbit import *接下来的步骤都默认你执行了这一步（导入所有的包：from microbit import *）；
许多函数都可直接使用：
#参数ms，休眠指定的时间，单位毫秒
sleep(ms)
#返回与最后一次开启的时间差，单位毫秒
running_time()
#使microbit开发板进入应急模式
#通常由内存不足引起，并且会显示一个悲伤的图片
#会生成任意的错误代码（error_code）
panic(error_code)
#复位microbit开发板
reset()其余的功能模块会在下面接着叙述。
注意：使用毫秒为标准单位，只接受整数参数。
Buttons（按钮）
microbit开发板有两个button，分别为
button_a
button_b两个button都是对象，有以下方法：
#当该button正被按下时，返回True；否则返回False
button.is_pressed()
#开发板运行以来，button曾经被按下，则返回True；否则返回False
button.was_pressed()
#返回button被按下的次数，然后重新重0开始计数
button.get_presses()The LED display（LED显示）
LED通过display对象来显示：
# 根据像素（x，y）来获取亮度，亮度值范围为0（led关闭）到 9（led亮度最大）
display.get_pixel(x,y)
# 设置像素（x，y）的亮度值为val（0-9）
display.set_pixel(x,y,val)
# 清空显示
display.clear()
# 显示image图像
display.show(image,delay=0,wait=True,loop=False,clear=False)
# 每隔固定时间（毫秒），显示不同的图像和字母
display.show(iterable,delay=400,wait=True,loop=False,clear=False)
# 滚动显示字符串
display.scroll(string,delay=400)Pins（引脚）
提供数字和模拟的输入，输出功能。许多pins被连接到内部I/O，比如led矩阵和按钮。每个pin都可以在microbit的模块中找到。能相对轻松的使用它们：
- pin0
- pin1
- …
- pin15
- pin16
- pin19
- pin20
注意：pin17和pin18不允许使用pins在microBitPin中被实例化。
可使用的API：
# value可以设置为0,1,False,True
pin.write_digital(value)
# 返回1或者0
pin.read_digital()
# value可设置为0到1023之间的值
pin.write_analog(value)
# 返回0到1023之间的整数
pin.read_analog()
#设置pin的PWM频率，单位毫秒
pin.set_analog_period(int)
#设置pin的PWM频率，单位微秒
pin.set_analog_period_microseconds(int)
#返回布尔值
pin.is_touched()Images（图像）
注意：你不需要总是自己自定义图像，你可以通过display.image来使用内置图像。display.image是Image的实例，你可以调用许多这样的实例。
Images API：
#创建一个空的5*5图像
image=Image()
#根据字符串创建图像。字符串中以冒号区分，每个冒号隔开的内容表示一行led灯的显示，数字0下标
#代表对应位置led关闭，9代表对应下标的led亮度最大
image=Image('90009:09090:00900:09090:90009:')
# 创建一个指定大小的图片
image=Image(width,height)
# 初始化一个特定宽度高度的图像，buffer是一个数组，长度为高度乘以宽度
image=Image(width,height,buffer)
# 返回图像的宽度（最大为5）
image.width()
# 返回图像高度（最大为5）
image.height()
# 设置像素的位置 (在 0 到 9之间).常数图像可能会失效
image.set_pixel(x,y,value)
# 获得像素的位置 (在 0 到 9之间)
image.get_pixel(x,y)
# 图片左移n位，返回一个新图像.
image.shift_left(n)
# 图片右移n位，返回一个新图像.
image.shift_right(n)
#图片上移n位，返回一个新图像.
image.shift_up(n)
#图片下移n位，返回一个新图像.
image.shift_down(n)
#得到一个紧凑的字符串表示的图像
repr(image)
#得到一个更可读的字符串表示的图像
str(image)
# 创建一个由两个图片叠加的图片
image+image
#返回一个新的图像由每个像素的亮度乘以n
image*n
# 内置图像.
Image.HEART
Image.HEART_SMALL
Image.HAPPY
Image.SMILE
Image.SAD
Image.CONFUSED
Image.ANGRY
Image.ASLEEP
Image.SURPRISED
Image.SILLY
Image.FABULOUS
Image.MEH
Image.YES
Image.NO
Image.CLOCK12# 时钟12点
Image.CLOCK11
...# 许多时钟图像 (Image.CLOCKn)
Image.CLOCK1#时钟1点
Image.ARROW_N
Image.ARROW_NW
Image.TRIANGLE
Image.TRIANGLE_LEFT
Image.CHESSBOARD
Image.DIAMOND
Image.DIAMOND_SMALL
Image.SQUARE
Image.SQUARE_SMALL
Image.RABBIT
Image.COW
Image.MUSIC_CROTCHET
Image.MUSIC_QUAVER
Image.MUSIC_QUAVERS
Image.PITCHFORK
Image.XMAS
Image.PACMAN
Image.TARGET
Image.TSHIRT
Image.ROLLERSKATE
Image.DUCK
Image.HOUSE
Image.TORTOISE
Image.BUTTERFLY
Image.STICKFIGURE
Image.GHOST
Image.SWORD
Image.GIRAFFE
Image.SKULL
Image.UMBRELLA
Image.SNAKE
Image.ALL_CLOCKS
Image.ALL_ARROWSThe accelerometer（加速计）
加速度访问的是accelerometer对象：
# 读取设备X轴的值
accelerometer.get_x()
#读取设备Y轴的值
accelerometer.get_y()
#读取设备Z轴的值
accelerometer.get_z()
# 返回一个元组（包含设备的x，y，z三轴的值）
accelerometer.get_values()
# 返回当前执行的
gesture.accelerometer.current_gesture()
# 如果指定的gesture是当前运行的，返回True，否则返回False
accelerometer.is_gesture(name)
#如果指定的gesture是曾经运行，返回True，否则返回False
accelerometer.was_gesture(name)
# 返回历史状态，最新的列在最后
accelerometer.get_gestures()内置的动作包含：up,down,left,right,faceup,facedown,freefall,3g,6g,8g,shake
The compass（指南针）
指南针访问的是compass对象：
# 校准指南针 (需要得到准确的读数).
compass.calibrate()
# 指向北方得到一个准确的读数
compass.heading()
# 返回一个数字表明磁场强度
compass.get_field_strength()
# 如果校准成功，返回True，否则返回False
compass.is_calibrated()
# 重置指南针的校准状态
compass.clear_calibration()I2C bus（I2C总线）
microbit开发板有一个I2C，访问的是I2C对象：
# 从地址addr读取n个字节; repeat=True 表示停止位不会被发送
i2c.read(addr,n,repeat=False)
# 将buf的内容写到地址addr; repeat=True表示停止位不会被发送
i2c.write(addr,buf,repeat=FalseUART（串口）
使用uart与开发板的串口I/O连接：
# 建立连接 (使用 pins 0 [TX] 和 1 [RX]) ，波特率设置为 9600.
uart.init()
# 如果有字符等待读取返回True，否则返回False
uart.any()
# 返回读取n长度的字符串
uart.read(n)
# 返回所有读到的字符串
uart.readall()
# 返回读取一行内容的字符串
uart.readline()
# 将读取的内容保存到buffer中
uart.readinto(buffer)
# 将buffer的内容写到已经连接的开发板中
uart.write(buffer)