/modules/LightRing_1-0/module.c - Annotate - AMiRo-OS - Research for Cognitive Interaction

amiro-os / modules / LightRing_1-0 / module.c @ d871cc15

History | View | Annotate | Download (9.543 KB)

-            e545e620
+/*
 AMiRo-OS is an operating system designed for the Autonomous Mini Robot (AMiRo) platform.
-f0ce9e
+Copyright (C) 2016..2019  Thomas Schöpping et al.
-            e545e620
+            Thomas Schöpping
 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/>.
 */
-ba5
+/**
  * @file
  * @brief   Structures and constant for the LightRing v1.0 module.
+ *
  * @addtogroup lightring_module
  * @{
  */
-            e545e620
+#include "module.h"
 /*===========================================================================*/
 /**
  * @name Module specific functions
  * @{
  */
 /*===========================================================================*/
 /** @} */
 /*===========================================================================*/
 /**
  * @name ChibiOS/HAL configuration
  * @{
  */
 /*===========================================================================*/
 CANConfig moduleHalCanConfig = {
   /* mcr  */ CAN_MCR_ABOM | CAN_MCR_AWUM | CAN_MCR_TXFP,
   /* btr  */ CAN_BTR_SJW(1) | CAN_BTR_TS2(2) | CAN_BTR_TS1(13) | CAN_BTR_BRP(1),
 };
 I2CConfig moduleHalI2cEepromConfig = {
   /* I²C mode   */ OPMODE_I2C,
   /* frequency  */ 400000, // TODO: replace with some macro (-> ChibiOS/HAL)
   /* duty cycle */ FAST_DUTY_CYCLE_2,
 };
 SerialConfig moduleHalProgIfConfig = {
   /* bit rate */ 115200,
   /* CR1      */ 0,
   /* CR1      */ 0,
   /* CR1      */ 0,
 };
 SPIConfig moduleHalSpiLightConfig = {
-be0f
+  /* circular buffer mode        */ false,
-            e545e620
+  /* callback function pointer   */ NULL,
   /* chip select line port       */ GPIOC,
   /* chip select line pad number */ GPIOC_LIGHT_XLAT,
   /* CR1                         */ SPI_CR1_BR_0 | SPI_CR1_BR_1,
   /* CR2                         */ SPI_CR2_RXDMAEN | SPI_CR2_TXDMAEN,
-be62dc
+};
-c29a8f
+SPIConfig moduleHalSpiWlConfig = {
-be62dc
+  /* circular buffer mode        */ false,
   /* callback function pointer   */ NULL,
   /* chip select line port       */ GPIOB,
   /* chip select line pad number */ GPIOB_WL_SS_N,
-c29a8f
+  /* CR1                         */ SPI_CR1_BR_0,
-be62dc
+  /* CR2                         */ SPI_CR2_RXDMAEN | SPI_CR2_TXDMAEN,
-            e545e620
+};
 /*===========================================================================*/
 /**
  * @name GPIO definitions
  * @{
  */
 /*===========================================================================*/
