Detailed Description

The ADConverter can be used to convert the input analog signal values to corresponding digital value.

Arguments

When operator is used inside a signal its default input is automatically tied to signal's InternalValue or previous operator's output. Its default output is automatically tied to next operator's input or to signal's Value. See also CDP Operator Usage In CDP Signals.

Example

Below is an example plot of sinusoidal analog input signal (cyan) and the same signal with ADConverter(InputRange=1, OutputRange=1024, Bipolar=true) applied (orange).

Note, that in this example ADConverter is in low frequency component so values are read and converted using lower frequency than the original analog signal changes:

Actual Processing Code of the ADConverter

unsigned int ADConverter<double>::Process()
{
  if (!m_inputRange || !m_bipolar || !m_outputRange || !m_outOfRange)
    return STATUS_ERROR;

  double inRange = (double)*m_inputRange;
  unsigned int outRange = (unsigned int)*m_outputRange;
  if (inRange <= 0 || outRange == 0)
  {
    GetParent()->ReportConfigurationFault(this, "InputRange and OutputRange must be greater than zero");
    m_faultReported = true;
    return STATUS_ERROR;
  }

  bool bipolar = (bool)*m_bipolar;
  double out = rint(((double)m_input) / inRange * outRange / (bipolar ? 2 : 1) + (bipolar ? (outRange / 2) : 0));
  if (out > outRange)
  {
    *m_outOfRange = true;
    out = outRange;
  } else if (out < 0) {
    *m_outOfRange = true;
    out = 0;
  } else
    *m_outOfRange = false;

  m_output = out;

  if (m_faultReported)
  {
    GetParent()->ClearConfigurationFault(this);
    m_faultReported = false;
  }
  return STATUS_OK;
}