https://github.com/sunsided/serial-sensors

Getting that data off your microcontrollers
https://github.com/sunsided/serial-sensors

csv data-export embedded rust sensor-fusion serial-port stm32f3discovery tui uart usb-cdc

Last synced: 3 months ago
JSON representation

Getting that data off your microcontrollers

• Host: GitHub
• URL: https://github.com/sunsided/serial-sensors
• Owner: sunsided
• License: eupl-1.2
• Created: 2024-07-02T10:34:15.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-06T07:39:12.000Z (6 months ago)
• Last Synced: 2025-02-08T02:23:02.538Z (5 months ago)
• Topics: csv, data-export, embedded, rust, sensor-fusion, serial-port, stm32f3discovery, tui, uart, usb-cdc
• Language: Rust
• Homepage:
• Size: 1.08 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Serial Sensors

A simple utility program to fetch data off my microcontrollers over a serial connection.

Its primary goal is to provide a host-side implementation of a semi-standardized

protocol for reading sensor data, such as IMU data (accelerometer, magnetometer, gyroscope),

temperature, etc.

I'm currently using it for these projects:

* [`stm32f3disco-rust`](https://github.com/sunsided/stm32f3disco-rust)

  via [`serial-sensors-proto`](https://github.com/sunsided/serial-sensors-proto).

At the moment it doesn't do much: it simply dumps out the information as it comes.

![A screenshot of the application in action](readme/picture.jpg)

## Logging data streams to disk

By using the `dump` subcommand and the `--dir /path/to/log` arguments, data streams can be logged

as CSV. The command creates one file per sensor and information type. The CSV will contain

both the device-side and host-side timestamps to allow for better inference of sensor data rates

later on.

By using the optional `--raw /path/to/file.bin` argument, the raw data stream can be logged.

```shell

cargo run -- dump --port /dev/ttyACM0 --raw stream.raw --dir dump/

```

## Analyzing data dumps

To analyze data dumps, use the `analyze-dump` command. To run it with the test data, use e.g.

```shell

cargo run --no-default-features --features=analyze -- analyze-dump \

  --dir test/2024-07-06/stm32f3discovery \

  --output test/2024-07-06/stm32f3discovery/output/ \

  --from 10 --to 25

```

Here is an example output for accelerometer measurements:

![](readme/accelerometer.jpg)

Sensor cross-correlation suffers a bit from display issues, but it's a starting point:

![](readme/cross-correlation.jpg)