Skip to content

Status Card

Jump to bottom
P0k3sm0t edited this page May 23, 2026 · 1 revision

Status Card

The Status card is the first thing to read before moving, framing, or running a job.

It shows live machine state, position, connection health, laser/pump indicators, system check results, update state, and safety lockout warnings.

Main fields

Field Meaning
State GRBL/Ray5 state such as Idle, Run, Hold, Alarm, Jog, Door, Offline
PageID ESP3D page/session ID if captured
X / Y Current machine/work position shown by live status
WCO Work coordinate offset
Feed Current feed value from live status
Laser Simple On/Off display based on command/status tracking
Laser Power Estimated percent or dash when unknown
Alarm Current alarm state or dash
Job Current job status if Ray5 Pilot is tracking one
Air Pump Air assist/pump state when detected or commanded
Timelapse Timelapse active, armed, paused, disabled, or idle state
Connection Online/offline/status connection summary
Progress Job progress when Ray5 Pilot can estimate it
File Current tracked job file
Run Time Local run timer when available
Source Where the displayed status came from
Version Ray5 Pilot version
Update In-app update check result

System check fields

Field Good result Meaning
Ray5 host configured Yes A Ray5 host/IP is set in Settings
Ray5 HTTP reachable Yes The HTTP interface responds
Ray5 WebSocket reachable Yes Live status WebSocket responds
PAGEID captured Yes ESP3D session/page ID was captured
SD card list working Yes Ray5 Pilot can list SD files
Camera URL configured Yes if using camera Camera URL exists in Settings
Camera test passed Yes if camera works Camera test succeeded

Source values

The Status card may show different sources depending on what is happening.

  • live means WebSocket status is being used.
  • upload_busy means Ray5 Pilot knows an upload is in progress and avoids treating short connection stalls as a failure.
  • offline means Ray5 Pilot does not have usable live status.
  • fallback/tracker values may be shown when live progress is not available but Ray5 Pilot has local run information.

Safety lockout

If Ray5 Pilot loses communication while a job may be active, the Status card can show a communication-loss safety lockout.

Do not clear it blindly. First check:

  1. The physical Ray5 screen.
  2. Whether the laser is still moving or firing.
  3. Whether the machine is idle.
  4. Whether the work area is safe.

Only then use Clear Safety Lockout.

How to use the Status card

Before a job, confirm:

  • State is safe for the action you want.
  • Connection is good.
  • System check is not showing obvious failures.
  • Laser is not unexpectedly on.
  • Alarm is clear.
  • Camera and SD status are correct if you need them.

During a job, watch:

  • State
  • Laser
  • Progress
  • Run Time
  • Connection
  • Timelapse

After a job, confirm:

  • State returned to Idle.
  • Laser is Off.
  • Timelapse saved if enabled.
  • SD refresh has resumed.

Troubleshooting

Status problem Likely cause What to do
Offline Wrong IP, Ray5 off, network issue Check Ray5 IP and Settings
HTTP reachable is No Ray5 web interface not reachable Test the Ray5 web page directly
WebSocket reachable is No Port/path/subprotocol issue Confirm port 8849, path /, subprotocol arduino
SD card list working is No SD API not responding or Ray5 busy Wait for idle, refresh SD list
Camera test failed Bad camera URL or camera offline Use Camera Test and check camera URL
Safety lockout appears Communication lost during possible job Check machine physically before clearing
Laser shows On after stop Status may be briefly stale Verify machine, send M5 if needed, refresh status

Clone this wiki locally