ESP32 Matter Smart Home: Thread, Commissioning & Multi-Admin

# 1. Install ESP-IDF v5.1+ (prerequisite)
mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git
cd esp-idf
git checkout v5.2.3
./install.sh esp32
source export.sh

# 2. Clone esp-matter SDK
cd ~/esp
git clone --recursive https://github.com/espressif/esp-matter.git
cd esp-matter

# 3. Install Python dependencies
pip install -r requirements.txt

# 4. Set environment
export ESP_MATTER_PATH=$(pwd)
export PATH="$ESP_MATTER_PATH/tools:$PATH"

# 5. Build contoh light
cd examples/light
idf.py set-target esp32c6
idf.py build
idf.py flash monitor

#include <esp_matter.h>
#include <esp_matter_console.h>
#include <esp_matter_ota.h>
#include <app-common/zap-generated/ids/Attributes.h>
#include <app-common/zap-generated/ids/Clusters.h>
#include <app/server/CommissioningWindowManager.h>

using namespace esp_matter;
using namespace esp_matter::attribute;
using namespace esp_matter::endpoint;

// GPIO untuk LED
#define LED_GPIO 2
#define BUTTON_GPIO 0

// Callback saat attribute berubah
static esp_err_t app_attribute_change_cb(
  callback_type_t type,
  uint16_t endpoint_id,
  uint32_t cluster_id,
  uint32_t attribute_id,
  esp_matter_attr_val_t *val,
  void *priv_data)
{
  if (type == PRE_UPDATE) {
    // Sebelum update — bisa validasi di sini
    ESP_LOGI("APP", "Attribute update: ep=%d cluster=0x%x attr=0x%x",
      endpoint_id, cluster_id, attribute_id);
  }

  if (type == POST_UPDATE) {
    // Setelah update — kontrol hardware
    if (endpoint_id == 1 &&
        cluster_id == OnOff::Id &&
        attribute_id == OnOff::Attributes::OnOff::Id) {
      // Kontrol LED
      bool state = val->val.b;
      gpio_set_level(LED_GPIO, state ? 1 : 0);
      ESP_LOGI("APP", "LED %s", state ? "ON" : "OFF");
    }
  }

  return ESP_OK;
}

extern "C" void app_main() {
  // Init NVS
  nvs_flash_init();

  // Inisialisasi Matter
  node::config_t node_config;
  node_t *node = node::create(&node_config, app_attribute_change_cb, NULL);

  // Buat endpoint On/Off Light (endpoint 1)
  on_off_light::config_t light_config;
  light_config.on_off.on_off = false;
  light_config.on_off.lighting.start_up_on_off = false;
  endpoint_t *light_ep = on_off_light::create(node, &light_config, ENDPOINT_FLAG_NONE, NULL);

  // Start Matter
  esp_matter::start();

  // Setup GPIO
  gpio_reset_pin(LED_GPIO);
  gpio_set_direction(LED_GPIO, GPIO_MODE_OUTPUT);
  gpio_set_level(LED_GPIO, 0);

  // Print pairing code
  ESP_LOGI("APP", "Matter Light siap!");
  ESP_LOGI("APP", "Pairing code: 34970112332");
  ESP_LOGI("APP", "QR Code: MT:Y3.13OTB00KA0648G00");

  // Setup button untuk factory reset
  gpio_reset_pin(BUTTON_GPIO);
  gpio_set_direction(BUTTON_GPIO, GPIO_MODE_INPUT);
  gpio_set_pull_mode(BUTTON_GPIO, GPIO_PULLUP_ONLY);

  // Factory reset: tahan tombol BOOT 5 detik
  int hold_count = 0;
  while (true) {
    if (gpio_get_level(BUTTON_GPIO) == 0) {
      hold_count++;
      if (hold_count > 50) {  // 5 detik
        ESP_LOGW("APP", "Factory Reset!");
        esp_matter::factory_reset();
      }
    } else {
      hold_count = 0;
    }
    vTaskDelay(pdMS_TO_TICKS(100));
  }
}

// Enable multi-fabric dalam menuconfig
// CONFIG_ENABLE_MULTI_FABRIC=y
// Atau dalam sdkconfig.defaults:

// sdkconfig.defaults
CONFIG_ENABLE_MULTI_FABRIC=y
CONFIG_MAX_ACTIVE_FABRICS=5
CONFIG_MAX_DEFINED_FABRICS=5

// Kode untuk enable multi-admin
void enableMultiAdmin() {
  // Setelah commissioning pertama selesai (fabric 1),
  // buka commissioning window lagi untuk fabric 2

  // Delay 30 detik sebelum buka commissioning window berikutnya
  vTaskDelay(pdMS_TO_TICKS(30000));

  commissioning_window_params_t params = {
    .window_timeout = 300,    // 5 menit
    .iteration = 1000,        // SPAKE2+ iteration count
    .discriminator = 3840,    // Discriminator
    .salt = nullptr,
    .salt_len = 0,
  };

  esp_err_t err = esp_matter::commissioning_window_open(&params);
  if (err == ESP_OK) {
    ESP_LOGI("APP", "Commissioning window dibuka untuk fabric baru!");
    ESP_LOGI("APP", "Pairing code baru: %d", params.setup_pin_code);
  }
}

#include <esp_matter_ota.h>

// Konfigurasi OTA
void setupOTA() {
  // OTA provider: memberikan firmware ke requester
  ota::config_t ota_config = {
    .ota_requestor = true,    // Device bisa menerima OTA
    .ota_provider = false,    // Bukan provider untuk device lain
  };

  // Inisialisasi OTA
  ota::init(&ota_config);

  ESP_LOGI("APP", "OTA diaktifkan");
  ESP_LOGI("APP", "Device siap menerima firmware update");
}

// Callback progress OTA
void otaProgressCallback(uint8_t progress) {
  ESP_LOGI("OTA", "Progress: %d%%", progress);
  // Bisa update LED indicator atau display
  if (progress >= 100) {
    ESP_LOGI("OTA", "Update selesai! Restart...");
    esp_restart();
  }
}