Skip to main content

Receives member task ingress

SUB 

{agent-base-topic}/exec/command

A move-to or search-area sent to an admitted member is handed unchanged to the Swarm Unit for delegation, including an optional boolean params.swarm (see SwarmFlag). If the member observes no Swarm Leader, it immediately fails the command on this member's execution boundary with fail-reason 'no swarm leader'. A move-to with params.swarm true (a Swarm Move, flown by the Swarm Leader for the whole Swarm) is also failed on this member's execution boundary, mirroring the Swarm Unit, with fail-reason 'no formation' when the formation is none, or 'task-already-running' when another Swarm Move is active. A command with an invalid params.agent-count, or one combined with params.swarm true, is failed on this member's execution boundary with fail-reason 'invalid-agent-count', one with an agent-count above one for a task type that gives it no meaning with 'agent-count-unsupported', and one asking for more Agents than the Swarm roster holds, or above one on a standalone or not-yet-admitted Agent, with 'insufficient-agents', and a search-area asking for more Agents than its area has lawnmower tracks with 'area-too-small'; none is handed to the Swarm Unit.

MQTT​

QoS1
retainfalse

Message message​

Message message​

Receives member task ingress
{
"task": {
"params": {
"swarm": false,
"agent-count": 1
}
},
"parent-task-uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"parent-com-uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}