CCT Zone Status

Get the current status of CCT lights in a zone.

Description

The CCT status allows you to retrieve the current state of tunable white LED lights in a zone including:

• Current dimming level (0-100%)
• Current color temperature (0-100%)

Request Topic

LYT/41e0d6b2-37de-43d8-a348-4ba94853b6cd/ZONE/STATUS

Request Payload

{
   "version": "v1.0",
   "type": "cct",
   "address": 57364
}

Request Field Descriptions

Field	Type	Required	Description
version	string	Yes	API version identifier (must be "v1.0")
type	string	Yes	Message type (must be "cct")
address	number	Yes	Address of the zone

Response Topic

LYT/41e0d6b2-37de-43d8-a348-4ba94853b6cd/ZONE/E/STATUS

Response Payload

Success Response

{
   "version": "v1.0",
   "message": "success",
   "type": "cct",
   "address": 57364,
   "cct": {      
      "dimming": 85,
      "color_temperature": 75
   }
}

Error Handling

The API may return various error responses based on different scenarios:

1. Zone Not Found Error (Code: 2005)

{
   "message": "error",
   "message_type": {
      "code": 2013,
      "message": "Zone not found",
      "errorCode": "ZONE_NOT_FOUND"
   },
   "type": "cct",
   "address": 50646
}

When it occurs:

• The specified zone address doesn't exist
• Zone has been deleted
• Zone is not configured

How to resolve:

1. Verify the zone address is correct
2. Check if the zone exists in the system
3. Ensure the zone is properly configured
4. Use zone management API to list available zones

2. Project Not Found Error (Code: 2002)

{
   "message": "error",
   "message_type": {
      "code": 2002,
      "message": "Project not found",
      "errorCode": "PROJECT_NOT_FOUND"
   },
   "type": "cct",
   "address": 50646
}

When it occurs:

• The project_uuid in your MQTT topic is invalid
• The project has been deleted
• The user doesn't have access to the project

How to resolve:

1. Verify the project_uuid in your MQTT topic is correct
2. Check if you have the necessary permissions to access the project
3. Contact system administrator if you should have access but don't

3. Request Timeout Error (Code: 3002)

{
   "message": "error",
   "message_type": {
      "code": 3002,
      "message": "Request timeout",
      "errorCode": "REQUEST_TIMEOUT"
   },
   "type": "cct",
   "address": 50646
}

When it occurs:

• Network connectivity issues
• Zone devices are not responding
• MQTT broker connection issues

How to resolve:

1. Check your network connection
2. Verify MQTT broker is accessible
3. Ensure zone devices are powered and connected

4. Constraint Error (Code: 3005)

a. Address Constraint:

{
   "message": "error",
   "message_type": {
      "code": 3005,
      "message": "address must be a number conforming to the specified constraints",
      "errorCode": "CONSTRAINT_ERROR"
   },
   "type": "cct",
   "address": 50646
}

b. Type Constraint:

{
   "message": "error",
   "message_type": {
      "code": 3005,
      "message": "type must be one of the following values: cct, dimmer, switch, fan, curtain, rgb",
      "errorCode": "CONSTRAINT_ERROR"
   },
   "type": "cct",
   "address": 50646
}

c. Version Constraint:

{
   "message": "error",
   "message_type": {
      "code": 3005,
      "message": "version must be one of the following values: v1.0",
      "errorCode": "CONSTRAINT_ERROR"
   },
   "type": "cct",
   "address": 50646
}

Constraint errors occur in the following cases:

1. Address Constraints:

   • Address must be a valid number
   • Address field is missing
   • Address field has incorrect type

2. Type Constraints:

   • Type must be one of: "cct", "dimmer", "switch", "fan", "curtain", "rgb"
   • Type field is missing
   • Type field has incorrect value

3. Version Constraints:

   • Version must be exactly "v1.0"
   • Version field is missing
   • Version field has incorrect format

Resolution:

• Always use "v1.0" as the version value
• Use "cct" as the type value
• Ensure address is a valid number
• Validate all parameters before sending

Error Code Summary

Code	Error Code	Description	Solution
3005	CONSTRAINT_ERROR	Parameter validation failed	Check input values
2005	ZONE_NOT_FOUND	Zone not available	Verify zone exists
2002	PROJECT_NOT_FOUND	Project doesn't exist	Check project_uuid
3002	REQUEST_TIMEOUT	Request took too long	Check connectivity