AnyMath 文档

节奏SDR卡管理 AnyMath

对于RITM machine上的DA-AX-FMC-RF9SDR卡的远程操作,使用以下内容 工程师。目标。RITM_API。特别提款权 -软件控制功能 AnyMath . 页面上提供了所有功能的详细说明 节奏SDR卡的软件管理.

本文使用以下缩写: *SDR-软件定义无线电系统; *射频-射频部分; *Dds-数字合成器; *JESD-FPGA与收发器之间的数字接口; *Fhm-载波调整模式; *MCS-多个板的同步。

当前的软件控制实现设计用于两个发射(TX)和两个接收(RX)通道。 软件控制可以检测和初始化电路板、控制载波、同步、校准、无线电路径、TX衰减、RX和DDS增益,并读取电路板和JESD线路的状态。 I/Q样本的阵列的发送和接收属于单独的接口。

管理如何运作

节奏SDR卡管理 AnyMath 是使用 恩吉。综合服务. AnyMath 通过AMQP与*Engee客户端程序交换数据。集成*安装在用户的管理计算机上。 客户端程序通过HTTP访问节奏机上的管理器;管理器执行命令 ritm-sdr 为所选择的费用。 函数的第一个参数 特别提款权 -注册机器的名称、其保存的IP地址或完整URL。 名称和IP地址必须添加到 AnyMath ;完整的URL可以直接传递。 论点 董事会 -函数返回的费用ID 列表板,而不是列表中的板的序列号。

在运行示例之前

*应用程序 *恩吉。综合服务*必须在用户的计算机上运行并连接。 *节奏机至少需要兼容的固件版本 v7.10.0. *在[准备]部分中,替换 里特姆1 和 192.168.56.3 用你的车的数据。 从 列表板. *在TX操作之前准备RF连接:成功完成 初始化, 校准 和 结算 在当前版本的驱动程序中,它可能会使无线电路径打开。

参数及操作程序

Dds载波和频率以Hz为单位,Fhm边界以MHz为单位,TX衰减以毫分贝为单位(32_000 = 32 dB),由表的RX索引增益,DDS缩放百万分之一(1_000_000 = 1.0). TX/RX通道有数字 0 和 1,DDS索引-从 0 以前 3. 对于FHM,请在 BoardConfig; 设定频率 适用于已经用FHM初始化的板。 对于MCS,主站和从站配置在单个调用中传输 初始化;软件管理中没有单独的MCS命令。

执行[准备,准备]一次,然后分别运行必要的部分。 每个部分都会改变设备的状况;不要连续执行所有部分。 修改方法返回一个具有 成功 和 味精,所以检查结果。 读取直接返回值,如果请求失败则抛出异常。 组初始化不是原子的;在错误或超时后,首先读取受影响板的状态,然后才决定是否重复该命令。 没有SDR命令的自动重播。 无线电 关闭RF,保存初始化; 脱初始化 完成板的操作。

使用软件控制与节奏SDR卡一起工作的一个例子

准备工作

在所选部分之前,在当前会话中运行以下代码一次。 它连接软件控制功能,设置机器名称。 (ritm_name),如有必要,将其添加到 AnyMath 通过 addMachine. 操作结果的验证也在这里定义。 更改计算机名称或地址后,再次运行代码。

ritm_name = "RITM 1"
if !RITM_API.isMachineExists(ritm_name)
    RITM_API.addMachine(ritm_name, "192.168.56.3")
end

sdr = RITM_API.SDR

require_success = result -> begin
    if !get(result, "success", false)
        message = get(result, "msg", "operation failed")
        error("RITM SDR: " * string(message))
    end
    return result
end

初始化单板

板在具有内部同步的固定载波上的初始化。

let
    board_id = 0
    carrier_frequency_hz = 300_000_000

    config = sdr.BoardConfig(
        id=board_id,
        frequency_hz=carrier_frequency_hz,
        topology="internal",
    )
    require_success(sdr.initialize(ritm_name, config))
end

单板去初始化

停止并取消初始化所选电路板。

let
    board_id = 0

    require_success(sdr.deinitialize(ritm_name, board_id))
end

在MCS中初始化两个板

用一个组调用初始化主从. MCS在此操作期间由驱动程序执行;没有单独的MCS命令。

let
    master_id = 0
    slave_id = 1
    master_frequency_hz = 300_000_000
    slave_frequency_hz = 300_000_000

    configs = [
        sdr.BoardConfig(
            id=master_id,
            frequency_hz=master_frequency_hz,
            topology="master",
        ),
        sdr.BoardConfig(
            id=slave_id,
            frequency_hz=slave_frequency_hz,
            topology="slave",
        ),
    ]
    require_success(sdr.initialize(ritm_name, configs; slave_fallback=true))
end

两块板的去初始化

用一个组呼叫去初始化两个板。

let
    board_ids = [0, 1]

    require_success(sdr.deinitialize(ritm_name, board_ids))
end

通道校准

板必须初始化。 在示例中,通道按顺序校准。 0 和 1. 驱动器在校准后使RF保持开启状态,因此该部分关闭单元中的RF。 最后.

let
    board_id = 0
    channels = (0, 1)

    results = Dict{Int,Any}()
    try
        for channel in channels
            results[channel] = require_success(
                sdr.calibrate(ritm_name, board_id; channel=channel),
            )
        end
    finally
        radio_result = sdr.radioOff(ritm_name, board_id)
        if !get(radio_result, "success", false)
            @warn "Не удалось выключить RF после калибровки" radio_result
        end
    end
    results
end

设置衰减

板必须初始化。 发射器的衰减以毫分贝为单位设置: 32_000 回应 32 分贝。

let
    board_id = 0
    channel = 0
    attenuation_mdb = 32_000

    require_success(
        sdr.setTxAttenuation(ritm_name, board_id, channel, attenuation_mdb),
    )
end

灵敏度设置

板必须初始化。 接收器的灵敏度由增益表索引设置,而不是由dB值设置。

let
    board_id = 0
    channel = 0
    gain_table_index = 255

    require_success(
        sdr.setRxGain(ritm_name, board_id, channel, gain_table_index),
    )
end

射频控制:开和关

板必须初始化。 第一个命令打开无线电路径,第二个命令将其关闭。 仅在准备好的支架上启动激活。

let
    board_id = 0

    enabled = require_success(sdr.radioOn(ritm_name, board_id))
    disabled = require_success(sdr.radioOff(ritm_name, board_id))
    Dict("enabled" => enabled, "disabled" => disabled)
end

获取单板的参数

两个射频通道的读取衰减和灵敏度、初始化状态和同步拓扑。 读取功能不包括无线电轨道-参数可以在任何时候读取.

let
    board_id = 0
    channels = (0, 1)

    Dict(
        "tx_attenuation_mdb" => Dict(
            channel => sdr.getTxAttenuation(ritm_name, board_id, channel)
            for channel in channels
        ),
        "initialized" => sdr.isInitialized(ritm_name, board_id),
        "topology" => sdr.getSyncTopology(ritm_name, board_id),
    )
end