Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jim-hodapp-coaching/edge-rs
A Rust implementation of the Edge IoT sensor framework for Raspberry Pi Pico.
https://github.com/jim-hodapp-coaching/edge-rs
iot-platform rust-lang sensor-data
Last synced: about 9 hours ago
JSON representation
A Rust implementation of the Edge IoT sensor framework for Raspberry Pi Pico.
- Host: GitHub
- URL: https://github.com/jim-hodapp-coaching/edge-rs
- Owner: Jim-Hodapp-Coaching
- Created: 2022-01-17T03:05:15.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-05-05T00:45:36.000Z (over 1 year ago)
- Last Synced: 2024-10-30T22:29:05.463Z (8 days ago)
- Topics: iot-platform, rust-lang, sensor-data
- Language: Rust
- Homepage:
- Size: 29.3 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# A Rust-based implementation of Edge-rs for the Raspberry Pi Pico
## Getting started
For more details see the following article on getting started for getting your environment set up
on Mac/Linux:
https://reltech.substack.com/p/getting-started-with-rust-on-a-raspberry
On a Mac, to run minicom: `minicom -D /dev/tty.usbmodem14201 -b 115200`. Note that you'll most likely
need to find the current /dev link assigned to the Pico UART for your particular machine.
## Requirements
- The standard Rust tooling (cargo, rustup) which you can install from https://rustup.rs/
- Toolchain support for the cortex-m0+ processors in the rp2040 (thumbv6m-none-eabi)
- flip-link - this allows you to detect stack-overflows on the first core, which is the only supported target for now.
## Installation of development dependencies
```
rustup target install thumbv6m-none-eabi
cargo install flip-link
cargo install cargo-edit
cargo add panic_halt
```
## Set Up Git Hooks
The ambi_mock_client repository makes use of several Git hooks to ensure that code quality standards are met and consistent. To automatically configure these hooks for your local workspace, you can run the following:
```bash
./scripts/create-git-hooks
```
This will create symlinks to the Git hooks, preserving any hooks that you may have already configured.
## Running
For a debug build
```
cargo run
```
For a release build
```
cargo run --release
```
## Debugging
To debug you can use either `cargo run` which will try and launch a gdb session connecting to a local OpenOCD instance
at localhost:3333, or you can use VSCode and the [cortex-debug extension for VSCode](https://marcelball.ca/projects/cortex-debug/) to connect to the same OpenOCD instance.
For more information on getting set up to use OpenOCD with gdb for flashing and debugging your Pico target device, [see this getting started guide](https://reltech.substack.com/p/getting-started-with-rust-on-a-raspberry).
## License
This project is licensed under either of
- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or
http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.