简介GRBL 1.1f是运行于Arduino平台的开源CNC运动控制固件专为桌面级数控机床、激光雕刻机等设备提供低成本实时控制方案。该zip压缩包内含69个文件共297KB核心为一批C与头文件源码并配有Makefile、Arduino IDE工程文件.ino、Markdown说明文档及Python辅助脚本便于开发者阅读、编译和二次开发。这一版本优化了运动控制性能改进错误报告与恢复机制并对Arduino Mega等硬件提供了更广泛兼容。通过研读源码可以深入理解G-code解析、多轴插补、加减速规划、过载与超程保护等关键机制适合希望定制固件或入门嵌入式运动控制的工程师与爱好者。已有813人在CSDN学习下载资源结构清晰是学习CNC控制系统实现细节的理想起点。1. grbl 1.1f 源码包里真正要用的那部分搜到grbl-1.1f.20170801.zip这类文件名时多数人不是想读源码而是想找一个能直接编出固件的基线版本。这个 zip 对应 grbl 1.1f 在 2017 年 8 月 1 日附近的源码快照对 ATmega328p 和 ATmega2560 这两代 8 位 CNC 控制板来说1.1f 至今仍是很多国产板卡出厂固件的底层原型。比起追新做机床改造的人更在意行为稳定插补节奏、串口协议、参数表结构都固定下来后续的 grbl 1.1h 主要是模块化和主轴 PWM 细节调整运动控制骨架差别不大。所以当你拿到这个 zip真正要做的不是解压浏览而是把grbl/目录下的 C 源码配合 Makefile 交叉编译成grbl.hex用 avrdude 烧进 UNO 或 Mega2560再用 grbl 上位机验证参数。整个过程半小时能走完但里面藏着三个高频坑avr-gcc 工具链版本不匹配、avrdude 端口参数写错、还有串口连接被 DTR 复位卡住。这篇就按这个顺序把这些讲清楚不绕到 grbl 之外。2. grbl 1.1f 源码目录结构与编译前置条件grbl 的源码结构不像大型项目那么复杂但也不能对整个目录一股脑全编。理解每个文件职责排错时会省一半时间。2.1 解压后只看这几个目录就能定位版本拿到 zip 后先解压确认顶层目录名是不是grbl-1.1f.20170801有时候从网盘转到本地会被改名成grbl(1).zip最好先恢复成原始目录名再操作。进入目录后真正的源码在grbl/子目录里而不是 zip 根目录。grbl-1.1f.20170801/ ├── doc/ # 协议文档、芯片映射说明不用编译 ├── grbl/ # 内核源码编译入口在这里 │ ├── Makefile # 编译配置AVR 交叉编译的入口 │ ├── config.h # 功能裁剪默认参数从这里来 │ ├── cpu_map.h # 引脚映射换板子基本改这里 │ ├── grbl.h # 全局头文件包含各模块 │ ├── planner.c # 运动规划器梯形加减速在这里 │ ├── stepper.c # 步进脉冲生成ISR 核心 │ └── ... └── README.md # 版本说明和编译提示2.1.1 确认 1.1f 版本标识的两个位置第一处是grbl/grbl.h里的宏定义。打开文件搜索GRBL_VERSION1.1f 的写法通常是#define GRBL_VERSION 1.1f第二处是烧录后通过串口返回的固件标识。如果板子上已经跑着别的版本的 grbl直接接串口发$I能看到类似Grbl 1.1f [$ for help]的返回这个字符串和你grbl.h里面定义的一致说明源码包和固件对得上。我是建议先看这行字符串再动手编译避免花了十分钟编出来的固件和 zip 里标注的版本完全不是一回事。cpu_map.h也值得打开扫一眼它决定了二进制烧到哪块板子上能跑。默认的cpu_map.h支持 atmega328p 和 atmega2560通过#ifdef分流。你在 Makefile 里选哪个 MCU编译时就会包含对应引脚映射不用手动改。2.2 avr-gcc 工具链与 make 环境准备grbl 1.1f 的源码是标准 C但最终目标是 AVR 单片机所以必须用 AVR 交叉编译工具链。用本机自带的 gcc 去编一定会报错。各平台准备方式略有差异这里给 Linux 和 macOS 的常用装法# Debian / Ubuntu sudo apt-get install gcc-avr avr-libc binutils-avr make # macOSHomebrew brew tap osx-cross/avr brew install avr-gcc avr-libc makeWindows 上比较省事的是装 WinAVR或者用 MSYS2 的 mingw-w64-avr-gcc。我一般不建议在纯 Windows 环境下编译 grbl不是因为编不了而是后续 avrdude 的串口设备名、驱动权限问题在 Linux 下更容易定位。工具链装完可以先用下面的命令验证avr-gcc --version make --version注意avr-gcc版本建议在 5.x 以上。grbl 1.1f 源码本身不挑编译器但太老的工具链在planner.c里的内联函数优化上会出一些奇怪警告不影响功能却会干扰你判断真正的错误信息。2.2.1 Makefile 里必须确认的三个变量打开grbl/Makefile重点看这几行# 默认芯片 MCU atmega328p # 主频 AVR_FREQ 16000000L # 编译目标名 TARGET grblMCU决定编译产物跑在哪种芯片上。atmega328p对应 UNO 和绝大多数 CNC 扩展板atmega2560对应 Mega 方案gnea 的 grbl-Mega 系列也沿用这套结构。AVR_FREQ必须和板子上晶振一致16MHz 是标准值如果用了 20MHz 晶振改这里否则串口波特率会偏差到完全连不上。TARGET只控制输出文件名保持grbl就行改名的意义不大。3. 编译 grbl 1.1f 生成 hex 与烧录参数整个流程里编译和烧录是最容易出问题的两步。编译失败还好看日志烧录失败经常是「命令看着对但板子没反应」。3.1 默认 make 编译与产物检查进入grbl/子目录直接编译cd grbl-1.1f.20170801/grbl make clean makemake clean先清掉上一次的中间文件防止旧的.o和.elf干扰新配置。编译成功会生成grbl.hex同时生成grbl.elf和一堆.o文件。其中grbl.hex才是烧录用的目标。如果编译报avr-gcc: command not found说明工具链没装进 PATH回到第 2.2 节检查安装步骤。确认产物ls -lh grbl.hex avr-size grbl.elfavr-size输出里的data段是 RAM 占用grbl 1.1f 在 328p 上编译后通常只有几百字节 RAM 余量如果改了DEFAULT_宏数组开得太大会出现region data overflowed by ...的链接错误这时候要去config.h里关掉不需要的功能模块而不是死磕优化选项。编译时如果只想快速验证代码能不能过编译可以加make -j4并行加速。但第一次编译我建议不要并行串行输出的错误信息顺序更清晰。3.1.1 单独指定 MCU 的编译写法默认make编的是 atmega328p 版本。如果手里是 Mega2560 板子常见的写法是直接在命令行覆盖 Makefile 变量make clean make MCUatmega2560 AVR_FREQ16000000L命令行里给的变量会覆盖 Makefile 里面写好的值不需要去改文件。等编完用grep MCU grbal.hex这种方法是验不出来的串口连上后发$I固件本身会告诉你跑在什么版本上。3.2 avrdude 烧录 atmega328p 的完整命令在 Linux 下烧录最常见的连接方式是 Arduino 板子自带的 bootloaderavrdude 用arduino编程器协议走串口。完整命令如下avrdude -v -p atmega328p -c arduino -P /dev/ttyUSB0 -b 115200 -D -U flash:w:grbl.hex:i参数拆开说清楚方便你改自己的环境参数含义常见改动点-v冗余输出能看到端口和芯片识别细节调试时加正常烧录可以去掉-p atmega328p目标芯片型号Mega2560 改atmega2560-c arduino编程器协议走 bootloader用 USBasp 改usbasp-P /dev/ttyUSB0串口号Windows 下改成COM3等实际端口-b 115200与 bootloader 通信的波特率部分国产 UNO 兼容板要改成57600-D不擦除 EEPROM直接写 flash想保留已有参数就保留这个-U flash:w:grbl.hex:i把 hex 写进 flashi表示 Intel hex 格式路径写错会报file not found写完如果提示avrdude: stk500_getsync() attempt 1 of 10: not in sync这是 bootloader 没有复位进入编程模式。Arduino UNO 的 DTR 会自动控制复位时序但有些兼容板要手动按一下板上的复位键等 avrdude 开始尝试同步时松手。这个动作要在 10 次尝试窗口内完成所以建议先把命令准备好再按复位。3.3 常见编译烧录失败的前三个原因第一avr-libc没装。现象是编译到一半报fatal error: avr/io.h: No such file or directory但你已经把avr-gcc装好了。这是个经典坑avr/io.h是 avr-libc 提供的不是 gcc 自带单独装 gcc 是不够的。第二串口设备权限不足。Linux 下打开/dev/ttyUSB0报Permission denied需要把当前用户加进dialout组sudo usermod -a -G dialout $USER改完要重新登录会话才生效。临时应急可以sudo chmod 666 /dev/ttyUSB0但重启后失效。第三烧录前没有退出占用串口的程序。grbl 上位机、screen、minicom 只要有一个开着串口avrdude 连上去就是Device is busy。烧录前先关掉烧完再开上位机这个顺序不要反过来。4. grbl 1.1f 参数表与上位机联调固件烧进去之后立刻就能通过串口联调。这里说的「上位机」可以是 Universal Gcode Sender、bCNC也可以只是最朴素的串口终端。grbl 的参数体系是$开头的文本命令不依赖图形界面所以用命令行验证反而是最快的方式。4.1 用 $$ 读取全部参数的可复现流程用 screen 或者 minicom 打开串口波特率 1152008 数据位、1 停止位、无校验。连接成功后先随便按个回车grbl 会响应ok或者ALARM然后输入$$ # grbl 返回全部参数表 $I # 返回固件版本与编译信息 $H # 执行回零需要机器装了限位开关$$输出的格式是$010这种键值对每一项对应一个运行参数。grbl 1.1f 一共 30 多项从$0步进脉冲时间到$132Z 轴行程。第一次拿到新板子我会先保存一份完整的$$输出到本地文件作为工厂默认值后面调乱了随时$RST*恢复默认。4.1.1 上位机连不上时先查两件事grbl 上位机最常见的问题是界面没反应但串口能开。第一件事是查波特率grbl 1.1f 默认 115200有些批量的国产板子在 config.h 里把BAUD_RATE改成了 9600上位机里两个都要试。第二件事是查 DTR 信号grbl 上电后如果 DTR 被拉低UNO 兼容板会进入复位循环表现为打开串口时板载 LED 闪一下然后没有握手信息。大部分 grbl 上位机包括 UGS在连接时默认控制 DTR如果遇到闪断去上位机的串口设置里把 DTR 和 RTS 的勾选去掉或者反过来手动拉高这类兼容性问题没有统一的判别标准只能逐个试组合。4.2 $100/$101/$102 步进换算与速度加速参数这一组参数是所有 grbl 调试里的核心直接决定电机走多远。$100是 X 轴每毫米步数$101是 Y 轴$102是 Z 轴。计算公式是每毫米步数 (电机每转步数 × 细分) / 丝杆导程常见配置1.8 度步进电机200 步/转驱动细分 16丝杆导程 4mm那么每毫米步数就是(200 × 16) / 4 800。同步带传动还要再乘上带轮齿数比这个不展开。设置命令$100800 $101800 $102400设置完成后立即生效不需要重启。传动的实际参数和理论计算总有偏差精确校准靠机械上的游标卡尺或百分表量实际移动距离然后反推修正。跑 100mm 实际走了 102mm就把$100从 800 改成800 × 100 / 102 ≈ 784.3。至于速度参数这一组容易搞混参数含义典型值$110X 轴最大速率 mm/min8000$120X 轴最大加速度 mm/s²60$130X 轴行程 mm200$110给太大步进电机会丢步$120给太大机器起步会抖。1.1f 的运动规划器用的是梯形加减速$120决定的是从 0 到最大速度的过程中加速度斜率。拿到新机器我习惯先把$110设成理论值的 60%跑一圈再往上加而不是一上来就跑到极值。4.3 方向、限位、回家相关的常用设置电机方向反了不用换线直接反转方向掩码。$3是方向端口反转掩码每一位代表一个轴bit0 是 Xbit1 是 Ybit2 是 Z。试机时发现 X 轴正方向反了把$3当前值和 1 做异或就行$3 # 假设输出 $30改成 1 $31如果 Y 轴也反了就把 2 也加上$33。Z 轴反了再加 4。这三个值组合出 0 到 7 共 8 种情况试完一轮总能让所有轴方向正确。限位和回零的参数集中在$20到$27。$221开启回零循环$211开启硬限位$23是回零方向反转掩码。1.1f 在回零搜索阶段用的是$25指定的搜索速度碰到开关后以$24的慢速退开找零点。这两组参数配合不好会出现回零过冲现象是碰到限位后向前冲一点点再退回来原因是搜索速度过高慢速退开距离$27覆盖不了惯性。解决方法是把$25从默认的 1000 mm/min 降到 500或者加大$27的退避距离。5. 验证 grbl 1.1f 固件是否健康的几个技巧烧录完成不等于机器能干活固件烧进去之后最好用一套固定流程验证从头到尾十分钟能覆盖八成的问题。5.1 串口握手与参数回传检查单第一次连接成功后记下三行输出上电时的Grbl 1.1f标识、$$返回的前三行参数、以及输入?返回的状态。?是非阻塞查询grbl 会返回当前运动状态和机床坐标比如Idle|MPos:0.000,0.000,0.000|FS:0,0。如果?没有响应说明固件已经在跑但串口回传部分异常检查 RX/TX 是否接反。5.2 用 G 代码空跑验证运动轴不需要机械加载直接发一段相对运动验证每个轴G91 G1 X10 F500 G91 G1 Y10 F500 G91 G1 Z5 F200G91切换到相对坐标模式G1是直线插补F是进给速度。每一行执行完 grbl 会返回一个ok。如果ok没回来说明前面还有指令在缓冲区排队这时多发几个也没问题grbl 的 FIFO 有 128 字节深度。如果电机不转但ok正常检查$100是否被设成了 0grbl 1.1f 里 0 值会被当成未配置部分固件版本会直接拒绝配速归零的轴。跑完相对运动再发G0 X0 Y0回原点确认回程没有累计丢步。一个轴丢步的典型表现是走一个 100mm 的方形行程后回到起始点偏差超过 0.5mm。5.3 从 config.h 改默认参数重新固化的技巧$$设置的参数存在 EEPROM 里而 config.h 里的DEFAULT_宏是出厂值。这两者互不干扰但有个技巧值得记住当你调出了一组稳定参数可以在 config.h 里把对应宏改成这组值重新编译烧录这样参数就固化进固件里了以后$RST*恢复默认时不会丢。具体做法是打开grbl/defaults.h找到#define DEFAULT_X_STEPS_PER_MM这一组宏把数值替换成你实测出来的步进参数。改完重新走第 3 章的编译烧录流程。这个技巧在批量刷多块板子时特别有用不用每块板子都手动敲一遍$100到$132。但要注意config.h里同时还有#define DEFAULT_ACCELERATION这类加速度默认值改错了重新烧录后机器会带着异常参数启动所以改完直接烧烧完先发$$确认一遍再上电驱动。本文还有配套的精品资源点击获取 grbl 1.1f 源码编译烧录全攻略：从工具链到参数调校
简介GRBL 1.1f是运行于Arduino平台的开源CNC运动控制固件专为桌面级数控机床、激光雕刻机等设备提供低成本实时控制方案。该zip压缩包内含69个文件共297KB核心为一批C与头文件源码并配有Makefile、Arduino IDE工程文件.ino、Markdown说明文档及Python辅助脚本便于开发者阅读、编译和二次开发。这一版本优化了运动控制性能改进错误报告与恢复机制并对Arduino Mega等硬件提供了更广泛兼容。通过研读源码可以深入理解G-code解析、多轴插补、加减速规划、过载与超程保护等关键机制适合希望定制固件或入门嵌入式运动控制的工程师与爱好者。已有813人在CSDN学习下载资源结构清晰是学习CNC控制系统实现细节的理想起点。1. grbl 1.1f 源码包里真正要用的那部分搜到grbl-1.1f.20170801.zip这类文件名时多数人不是想读源码而是想找一个能直接编出固件的基线版本。这个 zip 对应 grbl 1.1f 在 2017 年 8 月 1 日附近的源码快照对 ATmega328p 和 ATmega2560 这两代 8 位 CNC 控制板来说1.1f 至今仍是很多国产板卡出厂固件的底层原型。比起追新做机床改造的人更在意行为稳定插补节奏、串口协议、参数表结构都固定下来后续的 grbl 1.1h 主要是模块化和主轴 PWM 细节调整运动控制骨架差别不大。所以当你拿到这个 zip真正要做的不是解压浏览而是把grbl/目录下的 C 源码配合 Makefile 交叉编译成grbl.hex用 avrdude 烧进 UNO 或 Mega2560再用 grbl 上位机验证参数。整个过程半小时能走完但里面藏着三个高频坑avr-gcc 工具链版本不匹配、avrdude 端口参数写错、还有串口连接被 DTR 复位卡住。这篇就按这个顺序把这些讲清楚不绕到 grbl 之外。2. grbl 1.1f 源码目录结构与编译前置条件grbl 的源码结构不像大型项目那么复杂但也不能对整个目录一股脑全编。理解每个文件职责排错时会省一半时间。2.1 解压后只看这几个目录就能定位版本拿到 zip 后先解压确认顶层目录名是不是grbl-1.1f.20170801有时候从网盘转到本地会被改名成grbl(1).zip最好先恢复成原始目录名再操作。进入目录后真正的源码在grbl/子目录里而不是 zip 根目录。grbl-1.1f.20170801/ ├── doc/ # 协议文档、芯片映射说明不用编译 ├── grbl/ # 内核源码编译入口在这里 │ ├── Makefile # 编译配置AVR 交叉编译的入口 │ ├── config.h # 功能裁剪默认参数从这里来 │ ├── cpu_map.h # 引脚映射换板子基本改这里 │ ├── grbl.h # 全局头文件包含各模块 │ ├── planner.c # 运动规划器梯形加减速在这里 │ ├── stepper.c # 步进脉冲生成ISR 核心 │ └── ... └── README.md # 版本说明和编译提示2.1.1 确认 1.1f 版本标识的两个位置第一处是grbl/grbl.h里的宏定义。打开文件搜索GRBL_VERSION1.1f 的写法通常是#define GRBL_VERSION 1.1f第二处是烧录后通过串口返回的固件标识。如果板子上已经跑着别的版本的 grbl直接接串口发$I能看到类似Grbl 1.1f [$ for help]的返回这个字符串和你grbl.h里面定义的一致说明源码包和固件对得上。我是建议先看这行字符串再动手编译避免花了十分钟编出来的固件和 zip 里标注的版本完全不是一回事。cpu_map.h也值得打开扫一眼它决定了二进制烧到哪块板子上能跑。默认的cpu_map.h支持 atmega328p 和 atmega2560通过#ifdef分流。你在 Makefile 里选哪个 MCU编译时就会包含对应引脚映射不用手动改。2.2 avr-gcc 工具链与 make 环境准备grbl 1.1f 的源码是标准 C但最终目标是 AVR 单片机所以必须用 AVR 交叉编译工具链。用本机自带的 gcc 去编一定会报错。各平台准备方式略有差异这里给 Linux 和 macOS 的常用装法# Debian / Ubuntu sudo apt-get install gcc-avr avr-libc binutils-avr make # macOSHomebrew brew tap osx-cross/avr brew install avr-gcc avr-libc makeWindows 上比较省事的是装 WinAVR或者用 MSYS2 的 mingw-w64-avr-gcc。我一般不建议在纯 Windows 环境下编译 grbl不是因为编不了而是后续 avrdude 的串口设备名、驱动权限问题在 Linux 下更容易定位。工具链装完可以先用下面的命令验证avr-gcc --version make --version注意avr-gcc版本建议在 5.x 以上。grbl 1.1f 源码本身不挑编译器但太老的工具链在planner.c里的内联函数优化上会出一些奇怪警告不影响功能却会干扰你判断真正的错误信息。2.2.1 Makefile 里必须确认的三个变量打开grbl/Makefile重点看这几行# 默认芯片 MCU atmega328p # 主频 AVR_FREQ 16000000L # 编译目标名 TARGET grblMCU决定编译产物跑在哪种芯片上。atmega328p对应 UNO 和绝大多数 CNC 扩展板atmega2560对应 Mega 方案gnea 的 grbl-Mega 系列也沿用这套结构。AVR_FREQ必须和板子上晶振一致16MHz 是标准值如果用了 20MHz 晶振改这里否则串口波特率会偏差到完全连不上。TARGET只控制输出文件名保持grbl就行改名的意义不大。3. 编译 grbl 1.1f 生成 hex 与烧录参数整个流程里编译和烧录是最容易出问题的两步。编译失败还好看日志烧录失败经常是「命令看着对但板子没反应」。3.1 默认 make 编译与产物检查进入grbl/子目录直接编译cd grbl-1.1f.20170801/grbl make clean makemake clean先清掉上一次的中间文件防止旧的.o和.elf干扰新配置。编译成功会生成grbl.hex同时生成grbl.elf和一堆.o文件。其中grbl.hex才是烧录用的目标。如果编译报avr-gcc: command not found说明工具链没装进 PATH回到第 2.2 节检查安装步骤。确认产物ls -lh grbl.hex avr-size grbl.elfavr-size输出里的data段是 RAM 占用grbl 1.1f 在 328p 上编译后通常只有几百字节 RAM 余量如果改了DEFAULT_宏数组开得太大会出现region data overflowed by ...的链接错误这时候要去config.h里关掉不需要的功能模块而不是死磕优化选项。编译时如果只想快速验证代码能不能过编译可以加make -j4并行加速。但第一次编译我建议不要并行串行输出的错误信息顺序更清晰。3.1.1 单独指定 MCU 的编译写法默认make编的是 atmega328p 版本。如果手里是 Mega2560 板子常见的写法是直接在命令行覆盖 Makefile 变量make clean make MCUatmega2560 AVR_FREQ16000000L命令行里给的变量会覆盖 Makefile 里面写好的值不需要去改文件。等编完用grep MCU grbal.hex这种方法是验不出来的串口连上后发$I固件本身会告诉你跑在什么版本上。3.2 avrdude 烧录 atmega328p 的完整命令在 Linux 下烧录最常见的连接方式是 Arduino 板子自带的 bootloaderavrdude 用arduino编程器协议走串口。完整命令如下avrdude -v -p atmega328p -c arduino -P /dev/ttyUSB0 -b 115200 -D -U flash:w:grbl.hex:i参数拆开说清楚方便你改自己的环境参数含义常见改动点-v冗余输出能看到端口和芯片识别细节调试时加正常烧录可以去掉-p atmega328p目标芯片型号Mega2560 改atmega2560-c arduino编程器协议走 bootloader用 USBasp 改usbasp-P /dev/ttyUSB0串口号Windows 下改成COM3等实际端口-b 115200与 bootloader 通信的波特率部分国产 UNO 兼容板要改成57600-D不擦除 EEPROM直接写 flash想保留已有参数就保留这个-U flash:w:grbl.hex:i把 hex 写进 flashi表示 Intel hex 格式路径写错会报file not found写完如果提示avrdude: stk500_getsync() attempt 1 of 10: not in sync这是 bootloader 没有复位进入编程模式。Arduino UNO 的 DTR 会自动控制复位时序但有些兼容板要手动按一下板上的复位键等 avrdude 开始尝试同步时松手。这个动作要在 10 次尝试窗口内完成所以建议先把命令准备好再按复位。3.3 常见编译烧录失败的前三个原因第一avr-libc没装。现象是编译到一半报fatal error: avr/io.h: No such file or directory但你已经把avr-gcc装好了。这是个经典坑avr/io.h是 avr-libc 提供的不是 gcc 自带单独装 gcc 是不够的。第二串口设备权限不足。Linux 下打开/dev/ttyUSB0报Permission denied需要把当前用户加进dialout组sudo usermod -a -G dialout $USER改完要重新登录会话才生效。临时应急可以sudo chmod 666 /dev/ttyUSB0但重启后失效。第三烧录前没有退出占用串口的程序。grbl 上位机、screen、minicom 只要有一个开着串口avrdude 连上去就是Device is busy。烧录前先关掉烧完再开上位机这个顺序不要反过来。4. grbl 1.1f 参数表与上位机联调固件烧进去之后立刻就能通过串口联调。这里说的「上位机」可以是 Universal Gcode Sender、bCNC也可以只是最朴素的串口终端。grbl 的参数体系是$开头的文本命令不依赖图形界面所以用命令行验证反而是最快的方式。4.1 用 $$ 读取全部参数的可复现流程用 screen 或者 minicom 打开串口波特率 1152008 数据位、1 停止位、无校验。连接成功后先随便按个回车grbl 会响应ok或者ALARM然后输入$$ # grbl 返回全部参数表 $I # 返回固件版本与编译信息 $H # 执行回零需要机器装了限位开关$$输出的格式是$010这种键值对每一项对应一个运行参数。grbl 1.1f 一共 30 多项从$0步进脉冲时间到$132Z 轴行程。第一次拿到新板子我会先保存一份完整的$$输出到本地文件作为工厂默认值后面调乱了随时$RST*恢复默认。4.1.1 上位机连不上时先查两件事grbl 上位机最常见的问题是界面没反应但串口能开。第一件事是查波特率grbl 1.1f 默认 115200有些批量的国产板子在 config.h 里把BAUD_RATE改成了 9600上位机里两个都要试。第二件事是查 DTR 信号grbl 上电后如果 DTR 被拉低UNO 兼容板会进入复位循环表现为打开串口时板载 LED 闪一下然后没有握手信息。大部分 grbl 上位机包括 UGS在连接时默认控制 DTR如果遇到闪断去上位机的串口设置里把 DTR 和 RTS 的勾选去掉或者反过来手动拉高这类兼容性问题没有统一的判别标准只能逐个试组合。4.2 $100/$101/$102 步进换算与速度加速参数这一组参数是所有 grbl 调试里的核心直接决定电机走多远。$100是 X 轴每毫米步数$101是 Y 轴$102是 Z 轴。计算公式是每毫米步数 (电机每转步数 × 细分) / 丝杆导程常见配置1.8 度步进电机200 步/转驱动细分 16丝杆导程 4mm那么每毫米步数就是(200 × 16) / 4 800。同步带传动还要再乘上带轮齿数比这个不展开。设置命令$100800 $101800 $102400设置完成后立即生效不需要重启。传动的实际参数和理论计算总有偏差精确校准靠机械上的游标卡尺或百分表量实际移动距离然后反推修正。跑 100mm 实际走了 102mm就把$100从 800 改成800 × 100 / 102 ≈ 784.3。至于速度参数这一组容易搞混参数含义典型值$110X 轴最大速率 mm/min8000$120X 轴最大加速度 mm/s²60$130X 轴行程 mm200$110给太大步进电机会丢步$120给太大机器起步会抖。1.1f 的运动规划器用的是梯形加减速$120决定的是从 0 到最大速度的过程中加速度斜率。拿到新机器我习惯先把$110设成理论值的 60%跑一圈再往上加而不是一上来就跑到极值。4.3 方向、限位、回家相关的常用设置电机方向反了不用换线直接反转方向掩码。$3是方向端口反转掩码每一位代表一个轴bit0 是 Xbit1 是 Ybit2 是 Z。试机时发现 X 轴正方向反了把$3当前值和 1 做异或就行$3 # 假设输出 $30改成 1 $31如果 Y 轴也反了就把 2 也加上$33。Z 轴反了再加 4。这三个值组合出 0 到 7 共 8 种情况试完一轮总能让所有轴方向正确。限位和回零的参数集中在$20到$27。$221开启回零循环$211开启硬限位$23是回零方向反转掩码。1.1f 在回零搜索阶段用的是$25指定的搜索速度碰到开关后以$24的慢速退开找零点。这两组参数配合不好会出现回零过冲现象是碰到限位后向前冲一点点再退回来原因是搜索速度过高慢速退开距离$27覆盖不了惯性。解决方法是把$25从默认的 1000 mm/min 降到 500或者加大$27的退避距离。5. 验证 grbl 1.1f 固件是否健康的几个技巧烧录完成不等于机器能干活固件烧进去之后最好用一套固定流程验证从头到尾十分钟能覆盖八成的问题。5.1 串口握手与参数回传检查单第一次连接成功后记下三行输出上电时的Grbl 1.1f标识、$$返回的前三行参数、以及输入?返回的状态。?是非阻塞查询grbl 会返回当前运动状态和机床坐标比如Idle|MPos:0.000,0.000,0.000|FS:0,0。如果?没有响应说明固件已经在跑但串口回传部分异常检查 RX/TX 是否接反。5.2 用 G 代码空跑验证运动轴不需要机械加载直接发一段相对运动验证每个轴G91 G1 X10 F500 G91 G1 Y10 F500 G91 G1 Z5 F200G91切换到相对坐标模式G1是直线插补F是进给速度。每一行执行完 grbl 会返回一个ok。如果ok没回来说明前面还有指令在缓冲区排队这时多发几个也没问题grbl 的 FIFO 有 128 字节深度。如果电机不转但ok正常检查$100是否被设成了 0grbl 1.1f 里 0 值会被当成未配置部分固件版本会直接拒绝配速归零的轴。跑完相对运动再发G0 X0 Y0回原点确认回程没有累计丢步。一个轴丢步的典型表现是走一个 100mm 的方形行程后回到起始点偏差超过 0.5mm。5.3 从 config.h 改默认参数重新固化的技巧$$设置的参数存在 EEPROM 里而 config.h 里的DEFAULT_宏是出厂值。这两者互不干扰但有个技巧值得记住当你调出了一组稳定参数可以在 config.h 里把对应宏改成这组值重新编译烧录这样参数就固化进固件里了以后$RST*恢复默认时不会丢。具体做法是打开grbl/defaults.h找到#define DEFAULT_X_STEPS_PER_MM这一组宏把数值替换成你实测出来的步进参数。改完重新走第 3 章的编译烧录流程。这个技巧在批量刷多块板子时特别有用不用每块板子都手动敲一遍$100到$132。但要注意config.h里同时还有#define DEFAULT_ACCELERATION这类加速度默认值改错了重新烧录后机器会带着异常参数启动所以改完直接烧烧完先发$$确认一遍再上电驱动。本文还有配套的精品资源点击获取