no-OS
Functions
adf4382.c File Reference

Implementation of adf4382 Driver. More...

#include "adf4382.h"
#include "no_os_alloc.h"
#include "no_os_delay.h"
#include "no_os_error.h"
#include "no_os_print_log.h"
#include "no_os_util.h"
Include dependency graph for adf4382.c:

Functions

int adf4382_spi_write (struct adf4382_dev *dev, uint16_t reg_addr, uint8_t data)
 Writes data to ADF4382 over SPI. More...
 
int adf4382_spi_read (struct adf4382_dev *dev, uint16_t reg_addr, uint8_t *data)
 Reads data from ADF4382 over SPI. More...
 
int adf4382_spi_update_bits (struct adf4382_dev *dev, uint16_t reg_addr, uint8_t mask, uint8_t data)
 Updates the values of the ADF4382 register. More...
 
int adf4382_reg_dump (struct adf4382_dev *dev)
 Will output on the terminal the values of all the ADF4382 registers. More...
 
int adf4382_set_ref_clk (struct adf4382_dev *dev, uint64_t val)
 Set the desired reference frequency and reset everything over to maximum supported value of 5GHz to the max. value and everything under the minimum supported value of 10MHz to the min. value. More...
 
int adf4382_get_ref_clk (struct adf4382_dev *dev, uint64_t *val)
 Gets the user proposed reference frequency. More...
 
int adf4382_set_en_ref_doubler (struct adf4382_dev *dev, bool en)
 Set the reference doubler to enable or disable based on the passed parameter. If the parameter is different then 0 it will set the doubler to enable. More...
 
int adf4382_get_en_ref_doubler (struct adf4382_dev *dev, bool *en)
 Gets the value the doubler if it is enabled or disable and stores it it the dev structure. More...
 
int adf4382_set_ref_div (struct adf4382_dev *dev, int32_t div)
 Set the reference divider value and reset everything over to maximum supported value of 63 to the max. value. More...
 
int adf4382_get_ref_div (struct adf4382_dev *dev, int32_t *div)
 Gets the value the reference divider. More...
 
int adf4382_set_cp_i (struct adf4382_dev *dev, int32_t reg_val)
 Set the charge pump value which will be written to the register. The value will be between 0 and 15 on 8 bits. For more information please consult the Datasheet. More...
 
int adf4382_get_cp_i (struct adf4382_dev *dev, int32_t *reg_val)
 Gets the charge pump value from the register. The value will be between 0 and 15 on 8 bits. For more information please consult the Datasheet. More...
 
int adf4382_set_bleed_word (struct adf4382_dev *dev, int32_t word)
 Set the bleed word, which represents the value of the bleed current written to the register space. More...
 
int adf4382_get_bleed_word (struct adf4382_dev *dev, int32_t *word)
 Gets the value of the set bleed word. More...
 
int adf4382_set_out_power (struct adf4382_dev *dev, uint8_t ch, int32_t pwr)
 Set the output power register value of a channel and reset everything over to maximum supported value of 15 to the max. value. More...
 
int adf4382_get_out_power (struct adf4382_dev *dev, uint8_t ch, int32_t *pwr)
 Gets the output power register value. More...
 
int adf4382_set_en_chan (struct adf4382_dev *dev, uint8_t ch, bool en)
 Set the output channel to enable or disable based on the passed parameter. If the parameter is different then 0 it will set the doubler to enable. More...
 
int adf4382_get_en_chan (struct adf4382_dev *dev, uint8_t ch, bool *en)
 Gets the value the output channel if it is enabled or disable. More...
 
int adf4382_set_en_sync (struct adf4382_dev *dev, bool en)
 Set the sync to enable or disable based on the passed parameter. If the parameter is different then 0 it will set the doubler to enable. More...
 
int adf4382_get_en_sync (struct adf4382_dev *dev, bool *en)
 Gets the value the sync if it is enabled or disable. More...
 
