https://github.com/sunsided/serial-sensors-proto
A simple wire format for transmitting MEMS sensor data and friends
https://github.com/sunsided/serial-sensors-proto
embedded protocol rust sensors
Last synced: 3 months ago
JSON representation
A simple wire format for transmitting MEMS sensor data and friends
- Host: GitHub
- URL: https://github.com/sunsided/serial-sensors-proto
- Owner: sunsided
- License: eupl-1.2
- Created: 2024-07-02T18:39:10.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-07-08T16:38:33.000Z (11 months ago)
- Last Synced: 2025-01-29T08:33:55.945Z (4 months ago)
- Topics: embedded, protocol, rust, sensors
- Language: Rust
- Homepage: https://crates.io/crates/serial-sensors-proto
- Size: 213 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-EUPL
Awesome Lists containing this project
README
# serial-sensors-proto
> A simple wire format for transmitting MEMS sensor data and friends.
[![Crates.io][crates-image]][crates-link]
[![Docs][docs-image]][docs-link]
[![Build Status][build-image]][build-link]
[![Safety Dance][safety-image]][safety-link]
[![codecov][codecov-image]][codecov-link]
![MSRV][msrv-image]
[![EUPL 1.2 licensed][license-eupl-image]][license-eupl-link]
The approach is twofold:
- The protocol is a little bit extensible in sensor and data types and supports 1-, 3- and 4-dimensional readings.
- Data packets are serialized using [bincode](https://crates.io/crates/bincode) first, then byte-stuffed
using [corncobs](https://crates.io/crates/corncobs) (i.e. using Consistent Overhead Byte Stuffing, COBS).
On the receiving end, the entire process runs in reverse.
Apart from supporting some generic sensor types such as accelerometers, magnetometers, gyroscopes etc.,
the format has some capabilities for self-description. If implemented, the sensor maker and name, as well as linear
normalization factors can be sent over the wire once or periodically, allowing for automatic and sensor-agnostic
conversion on the host.
---
See [stm32f3disco-rust](https://github.com/sunsided/stm32f3disco-rust)
and [serial-sensors](https://github.com/sunsided/serial-sensors)
for an example. Here's an example screenshot from that project, showing sensor data as it streams in:
The device-side code can be as simple as this:
```rust
fn example() {
let value = AccelerometerI16::new(Vector3Data { x: 1, y: -2, z: 3 });
let frame = Version1DataFrame::new(u32::MAX, 12, 0, value);
// Serialize into a transmit buffer.
let mut buffer = [0_u8; 48];
let buffer = serialize(frame, &mut buffer).unwrap();
assert_eq!(buffer.len(), 21);
// ... send the buffer over the wire ...
// Deserialization the received buffer.
let data = deserialize(buffer).unwrap();
assert_eq!(data.version, Version1);
assert_eq!(data.data.global_sequence, u32::MAX);
assert_eq!(data.data.sensor_sequence, 12);
assert_eq!(data.data.sensor_tag, 0);
let data: AccelerometerI16 = data.try_into().unwrap();
assert_eq!(data.x, 1);
assert_eq!(data.y, -2);
assert_eq!(data.z, 3);
}
```
[crates-image]: https://img.shields.io/crates/v/serial-sensors-proto
[crates-link]: https://crates.io/crates/serial-sensors-proto
[docs-image]: https://docs.rs/serial-sensors-proto/badge.svg
[docs-link]: https://docs.rs/serial-sensors-proto/
[build-image]: https://github.com/sunsided/serial-sensors-proto/workflows/Rust/badge.svg
[build-link]: https://github.com/sunsided/serial-sensors-proto/actions
[safety-image]: https://img.shields.io/badge/unsafe-optional-success.svg
[safety-link]: https://github.com/rust-secure-code/safety-dance/
[msrv-image]: https://img.shields.io/badge/rustc-1.71+-blue.svg
[license-eupl-image]: https://img.shields.io/badge/license-EUPL_1.2-blue.svg
[license-eupl-link]: https://github.com/sunsided/serial-sensors-proto/blob/develop/LICENSE-EUPL
[embedded-hal]: https://docs.rs/embedded-hal/
[codecov-image]: https://codecov.io/gh/sunsided/serial-sensors-proto/graph/badge.svg?token=ysTw27B78y
[codecov-link]: https://codecov.io/gh/sunsided/serial-sensors-proto
[cc]: https://contributor-covenant.org