/modules/PowerManagement_1-2/module.h - Annotate - AMiRo-OS - Research for Cognitive Interaction

amiro-os / modules / PowerManagement_1-2 / module.h @ 4c72a54c

History | View | Annotate | Download (30.663 KB)

-            b010278f
+/*
 AMiRo-OS is an operating system designed for the Autonomous Mini Robot (AMiRo) platform.
 Copyright (C) 2016..2019  Thomas Schöpping et al.
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 /**
  * @file
  * @brief   Structures and constant for the PowerManagement module.
+ *
  * @addtogroup powermanagement_module
  * @{
  */
 #ifndef AMIROOS_MODULE_H
 #define AMIROOS_MODULE_H
 #include <amiroos.h>
 /*===========================================================================*/
 /**
  * @name Module specific functions
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief Makro to store data in the core coupled memory (ccm).
  *        Example:
  *        int compute_buffer[128] CCM_RAM;
+ *
  * @note The ccm is not connected to any bus system.
  */
 #define CCM_RAM(...)                            __attribute__((section(".ram4"), ##__VA_ARGS__))
 /**
  * @brief Makro to store data in the ethernet memory (eth).
  *        Example:
  *        int dma_buffer[128] ETH_RAM;
+ *
  * @note The eth is a dedicated memory block with its own DMA controller.
  */
 #define ETH_RAM(...)                            __attribute__((section(".ram2"), ##__VA_ARGS__))
 /**
  * @brief Makro to store data in the backup memory (bckp).
  *        Example:
  *        int backup_buffer[128] BCKP_RAM;
+ *
  * @note The eth is a dedicated memory block with its own DMA controller.
  */
 #define BCKP_RAM(...)                           __attribute__((section(".ram5"), ##__VA_ARGS__))
 /** @} */
 /*===========================================================================*/
 /**
  * @name ChibiOS/HAL configuration
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief   ADC driver for reading the system voltage.
  */
 #define MODULE_HAL_ADC_VSYS                     ADCD1
 /**
  * @brief   Configuration for the ADC.
  */
 extern ADCConversionGroup moduleHalAdcVsysConversionGroup;
 /**
  * @brief   CAN driver to use.
  */
 #define MODULE_HAL_CAN                          CAND1
 /**
  * @brief   Configuration for the CAN driver.
  */
 extern CANConfig moduleHalCanConfig;
 /**
  * @brief   I2C driver to access the sensor ring, power monitors for VIO1.8 and VIO3.3, and fuel gauge (rear battery).
  * @details Depending on the attached sensor ring, the devices connected to this bus vary:
  *          ProximitySensor:
  *            - I2C multiplexer (PCA9544A)
  *            - proximity sensors (VCNL4020) #1 - #4
  *          DistanceSensor (VL53L0X):
  *            TODO
  *          DistanceSensor (VL53L1X):
  *            TODO
  */
 #define MODULE_HAL_I2C_SR_PM18_PM33_GAUGEREAR   I2CD1
 /**
  * @brief   Configuration for the sensor ring, power monitors for VIO1.8 and VIO3.3, and fuel gauge (rear battery) I2C driver.
  * @details Depending on the attached sensor ring, the devices connected to this bus vary:
  *          ProximitySensor:
  *            - I2C multiplexer (PCA9544A)
  *            - proximity sensors (VCNL4020) #1 - #4
  *          DistanceSensor (VL53L0X):
  *            TODO
  *          DistanceSensor (VL53L1X):
  *            TODO
  */
 extern I2CConfig moduleHalI2cSrPm18Pm33GaugeRearConfig;
 /**
  * @brief   I2C driver to access the sensor ring, power monitors for VSYS4.2, VIO5.0 and VDD, EEPROM, and fuel gauge (front battery).
  * @details Depending on the attached sensor ring, the devices connected to this bus vary:
  *          ProximitySensor:
  *            - I2C multiplexer (PCA9544A)
  *            - proximity sensors (VCNL4020) #1 - #4
  *            - touch sensor (MPR121)
  *          DistanceSensor (VL53L0X):
  *            TODO
  *          DistanceSensor (VL53L1X):
  *            TODO
  */
 #define MODULE_HAL_I2C_SR_PM42_PM50_PMVDD_EEPROM_GAUGEFRONT I2CD2
 /**
  * @brief   Configuration for the sensor ring, power monitors for VSYS4.2, VIO5.0 and VDD, EEPROM, and fuel gauge (front battery) I2C driver.
  * @details Depending on the attached sensor ring, the devices connected to this bus vary:
  *          ProximitySensor:
  *            - I2C multiplexer (PCA9544A)
  *            - proximity sensors (VCNL4020) #1 - #4
  *            - touch sensor (MPR121)
  *          DistanceSensor (VL53L0X):
  *            TODO
  *          DistanceSensor (VL53L1X):
  *            TODO
  */
 extern I2CConfig moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig;
 /**
  * @brief   PWM driver for the buzzer.
  */
 #define MODULE_HAL_PWM_BUZZER                   PWMD3
 /**
  * @brief   Configuration of the PWM driver.
  */
 extern PWMConfig moduleHalPwmBuzzerConfig;
 /**
  * @brief   PWM channeö for the buzzer.
  */
 #define MODULE_HAL_PWM_BUZZER_CHANNEL           1
 /**
  * @brief   Serial driver of the programmer interface.
  */
 #define MODULE_HAL_PROGIF                       SD1
 /**
  * @brief   Configuration for the programmer serial interface driver.
  */
 extern SerialConfig moduleHalProgIfConfig;
 /**
  * @brief   Real-Time Clock driver.
  */
 #define MODULE_HAL_RTC                          RTCD1
 /** @} */
 /*===========================================================================*/
 /**
  * @name GPIO definitions
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief   SWITCH_STATUS input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSwitchStatus;
 /**
  * @brief   SYS_REG_EN output signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysRegEn;
 /**
  * @brief   IR_INT1 input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioIrInt1;
 /**
  * @brief   POWER_EN output signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioPowerEn;
 /**
  * @brief   SYS_UART_DN bidirectional signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysUartDn;
 /**
  * @brief   CHARGE_STAT2A input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioChargeStat2A;
 /**
  * @brief   GAUGE_BATLOW2 input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioGaugeBatLow2;
 /**
  * @brief   GAUGE_BATGD2 input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioGaugeBatGd2;
 /**
  * @brief   LED output signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioLed;
 /**
  * @brief   SYS_UART_UP bidirectional signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysUartUp;
 /**
  * @brief   CHARGE_STAT1A input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioChargeStat1A;
 /**
  * @brief   GAUGE_BATLOW1 input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioGaugeBatLow1;
 /**
  * @brief   GAUGE_BATGD1 input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioGaugeBatGd1;
 /**
  * @brief   CHARG_EN1 output signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioChargeEn1;
 /**
  * @brief   IR_INT2 input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioIrInt2;
 /**
  * @brief   TOUCH_INT input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioTouchInt;
 /**
  * @brief   SYS_DONE input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysDone;
 /**
  * @brief   SYS_PROG output signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysProg;
 /**
  * @brief   PATH_DC input signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioPathDc;
 /**
  * @brief   SYS_SPI_DIR bidirectional signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysSpiDir;
 /**
  * @brief   SYS_SYNC bidirectional signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysSync;
 /**
  * @brief   SYS_PD bidirectional signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysPd;
 /**
  * @brief   SYS_WARMRST bidirectional signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioSysWarmrst;
 /**
  * @brief   BT_RST output signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioBtRst;
 /**
  * @brief   CHARGE_EN2 output signal GPIO.
  */
 extern ROMCONST apalControlGpio_t moduleGpioChargeEn2;
 /** @} */
 /*===========================================================================*/
 /**
  * @name AMiRo-OS core configurations
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief   Event flag to be set on a IR_INT1 / CHARGE_STAT1A interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_IRINT1           AOS_IOEVENT_FLAG(PAL_PAD(LINE_IR_INT1_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a GAUGE_BATLOW1 interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_GAUGEBATLOW1     AOS_IOEVENT_FLAG(PAL_PAD(LINE_GAUGE_BATLOW1))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a GAUGE_BATGD1 interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_GAUGEBATGD1      AOS_IOEVENT_FLAG(PAL_PAD(LINE_GAUGE_BATGD1_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a SYS_UART_DN interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_SYSUARTDN        AOS_IOEVENT_FLAG(PAL_PAD(LINE_SYS_UART_DN))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a IR_INT2 / CHARGE_STAT2A interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_IRINT2           AOS_IOEVENT_FLAG(PAL_PAD(LINE_IR_INT2_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a TOUCH_INT interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_TOUCHINT         AOS_IOEVENT_FLAG(PAL_PAD(LINE_TOUCH_INT_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a GAUGE_BATLOW2 interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_GAUGEBATLOW2     AOS_IOEVENT_FLAG(PAL_PAD(LINE_GAUGE_BATLOW2))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a GAUGE_BATGD2 interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_GAUGEBATGD2      AOS_IOEVENT_FLAG(PAL_PAD(LINE_GAUGE_BATGD2_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a PATH_DC interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_PATHDC           AOS_IOEVENT_FLAG(PAL_PAD(LINE_PATH_DC))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a SYS_SPI_DIR interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_SYSSPIDIR        AOS_IOEVENT_FLAG(PAL_PAD(LINE_SYS_SPI_DIR))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a SYS_SYNC interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_SYSSYNC          AOS_IOEVENT_FLAG(PAL_PAD(LINE_SYS_INT_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a SYS_PD interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_SYSPD            AOS_IOEVENT_FLAG(PAL_PAD(LINE_SYS_PD_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a SYS_WARMRST interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_SYSWARMRST       AOS_IOEVENT_FLAG(PAL_PAD(LINE_SYS_WARMRST_N))
-            b010278f
+            Thomas Schöpping
 /**
  * @brief   Event flag to be set on a SYS_UART_UP interrupt.
  */
