Library Description

Initializes and defines GPIO port driver and driver functions which are realized for communication via SPI bus and for calculating and converting analog signal to a digital one, according to the value of the referent voltage.

Key functions

uint8_t adc4_writeReg( const uint8_t regAddress, uint8_t *value );- This function writes data in the register determined by register address parameter of the function.

uint8_t adc4_readReg( const uint8_t regAddress, uint8_t *value );- This function reads data from the register determined by register address parameter of the function.

void adc4_reset(void);- This function reset ADC 4 click.

uint8_t adc4_getErrPin(void);- This function returns the value of INT (ERROR) pin which is controlled by ERR_DAT bit in the GPIOCON register.

void adc4_getConfig( const uint8_t regAddress, uint16_t *value );- This function writes the value of the configuration registers in storage determined by pointer value.

void adc4_setConfig( const uint8_t regAddress, uint16_t value );- This function writes a 16-bit value in the configuration registers determined by register address parameter.

uint32_t adc4_getData(void);- This function checks ready bit, is data ready or not, and returns 24-bit value from the data register.

uint16_t adc4_getVoltage(void);- This function returns 16-bit calculated value and AD converted voltage value.

Examples Description

The demo application is composed of three sections:

• System Initialization - Initializes GPIO pins (CS, INT), SPI module for communication with ADC 4 click and UART for data logging.
• Application Initialization - Initializes ADC 4 driver and sets up working mode.
• Application Task - (code snippet) - Sequential read of voltage. Information about the current voltage is logged to UART. Operation is repeated each second. Settings are set to calculate and convert input voltage in the range from -2.5V to 2.5V.

void applicationTask()
{
    voltage = adc4_getVoltage();

    IntToStr( voltage, text );
    mikrobus_logWrite( "Current Voltage : ", _LOG_TEXT );
    mikrobus_logWrite( text, _LOG_TEXT );
    mikrobus_logWrite( " mV", _LOG_LINE );

    Delay_ms( 1000 );
}

Other MikroElektronika libraries used in the example:

• Conversions
• C_String
• SPI
• UART

Additional notes and information

Depending on the development board you are using, you may need USB UART click,  USB UART 2 click or  RS232 click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.