TCS3472 Driver extensions. More...

#include "sarmfsw.h"
#include "TCS3472.h"

Include dependency graph for TCS3472_ex.h:

This graph shows which files directly or indirectly include this file:

Data Structures
union	uTCS3472_REG_MAP
	Union of TCS3472 registry map. More...

Enumerations
enum	TCS3472_chan { TCS3472__CHAN_CLEAR = 0U , TCS3472__CHAN_RED , TCS3472__CHAN_GREEN , TCS3472__CHAN_BLUE }
	Light type channels of TCS3472. More...

Functions
FctERR	TCS3472_Write_En (TCS3472_t *const pCpnt, const uint8_t en)
	Write TCS3472 Enable register.

FctERR	TCS3472_Write_Cfg (TCS3472_t *const pCpnt, const uint8_t cfg)
	Write TCS3472 Config register.

FctERR	TCS3472_Write_Ctl (TCS3472_t *const pCpnt, const uint8_t ctl)
	Write TCS3472 Control register.

FctERR	TCS3472_Set_PON (TCS3472_t *const pCpnt, const bool en)
	Oscillator Enable / Disable.

FctERR	TCS3472_Set_AEN (TCS3472_t *const pCpnt, const bool en)
	Clear module Enable / Disable.

FctERR	TCS3472_Set_AIEN (TCS3472_t *const pCpnt, const bool en)
	Clear interrupt module Enable / Disable.

FctERR	TCS3472_Set_WEN (TCS3472_t *const pCpnt, const bool en)
	WAIT module Enable / Disable.

FctERR	TCS3472_Set_Gain (TCS3472_t *const pCpnt, const TCS3472_gain gain)
	Gain configuration.

FctERR	TCS3472_Set_Pesistence (TCS3472_t *const pCpnt, const TCS3472_it_persist persist)
	ALS Persistence configuration.

FctERR	TCS3472_Set_Integration_Time (TCS3472_t *const pCpnt, const uint16_t integ)
	Integration time configuration.

FctERR	TCS3472_Set_Wait_Time (TCS3472_t *const pCpnt, const uint16_t wait)
	Wait time configuration.

FctERR	TCS3472_Set_AILT (TCS3472_t *const pCpnt, const uint16_t thr)
	ALS interrupt low threshold configuration.

FctERR	TCS3472_Set_AIHT (TCS3472_t *const pCpnt, const uint16_t thr)
	ALS interrupt high threshold configuration.

FctERR	TCS3472_Set_AIT (TCS3472_t *const pCpnt, const uint16_t lthr, const uint16_t hthr)
	ALS interrupt thresholds configuration.

FctERR	TCS3472_SF_Clear_IT (TCS3472_t *const pCpnt)
	Clear pending interruption.

FctERR	TCS3472_Get_ChipID (TCS3472_t const pCpnt, uint8_t const id)
	Get TCS3472 chip ID.

FctERR	TCS3472_Get_Channels (TCS3472_t *const pCpnt, uint16_t buf[])
	Get All channels conversions.

FctERR	TCS3472_Get_Channel (TCS3472_t const pCpnt, uint16_t const val, const TCS3472_chan chan)
	Get Specific channel conversion.

FctERR	TCS3472_Get_Clear (TCS3472_t const pCpnt, uint16_t const clr)
	Get Clear channel conversion.

FctERR	TCS3472_Get_Red (TCS3472_t const pCpnt, uint16_t const r)
	Get Red channel conversion.

FctERR	TCS3472_Get_Green (TCS3472_t const pCpnt, uint16_t const g)
	Get Green channel conversion.

FctERR	TCS3472_Get_Blue (TCS3472_t const pCpnt, uint16_t const b)
	Get Blue channel conversion.

void	TCS3472_INT_GPIO_Init (TCS3472_t const pCpnt, GPIO_TypeDef const GPIOx, const uint16_t GPIO_Pin, const GPIO_PinState GPIO_Active)
	Interrupt GPIO pin init for TCS3472.

bool	TCS3472_INT_GPIO_Get (const TCS3472_t *const pCpnt)
	Interrupt GPIO pin getter for TCS3472.

