doc: efm32: tag USB files for doxygen generation

This commit is contained in:
Karl Palsson 2019-06-25 12:19:03 +00:00
parent 2d1277e1fa
commit 1f359e0cb8
7 changed files with 69 additions and 19 deletions

View File

@ -1,3 +1,5 @@
/** @addtogroup usb_defines
*/
/*
* This file is part of the libopencm3 project.
*
@ -17,12 +19,13 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIBOPENCM3_EFM32_USB_H
#define LIBOPENCM3_EFM32_USB_H
#pragma once
#include <libopencm3/cm3/common.h>
#include <libopencm3/usb/usbd.h>
/**@{*/
#define USB_CTRL MMIO32(USB_BASE + 0x000)
#define USB_STATUS MMIO32(USB_BASE + 0x004)
#define USB_IF MMIO32(USB_BASE + 0x008)
@ -365,5 +368,4 @@
/* Bits 18:7 - Reserved */
#define USB_DIEP0TSIZ_XFRSIZ_MASK (0x7f << 0)
#endif
/**@}*/

View File

@ -1,3 +1,11 @@
/** @defgroup usb_defines USB Defines
*
* @brief <b>Defined Constants and Types for the USB module</b>
*
* @ingroup EZR32WG_defines
*
* LGPL License Terms @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
*
@ -17,9 +25,6 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIBOPENCM3_EFM32_EZR32WG_USB_H
#define LIBOPENCM3_EFM32_EZR32WG_USB_H
#pragma once
#include <libopencm3/efm32/common/usb_common.h>
#endif

View File

@ -1,3 +1,11 @@
/** @defgroup usb_defines USB Defines
*
* @brief <b>Defined Constants and Types for the USB module</b>
*
* @ingroup EFM32HG_defines
*
* LGPL License Terms @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
*
@ -18,12 +26,13 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIBOPENCM3_EFM32_USB_H
#define LIBOPENCM3_EFM32_USB_H
#pragma once
#include <libopencm3/cm3/common.h>
#include <libopencm3/usb/dwc/otg_fs.h>
/**@{*/
#define USB_CTRL MMIO32(USB_BASE + 0x000)
#define USB_STATUS MMIO32(USB_BASE + 0x004)
#define USB_IF MMIO32(USB_BASE + 0x008)
@ -58,4 +67,4 @@
/* Bit 1 - Reserved */
#define USB_ROUTE_PHYPEN (1 << 0)
#endif
/**@}*/

View File

@ -1,3 +1,11 @@
/** @defgroup usb_defines USB Defines
*
* @brief <b>Defined Constants and Types for the USB module</b>
*
* @ingroup EFM32LG_defines
*
* LGPL License Terms @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
*
@ -17,9 +25,6 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIBOPENCM3_EFM32_LG_USB_H
#define LIBOPENCM3_EFM32_LG_USB_H
#pragma once
#include <libopencm3/efm32/common/usb_common.h>
#endif

View File

@ -1,3 +1,11 @@
/** @defgroup usb_defines USB Defines
*
* @brief <b>Defined Constants and Types for the USB module</b>
*
* @ingroup EFM32WG_defines
*
* LGPL License Terms @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
*
@ -17,9 +25,6 @@
* along with this library. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef LIBOPENCM3_EFM32_WG_USB_H
#define LIBOPENCM3_EFM32_WG_USB_H
#pragma once
#include <libopencm3/efm32/common/usb_common.h>
#endif

View File

@ -1,3 +1,9 @@
/** @addtogroup usb_file USB peripheral API
* @ingroup peripheral_apis
*
* @sa usb_defines
* @copyright See @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
*
@ -26,6 +32,8 @@
#include <libopencm3/usb/usbd.h>
#include "usb_private.h"
/**@{*/
/* Receive FIFO size in 32-bit words. */
#define RX_FIFO_SIZE 256
@ -424,3 +432,5 @@ const struct _usbd_driver efm32lg_usb_driver = {
.set_address_before_status = 1,
.rx_fifo_size = RX_FIFO_SIZE,
};
/**@}*/

View File

@ -1,3 +1,13 @@
/** @addtogroup usb_file USB peripheral API
* @ingroup peripheral_apis
*
* @brief USB Peripheral for Happy Gecko
*
* The Happy Gecko uses the "standard" usb_dwc_otg core.
*
* @sa usb_defines
* @copyright See @ref lgpl_license
*/
/*
* This file is part of the libopencm3 project.
*
@ -28,6 +38,8 @@
#include "usb_private.h"
#include "usb_dwc_common.h"
/**@{*/
/* Receive FIFO size in 32-bit words. */
#define RX_FIFO_SIZE 256
@ -124,3 +136,5 @@ const struct _usbd_driver efm32hg_usb_driver = {
.set_address_before_status = 1,
.rx_fifo_size = RX_FIFO_SIZE,
};
/**@}*/