Johnny-Five 实战:用 TinkerKit 旋转电位器(Rotary Potentiometer)实时驱动舵机角度
Johnny-Five 实战:用 TinkerKit 旋转电位器(Rotary Potentiometer)实时驱动舵机角度
TinkerKit 是一套面向 Arduino 的模块化传感器/执行器套件,其中的旋转电位器(Rotary Potentiometer)通过旋钮输出可变的模拟电压,是最直观的"旋转输入"设备。本文基于 Johnny-Five 官方示例 docs/tinkerkit-rotary.md 与 eg/tinkerkit-rotary.js,讲解如何用 Sensor 读取电位器原始值、通过 scale() 映射为 0–180 度的舵机角度,再借助 Servo.to() 让舵机跟随旋钮实时转动。读完本文你将掌握 TinkerKit 输入/输出引脚的映射规则、模拟量缩放的核心原理,以及一套可直接运行的控制方案。
1. 硬件背景:TinkerKit 旋转电位器与 Shield
TinkerKit 是 Arduino 官方合作推出的一套"即插即用"模块套件,每个模块都带标准化的三针接口(信号 + 电源 + 地),通过 TinkerKit Shield 插在 Arduino 主板上即可使用,无需面包板和跳线焊接。
旋转电位器模块内部是一个可变电阻分压器,旋钮转动会改变中间抽头(信号脚)的输出电压,输出电压范围在 0V 与 5V(或 3.3V)之间连续变化。Arduino 的模拟输入引脚(ADC)把这个电压量化为一个整数(UNO 默认 10-bit 分辨率,范围 0–1023),Johnny-Five 的 Sensor 类正是对这个量化结果的封装。
在 Johnny-Five 中,TinkerKit 引脚使用了面向套件的命名约定:
- 输入引脚:
I0–I9(对应 Arduino 模拟输入 A0–A9) - 输出引脚:
O0–O5(对应 Arduino 数字 PWM 输出)
这套"套件引脚 → 物理引脚"的翻译表定义在 lib/board.pins.js 的 Pins.translations 中,以 UNO 为例:
| TinkerKit 引脚 | 实际 Arduino 引脚 | 用途 |
|---|---|---|
I0 |
A0 | 模拟输入 |
I1 |
A1 | 模拟输入 |
I2–I5 |
A2–A5 | 模拟输入 |
O0 |
11 | PWM 输出 |
O1 |
10 | PWM 输出 |
O2 |
9 | PWM 输出 |
O3 |
6 | PWM 输出 |
O4 |
5 | PWM 输出 |
O5 |
3 | PWM 输出 |
MEGA 的映射与 UNO 一致,并额外提供 I6–I9(A6–A9)。代码中写 new five.Servo("O0") 时,Johnny-Five 会自动完成 "O0" → 11 的翻译,因此示例中的 "I1" 与 "O0" 分别对应"电位器接 A1"和"舵机接 PWM 11"。
2. 完整示例:旋钮转动,舵机跟随
原文档提供的核心示例(与 eg/tinkerkit-rotary.js 完全一致)如下:
var five = require("johnny-five");
var board = new five.Board();
board.on("ready", function() {
var servo = new five.Servo("O0");
new five.Sensor("I1").scale(0, 180).on("change", function() {
servo.to(this.value);
});
});
在仓库根目录运行(需要先安装 johnny-five 依赖并用 USB 连接 Arduino 开发板):
node eg/tinkerkit-rotary.js
注意:官方示例中第 1 行写的是 require("../lib/johnny-five.js"),这是仓库内部开发时直接引用源码的写法;作为普通用户从 npm 安装后,应使用 require("johnny-five")(与原文档 docs/tinkerkit-rotary.md 中一致)。
2.1 代码逐行拆解
① 创建 Board 并等待就绪
var board = new five.Board();
board.on("ready", function() { ... });
five.Board() 负责与开发板建立连接(默认自动探测串口)。只有触发 "ready" 事件后,固件程序(Firmata)才完成握手,此时才能安全地创建组件实例。
② 创建舵机实例
var servo = new five.Servo("O0");
"O0" 经 TinkerKit 翻译表解析为 UNO 的数字 PWM 引脚 11。Servo 类默认工作区间是 0–180 度(lib/servo.js 中 this.range = options.range || this.degreeRange)。
③ 读取电位器并映射到角度
new five.Sensor("I1").scale(0, 180).on("change", function() {
servo.to(this.value);
});
这行代码是整段程序的核心,包含三个动作:
new five.Sensor("I1"):在模拟输入 A1 上创建传感器,读取原始 ADC 值(UNO 上为 0–1023,具体分辨率取决于io.RESOLUTION.ADC,见 lib/sensor.js);.scale(0, 180):把原始量程线性映射到 0–180,与舵机角度范围对齐;.on("change", ...):当值发生改变时,把缩放后的值交给servo.to(),实现"旋钮转动 → 舵机跟随"。
3. 底层原理:Sensor.scale() 与 Servo.to()
3.1 Sensor.prototype.scale(low, high)
scale() 在 lib/sensor.js 中实现,本质上只是记录缩放区间:
scale(low, high) {
this.isScaled = true;
priv.get(this).scale = Array.isArray(low) ?
low : [low, high];
return this;
}
它同时支持两种传参形式:scale(0, 180) 或 scale(<a href="https://link.gitcode.com/i/ca75c748477d8590dec2ccd181393531" target="_blank">0, 180]),返回 this 以支持链式调用。真正的换算发生在读取阶段——Sensor 的 value getter([lib/sensor.js)检测到设置了 scale 后,会返回 scaled 属性,而 scaled 的实现是(lib/sensor.js):
mapped = Fn.fmap(raw, this.range[0], this.range[1], state.scale[0], state.scale[1]);
constrain = Fn.constrain(mapped, state.scale[0], state.scale[1]);
return constrain;
即:先把原始值 raw 按传感器自身量程 [0, resolution] 映射到目标区间 [0, 180],再做一次 constrain 钳制,确保输出永远不会超出缩放边界。这意味着即使电位器旋到最大,this.value 也严格落在 0–180 内,不会给舵机发送越界角度。
补充:
Sensor还提供scaleTo()(lib/sensor.js)和fscaleTo()(单精度浮点版本),前者做整数映射、后者保留浮点精度,适合需要更平滑角度控制或 LCD 显示的场景。
3.2 Servo.prototype.to(degrees)
当传入的是纯数字角度时,to() 会先做范围约束(lib/servo.js):
const target = degrees;
// Enforce limited range of motion
degrees = Fn.constrain(degrees, this.range[0], this.range[1]);
range 默认是 <a href="https://link.gitcode.com/i/e92ddd1bba5e1ed7a24f5df22f41f1b3" target="_blank">0, 180]。随后依次处理角度偏移(this.offset)、反向(this.invert)并通过 this.update(degrees) 下发到 IO 层([lib/servo.js),同时把最近几次动作写入 state.history 供回放与测试使用。也就是说,即使上游传来的数值略微越界,舵机也会被安全地限制在机械可运动范围内。
to() 同样支持传入对象形式 { degrees, duration, easing } 来做动画式平滑转动;但本文示例直接传数字,属于"立即到位"模式,实时性最好,最贴合电位器连续调节的交互。
4. 接线说明
- 将 TinkerKit 旋转电位器插入 Shield 的 I1 输入插座(信号线走模拟输入 A1;电源与地由 Shield 自动供给);
- 将 标准舵机 的信号线接入 Shield 的 O0 输出插座(PWM 引脚 11),供电由 Shield 提供(注意外接舵机功率较大时建议使用独立电源);
- 把 Shield 插到 Arduino UNO(或 MEGA/Leonardo,Leonardo 复用 UNO 的翻译表,见 lib/board.pins.js),USB 连接电脑。
接线无误后运行 node eg/tinkerkit-rotary.js,旋转电位器旋钮即可看到舵机臂在 0°–180° 之间同步摆动。
5. 扩展玩法:从单一旋钮到更多 TinkerKit 输入
同样的"模拟量缩放"思路可以推广到其他 TinkerKit 输入模块,仓库中提供了多个可对照的示例:
- eg/tinkerkit-linear-pot.js:线性电位器接
I0,scale(0, 255)后把缩放值打到终端,可用于调节 LED 亮度(配合 docs/tinkerkit-blink.md 中new five.Led("O0").strobe(250)的输出用法); - eg/tinkerkit-joystick.js:摇杆占用
I0、I1两个模拟输入,用five.Joystick一次性封装 x/y 两个轴; - eg/tinkerkit-combo.js:在一个
ready回调中同时使用加速计(I0/I1)、滑块(I2)和两个连续舵机(O0),演示多模块组合——滑块同样执行slider.scale(0, 180).on("change", ...)并驱动servos.to(...),与本文的旋转电位器模式完全同构; - 数字输入类可参考 docs/tinkerkit-button.md(按钮接
I0,配controller: "TINKERKIT")。
如果想直接观察原始 ADC 读数而非缩放结果,把示例改成:
new five.Sensor("I1").on("data", function() {
console.log("raw:", this.raw, "value:", this.value);
});
旋钮从一端转到另一端,raw 会在 0–1023(10-bit ADC)之间连续变化,这正是 scale() 的输入素材。
6. 常见问题与调试建议
- 舵机不动作:确认
"O0"对应的 PWM 引脚(UNO 上为 11)是否被其他设备占用;确认舵机电源是否充足,大扭矩舵机抖动时优先外接电源。 - 角度反向:电位器向右转舵机却向左,可在
scale(0, 180)后对角度做反转,例如servo.to(180 - this.value),或利用 Servo 构造选项中的反向支持。 - 数值抖动:模拟输入难免有噪声,可在
Sensor构造时传入freq(采样频率)或threshold(变化阈值)来控制"change"事件的触发灵敏度。 - 使用其他开发板:TinkerKit 翻译表目前覆盖 UNO/MEGA/LEONARDO,其他板卡(如基于 Intel Edison 的板子)请确认其模拟与 PWM 引脚定义,见 docs/edison-io-arduino.md 等平台文档。
7. 小结
本文示例虽短,却完整演示了 Johnny-Five 中最常见的"传感器输入 → 数值缩放 → 执行器输出"闭环:Sensor 负责采集与映射,Servo 负责执行,而 TinkerKit 的 I*/O* 引脚命名让硬件接线与代码读写都变得一目了然。掌握 scale() 的映射语义(lib/sensor.js)与 to() 的范围钳制(lib/servo.js)之后,你可以轻松把同样的模式迁移到滑块、摇杆、光敏电阻等任何模拟输入,驱动舵机、LED、电机等任意输出设备。
进一步阅读:docs/tinkerkit-combo.md(多模块组合)、docs/tinkerkit-blink.md(TinkerKit 输出)、docs/sensor.md(Sensor 完整 API)、docs/servo.md(Servo 完整 API)。
