Download RCC-1.2.18 drivers Manual

Prototypes
Non-zero return meaning
int gradcdac_DAC_ReqRej(unsigned int status)
DAC conversion request rejected
int gradcdac_DAC_isCompleted(unsigned int status)
DAC conversion complete
int gradcdac_DAC_isOngoing(unsigned int status)
DAC conversion is ongoing
int gradcdac_ADC_isTimeouted(unsigned int status)
ADC sample timed out
int gradcdac_ADC_ReqRej(unsigned int status)
ADC sample request rejected
int gradcdac_ADC_isCompleted(unsigned int status)
ADC conversion is completed
int gradcdac_ADC_isOngoing(unsigned int status)
ADC conversion is ongoing
Table 146: Status interpretation help functions
32.2.6.3 ADC functions
A short summary to the functions are presented in the prototype lists below.
Operating on all ports
void gradcdac_adc_convert_start(void)
int gradcdac_adc_convert_try(unsigned short *digital_value)
int gradcdac_adc_convert(unsigned short *digital_value)
Table 147: ADC functions
32.2.6.3.1 gradcdac_adc_convert_start
Make the ADC circuitry initialize an analogue to digital conversion. The result can be read out by
gradcdac_adc_convert_try or gradcdac_adc_convert.
32.2.6.3.2 gradcdac_adc_convert_try
Tries to read the conversion result previously started with gradcdac_adc_convert_start. If the
circuitry is busy converting the function returns a non-zero value, if the conversion has
successfully finished zero is returned.
Return Code
Description
Zero
ADC conversion complete, digital_value contain current conversion result.
Positive
ADC busy, digital value contain previous conversion result.
Negative
ADC conversion request failed
Table 148: gradcdac_adc_convert_try return code
32.2.6.3.3 gradcdac_adc_convert
Waits until the ADC circuity has finished a digital to analogue conversion. The waiting is
implemented as a busy loop utilizing 100% CPU load. This function returns zero on success and a
negative value on failure, a positive result is never returned. See table 142 for a description of
the return values.