-e8cc
+#define MODULE_OS_IOEVENTFLAGS_SYSUARTUP        AOS_IOEVENT_FLAG(PAL_PAD(LINE_SYS_UART_UP))
-            b010278f
+            Thomas Schöpping
 #if (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
 /**
  * @brief   Shell prompt text.
  */
 extern ROMCONST char* moduleShellPrompt;
 #endif /* (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) */
 /**
  * @brief   Interrupt initialization macro.
  * @note    SSSP related interrupt signals are already initialized in 'aos_system.c'.
  */
 #define MODULE_INIT_INTERRUPTS() {                                            \
   /* IR_INT1 */                                                               \
-e8cc
+  palSetLineCallback(moduleGpioIrInt1.gpio->line, aosSysGetStdIntCallback(), &moduleGpioIrInt1.gpio->line); \
   palEnableLineEvent(moduleGpioIrInt1.gpio->line, APAL2CH_EDGE(moduleGpioIrInt1.meta.edge));                \
-            b010278f
+  /* GAUGE_BATLOW2 */                                                         \
-e8cc
+  palSetLineCallback(moduleGpioGaugeBatLow2.gpio->line, aosSysGetStdIntCallback(), &moduleGpioGaugeBatLow2.gpio->line); \
   palEnableLineEvent(moduleGpioGaugeBatLow2.gpio->line, APAL2CH_EDGE(moduleGpioGaugeBatLow2.meta.edge));                \
