绘图仪的设置存储在非易失性存储器中，这意味着它们只需配置一次。[1] GRBL中的默认设置如下所示： Grbl参数配置说明 以下参数说明来源于：http://www.xn–bnq31s.xn–fiqs8s/?cate=34

Grbl编译软件与使用方法： 推荐使用Programmer’sNotepad编译器，软件和使用方法自行下载： 链接：http://pan.baidu.com/s/1bOeH1k Grbl程序下载软件与使用方法： 下载软件推荐使用 Arduloader，软件和使用方法自行下载： 链接：http://pan.baidu.com/s/1hrDdjDi Grbl控制端软件GrblController： 链接：http://pan.baidu.com/s/1hsMMRbA

要更改任何设置，只需在命令行中输入设置编号，后跟“ =”，然后输入“ value”。完成后，键入$ 以 确 认 设 置 。 例 如 ， 以确认设置。例如， 以确认设置。例如， 100 = 80告诉GRBL，您的绘图仪需要80步才能移动1毫米。

原文地址：https://github.com/gnea/grbl/wiki/Grbl-v1.1-Configuration

Charles Van Noland编辑了此页面 on 14 Dec 2017 · 18个修订 快速链接：

首先，使用您选择的串行端子连接到Grbl。

将波特率设置为115200为8-N-1（8位，无奇偶校验和1个停止位）。

连接后，您应该会看到Grbl提示符，如下所示：

键入 并 按 E n t e r 键 以 使 G r b l 打 印 帮 助 消 息 。 您 应 该 不 会 看 到 并按Enter键以使Grbl打印帮助消息。您应该不会看到 并按Enter键以使Grbl打印帮助消息。您应该不会看到的任何本地回显，然后输入。Grbl应该回应：

“ ” 命 令 是 G r b l 系 统 命 令 ， 用 于 调 整 设 置 ， 查 看 或 更 改 G r b l 的 状 态 和 运 行 模 式 以 及 启 动 归 位 循 环 。 最 后 四 个 非 − ”命令是Grbl系统命令，用于调整设置，查看或更改Grbl的状态和运行模式以及启动归位循环。最后四个非 - ”命令是Grbl系统命令，用于调整设置，查看或更改Grbl的状态和运行模式以及启动归位循环。最后四个非−命令是实时控制命令，无论Grbl在做什么，它都可以随时发送。这些要么立即改变Grbl的运行行为，要么立即打印重要的实时数据的报告，例如当前位置（aka DRO）。

要查看设置，请$$在连接到Grbl后键入并按Enter。Grbl应该以当前系统设置的列表作为响应，如下例所示。所有这些设置都是持久性的，并保存在EEPROM中，因此，如果您关闭电源，则下次启动Arduino时将重新加载这些设置。

所述x的$x=val指示特定设置，而val是设定值。在以前的Grbl版本中，每个设置都在()括号旁边有一个描述，但是不幸的是Grbl v1.1 +不再包含它们。这样做是为了释放宝贵的闪存以添加v1.1中可用的新功能。但是，大多数优秀的GUI都可以通过为您附上描述来帮助您，从而使您知道自己在看什么。

该$x=val命令可保存或更改Grbl设置，当通过串行终端程序连接到Grbl时，可以通过发送此命令来手动完成此设置，但是大多数Grbl GUI都会通过用户友好的功能为您完成此设置。

要手动将微秒步进脉冲选项更改为10us，请键入以下内容，然后按Enter：

如果一切顺利，Grbl将以“ ok”响应，此设置存储在EEPROM中，并将永久保留或直到您更改它们为止。您可以通过键入$$再次查看系统设置来检查Grbl是否正确接收并存储了您的设置。

注意：从Grbl v0.9到Grbl v1.1，仅$10状态报告已更改，并且添加了新的$30/ $31主轴rpm最大/最小和$32激光模式设置。其他一切都一样。

