#pragma once #include #include #include #ifdef __cplusplus extern "C" { #endif /** Init I2C */ void api_hal_i2c_init(); /** * Perform I2C tx transfer * @param instance I2C_TypeDef instance * @param address I2C slave address * @param data pointer to data buffer * @param size size of data buffer * @param timeout timeout in CPU ticks * @return true on successful transfer, false otherwise */ bool api_hal_i2c_tx( I2C_TypeDef* instance, const uint8_t address, const uint8_t* data, const uint8_t size, uint32_t timeout); /** * Perform I2C rx transfer * @param instance I2C_TypeDef instance * @param address I2C slave address * @param data pointer to data buffer * @param size size of data buffer * @param timeout timeout in CPU ticks * @return true on successful transfer, false otherwise */ bool api_hal_i2c_rx( I2C_TypeDef* instance, const uint8_t address, uint8_t* data, const uint8_t size, uint32_t timeout); /** * Perform I2C tx and rx transfers * @param instance I2C_TypeDef instance * @param address I2C slave address * @param tx_data pointer to tx data buffer * @param tx_size size of tx data buffer * @param rx_data pointer to rx data buffer * @param rx_size size of rx data buffer * @param timeout timeout in CPU ticks * @return true on successful transfer, false otherwise */ bool api_hal_i2c_trx( I2C_TypeDef* instance, const uint8_t address, const uint8_t* tx_data, const uint8_t tx_size, uint8_t* rx_data, const uint8_t rx_size, uint32_t timeout); /** Acquire I2C mutex */ void api_hal_i2c_lock(); /** Release I2C mutex */ void api_hal_i2c_unlock(); /** * With clause for I2C peripheral * @param type type of function_body * @param pointer pointer to return of function_body * @param function_body a (){} lambda declaration, executed with I2C mutex acquired */ #define with_api_hal_i2c(type, pointer, function_body) \ { \ api_hal_i2c_lock(); \ *pointer = ({ type __fn__ function_body __fn__; })(); \ api_hal_i2c_unlock(); \ } #ifdef __cplusplus } #endif