-            b010278f
+  /* GAUGE_BATGD2 */                                                          \
-e8cc
+  palSetLineCallback(moduleGpioGaugeBatGd2.gpio->line, aosSysGetStdIntCallback(), &moduleGpioGaugeBatGd2.gpio->line); \
   palEnableLineEvent(moduleGpioGaugeBatGd2.gpio->line, APAL2CH_EDGE(moduleGpioGaugeBatGd2.meta.edge));                \
-            b010278f
+  /* GAUGE_BATLOW1 */                                                         \
-e8cc
+  palSetLineCallback(moduleGpioGaugeBatLow1.gpio->line, aosSysGetStdIntCallback(), &moduleGpioGaugeBatLow1.gpio->line); \
   palEnableLineEvent(moduleGpioGaugeBatLow1.gpio->line, APAL2CH_EDGE(moduleGpioGaugeBatLow1.meta.edge));                \
-            b010278f
+  /* GAUGE_BATGD1 */                                                          \
-e8cc
+  palSetLineCallback(moduleGpioGaugeBatGd1.gpio->line, aosSysGetStdIntCallback(), &moduleGpioGaugeBatGd1.gpio->line); \
   palEnableLineEvent(moduleGpioGaugeBatGd1.gpio->line, APAL2CH_EDGE(moduleGpioGaugeBatGd1.meta.edge));                \
