hallcurrent22 2.2.0
Loading...
Searching...
No Matches
Hall Current 22 Click Driver

API for configuring and manipulating Hall Current 22 Click driver. More...

Topics

 Hall Current 22 Registers Settings
 Settings for registers of Hall Current 22 Click driver.
 Hall Current 22 MikroBUS Map
 MikroBUS pin mapping of Hall Current 22 Click driver.

Functions

void hallcurrent22_cfg_setup (hallcurrent22_cfg_t *cfg)
 Hall Current 22 configuration object setup function.
void hallcurrent22_drv_interface_sel (hallcurrent22_cfg_t *cfg, hallcurrent22_drv_t drv_sel)
 Hall Current 22 driver interface setup function.
err_t hallcurrent22_init (hallcurrent22_t *ctx, hallcurrent22_cfg_t *cfg)
 Hall Current 22 initialization function.
err_t hallcurrent22_read_raw_adc (hallcurrent22_t *ctx, uint16_t *raw_adc)
 Hall Current 22 read raw ADC value function.
err_t hallcurrent22_read_voltage (hallcurrent22_t *ctx, float *voltage)
 Hall Current 22 read voltage level function.
err_t hallcurrent22_read_voltage_avg (hallcurrent22_t *ctx, uint16_t num_conv, float *voltage_avg)
 Hall Current 22 read average voltage level function.
err_t hallcurrent22_set_vref (hallcurrent22_t *ctx, float vref)
 Hall Current 22 set vref function.
err_t hallcurrent22_calib_offset (hallcurrent22_t *ctx)
 Hall Current 22 calib offset function.
err_t hallcurrent22_calib_resolution (hallcurrent22_t *ctx, float calib_current)
 Hall Current 22 calib resolution function.
err_t hallcurrent22_read_current (hallcurrent22_t *ctx, float *current)
 Hall Current 22 read current function.

Detailed Description

API for configuring and manipulating Hall Current 22 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

◆ hallcurrent22_calib_offset()

err_t hallcurrent22_calib_offset ( hallcurrent22_t * ctx)

Hall Current 22 calib offset function.

This function calibrates the zero current offset value.

Parameters
[in]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
This function should only be called when no current flows through the sensor.

◆ hallcurrent22_calib_resolution()

err_t hallcurrent22_calib_resolution ( hallcurrent22_t * ctx,
float calib_current )

Hall Current 22 calib resolution function.

This function calibrates the data resolution at the known load current.

Parameters
[in]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
[in]calib_current: The known load current used for calibrating data resolution.
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
This function should only be called when a known amount of load current flows through the sensor and after calibrating zero current offset using hallcurrent22_calib_offset function.

◆ hallcurrent22_cfg_setup()

void hallcurrent22_cfg_setup ( hallcurrent22_cfg_t * cfg)

Hall Current 22 configuration object setup function.

This function initializes Click configuration structure to initial values.

Parameters
[out]cfg: Click configuration structure. See hallcurrent22_cfg_t object definition for detailed explanation.
Returns
Nothing.
Note
The all used pins will be set to unconnected state.

◆ hallcurrent22_drv_interface_sel()

void hallcurrent22_drv_interface_sel ( hallcurrent22_cfg_t * cfg,
hallcurrent22_drv_t drv_sel )

Hall Current 22 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 hallcurrent22_cfg_t object definition for detailed explanation.
[in]drv_sel: Driver interface selection. See hallcurrent22_drv_t object definition for detailed explanation.
Returns
Nothing.
Note
This driver selection should be called 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.

◆ hallcurrent22_init()

err_t hallcurrent22_init ( hallcurrent22_t * ctx,
hallcurrent22_cfg_t * cfg )

Hall Current 22 initialization function.

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

Parameters
[out]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
[in]cfg: Click configuration structure. See hallcurrent22_cfg_t object definition for detailed explanation.
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
None.

◆ hallcurrent22_read_current()

err_t hallcurrent22_read_current ( hallcurrent22_t * ctx,
float * current )

Hall Current 22 read current function.

This function reads the input current level [A].

Parameters
[in]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
[out]current: Input current level [A].
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
This function relies on calibrated zero current offset and data resolution. Refer to hallcurrent22_calib_offset and hallcurrent22_calib_resolution functions.

◆ hallcurrent22_read_raw_adc()

err_t hallcurrent22_read_raw_adc ( hallcurrent22_t * ctx,
uint16_t * raw_adc )

Hall Current 22 read raw ADC value function.

This function reads raw ADC value.

Parameters
[in]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
[out]raw_adc: Output ADC result.
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
None.

◆ hallcurrent22_read_voltage()

err_t hallcurrent22_read_voltage ( hallcurrent22_t * ctx,
float * voltage )

Hall Current 22 read voltage level function.

This function reads raw ADC value and converts it to proportional voltage level.

Parameters
[in]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
[out]voltage: Output voltage level [V].
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
The conversion to voltage depends on the entered reference voltage.

◆ hallcurrent22_read_voltage_avg()

err_t hallcurrent22_read_voltage_avg ( hallcurrent22_t * ctx,
uint16_t num_conv,
float * voltage_avg )

Hall Current 22 read average voltage level function.

This function reads a desired number of ADC samples and calculates the average voltage level.

Parameters
[in]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
[in]num_conv: Number of ADC samples.
[out]voltage_avg: Average output voltage level [V].
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
The conversion to voltage depends on the entered reference voltage.

◆ hallcurrent22_set_vref()

err_t hallcurrent22_set_vref ( hallcurrent22_t * ctx,
float vref )

Hall Current 22 set vref function.

This function sets the voltage reference for Hall Current 22 Click driver.

Parameters
[in]ctx: Click context object. See hallcurrent22_t object definition for detailed explanation.
[in]vref: Reference voltage (volts).
Returns
  • 0 - Success,
  • -1 - Error. See #err_t definition for detailed explanation.
Note
The default voltage reference set with hallcurrent22_init is 3.3V.