Api Execution Timing - Analog Devices ADRV9001 User Manual

Reference Manual
MICROPROCESSOR AND SYSTEM CONTROL
Figure 81 shows the channel enable signal and its corresponding active output timing on DGPIO. The DGPIO high indicates the start of the
channel AFE fully on up to the end of the channel AFE fully off. If the EnaRise2AnaOn is set to 0, the time from CH_ENABLE rising edge to
DGPIO rising edge is the "enableSetupDelay." Similarly, if set EnaFall2Off to 0, the time from CH_ENABLE falling edge to DGPIO falling edge is
the time taken for the ADRV9001 to fully power down the AFE.
Enable this stream status to GPIO debug function by API adi_adrv9001_Stream_C0_Gpio_Debug_Set() in the chip "Standby" or "Calibrated"
state. The RX1_ENABLE output status is mapped to DPGIO_0, TX1_ENABLE output status to DGPIO_1, RX2_ENABLE output status to
DGPIO_2 and TX2_ENABLE output status to DGPIO_3. There are no options to configure these DGPIOs mapping, and once the debug
function is enabled, the DGPIO_0~DPGIO_3 is not available for other functions, no matter how many channels are configured in the profile.
Analog Devices recommends this debug function to measure the transmitter/receiver ENABLE timing for a given profile, and disable this
function to release the DGPIOs usage once measuring is done.

API EXECUTION TIMING

The ADRV9001 APIs have several categories in how they interact between the BBIC and the ADRV9001. Most APIs communicate with the
ADRV9001 through the mailbox, where the ADRV9001 ARM processor schedules tasks. These mailbox type APIs are usually not time critical
and can take tens of microseconds up to several milliseconds, depending on the real-time operating system (RTOS) task status. There are
also time-sensitive APIs that use faster methods of communication, either with higher priority in the mailbox or through software interrupt. Some
APIs do not communicate with the ARM processor and instead directly read or write to SPI registers on the ADRV9001.
these API categories. All APIs have the category type listed in their source code. For the timing of API execution, see the
section.
Table 36. API Timing Categories
API Category
Direct
Mailbox
Priority Mailbox
Fast Messaging
Interrupt
analog.com
Description
Direct ADRV9001 register access: API calls that bypass the ADRV9001 processor and directly write or read SPI
registers.
ADRV9001 mailbox commands: API calls that communicate through normal mailbox commands to the ADRV9001
on-board processor.
High-priority ADRV9001 mailbox commands: API calls that communicate through high-priority mailbox commands
to the ADRV9001 on-board processor.
Fast-messaging: API calls that communicate through fast message to the ADRV9001 on-board processor for more
deterministic timing.
Software interrupt: API calls that communicate through software interrupt to the ADRV9001 on-board processor.
ADRV9001
Table 36 further details
Measurement Method
Rev. 0 | 92 of 351