Lib.rs

require "scope"

function serial_rx(msg)
    msg_str = bytes2str(msg)

    if msg_str ~= "AT\r\n" then
        return
    end

    scope.println("Sending msg \"OK\" via serial tx...")
    scope.serial_tx(str2bytes("OK\r\n"))
    scope.println("Message sent!")
end

function user_command(arg_list)
    if arg_list[1] ~= "hello" then
        return
    end

    scope.println("Hello, World!\r\n")
end

要调用您的插件，您需要输入 !，然后是插件名称和参数列表。在您的插件内部，可以进行许多操作以与 Scope 和串行端口交互，例如：连接到串行端口、从串行端口断开连接、向串行端口发送数据、在 Scope 文本视图中打印一些消息等。有关 Scope 插件开发的更多信息，请参阅插件开发者指南。

Scope 与其他产品对比

Scope 结合了多项功能。下表列出了这些功能

[^2]: Docklight 有侧面板中的命令列表，因此不需要命令历史记录
[^3]: 尚未在 macOS 上进行测试

安装

您可以使用 cargo 安装 Scope 或在 发布页面 下载预构建的二进制文件

使用 cargo

cargo install scope-monitor

如何使用

安装完成后，输入 scope serial，然后是串行端口和所需的波特率。例如，要在波特率 115200 bps 下打开 COM3 端口，请输入

scope serial COM3 115200

当底部的命令栏为绿色时，它开始从串行端口捕获消息，并允许发送消息。

要从 YAML 文件加载命令列表，请使用 -c <YOUR_COMMANDS>.yml 或 --cmd-file <YOUR_COMMANDS>.yml，在 scope 和 serial 之间。例如，要加载 cmd.yml 文件，可以输入

scope -c cmd.yml serial COM3 115200

或

scope --cmd-file cmd.yml serial COM3 115200

项目目标

本项目有 5 个支柱，将指导该工具的开发

I. 直观使用： 工具的使用必须直观。这意味着可用性应遵循其他流行工具的常见行为。例如，历史导航（上箭头 和 下箭头）遵循 Unix shell 和 Windows Powershell 中的 OS 终端的历史导航。
II. 紧凑性和正交性： 功能必须遵循 Unix 的 紧凑性和正交性 原则。
III. 以用户为中心的开发： 该工具的开发必须首先为用户提供价值，而不是取悦开发者。例如：用于扩展工具的脚本语言必须是成熟的编程语言，而不是创建新语言。另一个例子是优先考虑用户报告的严重错误，而不是推出新功能。
IV. 多平台： 所有版本必须在 Windows、Linux（zsh、shell 和 fish）和 macOS 上工作。
V. 可扩展性： 支持用户脚本以扩展基本功能。这些脚本称为插件。有关插件的更多信息，请参阅 插件开发者指南

路线图和后续版本可在GitHub项目中找到。

社区

如有新功能请求或报告错误，请自由地在GitHub上发布新的问题。

贡献

请查看贡献指南。

维护者

• Matheus T. dos Santos

感谢

• Emilio Bottoni和José Gomes，感谢他们的想法推动了此工具的发展，感谢他们发现隐藏的错误以及良好的功能实现。

许可证

Scope在BSD v3许可证的条款下提供。

有关许可证详细信息，请参阅许可证。