Pepperdash.Essentials.Plugins.Colorlight.Z6 2.0.0-4series-conversion.8

Uintled ColorLight Z6 (c) 2025

License

Provided under MIT license

Configuration

Device ID (properties.id)

The ColorLight Z6 EPI uses an id value in the Essentials configuration to determine which device ID to embed in all commands.

• Config path: properties.id
• Type: unsigned 16-bit integer (0–65535), specified as a decimal value in JSON.
• Wire format: the value is split into high/low bytes and sent as:
  • High byte: (byte)(id >> 8)
  • Low byte: (byte)(id & 0xFF)

Common cases:

• id = 1

  • Wire bytes: 0x00 0x01
  • Example usage: target a specific device with ID 1.

• id = 65535

  • Wire bytes: 0xFF 0xFF
  • Example usage: broadcast / "unknown ID" mode as allowed by the manufacturer. This is how to send \xFF\xFF on the wire from config.

Note: JSON does not support hex literals like 0xFFFF; always enter the decimal equivalent (65535) in the Essentials configuration.

Example Essentials configuration snippet

{
	"devices": [
		{
			"key": "colorlight-z6-1",
			"name": "ColorLight Z6",
			"type": "colorlightz6",
			"group": "displays",
			"properties": {
				"control": {
					// standard Essentials TCP/UDP control config here
				},
				"id": 1,       // sends 0x00 0x01 as the ID bytes
				"friendlyNames": [
					{
						"inputNumber": 1,       // button 11
						"name": "HDMI Processor",
						"hideInput": false,
						"inputSelect": 1,       // optional: route to input 1 (default behavior)
						"brightness": 32767,    // optional: 50% brightness
						"preset": 1             // optional: recall preset 1
					},
					{
						"inputNumber": 2,       // button 12
						"name": "Scene - Movie",
						"hideInput": false,
						"brightness": 49149,    // brightness-only scene (75%)
						"preset": 3             // optional: preset 3
					},
					{
						"inputNumber": 3,       // button 13
						"name": "Preset Only",
						"hideInput": false,
						"preset": 5             // preset-only scene
					},
					{
						"inputNumber": 7,       // button 17
						"name": "Spare",
						"hideInput": true        // hidden from SIMPL: no button action, no feedback, blank name
					}
				]
			}
		},
		{
			"key": "colorlight-z6-broadcast",
			"name": "ColorLight Z6 (Broadcast)",
			"type": "colorlightz6",
			"group": "displays",
			"properties": {
				"control": {
					// standard Essentials TCP/UDP control config here
				},
				"id": 65535   // sends 0xFF 0xFF as the ID bytes
			}
		}
	]
}

SIMPL Bridge Join Map

The SIMPL bridge mapping is defined by the ColorlightZ6JoinMap class. The tables below show the join numbers, directions, types, and descriptions.

Digital joins

Analog joins

Serial joins