breadboard
documentación

Proyecto de ejemplo · Hogar inteligente

Espectáculo de colores Zigbee

La bombilla usa todos los colores: una luz de color regulable (clústeres ZCL Color + Level reales) se conecta al coordinador del control de color, que recorre una rueda de tonos cada pocos segundos, sin escribir. Pulsa el botón del control para encender/apagar; selecciona la bombilla para ver su color. Ambos sketches están en Code y cada orden es una trama 802.15.4 real en Wi-Fi sniffer.

El circuito Espectáculo de colores Zigbee tal como lo dibuja el simulador

Cómo funciona

La bombilla contiene un C6 con firmware ZigbeeColorDimmableLight: clústeres ZCL On/Off, Level y Color reales, como una Hue. El control DevKit coordina: vincula la bombilla, la enciende y recorre la rueda de colores enviando una orden ZCL real cada pocos segundos. La función RGB del firmware controla el WS2812 interno; la carcasa decodifica sus tramas generadas por software para dibujar el color del vidrio. El botón del control envía Toggle real.

Componentes del montaje

  • Batería (Battery)
  • Bombilla de color Zigbee (Zigbee Color Bulb)
  • ESP32-C6
  • Pulsador (Button)

Cómo está conectado

  • Pulsador (Button) · a→ESP32-C6 · g9
  • Pulsador (Button) · b→ESP32-C6 · gnd2
  • Batería (Battery) · pos→Bombilla de color Zigbee (Zigbee Color Bulb) · vcc
  • Batería (Battery) · neg→Bombilla de color Zigbee (Zigbee Color Bulb) · gnd

El código

Los sketches de Arduino C++ exactos con los que se compiló el firmware incluido. En el simulador, abre Code para editarlos y pulsa Compile & upload para volver a compilar el firmware de la placa.

Color remote (coordinator)

// Zigbee color remote — the coordinator for the color bulb.
//
// Forms the network, binds the color-dimmable light, then puts on a show
// with no typing: every few seconds it walks the bulb through a color
// wheel with genuine ZCL Color/Level commands. Pressing BOOT toggles the
// bulb on/off.

#include <Arduino.h>
#ifndef ZIGBEE_MODE_ZCZR
#error "Zigbee coordinator mode is not selected in Tools->Zigbee mode"
#endif

#include "Zigbee.h"

#define SWITCH_ENDPOINT 5
uint8_t button = BOOT_PIN;

ZigbeeColorDimmerSwitch zbRemote = ZigbeeColorDimmerSwitch(SWITCH_ENDPOINT);

// A small color wheel the remote walks through.
static const uint8_t WHEEL[][3] = {
  {255, 40, 20},   // warm red
  {255, 160, 0},   // amber
  {60, 255, 60},   // green
  {40, 120, 255},  // blue
  {200, 60, 255},  // violet
  {255, 255, 220}, // warm white
};

void setup() {
  Serial.begin(115200);
  pinMode(button, INPUT_PULLUP);

  zbRemote.setManufacturerAndModel("Breadboard", "ColorRemote");
  zbRemote.allowMultipleBinding(true);

  Zigbee.addEndpoint(&zbRemote);
  Zigbee.setRebootOpenNetwork(180);

  if (!Zigbee.begin(ZIGBEE_COORDINATOR)) {
    Serial.println("Zigbee failed to start!");
    Serial.println("Rebooting...");
    ESP.restart();
  }

  Serial.println("Network formed and open. Waiting for the color bulb to bind");
  while (!zbRemote.bound()) {
    Serial.print(".");
    delay(500);
  }
  Serial.println();
  Serial.println("Bulb bound - starting the color show (press BOOT to toggle).");
  delay(1000);
  zbRemote.lightOn();
  zbRemote.setLightLevel(220);
}

void loop() {
  // BOOT toggles the bulb (debounced on release).
  if (digitalRead(button) == LOW) {
    delay(100);
    while (digitalRead(button) == LOW) {
      delay(50);
    }
    zbRemote.lightToggle();
    Serial.println("TOGGLE sent");
  }

  // Walk the color wheel while bound.
  static uint32_t lastStep = 0;
  static size_t idx = 0;
  if (millis() - lastStep >= 5000) {
    lastStep = millis();
    const uint8_t *c = WHEEL[idx];
    idx = (idx + 1) % (sizeof(WHEEL) / sizeof(WHEEL[0]));
    zbRemote.setLightColor(c[0], c[1], c[2]);
    Serial.printf("color -> rgb(%u,%u,%u)\r\n", c[0], c[1], c[2]);
  }
  delay(50);
}

