Skip to content

Multi-command dispatch

2025-06-25

This feature is about allowing the operator to directly enter scheduled groups of commands in a single request.

Status: very preliminary.

The usual text field in the Command tab is used to also support this feature.

Preliminary version is mainly for initial testing of the necessary support on the backend. A future version can provide a more friendly user interface (e.g, explicit checkbox to indicate multi-command dispatch, use of multiple text fields, etc.)

Note that multiple commands have been and will continue to be supported in this field (with ; as the usual separator).

Multi-command dispatch refers to the ability to enter multiple command groups, each with its own scheduling.

For this purpose, --- is used as a separator between command groups.

The presence of any --- in the text field triggers the new dispatch, which consists of the following:

The user should now directly schedule each command group as part of the contents of the text field.

The scheduling for each command group can be indicated as follows:

  • "AFTER":

    • Start the group with sched as prefix
    • Then, add the semicolon-separated list of commands enclosed in "
    • Example: sched "load Engineering/lineCaptureHoming.tl;run"

  • "At time":

    • Start the group with sched YYYYMMDDThhmm as prefix
      • where YYYYMMDDThhmm indicates the date and time (UTC)
    • Then, add the semicolon-separated list of commands enclosed in "
    • Example: sched 20250625T0415 "load Engineering/undock.tl;run"

  • "ASAP": In this case, no prefix is required; just enter the semicolon-separated list of commands in a single line

  • Example: load Engineering/undock.tl;run

As an example of a complete multi-command input:

sched "load Engineering/lineCaptureHoming.tl;set lineCaptureHoming.StayOnDock 1 bool;set lineCaptureHoming.DockingAltitude 7.75 m;set lineCaptureHoming.AltitudeDepthLimit 68 m;set lineCaptureHoming.MaxDepth 70 m;set lineCaptureHoming.CorrectForSoundSpeed 1 bool;run"
---
sched "load Engineering/OnDock.tl;set OnDock.DockedTime 12 h;run"
---
sched 20250625T0415 "load Engineering/undock.tl; set undock.TransitLat 36.91 degree; set undock.TransitLon -122.11 degree; run"
---
sched 20250625T0430 "ubat on"
---
schedule list