
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

Trellix
Public (REST) API
Sample System Topology:
This diagram shows the main components of the WaveLinx Wireless and Wired Connected Lighting system.
The WaveLinx wireless system communicates using wireless mesh technology based on the IEEE 802.15.4 standard. A PoE LAN
connection for each Wireless Area Controller (WAC) is required for power and data access to the building lighting network.
The WaveLinx wired system controls the devices using relay, 0-10V, DMX and the WaveLinx wired digital local bus. The WaveLinx
wired system connects to the building LAN using the EG2 module. Each WaveLinx wired area controller communicate on the
WaveLinx wired network.
WaveLinx Area Controllers (WAC) and WaveLinx Ethernet Gateways (EG2) communicate with Trellix over the Ethernet network.
Please refer to the WaveLinx Wireless Network and IT Guidance Technical Guide and WaveLinx Wired Network and IT Guidance
Technical Guide for more information.
IoT
and
API
Touchscreen
Partner Apps
WaveLinx Wired
Local Bus
Smart Lighting Apps3rd Party Integration
Trellix Admin Trellix LightingTrellix Exchange
WaveLinx Wired
Network
WaveLinx
Wired
System
Trellix Core
wired
OR
wireless
WaveLinx
Wireless
System
Firewall
Up to 300
Wireless Area
Controllers
(Trellix Core
Enterprise & Virtual)
Wireless Area
Controller
View
WaveLinx Network
and IT Guidance
Technical Guide
Touchscreen
Smartphone
with
WaveLinx
app
Area or Room
20A
Relay
WaveLinx Wired local bus devices
(up to 64 devices per local bus)
Room Based
Occupancy Sensor
Scene
Wallstation
Addressable
Fixture
Relay Controlled
Fixture
WaveLinx
Wired
Connects to Trellix Core (Pro, Enterprise, Virtual)
Trellix Core # of gateways/devices 20 / 2000 20 / 2000
Trellix Enterprise # of gateways/devices 300 / 45,000* 300 / 45,000*
Trellix
Trellix Virtual Enterprise # of gateways/devices 300 / 45,000* 300 / 45,000*
Connecting device EG2/EG2-NA WAC-POE
Alarms
Events
Operate (oorplan control)
Operate - area control
Operate - zone control
Operate - device control
Trellix Lighting
Scheduling
Energy Dashboard
Occupancy Dashboard
BACnet/IP
Public (REST) API
Trellix
OpenADR
Exchange
Manage Users
Manage roles
Manage clients
Manage licenses
Trellix Admin
System settings (backup/restore, network etc)
* For larger number of gateways and devices, please contact Cooper Lighting Solutions Sales representatives.
Recommend designing the system at 70-80% of maximum capacity.
= All features = Subset of features
Area or Room
(15 + 1 construction area)
347V and 20A
Dimming Relay
Wireless Controlled Lighting ready devices
(up to 150 per WAC)
Room Based
Occupancy Sensor
WaveLinx
Wireless
Controlled
Receptacle
Scene
Wallstation
WaveLinx-Integrated
Ambient
Control Systems
• Trellix
• WaveLinx Wireless
• WaveLinx Wired
• VividTune
WaveLinx-Integrated
Outdoor
Cooper Lighting Solutions
1121 Highway 74 South
Peachtree City, GA 30269
P: 770-486-4800
www.cooperlighting.com
© 2020 Cooper Lighting Solutions
All Rights Reserved.
Specifications and dimensions
subject to change without notice.
PS503132EN page 3
July 2020