首页
/ Gqrx软件远程控制协议详解

Gqrx软件远程控制协议详解

2025-07-09 07:55:20作者:殷蕙予

概述

Gqrx是一款流行的开源软件定义无线电(SDR)接收器应用,它提供了丰富的远程控制功能。通过本文,我们将深入解析Gqrx的远程控制协议,帮助用户理解如何通过命令行接口与Gqrx进行交互。

基本通信机制

Gqrx的远程控制协议采用简单的文本命令格式,每条命令由单个字母或单词组成,后接可选参数。命令执行后会返回状态码:

  • RPRT 0 表示命令执行成功
  • RPRT 1 表示命令执行失败

核心功能命令详解

频率控制

  1. 查询当前频率

    f
    

    返回当前接收频率,单位为Hz

  2. 设置频率

    F 144500000
    

    将接收频率设置为144.5MHz

解调模式控制

  1. 获取当前解调模式

    m
    

    返回当前解调模式及带宽

  2. 设置解调模式

    M AM 6000
    

    设置为AM模式,带宽6kHz

    查询支持的模式:

    M ?
    

    返回空格分隔的可用模式列表

信号参数控制

  1. 信号强度查询

    l STRENGTH
    

    返回当前信号强度,单位为dBFS

  2. 静噪控制

    • 查询静噪阈值:
      l SQL
      
    • 设置静噪阈值:
      L SQL -50
      
      将静噪阈值设置为-50dBFS
  3. 音频增益控制

    • 查询音频增益:
      l AF
      
    • 设置音频增益:
      L AF 10
      
      将音频增益设置为10dB

增益控制

  1. 查询特定增益

    l LNA_GAIN
    

    返回LNA增益值

  2. 设置特定增益

    L LNA_GAIN 20
    

    将LNA增益设置为20

RDS功能

  1. 获取RDS PI码

    p RDS_PI
    

    返回十六进制格式的RDS PI码,不适用时返回0000

  2. RDS解码器控制

    • 查询RDS解码器状态:
      u RDS
      
    • 设置RDS解码器状态:
      U RDS 1
      
      启用RDS解码器(仅在WFM模式下有效)

录音控制

  1. 查询录音状态

    u RECORD
    

    返回录音状态

  2. 控制录音

    U RECORD 1
    

    开始录音

DSP控制

  1. 查询DSP状态

    u DSP
    

    返回DSP状态

  2. 设置DSP状态

    U DSP 1
    

    启用DSP

LNB LO控制

  1. 查询LNB LO频率

    LNB_LO
    

    返回当前LNB LO频率

  2. 设置LNB LO频率

    LNB_LO 97500000
    

    将LNB LO频率设置为97.5MHz

特殊事件命令

  1. 信号获取事件

    AOS
    

    触发信号获取事件,自动开始录音

  2. 信号丢失事件

    LOS
    

    触发信号丢失事件,自动停止录音

系统信息命令

  1. 获取版本信息

    _
    

    返回Gqrx版本信息

  2. 关闭连接

    q
    

    Q
    

    关闭远程控制连接

Hamlib兼容性命令

Gqrx提供了一些专为Hamlib兼容性设计的命令:

  1. VFO状态查询

    \chk_vfo
    

    获取VFO选项状态

  2. 状态转储

    \dump_state
    

    转储当前状态

  3. 电源状态查询

    \get_powerstat
    

    获取电源状态

  4. VFO控制

    • 查询:
      v
      
    • 设置:
      V
      
  5. 分集模式控制

    • 查询:
      s
      
    • 设置:
      S
      

实用技巧

  1. 批量命令执行:可以通过脚本连续发送多个命令,实现自动化控制

  2. 状态监控:定期查询信号强度和RDS信息,可用于远程监控

  3. 事件触发:结合AOS/LOS命令,可以实现基于信号状态的自动化操作

  4. 增益优化:通过脚本自动调整各阶段增益,寻找最佳接收设置

总结

Gqrx的远程控制协议提供了全面的功能覆盖,从基本的频率控制到高级的信号处理参数调整,都可以通过简单的文本命令实现。这种设计既方便了手动交互,也为自动化脚本和第三方应用集成提供了可能。掌握这些命令后,用户可以充分发挥Gqrx的潜力,实现更灵活的SDR操作体验。