diff --git a/include/libopencm3/stm32/common/dac_common_all.h b/include/libopencm3/stm32/common/dac_common_all.h
index 258af88b..2f555e34 100644
--- a/include/libopencm3/stm32/common/dac_common_all.h
+++ b/include/libopencm3/stm32/common/dac_common_all.h
@@ -388,7 +388,7 @@ Unmask bits [(n-1)..0] of LFSR/Triangle Amplitude equal to (2**(n+1)-1
/** DAC channel 2 DMA underrun flag */
#define DAC_SR_DMAUDR2 (1 << 29)
-/*@}*/
+/**@}*/
/** DAC channel identifier */
typedef enum {
diff --git a/include/libopencm3/stm32/common/iwdg_common_all.h b/include/libopencm3/stm32/common/iwdg_common_all.h
index d7430b53..81c08446 100644
--- a/include/libopencm3/stm32/common/iwdg_common_all.h
+++ b/include/libopencm3/stm32/common/iwdg_common_all.h
@@ -97,7 +97,7 @@ specific memorymap.h header before including this header file.*/
/** PVU: Watchdog prescaler value update */
#define IWDG_SR_PVU (1 << 0)
-/*@}*/
+/**@}*/
/* --- IWDG function prototypes---------------------------------------------- */
diff --git a/include/libopencm3/stm32/common/rtc_common_l1f024.h b/include/libopencm3/stm32/common/rtc_common_l1f024.h
index d854320f..66cce5f7 100644
--- a/include/libopencm3/stm32/common/rtc_common_l1f024.h
+++ b/include/libopencm3/stm32/common/rtc_common_l1f024.h
@@ -40,6 +40,8 @@ specific memorymap.h header before including this header file.*/
#ifndef LIBOPENCM3_RTC2_H
#define LIBOPENCM3_RTC2_H
+/**@{*/
+
/** @defgroup rtc_registers RTC Registers
* @ingroup rtc_defines
* @brief Real Time Clock registers
@@ -100,7 +102,7 @@ specific memorymap.h header before including this header file.*/
/** RTC backup registers (RTC_BKPxR) */
#define RTC_BKPXR(reg) MMIO32(RTC_BKP_BASE + (4 * (reg)))
-/*@}*/
+/**@}*/
/** @defgroup rtc_tr_values RTC Time register (RTC_TR) values
@@ -133,7 +135,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_TR_SU_SHIFT (0)
/** Second units in BCD format mask */
#define RTC_TR_SU_MASK (0xf)
-/*@}*/
+/**@}*/
/** @defgroup rtc_dr_values RTC Date register (RTC_DR) values
* @ingroup rtc_registers
@@ -167,7 +169,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_DR_DU_SHIFT (0)
/** Date units in BCD format mask */
#define RTC_DR_DU_MASK (0xf)
-/*@}*/
+/**@}*/
/** @defgroup rtc_cr_values RTC control register (RTC_CR) values
* @ingroup rtc_registers
@@ -191,7 +193,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_CR_OSEL_ALARMA (0x1)
#define RTC_CR_OSEL_ALARMB (0x2)
#define RTC_CR_OSEL_WAKEUP (0x3)
-/*@}*/
+/**@}*/
/** Output polarity */
#define RTC_CR_POL (1<<20)
@@ -239,7 +241,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_CR_WUCLKSEL_RTC_DIV2 (0x3)
#define RTC_CR_WUCLKSEL_SPRE (0x4)
#define RTC_CR_WUCLKSEL_SPRE_216 (0x6)
-/*@}*/
+/**@}*/
/** @defgroup rtc_isr_values RTC initialization and status register (RTC_ISR) values
* @ingroup rtc_registers
@@ -280,7 +282,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_ISR_ALRBWF (1<<1)
/** ALRAWF: Alarm A write flag */
#define RTC_ISR_ALRAWF (1<<0)
-/*@}*/
+/**@}*/
/** @defgroup rtc_prer_values RTC prescaler register (RTC_PRER) values
* @ingroup rtc_registers
@@ -293,7 +295,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_PRER_PREDIV_S_SHIFT (0)
/** Sync prescaler factor mask */
#define RTC_PRER_PREDIV_S_MASK (0x7fff)
-/*@}*/
+/**@}*/
/* RTC calibration register (RTC_CALIBR) ------------------------ */
#define RTC_CALIBR_DCS (1 << 7)
@@ -327,7 +329,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_ALRMXR_ST_MASK (0x7)
#define RTC_ALRMXR_SU_SHIFT (0)
#define RTC_ALRMXR_SU_MASK (0xf)
-/*@}*/
+/**@}*/
/* RTC shift control register (RTC_SHIFTR) ---------------------- */
#define RTC_SHIFTR_ADD1S (31)
@@ -351,7 +353,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_TSTR_ST_MASK (0x7)
#define RTC_TSTR_SU_SHIFT (0)
#define RTC_TSTR_SU_MASK (0xf)
-/*@}*/
+/**@}*/
/** @defgroup rtc_tsdr_values RTC time stamp date register (RTC_TSDR) values
* @ingroup rtc_registers
@@ -365,7 +367,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_TSDR_DT_MASK (0x3)
#define RTC_TSDR_DU_SHIFT (0)
#define RTC_TSDR_DU_MASK (0xf)
-/*@}*/
+/**@}*/
/** @defgroup rtc_calr_values RTC calibration register (RTC_CALR) values
* @ingroup rtc_registers
@@ -375,7 +377,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_CALR_CALW16 (1 << 13)
#define RTC_CALR_CALM_SHIFT (0)
#define RTC_CALR_CALM_MASK (0x1ff)
-/*@}*/
+/**@}*/
/** @defgroup rtc_tafcr_values RTC tamper and alternate function configuration register (RTC_TAFCR) values
* @ingroup rtc_registers
@@ -416,7 +418,7 @@ specific memorymap.h header before including this header file.*/
#define RTC_TAFCR_TAMPIE (1<<2)
#define RTC_TAFCR_TAMP1TRG (1<<1)
#define RTC_TAFCR_TAMP1E (1<<0)
-/*@}*/
+/**@}*/
/* RTC alarm X sub second register ------------------------------ */
/* Note: Applies to RTC_ALRMASSR and RTC_ALRMBSSR */
diff --git a/include/libopencm3/stm32/f3/rcc.h b/include/libopencm3/stm32/f3/rcc.h
index f77df32e..e7839437 100644
--- a/include/libopencm3/stm32/f3/rcc.h
+++ b/include/libopencm3/stm32/f3/rcc.h
@@ -281,7 +281,7 @@
#define RCC_AHBENR_SRAMEN (1 << 2)
#define RCC_AHBENR_DMA2EN (1 << 1)
#define RCC_AHBENR_DMA1EN (1 << 0)
-/*@}*/
+/**@}*/
/** @defgroup rcc_apb2enr_en RCC_APB2ENR enable values
@{*/
diff --git a/include/libopencm3/stm32/g4/crs.h b/include/libopencm3/stm32/g4/crs.h
index 4a3ab10d..11d7616a 100644
--- a/include/libopencm3/stm32/g4/crs.h
+++ b/include/libopencm3/stm32/g4/crs.h
@@ -1,6 +1,6 @@
/** @defgroup crs_defines CRS Defines
*
- * @brief Defined Constants and Types for the Clock Recovery System.
+ * @brief Defined Constants and Types for the Clock Recovery System
*
* @ingroup STM32G4xx_defines
*
diff --git a/include/libopencm3/stm32/g4/dmamux.h b/include/libopencm3/stm32/g4/dmamux.h
index 1a746620..7876c753 100644
--- a/include/libopencm3/stm32/g4/dmamux.h
+++ b/include/libopencm3/stm32/g4/dmamux.h
@@ -26,8 +26,8 @@ LGPL License Terms @ref lgpl_license
* along with this library. If not, see .
*/
-#ifndef LIBOPENCM3_DMAMUX_H
-#define LIBOPENCM3_DMAMUX_H
+#pragma once
+
/**@{*/
#include
@@ -63,6 +63,7 @@ LGPL License Terms @ref lgpl_license
#define DMAMUX_CxCR_SYNC_ID_DMAMUX_CH2_EVT 18
#define DMAMUX_CxCR_SYNC_ID_DMAMUX_CH3_EVT 19
#define DMAMUX_CxCR_SYNC_ID_LPTIM1_OUT 20
+/**@}*/
/** @defgroup dmamux_cxcr_dmareq_id DMAREQID DMA request line selected
@@ -213,4 +214,3 @@ LGPL License Terms @ref lgpl_license
/**@}*/
/**@}*/
-#endif
diff --git a/include/libopencm3/stm32/g4/rcc.h b/include/libopencm3/stm32/g4/rcc.h
index 51e45c76..dbf1ef04 100644
--- a/include/libopencm3/stm32/g4/rcc.h
+++ b/include/libopencm3/stm32/g4/rcc.h
@@ -177,7 +177,7 @@
#define RCC_CFGR_HPRE_DIV128 0xd
#define RCC_CFGR_HPRE_DIV256 0xe
#define RCC_CFGR_HPRE_DIV512 0xf
-/*@}*/
+/**@}*/
#define RCC_CFGR_HPRE_MASK 0xf
#define RCC_CFGR_HPRE_SHIFT 4
@@ -207,6 +207,7 @@
#define RCC_PLLCFGR_PLLR_DIV4 1
#define RCC_PLLCFGR_PLLR_DIV6 2
#define RCC_PLLCFGR_PLLR_DIV8 3
+/**@}*/
#define RCC_PLLCFGR_PLLR_SHIFT 25
#define RCC_PLLCFGR_PLLR_MASK 0x3
@@ -446,15 +447,15 @@
#define RCC_APB1ENR1_TIM4EN (1 << 2)
#define RCC_APB1ENR1_TIM3EN (1 << 1)
#define RCC_APB1ENR1_TIM2EN (1 << 0)
-/*@}*/
+/**@}*/
/** @defgroup rcc_apb1enr2_en RCC_APB1ENR2 enable values
*@{*/
#define RCC_APB1ENR2_UCPD1EN (1 << 8)
#define RCC_APB1ENR2_I2C4EN (1 << 1)
#define RCC_APB1ENR2_LPUART1EN (1 << 0)
-/*@}*/
-/*@}*/
+/**@}*/
+/**@}*/
/** @defgroup rcc_apb2enr_en RCC_APB2ENR enable values
*@{*/
diff --git a/include/libopencm3/stm32/l1/rcc.h b/include/libopencm3/stm32/l1/rcc.h
index 220d1f88..08b9017b 100644
--- a/include/libopencm3/stm32/l1/rcc.h
+++ b/include/libopencm3/stm32/l1/rcc.h
@@ -331,7 +331,7 @@
#define RCC_AHBENR_GPIOCEN (1 << 2)
#define RCC_AHBENR_GPIOBEN (1 << 1)
#define RCC_AHBENR_GPIOAEN (1 << 0)
-/*@}*/
+/**@}*/
/* --- RCC_APB2ENR values -------------------------------------------------- */
@@ -346,7 +346,7 @@
#define RCC_APB2ENR_TIM10EN (1 << 3)
#define RCC_APB2ENR_TIM9EN (1 << 2)
#define RCC_APB2ENR_SYSCFGEN (1 << 0)
-/*@}*/
+/**@}*/
/* --- RCC_APB1ENR values -------------------------------------------------- */
@@ -370,7 +370,7 @@
#define RCC_APB1ENR_TIM4EN (1 << 2)
#define RCC_APB1ENR_TIM3EN (1 << 1)
#define RCC_APB1ENR_TIM2EN (1 << 0)
-/*@}*/
+/**@}*/
/* --- RCC_AHBLPENR -------------------------------------------------------- */
#define RCC_AHBLPENR_DMA1LPEN (1 << 24)
diff --git a/lib/stm32/common/flash_common_all.c b/lib/stm32/common/flash_common_all.c
index b369d903..53f7990d 100644
--- a/lib/stm32/common/flash_common_all.c
+++ b/lib/stm32/common/flash_common_all.c
@@ -49,4 +49,4 @@ void flash_unlock_option_bytes(void)
FLASH_OPTKEYR = FLASH_OPTKEYR_KEY2;
}
-/*@}*/
+/**@}*/
diff --git a/lib/stm32/common/opamp_common_all.c b/lib/stm32/common/opamp_common_all.c
index 49f24550..acd84596 100644
--- a/lib/stm32/common/opamp_common_all.c
+++ b/lib/stm32/common/opamp_common_all.c
@@ -109,4 +109,4 @@ void opamp_vm_select(uint32_t base, uint32_t vm)
OPAMP_CSR(base) |= vm << OPAMP_CSR_VM_SEL_SHIFT;
}
-/*@}*/
+/**@}*/
diff --git a/lib/stm32/common/opamp_common_v1.c b/lib/stm32/common/opamp_common_v1.c
index 3f665d4c..3000be63 100644
--- a/lib/stm32/common/opamp_common_v1.c
+++ b/lib/stm32/common/opamp_common_v1.c
@@ -53,4 +53,4 @@ void opamp_vms_select(uint32_t base, uint32_t vms)
OPAMP_CSR(base) |= vms << OPAMP_CSR_VMS_SEL_SHIFT;
}
-/*@}*/
+/**@}*/
diff --git a/lib/stm32/common/opamp_common_v2.c b/lib/stm32/common/opamp_common_v2.c
index 3641edf1..fbb6ec3f 100644
--- a/lib/stm32/common/opamp_common_v2.c
+++ b/lib/stm32/common/opamp_common_v2.c
@@ -49,4 +49,4 @@ void opamp_output_set_external(uint32_t base)
OPAMP_CSR(base) &= ~OPAMP_CSR_OPAINTOEN;
}
-/*@}*/
+/**@}*/
diff --git a/lib/stm32/g4/adc.c b/lib/stm32/g4/adc.c
index 4ce7ad72..1b1cd920 100644
--- a/lib/stm32/g4/adc.c
+++ b/lib/stm32/g4/adc.c
@@ -27,7 +27,6 @@
* You should have received a copy of the GNU Lesser General Public License
* along with this library. If not, see .
*/
-/**@{*/
#include