https://github.com/tsabelmann/gpscandump-rs

Application logging GPS and CAN data simultaneously.
https://github.com/tsabelmann/gpscandump-rs

can-bus csv gps logging synchronization

Last synced: about 17 hours ago
JSON representation

Application logging GPS and CAN data simultaneously.

• Host: GitHub
• URL: https://github.com/tsabelmann/gpscandump-rs
• Owner: tsabelmann
• License: apache-2.0
• Created: 2022-02-10T13:18:45.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2022-02-22T11:00:57.000Z (over 2 years ago)
• Last Synced: 2024-10-31T11:55:50.893Z (20 days ago)
• Topics: can-bus, csv, gps, logging, synchronization
• Language: Rust
• Homepage: https://crates.io/crates/gpscandump
• Size: 32.2 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-APACHE

Awesome Lists containing this project

README

        
# gpscandump

[![Crates.io](https://img.shields.io/crates/v/gpscandump)](https://crates.io/crates/gpscandump)![Crates.io](https://img.shields.io/crates/l/gpscandump)![Crates.io](https://img.shields.io/crates/d/gpscandump)

This is a logging tool that receives GPS-data from a serial port and CAN-bus data from CAN-interface supported by the Linux kernel. The idea behind this tool was that the underlying logging device does not always have access to the current time. Consequently, the timestamps are only correct relatively to one and another. To mitigate this problem, the timestamps are synchronized by using GPS-data. The resulting log contains the following columns:

- Timestamp in [RFC-3339](https://datatracker.ietf.org/doc/html/rfc3339) formatting

- Unix-Timestamp

- CAN-bus interface

- DLC (number of received data bytes)

- CAN-bus data

- Longitude

- Latitude

- Altitude (elevation) in meter

- Speed over ground in m/s

Currently, `gpscandump` only supports CAN-interfaces the Linux kernel can use, as well as a specific [GPS-dongle](https://www.globalsat.com.tw/en/product-199952/Cable-GPS-with-USB-interface-SiRF-Star-IV-BU-353S4.html).

## Installation

```bash

cargo install gpscandump

```

## Usage

```bash

gpscandump - logs GPS and CAN-bus data 

USAGE:

    gpscandump [OPTIONS]

OPTIONS:

    -h, --help                         Print help information

    -i, --interface         The CAN-interface [default: vcan0]

    -o, --output               File where one saves the results [default: log.csv]

    -s, --serial-port     The serial-port to use [default: /dev/ttyUSB0]

```

## License / Terms of Usage

The source code of this project is licensed under the MIT license. This implies that you are free to use, share, and adapt it. However, please give appropriate credit by citing the project.

## Contact

If you have problems using the software, find mistakes, or have general questions please use the [issue tracker](https://github.com/tsabelmann/gpscandump-rs/issues) to contact us.

## Contributors

- [Tim Lucas Sabelmann](https://github.com/tsabelmann)