步进驱动器具有一定的最小步进脉冲长度。检查数据表或尝试一些数字。您希望步进驱动器能够可靠地识别出最短的脉冲。如果脉冲太长，则以很高的进给和脉冲速率运行系统时可能会遇到麻烦，因为步进脉冲可能会开始相互重叠。我们建议大约10微秒，这是默认值。

每当您的步进器完成一个动作并停止时，Grbl都会通过该值延迟禁用步进器。或，您可以通过将此值设置为最大255毫秒来始终保持启用轴（通电以保持位置）的状态。同样，只需重复一次，您可以通过设置保持所有轴始终处于启用状态$1=255。

步进器空闲锁定时间是在禁用之前Grbl将保持步进器锁定的时间长度。根据系统，可以将其设置为零并禁用它。在其他情况下，您可能需要25到50毫秒来确保在禁用之前轴完全停止。这有助于解决不喜欢长时间不做任何事情的机器电机的问题。另外，请记住，某些步进驱动器不会记住他们停止在哪个微步上，因此，当您重新启用该驱动程序时，您可能会因此而目睹一些“丢失”的步骤。在这种情况下，只需通过启用步进器即可$1=255。

该设置将步进脉冲信号反相。默认情况下，步进信号从正常低电平开始，并在发生步进脉冲事件时变为高电平。在由设置的步进脉冲时间后$0，该引脚复位为低电平，直到发生下一步进脉冲事件为止。反转后，步进脉冲的行为会从正常高电平切换为脉冲期间的低电平，然后再回到高电平。大多数用户不需要使用此设置，但是对于某些有特殊要求的CNC步进驱动器来说，此设置很有用。例如，方向引脚和步进脉冲之间的人为延迟可以通过使步进引脚反相来产生。

该反转掩码设置是将要反转的轴存储为位标志的值。您确实不需要完全了解其工作原理。您只需要输入要反转的轴的设置值即可。例如，如果要反转X轴和Z轴，$2=5则将其发送到Grbl，设置现在应显示为$2=5 (step port invert mask:00000101)。

此设置反转每个轴的方向信号。默认情况下，Grbl假定当方向引脚信号为低电平时，轴沿正方向移动；当方向引脚信号为高时，轴沿负方向移动。通常，某些机器的轴不会以这种方式移动。对于反向移动的那些轴，此设置将反转方向销信号。

反转掩码设置的工作原理与步进端口反转掩码完全相同，并存储要反转的轴作为位标志。要配置此设置，您只需要发送要反转的轴的值即可。使用上表。例如，如果只想反转Y轴方向，则发送$3=2给Grbl，设置现在应显示为

默认情况下，步进使能引脚为高电平以禁用，而为低电平。如果您的设置需要相反的操作，只需输入即可反转步进启用引脚$4=1。使用禁用$4=0。（可能需要重新启动电源以加载更改。）

默认情况下，极限引脚通过Arduino的内部上拉电阻保持在常高状态。当极限引脚为低电平时，Grbl将其解释为触发。对于相反的行为，只需输入即可反转极限销$5=1。使用禁用$5=0。您可能需要重启然后再加载更改。

注意：为了更高级的使用，可以在config.h中禁用限制引脚上的内部上拉电阻。

默认情况下，探针由Arduino的内部上拉电阻保持在常高状态。当探针引脚为低电平时，Grbl将其解释为触发。对于相反的行为，只需键入即可反转探针$6=1。使用禁用$6=0。您可能需要重启然后再加载更改。

此设置确定当“？”时它将向用户报告哪些Grbl实时数据。状态报告已发送。该数据包括当前运行状态，实时位置，实时进给速度，引脚状态，当前倍率值，缓冲区状态和当前正在执行的g代码行号（如果通过编译时选项启用）。

默认情况下，Grbl v1.1 +中的新报告实现将几乎包含标准状态报告中的所有内容。许多数据是隐藏的，只有更改后才会显示。与旧的报表样式相比，这极大​​地提高了效率，并允许您获得更快的更新并仍然获取有关计算机的更多数据。界面文档概述了它的工作方式，并且大多数仅适用于GUI开发人员或好奇的人。

