Library Description

The library initializes and defines the I2C bus or SPI bus driver and drivers that offer a choice for writing data in register. The library includes function for read magnetics X/Y/Z axis data, set offset, read interrupt state and read temperature. The user also has the function for initializes chip.

Key functions:

• int16_t c3dhall5_getAxis(uint8_t axis) - Functions for read axis data

• uint8_t c3dhall5_init() - Functions for initialize the chip

• void c3dhall5_writeByte(uint8_t reg, uint8_t _data) - Functions for write one byte in register

Example description

The application is composed of three sections :

• System Initialization - Initializes I2C/SPI module and sets CS pin and RST pin as OUTPUT and INT pin as INPUT
• Application Initialization - Initializes Driver init and chip init
• Application Task - (code snippet) - Reads the magnetics X / Y / Z axis data every 1 seconds.

void applicationTask()
{
    axis_X = c3dhall5_getAxis(_C3DHALL5_AXIS_X);
    mikrobus_logWrite(" X axis : ", _LOG_TEXT);
    IntToStr(axis_X, demoText);
    mikrobus_logWrite(demoText, _LOG_LINE);

    axis_Y = c3dhall5_getAxis(_C3DHALL5_AXIS_Y);
    mikrobus_logWrite(" Y axis : ", _LOG_TEXT);
    IntToStr(axis_Y, demoText);
    mikrobus_logWrite(demoText, _LOG_LINE);
    
    axis_Z = c3dhall5_getAxis(_C3DHALL5_AXIS_Z);
    mikrobus_logWrite(" Z axis : ", _LOG_TEXT);
    IntToStr(axis_Z, demoText);
    mikrobus_logWrite(demoText, _LOG_LINE);
    
    mikrobus_logWrite("  ", _LOG_LINE);
    Delay_ms( 1000 );
}

Other mikroE Libraries used in the example:

• I2C
• 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.