Color bulb (end device)

// Zigbee color bulb — a color-dimmable light end device (like a Hue bulb).
//
// The coordinator's ZCL On/Off, Level and Color commands land here; the
// combined state drives the DevKit's WS2812 (RGB_BUILTIN), which the bulb
// enclosure renders as the glass color.

#include <Arduino.h>
#ifndef ZIGBEE_MODE_ED
#error "Zigbee end device mode is not selected in Tools->Zigbee mode"
#endif

#include "Zigbee.h"

#define ZIGBEE_LIGHT_ENDPOINT 10
uint8_t led = RGB_BUILTIN;

ZigbeeColorDimmableLight zbColorLight = ZigbeeColorDimmableLight(ZIGBEE_LIGHT_ENDPOINT);

void setRGB(bool state, uint8_t red, uint8_t green, uint8_t blue, uint8_t level) {
  if (!state) {
    rgbLedWrite(led, 0, 0, 0);
    Serial.println("light OFF");
    return;
  }
  // Scale the color by the level (ZCL level control), like a real bulb.
  uint8_t r = (uint16_t)red * level / 255;
  uint8_t g = (uint16_t)green * level / 255;
  uint8_t b = (uint16_t)blue * level / 255;
  rgbLedWrite(led, r, g, b);
  Serial.printf("light ON  rgb(%u,%u,%u) level %u\r\n", red, green, blue, level);
}

void setup() {
  Serial.begin(115200);

  rgbLedWrite(led, 0, 0, 0);

  zbColorLight.setManufacturerAndModel("Breadboard", "ColorBulb");
  zbColorLight.onLightChangeRgb(setRGB);

  Serial.println("Adding ZigbeeColorDimmableLight endpoint to Zigbee Core");
  Zigbee.addEndpoint(&zbColorLight);

  if (!Zigbee.begin()) {
    Serial.println("Zigbee failed to start!");
    Serial.println("Rebooting...");
    ESP.restart();
  }
  // Keep the bulb off, but give its first ON command a visible warm red.
  if (!zbColorLight.setLightColor(255, 40, 20)) {
    Serial.println("Failed to set the initial bulb color");
    ESP.restart();
  }

  Serial.println("Connecting to network");
  while (!Zigbee.connected()) {
    Serial.print(".");
    delay(100);
  }
  Serial.println();
  Serial.println("Joined as a color bulb.");
}

void loop() {
  delay(100);
}

Licencia del firmware (en inglés)

Notice: this firmware uses the LGPL-licensed Arduino core library

arduino-zigbee-colorremote-c6.bin is statically linked with Arduino-ESP32 3.3.10. Parts of this library are licensed under the GNU Lesser General Public License, version 2.1 or (at your option) any later version. You may modify this work for your own use and reverse engineer it to debug those modifications. Download the relink package and corresponding source to rebuild it with a changed library.

It also links Espressif’s ZBOSS Zigbee stack, supplied unchanged under its own licence, which forbids reverse engineering, decompiling, modifying or disassembling the ZBOSS binary itself. Relink with the ZBOSS archives unchanged.

Notice: this firmware uses the LGPL-licensed Arduino core library

arduino-zigbee-colorbulb-c6.bin is statically linked with Arduino-ESP32 3.3.10. Parts of this library are licensed under the GNU Lesser General Public License, version 2.1 or (at your option) any later version. You may modify this work for your own use and reverse engineer it to debug those modifications. Download the relink package and corresponding source to rebuild it with a changed library.

It also links Espressif’s ZBOSS Zigbee stack, supplied unchanged under its own licence, which forbids reverse engineering, decompiling, modifying or disassembling the ZBOSS binary itself. Relink with the ZBOSS archives unchanged.

Prueba esto

  • Espera conexión y vinculación y observa: un color nuevo cada 5 segundos.
  • Pulsa el botón del control para apagar y encender en mitad del espectáculo.
  • Selecciona la bombilla: el Inspector muestra el color en hexadecimal en vivo.
  • Abre Wi-Fi sniffer y relaciona cada cambio con su trama ZCL.
Informar de un problema de traducción

Proyectos relacionados