[FL-1911] FuriHal: i2c refactoring (#847)

* Project: fix release build, replace asserts with checks.
* FuriHal: i2c refactoring, new bus access model, flexible bus gpio configuration.
* FuriHal: set i2c pins to high on detach.
* FuriHal: more i2c bus events, put bus under reset when not used, move bus enable/disable routine to bus handler.
* FuriHal: fix i2c deadlock in power api, add external i2c handle.

bootloader/targets/f7/furi-hal/furi-hal-i2c.h

@@ -1,31 +1,82 @@
+/**
+ * @file furi-hal-i2c.h
+ * I2C HAL API
+ */
+
 #pragma once
 
 #include <stdbool.h>
 #include <stdint.h>
-#include <furi-hal-resources.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      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 ticks
+ *
+ * @return     true on successful transfer, false otherwise
+ */
 bool furi_hal_i2c_tx(
-    I2C_TypeDef* instance,
+    FuriHalI2cBusHandle* handle,
     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 ticks
+ *
+ * @return     true on successful transfer, false otherwise
+ */
 bool furi_hal_i2c_rx(
-    I2C_TypeDef* instance,
+    FuriHalI2cBusHandle* handle,
     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 ticks
+ *
+ * @return     true on successful transfer, false otherwise
+ */
 bool furi_hal_i2c_trx(
-    I2C_TypeDef* instance,
+    FuriHalI2cBusHandle* handle,
     const uint8_t address,
     const uint8_t* tx_data,
     const uint8_t tx_size,
@@ -33,11 +84,6 @@ bool furi_hal_i2c_trx(
     const uint8_t rx_size,
     uint32_t timeout);
 
-#define with_furi_hal_i2c(type, pointer, function_body)       \
-    {                                                         \
-        *pointer = ({ type __fn__ function_body __fn__; })(); \
-    }
-
 #ifdef __cplusplus
 }
 #endif