Matter

Matter protocol implemented in pure Crystal Lang.

Installation

1. Add the dependency to your shard.yml:

   dependencies:
     matter:
       github: Crystal-Matter/matter

2. Run shards install

Examples

An example OnOff device is provided in the ./examples directory.

• Build using: crystal build examples/matter_switch_device.cr -o bin/matter_switch
• Validate with chip-tool
  • Launch bin/matter_switch, grab the chip-tool command line in the output
  • Clear any previous sessions: chip-tool storage clear-all
  • Commission using chip-tool

Confirmed working with iOS.

Example projects

These projects show off how custom matter interfaces can be built for almost any device.

• Control a Home Connect oven using siri
• Control a rangehood
• Control a Windows media center PC, plugged into your TV, from your phone

End to end tests

We've used industry tooling for validation, using the official chip-tool

./examples/run_validation.sh

We have our own implementation of chip-tool for running end-to-end tests too (used in the CI) Aiming to be compatible with the official tool

crystal build ./examples/chip-tool.cr -o ./bin/chip-tool --error-trace
./examples/run_validation.sh --chip-tool ./bin/chip-tool

Contributing

1. Fork it (https://github.com/Crystal-Matter/matter/fork)
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

Contributors

• Stephen von Takach - creator and maintainer