通过 Engee 中的 RITM 与外部设备协同工作
RITM 是实时运行模型的硬件解决方案。它允许您直接从*Engee*集成和控制物理硬件场景。
开始使用 RITM 目标平台:
-
安装对 RITM 块 的支持:
engee.package.install("RITM-Engee-Blocks")
-
安装外部硬件支持包:
engee.package.install("Engee-Device-Manager")
有关安装过程的更多信息,请参阅Engee 与设备的集成 。 -
完成这些步骤后,就可以使用可提供目标平台 "RITM "软件控制的外部设备工作模块。要连接模块,请输入以下命令:
using Main.EngeeDeviceManager.Targets using Main.EngeeDeviceManager.Targets.RITM.RITM_API
-
最后一步,创建 RITM 目标机平台与设备交互的对象,并指定相应设备的 IP 地址:
ritm = Targets.RITM.Ritm() Targets.RITM.set_url(ritm, "http://192.168.56.3:8000/")
使用 RITM 的基本方法
以下是使用 RITM 设备的方法:
-
Targets.upload_model
- 将模型上传到 RITM。 -
Targets.generate_executable_code
- 在 RITM 上生成 C 流水线。 -
Targets.compile_model
- 在 RITM 上构建模型。 -
Targets.start_model
- 在 RITM 上启动模型。 -
Targets.stop_model
- 停止 RITM 上的模型。 -
RITM_API.isConnected
- 检查 RITM 是否可用。 -
RITM_API.isRunning
- 检查 RITM 模型是否正在运行。 -
RITM_API.listFiles
- 显示指定目录中的文件列表。 -
RITM_API.readFile
- 从指定目录输出指定文件的内容。 -
RITM_API.getFile
- 从指定目录检索指定文件。 -
RITM_API.memInfo
- 输出模型消耗的内存信息。 -
RITM_API.getLog
- 返回 RITM 上模型执行日志的指定行数。 -
RITM_API.getScreenshot
- 在 RITM 上创建屏幕截图并返回图像文件的路径。 -
RITM_API.getData
- 返回 RITM 上的模型剖析结果。
每种方法的详细说明请参阅文章软件控制 RITM 。 |
使用 RITM 模型的分步示例
-
模块连接 - 连接包含目标平台 "RITM "及其应用程序接口定义的命名空间:
using Main.EngeeDeviceManager.Targets using Main.EngeeDeviceManager.Targets.RITM.RITM_API
-
创建 RITM 目标平台对象并设置 URL - 创建代表目标平台的
ritm
对象并指定 RITM 机器的 IP 地址:ritm = Targets.RITM.Ritm() Targets.RITM.set_url(ritm, "http://192.168.56.3:8000/")
-
检查 RITM 可用性 - 检查是否与 RITM 机器建立了通信:
RITM_API.isConnected(ritm)
如果该方法返回 "false",则检查 IP 地址以及客户端程序是否在 RITM 上运行。
-
*在 RITM 上以independent 模式*构建 Engee 中打开的模型:
model = Engee.engee.gcm() Targets.upload_model(ritm, model) Targets.generate_executable_code(ritm, model, false) Targets.compile_model(ritm, model)
-
启动模型 - 在 RITM 机器上启动模型:
Targets.start_model(ritm, model)
启动后,模型将以先前设定的模式(在本例中为独立模式)开始运行。
-
停止模型 - 停止 RITM 上所有正在运行的模型:
Targets.stop_model(ritm)
-
在 RITM 上输出目录内容 - 获取指定目录(
/home/ritm/
)中的文件列表:RITM_API.listFiles(ritm, "/home/ritm/")
-
读取文件内容 - 输出指定路径 (
/home/ritm/build/newmodel_1/build
) 下的文件 (install_manifest.txt) 内容:RITM_API.readFile(ritm, "install_manifest.txt"; path="/home/ritm/build/newmodel_1/build/")
-
获取文件到当前目录 - 在 Engee 中获取指定文件:
RITM_API.getFile(ritm, "install_manifest.txt"; from="/home/ritm/build/newmodel_1/build/", to="")
如果未指定
to
参数,文件将保存在当前 Engee 目录中。 -
获取内存信息 - 请求有关模型内存消耗的数据:
RITM_API.memInfo(ritm, "newmodel_1")
-
查看最近 10 行日志 - 获取模型执行日志的最后一行:
RITM_API.getLog(ritm, 10)
用它们来调试和诊断模型。
-
创建截图并获取路径 - 从 RITM 机器上截图:
RITM_API.getScreenshot(ritm, "example.png")
文件将保存在 RITM 的临时目录中,其路径将以字符串形式返回。
-
检查模型状态 - 确保模型在目标平台 "RITM "上运行:
RITM_API.isRunning(ritm, "newmodel_1")
如果函数返回
true
,则表示模型正在运行。 -
获取剖析数据 - 以文件或字符串形式从 RITM 获取模型剖析数据:
RITM_API.getData(ritm, "newmodel_1", "/user/", true)