Consensus Command and Control Protocol (CCCP)

The Consensus Command and Control Protocol (CCCP) is the native command protocol for Conreality nodes.

Overview

CCCP is an asynchronous application protocol built on the transport-layer User Datagram Protocol (UDP) running on IPv4 and IPv6 networks.

The use of UDP enables flexible asymmetric network topologies, where requests and responses may potentially travel by wholly different routes.

Port Number

The UDP protocol port is 1984.

Message Format

Messages are snippets of Lua code.

Commands

  • Device Control: enable, disable, toggle
  • Motion Control: hold, pan, tilt
  • Motion Planning:
  • Object Tracking: track
  • Swarm Membership: join, leave

Command Reference

abort

abort {mission}

disable

Disables a device.

In a natural-language interface, suggested aliases for this command include: stop.

disable {device=led01}

enable

Enables a device.

In a natural-language interface, suggested aliases for this command include: start.

enable {device=led01}

fire

fire {device=laser, seconds=3.0}

hold

hold {}

join

join {swarm=perimeter}

leave

leave {swarm=perimeter}

pan

Rotates the FOV in the horizontal plane.

pan {direction=left, degrees=90.0}

ping

ping {ipv4='8.8.8.8'}

resume

resume {}

tilt

Rotates the FOV in the vertical plane.

tilt {direction=up, degrees=45.0}

toggle

Toggles a device.

toggle {device=laser}

track

track {object=objects[42]}