More doxygen documentation

git-svn-id: https://svn.vbchaos.nl/svn/hsb/trunk@419 05563f52-14a8-4384-a975-3d1654cca0fa
This commit is contained in:
dvl
2018-01-11 14:56:48 +00:00
parent 33bbbf4827
commit 20885c64e8
12 changed files with 96 additions and 62 deletions

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file CathodeMCP.h
/// @ingroup {group_name}
/**
* CathodeMCP implementation
* \defgroup CathodeMCP Package CathodeMCP
* \ingroup Platform
* @{
*/
#ifndef CATHODEMCP_H_
#define CATHODEMCP_H_
@@ -108,3 +109,5 @@ extern void CathodeMCP_switchToCathode(void);
extern void CathodeMCP_switchToMCP(void);
#endif /* CATHODEMCP_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file InternalFlash.h
/// @ingroup {group_name}
/**
* InternalFlash implementation
* \defgroup InternalFlash Package InternalFlash
* \ingroup Platform
* @{
*/
#ifndef INC_INTERNALFLASH_H_
#define INC_INTERNALFLASH_H_
@@ -142,3 +143,5 @@ extern ErrorStatus InternalFlash_read(const struct InternalFlash* self, uint32_t
extern ErrorStatus InternalFlash_erasePage(const struct InternalFlash* self, unsigned int page);
#endif /* INC_INTERNALFLASH_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file PCBA.h
/// @ingroup {group_name}
/**
* Pcba implementation
* \defgroup Pcba Package Pcba
* \ingroup Platform
* @{
*/
#ifndef PCBA_H_
#define PCBA_H_
@@ -98,3 +99,5 @@ extern struct Pcba* PCBA_getInstance(void);
extern ErrorStatus PCBA_setIO(T_PL_GPIO* A0, T_PL_GPIO* A1);
#endif /* PCBA_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file Version.h
/// @ingroup {group_name}
/**
* Version implementation
* \defgroup Version Package Version
* \ingroup Platform
* @{
*/
#ifndef INC_VERSION_H_
#define INC_VERSION_H_
@@ -75,3 +76,5 @@ struct Version
extern struct Version* Version_getInstance(void);
#endif /* INC_VERSION_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file gpio.h
/// @ingroup {group_name}
/**
* GPIO implementation
* \defgroup GPIO Package GPIO
* \ingroup Platform
* @{
*/
#ifndef INC_GPIO_H_
#define INC_GPIO_H_
@@ -118,3 +119,5 @@ extern ErrorStatus GPIO_setValue(struct Gpio* self, bool value);
extern ErrorStatus GPIO_getValue(struct Gpio* self, bool* value);
#endif /* INC_GPIO_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file adc.h
/// @ingroup {group_name}
/**
* InternalADC implementation
* \defgroup InternalADC Package InternalADC
* \ingroup Platform
* @{
*/
#ifndef INC_ADC_H_
#define INC_ADC_H_
@@ -234,3 +235,5 @@ extern void ADCChannel_destruct(struct AdcChannel* self);
extern ErrorStatus ADCChannel_read(const struct AdcChannel* self, uint16_t* value);
#endif /* INC_ADC_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2017 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file keypadMatrix.h
/// @ingroup {group_name}
/**
* Keypad implementation
* \defgroup Keypad Package Keypad
* \ingroup Platform
* @{
*/
#ifndef KEYPAD_INC_KEYPADMATRIX_H_
@@ -134,3 +135,5 @@ extern void Keypad_destruct (const struct Keypad* self);
#endif /* KEYPAD_INC_KEYPADMATRIX_H_ */
/** @} */

View File

@@ -17,13 +17,12 @@
// (c) 2017 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {HAL} {group_description}
/// This file defines the properties for the Olimex STM32 H107 dev-kit
/// platform.
///
/// @file olx_stm32_h107.h
/// @ingroup {HAL}
/**
* Platform implementation
* \defgroup PlatformGroup Package Platform
* \ingroup Platform
* @{
*/
#ifndef PLATFORM_INC_PLATFORM_H_
@@ -138,3 +137,5 @@ extern ErrorStatus initPlatform(void);
extern ErrorStatus destructPlatform(void);
#endif /* PLATFORM_INC_PLATFORM_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file rtc.h
/// @ingroup {group_name}
/**
* Rtc implementation
* \defgroup Rtc Package Rtc
* \ingroup Platform
* @{
*/
#ifndef INC_RTC_H_
#define INC_RTC_H_
@@ -94,3 +95,5 @@ extern void RTC_calculateTimeFromSeconds(uint32_t seconds, struct Time* time);
#endif /* INC_RTC_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2017 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file spi.h
/// @ingroup {group_name}
/**
* Spi implementation
* \defgroup Spi Package Spi
* \ingroup Platform
* @{
*/
#ifndef MISC_INC_SPI_H_
@@ -150,3 +151,5 @@ extern ErrorStatus SPI_getDefaultParameters(struct SpiParameters* parameters);
#endif /* MISC_INC_SPI_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file spiDevice.h
/// @ingroup {group_name}
/**
* SpiDevice implementation
* \defgroup SpiDevice Package SpiDevice
* \ingroup Platform
* @{
*/
#ifndef PLATFORM_INC_SPIDEVICE_H_
#define PLATFORM_INC_SPIDEVICE_H_
@@ -79,3 +80,5 @@ extern ErrorStatus SpiDevice_construct(struct SpiDevice* self, struct Spi* spi,
extern ErrorStatus SpiDevice_write (const struct SpiDevice* self, const char* buffer, int length);
#endif /* PLATFORM_INC_SPIDEVICE_H_ */
/** @} */

View File

@@ -17,11 +17,12 @@
// (c) 2017 Micro-Key bv
// -----------------------------------------------------------------------------
/// @defgroup {group_name} {group_description}
/// Description
/// @file uart.h
/// @ingroup {group_name}
/**
* UART implementation
* \defgroup UART Package UART
* \ingroup Platform
* @{
*/
#ifndef MISC_INC_UART_H_
@@ -167,3 +168,5 @@ extern ErrorStatus Uart_read(struct Uart* self, char* buffer, size_t length, siz
#endif /* MISC_INC_UART_H_ */
/** @} */