Publish Events

Overview

TilliT can receive event notifications from your equipment via MQTT. Events represent specific occurrences in your production process, such as equipment status changes, quality issues, operator actions, or any other significant happening you want to track. Events are sent to TilliT from your edge devices and are recorded with full context including the asset, order, shift, and timestamp.

Payload

[
  {
    assetId: number;
    orderId?: number;
    shiftId?: number;
    timestamp: string;
    reasonGroupId?: number;
    eventReason?: string;
    eventTypeId?: number;
    value?: string | null;
    template?: DataTagTemplate | null; // see below
    orderStatus?: OrderStatus | null; // see below
    orderNumber?: string | null;
    isCloseEvent?: boolean;
    closedAt?: string;
  }
]

Data Tag Template

  
  EQUIPMENT_STATUS_READY = 'EQUIPMENT_STATUS_READY',
  EQUIPMENT_STATUS_RUNNING = 'EQUIPMENT_STATUS_RUNNING',
  EQUIPMENT_STATUS_STOPPED = 'EQUIPMENT_STATUS_STOPPED',
  EQUIPMENT_STATUS_COMPLETE = 'EQUIPMENT_STATUS_COMPLETE',
  EQUIPMENT_STATUS_SUSPENDED = 'EQUIPMENT_STATUS_SUSPENDED',
  EQUIPMENT_STATUS_STARVED = 'EQUIPMENT_STATUS_STARVED',
  EQUIPMENT_STATUS_BLOCKED = 'EQUIPMENT_STATUS_BLOCKED',
  EQUIPMENT_STATUS_FAULTED = 'EQUIPMENT_STATUS_FAULTED',
  EQUIPMENT_STATUS_ABORTED = 'EQUIPMENT_STATUS_ABORTED',
  COMMAND_RESET = 'COMMAND_RESET',
  COMMAND_START = 'COMMAND_START',
  COMMAND_STOP = 'COMMAND_STOP',
  COUNT_REJECT = 'COUNT_REJECT',
  COUNT_TOTAL = 'COUNT_TOTAL',
  COUNT_DAILY = 'COUNT_DAILY',
  ORDER_NUMBER = 'ORDER_NUMBER',
  DOWNTIME_REASON = 'DOWNTIME_REASON',
  ORDER_STATUS = 'ORDER_STATUS',
  MATERIAL_MOVEMENT_SSCC = 'MATERIAL_MOVEMENT_SSCC',
  MATERIAL_MOVEMENT_QTY = 'MATERIAL_MOVEMENT_QTY',
  ASSET_STATUS_CAUSE = 'ASSET_STATUS_CAUSE',
  

Order Status

  NEW = 'NEW',
  READY = 'READY',
  RUNNING = 'RUNNING',
  SUSPENDED = 'SUSPENDED',
  COMPLETED = 'COMPLETED',
  CANCELLED = 'CANCELLED',
  CHANGEOVER = 'CHANGEOVER',
  

Sending to the MQTT Broker

The topic to publish on is constructed as per the following, replacing ENV, TENANT and THINGNAME with those that apply for you

$aws/rules/`${ENV_NAME}_edge_data/${tenant}/${thingId}/events


e.g $aws/rules/production_edge_data/bottling/TillitEdge-717503/events
    $aws/rules/stage_edge_data/bakery/TillitEdge-a0163b/events

You can find your thingName contained in the same file as the certificates supplied to you. You can also contact support to track down the thingName for you.