寻求MicroPython完整文档及专属库（含BLE常量）的获取途径

开发者阿泽

2026-8-21

获取MicroPython专属库完整文档的途径

官方硬件端口源码
MicroPython的通用文档往往只覆盖核心API，像BLE这类硬件相关模块的细节，直接看对应硬件端口（比如ESP32、Pyboard）的源码是最权威的方式。比如ble.gap_advertise的常量，通常在端口目录下的ble.h、ble_constants.py或modbluetooth.c文件里，里面会完整列出所有支持的广播类型、标志位等枚举值。
交互式REPL探索
在设备的REPL里用内置工具直接查询：
1. 导入BLE相关模块后，用dir(模块名)列出所有属性，包括隐藏的常量；
2. 对gap_advertise函数调用help(ble.gap_advertise)，查看参数说明和关联常量；
  比如针对ESP32的BLE模块，输入：
```
import bluetooth
ble = bluetooth.BLE()
dir(bluetooth)
```
就能看到ADV_TYPE_IND、ADV_TYPE_NONCONN_IND等所有gap_advertise支持的常量。
社区整理的硬件特定文档
不少活跃的MicroPython社区会针对热门硬件（如ESP32、Raspberry Pi Pico）整理专属模块的完整API细节，包括BLE这类模块的常量列表，注意要匹配你使用的硬件端口，不同端口的实现可能有差异。
源码注释与示例细节
官方示例的注释里常隐含未在公开文档里列出的常量，另外查看模块源码的注释部分，也能找到文档遗漏的参数说明和常量定义。