stm32: dcmi: hook up doxygen again

We still need stub .c files as we're using shared common files, so .d
tracking doesn't work.  It lets us setup basic introductory text anyway,
and there will be .c files eventually, so acceptable.

include/libopencm3/stm32/common/dcmi_common_f47.h

@@ -34,16 +34,13 @@
  * along with this library.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/**@{*/
-/** @cond */
-#ifndef LIBOPENCM3_STM32_COMMON_DCMI_COMMON_F47_H_
-/** @endcond */
-#define LIBOPENCM3_STM32_COMMON_DCMI_COMMON_F47_H_
-
+#pragma once
 
 #include <libopencm3/cm3/common.h>
 #include <libopencm3/stm32/memorymap.h>
 
+/**@{*/
+
 /**
  * DCMI control register 1
  */
@@ -239,8 +236,4 @@
  */
 #define DCMI_DR				MMIO32(DCMI_BASE + 0x28U)
 
-/** @cond */
-#endif /* LIBOPENCM3_STM32_COMMON_DCMI_COMMON_F47_H_ */
-/** @endcond */
 /**@}*/
-

include/libopencm3/stm32/f4/dcmi.h

@@ -13,7 +13,6 @@
 
 
 /*
- * STM32F7 DCMI Defines
  * Copyright (C) 2020, Smolyaninov Nikolay <smolin35@gmail.org>
  *
  * This file is part of the libopencm3 project.

include/libopencm3/stm32/f7/dcmi.h

@@ -13,7 +13,6 @@
 
 
 /*
- * STM32F7 DCMI Defines
  * Copyright (C) 2020, Smolyaninov Nikolay <smolin35@gmail.org>
  *
  * This file is part of the libopencm3 project.
@@ -38,8 +37,6 @@
 
 #include <libopencm3/stm32/common/dcmi_common_f47.h>
 
-/**@{*/
-
 /**
  * @defgroup dcmi_cr_values DCMI_CR Values
  * @ingroup dcmi_defines

lib/stm32/common/dcmi_common_f47.c

@@ -0,0 +1,18 @@
+/** @addtogroup dcmi_file DCMI peripheral API
+ * @ingroup peripheral_apis
+ * @brief Digital camera interface.
+ *
+ * The digital camera is a synchronous parallel interface able to
+ * receive a high-speed data flow from an external 8-, 10-, 12- or 14-bit
+ * CMOS camera module.
+ *
+ * If the APIs here are insufficient or incomplete, see @ref dcmi_defines
+ *
+ * LGPL License Terms @ref lgpl_license
+ */
+
+/**@{*/
+
+#include <libopencm3/stm32/dcmi.h>
+
+/**@}*/

lib/stm32/f4/Makefile

@@ -42,6 +42,7 @@ OBJS += can.o
 OBJS += crc_common_all.o
 OBJS += crypto_common_f24.o crypto.o
 OBJS += dac_common_all.o
+OBJS += dcmi_common_f47.o
 OBJS += desig_common_all.o desig_common_v1.o
 OBJS += dma_common_f24.o
 OBJS += dma2d_common_f47.o

lib/stm32/f7/Makefile

@@ -44,6 +44,7 @@ OBJS += adc_common_v1.o adc_common_v1_multi.o adc_common_f47.o
 OBJS += can.o
 OBJS += crc_common_all.o crc_v2.o
 OBJS += dac_common_all.o
+OBJS += dcmi_common_f47.o
 OBJS += desig_common_all.o desig.o
 OBJS += dma_common_f24.o
 OBJS += dma2d_common_f47.o