为了使事情简单和一致，Grbl v1.1只有两个报告选项。这些主要是为用户和开发人员提供的帮助。

可以指定位置类型以显示机器位置（MPos:）或工作位置（WPos:），但不能同时显示两者。在某些情况下，当通过串行终端直接与Grbl进行交互时，启用工作位置很有用，但是默认情况下应使用机器位置报告。 可以启用Grbl的计划器和串行RX缓冲区的使用数据。这显示了各个缓冲区中可用的块或字节数。通常用于帮助确定在测试流接口时Grbl的性能。默认情况下应禁用此功能。 使用下表启用和禁用报告选项。只需添加列出您要启用的值，然后通过向Grbl发送您的设置值来保存它。例如，带有机器位置且没有缓冲区数据报告的默认报告设置为$10=1。如果需要工作位置和缓冲数据，则设置为$10=2。

加速度管理器使用结点偏差来确定它可以在G代码程序路径的线段结点处移动的速度。例如，如果G代码路径急转10度，并且机器以全速移动，则此设置有助于确定机器需要减速多少才能安全通过弯道而不会丢失步数。

我们如何计算它有些复杂，但是通常，较高的值可以使拐角处的运动更快，同时增加了丢失梯级和位置的风险。较低的值会使加速管理器更加谨慎，并会导致谨慎而缓慢的转弯。因此，如果您遇到机器尝试过快转弯的问题，请减小此值以使其在进入转弯时变慢。如果您希望机器通过结点移动得更快，请增加此值以加快速度。对于好奇的人，请单击此链接以了解Grbl的转弯算法，该算法通过一种非常简单，高效且健壮的方法来考虑速度和接合角。

Grbl通过将G2 / G3圆，弧和螺旋细分为细小的细线来渲染G2 / G3的圆，弧和螺旋，以使弧跟踪精度永远不会低于此值。您可能永远不需要调整此设置，因为0.002mm它远低于大多数CNC机床的精度。但是，如果您发现自己的圆太粗或弧形追踪的速度很慢，请调整此设置。较低的值可提供较高的精度，但可能会因过多的细线使Grbl过载而导致性能问题。或者，较高的值会导致较低的精度，但由于Grbl需要处理的线数较少，因此可以提高电弧性能。

出于好奇，将圆弧公差定义为距线段的最大垂直距离，线段的端点位于圆弧（也称为弦）上。对于一些基本几何图形，我们求解线段的长度以跟踪满足此设置的圆弧。用这种方式对电弧建模非常好，因为弧线段会自动调整长度并按比例缩放，以确保最佳的电弧追踪性能，同时又不会损失精度。

Grbl具有实时定位报告功能，可向用户提供有关当时机器确切位置以及坐标偏移和探测参数的用户反馈。默认情况下，它设置为以mm为单位报告，但是通过发送$13=1命令，将此布尔标志发送为true，这些报告功能现在将以英寸为单位报告。$13=0重新设置为毫米。

软限制是一项安全功能，可帮助您防止机器行驶太远且超出行驶限制，撞毁或破坏昂贵的物品。它通过了解每个轴的最大行程限制以及Grbl在机器坐标中的位置来工作。每当有新的G代码运动发送到Grbl时，它都会检查您是否意外地超出了机器空间。如果这样做，Grbl会在任何位置发出即时进给保持，关闭主轴和冷却液，然后设置系统警报以指示问题所在。机器位置将在之后保留，因为它不是由于硬限制而立即被迫停止。

注意：软限制要求启用归位和准确的轴最大行程设置，因为Grbl需要知道它在哪里。$20=1启用和$20=0禁用。

