EZO Carrier pH Click Driver

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

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

Macros
#define	EZOCARRIERPH_DEVICE_ADDRESS   0x61
	EZO Carrier pH device address setting.

Functions
void	ezocarrierph_cfg_setup (ezocarrierph_cfg_t *cfg)
	EZO Carrier pH configuration object setup function.
void	ezocarrierph_drv_interface_sel (ezocarrierph_cfg_t *cfg, ezocarrierph_drv_t drv_sel)
	EZO Carrier pH driver interface setup function.
err_t	ezocarrierph_init (ezocarrierph_t *ctx, ezocarrierph_cfg_t *cfg)
	EZO Carrier pH initialization function.
err_t	ezocarrierph_generic_write (ezocarrierph_t *ctx, uint8_t *data_in, uint16_t len)
	EZO Carrier pH data writing function.
err_t	ezocarrierph_generic_read (ezocarrierph_t *ctx, uint8_t *data_out, uint16_t len)
	EZO Carrier pH data reading function.
void	ezocarrierph_send_cmd (ezocarrierph_t *ctx, uint8_t *cmd)
	Send command function.
void	ezocarrierph_send_cmd_with_par (ezocarrierph_t *ctx, uint8_t *cmd, uint8_t *param_buf)
	Send command function with parameter.
void	ezocarrierph_send_cmd_check (ezocarrierph_t *ctx, uint8_t *cmd)
	Check the sent command.

Detailed Description

API for configuring and manipulating EZO Carrier pH 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

EZOCARRIERPH_DEVICE_ADDRESS

#define EZOCARRIERPH_DEVICE_ADDRESS   0x61

EZO Carrier pH device address setting.

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

Function Documentation

ezocarrierph_cfg_setup()

void ezocarrierph_cfg_setup

(

ezocarrierph_cfg_t *

cfg

)

EZO Carrier pH configuration object setup function.

This function initializes click configuration structure to initial values.

Parameters

[out]

cfg

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

Returns

Nothing.

Note

The all used pins will be set to unconnected state.

ezocarrierph_drv_interface_sel()

void ezocarrierph_drv_interface_sel	(	ezocarrierph_cfg_t *	cfg,
		ezocarrierph_drv_t	drv_sel )

EZO Carrier pH 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 ezocarrierph_cfg_t object definition for detailed explanation.
[in]	drv_sel	: Driver interface selection. See ezocarrierph_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.

ezocarrierph_generic_read()

err_t ezocarrierph_generic_read	(	ezocarrierph_t *	ctx,
		uint8_t *	data_out,
		uint16_t	len )

EZO Carrier pH data reading function.

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

Parameters

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

ezocarrierph_generic_write()

err_t ezocarrierph_generic_write	(	ezocarrierph_t *	ctx,
		uint8_t *	data_in,
		uint16_t	len )

EZO Carrier pH data writing function.

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

Parameters

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

ezocarrierph_init()

err_t ezocarrierph_init	(	ezocarrierph_t *	ctx,
		ezocarrierph_cfg_t *	cfg )

EZO Carrier pH initialization function.

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

Parameters

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

Returns

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

Note

None.

ezocarrierph_send_cmd()

void ezocarrierph_send_cmd	(	ezocarrierph_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 ezocarrierph_t object definition for detailed explanation.
[in]	cmd	: Command buffer.

Returns

Nothing.

Note

None.

ezocarrierph_send_cmd_check()

void ezocarrierph_send_cmd_check	(	ezocarrierph_t *	ctx,
		uint8_t *	cmd )

Check the sent command.

This function checks the command that is sent.

Parameters

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

Returns

Nothing.

Note

None.

ezocarrierph_send_cmd_with_par()

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

Returns

Nothing.

Note

None.