Skip to content

Maintenance Quick Commands

The Quick Commands buttons on the Maintenance page come from web/readinet/maintenance_commands.json. If the file has no entries, the page says "No quick commands configured yet".

{
  "commands": [
    {
      "label": "Open Clamp",
      "command": "fido.run_manual('fido.clamp.fullopen()')",
      "confirm": true,
      "note": "Fingers Clear!",
      "timeout": 30
    }
  ]
}
Key Meaning
label Button text
command Sent to the sampler as-is
confirm true shows an "Are you sure?" dialog with the command first
note Optional extra line in the confirmation dialog
timeout Seconds to wait for the sampler to reply

Wrap action calls in fido.run_manual('...') so the sampler always reports MANUAL (success) or ERROR (it raised), rather than leaving the request waiting for a reply.

Custom Command

Send Custom Command on the Maintenance page sends free text to the sampler. Whatever is typed is wrapped as fido.run_manual("..."), so fido.clamp.fullopen() runs as fido.run_manual("fido.clamp.fullopen()"). An optional timeout in seconds can be given.

The User Guide deliberately doesn't list available commands. The command set is defined by the esp-sampler firmware. See its documentation.