268 lines
9.7 KiB
C
Executable File
268 lines
9.7 KiB
C
Executable File
/*
|
|
ChibiOS - Copyright (C) 2006..2016 Giovanni Di Sirio
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
/**
|
|
* @file hal_dac.h
|
|
* @brief DAC Driver macros and structures.
|
|
*
|
|
* @addtogroup DAC
|
|
* @{
|
|
*/
|
|
|
|
#ifndef HAL_DAC_H
|
|
#define HAL_DAC_H
|
|
|
|
#if (HAL_USE_DAC == TRUE) || defined(__DOXYGEN__)
|
|
|
|
/*===========================================================================*/
|
|
/* Driver constants. */
|
|
/*===========================================================================*/
|
|
|
|
/*===========================================================================*/
|
|
/* Driver pre-compile time settings. */
|
|
/*===========================================================================*/
|
|
|
|
/**
|
|
* @name DAC configuration options
|
|
* @{
|
|
*/
|
|
/**
|
|
* @brief Enables synchronous APIs.
|
|
* @note Disabling this option saves both code and data space.
|
|
*/
|
|
#if !defined(DAC_USE_WAIT) || defined(__DOXYGEN__)
|
|
#define DAC_USE_WAIT TRUE
|
|
#endif
|
|
|
|
/**
|
|
* @brief Enables the @p dacAcquireBus() and @p dacReleaseBus() APIs.
|
|
* @note Disabling this option saves both code and data space.
|
|
*/
|
|
#if !defined(DAC_USE_MUTUAL_EXCLUSION) || defined(__DOXYGEN__)
|
|
#define DAC_USE_MUTUAL_EXCLUSION TRUE
|
|
#endif
|
|
/** @} */
|
|
|
|
/*===========================================================================*/
|
|
/* Derived constants and error checks. */
|
|
/*===========================================================================*/
|
|
|
|
/*===========================================================================*/
|
|
/* Driver data structures and types. */
|
|
/*===========================================================================*/
|
|
|
|
/**
|
|
* @brief Driver state machine possible states.
|
|
*/
|
|
typedef enum {
|
|
DAC_UNINIT = 0, /**< Not initialized. */
|
|
DAC_STOP = 1, /**< Stopped. */
|
|
DAC_READY = 2, /**< Ready. */
|
|
DAC_ACTIVE = 3, /**< Exchanging data. */
|
|
DAC_COMPLETE = 4, /**< Asynchronous operation complete. */
|
|
DAC_ERROR = 5 /**< Error. */
|
|
} dacstate_t;
|
|
|
|
#include "hal_dac_lld.h"
|
|
|
|
/*===========================================================================*/
|
|
/* Driver macros. */
|
|
/*===========================================================================*/
|
|
|
|
/**
|
|
* @name Low level driver helper macros
|
|
* @{
|
|
*/
|
|
#if (DAC_USE_WAIT == TRUE) || defined(__DOXYGEN__)
|
|
/**
|
|
* @brief Waits for operation completion.
|
|
* @details This function waits for the driver to complete the current
|
|
* operation.
|
|
* @pre An operation must be running while the function is invoked.
|
|
* @note No more than one thread can wait on a DAC driver using
|
|
* this function.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_wait_s(dacp) osalThreadSuspendS(&(dacp)->thread)
|
|
|
|
/**
|
|
* @brief Resumes a thread waiting for a conversion completion.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_reset_i(dacp) osalThreadResumeI(&(dacp)->thread, MSG_RESET)
|
|
|
|
/**
|
|
* @brief Resumes a thread waiting for a conversion completion.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_reset_s(dacp) osalThreadResumeS(&(dacp)->thread, MSG_RESET)
|
|
|
|
/**
|
|
* @brief Wakes up the waiting thread.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_wakeup_isr(dacp) { \
|
|
osalSysLockFromISR(); \
|
|
osalThreadResumeI(&(dacp)->thread, MSG_OK); \
|
|
osalSysUnlockFromISR(); \
|
|
}
|
|
|
|
/**
|
|
* @brief Wakes up the waiting thread with a timeout message.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_timeout_isr(dacp) { \
|
|
osalSysLockFromISR(); \
|
|
osalThreadResumeI(&(dacp)->thread, MSG_TIMEOUT); \
|
|
osalSysUnlockFromISR(); \
|
|
}
|
|
|
|
#else /* !DAC_USE_WAIT */
|
|
#define _dac_wait_s(dacp)
|
|
#define _dac_reset_i(dacp)
|
|
#define _dac_reset_s(dacp)
|
|
#define _dac_wakeup_isr(dacp)
|
|
#define _dac_timeout_isr(dacp)
|
|
#endif /* !DAC_USE_WAIT */
|
|
|
|
/**
|
|
* @brief Common ISR code, half buffer event.
|
|
* @details This code handles the portable part of the ISR code:
|
|
* - Callback invocation.
|
|
* .
|
|
* @note This macro is meant to be used in the low level drivers
|
|
* implementation only.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_isr_half_code(dacp) { \
|
|
if ((dacp)->grpp->end_cb != NULL) { \
|
|
(dacp)->grpp->end_cb(dacp, (dacp)->samples, (dacp)->depth / 2); \
|
|
} \
|
|
}
|
|
|
|
/**
|
|
* @brief Common ISR code, full buffer event.
|
|
* @details This code handles the portable part of the ISR code:
|
|
* - Callback invocation.
|
|
* - Waiting thread wakeup, if any.
|
|
* - Driver state transitions.
|
|
* .
|
|
* @note This macro is meant to be used in the low level drivers
|
|
* implementation only.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_isr_full_code(dacp) { \
|
|
if ((dacp)->grpp->end_cb != NULL) { \
|
|
if ((dacp)->depth > 1) { \
|
|
/* Invokes the callback passing the 2nd half of the buffer.*/ \
|
|
size_t half = (dacp)->depth / 2; \
|
|
size_t half_index = half * (dacp)->grpp->num_channels; \
|
|
(dacp)->grpp->end_cb(dacp, (dacp)->samples + half_index, half); \
|
|
} \
|
|
else { \
|
|
/* Invokes the callback passing the whole buffer.*/ \
|
|
(dacp)->grpp->end_cb(dacp, (dacp)->samples, (dacp)->depth); \
|
|
} \
|
|
} \
|
|
}
|
|
|
|
/**
|
|
* @brief Common ISR code, error event.
|
|
* @details This code handles the portable part of the ISR code:
|
|
* - Callback invocation.
|
|
* - Waiting thread timeout signaling, if any.
|
|
* - Driver state transitions.
|
|
* .
|
|
* @note This macro is meant to be used in the low level drivers
|
|
* implementation only.
|
|
*
|
|
* @param[in] dacp pointer to the @p DACDriver object
|
|
* @param[in] err platform dependent error code
|
|
*
|
|
* @notapi
|
|
*/
|
|
#define _dac_isr_error_code(dacp, err) { \
|
|
dac_lld_stop_conversion(dacp); \
|
|
if ((dacp)->grpp->error_cb != NULL) { \
|
|
(dacp)->state = DAC_ERROR; \
|
|
(dacp)->grpp->error_cb(dacp, err); \
|
|
if ((dacp)->state == DAC_ERROR) \
|
|
(dacp)->state = DAC_READY; \
|
|
} \
|
|
(dacp)->grpp = NULL; \
|
|
_dac_timeout_isr(dacp); \
|
|
}
|
|
/** @} */
|
|
|
|
/*===========================================================================*/
|
|
/* External declarations. */
|
|
/*===========================================================================*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
void dacInit(void);
|
|
void dacObjectInit(DACDriver *dacp);
|
|
void dacStart(DACDriver *dacp, const DACConfig *config);
|
|
void dacStop(DACDriver *dacp);
|
|
void dacPutChannelX(DACDriver *dacp,
|
|
dacchannel_t channel,
|
|
dacsample_t sample);
|
|
void dacStartConversion(DACDriver *dacp, const DACConversionGroup *grpp,
|
|
dacsample_t *samples, size_t depth);
|
|
void dacStartConversionI(DACDriver *dacp, const DACConversionGroup *grpp,
|
|
dacsample_t *samples, size_t depth);
|
|
void dacStopConversion(DACDriver *dacp);
|
|
void dacStopConversionI(DACDriver *dacp);
|
|
#if DAC_USE_WAIT
|
|
msg_t dacConvert(DACDriver *dacp, const DACConversionGroup *grpp,
|
|
dacsample_t *samples, size_t depth);
|
|
#endif
|
|
#if DAC_USE_MUTUAL_EXCLUSION
|
|
void dacAcquireBus(DACDriver *dacp);
|
|
void dacReleaseBus(DACDriver *dacp);
|
|
#endif
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* HAL_USE_DAC == TRUE */
|
|
|
|
#endif /* HAL_DAC_H */
|
|
|
|
/** @} */
|