moore

Moore 是一个硬件描述语言编译器，输出 llhd 汇编代码，注重可用性、清晰的错误报告和完整性。其目标是作为硬件设计工具（如综合器、代码检查器或逻辑等价性检查器）的前端。

用法

安装

您需要一个可用的 Rust 安装 来构建 Moore。该项目还依赖于 CIRCT 项目，以及间接依赖于 MLIR 和 LLVM。为了获得可用的二进制文件，通常您需要确保已检出 circt 和 circt/llvm 子模块

git submodule update --init --recursive

然后按照以下步骤操作

构建 LLVM 和 MLIR

mkdir -p circt/llvm/build
pushd circt/llvm/build
cmake ../llvm \
    -DCMAKE_BUILD_TYPE=Release \
    -DLLVM_BUILD_EXAMPLES=OFF \
    -DLLVM_ENABLE_ASSERTIONS=ON \
    -DLLVM_ENABLE_BINDINGS=OFF \
    -DLLVM_ENABLE_OCAMLDOC=OFF \
    -DLLVM_ENABLE_PROJECTS=mlir \
    -DLLVM_INSTALL_UTILS=ON \
    -DLLVM_OPTIMIZED_TABLEGEN=ON \
    -DLLVM_TARGETS_TO_BUILD="host"
cmake --build .
popd

构建 CIRCT

mkdir -p circt/build
pushd circt/build
cmake .. \
    -DCMAKE_BUILD_TYPE=Release \
    -DMLIR_DIR=$PWD/../llvm/build/lib/cmake/mlir \
    -DLLVM_DIR=$PWD/../llvm/build/lib/cmake/llvm \
    -DLLVM_ENABLE_ASSERTIONS=ON
cmake --build .
popd

构建 Moore

设置以下环境变量以指示您的 LLVM 和 CIRCT 构建位置

export CIRCT_SYS_CIRCT_DIR=$PWD/circt
export CIRCT_SYS_CIRCT_BUILD_DIR=$PWD/circt/build
export CIRCT_SYS_LLVM_DIR=$PWD/circt/llvm
export CIRCT_SYS_LLVM_BUILD_DIR=$PWD/circt/llvm/build

使用 cargo 安装 Moore

cargo install moore

请注意，在 Linux 系统上，您很可能需要版本 7 或更高版本的 libstdc++ 才能使其正常工作。

开发

对于积极开发，您可能希望使用常见的 check、build、run 和 test 子命令。

您可能还会发现将 *_BUILD_DIR 环境变量指向实际的构建目录（通常是 circt/llvm/build 和 circt/build）很有用，这样您就不需要每次 CIRCT 或 LLVM 发生变化时都重新安装。

示例

假设以下输入文件

// foo.sv
module hello_world;
endmodule

要编译 foo.sv 并将相应的 LLHD 汇编输出到标准输出，请使用文件名和要展开的模块调用 moore（-e 选项）

moore foo.sv -e hello_world

您可以使用 llhd-sim 来模拟编译后的模块

moore foo.sv -e hello_world > foo.llhd
llhd-sim foo.llhd

开发

Moore 是在此存储库中开发的，但已分离成以下 crates

• moore：将所有内容组合在一起的最高级 umbrella crate
• moore-common：由 SystemVerilog 和 VHDL 共享的公共基础设施
• moore-derive：过程宏
• moore-svlog：SystemVerilog 实现
• moore-svlog-syntax：SystemVerilog 解析器和 AST 实现
• moore-vhdl：VHDL 实现
• moore-vhdl-syntax：VHDL 解析器和 AST 实现
• moore-circt：CIRCT API 的 Rust 包装器
• moore-circt-sys：CIRCT 的低级语言绑定

在 moore 上工作的某些有用命令

git submodule init
git submodule update
cargo check
cargo test --all
cargo run -- foo.sv -e foo
scripts/test.py --debug -v
scripts/test.py --debug -v <path-to-test-case>
lit test -v

创建新的发布版本

要创建新的发布版本，必须按上述相反顺序发布项目的各个子 crates。遵循以下清单

1. 使用 scripts/release_status.sh 查看项目中使用的 moore/llhd crate 版本的概述
2. 更新所有 Cargo.toml 文件中的版本
3. 使用 scripts/release_check.sh 确保所有 crates 的版本与根版本相同
4. 确保 cargo 没有问题：cargo check
5. 更新 CHANGELOG.md 文件
6. 提交：git commit -am "Bump version to X.Y.Z
7. 标签：git tag vX.Y.Z
8. 使用 cargo publish 按相反顺序发布所有 crates

lib.rs:

此 crate 包含其余 moore 编译器使用的根本性实用工具。