git-svn-id: svn://svn.code.sf.net/p/chibios/svn/trunk@1481 35acf78f-673a-0410-8e92-d51de3d6d3f4

os/hal/templates/halconf.h

@@ -27,14 +27,23 @@
 /*
  * HAL configuration file, this file allows to enable or disable the various
  * device drivers from your application. You may also use this file in order
- * to change the device drivers settings found in the low level drivers
- * headers, just define here the new settings and those will override the
- * defaults defined in the LLD headers.
+ * to override the device drivers default settings.
  */
 
 #ifndef _HALCONF_H_
 #define _HALCONF_H_
 
+/*
+ * Uncomment the following line in order to include a mcu-related
+ * settings file. This file can be used to include platform specific
+ * header files or to override the low level drivers settings.
+ */
+/*#include "mcuconf.h"*/
+
+/*===========================================================================*/
+/* PAL driver related settings.                                              */
+/*===========================================================================*/
+
 /**
  * @brief Enables the PAL subsystem.
  */
@@ -42,6 +51,10 @@
 #define CH_HAL_USE_PAL                  TRUE
 #endif
 
+/*===========================================================================*/
+/* ADC driver related settings.                                              */
+/*===========================================================================*/
+
 /**
  * @brief Enables the ADC subsystem.
  */
@@ -49,6 +62,10 @@
 #define CH_HAL_USE_ADC                  TRUE
 #endif
 
+/*===========================================================================*/
+/* CAN driver related settings.                                              */
+/*===========================================================================*/
+
 /**
  * @brief Enables the CAN subsystem.
  */
@@ -56,6 +73,10 @@
 #define CH_HAL_USE_CAN                  TRUE
 #endif
 
+/*===========================================================================*/
+/* MAC driver related settings.                                              */
+/*===========================================================================*/
+
 /**
  * @brief Enables the MAC subsystem.
  */
@@ -63,6 +84,10 @@
 #define CH_HAL_USE_MAC                  TRUE
 #endif
 
+/*===========================================================================*/
+/* PWM driver related settings.                                              */
+/*===========================================================================*/
+
 /**
  * @brief Enables the PWM subsystem.
  */
@@ -70,6 +95,10 @@
 #define CH_HAL_USE_PWM                  TRUE
 #endif
 
+/*===========================================================================*/
+/* SERIAL driver related settings.                                           */
+/*===========================================================================*/
+
 /**
  * @brief Enables the SERIAL subsystem.
  */
@@ -77,6 +106,10 @@
 #define CH_HAL_USE_SERIAL               TRUE
 #endif
 
+/*===========================================================================*/
+/* SPI driver related settings.                                              */
+/*===========================================================================*/
+
 /**
  * @brief Enables the SPI subsystem.
  */
@@ -84,6 +117,15 @@
 #define CH_HAL_USE_SPI                  TRUE
 #endif
 
+/*
+ * Default SPI settings overrides (uncomment to override).
+ */
+/*#define SPI_USE_MUTUAL_EXCLUSION        TRUE*/
+
+/*===========================================================================*/
+/* MMC_SPI driver related settings.                                          */
+/*===========================================================================*/
+
 /**
  * @brief Enables the MMC_SPI subsystem.
  */
@@ -91,6 +133,14 @@
 #define CH_HAL_USE_MMC_SPI              TRUE
 #endif
 
+/*
+ * Default MMC_SPI settings overrides (uncomment to override).
+ */
+/*#define MMC_SECTOR_SIZE                 512*/
+/*#define MMC_NICE_WAITING                TRUE*/
+/*#define MMC_POLLING_INTERVAL            10*/
+/*#define MMC_POLLING_DELAY               10*/
+
 #endif /* _HALCONF_H_ */
 
 /** @} */

readme.txt

@@ -8,6 +8,7 @@
 - FIX: Fixed Linux simulator startup message (bug 2921012).
 - FIX: Fixed section separators comments into the HAL-related files. Now all
   the files should use the same style.
+- NEW: Improved HAL configuration file.
 
 *** 1.3.6 ***
 - FIX: Fixed missing STM32 PWM low level driver error in platform.mk by