Add optional BMA456 accelerometer init on shared I2C bus.

Probe and configure the sensor when present; log and continue boot if init fails so boards without BMA456 still run normally. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-05-18 22:51:32 +02:00
parent 755bdd92d7
commit e5db0b21c7
168 changed files with 42062 additions and 2 deletions
@@ -0,0 +1,127 @@
+/**\
+ * Copyright (c) 2023 Bosch Sensortec GmbH. All rights reserved.
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ **/
+
+#ifndef COMMON_H
+#define COMMON_H
+
+/*! CPP guard */
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include <stdio.h>
+#include "bma4.h"
+#include "coines.h"
+
+/*!
+ *  @brief Function for reading the sensor's registers through I2C bus.
+ *
+ *  @param[in] reg_addr     : Register address.
+ *  @param[out] reg_data    : Pointer to the data buffer to store the read data.
+ *  @param[in] length       : No of bytes to read.
+ *  @param[in] intf_ptr     : Interface pointer
+ *
+ *  @return Status of execution
+ *  @retval = BMA4_INTF_RET_SUCCESS -> Success
+ *  @retval != BMA4_INTF_RET_SUCCESS  -> Failure Info
+ *
+ */
+BMA4_INTF_RET_TYPE bma4_i2c_read(uint8_t reg_addr, uint8_t *reg_data, uint32_t len, void *intf_ptr);
+
+/*!
+ *  @brief Function for writing the sensor's registers through I2C bus.
+ *
+ *  @param[in] reg_addr     : Register address.
+ *  @param[in] reg_data     : Pointer to the data buffer whose value is to be written.
+ *  @param[in] length       : No of bytes to write.
+ *  @param[in] intf_ptr     : Interface pointer
+ *
+ *  @return Status of execution
+ *  @retval = BMA4_INTF_RET_SUCCESS -> Success
+ *  @retval != BMA4_INTF_RET_SUCCESS  -> Failure Info
+ *
+ */
+BMA4_INTF_RET_TYPE bma4_i2c_write(uint8_t reg_addr, const uint8_t *reg_data, uint32_t len, void *intf_ptr);
+
+/*!
+ *  @brief Function for reading the sensor's registers through SPI bus.
+ *
+ *  @param[in] reg_addr     : Register address.
+ *  @param[out] reg_data    : Pointer to the data buffer to store the read data.
+ *  @param[in] length       : No of bytes to read.
+ *  @param[in] intf_ptr     : Interface pointer
+ *
+ *  @return Status of execution
+ *  @retval = BMA4_INTF_RET_SUCCESS -> Success
+ *  @retval != BMA4_INTF_RET_SUCCESS  -> Failure Info
+ *
+ */
+BMA4_INTF_RET_TYPE bma4_spi_read(uint8_t reg_addr, uint8_t *reg_data, uint32_t len, void *intf_ptr);
+
+/*!
+ *  @brief Function for writing the sensor's registers through SPI bus.
+ *
+ *  @param[in] reg_addr     : Register address.
+ *  @param[in] reg_data     : Pointer to the data buffer whose data has to be written.
+ *  @param[in] length       : No of bytes to write.
+ *  @param[in] intf_ptr     : Interface pointer
+ *
+ *  @return Status of execution
+ *  @retval = BMA4_INTF_RET_SUCCESS -> Success
+ *  @retval != BMA4_INTF_RET_SUCCESS  -> Failure Info
+ *
+ */
+BMA4_INTF_RET_TYPE bma4_spi_write(uint8_t reg_addr, const uint8_t *reg_data, uint32_t len, void *intf_ptr);
+
+/*!
+ * @brief This function provides the delay for required time (Microsecond) as per the input provided in some of the
+ * APIs.
+ *
+ *  @param[in] period_us    : The required wait time in microsecond.
+ *  @param[in] intf_ptr     : Interface pointer
+ *
+ *  @return void.
+ *
+ */
+void bma4_delay_us(uint32_t period, void *intf_ptr);
+
+/*!
+ *  @brief Function to select the interface between SPI and I2C.
+ *
+ *  @param[in] bma      : Structure instance of bma4_dev
+ *  @param[in] intf     : Interface selection parameter
+ *  @param[in] variant  : Variant information of the sensor
+ *                            ( BMA42x variants values - BMA42X_VARIANT / BMA42X_B_VARIANT )
+ *                            ( BMA45x variants values - BMA45X_VARIANT )
+ *
+ *  @return Status of execution
+ *  @retval 0 -> Success
+ *  @retval < 0 -> Failure Info
+ */
+int8_t bma4_interface_init(struct bma4_dev *bma, uint8_t intf, enum bma4_variant variant);
+
+/*!
+ *  @brief Prints the execution status of the APIs.
+ *
+ *  @param[in] api_name : Name of the API whose execution status has to be printed.
+ *  @param[in] rslt     : Error code returned by the API whose execution status has to be printed.
+ *
+ *  @return void.
+ */
+void bma4_error_codes_print_result(const char api_name[], int8_t rslt);
+
+/*!
+ *  @brief Deinitializes coines platform
+ *
+ *  @return void.
+ */
+void bma4_coines_deinit(void);
+
+#ifdef __cplusplus
+}
+#endif /* End of CPP guard */
+
+#endif /* COMMON_H */