I_Apci1500_Inittimercounter1 - Addi-Data ADDINUM CPCI-1500 Technical Description

APCI-/CPCI-1500

2) i_APCI1500_InitTimerCounter1 (...)

Syntax:
<Return value> = i_APCI1500_InitTimerCounter1
Parameters:
BYTE
BYTE
LONG
BYTE b_ContinuousOrSingleCycleSelect: - APCI1500_CONTINUOUS:
BYTE
Task:
Selects the operating mode of the first counter/timer. The user enters its start value.
You have to decide:
- if the counter/timer must execute once or several times the counting operation,
- if the counter/timer is used as a counter or a timer,
- and if an interrupt must be generated when the counter/timer has run down.
Return value:
0: No error
-1: The handle-parameter of the board is wrong
-2: The parameter for selecting the counter or the timer is wrong
(APCI1500_COUNTER or APCI1500_TIMER)
-3: Error with the interrupt selection
(APCI1500_ENABLE or APCI1500_DISABLE)
-4: The user interrupt routine is not installed
-5: Cycle parameter is wrong (APCI1500_CONTINUOUS or APCI1500_SINGLE)
84
b_BoardHandle:
b_CounterOrTimerSelect:
l_ReloadValue:
b_InterruptHandling:
Technical description
(BYTE b_BoardHandle,
BYTE b_CounterOrTimerSelect,
LONG_ l_ReloadValue,
BYTE b_ContinuousOrSingleCycleSelect,
BYTE b_InterruptHandling)
Handle of the xPCI-1500
Select the mode of the first counter/timer
- APCI1500_TIMER :
The first counter/timer is used as timer
- APCI1500_COUNTER :
The first counter/timer is used as counter
This parameter has two meanings.
If the counter/timer is used as a counter,
it loads the start value of the counter.
If the counter/timer is used as a timer,
it loads the divider factor for the output.
Each time the counter value or timer value
is set to "0", l_ReloadValue is loaded.
- APCI1500_SINGLE:
If the counter or timer value is set to
"0", the counter or timer is stopped.
Interrupts can be generated , when the
counter has run down, or when the
timer output is on high.
With this parameter the user decides if
interrupts are used or not.
APCI1500_ENABLE: Interrupts are
enabled.
APCI1500_DISABLE:
Interrupts are disabled.
Chapter 9