int adf4382_set_rfout (struct adf4382_dev *dev, uint64_t val)
 Set the desired output frequency and reset everything over to maximum supported value of 22GHz (21GHz for ADF4382A) to the max. value and everything under the minimum supported value of 687.5MHz (2.875GHz for ADF4382A) to the min. value. More...
 
int adf4382_get_rfout (struct adf4382_dev *dev, uint64_t *val)
 Gets the user proposed output frequency. More...
 
int adf4382_set_freq (struct adf4382_dev *dev)
 Set the output frequency. More...
 
int adf4382_set_phase_adjust (struct adf4382_dev *dev, uint32_t phase_ps)
 Set the phase adjustment in pico-seconds. The phase adjust will enable the Bleed current option as well as delay mode to 0. More...
 
int adf4382_set_phase_pol (struct adf4382_dev *dev, bool polarity)
 Set the phase polarity. If pol = 0 then it will add the phase value otherwise it will subtract the phase value. More...
 
int adf4382_get_phase_pol (struct adf4382_dev *dev, bool *polarity)
 Gets the polarity of the phase adjust. More...
 
int adf4382_init (struct adf4382_dev **dev, struct adf4382_init_param *init_param)
 Initializes the ADF4382. More...
 
int adf4382_remove (struct adf4382_dev *dev)
 Free resources allocated for ADF4382. More...
 

Detailed Description

Implementation of adf4382 Driver.

Author
Ciprian Hegbeli (cipri.nosp@m.an.h.nosp@m.egbel.nosp@m.i@an.nosp@m.alog..nosp@m.com)

Copyright 2024(c) Analog Devices, Inc.

All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

THIS SOFTWARE IS PROVIDED BY ANALOG DEVICES "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ANALOG DEVICES BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, INTELLECTUAL PROPERTY RIGHTS, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Function Documentation

◆ adf4382_get_bleed_word()

int adf4382_get_bleed_word ( struct adf4382_dev dev,
int32_t *  word 
)

Gets the value of the set bleed word.

Parameters
dev- The device structure.
word- The read bleed current register value.
Returns
- Result of the reading procedure, error code otherwise.

◆ adf4382_get_cp_i()

int adf4382_get_cp_i ( struct adf4382_dev dev,
int32_t *  reg_val 
)

Gets the charge pump value from the register. The value will be between 0 and 15 on 8 bits. For more information please consult the Datasheet.

Parameters
dev- The device structure.
reg_val- The read charge pump register value.
Returns
- 0 in case of success or negative error code.

◆ adf4382_get_en_chan()

int adf4382_get_en_chan ( struct adf4382_dev dev,
uint8_t  ch,
bool en 
)

Gets the value the output channel if it is enabled or disable.

Parameters
dev- The device structure.
ch- The channel to get state.
en- The status of the output channel.
Returns
- 0 in case of success or negative error code.

◆ adf4382_get_en_ref_doubler()

int adf4382_get_en_ref_doubler ( struct adf4382_dev dev,
bool en 
)

Gets the value the doubler if it is enabled or disable and stores it it the dev structure.

Parameters
dev- The device structure.
en- The read value of the reference doubler.
Returns
- 0 in case of success or negative error code.

◆ adf4382_get_en_sync()

int adf4382_get_en_sync ( struct adf4382_dev dev,
bool en 
)

Gets the value the sync if it is enabled or disable.

Parameters
dev- The device structure.
en- The read status of the sync enable.
Returns
- 0 in case of success or negative error code.

◆ adf4382_get_out_power()

int adf4382_get_out_power ( struct adf4382_dev dev,
uint8_t  ch,
int32_t *  pwr 
)

Gets the output power register value.

Parameters
dev- The device structure.
ch- The channel to get the power off.
pwr- The output power register value.
Returns
- Result of the reading procedure, error code otherwise.

◆ adf4382_get_phase_pol()

