EZO Carrier EC Click Driver

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

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

Functions
void	ezocarrierec_cfg_setup (ezocarrierec_cfg_t *cfg)
	EZO Carrier EC configuration object setup function.
void	ezocarrierec_drv_interface_sel (ezocarrierec_cfg_t *cfg, ezocarrierec_drv_t drv_sel)
	EZO Carrier EC driver interface setup function.
err_t	ezocarrierec_init (ezocarrierec_t *ctx, ezocarrierec_cfg_t *cfg)
	EZO Carrier EC initialization function.
err_t	ezocarrierec_generic_write (ezocarrierec_t *ctx, uint8_t *data_in, uint16_t len)
	EZO Carrier EC data writing function.
err_t	ezocarrierec_generic_read (ezocarrierec_t *ctx, uint8_t *data_out, uint16_t len)
	EZO Carrier EC data reading function.
void	ezocarrierec_send_cmd (ezocarrierec_t *ctx, uint8_t *cmd)
	Send command function.
void	ezocarrierec_send_cmd_with_par (ezocarrierec_t *ctx, uint8_t *cmd, uint8_t *param_buf)
	Send command function with parameter.
void	ezocarrierec_send_cmd_check (ezocarrierec_t *ctx, uint8_t *cmd)
	Check the sent command.

Detailed Description

API for configuring and manipulating EZO Carrier EC Click driver.

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

Function Documentation

ezocarrierec_cfg_setup()

void ezocarrierec_cfg_setup

(

ezocarrierec_cfg_t *

cfg

)

EZO Carrier EC configuration object setup function.

This function initializes click configuration structure to initial values.

Parameters

[out]

cfg

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

Returns

Nothing.

Note

The all used pins will be set to unconnected state.

ezocarrierec_drv_interface_sel()

void ezocarrierec_drv_interface_sel	(	ezocarrierec_cfg_t *	cfg,
		ezocarrierec_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 ezocarrierec_cfg_t object definition for detailed explanation.
[in]	drv_sel	: Driver interface selection. See ezocarrierec_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.

ezocarrierec_generic_read()

err_t ezocarrierec_generic_read	(	ezocarrierec_t *	ctx,
		uint8_t *	data_out,
		uint16_t	len )

EZO Carrier EC data reading function.

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

Parameters

[in]	ctx	: Click context object. See ezocarrierec_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.

ezocarrierec_generic_write()

err_t ezocarrierec_generic_write	(	ezocarrierec_t *	ctx,
		uint8_t *	data_in,
		uint16_t	len )

EZO Carrier EC data writing function.

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

Parameters

[in]	ctx	: Click context object. See ezocarrierec_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.

ezocarrierec_init()

err_t ezocarrierec_init	(	ezocarrierec_t *	ctx,
		ezocarrierec_cfg_t *	cfg )

EZO Carrier EC initialization function.

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

Parameters

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

Returns

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

Note

None.

ezocarrierec_send_cmd()

void ezocarrierec_send_cmd	(	ezocarrierec_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 ezocarrierec_t object definition for detailed explanation.
[in]	cmd	: Command buffer.

Returns

Nothing.

Note

None.

ezocarrierec_send_cmd_check()

void ezocarrierec_send_cmd_check	(	ezocarrierec_t *	ctx,
		uint8_t *	cmd )

Check the sent command.

This function checks the command that is sent.

Parameters

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

Returns

Nothing.

Note

None.

ezocarrierec_send_cmd_with_par()

void ezocarrierec_send_cmd_with_par	(	ezocarrierec_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 ezocarrierec_t object definition for detailed explanation.
[in]	cmd	: Command buffer.
[in]	param_buf	: Parameter buffer.

Returns

Nothing.

Note

None.