start_time, stop_time, duration:

  • If none are specified, then start_time is now, stop_time is never, and duration is infinity.
  • Only two of the three are allowed on any given Command and the third is derived from the equation stop_time = start_time + duration.
  • If only start_time is specified then stop_time is never and duration is infinity.
  • If only stop_time is specified then start_time is now and duration is derived.
  • If only duration is specified then start_time is now and stop_time is derived.

response_requested:

  • If response_requested is specified as none then the Consumer SHOULD NOT send a Response.
  • If response_requested is specified as ack then the Consumer SHOULD send a Response acknowledging receipt of the Command: {"status": 102}.
  • If response_requested is specified as status then the Consumer SHOULD send a Response containing the current status of Command execution.
  • If response_requested is specified as complete then the Consumer SHOULD send a Response containing the status or results upon completion of Command execution.
  • If response_requested is not explicitly specified then the Consumer SHOULD respond as if complete was specified.
interface Arguments {
    duration?: number;
    response_requested?: ResponseType;
    start_time?: number;
    stop_time?: number;
}

Properties

duration?: number

The length of time for an Command to be in effect

response_requested?: ResponseType

The type of Response required for the Command: none, ack, status, complete

start_time?: number

The specific date/time to initiate the Command

stop_time?: number

The specific date/time to terminate the Command