引脚

编辑器积木分类：引脚。添加比卜创造 Micro:bit 主扩展后，本分组会自动出现。

本页按积木列出说明：积木脚本展示、使用样例（blocks）与简要提示。文案以编辑器当前版本为准。

数字读取

读取引脚的数字电平，返回 0 或 1。

使用样例

开关接到 P0 与 3V/GND 时可读 0/1。

数字写入

向引脚写入数字 0 或 1。

使用样例

可驱动 LED（注意限流电阻）。

模拟读取

读取引脚模拟值（约 0–1023）。

使用样例

电位器中心脚接 P0，另外两脚接 3V 与 GND。

模拟写入

向引脚写入模拟值（0–1023）。

使用样例

适合 PWM 调光。

当引脚接通

当触摸引脚被接通（如用手指接到 GND）时启动。

使用样例

用导线或手指把 P0 接到 GND 试试。

当引脚被按下时

判断触摸引脚此刻是否被按下/接通。

使用样例

文案是「当…被按下时」，但是布尔侦测块。

映射

把数值从旧区间线性映射到新区间。

使用样例

常把 0–1023 映射到 0–4 去做点阵坐标。

设置模拟期间

设置引脚模拟 PWM 的周期（微秒）。

使用样例

舵机常用约 20000 µs 周期。

设置音频引脚

指定外接喇叭/蜂鸣器使用的音频引脚。

使用样例

外接无源蜂鸣器时常接到 P0。

设置音频引脚启用

启用或禁用音频引脚输出。

使用样例

与「内置扬声器」开关配合使用。

设置上拉/下拉

设置引脚上拉 / 下拉 / 无。

使用样例

开关一侧接地时，常用上拉得到稳定默认高电平。

设置引脚事件

配置引脚触发哪类事件（边缘、脉冲、触摸等）。

使用样例

先配置事件类型，再配合脉冲/接通类帽子。

设为触摸模式

把 P0/P1/P2 或徽标设为电容/电阻触摸模式。

使用样例

徽标也可选；模式影响触摸灵敏度。

当引脚脉冲

检测到指定边沿脉冲时启动脚本。

使用样例

适合接外部模块的脉冲输出。

脉冲持续时间

报告最近一次指定边沿脉冲的持续时间（微秒）。

使用样例

可与超声波等模块配合测脉宽。

SPI 频率

设置 SPI 时钟频率。

使用样例

先设引脚与格式，再通信。

SPI 格式

设置 SPI 数据位数与模式。

使用样例

位数与模式必须与外设手册一致。

SPI 写入

通过 SPI 写入一个字节。

使用样例

写入值按外设协议解释。

SPI 设置引脚

指定 SPI 的 MOSI / MISO / SCK 引脚。

使用样例

默认示例对应常见接线；请按模块改引脚。