rigctl - 云端在线

程序：

您的姓名

rigctl - 控制无线电收发器和接收器

概要

控件 [OPTION]……[指挥] ...

商品描述

控制无线电收发器和接收器。 控件 接受 命令 从命令行
以及在交互模式下，如果命令行上没有提供。

请记住 哈姆利卜 是BETA级软件。 虽然很多后端库缺乏
完整的钻机支持，基本功能通常都得到很好的支持。 API 可能会更改
没有公开通知，而次要版本的改进（例如 1.1.x 到 1.2.x）
表示这样的变化。

请报告错误并通过报告错误中提供的电子邮件地址提供反馈
部分。 补丁和代码增强也是受欢迎的。

配置

该程序遵循通常的 GNU 命令行语法，长选项以
两个破折号 (`-')。

以下是支持的选项的摘要：

-米， --型号=id
选择无线电型号。 请参阅模型列表（使用 'rigctl -l'）。

注意： 控件 （或第三方软件）在使用时将使用钻机型号 1901 rpc.rigd or
NET rigctl (rigctld) 的钻机模型 2。

-r, --rig-file=设备
使用 VHDL 语言编写 设备 作为无线电连接的端口的文件名。 经常是连续剧
端口，但可以是 USB 到串行适配器。 通常 /dev/ttyS0、/dev/ttyS1、
Linux 上的 /dev/ttyUSB0 等或 Win1 上的 COM2、COM32 等。

还用于指定主机和端口以连接到侦听 rotctld 守护进程
POSIX：

-r 本地主机：4532

在 Win32 上：

-r 127.0.0.1:4532

-p, --ptt-file=设备
使用 VHDL 语言编写 设备 作为使用设备文件的一键通设备的文件名
如上所述。

-d, --dcd-文件=设备
使用 VHDL 语言编写 设备 作为使用设备文件的数据载波检测设备的文件名
如上所述。

-P, --ptt-type=类型
使用 VHDL 语言编写 类型 一键通设备。 支持的类型有 RIG、DTR、RTS、PARALLEL、
NONE，覆盖设备后端定义的 PTT 类型。

此命令的一些副作用是当 type 设置为 DTR 时，读取 PTT 状态
来自 Hamlib 前端，不是从收音机中读取的。 设置为 NONE 时，PTT 状态
即使钻机后端支持从以下位置读取/设置 PTT 状态，也无法读取或设置
钻机。

-D, --dcd-type=类型
使用 VHDL 语言编写 类型 数据载波检测设备。 支持的类型有 RIG、DSR、CTS、CD、
平行，无。

-是的， --串行速度=波特率
将串行速度设置为 波特 速度。 使用钻机后端的最大串行速度
能力作为默认。

-C， --civaddr=id
使用 VHDL 语言编写 id 作为与钻机通信的 CI-V 地址。 仅对 Icom 钻机有用。

注意： id 是十进制表示法，除非以 0x，在这种情况下
十六进制。

-t, --send-cmd-term=字符
更改终止 坦克 用于文本协议时使用 发送_cmd 命令。 的
默认值为(0x0d)。 非 ASCII 可打印字符可以指定为
ASCII 数字，十六进制格式，以 0x 开头。 你可以通过一个空的
没有终止字符的字符串。 字符串 '-1' 告诉 rigctl 切换到二进制
协议。 见 发送_cmd 命令进一步解释。

例如，为 Kenwood 风格的文本命令 pass 指定命令终止符
"-t ';'" 到 rigctl。 参见下面的例子。

-L, --显示会议
列出上面使用 -m 定义的无线电的所有配置参数。

-C， --set-conf=parm=val[,parm=val]*
设置配置参数。 例如 stop_bits=2

对列表使用 -L 选项。

-l, - 列表
列出中定义的所有型号 哈姆利卜 并退出。 从 1.2.15.1 开始，列表是
按型号排序。

注： 在 Linux 中，可以使用 Shift-PageUp/Shift-PageDown 向后滚动列表，或者
使用 X 中虚拟终端的滚动条或 Windows 中的 cmd 窗口。 这
输出可以通过管道传输到“更多”或“更少”，例如“rigctl -l | 更多的'。

-你， --转储上限
上面用 -m 定义的无线电转储功能并退出。

-o， --vfo
设置 vfo 模式，在每个适当的命令前需要一个额外的 VFO 参数。
否则，如果未设置此选项，则假定为 VFO_CURR。

-v， --详细
设置详细模式，累积（参见下面的诊断）。

-H， - 帮帮我
显示这些选项的摘要并退出。

-V, - 版
显示版本 控件 并退出。

注： 某些选项可能不会由给定的后端实现，并且会返回错误。
这最有可能发生在 --设置会议 和 --显示会议 选项​​。

请注意，要控制的收音机的后端，或收音机本身可能不会
支持一些命令。 在这种情况下，操作将失败并显示 哈姆利卜 错误代码。

指令

命令可以作为单个字符输入，也可以作为长命令名称输入。 基本上，
与选项一样，命令在命令行中的前面没有破折号。
它们可以在交互模式下输入或在命令行中作为参数提供
接口模式。

由于大部分时间 哈姆利卜 操作有一个 集 和 得到 方法，大写字母将
用于 集 方法，而相应的小写字母指的是 得到
方法。 每个操作也有一个长名称； 在交互模式下，在前面加上反斜杠
输入一个长命令名称。

示例：使用“\dump_caps”查看此收音机可以做什么。

请注意，要控制的收音机的后端，或收音机本身可能不会
支持一些命令。 在这种情况下，操作将失败并显示 哈姆利卜 错误信息。

这是支持的命令的摘要（在“set”命令的情况下，引用
字符串被描述中的值替换。 在“get”命令的情况下
带引号的字符串是返回值的键名。）：

问|问, 出口 控件
以交互模式退出 rigctl。

当 rigctl 直接控制钻机时，将关闭钻机后端和端口。
当 rigctl 连接到 rigctld（钻机模型 2）时，到 rigctld 的 TCP/IP 连接
已关闭且 rigctld 仍在运行，可用于另一个 TCP/IP 网络
连接。

F, 设置频率 '频率'
设置“频率”，单位为赫兹。

f, 获取频率
获取“频率”，以赫兹为单位。

M, 设置模式 '模式' '通带'
设置“模式”：USB、LSB、CW、CWR、RTTY、RTTYR、AM、FM、WFM、AMS、PKTLSB、PKTUSB、
PKTFM、ECSSUSB、ECSSLSB、传真、SAM、SAL、SAH、DSB。

以 Hz 为单位设置“Passband”，或为 Hamlib 后端默认设置“0”。

m, 获取模式
获取“模式”“通带”。

以字符串形式返回 Mode 设置模式 以上和以Hz为单位的通带。

V, 设置_vfo 'VFO'
设置“VFO”：VFOA、VFOB、VFOC、currVFO、VFO、MEM、Main、Sub、TX、RX。

在 VFO 模式下，只需要一个 VFO 参数。

v, 获取vfo
获取当前的“VFO”。

以字符串形式返回 VFO 设置_vfo 以上。

J, 设置_rit 'RIT'
设置'RIT'，单位为Hz，可以是+或-。

值“0”会重置 RIT 并且*应该*关闭 RIT。 如果没有，请提交错误报告
针对 Hamlib 后端。

j, 获取_rit
获取“RIT”，以赫兹为单位。

Z, 设置退出 'XIT'
设置'XIT'，以Hz为单位可以是+或-。

值“0”会重置 RIT 并且*应该*关闭 RIT。 如果没有，请提交错误报告
针对 Hamlib 后端。

z, 退出
获取“XIT”，单位为赫兹。

T, 设置点 'PTT'
设置“PTT”、0（RX）、1（TX）、2（TX麦克风）、3（TX数据）。

t, 获取_ptt
获取“PTT”状态。

0x8b， 获取dcd
获取“DCD”（静噪）状态，0（关闭）或 1（打开）

R, 设置_rptr_shift 'Rptr 转移'
设置 'Rptr Shift': "+", "-" 或其他不设置。

r, 获取rptr_shift
获取'Rptr Shift'。 返回“+”、“-”或“无”。

O, 设置_rptr_offs 'Rptr 抵消'
以赫兹为单位设置“Rptr 偏移”。

o, 获取rptr_offs
获取以 Hz 为单位的“Rptr 偏移量”。

C, 设置ctcss_tone 'CTCSS 语气'
设置“CTCSS 音调”，以十分之一赫兹为单位。

c, 获取ctcss_tone
获取“CTCSS 音调”，以十分之一赫兹为单位。

D, 设置dcs代码 'DCS 代码'
设置“DCS 代码”。

d, 获取dcs代码
获取“DCS 代码”。

0x90， 设置_ctcss_sql 'CTCSS Sql'
设置“CTCSS Sql”音调，以十分之一赫兹为单位。

0x91， 获取_ctcss_sql
获取 'CTCSS Sql' 音调，以十分之一赫兹为单位。

0x92， 设置_dcs_sql 'DCS Sql'
设置“DCS Sql”代码。

0x93， 获取_dcs_sql
获取“DCS Sql”代码。

I, 设置分割频率 '发送 频率'
设置“TX 频率”，单位为赫兹。

i, 获取分割频率
获取“TX 频率”，单位为赫兹。

X, 设置拆分模式 'TX 模式' 'TX 通带'
设置“TX 模式”：AM、FM、CW、CWR、USB、LSB、RTTY、RTTYR、WFM、AMS、PKTLSB、PKTUSB、
PKTFM、ECSSUSB、ECSSLSB、传真、SAM、SAL、SAH、DSB。

'TX Passband' 是以 Hz 为单位的精确通带，或者是 Hamlib 后端的'0'
默认。

x, 获取分割模式
获取“TX 模式”和“TX 通带”。

以字符串形式返回 TX 模式 设置拆分模式 以上和以Hz为单位的TX通带。

S, 设置分割vfo '分裂' 'TX VFO'
设置 'Split' 模式、'0' 或 '1' 和 'TX VFO' 从 设置_vfo 以上。

s, 获取_split_vfo
获取“拆分”模式、“0”或“1”以及“TX VFO”。

N, 设置_ts '调音 步'
以赫兹为单位设置“调谐步长”。

n, 获取_ts
获取“调整步长”，单位为 Hz。

U, 设置函数 '功能' '功能 地位'
设置“功能”“功能状态”。

Func 是以下之一：FAGC、NB、COMP、VOX、TONE、TSQL、SBKIN、FBKIN、ANF、NR、AIP、APF、
MON、MN、RF、ARO、LOCK、MUTE、VSC、REV、SQL、ABM、BC、MBC、AFC、SATMODE、SCOPE、
恢复，爆发，调谐器。

Func 状态参数是“激活”的非空值，否则“取消激活”，
就像 C 语言中的 TRUE/FALSE 定义一样。

u, 获取函数
获取“功能”“功能状态”。

以字符串形式返回 Func 设置函数 以上和 Func 状态为非空值。

L, 设置级别 '等级' '等级 价值'
设置“级别”和“级别值”。

级别是以下之一：PREAMP、ATT、VOX、AF、RF、SQL、IF、APF、NR、PBT_IN、PBT_OUT、
CWPITCH、RFPOWER、MICGAIN、KEYSPD、NOTCHF、COMP、AGC（0：关闭、1：超快、2：快速、
3：慢、4：用户、5：中、6：自动）、BKINDL、BAL、METER、VOXGAIN、ANTIVOX、SLOPE_LOW、
SLOPE_HIGH、RAWSTR、SWR、ALC、强度。

级别值可以是浮点数或整数。

l, 获取级别
获取“级别”“级别值”。

以字符串形式返回 Level 设置级别 高于和水平值作为浮点数或
整数。

P, 设置参数 '帕尔姆' '帕尔姆 价值'
设置“参数”“参数值”

Parm 是以下之一：ANN、APO、背光、BEEP、时间、BAT、KEYLIGHT。

p, 获取参数
获取“Parm”“Parm 值”。

以字符串形式返回 Parm 设置参数 以上和 Parm 值作为浮点数或整数。

B, 设置银行 '银行'
设置“银行”。 设置当前存储库编号。

E, 设置内存 '记忆＃'
设置“内存#”频道号。

e, 获取内存
获取“内存#”频道号。

G, vfo_op '内存/VFO 欧普'
执行“内存/VFO 操作”。

Mem VFO 操作是以下之一：CPY、XCHG、FROM_VFO、TO_VFO、MCL、UP、DOWN、BAND_UP、
BAND_DOWN、左、右、调谐、切换。

g, 浏览 '扫描 Fct' '扫描 渠道'
执行“扫描Fct”“扫描通道”。

扫描功能/通道是以下之一：STOP、MEM、SLCT、PRIO、PROG、DELTA、VFO、PLT。

H, 设置频道 '渠道'
设置内存“通道”数据。 尚未实施。

h, 获取频道
获取内存“通道”数据。 尚未实施。

A, 设置_trn '收发'
设置“收发”模式（报告事件）：OFF、RIG、POLL。

a, 获取_trn
获取“收发”模式（报告事件），如 设置_trn 以上。

Y, 设置蚂蚁 '天线'
设置“天线”编号（0、1、2、..）。

y, 获取蚂蚁
获取“天线”编号（0、1、2、..）。

*, 重置 '重启'
执行装备“重置”。

0 = 无，1 = 软件复位，2 = VFO 复位，4 = 存储器清除复位，8 = 主
重启。 由于这些值在 rig.h 中定义为位掩码，因此应该可以
如果后端支持，将这些值与这些值一起进行一次多次重置
它或完全通过钻机控制支持重置操作。

b, 发送莫尔斯 '摩斯'
发送“莫尔斯”符号。

0x87， 设置电源状态 '力量 地位'
设置电源开/关/待机“电源状态”。

0 = 电源关闭，1 = 电源开启，2 = 电源待机。 在 rig.h 中定义为位掩码。

0x88， 获取电源状态
获取电源开/关/待机“电源状态”，如 设置电源状态 以上。

0x89， 发送_dtmf '数字'
设置 DTMF '数字'。

0x8a， 接收dtmf
获取 DTMF '数字'。

_, 获取信息
获取有关装备的其他信息（“VFO 模式”中没有 VFO 或传递值）。

1, 转储上限
不是真正的钻机远程命令，它只是转储功能，即后端是什么
知道这个模型，以及它可以做什么。

TODO：确保这是一致的格式，以便可以将其读入散列，
字典等。请求报告错误。

注：: 这个命令会产生多行输出，所以如果使用
定长数组！ 例如，对 Dummy 后端运行此命令
导致超过 5kB 的文本输出。

“VFO 模式”中未使用 VFO 参数。

2, 功率2mW '力量 [0.0..1.0]' '频率' '模式'
返回“功率 mW”

转换范围内的 Power 值 0.0 ... 1.0 到实际发射功率
毫瓦（整数）。 这 频率 和 模式 还需要作为输出提供
功率可能会根据这些值而有所不同。

“VFO 模式”中未使用 VFO 参数。

4, 兆瓦2功率 '力量 兆瓦' '频率' '模式'
返回“功率 [0.0..1.0]”

将以毫瓦（整数）为单位的实际发射功率转换为以单位为单位的功率值
范围 0.0 ... 1.0。 该 频率 和 模式 还需要作为输出提供
功率可能会根据这些值而有所不同。

“VFO 模式”中未使用 VFO 参数。

w, 发送_cmd '命令'
将原始命令字符串发送到装备。 这对于测试和故障排除设备很有用
开发后端时的命令和响应。

对于二进制协议，输入值\0xAA\0xBB。 期待钻机的“回复”
这可能是一个二进制块或一个 ASCII 字符串，具体取决于钻机的
协议（请参阅对讲机的计算机控制文档）。

命令终止符，由 发送命令项 上面的选项，将终止每个
命令字符串发送到无线电。 这个字符不应该是输入的一部分
字符串。

示例

开始 控件 对于 Yaesu FT-920，在 Linux 上以交互方式使用 USB 到串行适配器
模式：

$ rigctl -m 114 -r /dev/ttyUSB1

开始 控件 对于在 Win920 上使用 COM1 的 Yaesu FT-32，同时生成 TRACE 输出到
斯特德:

C:\> rigctl -m 114 -r COM1 -vvvvv

开始 控件 对于 Yaesu FT-920 使用 USB 转串口适配器，同时设置波特率和
停止位：

$ rigctl -m 114 -r /dev/ttyUSB1 -s 4800 -C stop_bits=2

开始 控件 指定命令时使用 USB 转串口适配器的 Elecraft K3
“w”命令的终止符：

$ rigctl -m 229 -r /dev/ttyUSB0 -t';'

开始 控件 运用 rpc.rigd 并设置频率和模式：

$ rigctl -m 1901 -r 本地主机 F 7253500 M LSB 0

连接到正在运行的 权限 使用本地主机上的钻机模型 2（“NET rigctl”）和
在 POSIX 上指定 TCP 端口：

$ rigctl -m 2 -r 本地主机：4532

在 Win32 上：

C:\> rigctl -m 2 -r 127.0.0.1:4532

诊断

这个 -v, --详细 选项允许将不同级别的诊断输出到 斯特德 和
对应于 -v 表示 BUG，-vv 表示 ERR，-vvv 表示 WARN，-vvvv 表示 VERBOSE，或 -vvvvv 表示
痕迹。

给定的详细级别对于向电子邮件提供所需的调试信息很有用
地址如下。 例如，TRACE 输出显示发送到和接收到的所有值
来自无线电这对无线电后端库开发非常有用，可能是
应开发商要求。

退出 状态

控件 退出：
0 如果所有操作正常完成；
1 如果存在无效的命令行选项或参数；
2 如果错误被返回 哈姆利卜.

使用 onworks.net 服务在线使用 rigctl