= StartDIOPulse =
Start a digital output pulse for the main board or a DIO option card.

{{{
int StartDIOPulse(int bd, int out, uint8 cond, int count, float pulseWidth, float dutyCycle);
}}}

{{{
int StartDIOPulse(int bd, int out, float dutyCycle);
}}}

== Parameters ==

 * bd - number of digital output card (main board output is not supported for pulse)
 * output - output number (outputs 1 - 4) only are supported
 * cond - DIO_PULSE_HIGH = start with output on, DIO_PULSE_LOW = start with output off
 * count - count of pulses to output, 0 = continuous until StopDIOPulse
 * pulseWidth = size of the cycle in seconds
 * dutyCycle = duty cycle .5 = 50 percent duty cycle

== Return Value ==

 * Returns the result - OK success

== Remarks ==

Requires main board version 1.19 and DIO card firmware version 0.05 or greater. The main board or option card must already be opened by calling OpenMnBd first. The call does a wait for acknowledgement. If the application is using main board communication events these events may be called during the wait for acknowledgement.

== Examples ==

{{{
if(StartDIOPulse(1, 1, DIO_PULSE_HIGH, 10, 2.0, 0.5) == OK)
    DisplayText(0, 0, "10 pulses 1 sec on 1 sec off");
}}}

{{{
if(StartDIOPulse(1, 4, 0.7) == OK)
    DisplayText(0, 0, "Card 1 Output 4 70 pct");
}}}

== See Also ==

 * [wiki:StopDIOPulse StopDIOPulse]
 * [wiki:SetOutputMask SetOutputMask]