You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/hardware/_unlisted/boards/nano-matter/tutorials/user-manual/content.md
+14-14Lines changed: 14 additions & 14 deletions
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@ title: 'Nano Matter User Manual'
3
3
difficulty: beginner
4
4
compatible-products: [nano-matter]
5
5
description: 'Learn about the hardware and software features of the Arduino® Nano Matter.'
6
-
tags:
6
+
tags:
7
7
- IoT
8
8
- Matter
9
9
- BLE
@@ -91,7 +91,7 @@ The complete STEP files are available and downloadable from the link below:
91
91
92
92
### Form Factor
93
93
94
-
The Nano Matter board features castellated pins, which are ideal for integrating the board into final solutions.
94
+
The Nano Matter board features castellated pins, which are ideal for integrating the board into final solutions.
95
95
96
96
You can easily solder the Nano Matter in your custom PCB, since the board does not present any bottom-mounted components.
97
97
@@ -300,7 +300,7 @@ void handle_button_press()
300
300
301
301
Here is the example sketch main functions explanation:
302
302
303
-
- In the `setup()` function, Matter is initialized with `Matter.begin()` alongside the initial configurations of the board to handle the different inputs and outputs. The device commissioning is verified with `Matter.isDeviceCommissioned()` to show the user the network pairing credentials if needed and the connection is confirmed with the `Matter.isDeviceConnected()` function.
303
+
- In the `setup()` function, Matter is initialized with `Matter.begin()` alongside the initial configurations of the board to handle the different inputs and outputs. The device commissioning is verified with `Matter.isDeviceCommissioned()` to show the user the network pairing credentials if needed and the connection is confirmed with the `Matter.isDeviceConnected()` function.
304
304
- In the `loop()` function, the RGB LED is controlled on and off with `matter_color_bulb.set_onoff(state)`, the current state is retrieved with `matter_color_bulb.get_onoff()` and the button state is read to control the LED manually.
305
305
- In the `update_led_color()` function, the color defined in the app is retrieved using the function `matter_color_bulb.get_rgb(&r, &g, &b)` that stores the requested color code in RGB format variables.
306
306
@@ -342,7 +342,7 @@ Finally, you will be able to control the Nano Matter built-in RGB LED as a nativ
342
342
343
343

