ADRV9009功能描述

ADRV9009是一款高集成度射频（RF）、捷变收发器，提供双通道发射器和接收器、集成式频率合成器以及数字信号处理功能。这款IC具备多样化的高性能和低功耗组合，以满足3G、4G和5G宏蜂窝时分双工（TDD）基站应用要求。

应用

3G、4G和5G TDD宏蜂窝基站

TDD有源天线系统

大规模多路输入、多路输出（MIMO）

相控阵雷达

电子战

军事通信

便携测试设备

下面介绍ADI提供的adrv9009_API功能描述。源代码链接如下：https://github.com/analogdevicesinc/no-OS/blob/master/drivers/rf-transceiver/talise/api/talise_radioctrl.h

talise_radioctrl.h

1， uint32_t TALISE_loadStreamFromBinary（taliseDevice_t *device， uint8_t *binary）;描述：将二进制数组加载到流处理器数据内存中。限制：此函数在设备初始化并验证PLL锁定状态后调用。

2， uint32_t TALISE_setArmGpioPins（taliseDevice_t *device， taliseArmGpioConfig_t *armGpio）;描述：指示用于TDD引脚控制的GPIO引脚，此功能应在radio关闭状态下使用。限制：此函数可以在加载Talise ARM二进制文件后调用，但在初始化期间进入radioOn之前。

3， uint32_t TALISE_setRadioCtlPinMode（taliseDevice_t *device， uint8_t pinOptionsMask， taliseRadioCtlCfg2_t orxEnGpioPinSel）;描述：设置引脚模式控制的Tx、Rx和ORx 控制位掩码。此功能应在radio关闭状态下使用。限制：此函数可在设备在运行时操作期间的任何时候完全初始化后调用，但要在配置了ARM和GPIO之后。

4， uint32_t TALISE_getRadioCtlPinMode（taliseDevice_t *device， uint8_t *pinOptionsMask， taliseRadioCtlCfg2_t *orxEnGpioPinSel）;描述：读取引脚模式控制的Tx、Rx和ORx 控制位掩码。此功能应在radio关闭状态下使用。限制：此函数可在设备在运行时操作期间的任何时候完全初始化后调用，但要在配置了ARM和GPIO之后。

5，uint32_t TALISE_setOrxLoCfg（taliseDevice_t *device， const taliseOrxLoCfg_t *orxLoCfg）;描述：ORx LO（本机振荡器）源（RFPLL或AuxPLL）设置。限制：这个函数应该在加载ARM之后，但在运行初始化校准之前调用。AuxLO频率也必须在设置RFPLL频率后，但在初始CAL之前设置。此函数可以在ARM READY（init cals之前）或Radio off状态下调用。

6，uint32_t TALISE_getOrxLoCfg（taliseDevice_t *device， taliseOrxLoCfg_t *orxLoCfg）;描述： 读取ORx LO（本机振荡器）源（RFPLL或AuxPLL）设置。此函数可用于读回 TALISE_setOrxLoCfg（）函数设置的 ORx LO 配置。限制：在调用TALISE_setOrxLoCfg（）之后，可以随时调用此函数。此函数可以在ARM READY（init cals（初始化校准）之前）或Radio off状态下调用。

7，uint32_t TALISE_radioOn（taliseDevice_t *device）;描述：指示ARM处理器将无线电状态移到打开状态。当ARM处于无线电打开状态时，启用的Rx和Tx信号链将通电，ARM跟踪校准将开始。要将此状态退出到低功耗脱机状态，请调用TALISE_radioOff（）函数。限制：此函数在设备初始化完成、所有PLL配置并锁定、多芯片同步（MCS）完成、JESD204B链路配置并可运行之后调用。

8，uint32_t TALISE_radioOff（taliseDevice_t *device）;描述：指示ARM处理器将无线电状态移到关闭状态。当ARM从Radio On状态移动到Radio Off（Idle）时，ARM跟踪校准停止，TxEnable/RxEnable等GPIO控制引脚将被忽略。这还将保持接收和发送链的电源关闭，直到再次调用TALISE_radioOn（）函数。限制：这个函数可以在TALISE_radioOn被调用前的任何时间调用。

9，uint32_t TALISE_getRadioState（taliseDevice_t *device， uint32_t *radioStatus）;描述：读取当前ARM的无线电状态。目前，radioStatus只返回低8位的数据，但定义为32位状态字，以允许将来扩展位字段。限制：此函数可在设备完全初始化后随时调用。

