himpi-sys

Hi35XX MPI API for Rust不安全绑定。

要求

1. 目标板工具链必须安装并导出到 PATH
   • hi3516ev200 - arm-himix100-linux.
   • hi3516ev300 - 与 hi3516ev200 相同。
   • hi3518ev200 - 与 hi3516ev200 相同。
   • hi3518ev300 - 与 hi3516ev200 相同。
   • hi3519av100 - arm-himix200-linux.
   • hi3531v100 - arm-hisiv100nptl-linux.
   • hi3559av100 - aarch64-himix100-linux.
2. 目标板必须安装rust目标
   • hi3516ev200 - armv7-unknown-linux-musleabihf.
   • hi3516ev300 - 与 hi3516ev200 相同。
   • hi3518ev200 - 与 hi3516ev200 相同。
   • hi3518ev300 - 与 hi3516ev200 相同。
   • hi3519av100 - aarch64-unknown-linux-gnu.
   • hi3531v100 - arm-unknown-linux-musleabi.
   • hi3559av100 - aarch64-unknown-linux-gnu.
3. 将 MPP_DIR 导出为包含 mpp-lib 的目录。
4. 将 SYS_INCLUDE 导出为包含系统头文件的目录。
5. 将 SYS_LIBDIR 导出为包含系统库的目录。

您可以从BSP SDK中获取工具链和mpp-lib。

环境默认值

Hi3516EV200

Hi3616EV300、Hi3616EV200、Hi3618EV300使用相同的SDK。

export PATH=/opt/hisi-linux/x86-arm/arm-himix100-linux/bin:$PATH
export MPP_DIR=vendor/mpp-lib-Hi3516EV200_V1.0.1.0
export SYS_INCLUDE=/opt/hisi-linux/x86-arm/arm-himix100-linux/target/usr/include

Hi3519AV100

export PATH=/opt/hisi-linux/x86-arm/arm-himix200-linux/bin:$PATH
export MPP_DIR=vendor/mpp-lib-Hi3519AV100_V2.0.2.0
export SYS_INCLUDE=/opt/hisi-linux/x86-arm/arm-himix200-linux/target/usr/include

Hi3531V100

export PATH=/opt/hisi-linux-nptl/arm-hisiv100-linux/target/bin:$PATH
export MPP_DIR=vendor/mpp-lib-Hi3531V100_V1.0.D.0
export SYS_INCLUDE=/opt/hisi-linux-nptl/arm-hisiv100-linux/target/usr/include

Hi3559AV100

export PATH=/opt/hisi-linux/x86-arm/aarch64-himix100-linux/bin:$PATH
export MPP_DIR=vendor/mpp-lib-Hi3559AV100_V2.0.2.0
export SYS_INCLUDE=/opt/hisi-linux/x86-arm/aarch64-himix100-linux/aarch64-linux-gnu/sys-include

构建

要构建该包，您必须首先设置交叉编译环境。

在 .cargo/ 中有一些预设，可以帮助您快速设置交叉编译。

示例

# Setup for Hi3559AV100 boards
cp .cargo/hi3559av100.toml .cargo/config
# or for link static libraries
cp .cargo/hi3559av100-static.toml .cargo/config
# Build the package ...
cargo b

确保在Cargo.toml中启用了 hi3559av100 功能，hi3559av100 指定了目标板，您可以将它更改为其他，例如： hi3531v100 更多功能请参阅Cargo.toml。

使用 arm-hisiv100-linux-uclibcgnueabi 构建

# the nightly toolchain and rust-src must be installed.
rustup override set nightly
rustup component add rust-src
# the xargo command must be installed.
cargo install xargo
# if the above already, that should be work now.
RUST_TARGET_PATH=$(pwd) xargo [b|c|r|t] ...

如果未设置RUST_TARGET_PATH，xargo将引发“错误加载目标规范...”

示例

use himpi_sys::{HI_MPI_SYS_Init, HI_MPI_SYS_Exit};

fn main() {
    unsafe {
        println!("HI_MPI_SYS_Init() = {}", HI_MPI_SYS_Init());
        println!("HI_MPI_SYS_Exit() = {}", HI_MPI_SYS_Exit());
    }
}