ardop_interface

ARDOP TNC的异步Rust接口

文档 | 包 | Git

简介

ardop_interface与业余无线电数字开放协议（ARDOP）声卡调制解调器软件集成。ARDOP调制解调器旨在在短波（HF）无线电链路上提供可靠、低速的连接。

此包不是ARDOP。 此包仅是一个接口。通过此接口和独立的ARDOP调制解调器软件，您可以构建具有完整功能的Rust应用程序，并通过无线电进行通信。

最小示例

use std::net::SocketAddr;
use async_std::task;
use futures::prelude::*;

use ardop_interface::tnc::*;

fn main() {
   task::block_on(async {
        let addr = "127.0.0.1:8515".parse().unwrap();
        let mut tnc = ArdopTnc::new(&addr, "MYC4LL")
            .await
            .unwrap();
        let mut conn = tnc.connect("T4GET", 500, false, 3)
            .await
            .expect("TNC failure")
            .expect("Connection failed");
        conn.write_all(b"Hello, world!\n").await.unwrap();
        conn.close().await;
   })
}

请参阅源代码仓库中的examples/目录中的完整客户端和服务器。示例还演示了async_std包、参数解析和日志记录。

ARDOP调制解调器

像大多数业余无线电调制解调器一样，ARDOP设计用于通过声卡接口与模拟单边带（SSB）收发器接口。计算机（可能是一块简单的单板计算机）将数据转换为声音，反之亦然。

ARDOP设计用于

• 自动重试失败的传输。这种操作模式称为自动重传请求 (ARQ)，并有助于确保数据达到最终目的地。

• 使用最快可用的模式，根据信号与噪声比和频段条件

• 支持无人值守、自动站操作

• 在短波（HF）频段上表现良好

最好的是，ARDOP有一个开放的开发模型。完整的协议规范可用，并且存在调制解调器的开源实现。

ARDOP旨在由获照的无线电爱好者使用。如果您想开始这项爱好，您应该找到您附近的俱乐部、“hamfest”或“hamvention”！

Rust接口

ARDOP软件为客户端提供了一个标准化的“终端节点控制器”（TNC）接口。为了使用TNC，客户端必须建立两个同时的TCP连接，并执行大量的序列化和反序列化操作。这个库为您处理了许多这些细节。

此库提供了一个许多Rust程序员熟悉的async API：套接字编程。设计ArqStream对象是为了模拟异步的TcpStream。一旦建立连接，数据通过从ArqStream对象异步读取和写入来交换。

async API允许ARDOP与原生TCP套接字、GUI和其他I/O过程共存，同时保持较小的系统资源占用。

开发状态

此库处于实验阶段。其API将不会稳定，直到ardop_interface可以在不使用async_std的unstable特性的情况下构建。

先决条件

需要Rust 1.40或更高版本。

获取ARDOP的兼容实现。您必须使用实现协议版本一的ARDOP软件。ARDOP v2规范已被其作者撤回，而版本三目前正在开发中。这个库所依赖的TNC接口可能会在主要版本发布期间发生变化。

以下说明假设使用John Wiseman的ardopc版本1。其他实现可能也能工作，但这个库尚未针对它们进行测试。您可能可以从http://www.cantab.net/users/john.wiseman/Downloads/Beta/TeensyProjects.zip或从ARDOP 论坛获得此软件。

您需要系统上的C/C++编译器来构建ardopc。基于Debian的发行版可以使用以下命令安装这些工具：

sudo apt-get install build-essential

解压缩存档，进入ARDOPC子目录，然后运行make来构建软件。对于Windows用户，还有一个Visual Studio项目。或者，您可以在http://www.cantab.net/users/john.wiseman/Downloads/Beta/找到二进制构建版本。

现在您可以调用ARDOP了

./ardopc PORT INDEV OUTDEV

其中

• PORT是所需的TCP控制端口（通常是8515）
• INDEV是您的"线入"声卡端口的ALSA设备名称。如果您系统有pulseaudio，您可以使用pulse设备。
• OUTDEV是您的"线路输出"声卡端口的ALSA设备名称。如果您系统有pulseaudio，您可以使用pulse设备。

git clone https://github.com/cbs228/ardop_interface.git

pacmd load-module module-null-sink sink_name=Virtual1
pacmd set-default-sink Virtual1
pacmd set-default-source Virtual1.monitor

./ardopc 8515 pulse pulse &
./ardopc 8520 pulse pulse &

cargo run --package echoserver -- localhost:8515 MYCALL-S 200

cargo run --package echoclient -- localhost:8520 MYCALL-C MYCALL-S 200

Echo server echoed all stanzas correctly.

pacmd unload-module module-null-sink