-            b010278f
+  /* IR_INT2 */                                                               \
-e8cc
+  palSetLineCallback(moduleGpioIrInt2.gpio->line, aosSysGetStdIntCallback(), &moduleGpioIrInt2.gpio->line); \
   palEnableLineEvent(moduleGpioIrInt2.gpio->line, APAL2CH_EDGE(moduleGpioIrInt2.meta.edge));                \
-            b010278f
+  /* TOUCH_INT */                                                             \
-e8cc
+  palSetLineCallback(moduleGpioTouchInt.gpio->line, aosSysGetStdIntCallback(), &moduleGpioTouchInt.gpio->line); \
   palEnableLineEvent(moduleGpioTouchInt.gpio->line, APAL2CH_EDGE(moduleGpioTouchInt.meta.edge));                \
-            b010278f
+  /* PATH_DC */                                                               \
-e8cc
+  palSetLineCallback(moduleGpioPathDc.gpio->line, aosSysGetStdIntCallback(), &moduleGpioPathDc.gpio->line); \
   palEnableLineEvent(moduleGpioPathDc.gpio->line, APAL2CH_EDGE(moduleGpioPathDc.meta.edge));                \
-            b010278f
+  /* SYS_SPI_DIR */                                                           \
-e8cc
+  palSetLineCallback(moduleGpioSysSpiDir.gpio->line, aosSysGetStdIntCallback(), &moduleGpioSysSpiDir.gpio->line); \
   palEnableLineEvent(moduleGpioSysSpiDir.gpio->line, APAL2CH_EDGE(moduleGpioSysSpiDir.meta.edge));                \
-            b010278f
+  /* SYS_WARMRST */                                                           \
-e8cc
+  palSetLineCallback(moduleGpioSysWarmrst.gpio->line, aosSysGetStdIntCallback(), &moduleGpioSysWarmrst.gpio->line); \
   palEnableLineEvent(moduleGpioSysWarmrst.gpio->line, APAL2CH_EDGE(moduleGpioSysWarmrst.meta.edge));                \
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   Test initialization hook.
-            b010278f
+ */
 #define MODULE_INIT_TESTS() {                                                 \
   /* add unit-test shell commands */                                          \
-c72a54c
+  aosShellAddCommand(&aos.shell, &moduleTestAdcShellCmd);                     \
   aosShellAddCommand(&aos.shell, &moduleTestAt24c01bShellCmd);                \
   aosShellAddCommand(&aos.shell, &moduleTestBq241xxShellCmd);                 \
   aosShellAddCommand(&aos.shell, &moduleTestBq27500ShellCmd);                 \
   aosShellAddCommand(&aos.shell, &moduleTestBq27500Bq241xxShellCmd);          \
   aosShellAddCommand(&aos.shell, &moduleTestIna219ShellCmd);                  \
   aosShellAddCommand(&aos.shell, &moduleTestLedShellCmd);                     \
   aosShellAddCommand(&aos.shell, &moduleTestPkxxxexxxShellCmd);               \
   aosShellAddCommand(&aos.shell, &moduleTestTps6211xShellCmd);                \
   aosShellAddCommand(&aos.shell, &moduleTestTps6211xIna219ShellCmd);          \
