adp1055.c File Reference

Source file for the ADP1055 Driver. More...

#include "adp1055.h"
#include "no_os_error.h"
#include "no_os_util.h"
#include "no_os_alloc.h"
#include "no_os_delay.h"

Include dependency graph for adp1055.c:

Functions
int	adp1055_send_command (struct adp1055_desc *desc, uint16_t command)
	Send command byte/word to ADP1055.
int	adp1055_write (struct adp1055_desc *desc, uint16_t command, uint16_t data, uint8_t byte_num)
	Write data to ADP1055
int	adp1055_read (struct adp1055_desc *desc, uint16_t command, uint8_t *data, uint8_t byte_num)
	Read data from ADP1055.
int	adp1055_init (struct adp1055_desc **desc, struct adp1055_init_param *init_param)
	Initialize the ADP1055 device.
int	adp1055_remove (struct adp1055_desc *desc)
	Free the resources allocated by the adp1055_init()
int	adp1055_read_status (struct adp1055_desc *desc, enum adp1055_status_type status, uint16_t *status_val)
	Send statuses.
int	adp1055_read_value (struct adp1055_desc *desc, enum adp1055_value_type value, uint16_t *mant, uint8_t *exp)
	Read VIN/IIN/VOUT/TEMP2/TEMP3/DUTY_CYCLE_FREQ/POUT raw value from the ADP1055.
int	adp1055_read_vsense (struct adp1055_desc *desc, uint16_t *vsense)
	Read Voltage Sense output raw value from the ADP1055.
int	adp1055_vout_value (struct adp1055_desc *desc, uint16_t vout_command, uint16_t vout_max)
	Set VOUT_COMMAND and VOUT_MAX values.
int	adp1055_vout_offset (struct adp1055_desc *desc, int16_t vout_offset)
	Set output voltage offset.
int	adp1055_vout_tr (struct adp1055_desc *desc, uint8_t exp, uint16_t mant)
	Set ADP1055 VOUT transition rate.
int	adp1055_vout_droop (struct adp1055_desc *desc, uint8_t exp, uint16_t mant)
	Set ADP1055 Vout Droop.
int	adp1055_vout_scale_loop (struct adp1055_desc *desc, uint8_t exp, uint16_t mant)
	Set ADP1055 vout scale loop.
int	adp1055_vout_scale (struct adp1055_desc *desc, uint8_t exp, uint16_t mant)
	Set ADP1055 VOUT_SCALE_MONITOR.
int	adp1055_set_vin (struct adp1055_desc *desc, int16_t mant, int8_t exp, bool state_on)
	Set ADP1055 VIN on/off raw value for input voltage limiting.
int	adp1055_iout_cal_gain (struct adp1055_desc *desc, int16_t mant, int8_t exp)
	Set ADP1055 IOUT calibration gain.
int	adp1055_iout_cal_offset (struct adp1055_desc *desc, int16_t mant, int8_t exp)
	Set ADP1055 IOUT calibration offset.
int	adp1055_normal_mode_df (struct adp1055_desc *desc, uint8_t zero, uint8_t pole, uint8_t lf, uint8_t hf)
	Set ADP1055 Normal Mode Digital Filter.
int	adp1055_lightload_mode_df (struct adp1055_desc *desc, uint8_t zero, uint8_t pole, uint8_t lf, uint8_t hf)
	Set ADP1055 Light Load Mode Digital Filter.
int	adp1055_singleshot_mode_df (struct adp1055_desc *desc, uint8_t zero, uint8_t pole, uint8_t lf, uint8_t hf)
	Set ADP1055 Single Shot Digital Filter.
int	adp1055_pwm_config (struct adp1055_desc *desc, uint16_t pulse_width, uint16_t pulse_start, bool mod_en, bool mod_sign, enum adp1055_channel chan)
	PWM modulation configuration for the ADP1055.
int	adp1055_set_pwm (struct adp1055_desc *desc, enum adp1055_channel chan, int8_t exp, uint16_t mant)
	Set PWM channel and frequency.
int	adp1055_freq_sync (struct adp1055_desc *desc, bool pll, bool reso)
	Frequency synchronization of the PWM clock with an external clock Requires syni_desc to be initialized.

Detailed Description

Source file for the ADP1055 Driver.

Author

Ivangil Mercano (Ivang.nosp@m.il.m.nosp@m.ercan.nosp@m.o@an.nosp@m.alog..nosp@m.com)

Copyright 2025(c) Analog Devices, Inc.

SPDX-License-Identifier: BSD-3-Clause

Function Documentation

adp1055_freq_sync()

int adp1055_freq_sync	(	struct adp1055_desc *	desc,
		bool	pll,
		bool	reso )

Frequency synchronization of the PWM clock with an external clock Requires syni_desc to be initialized.

Parameters

desc	- ADP1055 device descriptor
pll	- pll disable and enable
reso	- 5ns resolution enable

