EZO Carrier RTD Click Driver

API for configuring and manipulating EZO Carrier RTD Click driver. More...

Topics
	EZO Carrier RTD Device Settings
	Settings for registers of EZO Carrier RTD Click driver.
	EZO Carrier RTD MikroBUS Map
	MikroBUS pin mapping of EZO Carrier RTD Click driver.

Macros
#define	EZOCARRIERRTD_DEVICE_ADDRESS   0x61
	EZO Carrier RTD device address setting.

Functions
void	ezocarrierrtd_cfg_setup (ezocarrierrtd_cfg_t *cfg)
	EZO Carrier RTD configuration object setup function.
void	ezocarrierrtd_drv_interface_sel (ezocarrierrtd_cfg_t *cfg, ezocarrierrtd_drv_t drv_sel)
	EZO Carrier EC driver interface setup function.
err_t	ezocarrierrtd_init (ezocarrierrtd_t *ctx, ezocarrierrtd_cfg_t *cfg)
	EZO Carrier RTD initialization function.
err_t	ezocarrierrtd_generic_write (ezocarrierrtd_t *ctx, uint8_t *data_in, uint16_t len)
	EZO Carrier RTD data writing function.
err_t	ezocarrierrtd_generic_read (ezocarrierrtd_t *ctx, uint8_t *data_out, uint16_t len)
	EZO Carrier RTD data reading function.
void	ezocarrierrtd_send_cmd (ezocarrierrtd_t *ctx, uint8_t *cmd)
	Send command function.
void	ezocarrierrtd_send_cmd_with_par (ezocarrierrtd_t *ctx, uint8_t *cmd, uint8_t *param_buf)
	Send command function with parameter.
void	ezocarrierrtd_send_cmd_check (ezocarrierrtd_t *ctx, uint8_t *cmd)
	Check the sent command.

Detailed Description

API for configuring and manipulating EZO Carrier RTD Click driver.

Any initialization code needed for MCU to function properly. Do not remove this line or clock might not be set correctly.

Macro Definition Documentation

EZOCARRIERRTD_DEVICE_ADDRESS

#define EZOCARRIERRTD_DEVICE_ADDRESS   0x61

EZO Carrier RTD device address setting.

Specified setting for device slave address selection of EZO Carrier RTD Click driver.

Function Documentation

ezocarrierrtd_cfg_setup()

void ezocarrierrtd_cfg_setup

(

ezocarrierrtd_cfg_t *

cfg

)

EZO Carrier RTD configuration object setup function.

This function initializes click configuration structure to initial values.

Parameters

[out]

cfg

: Click configuration structure. See ezocarrierrtd_cfg_t object definition for detailed explanation.

Returns

Nothing.

Note

The all used pins will be set to unconnected state.

ezocarrierrtd_drv_interface_sel()

void ezocarrierrtd_drv_interface_sel	(	ezocarrierrtd_cfg_t *	cfg,
		ezocarrierrtd_drv_t	drv_sel )

EZO Carrier EC driver interface setup function.

This function sets a serial driver interface which will be used further in the click driver.

Parameters

[out]	cfg	: Click configuration structure. See ezocarrierrtd_cfg_t object definition for detailed explanation.
[in]	drv_sel	: Driver interface selection. See ezocarrierrtd_drv_t object definition for detailed explanation.

Returns

Nothing.

Note

This driver selection should be call before init function to configure the driver to work with the serial interface which is consistent with the real state of the hardware. If this function is not called, the default driver interface will be set.

ezocarrierrtd_generic_read()

err_t ezocarrierrtd_generic_read	(	ezocarrierrtd_t *	ctx,
		uint8_t *	data_out,
		uint16_t	len )

EZO Carrier RTD data reading function.

This function reads a desired number of data bytes by using UART serial interface.

Parameters

[in]	ctx	: Click context object. See ezocarrierrtd_t object definition for detailed explanation.
[out]	data_out	: Output read data.
[in]	len	: Number of bytes to be read.

Returns

• >0 - Number of data bytes read,
• <=0 - Error/Empty Ring buffer. See #err_t definition for detailed explanation.

Note

None.

ezocarrierrtd_generic_write()

err_t ezocarrierrtd_generic_write	(	ezocarrierrtd_t *	ctx,
		uint8_t *	data_in,
		uint16_t	len )

EZO Carrier RTD data writing function.

This function writes a desired number of data bytes by using UART serial interface.

Parameters

[in]	ctx	: Click context object. See ezocarrierrtd_t object definition for detailed explanation.
[in]	data_in	: Data buffer for sending.
[in]	len	: Number of bytes for sending.

Returns

• >=0 - Success,
• <0 - Error. See #err_t definition for detailed explanation.

Note

None.

ezocarrierrtd_init()

err_t ezocarrierrtd_init	(	ezocarrierrtd_t *	ctx,
		ezocarrierrtd_cfg_t *	cfg )

EZO Carrier RTD initialization function.

This function initializes all necessary pins and peripherals used for this click board.

Parameters

[out]	ctx	: Click context object. See ezocarrierrtd_t object definition for detailed explanation.
[in]	cfg	: Click configuration structure. See ezocarrierrtd_cfg_t object definition for detailed explanation.

Returns

• 0 - Success,
• -1 - Error. See #err_t definition for detailed explanation.

Note

None.

ezocarrierrtd_send_cmd()

void ezocarrierrtd_send_cmd	(	ezocarrierrtd_t *	ctx,
		uint8_t *	cmd )

Send command function.

This function sends a specified command to the click module.

Parameters

[in]	ctx	: Click context object. See ezocarrierrtd_t object definition for detailed explanation.
[in]	cmd	: Command buffer.

Returns

Nothing.

Note

None.

ezocarrierrtd_send_cmd_check()

void ezocarrierrtd_send_cmd_check	(	ezocarrierrtd_t *	ctx,
		uint8_t *	cmd )

Check the sent command.

This function checks the command that is sent.

Parameters

[in]	ctx	: Click context object. See ezocarrierrtd_t object definition for detailed explanation.
[in]	cmd	: Command buffer.

Returns

Nothing.

Note

None.

ezocarrierrtd_send_cmd_with_par()

void ezocarrierrtd_send_cmd_with_par	(	ezocarrierrtd_t *	ctx,
		uint8_t *	cmd,
		uint8_t *	param_buf )

Send command function with parameter.

This function sends a command with specified parameter to the click module.

Parameters

[in]	ctx	: Click context object. See ezocarrierrtd_t object definition for detailed explanation.
[in]	cmd	: Command buffer.
[in]	param_buf	: Parameter buffer.

Returns

Nothing.

Note

None.