Skip to main content
本指南带您完成一个完整的测试流程,可以用 Python,也可以用 Rust。流程从连通性开始,到自动化测试结束。完成之后,您可以交互式地使用 CLI,并编写自己的 Lager 测试脚本。
请先完成 入门 指南。本教程假设您已经安装了 CLI、添加了 Box,并用 Net 配置好了仪器。

第 1 部分:CLI 演练

我们先用一条条 CLI 命令走完一个典型的测试流程。这对临时测试、调试和熟悉您的配置很有帮助。

第 1 步:确认您的 Box 在线

预期输出:

第 2 步:查看已连接的仪器

这条命令显示 Box 能看到的所有仪器。请确认您的电源、调试探针和其他仪器都出现在列表中。

第 3 步:查看已配置的 Net

这条命令显示您在后续命令中要使用的命名 Net。请记下这些 Net 名称,下面会用到。

第 4 步:设置默认值以减少输入

设置默认值之后,后续命令可以省略 --box 和 Net 名称。

第 5 步:烧录固件

预期输出:

第 6 步:给您的设备上电

第 7 步:进行一次测量

预期输出:

第 8 步:断电

测试结束后,请始终关闭电源输出。

第 2 部分:您的第一个测试脚本

现在把上面的手动 CLI 步骤变成一个可重复的测试。脚本总是会自己清理,即使发生错误也会关闭电源。 您可以用 Python 编写,它通过 lager python 在 Box 上运行。您也可以用 Rust 编写:在您的固件仓库中作为一个普通的 cargo test,使用 lager-net crate。下面两个版本都会烧录、上电、测量、断言并清理。
清理可以保护您的硬件,所以两个版本都做了清理。Python 版本使用 try/finally,即使发生错误也会关闭电源。Rust 版本在断言之前关闭电源。更早的 ? 错误同样会结束测试,并且失败信息会显示电源的状态。

第 3 部分:运行测试

在您的 Lager Box 上执行这个 Python 脚本:
或者从您的项目运行 Rust 测试(在 [dev-dependencies] 中加入 lager = { package = "lager-net", version = "0.4" }):
预期输出(Python):
如果您需要随脚本一起发送其他文件(固件二进制文件、配置文件),请使用 --add-file

接下来做什么

您已经用 Lager 完成了第一个测试。以下是可以继续探索的方向:
  • CLI 参考 — 每条 CLI 命令的完整文档
  • Python API — 完整的 Python SDK 参考
  • Rust API — 把您的 HIL 测试套件写成 cargo test 集成测试
  • 故障排除 — 出现问题时的解决方法
  • 术语表 — 文档中技术术语的定义
示例脚本 是一个更大的例子。它把机械臂控制、USB 集线器电源循环、调试探针烧录和 ADC 测量组合在一起。