在Engee中通过节奏与外部设备一起工作

*节奏*是实时运行模型的硬件解决方案。它允许您将工作场景与物理硬件集成，并直接从*Engee*进行管理。

开始使用目标节奏平台:

添加节奏机器到*Engee*通过应用程序 RITM.机器控制 .

engee.package.install("RITM-Engee-Blocks")

安装外部硬件支持包:
```
engee.package.install("Engee-Device-Manager")
```
有关安装过程的详细信息，请参阅工程师与硬件的集成.
在这些步骤之后，用于与外部设备一起工作的模块变得可用，提供目标节奏平台的软件管理。要连接模块，请输入以下命令:
```
using Main.EngeeDeviceManager.Targets
using Main.EngeeDeviceManager.Targets.RITM.RITM_API
```
在最后阶段，创建用于与设备交互的目标节奏平台的对象，并指定相应设备的IP地址。:
```
ritm = Targets.RITM.Ritm()
ritm.set_url("http://192.168.56.3:8000/")
```

节奏工作的基本方法

以下方法可用于使用节奏设备:

"里特姆。upload_model'-将模型上传到节奏。
"里特姆。generate_executable_code'-在节奏上生成C绑定。
"里特姆。compile_model'-基于节奏构建模型。
"里特姆。start_model'-根据节奏启动模型。
"里特姆。stop_model'-停止模型的节奏。
'RITM_API。isConnected'-检查节奏的可用性。
'RITM_API。isRunning'-检查节奏模型是否正在运行。
'RITM_API。listFiles'-显示指定目录中的文件列表。
'RITM_API。ReadFile'-从指定目录输出指定文件的内容。
'RITM_API。GetFile—-从指定的目录中获取指定的文件。
'RITM_API。memInfo'-显示有关模型消耗的内存的信息。
'RITM_API。getLog—-返回节奏指定的模型执行日志行数。
'RITM_API。getScreenshot`-在节奏上创建屏幕截图并返回图像文件的路径。
'RITM_API。getData'-返回基于节奏分析模型的结果。

文中提供了每种方法的详细描述。软件控制 RITM.

使用节奏模型的分步示例

连接模块-连接包含目标节奏平台及其API定义的命名空间:

using Main.EngeeDeviceManager.Targets
using Main.EngeeDeviceManager.Targets.RITM.RITM_API

创建一个RITM目标平台对象并设置URL-创建一个代表目标平台的`ritm’对象并指定节奏机器的IP地址:
```
ritm = Targets.RITM.Ritm()
ritm.set_url("http://192.168.56.3:8000/")
```
检查节奏的可用性-检查是否与节奏设备建立了连接:
```
RITM_API.isConnected(ritm)
```
如果该方法返回’false'，则检查IP地址以及客户端程序是否在服务器上运行。

在Engee中以节奏组装开放模型独立模式:

model = Engee.engee.gcm()
ritm.upload_model(model)
ritm.generate_executable_code(model, false)
ritm.compile_model(model)

启动模型-在节奏机器上启动模型:
```
ritm.start_model(model)
```
启动后，模型将以先前设置的模式（在我们的例子中，以独立模式）开始执行。
停止模型-停止在节奏上执行所有正在运行的模型:
```
ritm.stop_model()
```
将目录的内容输出到目录中-获取指定目录中的文件列表（'/home/ritm/`）:
```
RITM_API.listFiles(ritm, "/home/ritm/")
```
读取文件内容-输出文件内容（install_manifest。txt）在指定的路径上（'/home/ritm/build/newmodel_1/build`）:
```
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_API.getScreenshot(ritm, "example.png")
```
该文件将保存在节奏上的临时目录中，其路径将作为字符串返回。
检查模型的状态-确保模型在目标平台"RHYTHM"上运行:
```
RITM_API.isRunning(ritm, "newmodel_1")
```
如果函数返回’true'，则模型正在进行中。
获取剖析数据-以文件或字符串的形式从节奏中获取模型剖析数据:
```
RITM_API.getData(ritm, "newmodel_1", "/user/", true)
```

在Engee中通过节奏与外部设备一起工作

节奏工作的基本方法

使用节奏模型的分步示例

有用的连结