Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chef sample app #16731

Merged
Show file tree
Hide file tree
Changes from 9 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions examples/chef/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
zap-generated
project_include.cmake
linux/args.gni
linux/sample.gni
38 changes: 38 additions & 0 deletions examples/chef/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
# MATTER CHEF APP

The purpose of the chef app is to to increase the coverage of device types in
Matter.

It uses the shell app a starting point, adding the processing of ZAP files and
the support of a few targets under a unified build script: `chef.py`.

As it incorporates the processing of ZAP files as part of the build process, it
does not use `zzz_generated`, but rather places the auto-generated zap artifacts
under its `zap-generated` temporary folder.

All device types available (DM/IM .zap files) are found inside the `devices`
folder.

## Building a Sample Application

Run `chef.sh -h` to see the available commands

## Building your first sample

1. Make sure you have the toolchain installed for your desired target
2. Update your SoC SDK paths on `chef_config.sh` and flip the `configured`
andy31415 marked this conversation as resolved.
Show resolved Hide resolved
variable to True
3. Run `$ chef.sh -u` to update zap and the toolchain (on selected platforms)
4. Run `$ chef.sh -gzbf -t <platform> -d lighting`. This command will run the
ZAP GUI opening the `devices/lighting.zap` file and will allow editing. It
will then generate the zap artifacts, place them on the `zap-generated`
folder, run a build and flash the binary in your target

## Creating a new device type in your device library

1. Run `$ chef.sh -g -d <device>` to open in the ZAP GUI a device to be used as
a starting point.
2. Edit your cluster configurations
3. Click on `Save As` and save the file with the name of your new device type
into the `devices` folder. This device is now available for the script. See
`chef.sh -h` for a list of devices available.
1 change: 1 addition & 0 deletions examples/chef/README_DEVICE.md
1 change: 1 addition & 0 deletions examples/chef/README_OTCLI.md
1 change: 1 addition & 0 deletions examples/chef/README_SHELL.md
Loading