micro:bit MicroPython API 速查手册20 模块从 microbit 到 utime 的完整参考清单【免费下载链接】micropythonPort of MicroPython for the BBC micro:bit项目地址: https://gitcode.com/gh_mirrors/mic/micropython本手册面向 BBC micro:bit 板卡提供 MicroPython 版 **micro:bit MicroPython API 速查**从核心microbit模块到utime、machine、radio、speech等 20 内置模块一页掌握所有可用对象、方法与常量。无论你是第一次接触 micro:bit MicroPython还是想快速查阅display、pin、image的具体用法这份完整参考清单都能帮你 3 分钟定位到目标 API。模块全家福micro:bit MicroPython 内置模块一览表本移植版Port将全部模块编译进固件启动即可用无需import额外依赖。模块注册表定义在 mpconfigport.h对照下表可一眼看全模块定位典型用途microbit核心模块引脚、按钮、显示、加速度计、罗盘等对象入口machine底层硬件读取 MCU 频率、唯一 ID、内存读写utime时间模块睡眠、毫秒计时、周期任务display/button_a/pin0…全局快捷对象免 import 直接调用display等已注入全局命名空间music音乐播放 20 余首内置旋律、自定义音阶audio原始音频播放 WAV 文件、生成自定义 AudioFramespeech语音合成英文朗读、唱歌、音调/语速调节radio2.4GHz 无线两台 micro:bit 之间收发数据neopixelLED 灯带驱动 WS2812 像素灯random随机数randint、choice、uniform 等os文件系统listdir、读/写/删除文件this/antigravity/love趣味模块作者信息、彩蛋、表白collections/struct/time别名模块分别指向 collections、ustruct、utime核心模块 microbit最常用的 20 个对象与函数microbit模块是 API 的中枢源码位于 modmicrobit.cpp。它的完整符号表见 qstrdefsport.h。顶层函数速查函数说明microbit.temperature()读取板载温度摄氏度microbit.running_time()开机后经过的毫秒数microbit.sleep(ms)休眠指定毫秒microbit.panic(n)用错误码在 LED 矩阵上报错microbit.reset()复位板卡设备对象速查对象类型关键方法microbit.displayMicroBitDisplayshow、scroll、set_brightnessmicrobit.button_a/button_bMicroBitButtonis_pressed、was_pressed、get_pressesmicrobit.pin0~pin20MicroBitPinread_digital、write_digital、read_analog、write_analog、set_analog_periodPWM、is_touchedmicrobit.accelerometerMicroBitAccelerometerget_x/y/z、current_gesture、set_range(3g/6g/8g)microbit.compassMicroBitCompassheading、calibrate、is_calibrated、get_x/y/zmicrobit.i2cMicroBitI2Cinit、read、writemicrobit.spiMicroBitSPIinit、write、write_readintomicrobit.uartMicroBitUARTinit、read、readline、writemicro:bit 共提供 20 个 GPIO 引脚含触摸引脚 0/1布局如下pin19/pin16还兼作 I2C 与 SPI 接口display 显示模块让 5x5 LED 矩阵动起来display直接注入全局命名空间无需 import。核心能力display.show(对象, delay, loop)显示图像、字符串、列表display.scroll(字符串, delay, loop, wait)文字滚动display.set_brightness(0-255)调节亮度display.set_display_mode(Facade/3D)切换点阵渲染模式image 图像模块45 个内置 5x5 图案image.Image提供像素级操作set_pixel、get_pixel、invert、fill、shift_left/right/up/down、monospace、blit。内置图案分三类全部是模块常量可直接display.show(image.HEART)类别常量示例表情HEART、HAPPY、SAD、ANGRY、SURPRISED、GHOST时钟/方向CLOCK1~CLOCK12、ARROW_N~ARROW_NW、ALL_CLOCKS、ALL_ARROWS图案/物体CHESSBOARD、DIAMOND、RABBIT、XMAS、PACMAN、SKULL、TORTOISE图像构建逻辑在 microbitimage.cpp常量像素数据由 microbitconstimagetuples.c 生成完整清单见 image.rst。utime 与 machine时间与底层硬件速查utime 时间模块源码位于 modutime.ctime模块是其别名见模块表常用 APIutime.sleep(s)/utime.sleep_ms(ms)/utime.sleep_us(us)utime.ticks_ms()/utime.ticks_diff(a, b)毫秒时间戳与差值utime.ticks_us()微秒级计时适合短周期任务machine 底层模块实现见 modmachine.cmachine.freq()MCU 主频16MHznRF51822machine.unique_id()8 字节硬件唯一 ID适合给设备命名machine.mem8/mem16/mem32内存直接读写machine.disable_irq()/machine.enable_irq()中断控制machine.time_pulse_us精确脉冲计时通信与存储radio、i2c/uart/spi、osradio 无线模块让两台 micro:bit 用 2.4GHz 射频通信配置参数一目了然方法说明radio.on()/radio.off()开关射频radio.config(group, channel, address, data_rate)设置分组/信道/地址/速率RATE_250KBIT/RATE_1MBIT/RATE_2MBITradio.send()/radio.receive()收发文本或字节radio.receive_full()/radio.receive_bytes_into()可靠接收带队列长度检查radio.length、radio.queue教程可参考 radio.rst收发实现见 modradio.cpp。文件存储 os 模块micro:bit 内置 FLASH 文件系统os模块提供os.listdir()列出文件、open(文件名, r/w)读写、os.remove()删除。存储细节见 storage.rst 与 filesystem.rst声音三件套music、audio、speech 模块分工模块场景关键 APImusic旋律/音阶music.play(music.ODDITY)播放 20 余首内置曲music.pitch(...)自定义音符music.set_tempo(bpm)audio原始波形audio.play(file.wav)AudioFrame自定义采样is_playing()查询状态speech语音合成speech.say(hello)、speech.pronounce(...)、speech.sing(...)支持pitch/speed/throat调节曲库常量BIRTHDAY、CHASE、FUNERAL等 20 首定义在 modmusictunes.c语音模块见 speech.rst 与 modspeech.c。neopixel 灯带与 random 随机数neopixelNeoPixel(pin, n, bpp3)创建 WS2812 灯带对象pixel[i] (r,g,b)设色pixel.show()刷新pixel.clear()熄灭。示例项目见 neopixel_random.py。randomrandom.randint(a,b)、random.randrange(n)、random.choice(seq)、random.uniform(a,b)、random.getrandbits(k)、random.seed(s)。一分钟上手从零跑通第一个 MicroPython 脚本在 REPL 中输入import microbit大部分对象实际已在全局命名空间用display.show(HI)验证点阵屏用microbit.button_a.was_pressed()做交互用utime.sleep_ms(100)控制节奏想深入某模块时回到上面的速查表定位方法名再对照 docs 下的对应 .rst 文档。 小贴士display、button_a、pin0这类对象已预注入全局命名空间可以直接调用但music、radio、speech等模块仍需import。完整 API 参考见 microbit_micropython_api.rst各模块单独文档在 docs/ 目录下如 utime.rst、radio.rst、machine.rst。掌握这张从microbit到utime的完整参考清单micro:bit MicroPython 开发就没有死角——遇到任何硬件功能先查模块表再查方法表两分钟内即可上手。【免费下载链接】micropythonPort of MicroPython for the BBC micro:bit项目地址: https://gitcode.com/gh_mirrors/mic/micropython创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考