Detailed Description

TCS3472 Driver extensions.

Author: SMFSW

Copyright: MIT (c) 2017-2026, SMFSW

TCS3472: Color light-to-digital converter with IR filter

Enumeration Type Documentation

◆ TCS3472_chan

enum TCS3472_chan

Light type channels of TCS3472.

Enumerator
TCS3472__CHAN_CLEAR	Clear light channel.
TCS3472__CHAN_RED	Red light channel.
TCS3472__CHAN_GREEN	Green light channel.
TCS3472__CHAN_BLUE	Blue light channel.

Function Documentation

◆ TCS3472_Get_Blue()

FctERR TCS3472_Get_Blue	(	TCS3472_t *const	pCpnt,
		uint16_t *const	b )

inline

Get Blue channel conversion.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in,out]	b	- pointer to Blue conversion result

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Get_Channel()

FctERR TCS3472_Get_Channel	(	TCS3472_t *const	pCpnt,
		uint16_t *const	val,
		const TCS3472_chan	chan )

Get Specific channel conversion.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in,out]	val	- pointer to conversions result
[in]	chan	- Channel to get

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Get_Channels()

FctERR TCS3472_Get_Channels	(	TCS3472_t *const	pCpnt,
		uint16_t	buf[] )

Get All channels conversions.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in,out]	buf	- pointer to conversions tab result

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Get_ChipID()

FctERR TCS3472_Get_ChipID	(	TCS3472_t *const	pCpnt,
		uint8_t *const	id )

inline

Get TCS3472 chip ID.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in,out]	id	- pointer to chip ID result

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_Get_Clear()

FctERR TCS3472_Get_Clear	(	TCS3472_t *const	pCpnt,
		uint16_t *const	clr )

inline

Get Clear channel conversion.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in,out]	clr	- pointer to Clear conversion result

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Get_Green()

FctERR TCS3472_Get_Green	(	TCS3472_t *const	pCpnt,
		uint16_t *const	g )

inline

Get Green channel conversion.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in,out]	g	- pointer to Green conversion result

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Get_Red()

FctERR TCS3472_Get_Red	(	TCS3472_t *const	pCpnt,
		uint16_t *const	r )

inline

Get Red channel conversion.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in,out]	r	- pointer to Red conversion result

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_INT_GPIO_Get()

bool TCS3472_INT_GPIO_Get ( const TCS3472_t *const pCpnt )

Interrupt GPIO pin getter for TCS3472.

Weak Functions: TCS3472 Interrupt GPIO pin getter may be user implemented if needed

Parameters

[in] pCpnt - Pointer to TCS3472 component

Returns: INT pin state value (0: inactive, 1: active)

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_INT_GPIO_Init()

void TCS3472_INT_GPIO_Init	(	TCS3472_t *const	pCpnt,
		GPIO_TypeDef *const	GPIOx,
		const uint16_t	GPIO_Pin,
		const GPIO_PinState	GPIO_Active )

Interrupt GPIO pin init for TCS3472.

Weak Functions: TCS3472 Interrupt GPIO pin init may be user implemented if needed

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	GPIOx	- INT port
[in]	GPIO_Pin	- INT pin
[in]	GPIO_Active	INT pin active state

Here is the call graph for this function:

◆ TCS3472_Set_AEN()

FctERR TCS3472_Set_AEN	(	TCS3472_t *const	pCpnt,
		const bool	en )

Clear module Enable / Disable.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	en	- 0 Disable, 1 Enable

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Set_AIEN()

FctERR TCS3472_Set_AIEN	(	TCS3472_t *const	pCpnt,
		const bool	en )

Clear interrupt module Enable / Disable.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	en	- 0 Disable, 1 Enable

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Set_AIHT()

FctERR TCS3472_Set_AIHT	(	TCS3472_t *const	pCpnt,
		const uint16_t	thr )

inline

ALS interrupt high threshold configuration.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	thr	- High threshold value

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Set_AILT()

FctERR TCS3472_Set_AILT	(	TCS3472_t *const	pCpnt,
		const uint16_t	thr )

