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

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

<<
128.182.1.2
IMess4C.IsActive|IsActive
!128.182.2.2
--
<!DEF>
function <!TW>IMess4C.IsActive (aCard :address) : real;
<!TXT>
Returns the active measuring channel (1 - 4) of the card <!PW>aCard or 0, if no channel is activated.
>>

<<
128.182.1.3
IMess4C.Inc|Inc
--
<!DEF>
function <!TW>IMess4C.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.182.1.4
IMess4C.Dec|Dec
--
<!DEF>
function <!TW>IMess4C.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.182.2
Procedures of the IMess4C Object|Procedures
--
>>

<<
128.182.2.1
IMess4C.Setup|Setup
!128.182.2.3
--
<!DEF>
procedure <!TW>IMess4C.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,01 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<!>
<!c>4<!>Gain : x 10000<!>
<!ETBL>
>>

<<
128.182.2.2
IMess4C.Active|Active
!128.182.2.3
!128.182.1.2
--
<!DEF>
procedure <!TW>IMess4C.Active (aCard : address; rChannel : real);
<!TXT>
Switches the measuring channel (1-4) of the card <!PW>aCard as defined in <!PW>rChannel on. A value of 0 turns off all channels. Only one measuring channel can be activated at the same time. The change over between the measuring channels can be uninteruptible. This depends on the setup from then input channels.

>>

<<
128.182.2.3
IMess4C.SetupChannels|SetupChannels
!128.182.2.2
--
<!DEF>
procedure <!TW>IMess4C.SetupChannels (aCard : address; rChannel1, rChannel2, rChannel3, rChannel4 : real);
<!TXT>
Activated or deactivated channels (not the measurement) of the card <!PW>aCard.

<!STBL>
<!+>rChannel1 - 4<!+>Result<!>
<!c>0<!>keep actual setting<!>
<!c>1<!>channel open<!>
<!c>2<!>channel closed<!>
<!ETBL>
>>

<<
128.182.2.4
IMess4C.SetupSense|SetupSense
--
<!DEF>
procedure <!TW>IMess4C.SetupSense (aCard : address; rSense1, rSense2, rSense3, rSense4 : real);
<!TXT>
Activated or deactivated the sense circuit of the card <!PW>aCard.

<!STBL>
<!+>rSense1 - 4<!+>Result<!>
<!c>0<!>keep actual setting<!>
<!c>1<!>sense open<!>
<!c>2<!>sense closed<!>
<!ETBL>

>>

<<
128.182.2.5
IMess4C.SetupCalibration|SetupCalibration
!128.182.2.6
--
<!DEF>
procedure <!TW>IMess4C.SetupCalibration (aCard : address; rChipSelect, rDirection : real);
<!TXT>
Activated or deactivatedthe the calibration of the card <!PW>aCard.

<!STBL>
<!+>rChipSelect<!+>Result<!>
<!c>0<!>calibartion deactivated<!>
<!c>1<!>calibration for chip 1<!>
<!c>2<!>calibration for chip 2<!>
<!ETBL>

<!STBL>
<!+>rDirection<!+>Result<!>
<!c>0<!>calibration up<!>
<!c>1<!>calibration down<!>
<!ETBL>
>>

<<
128.182.2.6
IMess4C.Trigger|Trigger
!128.182.2.5
--
<!DEF>
procedure <!TW>IMess4C.Trigger (aCard : address; rTrigger : real);
<!TXT>
Calibration ot the card <!PW>aCard.

<!STBL>
<!+>rTrigger<!+>Result<!>
<!c>0 / False<!>trigger off<!>
<!c>1 / True <!>trigger on<!>
<!ETBL>
>>