硬限制的工作原理与软限制基本相同，但改用物理开关。基本上，您在每个轴的行进结束时或在任何您觉得如果程序移到不应移动的地方可能会遇到麻烦的地方，连接一些开关（机械的，磁性的或光学的）。开关触发后，它将立即停止所有运动，关闭冷却液和主轴（如果已连接），并进入警报模式，这将迫使您检查机器并重置所有内容。

要在Grbl上使用硬极限，必须使用内部上拉电阻将限位引脚保持在高电平，因此您要做的就是将常开开关的引脚与地线连接在一起，并通过启用硬极限$21=1。（禁用$21=0。）我们强烈建议您采取防止电干扰的措施。如果要限制一个轴的行进两端，只需将两个开关与销和地平行地接线，这样，如果其中一个跳闸，就会触发硬极限。

请记住，硬极限事件被认为是关键事件，在这种情况下，步进器会立即停止并且可能会丢失步数。Grbl没有任何位置反馈，因此无法保证它对位置有任何了解。因此，如果触发了硬限制，Grbl将进入无限循环警报模式，这使您有机会检查计算机并强制您重置Grbl。请记住，这纯粹是一项安全功能。

啊，归位。对于刚启动CNC的用户，每次在两次会话之间启动Grbl时，都使用归位循环来精确准确地定位机器上已知且一致的位置。换句话说，您每次都准确知道自己在什么位置。假设您开始加工某物或准备开始下一步工作，并且电源中断，则重新启动Grbl，而Grbl不知道步进在哪里，这是由于步进器处于开环控制状态。您剩下的任务就是弄清楚自己在哪里。如果进行归位，则始终可以找到机器零参考点，因此，您所要做的就是运行归位循环并从上次中断的地方继续。

要设置Grbl的归位周期，您需要将限位开关固定在不会碰撞或移动的固定位置，否则基准点会被弄乱。通常将它们设置在每个轴的+ x，+ y，+ z的最远点。将限位开关与限位销连接在一起，添加推荐的RC滤波器以帮助减少电气噪声并启用归位功能。如果您好奇，可以将限位开关用于硬限位和归位。他们彼此打得很好。

首次尝试原点复归之前，请确保已正确设置所有内容，否则原点复归可能会出现异常情况。首先，确保您的机器轴按照直角坐标在正确的方向上移动（右手定则）。如果不是，请使用$3方向反转设置进行修复。其次，确保您的限位开关销在Grbl的状态报告中未显示为“已触发”。如果是，请检查接线和设置。最后，确保$13x最大行程设置有些准确（在20％以内），因为Grbl使用这些值来确定搜索归位开关的距离。

默认情况下，Grbl的归位循环首先将Z轴正向移动以清除工作空间，然后同时沿正方向同时移动X和Y轴。为了设置归位周期的行为，页面下方还有更多的Grbl设置来描述它们的工作（以及编译时选项）。

此外，启用归位后还要注意一件事。Grbl将锁定所有G代码命令，直到执行归位循环为止。这意味着没有轴运动，除非锁定被禁用（$X），但稍后会更多。大多数（即使不是全部）CNC控制器也会执行类似的操作，因为它主要是一项安全功能，可以防止用户犯下定位错误，这很容易做到，并且当错误毁坏零件时会感到难过。如果您发现此问题烦人或发现任何怪异的错误，请告诉我们，我们将尝试进行处理，以使每个人都很高兴。😃

注意：请查看config.h，以获取高级用户的更多归位选项。您可以在启动时禁用归位锁定，配置在归位循环中哪些轴先移动以及以什么顺序等等。

默认情况下，Grbl假设您的归位限位开关在正方向上，首先将z轴正向移动，然后将xy轴正向移动，然后再通过在开关周围缓慢地来回移动来精确定位机器零。如果您的机器在负方向上有一个限位开关，则回原点方向遮罩会反转轴的方向。就像步进端口反转掩码和方向端口反转掩码一样，您要做的就是发送表中的值以指示要反转并在相反方向上搜索的轴。

