Skip to content
P0k3sm0t edited this page May 23, 2026 · 1 revision

GRBL

The GRBL page is for reading, backing up, and editing Ray5 controller $ settings.

This page replaces the old Machine Settings wording. Use GRBL for controller firmware settings and Settings for Ray5 Pilot app settings.

Open GRBL

Use the top navigation:

GRBL

The route may still internally use machine-settings for compatibility, but the user-facing page is GRBL.

What this page is for

Use GRBL when you need to:

  • Read controller $ settings.
  • Back up current settings.
  • Compare settings.
  • Change a known numeric GRBL value.

Do not use it for normal Ray5 Pilot app settings. Those are on Settings.

Before changing anything

  1. Back up the current settings.
  2. Change only one or two values at a time.
  3. Write down what you changed.
  4. Test carefully.
  5. Restore the backup if something behaves wrong.

Safety notes

GRBL settings can affect:

  • Travel limits
  • Homing
  • Acceleration
  • Max speed
  • Steps/mm
  • Laser mode
  • Spindle/laser power behavior

Wrong values can cause crashes, wrong scale, missed steps, or unsafe laser behavior.

Troubleshooting

Problem Fix
GRBL page cannot load settings Check Ray5 connection and unlock state
Save is rejected Key/value may not be numeric or valid
Machine moves wrong distance Restore previous steps/mm settings
Homing changed Review homing-related $ values
Laser power behavior changed Review laser/spindle-related settings
Unsure what a value does Do not change it until you verify it

Clone this wiki locally