Files
hsb/S - Software/0 - HSB MRTS Kathode-MCP/3 - Implementation/0 - Code/HAL/inc/ADCDevice.h
dvl 9915a5a349 More doxygen documentation
git-svn-id: https://svn.vbchaos.nl/svn/hsb/trunk@416 05563f52-14a8-4384-a975-3d1654cca0fa
2018-01-11 13:51:42 +00:00

106 lines
3.2 KiB
C

// -----------------------------------------------------------------------------
/// @file ADCDevice.h
/// @brief File description
// -----------------------------------------------------------------------------
// Micro-Key bv
// Industrieweg 28, 9804 TG Noordhorn
// Postbus 92, 9800 AB Zuidhorn
// The Netherlands
// Tel: +31 594 503020
// Fax: +31 594 505825
// Email: support@microkey.nl
// Web: www.microkey.nl
// -----------------------------------------------------------------------------
/// $Revision: $
/// $Author: $
/// $Date: $
// (c) 2015 Micro-Key bv
// -----------------------------------------------------------------------------
/**
* ADCDevice implementation
* \defgroup ADCDevice Package ADCDevice
* \ingroup HAL
* @{
*/
#ifndef INC_ADCDEVICE_H_
#define INC_ADCDEVICE_H_
// -----------------------------------------------------------------------------
// Include files
// -----------------------------------------------------------------------------
#include <stdbool.h>
#include "stm32f10x.h"
// -----------------------------------------------------------------------------
// Constant and macro definitions
// -----------------------------------------------------------------------------
struct ADCDevice;
typedef uint32_t (*ADCReadFunction)(const struct ADCDevice* self);
struct ADCDevice
{
ADCReadFunction _read;
bool initialized;
unsigned int resolutionInBits;
};
// -----------------------------------------------------------------------------
// Function declarations
// -----------------------------------------------------------------------------
/** ----------------------------------------------------------------------------
* ADCDevice_construct
* Constructor for ADC device
*
* @param self ADC object
* @param read Pointer to read function
* @param resolutionsInBits The resolution of this ADC device in
* number of bits
*
* @return ErrorStatus SUCCESS if construction was successful
* ERROR otherwise
*
* @todo
* -----------------------------------------------------------------------------
*/
extern ErrorStatus ADCDevice_construct(struct ADCDevice* self, ADCReadFunction read, unsigned int resolutionInBits);
/** ----------------------------------------------------------------------------
* ADCDevice_destruct
* Destructor for ADC device
*
* @param self ADC object
*
* @return void
*
* @todo
* -----------------------------------------------------------------------------
*/
extern void ADCDevice_destruct(struct ADCDevice* self);
/** ----------------------------------------------------------------------------
* ADCDevice_read
* Reads a value from the ADC device input
*
* @param self ADC object
*
* @return uint32_t The current value read from the ADC
*
* @todo
* -----------------------------------------------------------------------------
*/
extern uint32_t ADCDevice_read(const struct ADCDevice* self);
#endif /* INC_ADCDEVICE_H_ */
/** @} */