原点复归循环首先以较高的寻道速率搜索限位开关，找到限位开关后，以较低的进给速率移动到机床零位的精确位置。归位进给速度是较慢的进给速度。将此值设置为任何可重复且精确的机器零位定位的速率值。

归位寻道率是归位周期搜索率，或它首次尝试找到限位开关的速率。在足够短的时间内调整到限位开关的速度，而不会太快地撞到您的限位开关。

每当开关触发时，其中一些可能会产生电气/机械噪声，在建立之前实际上会“反弹”信号的高低两毫秒。要解决此问题，您需要使用某种硬件来对信号进行反跳信号调节器或通过软件延迟很短的时间使信号弹起。Grbl会执行短暂的延迟，仅在定位机器零点时归位。将此延迟值设置为交换机可重复进行归位所需的任何值。在大多数情况下，5-25毫秒是可以的。

为了更好地利用硬限位功能（归位可以共享相同的限位开关），归位循环完成后，归位周期将通过该拉出行程移开所有限位开关。换句话说，它有助于防止在归位循环后意外触发硬限制。确保该值足够大以清除限位开关。否则，Grbl将因未能清除错误而引发警报错误。

这将设置最大5V PWM引脚输出的主轴速度。例如，如果要在5V下设置10000rpm，请编程$30=10000。对于5V时的255rpm，编程$30=255。如果程序试图将更高的主轴RPM设置为大于$30最大主轴速度，则Grbl将仅输出最大5V，因为它不能再快得多。默认情况下，Grbl以255个等间隔增量将最大-最小RPM与5V-0.02V PWM引脚输出线性相关。当PWM引脚读取0V时，表明主轴已禁用。请注意，config.h中还有其他配置选项可用于调整其操作方式。

这将设置最小0.02V PWM引脚输出的主轴速度（禁用0V）。Grbl接受较低的RPM值，但PWM输出不会低于0.02V，除非RPM为零。如果为零，则主轴被禁用，PWM输出为0V。

启用后，当用主轴速度（激光功率）编程时，Grbl将通过连续的G1，G2或G3运动命令连续移动S。主轴PWM引脚将在每次运动时立即更新，而不会停止。使用此模式之前，请阅读GRBL激光文档和您的激光设备文档。激光非常危险。它们会立即永久损坏您的视力并引起火灾。Grbl对固件可能引起的任何问题（由其GPL许可定义）不承担任何责任。

禁用后，Grbl会像往常一样运行，并根据每个S主轴速度命令停止运动。这是铣床的默认操作，允许暂停以使主轴改变速度。

Grbl需要知道每个步骤将使该工具实际应用到什么程度。要计算机器轴的步长/毫米，您需要知道：

步进电机每转一圈所经过的毫米数。这取决于皮带传动齿轮或丝杠螺距。 步进电机每转的完整步数（通常为200） 控制器每步的微步（通常为1、2、4、8或16）。提示：使用较高的微步长值（例如16）会降低步进电机的扭矩，因此请使用最低的步长，以便获得所需的轴分辨率和舒适的运行性能。 然后可以像这样计算步长/ mm： s t e p s p e r m m = ( s t e p s p e r r e v o l u t i o n ∗ m i c r o s t e p s ) m m p e r r e v steps_per_mm = \frac{(steps_per_revolution*microsteps)}{mm_per_rev} stepsp​erm​m=mmp​err​ev(stepsp​err​evolution∗microsteps)​

计算每个轴的该值，并将这些设置写入Grbl。

设置每个轴可以移动的最大速率。每当Grbl计划移动时，它都会检查移动是否导致这些单个轴中的任何一个超出其最大速率。如果是这样，它将减慢运动速度，以确保所有轴都不超出其最大速率限制。这意味着每个轴都有自己独立的速度，这对于限制通常较慢的Z轴非常有用。

