Zigbee_On-Off_MultiSwitch example problems

[dbn-b4e]

Board

ESP32C6

Device Description

Button and RGB led onboard

Hardware Configuration

ESP32C6Zero (Waveshare)

Version

latest development Release Candidate (RC-X)

IDE Name

Arduino IDE

Operating System

Mac OSX 15.1

Flash frequency

80

PSRAM enabled

no

Upload speed

921000

Description

Hello,

I have tested to create ESP32C6 zigbee device with light, temperature and input switch at the same time. Basically it works. Temperature and Light are fully ok. While I tested many things to get the switch to work without any success.

I want it to work with Z2M and not as local coordinator.

First problem from the example is zbSwitch.setManualBinding(true); that does not exist as method. Strange. Looked at all repos and no clue.

Second problem is it reports as IAS with alarm1, alarm2 what is in the code. How to create a simple (or multiple) wall input buttons with simple, double or whatever function? I do not see it in any example. Seems to me a basic function but I cannot find anything working in Arduino IDE with the wrappers.

Third problem is the ROUTER mode, if I try the MultiSwitch example with Coordinator in ESP stack config and start with Zigbee.begin(ZIGBEE_ROUTER) it crashes at startup.

If anybody has any idea... mmany thanks. Library ESP is latest 3.3.0 alpha 1.

Sketch

Here is the global sketch:


// Copyright 2024 Espressif Systems (Shanghai) PTE LTD
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

/**
 * @brief This example demonstrates Zigbee temperature sensor.
 *
 * The example demonstrates how to use Zigbee library to create a end device temperature sensor.
 * The temperature sensor is a Zigbee end device, which is controlled by a Zigbee coordinator.
 *
 * Proper Zigbee mode must be selected in Tools->Zigbee mode
 * and also the correct partition scheme must be selected in Tools->Partition Scheme.
 *
 * Please check the README.md for instructions and more detailed description.
 *
 * Created by Jan Procházka (https://github.com/P-R-O-C-H-Y/)
 */

#ifndef ZIGBEE_MODE_ED
#error "Zigbee end device mode is not selected in Tools->Zigbee mode"
#endif

#include "Zigbee.h"

/* Zigbee temperature sensor configuration */
#define TEMP_SENSOR_ENDPOINT_NUMBER     10
#define ZIGBEE_LIGHT_ENDPOINT           11
#define CONTACT_SWITCH_ENDPOINT_NUMBER  12

//#define ZIGBEE_ROLE NONE//ZIGBEE_ROUTER

uint8_t button = 9;
uint8_t sensor_pin = 9;
#define LED_PIN 8

typedef enum {
  SWITCH_ON_CONTROL,
  SWITCH_OFF_CONTROL,
  SWITCH_ONOFF_TOGGLE_CONTROL,
  SWITCH_LEVEL_UP_CONTROL,
  SWITCH_LEVEL_DOWN_CONTROL,
  SWITCH_LEVEL_CYCLE_CONTROL,
  SWITCH_COLOR_CONTROL,
} SwitchFunction;

typedef struct {
  uint8_t pin;
  SwitchFunction func;
} SwitchData;

typedef enum {
  SWITCH_IDLE,
  SWITCH_PRESS_ARMED,
  SWITCH_PRESS_DETECTED,
  SWITCH_PRESSED,
  SWITCH_RELEASE_DETECTED,
} SwitchState;

// Optional Time cluster variables
struct tm timeinfo;
struct tm *localTime;
int32_t timezone;



ZigbeeTempSensor zbTempSensor = ZigbeeTempSensor(TEMP_SENSOR_ENDPOINT_NUMBER);
ZigbeeLight zbLight = ZigbeeLight(ZIGBEE_LIGHT_ENDPOINT);
ZigbeeContactSwitch zbContactSwitch = ZigbeeContactSwitch(CONTACT_SWITCH_ENDPOINT_NUMBER);


/********************* RGB LED functions **************************/
void setLED(bool value) {
  if (value)
    rgbLedWrite(LED_PIN,0,255,0);
  else
    rgbLedWrite(LED_PIN,0,0,0);
}

/************************ Temp sensor *****************************/
static void temp_sensor_value_update(void *arg) {
  for (;;) {
    // Read temperature sensor value
    float tsens_value = temperatureRead();
    Serial.printf("Updated temperature sensor value to %.2f°C\r\n", tsens_value);
    // Update temperature value in Temperature sensor EP
    zbTempSensor.setTemperature(tsens_value);
    delay(1000);
  }
}

