Implementation of LTC3220 Driver. More...

#include <errno.h>
#include <stdlib.h>
#include <stdint.h>
#include <stdbool.h>
#include "ltc3220.h"
#include "no_os_i2c.h"
#include "no_os_util.h"
#include "no_os_delay.h"

Include dependency graph for ltc3220.c:

Functions
int	ltc3220_init (struct ltc3220_dev **device, struct ltc3220_init_param init_param)
	Initializes the LTC3220 device structure.

int	ltc3220_remove (struct ltc3220_dev *device)
	Deallocates the resources for the device structure.

int	ltc3220_reset (struct ltc3220_dev *device)
	Resets the device using the RST pin.

int	ltc3220_reg_write (struct ltc3220_dev *device, uint8_t reg_addr, uint8_t reg_data)
	Writes to the selected register on the device.

int	ltc3220_set_uled_mode (struct ltc3220_dev *device, uint8_t uled_number, enum ltc3220_uled_mode mode)
	Sets the selected ULED register's operating mode.

int	ltc3220_set_uled_current (struct ltc3220_dev *device, uint8_t uled_number, uint8_t current_level)
	Sets the selected ULED register's current strength.

int	ltc3220_update_reg_uled (struct ltc3220_dev *device, uint8_t uled_number, enum ltc3220_uled_mode mode, uint8_t current_level)
	Updates the configuration set on the ULED based on the device's config.

int	ltc3220_set_blink_fast (struct ltc3220_dev *device, bool is_fast_on)
	Sets the configuration for blinking mode of ULEDs.

int	ltc3220_set_blink_long (struct ltc3220_dev *device, bool is_long_period)
	Sets the configuration for blinking mode of ULEDs.

int	ltc3220_set_grad_increasing (struct ltc3220_dev *device, bool is_increasing)
	Sets the configuration for the device's direction of gradation.

int	ltc3220_set_grad_speed (struct ltc3220_dev *device, uint8_t speed)
	Sets the configuration of the device's speed of gradation.

int	ltc3220_update_reg_blink_grad (struct ltc3220_dev *device, bool is_blink_fast, bool is_blink_long, bool is_grad_inc, uint8_t grad_speed)
	Updates the configuration set on the device's Blink/Gradation based on the config.

int	ltc3220_set_quick_write (struct ltc3220_dev *device, bool is_quick_write)
	Sets the configuration to perform a quick write to the device.

int	ltc3220_set_cpo_1x (struct ltc3220_dev *device, bool is_force_cpo_1x)
	Sets the device's charge pump to output 1x of operating voltage.

int	ltc3220_set_cpo_1p5x (struct ltc3220_dev *device, bool is_force_cpo_1p5x)
	Sets the device's charge pump to output 1.5x of operating voltage.

int	ltc3220_set_cpo_2x (struct ltc3220_dev *device, bool is_force_cpo_2x)
	Sets the device's charge pump to output 2x of operating voltage.

int	ltc3220_set_shutdown (struct ltc3220_dev *device, bool is_shutdown)
	Sets the device to shutdown mode, while retaining the register configurations.

int	ltc3220_update_reg_command (struct ltc3220_dev *device, bool is_shutdown, bool is_force_cpo_2x, bool is_force_cpo_1p5x, bool is_quick_write)
	Updates the configuration set on the.

Detailed Description

Implementation of LTC3220 Driver.

Author: Jan Carlo Roleda (Janca.nosp@m.rlo..nosp@m.roled.nosp@m.a@an.nosp@m.alog..nosp@m.com)

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

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of Analog Devices, Inc. nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
The use of this software may or may not infringe the patent rights of one or more patent holders. This license does not release you from the requirement that you obtain separate licenses from these patent holders to use this software.
Use of the software either in source or binary form, must be run on or directly connected to an Analog Devices Inc. component.

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

◆ ltc3220_init()

int ltc3220_init	(	struct ltc3220_dev **	device,
		struct ltc3220_init_param	init_param )

Initializes the LTC3220 device structure.

Parameters

device	- The device structure to initialize.
init_param	- The initialization parameters.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_reg_write()

int ltc3220_reg_write	(	struct ltc3220_dev *	device,
		uint8_t	reg_addr,
		uint8_t	reg_data )

Writes to the selected register on the device.

Parameters

device	- The device structure.
reg_addr	- The register sub-address.
reg_data	- The data to write into the register (8-bits wide)

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_remove()

int ltc3220_remove ( struct ltc3220_dev * device )

Deallocates the resources for the device structure.

Parameters

device - The device structure.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_reset()

int ltc3220_reset ( struct ltc3220_dev * device )

Resets the device using the RST pin.

Parameters

device - the device structure.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_blink_fast()

int ltc3220_set_blink_fast	(	struct ltc3220_dev *	device,
		bool	is_fast_on )

Sets the configuration for blinking mode of ULEDs.

Parameters

device	- The device structure.
is_fast_on	- Sets whether blinking should turn on fast (0.156s) or not (0.625s)

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_blink_long()

int ltc3220_set_blink_long	(	struct ltc3220_dev *	device,
		bool	is_long_period )

Sets the configuration for blinking mode of ULEDs.

Parameters

device	- The device structure.
is_long_period	- Sets whether blinking should have a shorter (1.25s) or longer (2.5s) period

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_cpo_1p5x()

int ltc3220_set_cpo_1p5x	(	struct ltc3220_dev *	device,
		bool	is_force_cpo_1p5x )

Sets the device's charge pump to output 1.5x of operating voltage.

Parameters

