:html
<<
128.155
IUConv-Object|IUConv
--
The IP Object <!RW>IUConv is used to control a current[I]/voltage[U] converter card of the UMS.
>>

<<
128.155.1
Functions of the IUConv Object|Functions
--
>>
<<
128.155.1.1
IUConv.Factor|Factor
--
<!DEF>
function <!TW>IUConv.Factor (aCard : address) : real;
<!TXT>
Returns the actual conversion factor (in [V/A]) for the IUConv card <!PW>aCard.
This factor depends on the active shunt and the gain of the PGA.
>>

<<
128.155.1.2
IUConv.Inc|Inc
--
<!DEF>
function <!TW>IUConv.Inc (aCard :address; rPreferHigherShunt : real) : real;
<!TXT>
Activates (if possible) the next higher current/voltage conversion factor of the card <!PW>aCard.

Returns <!RW>True, if a higher conversion factor was found.

If two combinations of PGA and shunt will provide the same factor, the chosen combination depends on <!PW>rPreferHigherShunt. If (<!RW>True), the combination with the higher shunt resp., if (<!RW>False) the combination with the lower shunt will be used.
>>
<<
128.155.1.3
IUConv.Dec|Dec
--
<!DEF>
function <!TW>IUConv.Dec (aCard :address; rPreferHigherShunt : real) : real;
<!TXT>
Activates (if possible) the next lower current/voltage conversion factor of the card <!PW>aCard. 

Returns <!RW>True, if a lower conversion factor was found.

If two combinations of PGA and shunt will provide the same factor, the chosen combination depends on <!PW>rPreferHigherShunt. If (<!RW>True), the combination with the higher shunt resp., if (<!RW>False) the combination with the lower shunt will be used.
>>
<<
128.155.1.2
IUConv.IsActive|IsActive
--
<!DEF>
function <!TW>IUConv.IsActive (aCard :address) : real;
<!TXT>
Returns <!RW>True, if the input relay of the card <!PW>aCard is active.
>>

<<
128.155.2
Procedures of the IUConv Object|Procedures
--
>>

<<
128.155.2.1
IUConv.Setup|Setup
--
<!DEF>
procedure <!TW>IUConv.Setup (aCard : address; rShunt, rPGA : real);
<!TXT>
Selects on the card <!PW>aCard the shunt and the gain of the PGA.

<!STBL>
<!+>rShunt<!+>Result<!>
<!c>0<!>keep the actuial shunt setup<!>
<!c>1<!>activate shunt 1 (default: 0,1 Ohm)<!>
<!c>2<!>activate shunt 2 (default: 10 Ohm)<!>
<!ETBL>
<!STBL>
<!+>rPGA<!+>Result<!>
<!c>0<!>keep actual gain setting<!>
<!c>1<!>Gain :  x 10<!>
<!c>2<!>Gain : x 100<!>
<!c>3<!>Gain : x 1000<!>
<!ETBL>
>>

<<
128.155.2.2
IUConv.Active|Active
--
<!DEF>
procedure <!TW>IUConv.Active (aCard : address; rOn : real);
<!TXT>
Switches the input relay of the card <!PW>aCard as defined in <!PW>rOn.

 <!PW>rOn can be : <!RW>OFF | <!RW>ON resp. 0..1.
>>


