模块: FastAccelStepper 电机库
约 648 字大约 2 分钟
2026-05-21
构建固件和导入到JS
额外组件
该功能需要安装 beshell-FastAccelStepper 组件才能使用。
安装方法:
- 编辑项目根目录下的
idf_component.yml文件,添加依赖:
dependencies:
become-cool/beshell-FastAccelStepper: '>=1.0.2'- 或在 ESP-IDF 环境的命令行中执行:
idf.py add-dependency "become-cool/beshell-FastAccelStepper>=1.0.2"在 C++ 里加入以下代码, 然后重新编译构建固件:
// 为了控制固件的尺寸,BeShell 的 module 是按需引入的。
beshell.use<be::fas::FastAccelStepper>() ;在JS中导入 fas module:
在.js文件中
import * as fas from 'fas'在REPL命令行下
import fas简介
FastAccelStepper 步进电机控制模块
基于 FastAccelStepper 库,提供高性能的步进电机控制能力。支持速度控制、位置控制、加减速等高级功能。
示例:
import * as fas from "fas"
// 初始化引擎
fas.setup()
// 连接步进电机到引脚
const stepper = fas.stepperConnectToPin(2)
// 设置速度和加速度
stepper.setSpeedInHz(1000)
stepper.setAcceleration(5000)
// 移动 1000 步
stepper.move(1000)模块函数
函数 setup
原型: setup (maxSteppers:number=1)
初始化 FastAccelStepper 引擎
在使用任何步进电机之前必须先调用此方法初始化引擎。如果未显式调用,stepperConnectToPin() 会自动初始化。
示例:
import * as fas from "fas"
// 初始化引擎(默认支持 1 个电机)
fas.setup()
// 指定最大电机数量
fas.setup(3)参数:
maxSteppers
类型number
默认值1
参数说明最大步进电机数量
异常:
- FastAccelStepper engine already inited
返回值:
类型undefined
函数 stepperConnectToPin
原型: stepperConnectToPin (pin:number)
将步进电机连接到指定引脚
创建一个 Stepper 实例并连接到指定的 GPIO 引脚。如果引擎尚未初始化,会自动调用 setup() 进行初始化。
示例:
import * as fas from "fas"
// 连接步进电机到 GPIO 2
const stepper = fas.stepperConnectToPin(2)
// 设置参数
stepper.setSpeedInHz(800)
stepper.setAcceleration(10000)
// 移动
stepper.move(2000)参数:
pin
类型number
参数说明GPIO 引脚号
异常:
- failed to connect stepper
返回值:
类型Stepper
说明步进电机实例
