PWMOut.h

Go to the documentation of this file.

/************************************************
*
*  CROSSCONTROL AUX API
*
*  PWMOut.h
*
*  Version 2.8.3.0, 2016-04-06
*
*  (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 */