| Table of Contents | ||
|---|---|---|
|
...
The I/O interface must be configured, and valid connections must be defined (using the Configuration section of the RT-LAB project) before the driver is launched at simulation start.
...
Every bitstream file (.bin), or programmable definition file (.pdi), programmed into an FPGA interfaced with the OPAL-RT Board driver must have an associated configuration file. The driver requires a description of the hardware installed in the simulator to correctly interface with it.
...
- Make sure the .opal file given by the field Bitstream configuration file exists.
- If it doesn't exist, find it and copy it in the project directory.
- Copy the .bin file to the project directory.
- Close the project.
- Re-open the project.
Users can also program the bitstream using RT-LAB's flash utility (see Flash bitstream wizard in RT-LAB Help files).
...
For a list of the possible chassis and board/module combinations, consult the list of compatibilities in the Limitations section.
See the General Configuration section below for more details on changing and loading configurations.
...
For a list of the possible remote chassis and board/module combinations, consult the list of compatibilities in the Limitations section.
Interface Overview
...
| Show advanced configuration | When selected, the user can configure advanced features: | |
|---|---|---|
| Time step factor | Denotes a multiplier for the board's speed in relation to the model's timestep. | |
| Enable FPGA register logger | For advanced debugging purposes, the driver will start a tool that will log all the FPGA register accesses during the initialization and the reset of the model. The logs will be saved in files named with the prefix "register_trace*". Those files are retrieved on the host PC after the reset of the model. | |
| Automatic bitstream reprogramming | If selected, bitstream programming is triggered automatically at the model load. The bitstreams should be placed at the model path and must have the name given in the configuration file used. If the bitstream currently programmed in the board is found to be the same as the one about to be programmed, then the bitstream is reloaded into the FPGA. The field is not available if the bitstream file is not Found. | |
| Bitstream file name | A static field showing the bitstream found based on the selected bitstream configuration file. | |
| Force | This option flashes the board even if it is already programmed with the same bitstream. | |
| Disable strict hardware mismatch validation | If selected, the use of multiple I/O card types based on general compatibility rules is activated instead of exact hardware ID values. | |
| Chassis name | This field will be available for the user to configure a custom name to be displayed on the Chassis LCD. NOTE: Only visible when Chassis type is OP4810 or OP4815. | |
| IP address | In order to allow bitstream programming, this field will be available for the user to enter the appropriate IP address that is displayed on the Chassis LCD. NOTE: Only visible when Chassis type is OP4810 or OP4815. | |
| Enable FPGA Scope | If selected, the FPGA Scope will be available when the model is executed. The option is visible only if the feature is available in the selected bitstream configuration file. | |
| Enable virtual mode | In virtual mode, the model can be executed even if this I/O interface is not compatible with the hardware configuration of the system. The connections between the model and the I/O interface will be done during the initialization, but the I/O interface will not do anything. The virtual mode can be used to troubleshoot problems on a system without having the required hardware, or to prepare a model with different I/O interfaces even if the final hardware platform is not available. | |
...
1. Select a bitstream configuration file (the same or different) from the drop-down containing available configuration files when Bitstream configuration location equals to Standard repositories or by clicking on the Bitstream configuration file value when Bitstream configuration location equals to File system. This will bring up the refresh menu, asking how to proceed with the configuration's editable parameters that originated from the initial file. The parameters affected by this choice are the ones marked as keep or reset in the table below, in the Common elements update section.
| Keep all modified values | The values of the editable parameters that originated from the initial bitstream configuration file will be unaltered. This will ensure that any user modifications are maintained. |
| Reset all modified values | The values of the editable parameters that originated from the initial bitstream configuration file will be reset to the value found in the new file. All user modifications will be lost |
...
4. The configuration can be reset when Bitstream configuration location equals Standard repositories. To do so, choose the option < Select your file > from the drop-down menu containing the available configurations.
Detecting changes in the bitstream configuration file
...
Only Slot1B slot is considered in common :
- Slot1A : the slot name is the same however the digital in cards in the new and old bitstream configuration files are not compatible (refer to section General Compatibility Rules for Multiple I/O Card Types). When the new bitstream configuration file is applied, the information and configuration of Slot1A will be reset to the values contained in the new .opal.
- Slot1B: the slot name is the same and the analog out cards in the new and old bitstream configuration files are compatible (refer to section General Compatibility Rules for Multiple I/O Card Types). When the new bitstream configuration file is applied, the Slot1B IO card type is reset to the card type in the new file (OP5330-3), however the user configurations applied on the associated common channel groups will be kept.
- Slot2A: only available in the old bitstream and will be removed when the new bitstream configuration file is applied.
- Slot2B: only available in the new bitstream configuration file and will be added to the configuration when the file is applied.
...
- Port 0: kept, but only the first 2 previously configured DWORDS remain, as the new maximum DWORD count has changed to 2.
- Port 1: removed due to not being defined in the new configuration file.
- Port 2: added according to the new file.
Example 3:
Both old and new bitstream configuration files specify support of the MuSE feature; the remote boards configured by the user will be kept when loading the new file.
...
| Common elements | Action | Explanation | |
|---|---|---|---|
Slot configuration | Description | reset | The value of the Description field will be reset to the value in the new bitstream configuration file. |
| Functionality | reset | The Functionality field will be reset to the value in the new bitstream configuration file. | |
| IO card type | reset | The IO card type field will be reset to the value in the new bitstream configuration file. | |
| Analog Inputs | keep | The Analog Inputs channel group configuration (refer to Analog In) is applied to the new configuration. | |
| Analog Outputs | keep | The Analog Outputs channel group configuration (refer to Analog Out) is applied to the new configuration. | |
| Digital Inputs | keep | The Digital Inputs channel group configuration (refer to Digital In) is applied to the new configuration. | |
| Digital Output | keep | The Digital Outputs channel group configuration (refer to Digital Out) is applied to the new configuration. | |
Digital In channel group Threshold low value | keep or reset | If a slot contains a card with support for configurable thresholds (refer to section General Compatibility Rules for Multiple I/O Card Types), the Threshold low value from the old configuration is kept or reset according to the user preferences. | |
Digital In channel group Threshold high value | keep or reset | If a slot contains a card with support for configurable thresholds (refer to section General Compatibility Rules for Multiple I/O Card Types), the Threshold high value from the old configuration is kept or reset according to the user preferences. | |
Bidirectional channel group Direction | keep or reset | If a slot contains a card supporting configurable direction (refer to section General Compatibility Rules for Multiple I/O Card Types), the Direction is kept or reset according to the user preferences. | |
Raw data configuration | If both the old and the new bitstream configuration files define the same raw data from board ports, the configuration done (refer to section Data from Board on these ports is kept. For all common ports, the maximum DWORD count is the lower value among the maximums defined in the two files. | ||
| Raw data to board ports | keep | If both the old and the new bitstream configuration files define the same raw data to board ports, the configuration done (refer to section Data to Board) on these ports is kept. For all common ports, the maximum DWORD count is the lower value among the maximums defined in the two files. | |
| Raw load from board ports | keep | If both the old and the new bitstream configuration files define the same raw load from board ports, the configuration done (refer to section Load from Board) on these ports is kept. For all common ports, the maximum DWORD count is the lower value among the maximums defined in the two files. | |
| Raw load to board ports | keep | If both the old and the new bitstream configuration files define the same raw load to board ports, the configuration done (refer to section Load to Board) on these ports is kept. For all common ports, the maximum DWORD count is the lower value among the maximums defined in the two files. | |
| Remote boards configuration | keep | If the MuSE feature is available in both old and new bitstreams, the remote boards configuration (refer to section Remote Board Configuration) will be kept when loading the new bitstream configuration file. | |
...