/********************* Arduino functions **************************/
void setup() {
  Serial.begin(115200);

 // Init button + switch
  pinMode(button, INPUT_PULLUP);
  pinMode(sensor_pin, INPUT_PULLUP);

  // Init RGB and leave light OFF
  rgbLedWrite(LED_PIN,0,0,0);

  // Set callback function for light change
  zbLight.onLightChange(setLED);



  zbLight.setVersion( 1234);
  zbTempSensor.setVersion( 1234);
  zbContactSwitch.setVersion( 1234);
  
  //Add endpoint to Zigbee Core
  Serial.println("Adding ZigbeeSwitch endpoint to Zigbee Core");
  Zigbee.addEndpoint(&zbContactSwitch);

  //Add endpoint to Zigbee Core
  Serial.println("Adding ZigbeeLight endpoint to Zigbee Core");
  Zigbee.addEndpoint(&zbLight);

  // Optional: set Zigbee device name and model
  zbTempSensor.setManufacturerAndModel("B4E", "ZB_Test_1");

  // Set minimum and maximum temperature measurement value (10-50°C is default range for chip temperature measurement)
  zbTempSensor.setMinMaxValue(10, 60);

  // Optional: Set tolerance for temperature measurement in °C (lowest possible value is 0.01°C)
  zbTempSensor.setTolerance(1);

  // Optional: Time cluster configuration (default params, as this device will revieve time from coordinator)
  zbTempSensor.addTimeCluster();

  // Add endpoint to Zigbee Core
    Serial.println("Adding ZigbeeTemperature endpoint to Zigbee Core");
  Zigbee.addEndpoint(&zbTempSensor);

  Serial.println("Starting Zigbee...");
  // When all EPs are registered, start Zigbee in End Device mode
  if (!Zigbee.begin()) {
    Serial.println("Zigbee failed to start!");
    Serial.println("Rebooting...");
    ESP.restart();
  } else {
    Serial.println("Zigbee started successfully!");
  }
  Serial.println("Connecting to network");
  while (!Zigbee.connected()) {
    Serial.print(".");
    delay(100);
  }
  Serial.println();

  // Optional: If time cluster is added, time can be read from the coordinator
  timeinfo = zbTempSensor.getTime();
  timezone = zbTempSensor.getTimezone();

  Serial.println("UTC time:");
  Serial.println(&timeinfo, "%A, %B %d %Y %H:%M:%S");

  time_t local = mktime(&timeinfo) + timezone;
  localTime = localtime(&local);

  Serial.println("Local time with timezone:");
  Serial.println(localTime, "%A, %B %d %Y %H:%M:%S");

  // Start Temperature sensor reading task
  xTaskCreate(temp_sensor_value_update, "temp_sensor_update", 2048, NULL, 10, NULL);

  // Set reporting interval for temperature measurement in seconds, must be called after Zigbee.begin()
  // min_interval and max_interval in seconds, delta (temp change in 0,1 °C)
  // if min = 1 and max = 0, reporting is sent only when temperature changes by delta
  // if min = 0 and max = 10, reporting is sent every 10 seconds or temperature changes by delta
  // if min = 0, max = 10 and delta = 0, reporting is sent every 10 seconds regardless of temperature change
  zbTempSensor.setReporting(1, 0, 1);
}

void loop() {
#if 0
  // Checking button for factory reset
  if (digitalRead(button) == LOW) {  // Push button pressed
    // Key debounce handling
    delay(100);
    int startTime = millis();
    while (digitalRead(button) == LOW) {
      delay(50);
      if ((millis() - startTime) > 3000) {
        // If key pressed for more than 3secs, factory reset Zigbee and reboot
        Serial.println("Resetting Zigbee to factory and rebooting in 1s.");
        delay(1000);
        Zigbee.factoryReset();
      }
    }
    zbTempSensor.reportTemperature();
  }
#endif

  // Checking pin for contact change
  static bool contact = false;
  if (digitalRead(sensor_pin) == HIGH && !contact) {
    // Update contact sensor value

    zbContactSwitch.setClosed();
    contact = true;
    Serial.println("Switch true");
  } else if (digitalRead(sensor_pin) == LOW && contact) {
    zbContactSwitch.setOpen();
    contact = false;
    Serial.println("Switch false");
  }

#if 0
  // Checking button for factory reset
  if (digitalRead(button) == LOW) {  // Push button pressed
    // Key debounce handling
    delay(100);
    int startTime = millis();
    while (digitalRead(button) == LOW) {
      delay(50);
      if ((millis() - startTime) > 3000) {
        // If key pressed for more than 3secs, factory reset Zigbee and reboot
        Serial.println("Resetting Zigbee to factory and rebooting in 1s.");
        delay(1000);
        Zigbee.factoryReset();
      }
    }
  }

  #endif
  delay(100);
  // Send temperature each 10 seconds
  static uint32_t lastPrint = 0;
  if (millis() - lastPrint > 10000) {
    lastPrint = millis();
    zbTempSensor.reportTemperature();
  }
}