int adf4382_get_phase_pol ( struct adf4382_dev dev,
bool polarity 
)

Gets the polarity of the phase adjust.

uint8_t pol;

Parameters
dev- The device structure.
polarity- The read polarity of the phase.
Returns
- Result of the tesint procedure, negative error code otherwise.

◆ adf4382_get_ref_clk()

int adf4382_get_ref_clk ( struct adf4382_dev dev,
uint64_t *  val 
)

Gets the user proposed reference frequency.

Parameters
dev- The device structure.
val- The set value of the reference frequency in Hz.
Returns
- Reference frequency in KHz.

◆ adf4382_get_ref_div()

int adf4382_get_ref_div ( struct adf4382_dev dev,
int32_t *  div 
)

Gets the value the reference divider.

Parameters
dev- The device structure.
div- The read reference divider value.
Returns
- Result of the reading procedure, error code otherwise.

◆ adf4382_get_rfout()

int adf4382_get_rfout ( struct adf4382_dev dev,
uint64_t *  val 
)

Gets the user proposed output frequency.

Parameters
dev- The device structure.
val- The set value of the output frequency in Hz.
Returns
- 0 in case of success or negative error code.

◆ adf4382_init()

int adf4382_init ( struct adf4382_dev **  dev,
struct adf4382_init_param init_param 
)

Initializes the ADF4382.

Parameters
dev- The device structure.
init_param- The structure containing the device initial parameters.
Returns
- 0 in case of success or negative error code.
Here is the caller graph for this function:

◆ adf4382_reg_dump()

int adf4382_reg_dump ( struct adf4382_dev dev)

Will output on the terminal the values of all the ADF4382 registers.

Parameters
dev- The device structure.
Returns
- 0 in case of success or negative error code.

◆ adf4382_remove()

int adf4382_remove ( struct adf4382_dev dev)

Free resources allocated for ADF4382.

Parameters
dev- The device structure.
Returns
- 0 in case of success or negative error code.
Here is the caller graph for this function:

◆ adf4382_set_bleed_word()

int adf4382_set_bleed_word ( struct adf4382_dev dev,
int32_t  word 
)

Set the bleed word, which represents the value of the bleed current written to the register space.

Parameters
dev- The device structure.
word- The bleed current register value.
Returns
- 0 in case of success or negative error code.

◆ adf4382_set_cp_i()

int adf4382_set_cp_i ( struct adf4382_dev dev,
int32_t  reg_val 
)

Set the charge pump value which will be written to the register. The value will be between 0 and 15 on 8 bits. For more information please consult the Datasheet.

Parameters
dev- The device structure.
reg_val- The desired charge pump register value.
Returns
- 0 in case of success or negative error code.

◆ adf4382_set_en_chan()

int adf4382_set_en_chan ( struct adf4382_dev dev,
uint8_t  ch,
bool  en 
)

Set the output channel to enable or disable based on the passed parameter. If the parameter is different then 0 it will set the doubler to enable.

Parameters
dev- The device structure.
ch- The channel to set state.
en- The enable or disable value of the output channel.
Returns
- Result of the writing procedure, error code otherwise.

◆ adf4382_set_en_ref_doubler()

int adf4382_set_en_ref_doubler ( struct adf4382_dev dev,
bool  en 
)

Set the reference doubler to enable or disable based on the passed parameter. If the parameter is different then 0 it will set the doubler to enable.

Parameters
dev- The device structure.
en- The enable or disable value of the reference doubler.
Returns
- 0 in case of success or negative error code.

◆ adf4382_set_en_sync()

int adf4382_set_en_sync ( struct adf4382_dev dev,
bool  en 
)

Set the sync to enable or disable based on the passed parameter. If the parameter is different then 0 it will set the doubler to enable.

Parameters
dev- The device structure.
en- The enable or disable sync.
Returns
- Result of the writing procedure, error code otherwise.

◆ adf4382_set_freq()

