====== StepPulse ======

Output a finite pulse train on the specified ''pin'' using a PIO state machine.

===== Syntax =====

<code python>
from cubloc import StepPulse

StepPulse(pin: int, freq: int, qty: int)
</code>

===== Parameters =====

  * **pin**: Output GPIO pin number.
  * **freq**: Output frequency in pulses per second.
  * **qty**: Number of pulses to output.

===== Exceptions =====

  * [[https://docs.micropython.org/en/latest/library/builtins.html#TypeError|TypeError]]: ''channel'', ''pin'', ''freq'', or ''qty'' has an invalid type.
  * [[https://docs.micropython.org/en/latest/library/builtins.html#ValueError|ValueError]]: ''channel'', ''freq'', or ''qty'' is outside the supported range.

===== Notes =====

  * Note: Pulse generation is handled by PIO, not PWM.

===== Example =====

<code python>
from cubloc import StepPulse

StepPulse(15, 2000, 5000)

while True:
    pass
</code>

===== Related APIs =====

  * [[logicpython:cubloc_api:stepaccel|StepAccel]]
  * [[logicpython:cubloc_api:stepstat|StepStat]]
  * [[logicpython:cubloc_api:stepstop|StepStop]]