aboutsummaryrefslogtreecommitdiff
path: root/lib/stm32/common
diff options
context:
space:
mode:
authorKen Sarkies2013-03-07 11:14:06 +1030
committerKen Sarkies2013-03-07 11:14:06 +1030
commite2022f588492d5c117743b6b13801940f4a4b03e (patch)
tree8c70e829e69094361afa51489ef097a5e663ea6c /lib/stm32/common
parent31aa3b6f5a9e9afa4d1bc8661cbaef147af55f74 (diff)
Repair to documentation (most documented files)
to remove errors, duplications and inconsistencies. File lib/stm32/f1/pwr.c - all code removed as it duplicates that in common/pwr_common.c Remaining changes do not affect code. Compiles OK. TODO efm32 has no code so generates no modules TODO F2 needs pwr.c TODO L1 needs dma.h and dma.c
Diffstat (limited to 'lib/stm32/common')
-rw-r--r--lib/stm32/common/crc_common_all.c6
-rw-r--r--lib/stm32/common/dac_common_all.c6
-rw-r--r--lib/stm32/common/dma_common_f13.c6
-rw-r--r--lib/stm32/common/dma_common_f24.c10
-rw-r--r--lib/stm32/common/gpio_common_all.c6
-rw-r--r--lib/stm32/common/gpio_common_f24.c5
-rw-r--r--lib/stm32/common/i2c_common_all.c7
-rw-r--r--lib/stm32/common/iwdg_common_all.c7
-rw-r--r--lib/stm32/common/pwr_common_all.c14
-rw-r--r--lib/stm32/common/rtc_common_bcd.c6
-rw-r--r--lib/stm32/common/spi_common_all.c8
-rw-r--r--lib/stm32/common/usart_common_all.c8
12 files changed, 23 insertions, 66 deletions
diff --git a/lib/stm32/common/crc_common_all.c b/lib/stm32/common/crc_common_all.c
index d65d1b7..14b35eb 100644
--- a/lib/stm32/common/crc_common_all.c
+++ b/lib/stm32/common/crc_common_all.c
@@ -1,13 +1,9 @@
/** @addtogroup crc_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2012 Karl Palsson <karlp@remake.is>
-@date 15 October 2012
+*/
-LGPL License Terms @ref lgpl_license
- */
/*
* This file is part of the libopencm3 project.
*
diff --git a/lib/stm32/common/dac_common_all.c b/lib/stm32/common/dac_common_all.c
index a6be233..b20b9c3 100644
--- a/lib/stm32/common/dac_common_all.c
+++ b/lib/stm32/common/dac_common_all.c
@@ -1,10 +1,6 @@
/** @addtogroup dac_file
-@version 1.0.0
-
-@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies
-
-@date 18 August 2012
+@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies ksarkies@internode.on.net
This library supports the Digital to Analog Conversion System in the
STM32F series of ARM Cortex Microcontrollers by ST Microelectronics.
diff --git a/lib/stm32/common/dma_common_f13.c b/lib/stm32/common/dma_common_f13.c
index 35b9da6..9ef5b45 100644
--- a/lib/stm32/common/dma_common_f13.c
+++ b/lib/stm32/common/dma_common_f13.c
@@ -1,11 +1,7 @@
/** @addtogroup dma_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
-@date 18 August 2012
-
This library supports the DMA Control System in the STM32 series of ARM Cortex
Microcontrollers by ST Microelectronics.
@@ -42,7 +38,7 @@ LGPL License Terms @ref lgpl_license
/**@{*/
-#include <libopencm3/stm32/f1/dma.h>
+#include <libopencm3/stm32/dma.h>
/*-----------------------------------------------------------------------------*/
/** @brief DMA Channel Reset
diff --git a/lib/stm32/common/dma_common_f24.c b/lib/stm32/common/dma_common_f24.c
index 504c30e..aa20e39 100644
--- a/lib/stm32/common/dma_common_f24.c
+++ b/lib/stm32/common/dma_common_f24.c
@@ -1,11 +1,7 @@
/** @addtogroup dma_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-@date 30 November 2012
-
This library supports the DMA Control System in the STM32F2 and STM32F4
series of ARM Cortex Microcontrollers by ST Microelectronics.
@@ -22,8 +18,8 @@ Each stream has access to a 4 word deep FIFO and can use double buffering
by means of two memory pointers. When using the FIFO it is possible to
configure transfers to occur in indivisible bursts.
-It is also possible to select a peripheral to control the flow of data rather
-than the DMA controller. This limits the functionality but is udeful when the
+It is also possible to select a peripheral instead of the DMA controller to
+control the flow of data. This limits the functionality but is useful when the
number of transfers is unknown.
LGPL License Terms @ref lgpl_license
@@ -49,7 +45,7 @@ LGPL License Terms @ref lgpl_license
/**@{*/
-#include <libopencm3/stm32/f4/dma.h>
+#include <libopencm3/stm32/dma.h>
/*-----------------------------------------------------------------------------*/
/** @brief DMA Stream Reset
diff --git a/lib/stm32/common/gpio_common_all.c b/lib/stm32/common/gpio_common_all.c
index d23e415..ef662e4 100644
--- a/lib/stm32/common/gpio_common_all.c
+++ b/lib/stm32/common/gpio_common_all.c
@@ -1,4 +1,8 @@
-/** @addtogroup gpio_file */
+/** @addtogroup gpio_file
+
+@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/lib/stm32/common/gpio_common_f24.c b/lib/stm32/common/gpio_common_f24.c
index 5b29693..63c18c3 100644
--- a/lib/stm32/common/gpio_common_f24.c
+++ b/lib/stm32/common/gpio_common_f24.c
@@ -1,12 +1,8 @@
/** @addtogroup gpio_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-@date 18 August 2012
-
Each I/O port has 16 individually configurable bits. Many I/O pins share GPIO
functionality with a number of alternate functions and must be configured to the
alternate function mode if these are to be accessed. A feature is available to
@@ -50,7 +46,6 @@ Example 2: Digital input on port C12 with pullup
reg16 = gpio_port_read(GPIOC);
@endcode
-LGPL License Terms @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
diff --git a/lib/stm32/common/i2c_common_all.c b/lib/stm32/common/i2c_common_all.c
index 28ae199..337fe9d 100644
--- a/lib/stm32/common/i2c_common_all.c
+++ b/lib/stm32/common/i2c_common_all.c
@@ -1,12 +1,8 @@
/** @addtogroup i2c_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2010 Thomas Otto <tommi@viadmin.org>
@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-@date 15 October 2012
-
Devices can have up to two I2C peripherals. The peripherals support SMBus and
PMBus variants.
@@ -17,8 +13,7 @@ a multimaster contention is lost or a stop condition is generated.
@todo all sorts of lovely stuff like DMA, Interrupts, SMBus variant, Status
register access, Error conditions
-LGPL License Terms @ref lgpl_license
- */
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/lib/stm32/common/iwdg_common_all.c b/lib/stm32/common/iwdg_common_all.c
index d3d9364..792adfe 100644
--- a/lib/stm32/common/iwdg_common_all.c
+++ b/lib/stm32/common/iwdg_common_all.c
@@ -1,11 +1,7 @@
/** @addtogroup iwdg_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies ksarkies@internode.on.net
-@date 18 August 2012
-
This library supports the Independent Watchdog Timer System in the STM32F1xx
series of ARM Cortex Microcontrollers by ST Microelectronics.
@@ -20,8 +16,7 @@ relevant bit is not set, the IWDG timer must be enabled by software.
@note: Tested: CPU STM32F103RET6, Board ET-ARM Stamp STM32
-LGPL License Terms @ref lgpl_license
- */
+*/
/*
* This file is part of the libopencm3 project.
*
diff --git a/lib/stm32/common/pwr_common_all.c b/lib/stm32/common/pwr_common_all.c
index 451ed1c..a455664 100644
--- a/lib/stm32/common/pwr_common_all.c
+++ b/lib/stm32/common/pwr_common_all.c
@@ -1,19 +1,7 @@
-/** @defgroup STM32F1xx-pwr-file PWR
-
-@ingroup STM32F1xx
-
-@brief <b>libopencm3 STM32F1xx Power Control</b>
-
-@version 1.0.0
+/** @addtogroup pwr-file PWR
@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-@date 18 August 2012
-
-This library supports the power control system for the
-STM32F1 series of ARM Cortex Microcontrollers by ST Microelectronics.
-
-LGPL License Terms @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
diff --git a/lib/stm32/common/rtc_common_bcd.c b/lib/stm32/common/rtc_common_bcd.c
index cddfe9b..ff61a48 100644
--- a/lib/stm32/common/rtc_common_bcd.c
+++ b/lib/stm32/common/rtc_common_bcd.c
@@ -1,4 +1,8 @@
-/** @addtogroup rtc_file */
+/** @addtogroup rtc_file
+
+@author @htmlonly &copy; @endhtmlonly 2012 Karl Palsson <karlp@tweak.net.au>
+
+*/
/*
* This file is part of the libopencm3 project.
diff --git a/lib/stm32/common/spi_common_all.c b/lib/stm32/common/spi_common_all.c
index 184654e..2431d44 100644
--- a/lib/stm32/common/spi_common_all.c
+++ b/lib/stm32/common/spi_common_all.c
@@ -1,12 +1,8 @@
/** @addtogroup spi_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
@author @htmlonly &copy; @endhtmlonly 2012 Ken Sarkies <ksarkies@internode.on.net>
-@date 15 October 2012
-
Devices can have up to three SPI peripherals. The common 4-wire full-duplex
mode of operation is supported, along with 3-wire variants using unidirectional
communication modes or half-duplex bidirectional communication. A variety of
@@ -32,8 +28,8 @@ LSB first.
@todo need additional functions to aid ISRs in retrieving status
-LGPL License Terms @ref lgpl_license
- */
+*/
+
/*
* This file is part of the libopencm3 project.
*
diff --git a/lib/stm32/common/usart_common_all.c b/lib/stm32/common/usart_common_all.c
index 0c3d302..b550ba4 100644
--- a/lib/stm32/common/usart_common_all.c
+++ b/lib/stm32/common/usart_common_all.c
@@ -1,18 +1,14 @@
/** @addtogroup usart_file
-@version 1.0.0
-
@author @htmlonly &copy; @endhtmlonly 2009 Uwe Hermann <uwe@hermann-uwe.de>
-@date 30 August 2012
-
This library supports the USART/UART in the STM32F series
of ARM Cortex Microcontrollers by ST Microelectronics.
Devices can have up to 3 USARTs and 2 UARTs.
-LGPL License Terms @ref lgpl_license
- */
+*/
+
/*
* This file is part of the libopencm3 project.
*