Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tweedegolf/nrf9160-rust-starter
Run rust on the nrf9160, with the SPM already included
https://github.com/tweedegolf/nrf9160-rust-starter
Last synced: about 1 month ago
JSON representation
Run rust on the nrf9160, with the SPM already included
- Host: GitHub
- URL: https://github.com/tweedegolf/nrf9160-rust-starter
- Owner: tweedegolf
- License: apache-2.0
- Created: 2022-02-17T09:46:45.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-01-21T15:29:19.000Z (almost 2 years ago)
- Last Synced: 2024-04-14T05:27:09.070Z (9 months ago)
- Language: Rust
- Size: 72.3 KB
- Stars: 7
- Watchers: 5
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# `nrf9160-rust-starter`
The [app-template]() for the nrf9160, with the SPM already included.
`app-template` is part of the [Knurling] project, [Ferrous Systems]' effort at
improving tooling used to develop for embedded systems.
## Notes
- disables `flip-link` (need to figure out how to make that work)
- includes a pre-compiled `zephyr.bin` with some linker tricks
## Pre-Reqs
- Install [Rustup]
- Add the target with the command below
``` console
$ rustup target add thumbv8m.main-none-eabihf
```
- install [probe-run]. On Linux, you might have to install libudev and libusb
from your package manager before installing `probe-run`
```console
$ cargo install probe-run
```
probe-run is built on the [probe-rs] library and supports `CMSIS-DAP`, `ST-Link`,
and `Segger J-Link` out of the box. `J-Link` is recommended for this repo. For
Linux, [udev rules] can be added for user access without root privileges.
## Running a Binary
- run example `hello.rs` as a debug build
```console
$ cargo run --example hello
```
- or run with [alias commands](.cargo/config.toml) defined in .cargo/config.toml
```console
$ cargo rex hello
```
- run example as a release build (production build)
```console
$ cargo rrex hello
```
- run main.rs file
```console
$ cargo run
```
```console
$ cargo run --release
```
## License
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.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
licensed as above, without any additional terms or conditions.
[Knurling]: https://knurling.ferrous-systems.com/
[Ferrous Systems]: https://ferrous-systems.com/
[rust trainings]: https://ferrous-systems.com/training/
[Rustup]: https://www.rust-lang.org/learn/get-started
[probe-run]: https://crates.io/crates/probe-run
[probe-rs]: https://probe.rs/
[udev rules]: https://probe.rs/docs/getting-started/probe-setup/