节奏SDR卡的软件管理
本页介绍软件管理功能。 工程师。目标。RITM_API。特别提款权:类型 董事会;董事会 及用于管理和读取参数的方法。 在文章中给出了环境的制备和组分的相互作用方案。 节奏SDR卡管理 AnyMath.
|
使用软件控制功能
将示例中的名称和IP地址替换为您自己的计算机的值,或使用已注册的计算机。 个别方法的例子表明, |
类型和方法 特别提款权
| 团体 | 类型和方法 |
|---|---|
配置 |
|
检测和状态 |
|
初始化 |
|
频率和FHM |
|
同步化 |
|
无线电路径和校准 |
|
TX和RX |
|
DDS |
|
JESD |
|
-
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getDdsFrequency -
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getSlaveFallback -
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getSyncTopology -
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getTxAttenuation -
Main.EngeeDeviceManager.Targets.RITM_API.SDR.setTxAttenuation
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.BoardConfig — Method
SDR.BoardConfig(;
id,
frequency_hz,
fhm_min_mhz=nothing,
fhm_max_mhz=nothing,
topology="internal",
)
单块SDR板的配置类型。
命名参数
-
id::Int:SDR板的标识符。 -
frequency_hz::Int:初始载波频率,赫兹。 -
fhm_min_mhz::Union{Nothing,Int}=nothing:FHM下限,兆赫。 默认值为nothing。 -
fhm_max_mhz::Union{Nothing,Int}=nothing:FHM 上限,MHz。默认值为nothing。这两个边界
nothing均指定固定频率。对于 FHM,请指定两个边界;起始载波必须位于所选频段内。 对于 RFMC9000,请使用fhm_min_mhz < fhm_max_mhz设置正边界。驱动程序还会额外检查频段与收发器配置文件的兼容性。 -
topology::String="internal":同步拓扑,可设置为"internal"(默认)、"master"或"slave"。"internal"指定内部同步,"master"代表主板,"slave"代表从板。对于通用同步,请通过单次调用
initialize传递主从配置。
返回值
用于传递至initialize 的BoardConfig 对象。创建该对象时不会访问控制板。拓扑检查和 FHM 边界联合设置将在初始化命令准备过程中执行。
示例
config = SDR.BoardConfig(
id=board,
frequency_hz=300_000_000,
fhm_min_mhz=300,
fhm_max_mhz=5500,
topology="internal",
)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.calibrate — Method
SDR.calibrate(ritm, board::Integer; channel::Integer=0)
对已初始化的电路板执行发射链路校准。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:电路板标识符。
命名参数
-
channel::Integer=0:TX通道,0(默认)或1。
返回值
字典success/msg :
-
"success":操作成功时返回true,发生错误时返回false。 -
"msg":成功时返回nothing,出错时返回原因说明。
特性
在 RFMC9000 中,两个发射通道的校准是通用的,与传输的值无关channel 。成功时,当前驱动程序会保持 RF 处于开启状态。 不会恢复之前的 RF 状态。不会自动查询完整状态。
示例
try
result = SDR.calibrate(ritm, board; channel=0)
result["success"] || error(string(result["msg"]))
finally
result = SDR.radioOff(ritm, board)
result["success"] || error(string(result["msg"]))
end
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.deinitialize — Method
SDR.deinitialize(ritm, board::Integer)
SDR.deinitialize(ritm, boards::AbstractVector{<:Integer})
停止单个或多个电路板的工作,关闭无线电通路并执行设备去初始化。对于已去初始化的电路板,不会再次执行硬件停止操作。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:单块电路板的标识符。 -
boards::AbstractVector{<:Integer}:非空的标识符数组。
返回值
字典success/msg :
-
"success":操作成功时返回true,出错时返回false。 -
"msg":操作成功时返回nothing,出错时返回原因描述。
如果批量调用发生错误,请单独检查各电路板的状态:该结果并非每块电路板的停机报告。
示例
result = SDR.deinitialize(ritm, board)
result["success"] || error(string(result["msg"]))
# 替代的群组调用:
# result =SDR.deinitialize(ritm, [0, 1])
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getDdsChannel — Method
SDR.getDdsChannel(ritm, board::Integer)
从驱动程序缓存中读取最近使用的 DDS 索引。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:已初始化板的标识符。
返回值
整数 — DDS 索引。该方法不会切换振荡器,也不会返回所有已配置振荡器的列表。
示例
dds_channel = SDR.getDdsChannel(ritm, board)
println(dds_channel)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getDdsFrequency — Method
SDR.getDdsFrequency(ritm, board::Integer)
从驱动程序缓存中读取上次应用的 DDS 配置的频率。
参数
-
ritm:来自设备存储库的 RITM 设备名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。
返回值
整数----DDS频率(单位:赫兹)。这是存储的参数,而非读取所有组件的寄存器值,也不是对输出频率的测量。
示例
dds_frequency_hz = SDR.getDdsFrequency(ritm, board)
println(dds_frequency_hz)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getDdsScale — Method
SDR.getDdsScale(ritm, board::Integer)
从驱动程序缓存中读取上次应用的DDS设置的量程。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:已初始化板的标识符。
返回值
整数----以百万分之一为单位的量程。值1_000_000 对应于数字表示形式的振幅1.0 ; 无法直接由此确定 RF 信号的功率。
示例
dds_scale = SDR.getDdsScale(ritm, board)
println("Относительный масштаб: ", dds_scale / 1_000_000)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getFhmMaxMhz — Method
SDR.getFhmMaxMhz(ritm, board::Integer)
读取 FHM 范围的上限。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或RITM_API.Ritm描述符。 -
board::Integer:板卡标识符。
返回值
整数----以 MHz 为单位的上限。FHM 的活动状态需通过isFhmEnabled 单独验证。
示例
max_mhz = SDR.getFhmMaxMhz(ritm, board)
println("Верхняя граница: ", max_mhz, " МГц")
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getFhmMinMhz — Method
SDR.getFhmMinMhz(ritm, board::Integer)
读取 FHM 范围的下限。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:板卡标识符。
返回值
整数----下限(单位:MHz)。请与isFhmEnabled 配合使用:仅保存的阈值本身并不能证明 FHM 处于活动状态。
示例
min_mhz = SDR.getFhmMinMhz(ritm, board)
println("Нижняя граница: ", min_mhz, " МГц")
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getFrequency — Method
SDR.getFrequency(ritm, board::Integer)
读取驱动程序提供的载波值。
参数
-
ritm:来自机器库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:电路板标识符。
返回值
整数----频率(单位:赫兹)。该值并非射频输出信号频率的测量值。
示例
frequency_hz = SDR.getFrequency(ritm, board)
println("Несущая: ", frequency_hz / 1_000_000, " МГц")
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getJesdGood — Method
SDR.getJesdGood(ritm, board::Integer)
读取JESD数字线路的汇总健康状态。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:已初始化电路板的标识符。
返回值
Bool 。在当前驱动程序中,true 要求RX、TX和observation RX(观察接收器)这三条线路的状态为DATA 。该值描述了FPGA与收发器之间的数字线路。 该值并不表示存在有效的射频(RF)信号,也不表示多块板卡之间的信号具有相位相干性。
示例
jesd_good = SDR.getJesdGood(ritm, board)
println("JESD: ", jesd_good)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getJesdRx — Method
SDR.getJesdRx(ritm, board::Integer)
读取JESD接收数字总线的状态以及驱动程序的初始诊断信息。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。
返回值
单条线路的状态字典:
| 字段 | 值 |
|---|---|
|
|
|
|
|
状态字符串,或 |
|
诊断原始文本 |
示例
rx = SDR.getJesdRx(ritm, board)
println("Состояние RX JESD: ", rx["state"])
println(rx["raw"])
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getJesdRxOs — Method
SDR.getJesdRxOs(ritm, board::Integer)
读取观察接收器(observation RX)的 JESD 总线状态及驱动程序诊断信息。
参数
-
ritm:来自机器库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。
返回值
包含"enabled" 、"good" 、"state" 、"raw" 的词典,格式为 getJesdRx。
示例
rx_os = SDR.getJesdRxOs(ritm, board)
println("Observation RX JESD: ", rx_os["state"])
println(rx_os["raw"])
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getJesdTx — Method
SDR.getJesdTx(ritm, board::Integer)
读取 JESD 数字传输线路的状态及驱动程序诊断信息。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或RITM_API.Ritm描述符。 -
board::Integer:已初始化板的标识符。
返回值
包含"enabled" 、"good" 、"state" 、"raw" 的词典,采用 getJesdRx 格式。
示例
tx = SDR.getJesdTx(ritm, board)
println("Состояние TX JESD: ", tx["state"])
println(tx["raw"])
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getRxGain — Method
SDR.getRxGain(ritm, board::Integer, channel::Integer)
读取单个接收通道的增益表索引。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。 -
channel::Integer:RX通道,0或1。
返回值
整数----增益表的索引。该值不以分贝(dB)为单位。 如果驱动程序无法读取该参数(包括射频关闭时),该方法将抛出异常。若要获取包含readback_error 字段的完整状态,请使用getStatus 。
示例
gain_index = SDR.getRxGain(ritm, board, 0)
println("Индекс усиления RX0: ", gain_index)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getRxMode — Method
getRxMode(name, board::Integer)
Read the configured receive path without changing RF state.
-
name: RITM machine name, its saved IP/URL, or aRITM_API.Ritmhandle. -
board::Integer: SDR board ID, as returned bylistBoards.
The receive mode string: "rx", "orx1", or "orx2". Failed reads raise an exception.
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getSlaveFallback — Method
SDR.getSlaveFallback(ritm, board::Integer)
读取从属板切换至本地基准源的权限。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:电表标识符。
返回值
Bool :true ,如果允许fallback。 该方法返回配置信息,而非过渡是否实际触发的状态。该API中没有单独用于读取实际同步源的方法。
示例
fallback_allowed = SDR.getSlaveFallback(ritm, board)
println("Локальная опора разрешена: ", fallback_allowed)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getStatus — Method
SDR.getStatus(ritm, board::Integer)
读取单块电路板的完整状态。这是唯一一个用于查询完整状态的高级方法; 它不包含 RF。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:电路板标识符。
返回值
板卡状态字典:
| 字段 | 内容 |
|---|---|
|
板卡标识符 |
|
设备类型,当前值 |
|
初始化标志 |
|
驱动程序提供的载波值,Hz |
|
包含 |
|
包含 |
|
初始化时的MCS信息或 |
|
包含 |
|
RX信道状态数组 |
|
TX信道状态数组 |
|
包含 |
对于未初始化的板卡,mcs 、jesd 、dds 的值均为nothing ,而rx 和tx 为空数组。保存了频率或同步参数并不意味着设备已就绪:请检查initialized 。
rx 元素包含"channel" 、"gain_index" 、"readback_error" 。tx 元素包含"channel" 、"attenuation_mdb" 、"readback_error" 。如果读数不可用,则值为nothing ,且readback_error 包含诊断字符串。读取其他必填字段时发生错误可能会导致整个请求因异常而终止。
对于已初始化的电路板,mcs 包含"source" => "driver_initialization" 和"status_available" => false 。这是MCS执行位置的描述,而非相位同步检查的结果。
内部同步设置ibert_prbs_window_ms 、resync_sysref 、jesd_lmfc_offset 和lmk_sysref_delay 会被Julia封装层从结果中移除。 单条JESD总线的状态结构如getJesdRx 所示。DDS包含最近一次应用的设置缓存。
示例
state = SDR.getStatus(ritm, board)
println("Инициализирована: ", state["initialized"])
println("Топология: ", state["sync"]["topology"])
for rx in state["rx"]
if isnothing(rx["gain_index"])
println("RX", rx["channel"], ": ", rx["readback_error"])
else
println("RX", rx["channel"], ": индекс ", rx["gain_index"])
end
end
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getSyncTopology — Method
SDR.getSyncTopology(ritm, board::Integer)
读取已配置的同步拓扑。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:板卡标识符。
返回值
由驱动程序提供的字符串"internal" 、"master" 或"slave" 。它反映了拓扑配置。对于从属板,值"slave" 并不意味着在可能的降级后,该板实际由外部基准电压供电。
示例
topology = SDR.getSyncTopology(ritm, board)
println(topology)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.getTxAttenuation — Method
SDR.getTxAttenuation(ritm, board::Integer, channel::Integer)
读取单个发射通道的衰减值。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。 -
channel::Integer: TX通道,0或1。
返回值
整数----以毫分贝为单位的衰减量。如果无法进行硬件读取,该方法将抛出异常;读取时的RF不会自动启用。
示例
attenuation_mdb = SDR.getTxAttenuation(ritm, board, 1)
println("Затухание TX1: ", attenuation_mdb / 1000, " дБ")
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.initialize — Method
SDR.initialize(ritm, config::BoardConfig; slave_fallback::Bool=true)
SDR.initialize(ritm, configs::AbstractVector{BoardConfig}; slave_fallback::Bool=true)
通过一次函数调用初始化单块或一组电路板。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
config::BoardConfig:单块电路板的配置。 -
configs::AbstractVector{BoardConfig}:非空的配置数组。
命名参数
-
slave_fallback::Bool=true:允许从属板在未捕获外部基准信号时切换至本地基准源。当false时,不允许此类切换。该参数对整个调用有效。
返回值
字典success/msg:
-
"success":true(成功时),false(操作出错时)。 -
"msg":nothing(成功时),错误原因说明(出错时)。
的特性
FHM模式通过在每块板的BoardConfig 中设置边界来单独指定。MCS同步在初始化过程中自动执行。
应用配置前,所选电路板将被取消初始化。该批量操作并非原子操作。若发生错误,系统将尝试停止本次调用中已初始化的电路板,但无法保证恢复所有先前设置。 发生错误后,请读取每块受影响电路板的状态。
RFMC9000 初始化成功后,RF 将保持开启状态。
示例
config = SDR.BoardConfig(id=board, frequency_hz=300_000_000)
result = SDR.initialize(ritm, config)
result["success"] || error(string(result["msg"]))
result = SDR.radioOff(ritm, board)
result["success"] || error(string(result["msg"]))
批量操作;请将标识符替换为listBoards 中的值:
configs = [
SDR.BoardConfig(id=0, frequency_hz=300_000_000, topology="master"),
SDR.BoardConfig(id=1, frequency_hz=300_000_000, topology="slave"),
]
result = SDR.initialize(ritm, configs; slave_fallback=false)
result["success"] || error(string(result["msg"]))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.isFhmEnabled — Method
SDR.isFhmEnabled(ritm, board::Integer)
读取FHM模式初始化标志。
参数
-
ritm: 来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或描述符RITM_API.Ritm。 -
board::Integer:电路板标识符。
返回值
Bool :FHM 模式是否启用。对于未初始化的电路板,返回false 。值true 并不意味着频率会自动变化;软件调谐需通过setFrequency 方法执行。
示例
println("FHM: ", SDR.isFhmEnabled(ritm, board))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.isInitialized — Method
SDR.isInitialized(ritm, board::Integer)
读取板卡初始化标志。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:板卡标识符。
返回值
Bool :若板卡已初始化,则返回true ;否则返回false 。该标志不指示RF当前是否处于启用状态。
示例
initialized = SDR.isInitialized(ritm, board)
println(initialized)
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.listBoards — Method
SDR.listBoards(ritm)
返回检测到的 SDR 板卡列表。无需初始化设备。
参数
-
ritm:来自设备库的RITM设备名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。
返回值
包含字段"id" 和"device" 的字典数组。对于受支持的电路板,"device" 的值为"rfmc9000" 。如果不存在受支持的电路板,则数组为空。
示例
boards = SDR.listBoards(ritm)
for descriptor in boards
println("Плата ", descriptor["id"], ": ", descriptor["device"])
end
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.radioOff — Method
SDR.radioOff(ritm, board::Integer)
关闭射频链路。等同于setRadioState(ritm, board, false) 。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:已初始化电路板的标识符。
返回值
词典success/msg:
-
"success":true(成功时),false(操作出错时)。 -
"msg":nothing(成功时),错误原因描述(出错时)。
示例
result = SDR.radioOff(ritm, board)
result["success"] || error(string(result["msg"]))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.radioOn — Method
SDR.radioOn(ritm, board::Integer)
启用无线电链路。等同于setRadioState(ritm, board, true) 。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也可接受已保存的IP地址/URL或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。
返回值
词典success/msg:
-
"success":true(成功时),false(操作出错时)。 -
"msg":nothing(成功时),错误原因描述(出错时)。
示例
# RF-连接和板卡参数已预先准备就绪。
result = SDR.radioOn(ritm, board)
result["success"] || error(string(result["msg"]))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.setDds — Method
SDR.setDds(
ritm, board::Integer, channel::Integer, frequency_hz::Integer, scale::Integer,
)
根据低级索引配置一个 DDS 数字信号发生器。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。 -
channel::Integer:DDS 索引,范围从0到3。 -
frequency_hz::Integer: DDS频率(单位:赫兹),取整数值,范围从0到4_294_967_295(含)。选择工作频率时,请综合考虑采样率和设备配置。 -
scale::Integer: 缩放比例(单位:百万分之一),范围从0到1_999_000;50_000对应0.05,1_000_000对应1.0。
返回值
词典success/msg :
-
"success":true(操作成功时),false(操作出错时)。 -
"msg":nothing(操作成功时),错误原因说明(出错时)。
特性
RFMC9000 具有两个射频发射通道。DDS 索引并非射频发射器的编号。当前接口并未提供与0…3 中的组件TX1 I 、TX1 Q 、TX2 I 、TX2 Q 之间的唯一对应关系; 要配置特定的 I/Q 通道,需要考虑驱动程序和 FPGA 固件中的 DDS 实现。载波通过BoardConfig 或setFrequency 设置,与 DDS 频率分开。
该方法将频率和比例应用于所选的振荡器。后续的getDdsChannel 、getDdsFrequency 、getDdsScale 会读取该最新设置的缓存;它们不会检查所有组件的寄存器或信号波形。
示例
result = SDR.setDds(ritm, board, 0, 20_000_000, 50_000)
result["success"] || error(string(result["msg"]))
println("Индекс DDS: ", SDR.getDdsChannel(ritm, board))
println("Частота, Гц: ", SDR.getDdsFrequency(ritm, board))
println("Масштаб: ", SDR.getDdsScale(ritm, board))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.setFrequency — Method
SDR.setFrequency(ritm, board::Integer, frequency_hz::Integer)
更改在启用 FHM 状态下初始化的基板。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:电路板标识符。 -
frequency_hz::Integer:新的正频率(单位:赫兹),需在已配置的FHM范围内。
返回值
词典success/msg :
-
"success":成功时返回true,操作出错时返回false。 -
"msg":成功时返回nothing,出错时返回原因说明。
特性说明
该方法不适用于固定频率的板卡。此类频率的修改需通过initialize 并使用新的BoardConfig 参数进行。该方法不会返回实际设置的频率;请使用getFrequency 。
示例
# 该板已使用FHM 进行初始化,其中包含400 MHz。
result = SDR.setFrequency(ritm, board, 400_000_000)
result["success"] || error(string(result["msg"]))
println(SDR.getFrequency(ritm, board))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.setRadioState — Method
SDR.setRadioState(ritm, board::Integer, enabled::Bool)
启用或禁用已初始化板的射频通道。
参数
-
ritm:来自机器存储库的 RITM 机器名称(例如,"RITM 1");也接受已保存的 IP 地址/URL 或描述符RITM_API.Ritm。 -
board::Integer:电路板标识符。 -
enabled::Bool:true用于启用,false用于禁用。false的值用于保存板卡的初始化状态。要结束操作,请使用deinitialize。参数enabled需要Bool:请传入true或false,而非1或0。驱动程序中没有单独的RF状态读取函数。
返回值
词典success/msg:
-
"success":true(成功时),false(操作出错时)。 -
"msg":nothing(成功时),错误原因描述(出错时)。
示例
result = SDR.setRadioState(ritm, board, false)
result["success"] || error(string(result["msg"]))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.setRxGain — Method
SDR.setRxGain(ritm, board::Integer, channel::Integer, index::Integer)
设置接收通道增益表的索引。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或描述符RITM_API.Ritm。 -
board::Integer:已初始化电路板的标识符。 -
channel::Integer:RX通道,0或1。 -
index::Integer:增益表索引,范围为0至255的整数,需符合所用增益表及驱动程序模式的限制。
返回值
字典success/msg :
-
"success":成功时返回true,操作出错时返回false。 -
"msg":成功时返回nothing,出错时返回原因说明。
特性说明
参数index 不指定以 dB 为单位的增益。索引与增益的对应关系由收发器表决定;应用是否成功取决于驱动程序。读取时请使用getRxGain 。
示例
result = SDR.setRxGain(ritm, board, 0, 255)
result["success"] || error(string(result["msg"]))
#
Main.EngeeDeviceManager.Targets.RITM_API.SDR.setTxAttenuation — Method
SDR.setTxAttenuation(
ritm, board::Integer, channel::Integer, attenuation_mdb::Integer,
)
设置传输通道的衰减。
参数
-
ritm:来自机器存储库的RITM机器名称(例如,"RITM 1");也接受已保存的IP地址/URL或RITM_API.Ritm描述符。 -
board::Integer:已初始化电路板的标识符。 -
channel::Integer: TX通道,0或1。 -
attenuation_mdb::Integer: 以毫分贝为单位的衰减值,范围从0到41_950(含)。
返回值
字典success/msg:
-
"success": 操作成功时返回true,操作出错时返回false。 -
"msg":成功时返回nothing,错误时返回原因描述。
特性
RFMC9000 驱动程序安装后会启动常规 TX 校准;若校准成功,RF 将保持开启状态。 衰减量可按收发器配置文件中设定的步长进行量化。请通过getTxAttenuation 读取实际值。
示例
try
result = SDR.setTxAttenuation(ritm, board, 1, 32_000) # 32 dB
result["success"] || error(string(result["msg"]))
println(SDR.getTxAttenuation(ritm, board, 1))
finally
result = SDR.radioOff(ritm, board)
result["success"] || error(string(result["msg"]))
end
一般呼叫规则
-
ritm::字符串-注册车辆的名称(例如"RITM1"),其保存的IP地址或完整的URL。 名称和IP地址必须添加到 AnyMath ;完整的URL可以直接传递。 -
板::整数-身份证列表板,而不是Julia数组索引。 *TX和RX通道从头开始编号:0和1. *DDS生成器的索引:从0以前3. *载波和DDS频率以Hz为单位传输;FHM边界以MHz为单位。 *TX衰减以毫米波传输:1000回应1分贝。 *RX增益由表的索引设置,而不是由dB值设置。 *DDS规模以百万分之一为单位:1_000_000回应1.0.
给出的数值限制适用于DA-AX-FMC-RF9。 如果该值落在可接受的范围内,则不保证该设置对于特定收发器配置文件和采样率的适用性。
类型的方法的参数中 整数 你不能用 布尔 而不是数字:软件控件拒绝此值。 在执行操作时,附加地检查用于设备的配置的有效性。
操作更改的结果
方法 初始化, 去初始化, 设定频率, 校准, [医]固定剂, 无线电, 无线电波, n.定居,定居, n.集束,集束 和 setDds,setDds 他们回来了 Dict,Dict{String,Any} 有两个字段:
| 领域 | 意义 |
|---|---|
|
|
|
|
每个电话都必须检查:
result = SDR.radioOff(ritm, board)
result["success"] || error(string(result["msg"]))
成功响应不包含完整状态和实际应用的参数值。 要检查,请使用单独的读取功能或 [医]盖斯特斯.
Julia类型和参数错误、RPC/HTTP故障以及不正确的响应结构都可能导致异常。 所述操作还可以在错误或超时之前部分地改变设备的状态。 重复之前,读取受影响板的状态;程序控制中没有自动重复。
读取操作的结果
Read方法直接返回请求的值,一个字典或一个字典数组。 如果请求失败,他们会抛出异常。 读取功能不包括无线电跟踪-参数可以在任何时候读取.
方法 [医]盖斯特斯 申报表 什么都没有 对于不可访问的硬件读数,并保存读取错误的诊断。 如果无法读取值,则用于读取此类参数的单个函数以异常结束。
初始化前可用 isInitialized, [医]频率, [医]手持式, getFhmMinMhz的, getFhmMaxMhz的, [医]表面学 和 返回;返回. 他们阅读标志并保存设置。 单独的JESD、DDS、RX增益和TX衰减功能需要一个初始化板。
这些方法通过以下方式输出额外的诊断消息 @警告.