29 releases (4 breaking)
0.5.5 | Mar 5, 2023 |
---|---|
0.5.2 | Feb 28, 2023 |
0.1.3 | Dec 23, 2022 |
#151 in Hardware support
122 downloads per month
Used in 5 crates
2.5MB
63K
SLoC
Veryl is a modern hardware description language.
This project is under the exploration phase of language design. If you have any idea, please open Issue.
Documentation quick links
Concepts
Veryl is designed as a "SystemVerilog Alternative". There are some design concepts.
- Symplified syntax
- Based on SystemVerilog / Rust
- Removed traditional Verilog syntax
- Transpiler to SystemVerilog
- Human readable SystemVerilog code generation
- Interoperability with SystemVerilog
- Integrated tools
- Formatter / Linter
- VSCode, vim/neovim integration
- Package management based on git
Example
// module definition
module ModuleA #(
parameter ParamA: u32 = 10,
localparam ParamB: u32 = 10, // trailing comma is allowed
) (
i_clk : input logic,
i_rst : input logic,
i_sel : input logic,
i_data: input logic<ParamA> [2], // `[]` means unpacked array in SystemVerilog
o_data: output logic<ParamA> , // `<>` means packed array in SystemVerilog
) {
// localparam declaration
// `parameter` is not allowed in module
localparam ParamC: u32 = 10;
// variable declaration
var r_data0: logic<ParamA>;
var r_data1: logic<ParamA>;
// always_ff statement with reset
// `always_ff` can take a mandatory clock and a optional reset
// `if_reset` means `if (i_rst)`. This conceals reset porality
// `()` of `if` is not required
// `=` in `always_ff` is non-blocking assignment
always_ff (i_clk, i_rst) {
if_reset {
r_data0 = 0;
} else if i_sel {
r_data0 = i_data[0];
} else {
r_data0 = i_data[1];
}
}
// always_ff statement without reset
always_ff (i_clk) {
r_data1 = r_data0;
}
assign o_data = r_data1;
}
Installation
See Document.
Usage
// Create a new project
veryl new [project name]
// Create a new project in an existing directory
veryl init [path]
// Format the current project
veryl fmt
// Analyze the current project
veryl check
// Build target codes corresponding to the current project
veryl build
For detailed information, see Document.
License
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.
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 dual licensed as above, without any additional terms or conditions.
Dependencies
~11–49MB
~886K SLoC