Distech Controls ECLYPSE

What you can build

• Catch a setpoint that walked away

  The operator reads present-value and setpoint properties on a cycle and compares them with the approved range. When one drifts, it proposes a write at the agreed priority and shows you the trend that justifies it.

  With Setpoint Drift

• Find equipment running after hours

  Weekly schedules and binary outputs come from the same API. The operator flags outputs that are active outside the schedule and proposes an exception-schedule entry rather than a manual override.

  With After-Hours Audit

• Start the plant later on mild mornings

  Trend logs give the warm-up curve for each zone. The operator proposes a later occupancy start when the curve allows it and leaves the original schedule in the receipt.

  With Optimal Start

Requirements

• One or more ECLYPSE controllers reachable over HTTPS on the building network or through a managed tunnel
• A controller user with the roles needed to read objects and, for writes, to change property values
• The object type and instance numbers for the points you want, as configured in EC-gfxProgram or Envysion
• Acceptance of the Distech Controls API license agreement linked from Distech's API documentation

Authentication

HTTP Basic authentication with an ECLYPSE user account; the first authorized request returns an ECLYPSERESTSESSIONID cookie that later requests carry in place of the Authorization header.

Limits

• The API is per controller; a portfolio means one session per device and no site-level roll-up
• Trend log frequency is set in the controller's configuration, not through the API; the API only reads what was logged
• The event-notifications response is available in XML only
• System query options such as $select and $expand apply only to resources that support them; the trend and write resources do not

Questions and answers

Does the ECLYPSE REST API push events, or do I have to poll?

Polling is the documented pattern. GET /protocols/bacnet/local/event-notifications lists current notifications, and the Scheduled Calls resource can run a request on a cron expression or on a BACnet change-of-value and send the result to a configured destination type such as iotHub.

How is a write priority set?

POST to a property resource and add the priority query parameter, for example priority=16. The write-property-multiple resource carries a Priority field per PropertyReference and expects every value as a string, even numbers.

Can one request read many points?

Yes. POST /protocols/bacnet/local/objects/read-property-multiple returns several properties at once, and POST /batch combines multiple sub-requests in one JSON body with an id per request. The batch reply uses 207 when sub-request statuses differ.