PWMOut.h

Go to the documentation of this file.

/************************************************
*
*  CROSSCONTROL AUX API
*
*  PWMOut.h
*
*  Version 2.7.2.0, 2014-08-25
*
*  (c) maximatecc 2013
*
*  File description: 
*  PWM Output
*
*  Use the function GetPWMOut() to get a handle to pass on to the other functions.
*  Use the method PWMOut_release(PWMOUTHANDLE) to return the handle.
*
*  Note: The rise and fall times of the hardware limits the signal's usefulness in high frequencies.
*  The duty cycle of the PWM signal affects the maximum attainable frequency: at 50% duty cycle, the attainable frequecy is at it's maximum.
*  If the duty cycle is near 0 or 100%, the rise/fall times of the signal means that the maximum attainable frequency is significantly lower.
*  A PWM signal is generated when both the frequency and the duty cycle of a channel is not zero.
*
*  Example Usage:
*  @include pwmout_example.cpp
*
************************************************/
#ifndef CC_PWMOUT_H
#define CC_PWMOUT_H

#include "CCAuxErrors.h"
#include "CCPlatform.h"

#ifdef __cplusplus
namespace CrossControl {
#endif

  typedef void* PWMOUTHANDLE;

  EXTERN_C
    CCAUXDLL_API
    PWMOUTHANDLE
    CCAUXDLL_CALLING_CONV
    GetPWMOut(void);

  EXTERN_C
    CCAUXDLL_API
    void
    CCAUXDLL_CALLING_CONV
    PWMOut_release(PWMOUTHANDLE);


  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PWMOut_setPWMOutputChannelDutyCycle (PWMOUTHANDLE, unsigned char channel, unsigned char duty_cycle);


  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PWMOut_setPWMOutputChannelFrequency (PWMOUTHANDLE, unsigned char channel, float frequency);


  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PWMOut_getPWMOutputChannelDutyCycle (PWMOUTHANDLE, unsigned char channel, unsigned char* duty_cycle);


  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PWMOut_getPWMOutputChannelFrequency (PWMOUTHANDLE, unsigned char channel, float* frequency);


  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PWMOut_getPWMOutputStatus (PWMOUTHANDLE, unsigned char* status);


  EXTERN_C
    CCAUXDLL_API
    eErr
    CCAUXDLL_CALLING_CONV
    PWMOut_setPWMOutOff (PWMOUTHANDLE, unsigned char channel);


#ifdef __cplusplus
} /* namespace CrossControl */
#endif

#endif /* CC_PWMOUT_H */