Project Catalog # Type
Prepared by Notes Date
Trellix
Public (REST) API
APIs for Trellix on-premises smart spaces
IoT platform
Typical Applications
Oce • Education • Healthcare • Industrial
Interactive Menu
Product Features
• Order Information page 2
• Connected Systems page 3
• Product Warranty
Lighting
Exchange
Admin
Locate
Top Product Features
• APIs for space management applications – Allows third party partners to securely exchange data with Trellix Lighting and
obtain data such as a space occupancy status, energy usage and light level. Third party partners can use these insights
to offer solutions that would optimize operation eciency and tenant experience including solutions that would reduce a
facility’s energy usage, improve oor layout, and optimizes conference rooms usage.
• APIs for asset management and workow optimization application – Allows third party partners to securely exchange
data with Trellix Locate and obtain data gathered from assets and geo-fence notications. Third party partners can use
these insights to optimize business operations and tenant experience including solutions that automatically identify
workow deciencies, eciently locate specic assets within the facility and improve equipment utilization rates.
• REST (Representational State Transfer)
– Simplies the exchange of data and
operations interface between third
party applications and Cooper Lighting
Solutions connected lighting system
using HTTPS and JSON data format with
simple POST, GET actions to exchange
data between the applications.
• Secured Authentication and
authorization – Using the OAuth 2
authorization framework, the interface
enables a third-party application to obtain
limited access to an HTTPS service by
orchestrating an approval interaction
between Trellix and the HTTPS service or
by allowing the third party application to
obtain access on its own behalf.
Lighting
Devices
Gateway
Data
Data
Controller
Microservices
Storage
Trellix Exchange
BACnet/IP, APIs & OpenADR services
Trellix Core Services
Data
Data
Trellix Admin
Trellix Lighting
Trellix Locate
Trellix Partners Apps
PS503132EN page 1
July 2020
Trellix
Public (REST) API
Order Information
Trellix Core models TRX-TCPRO2, TRX-TCENT2 and TRX-TCVRT2 come with a base software license for interfaces that includes Public API for 250 nodes.
For systems with more than 250 nodes, users need to purchase Public API Software License Adders.
Note: A node is a device connected to the connected lighting system such as ceiling or integrated occupancy sensors, wallstations, relay switchpacks, powerpacks,
connected driver or receptacle.
Catalog Number
API Adder License Description
TRX-API250 API Software License option for 250 nodes
Notes
1. The Trellix applications are preloaded on Trellix Core platforms, i.e. Trellix Pro (TRX-TCPRO2), Trellix Enterprise (TRX-TCENT2) and Virtual Trellix Enterprise (TRX-TCVRT2).
Please refer to the Trellix Core datasheet to learn more about the capability of each platform.
2. All Trellix Core platforms are shipped with a base software license which enables Trellix Lighting and Trellix Exchange interfaces, except for OpenADR, for up to 250 nodes.
3. Capacity adder licenses are offered to increase the number of devices for Trellix lighting, Trellix BACnet and Trellix API for systems larger than the Trellix Core includes.
Product Specications
Network Requirements
• The IP network shall allow HTTP data exchange between the Trellix Core and the
third party applications. Please refer to the Wavelinx Installation and Planning
guide for more information with regards to the IT network requirements.
Performance Specifications
• Trellix Core Pro: Maximum of 2,000 connected devices
• Trellix Core Enterprise: Maximum of 45,000 connected devices
• Trellix Core Virtual Enterprise: Maximum of 45,000 connected devices
Supported Commands
• A subset of the HTTP methods is supported by the REST API.
• The supported methods are GET, POST
(Notes: PUT and DELETE actions not currently supported).
Please refer to the Trellix Reference Manual for more details.
Warranty
Consult website for warranty information.
PS503132EN page 2
July 2020