Minor fixes

git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@11750 110e8d01-0319-4d1e-a829-52ad28d1bb01

3 files changed, 163 insertions, 95 deletions

diff --git a/os/hal/include/hal_mac.h b/os/hal/include/hal_mac.h
index 5e6777e9d..00a73a821 100644
--- a/os/hal/include/hal_mac.h
+++ b/os/hal/include/hal_mac.h
@@ -86,7 +86,7 @@ typedef struct MACDriver MACDriver;
  * @{

  */

 /**

- * @brief   Returns the received frames event source.

+ * @brief   Enables the zero-copy API.

  *

  * @param[in] macp      pointer to the @p MACDriver object

  * @return              The pointer to the @p EventSource structure.

diff --git a/os/hal/include/hal_spi.h b/os/hal/include/hal_spi.h
index 6390f677a..3649c7508 100644
--- a/os/hal/include/hal_spi.h
+++ b/os/hal/include/hal_spi.h
@@ -77,7 +77,7 @@
 #endif

 

 /**

- * @brief   Enables the use of the .

+ * @brief   Handling method for SPI CS line.

  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(SPI_SELECT_MODE) || defined(__DOXYGEN__)

diff --git a/os/hal/templates/halconf.h b/os/hal/templates/halconf.h
index 84f39392c..2eac78b5e 100644
--- a/os/hal/templates/halconf.h
+++ b/os/hal/templates/halconf.h
@@ -28,171 +28,187 @@
 #ifndef HALCONF_H

 #define HALCONF_H

 

+#define _CHIBIOS_HAL_CONF_

+#define _CHIBIOS_HAL_CONF_VER_6_0_

+

 #include "mcuconf.h"

 

 /**

- * @name    Drivers enable switches

- */

-/**

  * @brief   Enables the PAL subsystem.

  */

 #if !defined(HAL_USE_PAL) || defined(__DOXYGEN__)

-#define HAL_USE_PAL                 TRUE

+#define HAL_USE_PAL                         TRUE

 #endif

 

 /**

  * @brief   Enables the ADC subsystem.

  */

 #if !defined(HAL_USE_ADC) || defined(__DOXYGEN__)

-#define HAL_USE_ADC                 TRUE

+#define HAL_USE_ADC                         TRUE

 #endif

 

 /**

  * @brief   Enables the CAN subsystem.

  */

 #if !defined(HAL_USE_CAN) || defined(__DOXYGEN__)

-#define HAL_USE_CAN                 TRUE

+#define HAL_USE_CAN                         TRUE

 #endif

 

 /**

  * @brief   Enables the cryptographic subsystem.

  */

 #if !defined(HAL_USE_CRY) || defined(__DOXYGEN__)

-#define HAL_USE_CRY                 TRUE

+#define HAL_USE_CRY                         TRUE

 #endif

 

 /**

  * @brief   Enables the DAC subsystem.

  */

 #if !defined(HAL_USE_DAC) || defined(__DOXYGEN__)

-#define HAL_USE_DAC                 TRUE

+#define HAL_USE_DAC                         TRUE

 #endif

 

 /**

  * @brief   Enables the EXT subsystem.

  */

 #if !defined(HAL_USE_EXT) || defined(__DOXYGEN__)

-#define HAL_USE_EXT                 TRUE

+#define HAL_USE_EXT                         TRUE

 #endif

 

 /**

  * @brief   Enables the GPT subsystem.

  */

 #if !defined(HAL_USE_GPT) || defined(__DOXYGEN__)

-#define HAL_USE_GPT                 TRUE

+#define HAL_USE_GPT                         TRUE

 #endif

 

 /**

  * @brief   Enables the I2C subsystem.

  */

 #if !defined(HAL_USE_I2C) || defined(__DOXYGEN__)

-#define HAL_USE_I2C                 TRUE

+#define HAL_USE_I2C                         TRUE

 #endif

 

 /**

  * @brief   Enables the I2S subsystem.

  */

 #if !defined(HAL_USE_I2S) || defined(__DOXYGEN__)

-#define HAL_USE_I2S                 TRUE

+#define HAL_USE_I2S                         TRUE

 #endif

 

 /**

  * @brief   Enables the ICU subsystem.

  */

 #if !defined(HAL_USE_ICU) || defined(__DOXYGEN__)

-#define HAL_USE_ICU                 TRUE

+#define HAL_USE_ICU                         TRUE

 #endif

 

 /**

  * @brief   Enables the MAC subsystem.

  */

 #if !defined(HAL_USE_MAC) || defined(__DOXYGEN__)

-#define HAL_USE_MAC                 TRUE

+#define HAL_USE_MAC                         TRUE

 #endif

 

 /**

  * @brief   Enables the MMC_SPI subsystem.

  */

 #if !defined(HAL_USE_MMC_SPI) || defined(__DOXYGEN__)

-#define HAL_USE_MMC_SPI             TRUE

+#define HAL_USE_MMC_SPI                     TRUE

 #endif

 

 /**

  * @brief   Enables the PWM subsystem.

  */

 #if !defined(HAL_USE_PWM) || defined(__DOXYGEN__)

-#define HAL_USE_PWM                 TRUE

+#define HAL_USE_PWM                         TRUE

 #endif

 

 /**

  * @brief   Enables the QSPI subsystem.

  */

 #if !defined(HAL_USE_QSPI) || defined(__DOXYGEN__)

-#define HAL_USE_QSPI                TRUE

+#define HAL_USE_QSPI                        TRUE

 #endif

 

 /**

  * @brief   Enables the RTC subsystem.

  */

 #if !defined(HAL_USE_RTC) || defined(__DOXYGEN__)

-#define HAL_USE_RTC                 TRUE

+#define HAL_USE_RTC                         TRUE

 #endif

 

 /**

  * @brief   Enables the SDC subsystem.

  */

 #if !defined(HAL_USE_SDC) || defined(__DOXYGEN__)

-#define HAL_USE_SDC                 TRUE

+#define HAL_USE_SDC                         TRUE

 #endif

 

 /**

  * @brief   Enables the SERIAL subsystem.

  */

 #if !defined(HAL_USE_SERIAL) || defined(__DOXYGEN__)

-#define HAL_USE_SERIAL              TRUE

+#define HAL_USE_SERIAL                      TRUE

 #endif

 

 /**

  * @brief   Enables the SERIAL over USB subsystem.

  */

 #if !defined(HAL_USE_SERIAL_USB) || defined(__DOXYGEN__)

-#define HAL_USE_SERIAL_USB          TRUE

+#define HAL_USE_SERIAL_USB                  TRUE

 #endif

 

 /**

  * @brief   Enables the SPI subsystem.

  */

 #if !defined(HAL_USE_SPI) || defined(__DOXYGEN__)

-#define HAL_USE_SPI                 TRUE

+#define HAL_USE_SPI                         TRUE

 #endif

 

 /**

  * @brief   Enables the UART subsystem.

  */

 #if !defined(HAL_USE_UART) || defined(__DOXYGEN__)

-#define HAL_USE_UART                TRUE

+#define HAL_USE_UART                        TRUE

 #endif

 

 /**

  * @brief   Enables the USB subsystem.

  */

 #if !defined(HAL_USE_USB) || defined(__DOXYGEN__)

-#define HAL_USE_USB                 TRUE

+#define HAL_USE_USB                         TRUE

 #endif

 

 /**

  * @brief   Enables the WDG subsystem.

  */

 #if !defined(HAL_USE_WDG) || defined(__DOXYGEN__)

-#define HAL_USE_WDG                 TRUE

+#define HAL_USE_WDG                         TRUE

 #endif

-/** @} */

 

 /*===========================================================================*/

+/* PAL driver related settings.                                              */

+/*===========================================================================*/

+

 /**

- * @name ADC driver related setting

- * @{

+ * @brief   Enables synchronous APIs.

+ * @note    Disabling this option saves both code and data space.

  */

+#if !defined(PAL_USE_CALLBACKS) || defined(__DOXYGEN__)

+#define PAL_USE_CALLBACKS                   FALSE

+#endif

+

+/**

+ * @brief   Enables synchronous APIs.

+ * @note    Disabling this option saves both code and data space.

+ */

+#if !defined(PAL_USE_WAIT) || defined(__DOXYGEN__)

+#define PAL_USE_WAIT                        FALSE

+#endif

+

+/*===========================================================================*/

+/* ADC driver related settings.                                              */

 /*===========================================================================*/

 

 /**

@@ -200,7 +216,7 @@
  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(ADC_USE_WAIT) || defined(__DOXYGEN__)

-#define ADC_USE_WAIT                TRUE

+#define ADC_USE_WAIT                        TRUE

 #endif

 

 /**

@@ -208,67 +224,93 @@
  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(ADC_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)

-#define ADC_USE_MUTUAL_EXCLUSION    TRUE

+#define ADC_USE_MUTUAL_EXCLUSION            TRUE

 #endif

-/** @} */

 

 /*===========================================================================*/

-/**

- * @name CAN driver related setting

- * @{

- */

+/* CAN driver related settings.                                              */

 /*===========================================================================*/

 

 /**

  * @brief   Sleep mode related APIs inclusion switch.

  */

 #if !defined(CAN_USE_SLEEP_MODE) || defined(__DOXYGEN__)

-#define CAN_USE_SLEEP_MODE          TRUE

+#define CAN_USE_SLEEP_MODE                  TRUE

 #endif

-/** @} */

 

 /*===========================================================================*/

+/* CRY driver related settings.                                              */

+/*===========================================================================*/

+

 /**

- * @name I2C driver related setting

- * @{

+ * @brief   Enables the SW fall-back of the cryptographic driver.

+ * @details When enabled, this option, activates a fall-back software

+ *          implementation for algorithms not supported by the underlying

+ *          hardware.

+ * @note    Fall-back implementations may not be present for all algorithms.

  */

+#if !defined(HAL_CRY_USE_FALLBACK) || defined(__DOXYGEN__)

+#define HAL_CRY_USE_FALLBACK                FALSE

+#endif

+

+/**

+ * @brief   Makes the driver forcibly use the fall-back implementations.

+ */

+#if !defined(HAL_CRY_ENFORCE_FALLBACK) || defined(__DOXYGEN__)

+#define HAL_CRY_ENFORCE_FALLBACK            FALSE

+#endif

+

+/*===========================================================================*/

+/* DAC driver related settings.                                              */

 /*===========================================================================*/

 

 /**

- * @brief   Enables the mutual exclusion APIs on the I2C bus.

+ * @brief   Enables synchronous APIs.

+ * @note    Disabling this option saves both code and data space.

  */

-#if !defined(I2C_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)

-#define I2C_USE_MUTUAL_EXCLUSION    TRUE

+#if !defined(DAC_USE_WAIT) || defined(__DOXYGEN__)

+#define DAC_USE_WAIT                        TRUE

+#endif

+

+/**

+ * @brief   Enables the @p dacAcquireBus() and @p dacReleaseBus() APIs.

+ * @note    Disabling this option saves both code and data space.

+ */

+#if !defined(DAC_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)

+#define DAC_USE_MUTUAL_EXCLUSION            TRUE

 #endif

-/** @} */

 

 /*===========================================================================*/

+/* I2C driver related settings.                                              */

+/*===========================================================================*/

+

 /**

- * @name MAC driver related setting

- * @{

+ * @brief   Enables the mutual exclusion APIs on the I2C bus.

  */

+#if !defined(I2C_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)

+#define I2C_USE_MUTUAL_EXCLUSION            TRUE

+#endif

+

+/*===========================================================================*/

+/* MAC driver related settings.                                              */

 /*===========================================================================*/

 

 /**

- * @brief   Enables an event sources for incoming packets.

+ * @brief   Enables the zero-copy API.

  */

 #if !defined(MAC_USE_ZERO_COPY) || defined(__DOXYGEN__)

-#define MAC_USE_ZERO_COPY           TRUE

+#define MAC_USE_ZERO_COPY                   TRUE

 #endif

 

 /**

  * @brief   Enables an event sources for incoming packets.

  */

 #if !defined(MAC_USE_EVENTS) || defined(__DOXYGEN__)

-#define MAC_USE_EVENTS              TRUE

+#define MAC_USE_EVENTS                      TRUE

 #endif

-/** @} */

 

 /*===========================================================================*/

-/**

- * @name MMC_SPI driver related setting

- * @{

- */

+/* MMC_SPI driver related settings.                                          */

 /*===========================================================================*/

 

 /**

@@ -280,15 +322,31 @@
  *          use a DMA channel and heavily loads the CPU.

  */

 #if !defined(MMC_NICE_WAITING) || defined(__DOXYGEN__)

-#define MMC_NICE_WAITING            TRUE

+#define MMC_NICE_WAITING                    TRUE

 #endif

-/** @} */

 

 /*===========================================================================*/

+/* QSPI driver related settings.                                             */

+/*===========================================================================*/

+

 /**

- * @name SDC driver related setting

- * @{

+ * @brief   Enables synchronous APIs.

+ * @note    Disabling this option saves both code and data space.

+ */

+#if !defined(QSPI_USE_WAIT) || defined(__DOXYGEN__)

+#define QSPI_USE_WAIT                       TRUE

+#endif

+

+/**

+ * @brief   Enables the @p qspiAcquireBus() and @p qspiReleaseBus() APIs.

+ * @note    Disabling this option saves both code and data space.

  */

+#if !defined(QSPI_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)

+#define QSPI_USE_MUTUAL_EXCLUSION           TRUE

+#endif

+

+/*===========================================================================*/

+/* SDC driver related settings.                                              */

 /*===========================================================================*/

 

 /**

@@ -296,7 +354,7 @@
  * @note    Attempts are performed at 10mS intervals.

  */

 #if !defined(SDC_INIT_RETRY) || defined(__DOXYGEN__)

-#define SDC_INIT_RETRY              100

+#define SDC_INIT_RETRY                      100

 #endif

 

 /**

@@ -305,7 +363,7 @@
  *          at @p FALSE.

  */

 #if !defined(SDC_MMC_SUPPORT) || defined(__DOXYGEN__)

-#define SDC_MMC_SUPPORT             TRUE

+#define SDC_MMC_SUPPORT                     TRUE

 #endif

 

 /**

@@ -315,15 +373,25 @@
  *          lower priority, this may slow down the driver a bit however.

  */

 #if !defined(SDC_NICE_WAITING) || defined(__DOXYGEN__)

-#define SDC_NICE_WAITING            TRUE

+#define SDC_NICE_WAITING                    TRUE

 #endif

-/** @} */

 

-/*===========================================================================*/

 /**

- * @name SERIAL driver related setting

- * @{

+ * @brief   OCR initialization constant for V20 cards.

  */

+#if !defined(SDC_INIT_OCR_V20) || defined(__DOXYGEN__)

+#define SDC_INIT_OCR_V20                    0x50FF8000U

+#endif

+

+/**

+ * @brief   OCR initialization constant for non-V20 cards.

+ */

+#if !defined(SDC_INIT_OCR) || defined(__DOXYGEN__)

+#define SDC_INIT_OCR                        0x80100000U

+#endif

+

+/*===========================================================================*/

+/* SERIAL driver related settings.                                           */

 /*===========================================================================*/

 

 /**

@@ -332,7 +400,7 @@
  *          default configuration.

  */

 #if !defined(SERIAL_DEFAULT_BITRATE) || defined(__DOXYGEN__)

-#define SERIAL_DEFAULT_BITRATE      38400

+#define SERIAL_DEFAULT_BITRATE              38400

 #endif

 

 /**

@@ -343,15 +411,11 @@
  *          buffers.

  */

 #if !defined(SERIAL_BUFFERS_SIZE) || defined(__DOXYGEN__)

-#define SERIAL_BUFFERS_SIZE         16

+#define SERIAL_BUFFERS_SIZE                 16

 #endif

-/** @} */

 

 /*===========================================================================*/

-/**

- * @name SERIAL_USB driver related setting

- * @{

- */

+/* SERIAL_USB driver related setting.                                        */

 /*===========================================================================*/

 

 /**

@@ -362,7 +426,7 @@
  *          buffers.

  */

 #if !defined(SERIAL_USB_BUFFERS_SIZE) || defined(__DOXYGEN__)

-#define SERIAL_USB_BUFFERS_SIZE     256

+#define SERIAL_USB_BUFFERS_SIZE             256

 #endif

 

 /**

@@ -370,15 +434,11 @@
  * @note    The default is 2 buffers.

  */

 #if !defined(SERIAL_USB_BUFFERS_NUMBER) || defined(__DOXYGEN__)

-#define SERIAL_USB_BUFFERS_NUMBER   2

+#define SERIAL_USB_BUFFERS_NUMBER           2

 #endif

-/** @} */

 

 /*===========================================================================*/

-/**

- * @name SPI driver related setting

- * @{

- */

+/* SPI driver related settings.                                              */

 /*===========================================================================*/

 

 /**

@@ -386,23 +446,36 @@
  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(SPI_USE_WAIT) || defined(__DOXYGEN__)

-#define SPI_USE_WAIT                TRUE

+#define SPI_USE_WAIT                        TRUE

+#endif

+

+/**

+ * @brief   Enables circular transfers APIs.

+ * @note    Disabling this option saves both code and data space.

+ */

+#if !defined(SPI_USE_CIRCULAR) || defined(__DOXYGEN__)

+#define SPI_USE_CIRCULAR                    FALSE

 #endif

 

+

 /**

  * @brief   Enables the @p spiAcquireBus() and @p spiReleaseBus() APIs.

  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(SPI_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)

-#define SPI_USE_MUTUAL_EXCLUSION    TRUE

+#define SPI_USE_MUTUAL_EXCLUSION            TRUE

 #endif

-/** @} */

 

-/*===========================================================================*/

 /**

- * @name UART driver related setting

- * @{

+ * @brief   Handling method for SPI CS line.

+ * @note    Disabling this option saves both code and data space.

  */

+#if !defined(SPI_SELECT_MODE) || defined(__DOXYGEN__)

+#define SPI_SELECT_MODE                     SPI_SELECT_MODE_PAD

+#endif

+

+/*===========================================================================*/

+/* UART driver related settings.                                             */

 /*===========================================================================*/

 

 /**

@@ -410,7 +483,7 @@
  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(UART_USE_WAIT) || defined(__DOXYGEN__)

-#define UART_USE_WAIT               TRUE

+#define UART_USE_WAIT                       TRUE

 #endif

 

 /**

@@ -418,15 +491,11 @@
  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(UART_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)

-#define UART_USE_MUTUAL_EXCLUSION   TRUE

+#define UART_USE_MUTUAL_EXCLUSION           TRUE

 #endif

-/** @} */

 

 /*===========================================================================*/

-/**

- * @name USB driver related setting

- * @{

- */

+/* USB driver related settings.                                              */

 /*===========================================================================*/

 

 /**

@@ -434,9 +503,8 @@
  * @note    Disabling this option saves both code and data space.

  */

 #if !defined(USB_USE_WAIT) || defined(__DOXYGEN__)

-#define USB_USE_WAIT                TRUE

+#define USB_USE_WAIT                        TRUE

 #endif

-/** @} */

 

 #endif /* HALCONF_H */