10，uint32_t TALISE_setRxTxEnable（taliseDevice_t *device， taliseRxORxChannels_t rxOrxChannel， taliseTxChannels_t txChannel）;描述：此API将收发器中Rx/ORx/Tx信道设置启用或禁用。限制：此函数可在进入radioOn后调用。在radioOff期间，所有发射和接收链都被强制关闭。

11，uint32_t TALISE_getRxTxEnable（taliseDevice_t *device， taliseRxORxChannels_t *rxOrxChannel， taliseTxChannels_t *txChannel）;描述：这个API读回收发器中通电的Rx/ORx/Tx信道。限制：此函数可在进入radioOn后调用。在radioOff期间，所有发射和接收链都被强制关闭。

12，uint32_t TALISE_setTxToOrxMapping（taliseDevice_t *device， uint8_t txCalEnable， taliseTxToOrxMapping_t oRx1Map， taliseTxToOrxMapping_t oRx2Map）;描述：设置外部LOL初始化校准和跟踪校准的Tx到ORx外部信号路由。限制：此函数可在ARM初始化和加载后调用。但是，在初始化校准运行之前，因为这同时用于外部LOL初始化和跟踪校准。

13，uint32_t TALISE_setRfPllFrequency（taliseDevice_t *device， taliseRfPllName_t pllName， uint64_t rfPllLoFrequency_Hz）;描述：设置RF PLL本机振荡器（LO）频率（RF载波频率）。限制：此函数可以在ARM初始化后调用，并且设备必须处于radioOff状态。

14，uint32_t TALISE_getRfPllFrequency（taliseDevice_t *device， taliseRfPllName_t pllName， uint64_t *rfPllLoFrequency_Hz）;描述：获取PLL本机振荡器（LO）频率（RF载波频率）。此函数用于获取锁相环的当前频率。为期望的PLL频率传递一个taliserfllname_t枚举类型，以读取：RF_PLL、AUX_PLL或CLK_PLL。限制：此功能可在设备初始化和配置PLL后使用。对于AUX U PLL或RF U PLL，ARM固件也必须加载并运行以读取PLL频率。

15，uint32_t TALISE_getPllsLockStatus（taliseDevice_t *device， uint8_t *pllLockStatus）;描述：检查PLL是否锁定。此函数通过pllLockStatus指针返回Talise PLLs的状态。pllLockStatus下uint8 UT值的3个LSB代表CLK PLL、RF PLL和AUX PLL的锁定状态。限制：此函数可以在PLL配置和运行后的任何时候调用。

16，uint32_t TALISE_setRfPllLoopFilter（taliseDevice_t *device， uint16_t loopBandwidth_kHz， uint8_t stability）;描述：设置射频锁相环滤波器的配置。此函数已弃用，应改用TALISE_setPllLoopFilter，因为它允许设置RF或Aux PLL环路滤波器设置。限制：他的函数可以在ARM初始化后调用，并且设备必须处于radioOff状态。此功能后必须有TALISE_setRfPllFrequency函数，以便使用新配置设置RF PLL。

17，uint32_t TALISE_getRfPllLoopFilter（taliseDevice_t *device， uint16_t *loopBandwidth_kHz， uint8_t *stability）;描述：获取RF PLL环路滤波器的配置。此函数已弃用。应改用 TALISE_getPllLoopFilter，因为它允许读取RF或Aux PLL环路滤波器设置。限制：此功能可在设备初始化和配置RF_PLL后使用。ARM固件也必须加载并运行。

18，uint32_t TALISE_setPllLoopFilter（taliseDevice_t *device， taliseRfPllName_t pllName， uint16_t loopBandwidth_kHz， uint8_t stability）;描述：设置RFPLL或AuxPLL的环路滤波器带宽限制：此函数可以在ARM初始化后调用，并且设备必须处于radioOff状态。此功能之后必须为所选PLL设置TALISE_setRfPllFrequency函数，以使用新的环路滤波器设置设置PLL。

19， uint32_t TALISE_getPllLoopFilter（taliseDevice_t *device， taliseRfPllName_t pllName， uint16_t *loopBandwidth_kHz， uint8_t *stability）;描述：获取RFPLL或Aux PLL循环筛选器的循环筛选器设置。限制：该功能可在设备初始化并配置所需的锁相环后使用。ARM固件也必须加载并运行。

