STM32 support for I/O ports.

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

ports/ARMCM3-STM32F103/port.dox

@@ -19,23 +19,37 @@
 
 /**
  * @defgroup STM32F103 STM32F103 Support
- * @{
  * @brief STM32F103 specific support.
  * @details The STM32F103 support includes:
  * - Buffered, interrupt driven, serial driver.
  * - A demo supporting the kernel test suite.
- *
+ * .
  * @ingroup ARMCM3
  */
-/** @} */
+
+/**
+ * @defgroup STM32F103_IOPORTS I/O Ports Support
+ * @brief I/O Ports peripherals support.
+ * @details This module supports the STM32F103 GPIO controller. The STM32
+ * controller is very flexible and allows to implement all the recommended
+ * behaviors for the I/O port driver. It supports the following features (see
+ * @ref IOPorts):
+ * - 16 bits wide ports.
+ * - Atomic set/reset functions.
+ * - Atomic set+reset function (atomic bus operations).
+ * - Output latched regardless of the pad setting.
+ * - Direct read of input pads regardless of the pad setting.
+ * .
+ * The only non atomic operation is bit toggling.
+ * @ingroup STM32F103
+ */
 
 /**
  * @defgroup STM32F103_SERIAL USART Support
- * @{
  * @brief USART peripherals support.
  * @details The serial driver supports the STM32F103 USARTs in asynchronous
  * mode.
  *
  * @ingroup STM32F103
  */
-/** @} */
+ 

src/include/ioports.h

@@ -116,7 +116,7 @@ typedef struct {
  *       for atomicity and/or portability reasons you may need to enclose port
  *       I/O operations between @p chSysLock() and @p chSysUnlock().
  */
-#define chPortToggle(port, bits) ioport_clear_lld(port, bits)
+#define chPortToggle(port, bits) ioport_toggle_lld(port, bits)
 
 /**
  * @brief Writes a value on an I/O bus.

src/templates/ioports_lld.h

@@ -18,7 +18,7 @@
 */
 
 /**
- * @file ioports_lld.h
+ * @file src/templates/ioports_lld.h
  * @brief I/O ports low level driver
  * @addtogroup IOPortsLLD
  * @{
@@ -118,7 +118,7 @@ typedef uint32_t ioportid_t;
  * @note This function is not meant to be invoked directly by the application
  *       code.
  */
-#define ioport_clear_lld(port, bits)
+#define ioport_toggle_lld(port, bits)
 
 /**
  * @brief Writes a value on an I/O bus.