Skip to content

SD Card Files

P0k3sm0t edited this page May 23, 2026 · 1 revision

SD Card Files

The SD Card Files card lists files stored on the Ray5 SD card and provides actions for starting, framing, downloading, deleting, and refreshing files.

How to use

  1. Make sure the Status card shows the Ray5 is reachable.
  2. Click Refresh on the SD Card Files card.
  3. Select the file you want.
  4. Use the available action.

Actions

Action Use
Refresh Reload the SD file list
Start Start the selected file from the Ray5 SD card
Frame Frame the selected file using parsed bounds
Download Download a file from the SD card if enabled
Delete Delete a file from the SD card if enabled
Preview Show preview only if supported by the Ray5 API/firmware

Auto-refresh behavior

Ray5 Pilot may pause SD auto-refresh while the machine is busy, uploading, running, holding, jogging, in door state, or in communication-loss safety lockout.

This is intentional. It avoids hammering the Ray5 SD API while the controller is busy.

When to use SD Start

Use SD Start when the file is already on the Ray5 SD card and you want the Ray5 to run it directly.

This is usually smoother than live streaming large jobs.

Troubleshooting

Problem Check
SD list is blank Ray5 reachable, SD inserted, SD API working
SD refresh pauses Machine may be busy or in safety lockout
Start button disabled Start actions may be disabled in Settings
Delete missing Delete actions may be disabled in Settings
File name looks shortened Auto-shorten upload option may be enabled
Preview unavailable Ray5 firmware/API may not support preview
File exists on screen but not in Ray5 Pilot Click Refresh after Ray5 is idle

Clone this wiki locally