🔌 Arduino 扩展——在 Scratch 中进行实体计算 #
Arduino 扩展将现实世界中的电子技术和机器人技术引入 Scratch。
使用简单的积木控制 LED、 motor、舵机和传感器,创建可与现实世界互动的项目。
非常适合学生、创客和 STEM 教育。✨

🌟 概述 #
- 实体计算: 控制真实硬件,包括 LED、电机、舵机、传感器等。
- Arduino 支持: 支持 Arduino Uno、Mega、Nano、Leonardo 以及其他兼容开发板。
- 连接方式: 使用浏览器中的串口或 Bluetooth BLE 与 Arduino 通信。有关完整的连接步骤,请参阅:
如何将 Pishi.ai Scratch 扩展连接到 Arduino、机器人和其他硬件. - Standard Firmata: Arduino 使用 Firmata 协议与 Scratch 通信。
- 丰富的积木: 提供 40 多个积木,可用于数字和模拟输入输出、PWM、舵机、RGB LED、电机、I2C 等。
- 实时控制: 代码运行时,硬件会立即响应。
✨ 主要特点 #
- 数字输入/输出: 读取按钮、控制 LED、检测数字信号。
- 模拟输入: 读取光线、温度、距离、电位器等传感器。
- PWM 输出: 控制 LED 亮度、电机速度和 RGB 颜色。
- 舵机控制: 控制舵机角度并创建机器人动作。
- RGB LED 控制: 提供 13 种预设颜色,也支持自定义 RGB 数值、渐变和闪烁。
- 电机控制: 配合 H 桥控制直流电机的速度和方向。
- 声音 / 蜂鸣器: 提供 13 种预设声音模式,包括提示音、警报和 SOS。
- I2C 通信: 与高级传感器和设备进行通信。
- 智能引脚读取: 自动识别引脚模式,方便读取传感器。
- 高级积木: 支持边沿检测、阈值监测和数值映射。
🚀 如何使用 #
步骤 1 – 安装 StandardFirmata #
Arduino 上必须安装 StandardFirmata。
✔ 请按照以下指南操作:
如何在 Arduino 上安装标准 Firmata
步骤 2 – 将 Arduino 连接到 Scratch #
1. 打开: pishi.ai/play
2. 添加 Arduino 扩展
3. 点击“连接”按钮
4. 选择 Arduino 对应的端口
有关完整的连接步骤、权限设置、浏览器支持以及 macOS 的相关说明,请参阅:
🧱 积木和函数 #
⚡ 核心输入/输出 – 数字引脚 #
将数字引脚设置为 HIGH(1)或 LOW(0)。
可用于打开或关闭 LED、控制继电器或发送数字信号。
参数:
- PIN – 数字引脚编号,例如 2、3、13
- 0/1 – 0 = LOW(关闭),1 = HIGH(开启)
例如: write digital pin [13] [1] → 打开 Arduino 开发板上的内置 LED。
读取数字引脚当前的状态,返回 0(LOW)或 1(HIGH)。
可用于读取按钮、开关或数字传感器。
返回值: 0 或 1
例如: read digital pin [2] → 返回引脚 2 当前的 0(LOW)或 1(HIGH)状态。
📊 核心输入/输出 – 模拟与 PWM #
向引脚输出 PWM(脉冲宽度调制)信号,可用于控制亮度、速度或类似模拟输出的效果。
Arduino 开发板上的 PWM 引脚通常带有 ~ 标记。例如 Uno 上的 3、5、6、9、10 和 11 号引脚。
参数:
- PIN – 支持 PWM 的引脚编号
- VALUE – 百分比(0–100: 0 = 关闭, 100 = 最大输出
例如: write pwm pin [9] [50|text]% → 将 LED 亮度设置为 50%。
Arduino Uno 上通常为 a0–a5,Mega 上通常为 a0–a15。
返回值范围从 0(0V)到 1023(5V)。
返回值: 0–1023
例如: 电位器数值, 光线传感器亮度, 温度传感器电压
智能读取引脚—自动检测该引脚应作为数字引脚还是模拟引脚读取。
当你不确定引脚模式,或希望更灵活地读取传感器时非常有用。
返回值: 引脚值(数字 0/1 或模拟 0–1023)
💡 LED 控制 #
简单控制 LED 的开启和关闭。
这些积木可以方便地完成常见的 LED 操作。
例如:
- turn on led on pin [13] → 点亮开发板上的内置 LED。
- clear led on pin [13] → 关闭 LED。
让 LED 按指定次数闪烁,并分别设置亮起和关闭的时间。
可以创建快速闪烁、慢速闪烁、摩尔斯码等不同效果。
参数:
- PIN – LED 所连接的引脚
- TIMES – 闪烁次数
- ON_TIME – LED 亮起时间(毫秒)
- OFF_TIME – LED 关闭时间(毫秒)
例如: blink led on pin [13] [3|text] times, on: [200|text] off: [500|text] ms → LED 缓慢闪烁 3 次。
🌈 RGB LED 控制 #
使用自定义 RGB 数值(0–255)控制 RGB LED。
通过混合红色、绿色和蓝色,可以产生各种颜色。
参数:
- RPIN/GPIN/BPIN → 分别连接红、绿、蓝通道的 PWM 引脚。
- RED/GREEN/BLUE → 每个颜色通道的亮度,范围 0–255。
例如: set rgb led r:[9] g:[10] b:[11] to r:[255|text] g:[0|text] b:[0|text] → 显示纯红色。
使用颜色选择器为 RGB LED 选择颜色。
例如: 设置 rgb led r:[9] g:[10] b:[11] 为 [|text]
通过菜单选择预设颜色。
例如:
- 关闭、红色、绿色、蓝色、白色、黄色、青色、品红色、橙色、紫色、粉色、青柠色、靛蓝色
例如: set rgb led r:[9] g:[10] b:[11] to [yellow]
让 RGB LED 在两种颜色之间交替闪烁。
例如: blink rgb led r:[9] g:[10] b:[11] [red]↔[blue] [5|text]x[300|text] ms → 红色和蓝色交替闪烁 5 次。
创建平滑的 RGB LED 渐变效果。
可以从关闭状态逐渐亮到指定颜色,也可以从指定颜色逐渐变暗直到关闭。
例如: fade in r:[9] g:[10] b:[11] to [white] over [1000|text] ms → 在 1 秒内逐渐变亮为白色。
🔊 声音 / 蜂鸣器控制 #
在指定引脚上发出一个短提示音。
将蜂鸣器或压电扬声器连接到该引脚即可使用。
可以精确控制蜂鸣声持续的时间。
例如: beep on pin [8] for [500|text] ms → 发出半秒钟的提示音。
播放预设的蜂鸣器声音模式。 可以用于提示、通知、警告等。
可用模式:
- 短提示音 – 一个快速提示音
- 长提示音 – 一个较长的提示音
- 双提示音 – 两个快速提示音
- 三提示音 – 三个快速提示音
- 成功 – 短音 + 长音,适合表示任务完成
- 胜利 – 快速的庆祝声音
- 错误 – 不规则的错误提示音
- 警告 – 多次警告提示音
- 失败 – 两个较长的低落提示音
- 警报 – 三个紧急的长提示音
- 通知 – 柔和的通知声音
- 心跳 – 有节奏的“响—停—响”
- sos – 摩尔斯码 SOS 求救信号
例如:
立即停止蜂鸣器输出,或在指定时间内保持静音。
🤖 Servo Control #
控制舵机的位置。
角度范围为 0°–180°。
适合用于机械臂、云台机构和仿生机器人等项目。
参数:
- PIN – 舵机信号引脚,通常使用支持 PWM 的引脚
- ANGLE – 舵机角度,范围 0–180°
例如: set servo on pin [9] to angle: [90|text] 将引脚 [9] 上的舵机设置到角度 [90|text]
让舵机从一个角度平滑移动到另一个角度,并控制移动速度。
可以产生更加自然、平滑的机器人动作。
参数:
- SPEED 移动速度(1–100): 1 = 最慢, 100 = 最快
例如: move servo on pin [2] from: [0|text] to: [180|text] speed: [50|text]
停止向舵机发送控制信号。 舵机会进入放松状态。
⚙️ 电机控制 #
通过 H 桥控制直流电机的速度和方向。
常见的 H 桥驱动器包括:
参数:
- PIN1/PIN2 – H 桥控制引脚
- SPEED – 电机速度(0–100%)
- DIRECTION – 前进、后退或停止
例如: set motor on pins [9] [10] speed: [75|text] direction: [forward]
停止直流电机。 两个控制引脚都会被设置为 0。
🎯 高级传感器积木 #
等待数字引脚状态发生变化。
在条件满足之前,脚本会暂停。
适合用于按钮、开关或传感器触发。
例如: wait until digital pin [2] becomes [1] → 等待按钮被按下。
布尔判断积木。 如果引脚当前状态与指定状态相同,则返回“真”。
例如: is digital pin [2] [1] → 如果引脚 2 当前值为 1,则返回“真”。
检测数字信号的变化。
可检 "
上升沿:0 → 1
下降沿:1 → 0
任意变化"
适合用于事件检测、计数器和编码器。
边沿类型:
- rising – 从 LOW 变为 HIGH
- falling – 从 HIGH 变为 LOW
- change – 任何状态变化
例如: pin [2] [rising] edge detected? → 当引脚 2 从 0 变为 1 时返回“真”。
检查模拟传感器的数值是否位于指定范围内。
例如: is analog pin [a0] between [300|text] and [700|text]? → 当 a0 的读取值在 300–700 之间时返回“真”。
等待模拟传感器达到指定条件。 条件:" 高于, 低于, 等于 "
例如: above, below, equals
例如: wait until analog pin [a0] [above] [500|text] → 等待传感器数值大于 500。
检测模拟值是否发生较大变化。
适合检测运动、触摸或环境变化。
例如: analog pin [a0] changed by more than [50|text]→ 当 a0 的数值变化超过 50 时返回“真”。
🔧 配置积木 #
设置引脚的工作模式。
通常会自动设置,但高级项目中可以手动指定。
Modes:
- digital input – 数字输入 0/1(按钮、开关)
- digital input: pullup – 带内部上拉电阻的数字输入
- output: 0 – LOW 状态的数字输出
- output: 1 – HIGH 状态的数字输出
- pwm – PWM 输出
- servo – RC 舵机输出
- analog input – 模拟输入(0–1023)
获取当前引脚模式,并以文本形式返回模式名称。
获取当前引脚状态,并返回当前引脚值。
🔌 I2C 通信(高级) #
启用 I2C 总线。
在使用 I2C 传感器或设备之前,需要先启用 I2C。
在 Arduino Uno 上,I2C 使用:
a4(SDA),
a5(SCL)
向 I2C 设备写入数据,用于向传感器、显示器或其他设备发送命令或数值。
例如: i2c write to address [0x48|text] data [0x00|text]
从 I2C 设备读取数据,例如传感器数值或设备状态。
格式: hex – 十六进制 , decimal (unsigned) – 十进制(无符号), decimal (signed) – 十进制(有符号), float – 浮点数, text (ASCII) – 文本(ASCII)
例如: i2c read [2|text] byte(s) from [0x48|text] register [0x00|text] as [float]
禁用 I2C,并释放 I2C 引脚,让这些引脚可以用于其他功能。
检查 I2C 当前是否已启用。 如果已启用,则返回 true。
📡 串口 / BLE 通信(高级) #
启用串口或 BLE 通信,并保护所选择的引脚。
当 Arduino 开发板没有内置 Bluetooth,而需要使用外置 BLE 模块连接 Scratch 时,可以使用此功能。
支持 StandardFirmataPishiAi 或其他经过修改的 StandardFirmata 固件。
启用后,所选引脚会被锁定,防止其他 Scratch 积木意外修改这些引脚。
参数:
- RX_PIN – 串口通信的接收引脚
- TX_PIN – 串口通信的发送引脚
主要用途:
- 外置 BLE 模块: 保护 HC-05、HC-06、HM-10 等串口或 BLE 模块所使用的串口引脚,使 Scratch 可以通过 StandardFirmataPishiAi 固件建立连接。
注意: 这些积木也可以单纯用于保护和保留两个重要引脚,避免它们在项目中被意外修改。
例如:
禁用串口或 BLE 通信,并释放受保护的引脚。
当你不再需要 BLE 连接,并希望将这些引脚重新用于传感器或输出设备时,可以使用此积木。
检查串口或 BLE 保护是否处于启用状态。
启用时返回 true,禁用时返回 false。
📐 实用工具积木 #
输入一个引脚编号,然后将这个报告积木拖入其他 Arduino 积木的引脚输入框中。
在准备将项目导出为 Arduino 代码时,这个积木尤其有用。
当 Arduino 未连接时,引脚下拉菜单只会显示有限数量的引脚。
使用此积木,即使目标开发板未连接,也可以输入该开发板上的引脚编号。
例如: 输入 22,然后将此报告积木放入 LED 积木的引脚输入框中,就可以在 Arduino Mega 上使用 22 号引脚。
请选择支持对应操作的引脚。
将一个范围内的数值映射到另一个范围。
这对于传感器校准非常有用。
功能类似于 Arduino 的 map() 函数。
例如: map [512|text] from [0|text]-[1023|text] to [0|text]-[100|text] → 返回 50.05,将模拟读取值转换为百分比。
常见用途:
- 将模拟传感器值 0–1023 转换为百分比 0–100
- 调整舵机角度或电机速度
- 校准传感器范围
获取 Firmata 版本,并返回版本字符串,例如:
(e.g., “2.5”).
可用于排查连接问题。
📦 导出 Arduino 代码 #
将你的 Scratch 创作变成可以独立运行的 Arduino 项目!
将积木转换为代码并上传到开发板,让硬件运行得更快,无需依赖 Scratch 即可独立运行。
此积木会将项目的 Arduino 代码下载为 .ino 文件。
文件名与项目名称相同。
如果已存在同名文件,浏览器可能会在文件名后添加数字,例如 (2)。
导出代码时无需连接 Arduino 开发板。
Use the “pin [NUMBER]” reporter block to enter a pin number that is missing from the dropdown when your board is disconnected.
使用方法
- 使用 Arduino 扩展积木和 Scratch 编程积木创建项目。
- 点击绿旗,启动你的脚本。
- 点击 [导出 Arduino 代码],下载程序文件。
- 使用 Arduino IDE 打开下载的文件。
- 如果 Arduino IDE 提示创建草图文件夹并将文件移动到该文件夹中,请点击 OK。
- 选择开发板和对应的端口,然后将程序上传到开发板。
上传完成后,Arduino 将独立运行该程序。
上传此程序会替换 StandardFirmata。
如果你想恢复通过 Scratch 进行实时控制,请重新安装 StandardFirmata。
支持的积木和脚本
- Arduino 扩展中的硬件控制积木和实用工具积木。
- Scratch 中的运算符、文本、变量和列表。
- 循环、条件判断、等待和自定义积木。
- 以绿旗启动的脚本、广播消息和计时器事件。
- 多个脚本同时运行。
不支持的积木
这些规则同样适用于其他扩展中的不支持积木。
- 不支持的命令积木将被跳过。
- 不支持的报告积木将返回 0,包括 [firmata version]。
- 以不支持的事件积木开头的脚本将保持未激活状态。
导出的代码中会包含注释,用于标识不支持的积木。
例如:
创建一个以绿旗启动的脚本,让 LED 灯反复亮起和熄灭,并在每次状态变化之间设置等待时间。
导出代码并上传到开发板,即可让 LED 灯独立闪烁,无需连接 Scratch。
🎓 教育用途 #
- 实体计算: 学生可以学习软件如何控制真实硬件,将数字世界与现实世界连接起来。
- 电子基础: 学习电路、电压、电流、数字信号与模拟信号以及 PWM。
- STEM / STEAM 项目: 可用于机器人、自动化、物联网和环境监测。
- 基于传感器的互动: 创建能够对光线、声音、运动、温度和距离作出反应的项目。
- 机器人教育: 使用舵机、电机和传感器设计和编程机器人。
- 创客学习: 通过动手实践、原型制作和创意解决问题进行学习。
- 跨学科项目: 将编程、工程、艺术和科学结合起来。
🎮 示例项目 #
- 交通灯系统: 使用 RGB LED 或 3 个 LED 创建定时灯光序列。
- 避障机器人: 使用距离传感器和电机实现自动避障。
- 智能家居控制器: 使用传感器和按钮控制灯光、风扇和警报器。
- 气象站: 读取温度和湿度传感器,并在 Scratch 舞台上显示数据。
- 互动游戏控制器: 使用按钮、摇杆和电位器作为游戏输入设备。
- 植物自动浇水系统: 检测土壤湿度,并在土壤过干时启动水泵。
- 机械臂: 控制多个舵机抓取和移动物体。
- LED 音乐可视化: 让 RGB LED 的颜色和亮度与 Scratch 音乐同步变化。
- 循线机器人: 使用红外传感器和电机进行自动循线。
- Arduino 钢琴: 读取模拟传感器或按钮,并在 Scratch 中播放对应音符。
🧩 自己试试看: pishi.ai/play
🔧 提示和故障排除 #
🔌 Arduino 专用提示 #
- 连接失败? USB 连接请确认已安装 StandardFirmata;Bluetooth 连接请确认已安装 StandardFirmataBLE 或兼容固件。
- 找不到 USB 端口? 关闭 Arduino IDE 的串口监视器,因为它会占用端口。也可以尝试拔下 USB 后重新连接。
- USB 的浏览器兼容性? 桌面电脑请使用 Chrome、Edge、Opera 或其他 Chromium 浏览器。Safari 和 Firefox 可能无法使用 Web USB。
- BLE 的浏览器兼容性? 桌面版 Chrome 和 Edge 支持 Web Bluetooth。Safari 和 Firefox 通常不支持 BLE。
- 引脚没有反应? 检查接线,确认引脚编号正确,并确认该引脚支持对应功能,例如 PWM 或模拟输入。
- LED 不亮? 请串联 220Ω–1kΩ 的电阻保护 LED,并检查极性。通常较长的引脚是正极。
- 舵机抖动? 建议使用外部电源为舵机供电。Arduino 的 USB 电源通常不足以稳定驱动舵机。
- 模拟读取值不稳定? 可以在传感器引脚之间加入一个 0.1µF 的小电容,提高稳定性。
- 电机不工作? 直流电机需要外部电源和 H 桥驱动器。不要将电机直接连接到 Arduino 引脚。
- Firmata 版本不匹配? 请从当前 Arduino IDE 版本中上传最新版 StandardFirmata。
- 使用多个 Arduino? 每块 Arduino 都需要单独建立连接。切换开发板时,请先断开当前连接,再重新连接另一块开发板。
- RGB LED 颜色不正确? 检查 RGB LED 是共阳极还是共阴极。
共阳极:颜色控制逻辑需要反转,
共阴极:使用正常控制逻辑
另外,一些 RGB LED 的不同颜色通道可能需要使用不同阻值的电阻,才能使亮度更一致。 - I2C 无法工作? 在 SDA 和 SCL 上使用 4.7kΩ 上拉电阻,并使用 I2C Scanner 程序检查设备地址。
⚡ 引脚参考 #
– Arduino Uno / Nano(经典版) #
- 数字引脚: 0–13 如果使用串口,建议避免使用 0 和 1。
- PWM 引脚: 3, 5, 6, 9, 10, 11
- 模拟输入: a0–a5 也可以作为数字引脚 14–19 使用。
- I2C: a4 (SDA), a5 (SCL)
- 内置 LED: 13 号引脚
– Arduino Mega 2560 #
- 数字引脚: 0–53
- PWM 引脚: 2–13, 44–46
- 模拟输入: a0–a15
- I2C: 20 (SDA), 21 (SCL)
– Arduino Micro / Leonardo #
- 数字引脚: 0–13,另外还有 14–21
- PWM 引脚: 3, 5, 6, 9, 10, 11, 13
- 模拟输入: a0–a5 根据开发板版本,也可能支持 a6–a11。
- I2C: 2 (SDA), 3 (SCL)
- 内置 LED: 13 号引脚
– Arduino Nano 33 BLE / BLE Sense #
- 数字引脚: 0–13
- PWM 引脚: 3, 5, 6, 9, 10, 11, 12
- 模拟输入: a0–a7
- I2C: a4 (SDA), a5 (SCL)
- 注意: 仅使用 3.3V 电平。
– Arduino MKR WiFi 1010 #
- 数字引脚: 0–13
- PWM 引脚: 0–8
- 模拟输入: a0–a6
- I2C: 11 (SDA), 12 (SCL)
- 注意: 使用 3.3V 逻辑电平,并支持 BLE 和 Wi-Fi。
– Arduino Uno WiFi Rev2 #
- 数字引脚: 0–13
- PWM 引脚: 3, 5, 6, 9, 10, 11
- 模拟输入: a0–a5
- I2C: 使用专用 SDA / SCL 引脚
- 内置 LED: 13 号引脚
注意: 以上列出的是最常见的开发板。只要其他 Arduino 兼容开发板支持 StandardFirmata 或 StandardFirmataBLE,也可能可以使用此扩展。
🔒 安全注意事项 #
- 电流限制: Arduino 引脚最大通常只能提供约 40mA 电流。不要超过此限制,否则可能损坏开发板。对于大功率负载,请使用晶体管或继电器。
- 电压限制: Arduino Uno 和 Mega 通常使用 5V,部分开发板使用 3.3V。不要将更高电压直接连接到引脚。
- LED 电阻: 使用 LED 时,请始终串联 220Ω–1kΩ 的限流电阻,防止 LED 损坏。
- 电机供电: 直流电机、舵机和其他大功率设备需要外部电源,并且外部电源应与 Arduino 共地。
- 反向极性: 连接电源前请检查正负极。极性接反可能会损坏元件。
- 短路: 避免错误接线造成短路。短路可能损坏 Arduino 或电脑的 USB 端口。
- 散热: 不要让大电流负载长时间连续运行,以免元件过热。
🧪 技术信息 #
- 协议: StandardFirmata 及其变体(例如 StandardFirmataBLE),均基于 Firmata 协议。
- 连接方式: 通过浏览器使用 USB 或 BLE 连接,无需额外驱动程序。
- 支持的开发板: Arduino Uno、Mega、Nano、Leonardo 以及其他兼容开发板。
- 波特率: 57600(Standard Firmata 默认值)
- 最低 StandardFirmata 版本: 2.0
- 数字引脚: 0/1(LOW/HIGH)
- 模拟范围: 0–1023(10 位 ADC)
- PWM 范围: 0–100%(内部转换为 0–255)
- 舵机范围: 0–180 degrees
- RGB 颜色值: 每个通道 0–255
- I2C 地址范围: 0x08–0x77
- 浏览器支持: 桌面版 Chrome、Edge、Opera 或其他 Chromium 浏览器。
🔗 相关扩展 #
- 🔌 硬件扩展: Arduino、micro:bit、PRB、Pbot、Lego Boost、Lego WeDo 2.0、EV3
- 🧠 AI 扩展: – FaceMesh, HandPose, PoseNet, Image Trainer, Speech Recognition, ChatGPT, Speech to Text, Text to Speech
📚 了解更多 #
- Pishi.ai Extensions Help
- Official Arduino Website
- Arduino Language Reference
- Firmata GitHub Repository
- Arduino Tutorials
- Scratch 项目创意
