Skip to content

Commit 96a45d8

Browse files
committed
Alpha release
0 parents  commit 96a45d8

File tree

719 files changed

+393578
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

719 files changed

+393578
-0
lines changed

.gitignore

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
## Ignore Work directory
2+
Work/

.gitmodules

+4
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
[submodule "Components/ThirdParty/Matter/repo"]
2+
path = Components/ThirdParty/Matter/repo
3+
url = https://github.com/Qorvo/connectedhomeip
4+
branch = v0.9.7.1

Applications/Matter/light/Makefile.light_qpg6105

+846
Large diffs are not rendered by default.

Applications/Matter/light/README.md

+124
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
# Matter QPG6105 lighting example application
2+
3+
Qorvo's QPG6105 Matter lighting example shows how to create a remotely controlled dimmable color light bulb, with Thread
4+
connectivity, using Matter. It is using Bluetooth LE to perform Matter provisioning. This example can be used as reference for
5+
creating your own Matter light bulb.
6+
7+
Buttons are used as input to trigger device state changes, LEDs are used as output to visualize the device states.
8+
9+
Features of this application are:
10+
- Remote lighting control (dimming, color, on/off) using a Matter controller (Instuctions to use a Matter controller can
11+
be found [here](../../../Documents/Guides/)).
12+
- Bluetooth LE for Matter commissioning procedure.
13+
- CLI console for [OpenThread commands](https://github.com/openthread/openthread/blob/9ea34d1e2053b6b2a80e1d46b65a6aee99fc504a/src/cli/README.md).
14+
- Factory reset implementation based on number of reset cycles.
15+
16+
17+
---
18+
19+
- [Matter QPG6105 lighting example application](#matter-qpg6105-lighting-example-application)
20+
- [Commissioning](#commissioning)
21+
- [Button control](#button-control)
22+
- [LED output](#led-output)
23+
- [Factory reset](#factory-reset)
24+
- [Logging output](#logging-output)
25+
- [OpenThread CLI](#openthread-cli)
26+
- [Building and flashing](#building-and-flashing)
27+
- [Testing the example](#testing-the-example)
28+
- [Android chip-tool](#android-chip-tool)
29+
- [POSIX CLI chip-tool](#posix-cli-chip-tool)
30+
31+
---
32+
33+
## Commissioning
34+
35+
The Matter light will start Bluetooth LE advertising automatically at start-up so it is discoverable for a Matter
36+
controller to start the Matter commissioning.
37+
38+
The commissioning procedure is done over Bluetooth LE where a connection is setup between a Matter device and a Matter
39+
controller. This Matter controller takes the role of a commissioner.
40+
The commissioner needs to get information from the Matter device to start the commissioning. This information can be
41+
obtained by a QR code or from the serial output of the Matter device. More information how this is done, can be found in
42+
the guides that explain the [Android chip-tool](../../../Documents/Guides/commissioning_android_chiptool.md) or the
43+
[POSIX CLI chip-tool](../../../Documents/Guides/commissioning_posix_cli_chiptool.md) as commissioners.
44+
45+
The final phase in the commissioning procedure is Thread provisioning. This involves sending the Thread network
46+
credentials over Bluetooth LE to the Matter device. Once this is done, the device joins the Thread network and
47+
communication with other Thread devices in the network can be achieved.
48+
49+
## Button control
50+
51+
This application uses following buttons of the DK board:
52+
53+
- `SW2`: Used to toggle the light between two levels
54+
- `SW6`: Used to perform a HW reset for the full board. If the reset is triggered 10 times in a row, factory reset will
55+
be triggered.
56+
- `SW4`: Used to toggle the off/on state of the simulated light
57+
- `SW5`: Used to perform, depending on the time the button is kept pressed,
58+
- Software update - not yet supported (released before 3s)
59+
- Trigger Thread joining (release after 3s)
60+
- Factory reset (released after 6s)
61+
62+
The buttons `SW1`, `SW3` and the slider switch `SW7` are unused.
63+
64+
## LED output
65+
66+
The following LEDs are used during the application:
67+
68+
- `LD3` - RGB led:
69+
- Off: Light is off
70+
- Dim: Light is set to low level
71+
- Bright: Light is set to high level
72+
- `LD4` - RED led - shows the device state and its connectivity. Following states are defined:
73+
- Short blink every 1s: Bluetooth LE advertising. The device is not commissioned yet.
74+
- Fast blinks: Bluetooth LE connected and subscribed but not yet commissioned.
75+
- Short off: Thread connected
76+
- On: Full service connectivity
77+
78+
## Factory reset
79+
80+
Factory reset of the Matter light can be triggered by pressing the reset (`SW6`) exactly 10 times in a row or by holding
81+
`SW5` at least 6 seconds. If the factory reset is triggered by the reset sequence, the light will blink one second ON and
82+
one second OFF, two times.
83+
84+
## Logging output
85+
86+
For instructions to view the serial logging, refer to [Matter light and lock](../../../README.md#matter-light-and-lock).
87+
88+
At startup you will see:
89+
90+
```
91+
qvCHIP <version> ROM<vx> (CL:xxxxxx) r:x
92+
[P][-] Init CHIP Stack
93+
[P][DL] BLEManagerImpl::Init() complete
94+
[P][-] Initializing OpenThread stack
95+
[P][DL] OpenThread ifconfig up and thread start
96+
[P][DL] OpenThread started: OK
97+
[P][DL] Setting OpenThread device type to MINIMAL END DEVICE
98+
[P][-] Starting OpenThread task
99+
[P][-] Starting Platform Manager Event Loop
100+
[P][-] ============================
101+
[P][-] Qorvo <application>-app Launching
102+
[P][-] ============================
103+
```
104+
105+
## OpenThread CLI
106+
107+
Using the serial connection with the Matter device you can access the OpenThread CLI. Type `help` to find the available
108+
commands.
109+
110+
## Building and flashing
111+
112+
See [Compilation and Programming](../../../README.md#compilation-and-programming) section to get instructions how to
113+
build and program the Matter light example application.
114+
115+
## Testing the example
116+
117+
### Android chip-tool
118+
119+
Please refer to [Commissioning Qorvo Matter device with Android chip-tool](../../../Documents/Guides/commissioning_android_chiptool.md)
120+
121+
### POSIX CLI chip-tool
122+
123+
Please refer to [Commissioning Qorvo Matter device with POSIX CLI chip-tool](../../../Documents/Guides/commissioning_posix_cli_chiptool.md)
124+

0 commit comments

Comments
 (0)