Detailed Description

The PWMOperator encodes input value into a pulse width modulated bool output value.

Pulse-width modulation (PWM) is a modulation technique used to encode a message into a pulsing value. Its main use is to allow the control of the power supplied to electrical devices, such as motors.

If input <= MinInput then the output bool value is false. If input >= MaxInput then the output bool value is true. For input value X between MinInput and MaxInput, output is a pulsing value that is true X percent of time.

Arguments

Note: When using PWMOperator, it is recommended to set your component fs Property to at least 1000 Hz (or use a lower Resolution). Otherwise pulsing output might be too slow for smooth operation of a motor.

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.

Actual Processing Code of the PWMOperator

unsigned int PWMOperator::Process()
{
  if (!m_minInput || !m_maxInput || !m_pwmResolution)
    return STATUS_ERROR;

  double input = m_input.GetVariantValue().GetConvertedValue<double>();
  input = std::max<double>(input, (double)*m_minInput);
  input = std::min<double>(input, (double)*m_maxInput);
  double dutyCycle = (*m_maxInput - static_cast<double>(*m_minInput))?(input - *m_minInput) / (*m_maxInput - static_cast<double>(*m_minInput)) : 0.0;

  ++m_counter;
  if (m_counter == *m_pwmResolution)
    m_counter = 0;

  if (m_counter < dutyCycle * *m_pwmResolution)
    m_output = 1;
  else
    m_output = 0;

  return STATUS_OK;
}