tutorial 2 advance

Author: mcmchris

content/hardware/03.nano/boards/nano-matter/tutorials/matter-rgb-light/assets/bsp-install-2.png

@@ -42,7 +42,6 @@ Thanks to the seamless compatibility of the Nano Matter with almost any Matter n
 - [Arduino IDE 2.0+](https://www.arduino.cc/en/software) or [Arduino Cloud Editor](https://create.arduino.cc/editor)
 - [Amazon Alexa](https://www.amazon.com/Alexa-App/b?ie=UTF8&node=18354642011)
 - [Seeed_RGB_LED_Matrix](https://github.com/Seeed-Studio/Seeed_RGB_LED_Matrix) library to control the RGB LED matrix. You can install it as .ZIP using the Arduino IDE.
-- [DHT](https://github.com/mcmchris/DHT-sensor-library/tree/patch-1) library. Download from this [branch](https://github.com/mcmchris/DHT-sensor-library/tree/patch-1) so it support the Nano Matter. 
 
 ### Board Core and Libraries
 
@@ -60,7 +59,7 @@ Now navigate to **Tools > Board > Boards Manager** or click the Boards Manager i
 
 Use the following connection diagram for the project:
 
-![Project wiring diagram](assets/diagram-v1.png)
+![Project wiring diagram](assets/diagram-v2.png)
 
 ### Programming
 
@@ -71,7 +70,164 @@ In the Arduino IDE upper menu, navigate to **Tools > Protocol stack** and select
 Copy and paste the following sketch:
 
 ```arduino
-
+#include <Matter.h>
+#include <MatterLightbulb.h>
+#include "grove_two_rgb_led_matrix.h"
+
+#define LED_R LED_BUILTIN
+#define LED_G LED_BUILTIN_1
+#define LED_B LED_BUILTIN_2
+
+MatterColorLightbulb matter_color_bulb;
+
+GroveTwoRGBLedMatrixClass matrix;
+
+void update_led_color();
+void led_off();
+void handle_button_press();
+volatile bool button_pressed = false;
+
+void setup() {
+  Wire.begin();
+  Serial.begin(115200);
+  Matter.begin();
+  matter_color_bulb.begin();
+  matter_color_bulb.boost_saturation(51);  // Boost saturation by 20 percent
+
+  // Set up the onboard button
+  pinMode(BTN_BUILTIN, INPUT_PULLUP);
+  attachInterrupt(BTN_BUILTIN, &handle_button_press, FALLING);
+
+  uint16_t VID = 0;
+  VID = matrix.getDeviceVID();
+  if (VID != 0x2886) {
+    Serial.println("Can not detect led matrix!!!");
+    while (1)
+      ;
+  }
+  Serial.println("Matrix init success!!!");
+
+  matrix.stopDisplay();
+
+  // Turn the LED off
+  led_off();
+
+  Serial.println("Arduino Nano Matter - color lightbulb");
+
+  if (!Matter.isDeviceCommissioned()) {
+    Serial.println("Matter device is not commissioned");
+    Serial.println("Commission it to your Matter hub with the manual pairing code or QR code");
+    Serial.printf("Manual pairing code: %s\n", Matter.getManualPairingCode().c_str());
+    Serial.printf("QR code URL: %s\n", Matter.getOnboardingQRCodeUrl().c_str());
+  }
+  while (!Matter.isDeviceCommissioned()) {
+    delay(200);
+  }
+
+Serial.println("Waiting for Thread network...");
+  while (!Matter.isDeviceThreadConnected()) {
+    delay(200);
+  }
+  Serial.println("Connected to Thread network");
+
+  Serial.println("Waiting for Matter device discovery...");
+  while (!matter_color_bulb.is_online()) {
+    delay(200);
+  }
+  Serial.println("Matter device is now online");
+
+}
+
+void loop() {
+  // If the physical button state changes - update the lightbulb's on/off state
+  if (button_pressed) {
+    button_pressed = false;
+    // Toggle the on/off state of the lightbulb
+    matter_color_bulb.toggle();
+  }
+
+  // Get the current on/off state of the lightbulb
+  static bool matter_lightbulb_last_state = false;
+  bool matter_lightbulb_current_state = matter_color_bulb.get_onoff();
+
+  // If the current state is ON and the previous was OFF - turn on the LED
+  if (matter_lightbulb_current_state && !matter_lightbulb_last_state) {
+    matter_lightbulb_last_state = matter_lightbulb_current_state;
+    Serial.println("Bulb ON");
+    // Set the LEDs to the last received state
+    update_led_color();
+  }
+
+  // If the current state is OFF and the previous was ON - turn off the LED
+  if (!matter_lightbulb_current_state && matter_lightbulb_last_state) {
+    matter_lightbulb_last_state = matter_lightbulb_current_state;
+    Serial.println("Bulb OFF");
+    led_off();
+  }
+
+  static uint8_t hue_prev = 0;
+  static uint8_t saturation_prev = 0;
+  static uint8_t brightness_prev = 0;
+  uint8_t hue_curr = matter_color_bulb.get_hue();
+  uint8_t saturation_curr = matter_color_bulb.get_saturation_percent();
+  uint8_t brightness_curr = matter_color_bulb.get_brightness_percent();
+
+  // If either the hue, saturation or the brightness changes - update the LED to reflect the latest change
+  if (hue_prev != hue_curr || saturation_prev != saturation_curr || brightness_prev != brightness_curr) {
+    update_led_color();
+    hue_prev = hue_curr;
+    saturation_prev = saturation_curr;
+    brightness_prev = brightness_curr;
+  }
+}
+
+// Updates the color of the RGB LED to match the Matter lightbulb's color
+void update_led_color() {
+  if (!matter_color_bulb.get_onoff()) {
+    return;
+  }
+  uint8_t r, g, b;
+  matter_color_bulb.get_rgb(&r, &g, &b);
+// If our built-in LED is active LOW, we need to invert the brightness values
+  if (LED_BUILTIN_ACTIVE == LOW) {
+    analogWrite(LED_R, 255 - r);
+    analogWrite(LED_G, 255 - g);
+    analogWrite(LED_B, 255 - b);
+  } else {
+    analogWrite(LED_R, r);
+    analogWrite(LED_G, g);
+    analogWrite(LED_B, b);
+  }
+
+  uint32_t RGB = ((uint8_t)r << 16L) | ((uint8_t)g << 8L) | (uint8_t)b;
+  matrix.displayColorBlock(RGB, 0, true);
+
+  Serial.printf("Setting bulb color to > r: %u  g: %u  b: %u\n", r, g, b);
+}
+
+// Turns the RGB LED off
+void led_off() {
+  // If our built-in LED is active LOW, we need to invert the brightness values
+  if (LED_BUILTIN_ACTIVE == LOW) {
+    analogWrite(LED_R, 255);
+    analogWrite(LED_G, 255);
+    analogWrite(LED_B, 255);
+  } else {
+    analogWrite(LED_R, 0);
+    analogWrite(LED_G, 0);
+    analogWrite(LED_B, 0);
+  }
+  matrix.stopDisplay();
+}
+
+void handle_button_press() {
+  static uint32_t btn_last_press = 0;
+  if (millis() < btn_last_press + 200) {
+    return;
+  }
+  btn_last_press = millis();
+  button_pressed = true;
+}
 ```
 
 Once you uploaded the example code to the Nano Matter, open the Serial Monitor and reset the board.

content/hardware/03.nano/boards/nano-matter/tutorials/matter-rgb-light/assets/diagram-v2.png

@@ -42,7 +42,7 @@ Thanks to the seamless compatibility of the Nano Matter with almost any Matter n
 - [Arduino IDE 2.0+](https://www.arduino.cc/en/software) or [Arduino Cloud Editor](https://create.arduino.cc/editor)
 - [Google Home App](https://home.google.com/get-app/)
 - [U8g2](https://github.com/olikraus/u8g2) library to control the OLED display. You can install it from the Arduino IDE library manager.
-- [DHT](https://github.com/mcmchris/DHT-sensor-library/tree/patch-1) library. Download from this [branch](https://github.com/mcmchris/DHT-sensor-library/tree/patch-1) so it support the Nano Matter. 
+- [DHT](https://github.com/mcmchris/DHT-sensor-library/tree/patch-1) library. Download from this [branch](https://github.com/mcmchris/DHT-sensor-library/tree/patch-1) so it supports the Nano Matter. 
 
 ### Board Core and Libraries