Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/project-chip/matter-rs
Rust implementation of the Matter protocol. Status: Experimental
https://github.com/project-chip/matter-rs
Last synced: about 2 months ago
JSON representation
Rust implementation of the Matter protocol. Status: Experimental
- Host: GitHub
- URL: https://github.com/project-chip/matter-rs
- Owner: project-chip
- License: apache-2.0
- Created: 2022-12-12T16:43:43.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-29T07:24:35.000Z (4 months ago)
- Last Synced: 2024-05-30T18:05:00.654Z (4 months ago)
- Language: Rust
- Size: 1.13 MB
- Stars: 278
- Watchers: 37
- Forks: 43
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# rs-matter: The Rust Implementation of Matter
![experimental](https://img.shields.io/badge/status-Experimental-red)
[![license](https://img.shields.io/badge/license-Apache2-green.svg)](https://raw.githubusercontent.com/project-chip/matter-rs/main/LICENSE)
[![CI](https://github.com/project-chip/matter-rs/actions/workflows/ci.yml/badge.svg)](https://github.com/project-chip/matter-rs/actions/workflows/ci.yml)
[![CI - TLV](https://github.com/project-chip/matter-rs/actions/workflows/ci-tlv-tool.yml/badge.svg)](https://github.com/project-chip/matter-rs/actions/workflows/ci-tlv-tool.yml)
[![crates.io](https://img.shields.io/crates/v/rs-matter.svg)](https://crates.io/crates/rs-matter)
[![Matrix](https://img.shields.io/matrix/matter-rs:matrix.org?label=join%20matrix&color=BEC5C9&logo=matrix)](https://matrix.to/#/#matter-rs:matrix.org)## Build
### Building the library
```
$ cargo build
```### Building and running the example (Linux, MacOS X)
```
$ cargo run --example onoff_light --features async-io
```## Test
With the [`chip-tool` (the current tool for testing Matter)](https://github.com/project-chip/connectedhomeip/blob/master/examples/chip-tool/README.md) use the Ethernet commissioning mechanism:
```
$ chip-tool pairing code 12344321
```Or alternatively:
```
$ chip-tool pairing ethernet 12344321 123456 0 5540
```Interact with the device
```
# Read server-list
$ chip-tool descriptor read server-list 12344321 0# Read On/Off status
$ chip-tool onoff read on-off 12344321 1# Toggle On/Off by invoking the command
$ chip-tool onoff on 12344321 1
```## Functionality
- Secure Channel:
- PASE
- CASE
- Interactions:
- Invoke Command(s), Read Attribute(s), Write Attribute(s)
- Commissioning:
- over Ethernet
- Network Commissioning Cluster
- General Commissioning Cluster
- Operational Certificates Cluster
- Some [TODO](TODO.md) are captured here## Notes
The matter-rs project is a work-in-progress and does NOT yet fully implement Matter.