d4787e859e
* Power, USB, LED driver improvements * u2f hid descriptor fix * variable_item_list: value alignment fix * InputTypeRepeat handling in menu/submenu/var_item_list * lp5562: fix bugs on 400khz i2c * Scripts: lint in parallel. * FuriHal: rename some USB structure to match naming convention. Drivers: update magic values in LP5562. Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
196 lines
5.2 KiB
C
196 lines
5.2 KiB
C
/**
|
|
* @file furi_hal_i2c.h
|
|
* I2C HAL API
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <furi_hal_i2c_config.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/** Init I2C
|
|
*/
|
|
void furi_hal_i2c_init();
|
|
|
|
/** Acquire i2c bus handle
|
|
*
|
|
* @return Instance of FuriHalI2cBus
|
|
*/
|
|
void furi_hal_i2c_acquire(FuriHalI2cBusHandle* handle);
|
|
|
|
/** Release i2c bus handle
|
|
*
|
|
* @param bus instance of FuriHalI2cBus aquired in `furi_hal_i2c_acquire`
|
|
*/
|
|
void furi_hal_i2c_release(FuriHalI2cBusHandle* handle);
|
|
|
|
/** Perform I2C tx transfer
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param address I2C slave address
|
|
* @param data pointer to data buffer
|
|
* @param size size of data buffer
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_tx(
|
|
FuriHalI2cBusHandle* handle,
|
|
const uint8_t address,
|
|
const uint8_t* data,
|
|
const uint8_t size,
|
|
uint32_t timeout);
|
|
|
|
/** Perform I2C rx transfer
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param address I2C slave address
|
|
* @param data pointer to data buffer
|
|
* @param size size of data buffer
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_rx(
|
|
FuriHalI2cBusHandle* handle,
|
|
const uint8_t address,
|
|
uint8_t* data,
|
|
const uint8_t size,
|
|
uint32_t timeout);
|
|
|
|
/** Perform I2C tx and rx transfers
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle 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 ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_trx(
|
|
FuriHalI2cBusHandle* handle,
|
|
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);
|
|
|
|
/** Perform I2C device register read (8-bit)
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param i2c_addr I2C slave address
|
|
* @param reg_addr register address
|
|
* @param data pointer to register value
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_read_reg_8(
|
|
FuriHalI2cBusHandle* handle,
|
|
uint8_t i2c_addr,
|
|
uint8_t reg_addr,
|
|
uint8_t* data,
|
|
uint32_t timeout);
|
|
|
|
/** Perform I2C device register read (16-bit)
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param i2c_addr I2C slave address
|
|
* @param reg_addr register address
|
|
* @param data pointer to register value
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_read_reg_16(
|
|
FuriHalI2cBusHandle* handle,
|
|
uint8_t i2c_addr,
|
|
uint8_t reg_addr,
|
|
uint16_t* data,
|
|
uint32_t timeout);
|
|
|
|
/** Perform I2C device memory read
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param i2c_addr I2C slave address
|
|
* @param mem_addr memory start address
|
|
* @param data pointer to data buffer
|
|
* @param len size of data buffer
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_read_mem(
|
|
FuriHalI2cBusHandle* handle,
|
|
uint8_t i2c_addr,
|
|
uint8_t mem_addr,
|
|
uint8_t* data,
|
|
uint8_t len,
|
|
uint32_t timeout);
|
|
|
|
/** Perform I2C device register write (8-bit)
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param i2c_addr I2C slave address
|
|
* @param reg_addr register address
|
|
* @param data register value
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_write_reg_8(
|
|
FuriHalI2cBusHandle* handle,
|
|
uint8_t i2c_addr,
|
|
uint8_t reg_addr,
|
|
uint8_t data,
|
|
uint32_t timeout);
|
|
|
|
/** Perform I2C device register write (16-bit)
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param i2c_addr I2C slave address
|
|
* @param reg_addr register address
|
|
* @param data register value
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_write_reg_16(
|
|
FuriHalI2cBusHandle* handle,
|
|
uint8_t i2c_addr,
|
|
uint8_t reg_addr,
|
|
uint16_t data,
|
|
uint32_t timeout);
|
|
|
|
/** Perform I2C device memory
|
|
*
|
|
* @param handle pointer to FuriHalI2cBusHandle instance
|
|
* @param i2c_addr I2C slave address
|
|
* @param mem_addr memory start address
|
|
* @param data pointer to data buffer
|
|
* @param len size of data buffer
|
|
* @param timeout timeout in ticks
|
|
*
|
|
* @return true on successful transfer, false otherwise
|
|
*/
|
|
bool furi_hal_i2c_write_mem(
|
|
FuriHalI2cBusHandle* handle,
|
|
uint8_t i2c_addr,
|
|
uint8_t mem_addr,
|
|
uint8_t* data,
|
|
uint8_t len,
|
|
uint32_t timeout);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|