-            b010278f
+  MODULE_INIT_TEST_SENSORRING();                                              \
-c72a54c
+  aosShellAddCommand(&aos.shell, &moduleTestAllShellCmd);                     \
-            b010278f
+            Thomas Schöpping
 #if (BOARD_SENSORRING == BOARD_PROXIMITYSENSOR) || defined(__DOXYGEN__)
   #define MODULE_INIT_TEST_SENSORRING() {                                     \
-c72a54c
+    aosShellAddCommand(&aos.shell, &moduleTestPca9544aShellCmd);              \
     aosShellAddCommand(&aos.shell, &moduleTestMpr121ShellCmd);                \
     aosShellAddCommand(&aos.shell, &moduleTestVcnl4020ShellCmd);              \
-            b010278f
+            Thomas Schöpping
 #elif (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L0X) || defined(__DOXYGEN__)
   #define MODULE_INIT_TEST_SENSORRING() {                                     \
-c72a54c
+    aosShellAddCommand(&aos.shell, &moduleTestPcal6524ShellCmd);              \
     aosShellAddCommand(&aos.shell, &moduleTestAt42qt1050ShellCmd);            \
-            b010278f
+            Thomas Schöpping
 #elif (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L1X) || defined(__DOXYGEN__)
   #define MODULE_INIT_TEST_SENSORRING() {                                     \
-c72a54c
+    aosShellAddCommand(&aos.shell, &moduleTestPcal6524ShellCmd);              \
     aosShellAddCommand(&aos.shell, &moduleTestAt42qt1050ShellCmd);            \
-            b010278f
+            Thomas Schöpping
 #else /* (BOARD_SENSORRING == ?) */
   #define MODULE_INIT_TEST_SENSORRING()         {}
 #endif /* (BOARD_SENSORRING == ?) */
 /**
  * @brief   Periphery communication interfaces initialization hook.
  */
-c72a54c
+#define MODULE_INIT_PERIPHERY_IF() {                                          \
   MODULE_INIT_PERIPHERY_IF_SENSORRING();                                      \
