通过 Engee 中的 RITM 与外部设备协同工作

RITM 是实时运行模型的硬件解决方案。它允许您直接从*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)
```

通过 Engee 中的 RITM 与外部设备协同工作

使用 RITM 的基本方法

使用 RITM 模型的分步示例

实用链接