Skip to content

Commit 953f8e4

Browse files
committed
Tuto 2 initiated
1 parent 5267a20 commit 953f8e4

File tree

3 files changed

+89
-1
lines changed

3 files changed

+89
-1
lines changed

content/hardware/03.nano/boards/nano-matter/tutorials/matter-rgb-light/content.md

+89-1
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,92 @@ software:
1717
- ide-v2
1818
- web-editor
1919
- iot-cloud
20-
---
20+
---
21+
22+
## Overview
23+
24+
This tutorial will teach you how to create a Matter RGB Lightbulb to light up any room with colors.
25+
26+
![RGB lightbulb overview](assets/thumbnail-v1.png)
27+
28+
Thanks to the seamless compatibility of the Nano Matter with almost any Matter network we can easily integrate our RGB light with Amazon Alexa, Google Assistant, Apple Home, Home Assistant and even custom assistants.
29+
30+
## Hardware and Software Requirements
31+
### Hardware Requirements
32+
33+
- [Nano Matter](https://store.arduino.cc/products/nano-matter) (x1)
34+
- DHT11 Temperature and Humidity sensor (x1)
35+
- I2C OLED Display SSD1306(x1)
36+
- Breadboard (x1)
37+
- Jumper wires
38+
- Google Nest Hub Max (Thread Border Router) (x1)
39+
- [USB-C® cable](https://store.arduino.cc/products/usb-cable2in1-type-c) (x1)
40+
41+
### Software Requirements
42+
43+
- [Arduino IDE 2.0+](https://www.arduino.cc/en/software) or [Arduino Cloud Editor](https://create.arduino.cc/editor)
44+
- [Google Home App](https://home.google.com/get-app/)
45+
- [U8g2](https://github.com/olikraus/u8g2) library to control the OLED display. You can install it from the Arduino IDE library manager.
46+
- [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.
47+
48+
### Board Core and Libraries
49+
50+
The **Silicon Labs** core contains the libraries and examples you need to work with the board's components, such as its Matter, Bluetooth® Low Energy, and I/Os. To install the Nano Matter core, navigate to **File > Preferences** and in the **Additional boards manager URLs**, add the following:
51+
52+
`https://siliconlabs.github.io/arduino/package_arduinosilabs_index.json`
53+
54+
Now navigate to **Tools > Board > Boards Manager** or click the Boards Manager icon in the left tab of the IDE. In the Boards Manager tab, search for `Nano Matter` and install the latest `Silicon Labs` core version.
55+
56+
![Installing the Silicon Labs core in the Arduino IDE](assets/bsp-install-2.png)
57+
58+
## Project Setup
59+
60+
### Schematic Diagram
61+
62+
Use the following connection diagram for the project:
63+
64+
![Project wiring diagram](assets/diagram-v1.png)
65+
66+
### Programming
67+
68+
In the Arduino IDE upper menu, navigate to **Tools > Protocol stack** and select **Matter**.
69+
70+
![Matter Protocol stack selected](assets/matter-setup-2.png)
71+
72+
Copy and paste the following sketch:
73+
74+
```arduino
75+
76+
```
77+
78+
Once you uploaded the example code to the Nano Matter, open the Serial Monitor and reset the board.
79+
80+
![QR Code URL](assets/serial-monitor.png)
81+
82+
There you will find the URL that generates the QR for the Matter device commissioning.
83+
84+
### Commissioning
85+
86+
Copy and paste the QR code URL on your favorite web browser and a unique QR code will be generated for your board.
87+
88+
Go to your **Google Home** app, navigate to **devices** and tap on **Add**, select the **Matter-enabled device** option and scan the QR code.
89+
90+
![Adding the device to Google Home app](assets/add-device.png)
91+
92+
![Your device is successfully added](assets/add-device-2.png)
93+
94+
## Final Results
95+
96+
Finally, you will be able to monitor your room temperature from your smartphone, hub or asking to your personal assistant.
97+
98+
![Temperature sensor final result](assets/temp-sensor.png)
99+
100+
You can also see the temperature value on the device OLED display.
101+
102+
## Conclusion
103+
104+
In this tutorial we have learned how to create a Matter enabled temperature sensor that can be monitored from our smartphone and personal assistant. The Nano Matter allows us to seamlessly integrate the sensor as a commercial product with our current smart home ecosystem.
105+
106+
### Next Steps
107+
108+
You can take this solution even further by adding the humidity measuring capability of the DHT11 sensor and integrate it as a 2nd sensor to your Matter network.
Loading

0 commit comments

Comments
 (0)