20，uint32_t TALISE_setOrxLoSource（taliseDevice_t *device， taliseObsRxLoSource_t orxLoSource）;描述：设置ORx LO（本机振荡器）源（RF PLL或Aux PLL）。注：此功能将ORx的本振源设置为RF PLL或Aux PLL，但在ORx上升沿接通ORx信道之前，该设置才生效。如果在ORx通电时改变LO源，则LO源在ORx被禁用并重新启用之前不会生效。这是有效的，当使用引脚设置本振源和控制时，也启用了ORx。限制：此函数可在设备完全初始化且初始化校准已运行后使用。这只能在radio Off状态下调用。

21，uint32_t TALISE_getOrxLoSource（taliseDevice_t *device， taliseObsRxLoSource_t *orx1LoSource， taliseObsRxLoSource_t *orx2LoSource）;描述：获取ORx LO（本机振荡器）源（RF PLL或Aux PLL）限制：此函数可在设备完全初始化且初始化CAL已运行后使用。这可以在radio Off 或 On 状态下调用。

22，uint32_t TALISE_setFhmConfig（taliseDevice_t *device， taliseFhmConfig_t *fhmConfig）;描述：此功能配置跳频触发GPIO输入到ARM和跳频范围。FHM触发器GPIO引脚、跳频最小频率和跳频最大频率由该功能配置。FHM（frequency hopping mode ，调频模式）。限制：此功能可在设备完全初始化和ARM处理器初始化后使用。此函数只能在radio Off状态下调用。

23，uint32_t TALISE_getFhmConfig（taliseDevice_t *device， taliseFhmConfig_t *fhmConfig）;描述：此函数用于检索当前FHM设置。FHM（frequency hopping mode ，调频模式）。此功能读回跳频触发GPIO引脚、跳频最小频率和跳频最大频率。限制：无。

24，uint32_t TALISE_setFhmMode（taliseDevice_t *device， taliseFhmMode_t *fhmMode）;描述：此功能设置跳频模式。限制：此函数可在设备完全初始化、ARM处理器初始化并调用TALISE_setFhmConfig（）之后使用。此函数只能在radio Off状态下调用。

25，uint32_t TALISE_getFhmMode（taliseDevice_t *device， taliseFhmMode_t *fhmMode）;描述：此函数用于检索跳频的当前FHM模式设置。此功能可用于读取当前FHM配置（FHM启用/禁用、MCS同步和退出模式设置的当前状态）。限制：无。

26，uint32_t TALISE_setFhmHop（taliseDevice_t *device， uint64_t nextRfPllFrequency_Hz）;描述：此函数设置下一个RF PLL低跳频率，并在非gpio模式下向ARM发送跳到下一个频率的命令。限制：此函数可在设备完全初始化、ARM处理器初始化、FHM配置通过TALISE_setFhmConfig（）API设置、FHM模式通过TALISE_setFhmMode（）API设置后调用。此API只能在Radio ON状态下调用。

27，uint32_t TALISE_getFhmRfPllFrequency（taliseDevice_t *device， uint64_t *fhmRfPllFrequency_Hz）;描述：此功能允许用户在跳频模式下读回当前射频锁相环频率。限制：无。

28，uint32_t TALISE_getFhmStatus（taliseDevice_t *device， taliseFhmStatus_t *fhmStatus）;描述：此函数返回当前FHM状态。此功能可用于读取当前FHM状态。状态字段的详细说明请参见taliseFhmStatus结构定义。限制：无。

29，uint32_t TALISE_setExtLoOutCfg（taliseDevice_t *device， uint8_t enableExtLoOutput， taliseExtLoDiv_t extLoOutDivide）;描述：此功能启用/禁用外部LO输出并设置外部LO输出分配器。限制：无。

30，uint32_t TALISE_getExtLoOutCfg（taliseDevice_t *device， uint8_t *enableExtLoOutput， taliseExtLoDiv_t *extLoOutDivide）;描述：此功能读回外部LO输出和外部LO输出分配器设置的启用状态。限制：无。

原文标题：ADRV9009_API功能描述

文章出处：【微信公众号：FPGA之家】欢迎添加关注！文章转载请注明出处。

审核编辑：彭静