55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
[](https://crates.io/crates/cfdp-rs)
|
|
[](https://docs.rs/cfdp-rs)
|
|
[](https://github.com/us-irs/cfdp-rs/actions/workflows/ci.yml)
|
|
[](https://absatsw.irs.uni-stuttgart.de/projects/cfdp/coverage-rs/latest/index.html)
|
|
|
|
cfdp-rs - High level Rust crate for CFDP components
|
|
======================
|
|
|
|
The `cfdp-rs` Rust crate offers some high-level CCSDS File Delivery Protocol (CFDP) components to
|
|
perform file transfers according to the [CCSDS Blue Book 727.0-B-5](https://public.ccsds.org/Pubs/727x0b5.pdf).
|
|
The underlying base packet library used to generate the packets to be sent is the
|
|
[spacepackets](https://egit.irs.uni-stuttgart.de/rust/spacepackets) library.
|
|
|
|
# Features
|
|
|
|
The goal of this library is to be flexible enough to support the use-cases of both on-board
|
|
software and of ground software. It has support to make integration on [std] systems as simple
|
|
as possible, but also has sufficient abstraction to allow for integration on`no_std` environments.
|
|
Currently, the handlers still require the [std] feature until
|
|
[thiserror supports `error_in_core`](https://github.com/dtolnay/thiserror/pull/304).
|
|
|
|
It is recommended to activate the `alloc` feature at the very least to allow using the primary
|
|
components provided by this crate. These components will only allocate memory at initialization
|
|
time and thus are still viable for systems where run-time allocation is prohibited.
|
|
|
|
## Default features
|
|
|
|
- [`std`](https://doc.rust-lang.org/std/): Enables functionality relying on the standard library.
|
|
- [`alloc`](https://doc.rust-lang.org/alloc/): Enables features which require allocation support.
|
|
Enabled by the `std` feature.
|
|
|
|
## Optional Features
|
|
|
|
- [`serde`](https://serde.rs/): Adds `serde` support for most types by adding `Serialize` and `Deserialize` `derive`s
|
|
- [`defmt`](https://defmt.ferrous-systems.com/): Add support for the `defmt` by adding the
|
|
[`defmt::Format`](https://defmt.ferrous-systems.com/format) derive on many types.
|
|
|
|
# Examples
|
|
|
|
You can check the [documentation](https://docs.rs/cfdp-rs) of individual modules for various usage
|
|
examples.
|
|
|
|
# Coverage
|
|
|
|
Coverage was generated using [`grcov`](https://github.com/mozilla/grcov). If you have not done so
|
|
already, install the `llvm-tools-preview`:
|
|
|
|
```sh
|
|
rustup component add llvm-tools-preview
|
|
cargo install grcov --locked
|
|
```
|
|
|
|
After that, you can simply run `coverage.py` to test the project with coverage. You can optionally
|
|
supply the `--open` flag to open the coverage report in your webbrowser.
|