-            b010278f
+  /* serial driver */                                                         \
   sdStart(&MODULE_HAL_PROGIF, &moduleHalProgIfConfig);                        \
   /* I2C */                                                                   \
   moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed = (INA219_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed) ? INA219_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed;  \
   moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed = (BQ27500_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed) ? BQ27500_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed;  \
   moduleHalI2cSrPm18Pm33GaugeRearConfig.duty_cycle = (moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed <= 100000) ? STD_DUTY_CYCLE : FAST_DUTY_CYCLE_2;  \
   i2cStart(&MODULE_HAL_I2C_SR_PM18_PM33_GAUGEREAR, &moduleHalI2cSrPm18Pm33GaugeRearConfig); \
   moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (INA219_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? INA219_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed; \
   moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (AT24C01B_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? AT24C01B_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed; \
   moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (BQ27500_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? BQ27500_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed; \
   moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.duty_cycle = (moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed <= 100000) ? STD_DUTY_CYCLE : FAST_DUTY_CYCLE_2;  \
   i2cStart(&MODULE_HAL_I2C_SR_PM42_PM50_PMVDD_EEPROM_GAUGEFRONT, &moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig);  \
   /* ADC */                                                                   \
   adcStart(&MODULE_HAL_ADC_VSYS, NULL);                                       \
   /* PWM */                                                                   \
   pwmStart(&MODULE_HAL_PWM_BUZZER, &moduleHalPwmBuzzerConfig);                \
   moduleHalPwmBuzzerConfig.frequency = MODULE_HAL_PWM_BUZZER.clock;           \
   pwmStop(&MODULE_HAL_PWM_BUZZER);                                            \
   moduleHalPwmBuzzerConfig.period = moduleHalPwmBuzzerConfig.frequency / PKxxxExxx_LLD_FREQUENCY_SPEC; \
   pwmStart(&MODULE_HAL_PWM_BUZZER, &moduleHalPwmBuzzerConfig);                \
+}
 #if (BOARD_SENSORRING == BOARD_PROXIMITYSENSOR) || defined(__DOXYGEN__)
-c72a54c
+  #define MODULE_INIT_PERIPHERY_IF_SENSORRING() {                             \
-            b010278f
+    moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed = (PCA9544A_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed) ? PCA9544A_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed;  \
     moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed = (VCNL4020_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed) ? VCNL4020_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed;  \
     moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (PCA9544A_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? PCA9544A_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed; \
     moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (VCNL4020_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? VCNL4020_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed; \
     moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (MPR121_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? MPR121_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed; \
+  }
 #elif (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L0X) || defined(__DOXYGEN__)
-c72a54c
+  #define MODULE_INIT_PERIPHERY_IF_SENSORRING() {                             \
-            b010278f
+    moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed = (PCAL6524_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed) ? PCAL6524_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed;  \
     moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (PCAL6524_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? PCAL6524_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed;  \
     moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (AT42QT1050_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? AT42QT1050_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed;  \
+  }
 #elif (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L1X) || defined(__DOXYGEN__)
-c72a54c
+  #define MODULE_INIT_PERIPHERY_IF_SENSORRING() {                             \
-            b010278f
+    moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed = (PCAL6524_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed) ? PCAL6524_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm18Pm33GaugeRearConfig.clock_speed;  \
     moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (PCAL6524_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? PCAL6524_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed;  \
     moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed = (AT42QT1050_LLD_I2C_MAXFREQUENCY < moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed) ? AT42QT1050_LLD_I2C_MAXFREQUENCY : moduleHalI2cSrPm42Pm50PmVddEepromGaugeFrontConfig.clock_speed;  \
+  }
 #else /* (BOARD_SENSORRING == ?) */
-c72a54c
+  #define MODULE_INIT_PERIPHERY_IF_SENSORRING() {}
-            b010278f
+#endif /* (BOARD_SENSORRING == ?) */
 /**
  * @brief   Periphery communication interface deinitialization hook.
  */
-c72a54c
+#define MODULE_SHUTDOWN_PERIPHERY_IF() {                                      \
-            b010278f
+  /* PWM */                                                                   \
   pwmStop(&MODULE_HAL_PWM_BUZZER);                                            \
   /* ADC */                                                                   \
   adcStop(&MODULE_HAL_ADC_VSYS);                                              \
   /* I2C */                                                                   \
   i2cStop(&MODULE_HAL_I2C_SR_PM18_PM33_GAUGEREAR);                            \
   i2cStop(&MODULE_HAL_I2C_SR_PM42_PM50_PMVDD_EEPROM_GAUGEFRONT);              \
   /* don't stop the serial driver so messages can still be printed */         \
+}
 /** @} */
 /*===========================================================================*/
 /**
  * @name Startup Shutdown Synchronization Protocol (SSSP)
  * @{
  */
 /*===========================================================================*/
 /**
  * @brief   PD signal GPIO.
  */
 #define moduleSsspGpioPd                        moduleGpioSysPd
 /**
  * @brief   SYNC signal GPIO.
  */
 #define moduleSsspGpioSync                       moduleGpioSysSync
 /**
  * @brief   DN signal GPIO.
  */
 #define moduleSsspGpioDn                        moduleGpioSysUartDn
 /**
  * @brief   UP signal GPIO.
  */
 #define moduleSsspGpioUp                        moduleGpioSysUartUp
 /**
  * @brief   Event flags for PD signal events.
  */
 #define MODULE_SSSP_EVENTFLAGS_PD               MODULE_OS_IOEVENTFLAGS_SYSPD
 /**
  * @brief   Event flags for SYNC signal events.
  */
 #define MODULE_SSSP_EVENTFLAGS_SYNC             MODULE_OS_IOEVENTFLAGS_SYSSYNC
 /**
  * @brief   Event flags for UP signal events.
  */
 #define MODULE_SSSP_EVENTFLAGS_UP               MODULE_OS_IOEVENTFLAGS_SYSUARTUP
 /**
  * @brief   Event flags for DN signal events.
  */
 #define MODULE_SSSP_EVENTFLAGS_DN               MODULE_OS_IOEVENTFLAGS_SYSUARTDN
 /** @} */
 /*===========================================================================*/
 /**
  * @name Low-level drivers
  * @{
  */
 /*===========================================================================*/
 #include <alld_AT24C01B.h>
 #include <alld_bq241xx.h>
 #include <alld_bq27500.h>
 #include <alld_INA219.h>
 #include <alld_LED.h>
 #include <alld_PKxxxExxx.h>
 #include <alld_TPS6211x.h>
 /**
  * @brief   EEPROM driver.
  */
 extern AT24C01BDriver moduleLldEeprom;
 /**
  * @brief   Battery charger (front battery) driver.
  */
 extern BQ241xxDriver moduleLldBatteryChargerFront;
 /**
  * @brief   Battery charger (rear battery) driver.
  */
 extern BQ241xxDriver moduleLldBatteryChargerRear;
 /**
  * @brief   Fuel gauge (front battery) driver.
  */
 extern BQ27500Driver moduleLldFuelGaugeFront;
 /**
  * @brief   Fuel gauge (rear battery) driver.
  */
 extern BQ27500Driver moduleLldFuelGaugeRear;
 /**
  * @brief   Power monitor (VDD) driver.
  */
 extern INA219Driver moduleLldPowerMonitorVdd;
 /**
  * @brief   Power monitor (VIO 1.8) driver.
  */
 extern INA219Driver moduleLldPowerMonitorVio18;
 /**
  * @brief   Power monitor (VIO 3.3) driver.
  */
 extern INA219Driver moduleLldPowerMonitorVio33;
 /**
  * @brief   Power monitor (VSYS 4.2) driver.
  */
 extern INA219Driver moduleLldPowerMonitorVsys42;
 /**
  * @brief   Power monitor (VIO 5.0) driver.
  */
 extern INA219Driver moduleLldPowerMonitorVio50;
 /**
  * @brief   Status LED driver.
  */
 extern LEDDriver moduleLldStatusLed;
 /**
  * @brief   Step down converter driver.
  * @note    Although there multiple TPS6211x, those are completely identical from driver few (share the same signals).
  */
 extern TPS6211xDriver moduleLldStepDownConverter;
 #if (BOARD_SENSORRING == BOARD_PROXIMITYSENSOR) || defined(__DOXYGEN__)
 #include <alld_MPR121.h>
 #include <alld_PCA9544A.h>
 #include <alld_VCNL4020.h>
 /**
  * @brief   Touch sensor driver.
  */
 extern MPR121Driver moduleLldTouch;
 /**
  * @brief   I2C multiplexer (I2C #1) driver.
  */
 extern PCA9544ADriver moduleLldI2cMultiplexer1;
 /**
  * @brief   I2C multiplexer (I2C #2) driver.
  */
 extern PCA9544ADriver moduleLldI2cMultiplexer2;
 /**
  * @brief   Proximity sensor (I2C #1) driver.
  */
 extern VCNL4020Driver moduleLldProximity1;
 /**
  * @brief   Proximity sensor (I2C #2) driver.
  */
 extern VCNL4020Driver moduleLldProximity2;
 #endif /* (BOARD_SENSORRING == BOARD_PROXIMITYSENSOR) */
 #if (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L0X) || defined(__DOXYGEN__)
 #include <alld_PCAL6524.h>
 #include <alld_AT42QT1050.h>
 /**
  * @brief   GPIO extender (I2C #1) driver.
  */
 extern PCAL6524Driver moduleLldGpioExtender1;
 /**
  * @brief   GPIO extender (I2C #2) driver.
  */
 extern PCAL6524Driver moduleLldGpioExtender2;
 /**
  * @brief   Touch sensor driver.
  */
 extern AT42QT1050Driver moduleLldTouch;
 #endif /* (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L0X) */
 #if (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L1X) || defined(__DOXYGEN__)
 #include <alld_PCAL6524.h>
 #include <alld_AT42QT1050.h>
 /**
  * @brief   GPIO extender (I2C #1) driver.
  */
 extern PCAL6524Driver moduleLldGpioExtender1;
 /**
  * @brief   GPIO extender (I2C #2) driver.
  */
 extern PCAL6524Driver moduleLldGpioExtender2;
 /**
  * @brief   Touch sensor driver.
  */
 extern AT42QT1050Driver moduleLldTouch;
 #endif /* (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L1X) */
 /** @} */
 /*===========================================================================*/
 /**
-c72a54c
+ * @name Tests
-            b010278f
+ * @{
  */
 /*===========================================================================*/
 #if (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
 /**
-c72a54c
+ * @brief   ADC test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestAdcShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   AT24C01BN-SH-B (EEPROM) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestAt24c01bShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   bq24103a (battery charger) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestBq241xxShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   bq27500 (fuel gauge) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestBq27500ShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   bq27500 (fuel gauge) in combination with bq24103a (battery charger) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestBq27500Bq241xxShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   INA219 (power monitor) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestIna219ShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   Status LED test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestLedShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   PKLCS1212E4001 (buzzer) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestPkxxxexxxShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   TPS62113 (step-down converter) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestTps6211xShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   TPS62113 (step-sown converter) in combination with INA219 (power monitor) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestTps6211xIna219ShellCmd;
-            b010278f
+            Thomas Schöpping
 #if (BOARD_SENSORRING == BOARD_PROXIMITYSENSOR) || defined(__DOXYGEN__)
 /**
-c72a54c
+ * @brief   MPR121 (touch sensor) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestMpr121ShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   PCA9544A (I2C multiplexer) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestPca9544aShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   VCNL4020 (proximity sensor) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestVcnl4020ShellCmd;
-            b010278f
+            Thomas Schöpping
 #endif /* (BOARD_SENSORRING == BOARD_PROXIMITYSENSOR) */
 #if (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L0X) || defined(__DOXYGEN__)
 /**
-c72a54c
+ * @brief   PCAL6524 (GPIO extender) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestPcal6524ShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   AT42QT1050 (touch sensor) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestAt42qt1050ShellCmd;
-            b010278f
+            Thomas Schöpping
 #endif /* (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L0X) */
 #if (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L1X) || defined(__DOXYGEN__)
 /**
-c72a54c
+ * @brief   PCAL6524 (GPIO extender) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestPcal6524ShellCmd;
-            b010278f
+            Thomas Schöpping
 /**
-c72a54c
+ * @brief   AT42QT1050 (touch sensor) test command.
-            b010278f
+ */
-c72a54c
+extern aos_shellcommand_t moduleTestAt42qt1050ShellCmd;
-            b010278f
+            Thomas Schöpping
 #endif /* (BOARD_SENSORRING == BOARD_DISTANCESENSOR_VL53L1X) */
-c72a54c
+/**
  * @brief   Entire module test command.
  */
 extern aos_shellcommand_t moduleTestAllShellCmd;
-            b010278f
+#endif /* (AMIROOS_CFG_TESTS_ENABLE == true) */
 /** @} */
 #endif /* AMIROOS_MODULE_H */
 /** @} */