inline

ALS interrupt low threshold configuration.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	thr	- Low threshold value

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Set_AIT()

FctERR TCS3472_Set_AIT	(	TCS3472_t *const	pCpnt,
		const uint16_t	lthr,
		const uint16_t	hthr )

inline

ALS interrupt thresholds configuration.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	lthr	- Low threshold value
[in]	hthr	- High threshold value

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_Set_Gain()

FctERR TCS3472_Set_Gain	(	TCS3472_t *const	pCpnt,
		const TCS3472_gain	gain )

Gain configuration.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	gain	- Gain value

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_Set_Integration_Time()

FctERR TCS3472_Set_Integration_Time	(	TCS3472_t *const	pCpnt,
		const uint16_t	integ )

Integration time configuration.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	integ	- Integration time value (from 3ms to 614ms)

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_Set_Pesistence()

FctERR TCS3472_Set_Pesistence	(	TCS3472_t *const	pCpnt,
		const TCS3472_it_persist	persist )

inline

ALS Persistence configuration.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	persist	- Persistence value

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Set_PON()

FctERR TCS3472_Set_PON	(	TCS3472_t *const	pCpnt,
		const bool	en )

Oscillator Enable / Disable.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	en	- 0 Disable, 1 Enable

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Set_Wait_Time()

FctERR TCS3472_Set_Wait_Time	(	TCS3472_t *const	pCpnt,
		const uint16_t	wait )

Wait time configuration.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	wait	- Wait time value (from 3m to 7400ms)

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_Set_WEN()

FctERR TCS3472_Set_WEN	(	TCS3472_t *const	pCpnt,
		const bool	en )

WAIT module Enable / Disable.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	en	- 0 Disable, 1 Enable

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_SF_Clear_IT()

FctERR TCS3472_SF_Clear_IT ( TCS3472_t *const pCpnt )

inline

Clear pending interruption.

Warning: if event pin enabled, shall be called after read to reset pin

Parameters

[in] pCpnt - Pointer to TCS3472 component

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_Write_Cfg()

FctERR TCS3472_Write_Cfg	(	TCS3472_t *const	pCpnt,
		const uint8_t	cfg )

inline

Write TCS3472 Config register.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	cfg	- Configuration register value

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

◆ TCS3472_Write_Ctl()

FctERR TCS3472_Write_Ctl	(	TCS3472_t *const	pCpnt,
		const uint8_t	ctl )

inline

Write TCS3472 Control register.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	ctl	- Control register value

Returns: FctERR - error code

Here is the call graph for this function:

◆ TCS3472_Write_En()

FctERR TCS3472_Write_En	(	TCS3472_t *const	pCpnt,
		const uint8_t	en )

inline

Write TCS3472 Enable register.

Parameters

[in]	pCpnt	- Pointer to TCS3472 component
[in]	en	- 0 Disable, 1 Enable

Returns: FctERR - error code

Here is the call graph for this function:

Here is the caller graph for this function:

Data Structures

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

◆ TCS3472_chan

Function Documentation

◆ TCS3472_Get_Blue()

◆ TCS3472_Get_Channel()

◆ TCS3472_Get_Channels()

◆ TCS3472_Get_ChipID()

◆ TCS3472_Get_Clear()

◆ TCS3472_Get_Green()

◆ TCS3472_Get_Red()

◆ TCS3472_INT_GPIO_Get()

◆ TCS3472_INT_GPIO_Init()

◆ TCS3472_Set_AEN()

◆ TCS3472_Set_AIEN()

◆ TCS3472_Set_AIHT()

◆ TCS3472_Set_AILT()

◆ TCS3472_Set_AIT()

◆ TCS3472_Set_Gain()

◆ TCS3472_Set_Integration_Time()

◆ TCS3472_Set_Pesistence()

◆ TCS3472_Set_PON()

◆ TCS3472_Set_Wait_Time()

◆ TCS3472_Set_WEN()

◆ TCS3472_SF_Clear_IT()

◆ TCS3472_Write_Cfg()

◆ TCS3472_Write_Ctl()

◆ TCS3472_Write_En()