Generates Rust messages from a dbc
file.
Install published version using cargo:
cargo install dbc-codegen-cli
Install latest version from the git repository:
cargo install dbc-codegen-cli --git https://github.com/technocreatives/dbc-codegen --branch main
Generate messages.rs
from example.dbc
using the CLI:
dbc-codegen testing/dbc-examples/example.dbc dir/where/messages_rs/file/is/written
Or put something like this into your build.rs
file:
fn main() {
let dbc_path = "../dbc-examples/example.dbc";
let dbc_file = std::fs::read(dbc_path).unwrap();
println!("cargo:rerun-if-changed={}", dbc_path);
let config = Config::builder()
.dbc_name("example.dbc")
.dbc_content(&dbc_file)
//.impl_arbitrary(FeatureConfig::Gated("arbitrary")) // Optional impls.
//.impl_debug(FeatureConfig::Always) // See rustdoc for more,
//.check_ranges(FeatureConfig::Never) // or look below for an example.
.build();
let mut out = std::io::BufWriter::new(std::fs::File::create("src/messages.rs").unwrap());
dbc_codegen::codegen(config, &mut out).expect("dbc-codegen failed");
}
dbc-codegen generates a Rust file that is expected to be in a cargo project.
Here is an example testing/can-messages/Cargo.toml
which defines dependencies and features that are used in generated message file.
To use the code, add mod messages
to your lib.rs
(or main.rs
).
You will most likely want to interact with the generated Messages
enum, and call Messages::from_can_message(id, &payload)
.
Note: The generated code contains a lot of documentation. Give it a try:
cargo doc --open
The generator config has the following flags that control what code gets generated:
impl_debug
: enables#[derive(Debug)]
for messages.impl_arbitrary
: enables implementation of [Arbitrary
] trait. Also requires you to addarbitrary
crate (version 1.x) as a dependency of the crate. [Arbitrary
]: https://docs.rs/arbitrary/1.0.0/arbitrary/trait.Arbitrary.htmlimpl_error
: Implementsstd::error::Error
forCanError
. This makes it easy to use crates likeanyhow
for error handling.check_ranges
: adds range checks in signal setters. (Enabled by default)
These implementations can be enabled, disabled, or placed behind feature guards, like so:
Config::builder()
// this will generate Debug implementations
.impl_debug(FeatureConfig::Always)
// this will generate Error implementations behind `#[cfg(feature = "std")]` guards
.impl_error(FeatureConfig::Gated("std"))
// this will disable range checks
.check_ranges(FeatureConfig::Never)
The generated code is no_std compatible, unless you enable impl_error
.
If some field name starts with a non-alphabetic character or is a Rust keyword then it is prefixed with x
.
For example:
VAL_ 512 Five 0 "0Off" 1 "1On" 2 "2Oner" 3 "3Onest";
…is generated as:
pub enum BarFive {
X0off,
X1on,
X2oner,
X3onest,
_Other(bool),
}
Type
here:
SG_ Type : 30|1@0+ (1,0) [0|1] "boolean" Dolor
…conflicts with the Rust keyword type
. Therefore we prefix it with x
:
pub fn xtype(&self) -> BarType {
match self.xtype_raw() {
false => BarType::X0off,
true => BarType::X1on,
x => BarType::_Other(x),
}
}
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
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 dual licensed as above, without any additional terms or conditions.