/*
** ===================================================================
** Method : AD1_Calibrate (component ADC)
** Description :
** This method starts self calibration process. Calibration is
** typically used to remove the effects of the gain and offset
** from a specific reading.
** Parameters :
** NAME - DESCRIPTION
** WaitForResult - Wait for a result of
** calibration. If the <interrupt service> is
** disabled, the WaitForResult parameter is
** ignored and the method waits for
** calibration result every time.
** Returns :
** --- - Error code
** ERR_OK - OK
** ERR_BUSY - A conversion is already running
** ERR_SPEED - This device does not work in
** the active speed mode
** ERR_DISABLED - Device is disabled
** ERR_FAILED - Calibration hasn't been
** finished correctly
** ===================================================================
*/
byte PE_AD1_Calibrate(void)
{
if (ModeFlg != STOP) { /* Is the device in different mode than "stop"? */
return ERR_BUSY; /* If yes then error */
}
(void)AdcLdd1_GetMeasurementCompleteStatus(AdcLdd1_DeviceDataPtr); /* Clear measurement complete status */
(void)AdcLdd1_StartCalibration(AdcLdd1_DeviceDataPtr); /* Start calibration */
while (!AdcLdd1_GetMeasurementCompleteStatus(AdcLdd1_DeviceDataPtr)) {}; /* Wait until calibration ends */
if (AdcLdd1_GetCalibrationResultStatus(AdcLdd1_DeviceDataPtr) != ERR_OK) { /* If calibration failed flag is set */
ModeFlg = STOP; /* Set the device to the stop mode */
return ERR_FAILED; /* Return ERR_FAILED error code */
}
return ERR_OK; /* ADC device is now calibrated */
}
/*
** ===================================================================
** Method : AD1_Calibrate (component ADC)
** Description :
** This method starts self calibration process. Calibration is
** typically used to remove the effects of the gain and offset
** from a specific reading.
** Parameters :
** NAME - DESCRIPTION
** WaitForResult - Wait for a result of
** calibration. If the <interrupt service> is
** disabled, the WaitForResult parameter is
** ignored and the method waits for
** calibration result every time.
** Returns :
** --- - Error code
** ERR_OK - OK
** ERR_BUSY - A conversion is already running
** ERR_SPEED - This device does not work in
** the active speed mode
** ERR_DISABLED - Device is disabled
** ERR_FAILED - Calibration hasn't been
** finished correctly
** ===================================================================
*/
byte AD1_Calibrate(bool WaitForResult)
{
if (ModeFlg != STOP) { /* Is the device in different mode than "stop"? */
return ERR_BUSY; /* If yes then error */
}
ModeFlg = CALIBRATING; /* Set state of device to the calibration mode */
(void)AdcLdd1_GetMeasurementCompleteStatus(AdcLdd1_DeviceDataPtr); /* Clear measurement complete status */
(void)AdcLdd1_StartCalibration(AdcLdd1_DeviceDataPtr); /* Start calibration */
if (!WaitForResult) { /* If doesn't wait for result */
return ERR_OK; /* then return ERR_OK, but user have to check the result of calibration e.g. by GetCalibrationStatus method */
}
while (!AdcLdd1_GetMeasurementCompleteStatus(AdcLdd1_DeviceDataPtr)) {}; /* Wait until calibration ends */
if (AdcLdd1_GetCalibrationResultStatus(AdcLdd1_DeviceDataPtr) != ERR_OK) { /* If calibration failed flag is set */
ModeFlg = STOP; /* Set the device to the stop mode */
return ERR_FAILED; /* Return ERR_FAILED error code */
}
return ERR_OK; /* ADC device is now calibrated */
}
/*
** ===================================================================
** Method : MainMeasure (component ADC)
**
** Description :
** The method performs the conversion of the input channels in
** the polling mode.
** This method is internal. It is used by Processor Expert only.
** ===================================================================
*/
static void AD1_MainMeasure(void)
{
AdcLdd1_TResultData ResultData;
byte SumCnt; /* Counter of conversions */
byte SumChan; /* Counter of measured channels */
for (SumCnt=0U; SumCnt<16U; SumCnt++) {
for (SumChan=0U; SumChan<8U; SumChan++) {
SampleGroup[0].ChannelIdx = SumChan;
(void)AdcLdd1_CreateSampleGroup(AdcLdd1_DeviceDataPtr, (LDD_ADC_TSample *)SampleGroup, 1U); /* Configure sample group */
(void)AdcLdd1_StartSingleMeasurement(AdcLdd1_DeviceDataPtr);
while (AdcLdd1_GetMeasurementCompleteStatus(AdcLdd1_DeviceDataPtr) == FALSE) {} /* Wait for AD conversion complete */
AdcLdd1_GetMeasuredValues(AdcLdd1_DeviceDataPtr, (LDD_TData *)&ResultData);
AD1_OutV[SumChan] += ResultData;
}
}
OutFlg = TRUE; /* Measured values are available */
ModeFlg = STOP; /* Set the device to the stop mode */
}
