Documentation of the CAI022_IM hardware class

Hardware class CAI022_IM

for the C-DIAS analogue input module CAI022

This hardware class is used to control the CAI022 hardware module with 2 measuring bridges (+/- 2 mV/V). Special information can be seen in the module documentation.

Interfaces
Clients
MasterConnect This client serves the communication with the DiasMasterC hardware class and therefore has to be connected to the server Control or to the server Control of the CICXXX_IM hardware class. Special information can be seen in the documentation of the classes DiasMasterC and CICXXX_IM. On this client the address of the hardware module (C-DIAS plug position number) is written as initialization value. With this channel it can be decided whether the class is called in Cyclic or Realtime task. This client has to be set as initialization value.

Place CyRt

16.10.2007

V2.7

Page 1

Documentation of the CAI022_IM hardware class Server

State This server shows the state of the hardware class. If the value is > 0 an error occurred (e.g. wrong setting of the Place client). For an acceptable functionality of the hardware class this server has to display the value 0. Bit 0 to 3 are set in the initialization phase and avoid access to the hardware module, because necessary pre-conditions for operation are not existent.

Bit 0: Bit 1: Bit 2: Bit 3:

WrongHW: NoHW: NoCalibration: ParaChkWrong:

Another hardware module has been recognized on the bus as configured with Lasal. There is no hardware module on the given position. The connected hardware module is calibrated (EEPROM data are not right). not

The parameters for the module are wrong (internally: not used yet).

Bit 4 to 5 are set during runtime when limit values in the hardware class (e.g. temperature values at analogue cards) are exceeded.

Bit 4: Bit 5:

PhysicHiLimit: PhysicLoLimit:

Exceeded upper limit Exceeded lower limit

Bit 6: Bit 7 - 12: Bit 13: Bit 14:

Invert: rffu OnDummyMode: NotConnected:

Not used Not used Not used A client/server used for data output in not connected in the object network (hasnt be an error). Access to the hardware module is prevented (because of an error).

Bit 15:

PhysicAccessOff:

uiChNo: This structure element is only existent for compatibility reasons and is no longer used in the hardware classes. CH[1-2]_Enable These servers are used to activate the respective channel. 0 = not active, 1 = active

Page 2

V2.7

16.10.2007

Documentation of the CAI022_IM hardware class

CH[1-2]_Filter

With these servers the desired filters of the channels are set. 0: fg = fSamp / 8 1: fg = fSamp / 16 2: fg = fSamp / 32 3: fg = fSamp / 64 Data for filter output 1 of the respective channels. (18 bit ADC bit value) Data for filter output 2 of the respective channels. (18 bit ADC bit value) This server is set when an error occurred on the respective channel. If an adjustment is changed, this server is set to 1, which means the adjustment has not been accepted yet. To accept the set data of the servers CH[1-2]_Enable, respectively, CH[1-2]_Filter a Write() access has to be made on this server. With it the configuration is set on the module and the value of the server is set to 0 again.

CH[1-2]_Out1 CH[1-2]_Out2 CH[1-2]_Error Set_Configuration

Error_State

This server is on 1 during warm-up phase. After the warm-up phase is finished the server is set to 0. From now on the channel is displayed on which an overflow error signal occurs. -1 = warm-up phase runs 0 = everything OK 1 = Signal Overflow Channel 1 2 = Signal Overflow Channel 2

Version_Revision Version_Major Version_Minor

Shows the highest version number of the firmware ( X.x.x ). Shows the middle version number of the firmware ( x.X.x ). Shows the lowest version number of the firmware ( x.x.X ).

16.10.2007

V2.7

Page 3

Documentation of the CAI022_IM hardware class

Global functions
ReadEEData With this function the EEprom data of the module can be read-out. Transfer parameters: ui_offset ui_length p_data Return parameter: sd_retval : DINT 0 = OK, -1 = Offset + Length exceed 256 bytes, -2 = invalid data pointer, -4 = error at EEprom readout : UINT : UINT : UINT Address offset in the EEPROM. Length of the data to be read in bytes. Pointer to the data where the data should be written to.

As this function takes a lot of time, it should only be called in Background method. WriteEEData With this function data can be written specifically to the EEprom. Transfer parameters: ui_offset ui_length p_data : UINT : UINT : UINT Address offset in the EEPROM (valid from 16#80 to 16#FF). Length of the data to be read in bytes. Pointer to the memory where the data to be written are positioned. 0 = OK, -1=Offset + Length exceed 256 bytes, -2 = invalid data pointer, -3 = to low address offset, -4 = error at EEprom read-out

Rckgabeparameter: sd_retval : DINT

As this function takes a lot of time, it should only be called in Background method.

Page 4

V2.7

16.10.2007

Documentation of the CAI022_IM hardware class

Access times s
At the measurements all channels run in cyclic or realtime. The following measurement values are only reference values, which can vary depending on the setting and efficiency of the hardware class. At measurement of the average times the hardware was in errorfree state.

C-IPC
Directly on the C-DIAS bus Minimum Realtime Cyclic 1 1 Maximum 18 18 Average 10,95 11,23 Via DIAS bus (CIC module) Minimum 1 1 Maximum 12 12 Average 7,45 7,64

CCL911
Directly on the C-DIAS bus Minimum Realtime Cyclic 3 4 Maximum 33 31 Average 20,5 21,52 Via DIAS bus (CIC module) Minimum 4 4 Maximum 25 23 Average 15,53 14,49

CCL721
Directly on the C-DIAS bus Minimum Realtime Cyclic 40 40 Maximum 81 79 Average 72,24 72,06 Via DIAS bus (CIC module) Minimum 45 46 Maximum 179 179 Average 144,46 147,12

Times in the intelligent master

Main time Realtime / Cyclic Time Realtime Time Cyclic 76,65 76,65

The times are maximum times and can differ depending on the configuration of the hardware class.

16.10.2007

V2.7

Page 5

Documentation of the CAI022_IM hardware class

Internal peculiarity
As the warm-up phase can take long, the initialization of the individual server is executed not until the first cyclic/ runtime cycle after warm-up phase finish.

Page 6

V2.7

16.10.2007

Documentation of the CAI022_IM hardware class

Example

16.10.2007

V2.7

Page 7

Documentation of the CAI022_IM hardware class

Page 8

V2.7

16.10.2007