Returns

0 in case of success, negative error otherwise

adp1055_init()

int adp1055_init	(	struct adp1055_desc **	desc,
		struct adp1055_init_param *	init_param )

Initialize the ADP1055 device.

Parameters

desc	- ADP1055 device descriptor
init_param	- Initialization parameter containing information about the ADP1055 device to be initialized.

Returns

0 in case of succes, negative error code otherwise

adp1055_iout_cal_gain()

int adp1055_iout_cal_gain	(	struct adp1055_desc *	desc,
		int16_t	mant,
		int8_t	exp )

Set ADP1055 IOUT calibration gain.

Parameters

desc	- ADP1055 deveice descriptor
mant	- Mantissa value to be transmitted, 11-bit twos compliment
exp	- Exponent value to be transmitted, 5-bit twos compliment

Returns

0 in case of success, negative error otherwise

adp1055_iout_cal_offset()

int adp1055_iout_cal_offset	(	struct adp1055_desc *	desc,
		int16_t	mant,
		int8_t	exp )

Set ADP1055 IOUT calibration offset.

Parameters

desc	- ADP1055 deveice descriptor
mant	- Mantissa value to be transmitted, 11-bit twos compliment
exp	- Exponent value to be transmitted, 5-bit twos compliment

Returns

0 in case of success, negative error otherwise

adp1055_lightload_mode_df()

int adp1055_lightload_mode_df	(	struct adp1055_desc *	desc,
		uint8_t	zero,
		uint8_t	pole,
		uint8_t	lf,
		uint8_t	hf )

Set ADP1055 Light Load Mode Digital Filter.

Parameters

desc	- ADP1055 device descriptor
zero	- light mode zero settings.
pole	- light mode pole settings.
lf	- light mode low filter gain settings.
hf	- light mode high filter gain settings.

Returns

0 in case of success, negative error otherwise

adp1055_normal_mode_df()

int adp1055_normal_mode_df	(	struct adp1055_desc *	desc,
		uint8_t	zero,
		uint8_t	pole,
		uint8_t	lf,
		uint8_t	hf )

Set ADP1055 Normal Mode Digital Filter.

Parameters

desc	- ADP1055 device descriptor
zero	- light mode zero settings.
pole	- light mode pole settings.
lf	- light mode low filter gain settings.
hf	- light mode high filter gain settings.

Returns

0 in case of success, negative error otherwise

adp1055_pwm_config()

int adp1055_pwm_config	(	struct adp1055_desc *	desc,
		uint16_t	pulse_width,
		uint16_t	pulse_start,
		bool	mod_en,
		bool	mod_sign,
		enum adp1055_channel	chan )

PWM modulation configuration for the ADP1055.

Parameters

desc	- ADP1055 device descriptor
pulse_width	- Width of the pulse wanted for the signal (used for calculation of the 12-bit rising and falling edge timings for the requested channels, it depends on each channel how the falling and rising edges are calculated using this value). Each LSB corresponds to a 5ns resolution.
pulse_start	- Start of the pulse wanted for the signal (used for calculation of the 12-bit rising and falling edge timings for the requested channels, it depends on each channel how the falling and rising edges are calculated using this value). Each LSB corresponds to a 5ns resolution.
mod_en	- boolian for modulation enable
mod_sign	- bolian for modulation sign
chan	- requested channel

Returns

0 in case of success, negative error otherwise

adp1055_read()

int adp1055_read	(	struct adp1055_desc *	desc,
		uint16_t	command,
		uint8_t *	data,
		uint8_t	byte_num )

Read data from ADP1055.

Parameters

desc	- ADP1055 device descriptor
command	- Command value
data	- Buffer with received data
byte_num	- Number of bytes of received data

Returns

0 if success, negative error otherwise

adp1055_read_status()

int adp1055_read_status	(	struct adp1055_desc *	desc,
		enum adp1055_status_type	status,
		uint16_t *	status_val )

Send statuses.

Parameters

desc	- ADP1055 device descriptor
status	- Status type
status_val	- Status value to be returned

Returns

0 in case of success, negative error otherwise

adp1055_read_value()

int adp1055_read_value	(	struct adp1055_desc *	desc,
		enum adp1055_value_type	value,
		uint16_t *	mant,
		uint8_t *	exp )

Read VIN/IIN/VOUT/TEMP2/TEMP3/DUTY_CYCLE_FREQ/POUT raw value from the ADP1055.

Parameters

desc	- AP1055 device descriptor
value	- value type
mant	- Raw mantissa value to be received
exp	- Raw exponent value to be received

Returns

0 in case of success, negative error otherwise

adp1055_read_vsense()

int adp1055_read_vsense	(	struct adp1055_desc *	desc,
		uint16_t *	vsense )

Read Voltage Sense output raw value from the ADP1055.

Parameters

desc	- ADP1055 device descriptor
vsense	- VS(VOUT) raw value to be received of the parallel circuit.

