forked from project-chip/connectedhomeip
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[Telink] Add Temperature Measurement app demo (project-chip#25366)
* [Telink] Temperature Measurement App demo added (simulated data) * [Telink] Temperature Measurement App demo GitHub CI modified * [Telink] move zap & matter files into common folder * [Telink] Cleanup & fix identify cluster * [Telink] Remove identify functionality * [Telink] Set correct app name for CI build * [Telink] Fix code style --------- Co-authored-by: Dmytro Huz <diman1436@gmail.com>
- Loading branch information
1 parent
69b4c15
commit b810c2e
Showing
22 changed files
with
1,280 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
/build/ |
66 changes: 66 additions & 0 deletions
66
examples/temperature-measurement-app/telink/CMakeLists.txt
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,66 @@ | ||
# | ||
# Copyright (c) 2023 Project CHIP Authors | ||
# | ||
# Licensed under the Apache License, Version 2.0 (the "License"); | ||
# you may not use this file except in compliance with the License. | ||
# You may obtain a copy of the License at | ||
# | ||
# http://www.apache.org/licenses/LICENSE-2.0 | ||
# | ||
# Unless required by applicable law or agreed to in writing, software | ||
# distributed under the License is distributed on an "AS IS" BASIS, | ||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
# See the License for the specific language governing permissions and | ||
# limitations under the License. | ||
# | ||
cmake_minimum_required(VERSION 3.13.1) | ||
|
||
set(BOARD tlsr9518adk80d) | ||
|
||
get_filename_component(CHIP_ROOT ${CMAKE_CURRENT_SOURCE_DIR}/third_party/connectedhomeip REALPATH) | ||
get_filename_component(TELINK_COMMON ${CHIP_ROOT}/examples/platform/telink REALPATH) | ||
get_filename_component(GEN_DIR ${CHIP_ROOT}/zzz_generated/ REALPATH) | ||
|
||
set(CONF_FILE ${CHIP_ROOT}/config/telink/app/zephyr.conf prj.conf) | ||
|
||
# Load NCS/Zephyr build system | ||
list(APPEND ZEPHYR_EXTRA_MODULES ${CHIP_ROOT}/config/telink/chip-module) | ||
find_package(Zephyr HINTS $ENV{ZEPHYR_BASE}) | ||
|
||
project(chip-telink-temperature-measurement-example) | ||
|
||
include(${CHIP_ROOT}/config/telink/app/enable-gnu-std.cmake) | ||
include(${CHIP_ROOT}/src/app/chip_data_model.cmake) | ||
|
||
target_compile_options(app PRIVATE -fpermissive) | ||
|
||
target_include_directories(app PRIVATE | ||
include | ||
${GEN_DIR}/app-common | ||
${GEN_DIR}/temperature-measurement-app | ||
${TELINK_COMMON}/util/include | ||
${TELINK_COMMON}/app/include | ||
) | ||
|
||
add_definitions( | ||
"-DCHIP_ADDRESS_RESOLVE_IMPL_INCLUDE_HEADER=<lib/address_resolve/AddressResolve_DefaultImpl.h>" | ||
) | ||
|
||
target_sources(app PRIVATE | ||
src/AppTask.cpp | ||
src/SensorManager.cpp | ||
src/main.cpp | ||
${TELINK_COMMON}/util/src/LEDWidget.cpp | ||
${TELINK_COMMON}/util/src/ButtonManager.cpp | ||
${TELINK_COMMON}/util/src/ThreadUtil.cpp | ||
${TELINK_COMMON}/util/src/PWMDevice.cpp | ||
) | ||
|
||
chip_configure_data_model(app | ||
INCLUDE_SERVER | ||
ZAP_FILE ${CMAKE_CURRENT_SOURCE_DIR}/../temperature-measurement-common/temperature-measurement.zap | ||
) | ||
|
||
if(CONFIG_CHIP_OTA_REQUESTOR) | ||
target_sources(app PRIVATE ${TELINK_COMMON}/util/src/OTAUtil.cpp) | ||
endif() |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,163 @@ | ||
# Matter Telink Temperature Measurement Example Application | ||
|
||
The Telink Temperature Measurement Example demonstrates getting simulated data | ||
from temperature sensor. In further releases the real sensor handling will be | ||
implemented along. It uses buttons to test changing the device states and LEDs | ||
to show the state of these changes. You can use this example as a reference for | ||
creating your own application. | ||
|
||
![Telink B91 EVK](http://wiki.telink-semi.cn/wiki/assets/Hardware/B91_Generic_Starter_Kit_Hardware_Guide/connection_chart.png) | ||
|
||
## Build and flash | ||
|
||
1. Pull docker image from repository: | ||
|
||
```bash | ||
$ docker pull connectedhomeip/chip-build-telink:latest | ||
``` | ||
|
||
1. Run docker container: | ||
|
||
```bash | ||
$ docker run -it --rm -v ${CHIP_BASE}:/root/chip -v /dev/bus/usb:/dev/bus/usb --device-cgroup-rule "c 189:* rmw" connectedhomeip/chip-build-telink:latest | ||
``` | ||
|
||
here `${CHIP_BASE}` is directory which contains CHIP repo files **!!!Pay | ||
attention that OUTPUT_DIR should contains ABSOLUTE path to output dir** | ||
|
||
1. Activate the build environment: | ||
|
||
```bash | ||
$ source ./scripts/activate.sh | ||
``` | ||
|
||
1. In the example dir run: | ||
|
||
```bash | ||
$ west build | ||
``` | ||
|
||
1. Flash binary: | ||
|
||
``` | ||
$ west flash --erase | ||
``` | ||
|
||
## Usage | ||
|
||
### UART | ||
|
||
To get output from device, connect UART to following pins: | ||
|
||
| Name | Pin | | ||
| :--: | :---------------------------- | | ||
| RX | PB3 (pin 17 of J34 connector) | | ||
| TX | PB2 (pin 16 of J34 connector) | | ||
| GND | GND | | ||
|
||
### Buttons | ||
|
||
The following buttons are available on **tlsr9518adk80d** board: | ||
|
||
| Name | Function | Description | | ||
| :------- | :--------------------- | :----------------------------------------------------------------------------------------------------- | | ||
| Button 1 | Factory reset | Perform factory reset to forget currently commissioned Thread network and back to uncommissioned state | | ||
| Button 2 | NA | NA | | ||
| Button 3 | Thread start | Commission thread with static credentials and enables the Thread on device | | ||
| Button 4 | Open commission window | The button is opening commissioning window to perform commissioning over BLE | | ||
|
||
### LEDs | ||
|
||
#### Indicate current state of Thread network | ||
|
||
**Red** LED indicates current state of Thread network. It is able to be in | ||
following states: | ||
|
||
| State | Description | | ||
| :-------------------------- | :--------------------------------------------------------------------------- | | ||
| Blinks with short pulses | Device is not commissioned to Thread, Thread is disabled | | ||
| Blinks with frequent pulses | Device is commissioned, Thread enabled. Device trying to JOIN thread network | | ||
| Blinks with wide pulses | Device commissioned and joined to thread network as CHILD | | ||
|
||
### CHIP tool commands | ||
|
||
1. Build | ||
[chip-tool cli](https://github.com/project-chip/connectedhomeip/blob/master/examples/chip-tool/README.md) | ||
|
||
2. Pair with device | ||
|
||
``` | ||
${CHIP_TOOL_DIR}/chip-tool pairing ble-thread ${NODE_ID} hex:${DATASET} ${PIN_CODE} ${DISCRIMINATOR} | ||
``` | ||
|
||
Example: | ||
|
||
``` | ||
./chip-tool pairing ble-thread 1234 hex:0e080000000000010000000300000f35060004001fffe0020811111111222222220708fd61f77bd3df233e051000112233445566778899aabbccddeeff030e4f70656e54687265616444656d6f010212340410445f2b5ca6f2a93a55ce570a70efeecb0c0402a0fff8 20202021 3840 | ||
``` | ||
|
||
### OTA with Linux OTA Provider | ||
|
||
OTA feature enabled by default only for ota-requestor-app example. To enable OTA | ||
feature for another Telink example: | ||
|
||
- set CONFIG_CHIP_OTA_REQUESTOR=y in corresponding "prj.conf" configuration | ||
file. | ||
|
||
After build application with enabled OTA feature, use next binary files: | ||
|
||
- zephyr.bin - main binary to flash PCB (Use 2MB PCB). | ||
- zephyr-ota.bin - binary for OTA Provider | ||
|
||
All binaries has the same SW version. To test OTA “zephyr-ota.bin” should have | ||
higher SW version than base SW. Set CONFIG_CHIP_DEVICE_SOFTWARE_VERSION=2 in | ||
corresponding “prj.conf” configuration file. | ||
|
||
Usage of OTA: | ||
|
||
- Build the [Linux OTA Provider](../../ota-provider-app/linux) | ||
|
||
``` | ||
./scripts/examples/gn_build_example.sh examples/ota-provider-app/linux out/ota-provider-app chip_config_network_layer_ble=false | ||
``` | ||
|
||
- Run the Linux OTA Provider with OTA image. | ||
|
||
``` | ||
./chip-ota-provider-app -f zephyr-ota.bin | ||
``` | ||
|
||
- Provision the Linux OTA Provider using chip-tool | ||
|
||
``` | ||
./chip-tool pairing onnetwork ${OTA_PROVIDER_NODE_ID} 20202021 | ||
``` | ||
|
||
here: | ||
|
||
- \${OTA_PROVIDER_NODE_ID} is the node id of Linux OTA Provider | ||
|
||
- Configure the ACL of the ota-provider-app to allow access | ||
|
||
``` | ||
./chip-tool accesscontrol write acl '[{"fabricIndex": 1, "privilege": 5, "authMode": 2, "subjects": [112233], "targets": null}, {"fabricIndex": 1, "privilege": 3, "authMode": 2, "subjects": null, "targets": null}]' ${OTA_PROVIDER_NODE_ID} 0 | ||
``` | ||
|
||
here: | ||
|
||
- \${OTA_PROVIDER_NODE_ID} is the node id of Linux OTA Provider | ||
|
||
- Use the chip-tool to announce the ota-provider-app to start the OTA process | ||
|
||
``` | ||
./chip-tool otasoftwareupdaterequestor announce-ota-provider ${OTA_PROVIDER_NODE_ID} 0 0 0 ${DEVICE_NODE_ID} 0 | ||
``` | ||
|
||
here: | ||
|
||
- \${OTA_PROVIDER_NODE_ID} is the node id of Linux OTA Provider | ||
- \${DEVICE_NODE_ID} is the node id of paired device | ||
|
||
Once the transfer is complete, OTA requestor sends ApplyUpdateRequest command to | ||
OTA provider for applying the image. Device will restart on successful | ||
application of OTA image. |
33 changes: 33 additions & 0 deletions
33
examples/temperature-measurement-app/telink/include/AppConfig.h
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
/* | ||
* | ||
* Copyright (c) 2023 Project CHIP Authors | ||
* All rights reserved. | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
#pragma once | ||
|
||
// ---- Temperature measurement Example App Config ---- | ||
|
||
// Buttons config | ||
#define BUTTON_PORT DEVICE_DT_GET(DT_NODELABEL(gpioc)) | ||
|
||
#define BUTTON_PIN_1 2 | ||
#define BUTTON_PIN_3 3 | ||
#define BUTTON_PIN_4 1 | ||
#define BUTTON_PIN_2 0 | ||
|
||
// LEDs config | ||
#define LEDS_PORT DEVICE_DT_GET(DT_NODELABEL(gpiob)) | ||
#define SYSTEM_STATE_LED 7 |
57 changes: 57 additions & 0 deletions
57
examples/temperature-measurement-app/telink/include/AppEvent.h
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,57 @@ | ||
/* | ||
* | ||
* Copyright (c) 2023 Project CHIP Authors | ||
* All rights reserved. | ||
* | ||
* Licensed under the Apache License, Version 2.0 (the "License"); | ||
* you may not use this file except in compliance with the License. | ||
* You may obtain a copy of the License at | ||
* | ||
* http://www.apache.org/licenses/LICENSE-2.0 | ||
* | ||
* Unless required by applicable law or agreed to in writing, software | ||
* distributed under the License is distributed on an "AS IS" BASIS, | ||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | ||
* See the License for the specific language governing permissions and | ||
* limitations under the License. | ||
*/ | ||
|
||
#pragma once | ||
|
||
#include <cstdint> | ||
|
||
struct AppEvent; | ||
typedef void (*EventHandler)(AppEvent *); | ||
|
||
class LEDWidget; | ||
|
||
struct AppEvent | ||
{ | ||
enum AppEventTypes | ||
{ | ||
kEventType_Button = 0, | ||
kEventType_Timer, | ||
kEventType_UpdateLedState, | ||
kEventType_Install, | ||
}; | ||
|
||
uint16_t Type; | ||
|
||
union | ||
{ | ||
struct | ||
{ | ||
uint8_t Action; | ||
} ButtonEvent; | ||
struct | ||
{ | ||
void * Context; | ||
} TimerEvent; | ||
struct | ||
{ | ||
LEDWidget * LedWidget; | ||
} UpdateLedStateEvent; | ||
}; | ||
|
||
EventHandler Handler; | ||
}; |
Oops, something went wrong.