int adf4382_set_freq ( struct adf4382_dev dev)

Set the output frequency.

Parameters
dev- The device structure.
Returns
- 0 in case of success, negative error code otherwise.
Here is the caller graph for this function:

◆ adf4382_set_out_power()

int adf4382_set_out_power ( struct adf4382_dev dev,
uint8_t  ch,
int32_t  pwr 
)

Set the output power register value of a channel and reset everything over to maximum supported value of 15 to the max. value.

Parameters
dev- The device structure.
ch- The channel to set the power off.
pwr- The output power register value.
Returns
- Result of the writing procedure, error code otherwise.

◆ adf4382_set_phase_adjust()

int adf4382_set_phase_adjust ( struct adf4382_dev dev,
uint32_t  phase_ps 
)

Set the phase adjustment in pico-seconds. The phase adjust will enable the Bleed current option as well as delay mode to 0.

Parameters
dev- The device structure.
phase_ps- The phase adjustment in pico-seconds.
Returns
- 0 in case of success, negative error code otherwise.
Here is the caller graph for this function:

◆ adf4382_set_phase_pol()

int adf4382_set_phase_pol ( struct adf4382_dev dev,
bool  polarity 
)

Set the phase polarity. If pol = 0 then it will add the phase value otherwise it will subtract the phase value.

Parameters
dev- The device structure.
polarity- The polarity to be set.
Returns
- Result of the writing procedure, error code otherwise.

◆ adf4382_set_ref_clk()

int adf4382_set_ref_clk ( struct adf4382_dev dev,
uint64_t  val 
)

Set the desired reference frequency and reset everything over to maximum supported value of 5GHz to the max. value and everything under the minimum supported value of 10MHz to the min. value.

Parameters
dev- The device structure.
val- The desired reference frequency in Hz.
Returns
- 0 in case of success or negative error code.

◆ adf4382_set_ref_div()

int adf4382_set_ref_div ( struct adf4382_dev dev,
int32_t  div 
)

Set the reference divider value and reset everything over to maximum supported value of 63 to the max. value.

Parameters
dev- The device structure.
div- The reference divider value.
Returns
- 0 in case of success or negative error code.

◆ adf4382_set_rfout()

int adf4382_set_rfout ( struct adf4382_dev dev,
uint64_t  val 
)

Set the desired output frequency and reset everything over to maximum supported value of 22GHz (21GHz for ADF4382A) to the max. value and everything under the minimum supported value of 687.5MHz (2.875GHz for ADF4382A) to the min. value.

Parameters
dev- The device structure.
val- The desired output frequency in Hz.
Returns
- 0 in case of success or negative error code.
Here is the caller graph for this function:

◆ adf4382_spi_read()

int adf4382_spi_read ( struct adf4382_dev dev,
uint16_t  reg_addr,
uint8_t *  data 
)

Reads data from ADF4382 over SPI.

Parameters
dev- The device structure.
reg_addr- The register address.
data- Data read from the device.
Returns
- 0 in case of success or negative error code otherwise.
Here is the caller graph for this function:

◆ adf4382_spi_update_bits()

int adf4382_spi_update_bits ( struct adf4382_dev dev,
uint16_t  reg_addr,
uint8_t  mask,
uint8_t  data 
)

Updates the values of the ADF4382 register.

Parameters
dev- The device structure.
reg_addr- The register address.
mask- Bits to be updated.
data- Update value for the mask.
Returns
- 0 in case of success or negative error code otherwise.
Here is the caller graph for this function:

◆ adf4382_spi_write()

int adf4382_spi_write ( struct adf4382_dev dev,
uint16_t  reg_addr,
uint8_t  data 
)

Writes data to ADF4382 over SPI.

Parameters
dev- The device structure.
reg_addr- The register address.
data- Data value to write.
Returns
- 0 in case of success or negative error code otherwise.
Here is the caller graph for this function: