Engee 文档

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

RITM 是实时运行模型的硬件解决方案。它允许您直接从*Engee*集成和控制物理硬件场景。

开始使用 RITM 目标平台:

  1. 入门 通过 RITM.机器控制 应用程序 ritm iconEngee [添加] RITM 机器。

  2. 安装对 RITM 块 的支持:

    engee.package.install("RITM-Engee-Blocks")
  3. 安装外部硬件支持包:

    engee.package.install("Engee-Device-Manager")
    有关安装过程的更多信息,请参阅Engee 与设备的集成
  4. 完成这些步骤后,就可以使用可提供目标平台 "RITM "软件控制的外部设备工作模块。要连接模块,请输入以下命令:

    using Main.EngeeDeviceManager.Targets
    using Main.EngeeDeviceManager.Targets.RITM.RITM_API
  5. 最后一步,创建 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 模型的分步示例

  1. 模块连接 - 连接包含目标平台 "RITM "及其应用程序接口定义的命名空间:

    using Main.EngeeDeviceManager.Targets
    using Main.EngeeDeviceManager.Targets.RITM.RITM_API
  2. 创建 RITM 目标平台对象并设置 URL - 创建代表目标平台的 ritm 对象并指定 RITM 机器的 IP 地址:

    ritm = Targets.RITM.Ritm()
    Targets.RITM.set_url(ritm, "http://192.168.56.3:8000/")
  3. 检查 RITM 可用性 - 检查是否与 RITM 机器建立了通信:

    RITM_API.isConnected(ritm)

    如果该方法返回 "false",则检查 IP 地址以及客户端程序是否在 RITM 上运行。

  4. *在 RITM 上以independent 模式*构建 Engee 中打开的模型:

    model = Engee.engee.gcm()
    Targets.upload_model(ritm, model)
    Targets.generate_executable_code(ritm, model, false)
    Targets.compile_model(ritm, model)
  5. 启动模型 - 在 RITM 机器上启动模型:

    Targets.start_model(ritm, model)

    启动后,模型将以先前设定的模式(在本例中为独立模式)开始运行。

  6. 停止模型 - 停止 RITM 上所有正在运行的模型:

    Targets.stop_model(ritm)
  7. 在 RITM 上输出目录内容 - 获取指定目录(/home/ritm/)中的文件列表:

    RITM_API.listFiles(ritm, "/home/ritm/")
  8. 读取文件内容 - 输出指定路径 (/home/ritm/build/newmodel_1/build) 下的文件 (install_manifest.txt) 内容:

    RITM_API.readFile(ritm, "install_manifest.txt"; path="/home/ritm/build/newmodel_1/build/")
  9. 获取文件到当前目录 - 在 Engee 中获取指定文件:

    RITM_API.getFile(ritm, "install_manifest.txt"; from="/home/ritm/build/newmodel_1/build/", to="")

    如果未指定 to 参数,文件将保存在当前 Engee 目录中。

  10. 获取内存信息 - 请求有关模型内存消耗的数据:

    RITM_API.memInfo(ritm, "newmodel_1")
  11. 查看最近 10 行日志 - 获取模型执行日志的最后一行:

    RITM_API.getLog(ritm, 10)

    用它们来调试和诊断模型。

  12. 创建截图并获取路径 - 从 RITM 机器上截图:

    RITM_API.getScreenshot(ritm, "example.png")

    文件将保存在 RITM 的临时目录中,其路径将以字符串形式返回。

  13. 检查模型状态 - 确保模型在目标平台 "RITM "上运行:

    RITM_API.isRunning(ritm, "newmodel_1")

    如果函数返回 true,则表示模型正在运行。

  14. 获取剖析数据 - 以文件或字符串形式从 RITM 获取模型剖析数据:

    RITM_API.getData(ritm, "newmodel_1", "/user/", true)