[Zigbee_Sensor.txt](https://github.com/user-attachments/files/21077061/Zigbee_Sensor.txt)

Debug Message

[  1336][E][ZigbeeContactSwitch.cpp:82] report(): Failed to send IAS Zone status changed notification: 0x2: ERROR
Switch true

Other Steps to Reproduce

No additional steps

I have checked existing issues, online documentation and the Troubleshooting Guide

• I confirm I have checked existing issues, online documentation and Troubleshooting guide.

[P-R-O-C-H-Y]

Hi @dbn-b4e, I will answer your questions:

I have tested to create ESP32C6 zigbee device with light, temperature and input switch at the same time. Basically it works. Temperature and Light are fully ok. While I tested many things to get the switch to work without any success.

I want it to work with Z2M and not as local coordinator.

First problem from the example is zbSwitch.setManualBinding(true); that does not exist as method. Strange. Looked at all repos and no clue.

What was the actual problem with the Switch? I have beed testing the example for multiswitch with HomeAssistant - ZHA without any issues. Maybe there is some needed configuration for Z2M.

The setManualBinding method is located in ZigbeeEP class, as its a common method

arduino-esp32/libraries/Zigbee/src/ZigbeeEP.h

Line 75 in aab542d

void setManualBinding(bool bind) {

Second problem is it reports as IAS with alarm1, alarm2 what is in the code. How to create a simple (or multiple) wall input buttons with simple, double or whatever function? I do not see it in any example. Seems to me a basic function but I cannot find anything working in Arduino IDE with the wrappers.

The thing about SmartButtons is, that Zigbee 3.0 Specification does not declare any cluster or HA device for smart buttons - which is what you want to do. The ZigbeeSwitch is made to be switching on/off, dimming or color changing a bounded lights to the switch. Not to be sending events -> single, double and long press. This can be done only with custom configuration on Z2M or ZHA side like for example SonOff SmartButton does. But it's not a standard thing.

About the ContactSwitch, that's how IAS Zone devices works. In ZHA its fully working, maybe its missing support in Z2M to be easily used. Check this to see what Alarm1 and Alarm2 values means.

If you don't like the ContactSwitch, you can use BinaryInput endpoint. Which will do the same job but there won't be the extra security element that IAS uses - enrolling.

Third problem is the ROUTER mode, if I try the MultiSwitch example with Coordinator in ESP stack config and start with Zigbee.begin(ZIGBEE_ROUTER) it crashes at startup.

For that you need to select proper Zigbee mode and partition scheme in the IDE Tools menu. This is how it can look If you want to be starting Zigbee device in ROUTER mode and you have a C6 with 8MB of flash.

Let me know if you have any additional questions.

[dbn-b4e]

Hello,

Many thanks for your fast response! You rock!

In order to be clear about my goal:

1. I originaly wanted to use PVTO firmware but...
2. It is closed firmware and the developer did not wanted to add a function to driver one (or many) I/O expander like PCA9554
3. I am a hardware developer and had like to bring a lot my 1000+ hardware under Altium to the open source community
4. We are using 20.000+ ESP32-S3 for our commercial product (OCPP EVSE charger with 4G)
5. So basically I will open a discussion (I don't know where nor how... if you have an idea) in order to decide with interested people to define the "best" playground for ESP32-C6 and Zigbee at hardware level. I mean for example:

• External antenna (the waveshare ESP32-C6-Zero antenna is a real drama)
• 8 input buttons (hence the "Moes" like questions to have home push buttons inputs)
• 8 relay outputs
• ATM90E26 or other energy meter
• 1-wire bus
• RS485 modbus
• PCF RTC I2C
• ... other things people would like
• In a 24 or 230V DIN rail box

If I build this, would you need one to be able to test your code, would be happy to send you one.

Now this is explained, regrading your answers:

1. I don't have Coordinator/router in Arduino IDE, on which version are you? I am on 2.3.6 with ESP version 3.3.0 alpha. ANy idea?
2. If I do compile with coordinator and ROUTER in setup it enter a boot loop, is it because I have 4MB only? Strange since it compiles.
3. I am using Z2M with dozens of device without any problem. I can setup raspi with new HA and use ZHA in order to do a quick test.
4. With the "Multiswicth" and Z2M unable to have any trigger.
5. For the "smart button" I really don't understand why such a thing common to hundred of devices is not in the spec... Do you have a plan to do such thing, a lot of people are looking for it on forums and nobody manages to do so, be it under vscode or Arduino...
6. For the ROUTER thing it is setup as all project (working) I am trying out.
7. I tested the code from one of the "issues" from Support for ZigbeeButton #11112 and it is ok (still the [mvermand22] open question in the issue). But it is a on/off (tested with toggle) and does not reports triggers.

Again, many thanks for you time and developments.

David

[dbn-b4e]

I tried to recompile and have a look at zigbee.h thing but cannot find any reference for:

// Set binding settings depending on the role
if (ZIGBEE_ROLE == ZIGBEE_COORDINATOR) {
zbSwitch.allowMultipleBinding(true); // To allow binding multiple lights to the switch
} else {
zbSwitch.setManualBinding(true); //Set manual binding to true, so binding is done on Home Assistant side
}

And Zigbee.setManualBinding does not exist either.

EDIT: Ok installed 3.2.1 again and there it is. Disappeared in 3.3.0...

David

[P-R-O-C-H-Y]

If I build this, would you need one to be able to test your code, would be happy to send you one.

Would be awesome to have one to test all the stuff supported or even future stuff.

1. I don't have Coordinator/router in Arduino IDE, on which version are you? I am on 2.3.6 with ESP version 3.3.0 alpha. ANy idea?

You really don't see this in the Tools menu? I did install the 3.3.0-alpha1 and after I selected ESP32C6 Devkit I can see this menu. No issue here

2. If I do compile with coordinator and ROUTER in setup it enter a boot loop, is it because I have 4MB only? Strange since it compiles.

If it does not fit in Flash, it won't compile at all if the board defines have proper partition schemes maximum sizes defined. What board are you using or selecting in the IDE?

3. I am using Z2M with dozens of device without any problem. I can setup raspi with new HA and use ZHA in order to do a quick test.

From my point of view ZHA is a better option now for DYI Zigbee devices. All Endpoints supported in this Zigbee library are tested using the ZHA.

4. With the "Multiswicth" and Z2M unable to have any trigger.

The multiswitch works as following. In ZHA you join your network for example with 3 ESP32s. 1 have the MultiSwitch example loaded and other 2 have the ON/OFF Light example loaded. In ZHA you go to the MultiSwitch device and click on bindings. Then you select the 2 ESPs with ON/OFF Light and after that you can control the lights from the multiSwitch device. Like on/off or toggle. You can also have some groups or control directly only 1 device by its address.

5. For the "smart button" I really don't understand why such a thing common to hundred of devices is not in the spec... Do you have a plan to do such thing, a lot of people are looking for it on forums and nobody manages to do so, be it under vscode or Arduino...

Yeah I would expect to have some, but there is nothing. I can do that, but it will require a custom quirk loaded to the ZHA in order to make it work. It won't work just out of the box as other devices does.

6. For the ROUTER thing it is setup as all project (working) I am trying out.

Don't know what to answer here :D

7. I tested the code from one of the "issues" from Support for ZigbeeButton #11112 and it is ok (still the [mvermand22] open question in the issue). But it is a on/off (tested with toggle) and does not reports triggers.

This is exactly as the point 5. It won't work out of the box.
The SonOff uses translating the on, off and toggle commands to single, double and long press. That's how it can be done. But that requires the quirk.

I am happy to help and answer any questions

[dbn-b4e]

Hello Jan, Hardware: Great for the hardware. Do you any idea where I can post such brain-storming ideas before doing? Can you share your whishes / ideas? Would help me a LOT. You will be first (with me) to receive prototype :) ZHA vs Z2M: A *lot* of people are migrating to Z2M because of many (good) reasons. Why do you test with ZHA…? I will do a test with ZHA. Button / scene: What does it require to make this single/double/long press with Arduino zigbee and Z2M? Look at forums everybody is crying for this and are on Z2M mainly… Priority #1 :) Board: As per previous post I am on Waveshare C6 Zero and don’t se it. But true if I select devkit it shows up. Urgh! ZHA and pairing: As per what you say about the 3 boards this is not what normal user expects. It expects Zigbee triggers then does an automation, or better a blueprint wrapper. This is state of the art now. ZHA quircks / Z2M: Their device works with the triggers on Z2M. Example (Tuya based): Moes https://www.zigbee2mqtt.io/devices/TS0044.html#tuya-ts0044 Should be possible… Can look at Tuya.js translator. If I don’t disturb you too much, that’s perfect. PS: You seen my email can we exchange by email? I assume you don’t want to share your email on GitHub :) Ir. David Baldwin B4E SRL - Administrateur 40, Rue de l'Etang B-1410 Waterloo Belgium Mob: +32 477 56 29 78 <tel://+32 477 56 29 78> Mail: ***@***.*** ***@***.***> VAT : BE0635.630.310 Please consider our environment before printing this e-mail Disclaimer: This message and any attachments thereto are confidential. They may also be privileged or otherwise protected by work product immunity or other legal rules. If you have received it by mistake, please let us know by e-mail reply and delete it from your system; you may not copy this message or disclose its contents to anyone. E-mail transmission cannot be guaranteed to be secure or error free as information could be intercepted, corrupted, lost, destroyed, arrive late or incomplete, or contain viruses. The sender therefore is in no way liable for any errors or omissions in the content of this message, which may arise as a result of e-mail transmission. If verification is required, please request a hard copy. Cet email, ainsi que ses annexes, est confidentiel. Il contient des informations particulières destinées à l'usage exclusif de celui à qui il est adressé. Si ce message est reçu par quelqu'un d'autre que son destinataire, merci de le retourner simplement en y répondant et ensuite de le supprimer de votre ordinateur. Si vous n'êtes la personne à qui ce message est destiné, vous ne pouvez en faire de copie, le faire circuler ou en divulguer l'existence à qui que ce soit. Si le présent message est incomplet ou incorrect, merci de le retourner à son expéditeur.

…

Le 7 juil. 2025 à 14:11, Jan Procházka ***@***.***> a écrit : P-R-O-C-H-Y left a comment (espressif/arduino-esp32#11555) <#11555 (comment)> If I build this, would you need one to be able to test your code, would be happy to send you one. Would be awesome to have one to test all the stuff supported or even future stuff. I don't have Coordinator/router in Arduino IDE, on which version are you? I am on 2.3.6 with ESP version 3.3.0 alpha. ANy idea? You really don't see this in the Tools menu? I did install the 3.3.0-alpha1 and after I selected ESP32C6 Devkit I can see this menu. No issue here Screenshot.2025-07-07.at.13.36.30.png (view on web) <https://github.com/user-attachments/assets/d6888f26-5ca2-4c1d-8e78-cec64d5924ce> If I do compile with coordinator and ROUTER in setup it enter a boot loop, is it because I have 4MB only? Strange since it compiles. If it does not fit in Flash, it won't compile at all if the board defines have proper partition schemes maximum sizes defined. What board are you using or selecting in the IDE? I am using Z2M with dozens of device without any problem. I can setup raspi with new HA and use ZHA in order to do a quick test. From my point of view ZHA is a better option now for DYI Zigbee devices. All Endpoints supported in this Zigbee library are tested using the ZHA. With the "Multiswicth" and Z2M unable to have any trigger. The multiswitch works as following. In ZHA you join your network for example with 3 ESP32s. 1 have the MultiSwitch example loaded and other 2 have the ON/OFF Light example loaded. In ZHA you go to the MultiSwitch device and click on bindings. Then you select the 2 ESPs with ON/OFF Light and after that you can control the lights from the multiSwitch device. Like on/off or toggle. You can also have some groups or control directly only 1 device by its address. For the "smart button" I really don't understand why such a thing common to hundred of devices is not in the spec... Do you have a plan to do such thing, a lot of people are looking for it on forums and nobody manages to do so, be it under vscode or Arduino... Yeah I would expect to have some, but there is nothing. I can do that, but it will require a custom quirk loaded to the ZHA in order to make it work. It won't work just out of the box as other devices does. For the ROUTER thing it is setup as all project (working) I am trying out. Don't know what to answer here :D I tested the code from one of the "issues" from Support for ZigbeeButton #11112 <#11112> and it is ok (still the [mvermand22] open question in the issue). But it is a on/off (tested with toggle) and does not reports triggers. This is exactly as the point 5. It won't work out of the box. The SonOff uses translating the on, off and toggle commands to single, double and long press. That's how it can be done. But that requires the quirk. I am happy to help and answer any questions — Reply to this email directly, view it on GitHub <#11555 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AQGQ4IO4DNY5YSKNWHJNSRD3HJPXRAVCNFSM6AAAAACA3B5BEOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTANBUG43DMMBWGQ>. You are receiving this because you were mentioned.