Block
Mask
Description
This block was developed by Opal-RT to interface to the fault insertion tool EFS from Malibu Technologies or the ES4440 from ETAS.
The following information is from the EFS user manual. EFS was developed as a failure mode verification tool.
It is essentially a relay bank that offers the following advantages over a traditional break out box:
- Faults can be caused at a precise point in time.
- Faults can be event driven.
- A list of failures can be automated.
The ES4440 Compact Fault Simulation Module offers the following key features:
- Real-time fault simulation
- 64 high current channels and 16 high voltage channels
- Simulation of loose contacts
- API for customized system integration
- Deployment for automated testing
- CAN and Ethernet communication interfaces for simulation control
- Supported faults:
Short to GND/UBATT
Pin to pin faults
Cable breaks
Leakage current
Multiple faults for short to GND/UBATT and cable break
Parameters
EFS box: Select the FIU model
- MTI: Malibu Technologies EFS
- ES4440: ETAS Compact Fault Simulation Module
Hardware Interface Type: Select the type of hardware interface to be used for communicating to the FIU Box (applies only to MTI hardware).
- Auto: The software look for a USB device, if not detected it will use the parallel port
- USB Port: Use USB device
- Parallel Port: Use parallel port.
Parallel Port Address: If used, specify the parallel port address of the target computer.
Remote Address: IP address of the ES4440 module.
Trigger Type: This parameter is set by default to the rising edge. Used to latch the command input
Max Number of EFS Boxes: Specify the number of FIU boxes in used. No more than 3 EFS boxes are allowed (applies only to MTI hardware).
Max Number of Fault Signals: Specify the maximum number of fault signals to be tested simultaneously. This value can be between 1 and 120, for the EFS, depending on the power supply driving the internal relays.
Sample Time: Specify the model sample time, this value will be use to compute the test duration
Inputs
Signals List: Provide the signals list you want to work with.
For the MTI EFS, the signals range from 1 to 120. Signal 1 represents the signal A on the EFS, 2 represents B, 3 represents C, and so on. Note that the number of signals depends on the value of the parameter “Max Number of Fault Signals”.> For instance the second FIU signal range would be from 121 to 240, the third FIU would be from 241 to 360. The input size will be the number of max faults x number of FIU.
Actions List: The actions list specifies the type of fault to be inserted. Refer to the next figure for Actions Number. Note that the maximum number of signals depends on the value of the parameter “Max Number of Fault Signals”. The input size will be the number of max faults x number of FIU.
Note: for high voltage channels of the ETAS ES4400 FIU, a fault can only be set on only one channel per command. This means that “Actions list” values for the other channels must be set to 10 so they operate in normal mode.
Latch: (MTI only) This input will activate the specific command present at the command input. This input will be active on a rising edge. Refer to the command input description for more details.
Command: (MTI only) This input will retrieve the desired command to execute; This input could receive the following values:
- Reset: Reset the EFS to it’s normal state, no fault.
- Load: Load the Signals & Actions list to the EFS.
- Enable: Enable the faults.
- Disable: Disable the faults.
Note: The Duration of the test can be controlled using the Test Duration input line.
Test Duration: Specify the duration fault in seconds. If this value is 0, the duration will be controlled by the Command input as its value is set to Enable or Disable. When test duration is specified, the test will start when an enable command is activated by the Latch input. The EFS will return to a disable state (or normal state?) after the specified duration has elapsed.
Frequency: (ES4440 only) frequency for simulation of loose contacts.
Duty: (ES4440 only) duty cycle for simulation of loose contacts.
Resistor value: (ES4440 only) Resistor cascade value.
Outputs
Load State: When the Signal and Action list is loaded into the EFS, this output will show 1, otherwise the output will be 0.
Enable State: When value is 0, the EFS is disable state. When value is 1, the EFS is enabled state and a test is in progress.
Reset State: When value is 0, the EFS is not in reset state. When value is 1, the EFS is in reset state.
Version Number: Return the AutoEFS software version.
Error Number: Return the current error number.
- Error code 0: Functional.
- Error code 1: Invalid code version (Software version mismatch).
- Error code 2: Communication port not responding (Check cable, BIOS setting or Target config).
Note: These errors can be added. For instance if you get an error #3 this means that the error #1 and #2 are active.
Characteristics and Limitations
Extra Files
These files need to be transfer to the RT-Lab Target node.
asyncEFS.c
asyncEFS.h
AsyncUSBUtils.c
AsyncUSBUtils.h
AsyncIPUtils.h
es4440_cmd.h
asyncEFS.mk
Target Computer Parallel Port Configuration:
When using the parallel port, make sure the process devc-par is not running. If this process is running the devc-par driver will interfere with the RT-Lab EFS driver.
How to know if devc-par is running? Type the following command at a QNX prompt, “ps-e”.This will list all the process currently running. If you see devc-par in the list go to /sbin and rename the devc-par to devc-par.orig with the following move command:
mv devc-par devc-par.orig
Note: After renaming the file reboot the target computer.
Also make sure that the BIOS setting for the Parallel Port are set to be SPP mode, this is the standard Parallel Port setting.
If USB is to be used, enable the port in the BIOS.
Caution from the Manufacturer
Every effort has been made to protect sensitive electronic equipment through the use of fuses and control software, however, this unit has modes that can inflict damage on test equipment and instrumentation. Exercise extreme caution when using modes other than open and normal. See refer to EFS user manual for more detail.
OS Limitations:
Qnx only.
Direct Feedthrough | N/A |
---|---|
Discrete sample time | N/A |
XHP support | No |
Work offline | No |