aboutsummaryrefslogtreecommitdiff
path: root/lib/stm32
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
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')
-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
-rw-r--r--lib/stm32/f1/crc.c5
-rw-r--r--lib/stm32/f1/dac.c5
-rw-r--r--lib/stm32/f1/dma.c5
-rw-r--r--lib/stm32/f1/i2c.c5
-rw-r--r--lib/stm32/f1/iwdg.c5
-rw-r--r--lib/stm32/f1/pwr.c177
-rw-r--r--lib/stm32/f1/rtc.c20
-rw-r--r--lib/stm32/f1/spi.c5
-rw-r--r--lib/stm32/f1/usart.c5
-rw-r--r--lib/stm32/f2/crc.c5
-rw-r--r--lib/stm32/f2/dac.c5
-rw-r--r--lib/stm32/f2/dma.c5
-rw-r--r--lib/stm32/f2/gpio.c5
-rw-r--r--lib/stm32/f2/i2c.c5
-rw-r--r--lib/stm32/f2/iwdg.c5
-rw-r--r--lib/stm32/f2/rtc.c5
-rw-r--r--lib/stm32/f2/spi.c5
-rw-r--r--lib/stm32/f2/usart.c5
-rw-r--r--lib/stm32/f4/crc.c5
-rw-r--r--lib/stm32/f4/dac.c5
-rw-r--r--lib/stm32/f4/dma.c5
-rw-r--r--lib/stm32/f4/gpio.c5
-rw-r--r--lib/stm32/f4/i2c.c5
-rw-r--r--lib/stm32/f4/iwdg.c5
-rw-r--r--lib/stm32/f4/pwr.c19
-rw-r--r--lib/stm32/f4/rtc.c5
-rw-r--r--lib/stm32/f4/spi.c5
-rw-r--r--lib/stm32/f4/usart.c5
-rw-r--r--lib/stm32/l1/crc.c5
-rw-r--r--lib/stm32/l1/dac.c5
-rw-r--r--lib/stm32/l1/gpio.c5
-rw-r--r--lib/stm32/l1/i2c.c5
-rw-r--r--lib/stm32/l1/iwdg.c5
-rw-r--r--lib/stm32/l1/pwr.c17
-rw-r--r--lib/stm32/l1/rtc.c5
-rw-r--r--lib/stm32/l1/spi.c5
-rw-r--r--lib/stm32/l1/usart.c5
49 files changed, 242 insertions, 245 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.
*
diff --git a/lib/stm32/f1/crc.c b/lib/stm32/f1/crc.c
index 505fb79..8c88052 100644
--- a/lib/stm32/f1/crc.c
+++ b/lib/stm32/f1/crc.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F1xx CRC</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f1/dac.c b/lib/stm32/f1/dac.c
index 90dc029..d0a2372 100644
--- a/lib/stm32/f1/dac.c
+++ b/lib/stm32/f1/dac.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F1xx DAC</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f1/dma.c b/lib/stm32/f1/dma.c
index f22baef..3156508 100644
--- a/lib/stm32/f1/dma.c
+++ b/lib/stm32/f1/dma.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F1xx DMA</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f1/i2c.c b/lib/stm32/f1/i2c.c
index 2d86bf3..1f7e7a5 100644
--- a/lib/stm32/f1/i2c.c
+++ b/lib/stm32/f1/i2c.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F1xx I2C</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f1/iwdg.c b/lib/stm32/f1/iwdg.c
index 85cf18c..f44a9e4 100644
--- a/lib/stm32/f1/iwdg.c
+++ b/lib/stm32/f1/iwdg.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F1xx Independent Watchdog Timer</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f1/pwr.c b/lib/stm32/f1/pwr.c
index 451ed1c..8e59bab 100644
--- a/lib/stm32/f1/pwr.c
+++ b/lib/stm32/f1/pwr.c
@@ -1,4 +1,4 @@
-/** @defgroup STM32F1xx-pwr-file PWR
+/** @defgroup pwr-file PWR
@ingroup STM32F1xx
@@ -38,180 +38,5 @@ LGPL License Terms @ref lgpl_license
#include <libopencm3/stm32/pwr.h>
-/*---------------------------------------------------------------------------*/
-/** @brief Disable Backup Domain Write Protection.
-
-This allows backup domain registers to be changed. These registers are write
-protected after a reset.
-*/
-
-void pwr_disable_backup_domain_write_protect(void)
-{
- PWR_CR |= PWR_CR_DBP;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Re-enable Backup Domain Write Protection.
-
-This protects backup domain registers from inadvertent change.
-*/
-
-void pwr_enable_backup_domain_write_protect(void)
-{
- PWR_CR &= ~PWR_CR_DBP;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Enable Power Voltage Detector.
-
-This provides voltage level threshold detection. The result of detection is
-provided in the power voltage detector output flag (see @ref pwr_voltage_high)
-or by setting the EXTI16 interrupt (see datasheet for configuration details).
-
-@param[in] pvd_level u32. Taken from @ref pwr_pls.
-*/
-
-void pwr_enable_power_voltage_detect(u32 pvd_level)
-{
- PWR_CR &= ~PWR_CR_PLS_MASK;
- PWR_CR |= (PWR_CR_PVDE | pvd_level);
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Disable Power Voltage Detector.
-
-*/
-
-void pwr_disable_power_voltage_detect(void)
-{
- PWR_CR &= ~PWR_CR_PVDE;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Clear the Standby Flag.
-
-This is set when the processor returns from a standby mode.
-*/
-
-void pwr_clear_standby_flag(void)
-{
- PWR_CR |= PWR_CR_CSBF;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Clear the Wakeup Flag.
-
-This is set when the processor receives a wakeup signal.
-*/
-
-void pwr_clear_wakeup_flag(void)
-{
- PWR_CR |= PWR_CR_CWUF;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Set Standby Mode in Deep Sleep.
-
-*/
-
-void pwr_set_standby_mode(void)
-{
- PWR_CR |= PWR_CR_PDDS;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Set Stop Mode in Deep Sleep.
-
-*/
-
-void pwr_set_stop_mode(void)
-{
- PWR_CR &= ~PWR_CR_PDDS;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Voltage Regulator On in Stop Mode.
-
-*/
-
-void pwr_voltage_regulator_on_in_stop(void)
-{
- PWR_CR &= ~PWR_CR_LPDS;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Voltage Regulator Low Power in Stop Mode.
-
-*/
-
-void pwr_voltage_regulator_low_power_in_stop(void)
-{
- PWR_CR |= PWR_CR_LPDS;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Enable Wakeup Pin.
-
-The wakeup pin is used for waking the processor from standby mode.
-*/
-
-void pwr_enable_wakeup_pin(void)
-{
- PWR_CSR |= PWR_CSR_EWUP;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Release Wakeup Pin.
-
-The wakeup pin is used for general purpose I/O.
-*/
-
-void pwr_disable_wakeup_pin(void)
-{
- PWR_CSR &= ~PWR_CSR_EWUP;
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Get Voltage Detector Output.
-
-The voltage detector threshold must be set when the power voltage detector is
-enabled, see @ref pwr_enable_power_voltage_detect.
-
-@returns boolean: TRUE if the power voltage is above the preset voltage
-threshold.
-*/
-
-bool pwr_voltage_high(void)
-{
- return (PWR_CSR & PWR_CSR_PVDO);
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Get Standby Flag.
-
-The standby flag is set when the processor returns from a standby state. It is
-cleared by software (see @ref pwr_clear_standby_flag).
-
-@returns boolean: TRUE if the processor was in standby state.
-*/
-
-bool pwr_get_standby_flag(void)
-{
- return (PWR_CSR & PWR_CSR_SBF);
-}
-
-/*---------------------------------------------------------------------------*/
-/** @brief Get Wakeup Flag.
-
-The wakeup flag is set when a wakeup event has been received. It is
-cleared by software (see @ref pwr_clear_wakeup_flag).
-
-@returns boolean: TRUE if a wakeup event was received.
-*/
-
-bool pwr_get_wakeup_flag(void)
-{
- return (PWR_CSR & PWR_CSR_WUF);
-}
/**@}*/
diff --git a/lib/stm32/f1/rtc.c b/lib/stm32/f1/rtc.c
index cfc5f5b..24b19ce 100644
--- a/lib/stm32/f1/rtc.c
+++ b/lib/stm32/f1/rtc.c
@@ -1,3 +1,19 @@
+/** @defgroup rtc_file RTC
+
+@ingroup STM32F1xx
+
+@brief <b>libopencm3 STM32F1xx RTC</b>
+
+@author @htmlonly &copy; @endhtmlonly 2010 Uwe Hermann <uwe@hermann-uwe.de>
+@author @htmlonly &copy; @endhtmlonly 2010 Lord James <lordjames@y7mail.com>
+
+@version 1.0.0
+
+@date 4 March 2013
+
+LGPL License Terms @ref lgpl_license
+*/
+
/*
* This file is part of the libopencm3 project.
*
@@ -18,8 +34,8 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <libopencm3/stm32/f1/rcc.h>
-#include <libopencm3/stm32/f1/rtc.h>
+#include <libopencm3/stm32/rcc.h>
+#include <libopencm3/stm32/rtc.h>
#include <libopencm3/stm32/pwr.h>
void rtc_awake_from_off(osc_t clock_source)
diff --git a/lib/stm32/f1/spi.c b/lib/stm32/f1/spi.c
index 3be5c23..f3f36e3 100644
--- a/lib/stm32/f1/spi.c
+++ b/lib/stm32/f1/spi.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F1xx SPI</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f1/usart.c b/lib/stm32/f1/usart.c
index ecf2b06..13e20b2 100644
--- a/lib/stm32/f1/usart.c
+++ b/lib/stm32/f1/usart.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F1xx USART</b>
+@version 1.0.0
+
+@date 30 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/crc.c b/lib/stm32/f2/crc.c
index 5437f7c..df352d1 100644
--- a/lib/stm32/f2/crc.c
+++ b/lib/stm32/f2/crc.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx CRC</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/dac.c b/lib/stm32/f2/dac.c
index 5d20703..ce9165b 100644
--- a/lib/stm32/f2/dac.c
+++ b/lib/stm32/f2/dac.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx DAC</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/dma.c b/lib/stm32/f2/dma.c
index 8e8f702..c9374ff 100644
--- a/lib/stm32/f2/dma.c
+++ b/lib/stm32/f2/dma.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx DMA</b>
+@version 1.0.0
+
+@date 30 November 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/gpio.c b/lib/stm32/f2/gpio.c
index a2dfc88..370f59b 100644
--- a/lib/stm32/f2/gpio.c
+++ b/lib/stm32/f2/gpio.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx General Purpose I/O</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/i2c.c b/lib/stm32/f2/i2c.c
index f20a840..df0fcff 100644
--- a/lib/stm32/f2/i2c.c
+++ b/lib/stm32/f2/i2c.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx I2C</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/iwdg.c b/lib/stm32/f2/iwdg.c
index 0440d88..80a223d 100644
--- a/lib/stm32/f2/iwdg.c
+++ b/lib/stm32/f2/iwdg.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx Independent Watchdog Timer</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/rtc.c b/lib/stm32/f2/rtc.c
index 461d0b1..310fe43 100644
--- a/lib/stm32/f2/rtc.c
+++ b/lib/stm32/f2/rtc.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx RTC</b>
+@version 1.0.0
+
+@date 4 March 2013
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/spi.c b/lib/stm32/f2/spi.c
index bc4a4ee..ce157a5 100644
--- a/lib/stm32/f2/spi.c
+++ b/lib/stm32/f2/spi.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx SPI</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f2/usart.c b/lib/stm32/f2/usart.c
index 225b706..09c0900 100644
--- a/lib/stm32/f2/usart.c
+++ b/lib/stm32/f2/usart.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F2xx USART</b>
+@version 1.0.0
+
+@date 30 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/crc.c b/lib/stm32/f4/crc.c
index 90e6782..1814fcc 100644
--- a/lib/stm32/f4/crc.c
+++ b/lib/stm32/f4/crc.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx CRC</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/dac.c b/lib/stm32/f4/dac.c
index 4776c41..19eaa4b 100644
--- a/lib/stm32/f4/dac.c
+++ b/lib/stm32/f4/dac.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx DAC</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/dma.c b/lib/stm32/f4/dma.c
index c9f5db6..75271a1 100644
--- a/lib/stm32/f4/dma.c
+++ b/lib/stm32/f4/dma.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx DMA</b>
+@version 1.0.0
+
+@date 30 November 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/gpio.c b/lib/stm32/f4/gpio.c
index 96a6f45..db42e8d 100644
--- a/lib/stm32/f4/gpio.c
+++ b/lib/stm32/f4/gpio.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx General Purpose I/O</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/i2c.c b/lib/stm32/f4/i2c.c
index 3250faa..ac6f117 100644
--- a/lib/stm32/f4/i2c.c
+++ b/lib/stm32/f4/i2c.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx I2C</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/iwdg.c b/lib/stm32/f4/iwdg.c
index 9332fc4..67985d6 100644
--- a/lib/stm32/f4/iwdg.c
+++ b/lib/stm32/f4/iwdg.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx Independent Watchdog Timer</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/pwr.c b/lib/stm32/f4/pwr.c
index 7be34f4..e492192 100644
--- a/lib/stm32/f4/pwr.c
+++ b/lib/stm32/f4/pwr.c
@@ -1,3 +1,20 @@
+/** @defgroup pwr-file PWR
+
+@ingroup STM32F4xx
+
+@brief <b>libopencm3 STM32F4xx Power Control</b>
+
+@version 1.0.0
+
+@author @htmlonly &copy; @endhtmlonly 2011 Stephen Caudle <scaudle@doceme.com>
+
+@date 4 March 2013
+
+This library supports the power control system for the
+STM32F4 series of ARM Cortex Microcontrollers by ST Microelectronics.
+
+LGPL License Terms @ref lgpl_license
+*/
/*
* This file is part of the libopencm3 project.
*
@@ -17,7 +34,7 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
-#include <libopencm3/stm32/f4/pwr.h>
+#include <libopencm3/stm32/pwr.h>
void pwr_set_vos_scale(vos_scale_t scale)
{
diff --git a/lib/stm32/f4/rtc.c b/lib/stm32/f4/rtc.c
index 7e1b5ff..77f5631 100644
--- a/lib/stm32/f4/rtc.c
+++ b/lib/stm32/f4/rtc.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx RTC</b>
+@version 1.0.0
+
+@date 4 March 2013
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/spi.c b/lib/stm32/f4/spi.c
index 40f5501..050d823 100644
--- a/lib/stm32/f4/spi.c
+++ b/lib/stm32/f4/spi.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx SPI</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/f4/usart.c b/lib/stm32/f4/usart.c
index e0f7be8..201ff5d 100644
--- a/lib/stm32/f4/usart.c
+++ b/lib/stm32/f4/usart.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32F4xx USART</b>
+@version 1.0.0
+
+@date 30 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/crc.c b/lib/stm32/l1/crc.c
index 7d51341..b85ecd5 100644
--- a/lib/stm32/l1/crc.c
+++ b/lib/stm32/l1/crc.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx CRC</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/dac.c b/lib/stm32/l1/dac.c
index 534f9f1..b20457c 100644
--- a/lib/stm32/l1/dac.c
+++ b/lib/stm32/l1/dac.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx DAC</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/gpio.c b/lib/stm32/l1/gpio.c
index 7fc2012..fd42ba8 100644
--- a/lib/stm32/l1/gpio.c
+++ b/lib/stm32/l1/gpio.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx General Purpose I/O</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/i2c.c b/lib/stm32/l1/i2c.c
index 7a6fe84..00e9fa9 100644
--- a/lib/stm32/l1/i2c.c
+++ b/lib/stm32/l1/i2c.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx I2C</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/iwdg.c b/lib/stm32/l1/iwdg.c
index 05ddf04..b0b9593 100644
--- a/lib/stm32/l1/iwdg.c
+++ b/lib/stm32/l1/iwdg.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx Independent Watchdog Timer</b>
+@version 1.0.0
+
+@date 18 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/pwr.c b/lib/stm32/l1/pwr.c
index 8541851..e712899 100644
--- a/lib/stm32/l1/pwr.c
+++ b/lib/stm32/l1/pwr.c
@@ -1,3 +1,20 @@
+/** @defgroup pwr-file PWR
+
+@ingroup STM32L1xx
+
+@brief <b>libopencm3 STM32L1xx Power Control</b>
+
+@version 1.0.0
+
+@author @htmlonly &copy; @endhtmlonly 2012 Karl Palsson <karlp@tweak.net.au>
+
+@date 4 March 2013
+
+This library supports the power control system for the
+STM32L1 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/l1/rtc.c b/lib/stm32/l1/rtc.c
index bc7f87f..1afd597 100644
--- a/lib/stm32/l1/rtc.c
+++ b/lib/stm32/l1/rtc.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx RTC</b>
+@version 1.0.0
+
+@date 4 March 2013
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/spi.c b/lib/stm32/l1/spi.c
index 30c44dd..c6887dc 100644
--- a/lib/stm32/l1/spi.c
+++ b/lib/stm32/l1/spi.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx SPI</b>
+@version 1.0.0
+
+@date 15 October 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*
diff --git a/lib/stm32/l1/usart.c b/lib/stm32/l1/usart.c
index 67fd674..3dc55c2 100644
--- a/lib/stm32/l1/usart.c
+++ b/lib/stm32/l1/usart.c
@@ -4,6 +4,11 @@
@brief <b>libopencm3 STM32L1xx USART</b>
+@version 1.0.0
+
+@date 30 August 2012
+
+LGPL License Terms @ref lgpl_license
*/
/*