-e5f7648
+/**
  * @brief   LIGHT_BANK output signal GPIO.
  */
 static apalGpio_t _gpioLightBlank = {
-            e545e620
+  /* port */ GPIOA,
   /* pad  */ GPIOA_LIGHT_BLANK,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioLightBlank = {
-e5f7648
+  /* GPIO */ &_gpioLightBlank,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_OUTPUT,
     /* active state   */ TLC5947_LLD_BLANK_ACTIVE_STATE,
     /* interrupt edge */ APAL_GPIO_EDGE_NONE,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   LASER_EN output signal GPIO.
  */
 static apalGpio_t _gpioLaserEn = {
-            e545e620
+  /* port */ GPIOB,
   /* pad  */ GPIOB_LASER_EN,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioLaserEn = {
-e5f7648
+  /* GPIO */ &_gpioLaserEn,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_OUTPUT,
     /* active state   */ TPS2051B_LLD_ENABLE_ACTIVE_STATE,
     /* interrupt edge */ APAL_GPIO_EDGE_NONE,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   LASER_OC input signal GPIO.
  */
 static apalGpio_t _gpioLaserOc = {
-            e545e620
+  /* port */ GPIOB,
   /* pad  */ GPIOB_LASER_OC_N,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioLaserOc = {
-e5f7648
+  /* GPIO */ &_gpioLaserOc,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_INPUT,
     /* active state   */ TPS2051B_LLD_OVERCURRENT_ACTIVE_STATE,
     /* interrupt edge */ APAL_GPIO_EDGE_BOTH,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   SYS_UART_DN bidirectional signal GPIO.
  */
 static apalGpio_t _gpioSysUartDn = {
-            e545e620
+  /* port */ GPIOB,
   /* pad  */ GPIOB_SYS_UART_DN,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioSysUartDn = {
-e5f7648
+  /* GPIO */ &_gpioSysUartDn,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_BIDIRECTIONAL,
     /* active state   */ APAL_GPIO_ACTIVE_LOW,
     /* interrupt edge */ APAL_GPIO_EDGE_BOTH,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   WL_GDO2 input signal GPIO.
  */
 static apalGpio_t _gpioWlGdo2 = {
-            e545e620
+  /* port */ GPIOB,
   /* pad  */ GPIOB_WL_GDO2,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioWlGdo2 = {
-e5f7648
+  /* GPIO */ &_gpioWlGdo2,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_INPUT,
     /* active state   */ APAL_GPIO_ACTIVE_HIGH,
     /* interrupt edge */ APAL_GPIO_EDGE_BOTH,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   WL_GDO0 input signal GPIO.
  */
 static apalGpio_t _gpioWlGdo0= {
-            e545e620
+  /* port */ GPIOB,
   /* pad  */ GPIOB_WL_GDO0,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioWlGdo0 = {
-e5f7648
+  /* GPIO */ &_gpioWlGdo0,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_INPUT,
     /* active state   */ APAL_GPIO_ACTIVE_HIGH,
     /* interrupt edge */ APAL_GPIO_EDGE_BOTH,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   LIGHT_XLAT output signal GPIO.
  */
 static apalGpio_t _gpioLightXlat = {
-            e545e620
+  /* port */ GPIOC,
   /* pad  */ GPIOC_LIGHT_XLAT,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioLightXlat = {
-e5f7648
+  /* GPIO */ &_gpioLightXlat,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_OUTPUT,
     /* active state   */ TLC5947_LLD_XLAT_ACTIVE_STATE,
     /* interrupt edge */ APAL_GPIO_EDGE_NONE,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   SYS_PD bidirectional signal GPIO.
  */
 static apalGpio_t _gpioSysPd = {
-            e545e620
+  /* port */ GPIOC,
   /* pad  */ GPIOC_SYS_PD_N,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioSysPd = {
-e5f7648
+  /* GPIO */ &_gpioSysPd,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_BIDIRECTIONAL,
     /* active state   */ APAL_GPIO_ACTIVE_LOW,
     /* interrupt edge */ APAL_GPIO_EDGE_BOTH,
   },
 };
-            e545e620
+            Thomas Schöpping
-e5f7648
+/**
  * @brief   SYS_SYNC bidirectional signal GPIO.
  */
 static apalGpio_t _gpioSysSync = {
-            e545e620
+  /* port */ GPIOD,
   /* pad  */ GPIOD_SYS_INT_N,
 };
-            acc97cbf
+ROMCONST apalControlGpio_t moduleGpioSysSync = {
-e5f7648
+  /* GPIO */ &_gpioSysSync,
   /* meta */ {
     /* direction      */ APAL_GPIO_DIRECTION_BIDIRECTIONAL,
     /* active state   */ APAL_GPIO_ACTIVE_LOW,
     /* interrupt edge */ APAL_GPIO_EDGE_BOTH,
   },
 };
-            e545e620
+            Thomas Schöpping
 /** @} */
 /*===========================================================================*/
 /**
  * @name AMiRo-OS core configurations
  * @{
  */
 /*===========================================================================*/
-dd2e257
+#if (AMIROOS_CFG_SHELL_ENABLE == true) || (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
-            acc97cbf
+ROMCONST char* moduleShellPrompt = "LightRing";
-b53f6bf
+#endif
 /** @} */
 /*===========================================================================*/
 /**
  * @name Startup Shutdown Synchronization Protocol (SSSP)
  * @{
  */
 /*===========================================================================*/
-            e545e620
+/** @} */
 /*===========================================================================*/
 /**
  * @name Low-level drivers
  * @{
  */
 /*===========================================================================*/
 AT24C01BNDriver moduleLldEeprom = {
   /* I2C driver   */ &MODULE_HAL_I2C_EEPROM,
   /* I2C address  */ 0x00u,
 };
 TLC5947Driver moduleLldLedPwm = {
   /* SPI driver         */ &MODULE_HAL_SPI_LIGHT,
-e5f7648
+  /* BLANK signal GPIO  */ &moduleGpioLightBlank,
   /* XLAT signal GPIO   */ &moduleGpioLightXlat,
-            e545e620
+};
 TPS2051BDriver moduleLldPowerSwitchLaser = {
-e5f7648
+  /* laser enable GPIO      */ &moduleGpioLaserEn,
   /* laser overcurrent GPIO */ &moduleGpioLaserOc,
-            e545e620
+};
 /** @} */
 /*===========================================================================*/
 /**
  * @name Unit tests (UT)
  * @{
  */
 /*===========================================================================*/
 #if (AMIROOS_CFG_TESTS_ENABLE == true) || defined(__DOXYGEN__)
-be006e0
+/*
  * EEPROM (AT24C01BN)
  */
-            e545e620
+static int _utShellCmdCb_AlldAt24c01bn(BaseSequentialStream* stream, int argc, char* argv[])
+{
   (void)argc;
   (void)argv;
   aosUtRun(stream, &moduleUtAlldAt24c01bn, NULL);
   return AOS_OK;
+}
 static ut_at24c01bndata_t _utAt24c01bnData = {
   /* driver   */ &moduleLldEeprom,
   /* timeout  */ MICROSECONDS_PER_SECOND,
 };
 aos_unittest_t moduleUtAlldAt24c01bn = {
   /* name           */ "AT24C01BN-SH-B",
   /* info           */ "1kbit EEPROM",
   /* test function  */ utAlldAt24c01bnFunc,
   /* shell command  */ {
     /* name     */ "unittest:EEPROM",
     /* callback */ _utShellCmdCb_AlldAt24c01bn,
     /* next     */ NULL,
   },
   /* data           */ &_utAt24c01bnData,
 };
-be006e0
+/*
  * LED PWM driver (TLD5947)
  */
-            e545e620
+static int _utShellCmdCb_Tlc5947(BaseSequentialStream* stream, int argc, char* argv[])
+{
   (void)argc;
   (void)argv;
   aosUtRun(stream, &moduleUtAlldTlc5947, NULL);
   return AOS_OK;
+}
 aos_unittest_t moduleUtAlldTlc5947 = {
   /* info           */ "TLC5947",
   /* name           */ "LED PWM driver",
   /* test function  */ utAlldTlc5947Func,
   /* shell command  */ {
     /* name     */ "unittest:Lights",
     /* callback */ _utShellCmdCb_Tlc5947,
     /* next     */ NULL,
   },
   /* data           */ &moduleLldLedPwm,
 };
-be006e0
+/*
  * power switch (Laser)
  */
-            e545e620
+static int _utShellCmdCb_Tps2051bdbv(BaseSequentialStream* stream, int argc, char* argv[])
+{
   (void)argc;
   (void)argv;
   aosUtRun(stream,&moduleUtAlldTps2051bdbv, NULL);
   return AOS_OK;
+}
 aos_unittest_t moduleUtAlldTps2051bdbv = {
   /* info           */ "TPS2051BDBV",
   /* name           */ "current-limited power switch",
   /* test function  */ utAlldTps2051bdbvFunc,
   /* shell command  */ {
     /* name     */ "unittest:PowerSwitch",
     /* callback */ _utShellCmdCb_Tps2051bdbv,
     /* next     */ NULL,
   },
   /* data           */ &moduleLldPowerSwitchLaser,
 };
 #endif /* AMIROOS_CFG_TESTS_ENABLE == true */
 /** @} */
-ba8a
+/** @} */