device	- The device structure.
is_force_cpo_1p5x	- Sets the device's to use 1.5x voltage.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_cpo_1x()

int ltc3220_set_cpo_1x	(	struct ltc3220_dev *	device,
		bool	is_force_cpo_1x )

Sets the device's charge pump to output 1x of operating voltage.

Parameters

device	- The device structure.
is_force_cpo_1x	- Set if the device's is to use 1x voltage.

Returns: 0 in case of success, negative error code otherwise.

◆ ltc3220_set_cpo_2x()

int ltc3220_set_cpo_2x	(	struct ltc3220_dev *	device,
		bool	is_force_cpo_2x )

Sets the device's charge pump to output 2x of operating voltage.

Parameters

device	- The device structure.
is_force_cpo_2x	- Sets the device's to use 2x voltage.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_grad_increasing()

int ltc3220_set_grad_increasing	(	struct ltc3220_dev *	device,
		bool	is_increasing )

Sets the configuration for the device's direction of gradation.

Parameters

device	- The device structure.
is_increasing	- Set for increasing gradation, unset if decreasing gradation.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_grad_speed()

int ltc3220_set_grad_speed	(	struct ltc3220_dev *	device,
		uint8_t	speed )

Sets the configuration of the device's speed of gradation.

Parameters

device	- The device structure.
speed	- Sets the speed of gradation, with slowest speed at max setting (3). Set to 0 to disable gradation.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_quick_write()

int ltc3220_set_quick_write	(	struct ltc3220_dev *	device,
		bool	is_quick_write )

Sets the configuration to perform a quick write to the device.

Parameters

device	- The device structure.
is_quick_write	- Set for quick write operation. This copies the configuration set on ULED1 to all other ULED registers.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_shutdown()

int ltc3220_set_shutdown	(	struct ltc3220_dev *	device,
		bool	is_shutdown )

Sets the device to shutdown mode, while retaining the register configurations.

Parameters

device	- The device structure.
is_shutdown	- Signals the device to shutdown.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_set_uled_current()

int ltc3220_set_uled_current	(	struct ltc3220_dev *	device,
		uint8_t	uled_number,
		uint8_t	current_level )

Sets the selected ULED register's current strength.

Parameters

device	- The device structure.
uled_number	- The ULED to select (1-indexed).
current_level	- The current strength from 0 to 20mA to set on the corresponding ULED pin (64 levels)

Here is the caller graph for this function:

◆ ltc3220_set_uled_mode()

int ltc3220_set_uled_mode	(	struct ltc3220_dev *	device,
		uint8_t	uled_number,
		enum ltc3220_uled_mode	mode )

Sets the selected ULED register's operating mode.

Parameters

device	- The device structure.
uled_number	- The ULED to select (1-indexed).
mode	- The mode to set the ULED to.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_update_reg_blink_grad()

int ltc3220_update_reg_blink_grad	(	struct ltc3220_dev *	device,
		bool	is_blink_fast,
		bool	is_blink_long,
		bool	is_grad_inc,
		uint8_t	grad_speed )

Updates the configuration set on the device's Blink/Gradation based on the config.

Parameters

device	- The device's structure.
is_blink_fast	- Sets whether blinking should turn on fast (0.156s) or not (0.625s)
is_blink_long	- Sets whether blinking should have a shorter (1.25s) or longer (2.5s) period
is_grad_inc	- Set for increasing gradation, unset if decreasing gradation.
grad_speed	- Sets the speed of gradation, with slowest speed at max setting (3). Set to 0 to disable gradation.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_update_reg_command()

int ltc3220_update_reg_command	(	struct ltc3220_dev *	device,
		bool	is_shutdown,
		bool	is_force_cpo_2x,
		bool	is_force_cpo_1p5x,
		bool	is_quick_write )

Updates the configuration set on the.

Parameters

device	- The device's structure.
is_shutdown	- Signals the device to shutdown.
is_force_cpo_1p5x	- Sets the device's to use 1.5x voltage.
is_force_cpo_2x	- Sets the device's to use 2x voltage.
is_quick_write	- Set for quick write operation. This copies the configuration set on ULED1 to all other ULED registers.

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

◆ ltc3220_update_reg_uled()

int ltc3220_update_reg_uled	(	struct ltc3220_dev *	device,
		uint8_t	uled_number,
		enum ltc3220_uled_mode	mode,
		uint8_t	current_level )

Updates the configuration set on the ULED based on the device's config.

Updates the configuration set on the device's ULED based on the config.

Parameters

device	- The device structure.
uled_number	- The ULED to select (1-indexed).
mode	- The mode to set the ULED to.
current_level	- The current strength from 0 to 20mA to set on the corresponding ULED pin (64 levels)

Returns: 0 in case of success, negative error code otherwise.

Here is the caller graph for this function:

Functions

Detailed Description

Function Documentation

◆ ltc3220_init()

◆ ltc3220_reg_write()

◆ ltc3220_remove()

◆ ltc3220_reset()

◆ ltc3220_set_blink_fast()

◆ ltc3220_set_blink_long()

◆ ltc3220_set_cpo_1p5x()

◆ ltc3220_set_cpo_1x()

◆ ltc3220_set_cpo_2x()

◆ ltc3220_set_grad_increasing()

◆ ltc3220_set_grad_speed()

◆ ltc3220_set_quick_write()

◆ ltc3220_set_shutdown()

◆ ltc3220_set_uled_current()

◆ ltc3220_set_uled_mode()

◆ ltc3220_update_reg_blink_grad()

◆ ltc3220_update_reg_command()

◆ ltc3220_update_reg_uled()