344
344
345
-
You are also able to control your device using voice commands with your personal assistant.
345
+
You are also able to control your device using voice commands with your personal assistant.
346
346
347
347
If you want to commission your Nano Matter solution with another service, follow the steps in the [decommissioning](#device-decommissioning) section.
348
348
@@ -398,7 +398,7 @@ If this is your first Matter device, you may be asked to define the Matter hub t
398
398
399
399

400
400
401
-
Then, follow the steps for adding and naming the Matter Light bulb:
401
+
Then, follow the steps for adding and naming the Matter Light bulb:
402
402
403
403

404
404
@@ -412,7 +412,7 @@ If you want to commission your Nano Matter solution with another service, follow
412
412
413
413
### With Home Assistant
414
414
415
-
To use Matter with Home Assistant, you will need one of the *Google Home* or *Apple Home* devices that can work as a **Thread® Border Router**, listed in the previous sections.
415
+
To use Matter with Home Assistant, you will need one of the *Google Home* or *Apple Home* devices that can work as a **Thread® Border Router**, as listed in the previous sections.
416
416
417
417
To set up Home Assistant so that it can manage Matter devices, we need first to install the **Matter Server** add-on. For this, navigate to **Settings > Add-Ons > Add-On Store** and search for **Matter server**:
418
418
@@ -422,7 +422,7 @@ When the Matter server is correctly installed, navigate to **Settings > Devices
422
422
423
423

424
424
425
-
A prompt will show up asking for a connection method; if you are working with custom containers running the Matter server, uncheck the box.
425
+
A prompt will show up asking for a connection method; if you are working with custom containers running the Matter server, uncheck the box.
426
426
427
427
In our case, we leave it checked as the Matter server is running in Home Assistant.
428
428
@@ -452,7 +452,7 @@ If you want to commission your Nano Matter solution with another service, follow
452
452
453
453
### Device Decommissioning
454
454
455
-
If you have a Matter device configured and working with a _specific platform_, for example with the Google Home ecosystem, and you want to integrate it with Alexa or Apple Home instead, you need to decommission it first from the previous service.
455
+
If you have a Matter device configured and working with a _specific platform_, for example with the Google Home ecosystem, and you want to integrate it with Alexa or Apple Home instead, you need to decommission it first from the previous service.
456
456
457
457
In simple terms, **decommissioning** refers to unpairing your device from a current service to be able to pair it with a new one.
458
458
@@ -620,13 +620,13 @@ The main code functions are explained below:
620
620
- The microcontroller's internal temperature is measured with the function `getCPUTemp();`.
621
621
- The temperature value is advertised using the `matter_temp_sensor.set_measured_value_celsius(current_cpu_temp);` function.
622
622
623
-
After uploading the code to the Nano Matter, verify it is decommissioned from any other service previously used. For this, open the Serial Monitor and reset the board by clicking on the reset button
623
+
After uploading the code to the Nano Matter, verify it is decommissioned from any other service previously used. For this, open the Serial Monitor and reset the board by clicking on the reset button.
624
624
625
625
If it is not decommissioned you will see temperature readings printed in the Serial Monitor. To decommission it, follow these steps:
626
626
627
627
- Press the user button for **10 seconds** until the board's built-in LED starts **blinking in red**. You will also see a message confirming the process in the Serial Monitor.
628
628
629
-
- Finally, reset the board by clicking on the reset button and you should see the Matter commissioning credentials in the Serial Monitor.
629
+
- Finally, reset the board by clicking on the reset button and you should see the Matter commissioning credentials in the Serial Monitor.
630
630
631
631
### Device Commissioning
632
632
@@ -687,7 +687,7 @@ For this, navigate to **API Keys** in the upper left corner drop-down menu and c
687
687
688
688

689
689
690
-
You should get a **Client ID** and a **Client Secret**. Save these credentials in a safe place, you will not be able to see them again.
690
+
You should get a **Client ID** and a **Client Secret**. Save these credentials in a safe place, you will not be able to see them again.
691
691
692
692
### Home Assistant Set-Up
693
693
@@ -750,7 +750,7 @@ For the changes to take effect, navigate to **Developers Tools** and click on **
750
750
751
751

752
752
753
-
Finally, let's set up the automation that will call the **send_temperature** service every time the temperature sensor values change.
753
+
Finally, let's set up the automation that will call the **send_temperature** service every time the temperature sensor values change.
754
754
755
755
For this, navigate to **Settings > Automations & scenes** and click on **Create Automation**.
756
756
@@ -1148,7 +1148,7 @@ The Nano Matter includes an onboard **push button** that can be used as an input
The button pulls the input to ground when pressed, so is important to define the **pull-up resistor** to avoid undesired behavior by leaving the input floating.
1151
+
The button pulls the input to the ground when pressed, so is important to define the **pull-up resistor** to avoid undesired behavior by leaving the input floating.
1152
1152
1153
1153
Here you can find a complete example code to blink the built-in RGB LED of the Nano Matter:
1154
1154
@@ -1439,7 +1439,7 @@ The Nano Matter has **19 analog input pins**, mapped as follows:
1439
1439
1440
1440
***Digital I/O's can also be used as analog inputs with the exception of `D10`,`D9` and `D2`.***
1441
1441
1442
-
Analog input pins can be used through the built-in functions of the Arduino programming language.
1442
+
Analog input pins can be used through the built-in functions of the Arduino programming language.
1443
1443
1444
1444
Nano Matter ADC resolution is fixed to 12 bits and cannot be changed by the user.
0 commit comments