#vex #wrapper #robot #vex-rt #robotics #api-bindings

无std safe-vex

一个模块化、可靠且全面的vex-rt库包装器,永不崩溃

42 个版本 (27 个稳定版)

3.2.3-experimental2024年5月15日
3.1.10 2024年8月11日
3.1.9 2024年7月24日
2.2.2 2024年1月21日
0.3.2 2023年11月16日

#151 in 硬件支持

Download history 730/week @ 2024-05-06 310/week @ 2024-05-13 264/week @ 2024-05-20 9/week @ 2024-05-27 25/week @ 2024-07-01 113/week @ 2024-07-22 348/week @ 2024-07-29 63/week @ 2024-08-05 49/week @ 2024-08-12

每月573 次下载

MIT/Apache

21KB
383

crates.io Downloads crates.io License

safe-vex

一个安全、可靠且全面的vex-rt库包装器,绝不会有panic!

免责声明

safe-vex 是一个开源社区项目。 safe-vex 既未被Innovation First, Inc. 批准,也没有与之关联。VEX和VEX Robotics是Innovation First, Inc. 的商标或服务标志。safe-vex 也不是由vex-rt 的开发者开发的,而是一个独立项目。

快速入门 (本地)

你需要

  1. rustup 管理的Rust工具链
  2. arm-none-eabi 工具链
  3. gcclibclang-dev/libclang
  4. (可选) 如果 rustc 抛出错误,则需要 libc6-dev
--- stderr
/usr/lib/arm-none-eabi/include/sys/reent.h:14:10: fatal error: 'stddef.h' file not found
thread 'main' panicked at /home/dev/.cargo/registry/src/index.crates.io-6f17d22bba15001f/vex-rt-0.15.1/build/main.rs:266:10:
Could not generate bindings.: ClangDiagnostic("/usr/lib/arm-none-eabi/include/sys/reent.h:14:10: fatal error: 'stddef.h' file not found\n")
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace
  1. 通过 pip 安装的 pros-cli

然后

  1. 通过运行以下命令克隆 safe-vex 项目的 模板
git clone https://github.com/GreenChild04/safe-vex-template.git
  1. 进入新克隆的目录
  2. 打开并连接到vex v5大脑
  3. 使用以下命令授予上传代码到机器人的权限:(如果失败也不要紧)
sudo chmod a+rw /dev/ttyACM0 || sudo chmod a+rw /dev/ttyACM1
  1. 连接到v5大脑时运行
cargo run --release
  1. 现在你的机器人应该已经启动并运行了 :D

快速入门 (使用 Docker)

你需要

  1. docker

然后

  1. 通过运行以下命令克隆 safe-vex 项目的 模板
git clone https://github.com/GreenChild04/safe-vex-template.git
  1. 进入新克隆的目录
  2. 使用以下命令构建docker镜像
docker build -t safe-vex-template
  1. 打开并连接到vex v5大脑
  2. 使用以下命令授予上传代码到机器人的权限:(如果失败也不要紧)
sudo chmod a+rw /dev/ttyACM0 || sudo chmod a+rw /dev/ttyACM1
  1. 使用以下命令以交互方式运行docker容器
docker run -it --rm --device=/dev/$(ls /dev/ttyACM*) -v .:/project -v $HOME/.cargo/registry:/home/dev/.cargo/registry safe-vex-template
  1. 在连接到v5大脑的docker容器中运行 cargo run --release
  2. 现在你的机器人应该已经启动并运行了 :D

依赖关系

~25MB
~134K SLoC