Returns

0 in case of succes, negative error code otherwise

adp1055_remove()

int adp1055_remove

(

struct adp1055_desc *

desc

)

Free the resources allocated by the adp1055_init()

Parameters

desc	- ADP1055 device descriptor

Returns

0 in case of success, negative error otherwise

adp1055_send_command()

int adp1055_send_command	(	struct adp1055_desc *	desc,
		uint16_t	command )

Send command byte/word to ADP1055.

Parameters

desc	- ADP1055 device descriptor
command	- Value of the command

Returns

0 in case of sucess, negative error code otherwise

adp1055_set_pwm()

int adp1055_set_pwm	(	struct adp1055_desc *	desc,
		enum adp1055_channel	chan,
		int8_t	exp,
		uint16_t	mant )

Set PWM channel and frequency.

Parameters

desc	- ADP1055 device descriptor
chan	- Selected channel
exp	- 5-bit twos compliment (-4 to 0)
mant	- 11-bit twos compliment

Returns

0 in case of success, negative error otherwise

adp1055_set_vin()

int adp1055_set_vin	(	struct adp1055_desc *	desc,
		int16_t	mant,
		int8_t	exp,
		bool	state_on )

Set ADP1055 VIN on/off raw value for input voltage limiting.

Parameters

desc	- ADP1055 device descriptor
mant	- Mantissa value to be transmitted, 11 bit twos complement.
exp	- Exponent value to be transmitted, 5 bit twos complement.
state_on	- true - Set VIN_ON. false - Set VIN_OFF.

Returns

0 in case of succes, negative error code otherwise

adp1055_singleshot_mode_df()

int adp1055_singleshot_mode_df	(	struct adp1055_desc *	desc,
		uint8_t	zero,
		uint8_t	pole,
		uint8_t	lf,
		uint8_t	hf )

Set ADP1055 Single Shot Digital Filter.

Parameters

desc	- ADP1055 device descriptor
zero	- light mode zero settings.
pole	- light mode pole settings.
lf	- light mode low filter gain settings.
hf	- light mode high filter gain settings.

Returns

0 in case of success, negative error otherwise

adp1055_vout_droop()

int adp1055_vout_droop	(	struct adp1055_desc *	desc,
		uint8_t	exp,
		uint16_t	mant )

Set ADP1055 Vout Droop.

Parameters

desc	- ADP1055 device descriptor
exp	- Exponent 5-bit two's compliment
mant	- Mantissa 11-bit two's compliment

Returns

0 in case of success, negative error code otherwise

adp1055_vout_offset()

int adp1055_vout_offset	(	struct adp1055_desc *	desc,
		int16_t	vout_offset )

Set output voltage offset.

Parameters

desc	- ADP1055 device descriptor
vout_offset	- VOUT offset value.

Returns

0 in case of succes, negative error code otherwise

adp1055_vout_scale()

int adp1055_vout_scale	(	struct adp1055_desc *	desc,
		uint8_t	exp,
		uint16_t	mant )

Set ADP1055 VOUT_SCALE_MONITOR.

Parameters

desc	- ADP1055 device descriptor
exp	- Exponent - 5-bit twos complement
mant	- Mantissa - 11-bit twos complement

Returns

0 in case of succes, negative error code otherwise

adp1055_vout_scale_loop()

int adp1055_vout_scale_loop	(	struct adp1055_desc *	desc,
		uint8_t	exp,
		uint16_t	mant )

Set ADP1055 vout scale loop.

Parameters

desc	- ADP1055 device descriptor
exp	- Exponent 5-bit two's compliment
mant	- Mantissa 11-bit two's compliment

Returns

0 in case of success, negative error code otherwise

adp1055_vout_tr()

int adp1055_vout_tr	(	struct adp1055_desc *	desc,
		uint8_t	exp,
		uint16_t	mant )

Set ADP1055 VOUT transition rate.

Parameters

desc	- ADP1055 device descriptor
exp	- Exponent - 5-bit twos complement
mant	- Mantissa - 11-bit twos complement

Returns

0 in case of succes, negative error code otherwise

adp1055_vout_value()

int adp1055_vout_value	(	struct adp1055_desc *	desc,
		uint16_t	vout_command,
		uint16_t	vout_max )

Set VOUT_COMMAND and VOUT_MAX values.

Parameters

desc	- ADP1055 descriptor
vout_command	- VOUT_COMMAND value
vout_max	- VOUT_MAX value

Returns

0 in case of success, negative error code otherwise

adp1055_write()

int adp1055_write	(	struct adp1055_desc *	desc,
		uint16_t	command,
		uint16_t	data,
		uint8_t	byte_num )

• Write data to ADP1055

Parameters

desc	- ADP1055 device structure
command	- Command value
data	- Data value to write in ADP1055
byte_num	- Number of bytes to write.

Returns

0 in case of success, negative error code otherwise