确定这些值的最简单方法是通过逐渐增加最大速率设置并移动它来一次测试每个轴。例如，要测试X轴，请向Grbl发送G0 X50具有足够行进距离的东西，以使该轴加速到其最大速度。您会知道，当步进器停转时，您已达到最大速率阈值。会产生一点噪音，但不应伤害您的电动机。输入一个比该值低10-20％的设置，这样您就可以考虑磨损，摩擦以及工件/工具的质量。然后，重复其他轴。

注意：此最大速率设置还可以设置G0搜索速率。

这将以毫米/秒/秒为单位设置轴加速度参数。简单地说，较低的值会使Grbl较慢地运动，而较高的值会使运动更紧，并更快地达到所需的进给速度。与最大速率设置非常相似，每个轴都有自己的加速度值，并且彼此独立。这意味着多轴运动将仅以最低贡献轴的速度加速。

同样，与最大速率设置一样，确定此设置的值的最简单方法是用缓慢增加的值分别测试每个轴，直到电动机停转为止。然后将加速度设置定为低于此绝对最大值10-20％的值。这应该考虑磨损，摩擦和质量惯性。我们强烈建议您在使用新设置之前对某些G代码程序进行干燥测试。有时在所有轴上一起移动时，机器上的负载会有所不同。

这将以毫米为单位设置每个轴从一端到另一端的最大行程。仅当启用了软限制（和原点复归）时，此功能才有用，因为Grbl的软限制功能仅使用此功能来检查是否已通过运动命令超出了机器限制。

Grbl的默认配置故意非常通用，以帮助确保用户无需调整设置即可看到成功的运动。通常，您要做的第一件事就是让步进电机运行，通常无需将其连接到CNC。根据制造商指南，将Grbl连接到您的步进驱动器和步进电机。通过串行终端或许多Grbl GUI之一连接到Grbl。发送一些G1或G0命令Grbl。您应该看到步进电机正在旋转。如果您在步进电机上遇到麻烦，请尝试以下操作：

如果尚未将步进电机安装到CNC中，则将其安装。向Grbl发送一些运动命令，例如G91 G0 X1或G91 G0 X-1，它们将使x轴分别移动+ 1mm和-1mm。检查所有轴。如果轴未正确移动，请更改$3方向端口掩码设置以反转方向。

如果您不熟悉如何在CNC机器上设置坐标系，请参阅LinuxCNC的这张精美图。请记住，运动是相对于工具的。因此，在典型的CNC龙门铣床上，刀具将移动而不是固定工作台。如果x轴向右正对齐，则正向运动命令会将工具向右移动。而带有固定工具的移动工作台会将同一命令的工作台向左移动，因为该工具相对于工作台向右移动。

最后，调整您的设置以接近您想要的或最大的性能。首先，请确保您的$100，$101和$102轴步长/毫米设置对您的设置正确。这取决于您的步进增量，驱动器上的微步以及机械参数。如果您的机器制造商没有为您提供特定的机器，则在线上有多种资源可以显示如何计算该机器。调整$12x加速度和$11x最大速率设置以提高性能。设置为不大于绝对最大值的80％，以考虑惯性，切削力以及电机转矩随速度降低的情况。设置你的$13x最大行程设置（如果您打算使用归位或软限制）。建议您现在输入近似于实际行程的内容，以免将来出现问题。

至此，您已经准备好开始了！Grbl现在可以移动您的CNC机床并运行g代码作业。如果需要添加更多功能，例如用于归位或硬限位的限位开关或主轴/激光控制。还有其他Wiki页面可以帮助您。祝好运并玩得开心点！

原文地址：https://github.com/arkypita/LaserGRBL/issues/23 可替代的：http://www.bachinmaker.com/wiki/doku.php?id=start

https://blog.protoneer.co.nz/grbls-pwm-functionality-how-to-control-a-laser-or-variable-speed-spindle/ M3 / M4激光模式：http://lasergrbl.com/usage/raster-image-import/target-image-size-and-laser-options/#laser-modes

https://space.bilibili.com/16061216/