Support : Knowledge base

Knowledge Base

Welcome to OPAL-RT’s Knowledge Base

OPAL-RT offers a repository of support information for optimal use of its technology.

Loading…

Please note that OPAL-RT knowledge base is not fully optimized for mobile platforms.

For optimal experience, use a desktop computer.

Reference Number: AA-01516// Views: AA-01516// Created: 2018-07-27 16:39:41// Last Updated: 2022-12-07 07:36:40
HowTo
BlueStorm Serial Card Configuration and Troubleshooting

Overview

This article will present the steps required to configure the optional BlueStorm serial card installed in an OPAL-RT Simulator. Below you will find an explanation of the technical capabilities of this card, as well as the steps required to setup and test the unit. The last section will detail troubleshooting tips for this card.

Note: There are PCIe and PCI models for BlueStrom card, please make sure which type of card is used.

BlueStorm/Express Card Specifications

This card contains 16 hardware switchable serial ports. Using on-board jumpers, you can configure the card to run in RS-232, RS-422 or RS-485. It offers Bi-directional data speeds up to 921.6 Kbps (RS-232) and 1.843 Mbps (RS-422/485) and supports full duplex (4 wire) with RTS/CTS flow control, half duplex (2 wire) with auto TxD echo cancellation and multi-drop (4 wire) modes in RS-422/485. 

As shown in the image below, the card uses two breakout harnesses offering 8 ports each for a total of 16 channels:

(1) Breakout Cable    (2) RS-232/422/485 Port DB9 Connector     (3)  Breakout Panel with 8-Channel Subgroups

BlueStorm PCI Card Specifications

There are four types of BlueStorm PCI cards:  BlueStorm/LP/SP/SP Opto and SP RJ-11.

Depending on the type of the card, the specifications are different.2/4/8 ports models are available, While the specification for each channel is same as the  BlueStorm/Express channel.

Configuring the BlueStorm Hardware

When delivered in an OPAL-RT Simulator, there are no drivers to install as they are already contained in the OPAL-RT Linux distribution. Each BlueStorm card installed will appear as 16 generic serial devices (ttyS0, ttyS1 etc.)

NOTE: If the on-board serial ports located on the motherboard, are activated, the BlueStorm serial ports will take the ID's following these. So, it is important to note which device ID corresponds to which port. Typically, ttyS4 corresponds to Port 1.

To configure the desired protocol, there are jumpers on-board the card which can be set. Each channel is configured independently and can be set to your choice of RS-232/422/485. Please see the image below, which shows some examples of jumper configurations for BlueStorm PCI/Express card:


Jumper Explanations for BlueStorm/Express:

RS-485 Selection: Install this jumper to configure a port for RS-422/485 mode. If the jumper is not installed, the port will function in RS-232 mode. (All jumpers should be removed from any port operating in RS-232 mode.) 

TxD Control: Install this jumper to enable the RS-485 transmitter only when sending data. This mode is useful for half-duplex operation when only one device is allowed to send data at a time. If the jumper is not installed, the transmitter will always drive the line to an idle state when not sending data. 

RxD control: Install this jumper to enable the RS-485 receiver only when NOT transmitting data. This is useful for half-duplex operation to prevent the transmitting device from receiving the data it has sent. If this jumper is not installed, the receiver is always enabled and ready to receive data.

RxD ±Termination/Bias: Install this pair of jumpers to enable a 150 Ohm terminator across the RxD+ and RxD- pins for the corresponding port. A biasing network is also enabled that drives the receiver to an inactive or safe mode. The receiver can still receive data from another device and the biasing helps to prevent the reception of data generated by noise on the transmission line. The two jumpers for RxD termination/bias must be installed and removed as a pair.

Note: The jumper configuration for RS-232/422/485 for PCI types (BlueStorm/LP/SP/SP Opto and SP RJ-11) are different, which can be found in the CTIM_PCI_BlueStorm.pdf. 


Testing the BlueStorm Card

Hardware Setup:

Since RS-232 and RS422/485 have different electrical interfaces, it is important to correctly configure the loopback connection. Below are the corresponding loopback connections for each protocol (for PCI/Express card):

Note: The pin assignment for BlueStorm PCI cards can be also found in CTIM_PCI_BlueStorm.pdfDepending on whether BlueStorm/LP/SP/SP Opto and SP RJ-11 is used, the pin assignment are different.


Using the OPAL-RT Test Model

The recommended procedure for testing the card is to use the included I/O test model delivered on the customer CD. Normally it is a standard loopback connection test, which will transmit a shifting constant and receive the value on a data display. This is typically the fastest way to test all channels. When using this model, ensure that the OpSerialAsyncCtrl block is correctly configured:



Using a Third-Party Serial Client

If you decide to test the serial connection via a third-party SSH client, such as MiniCom, it is also important to correctly set the bus parameters. Below, an example of the correct configuration for Minicom:

NOTE: It is important that Hardware Flow Control and Software Flow Control both are set to OFF, as no messages will appear if these are left enabled.

By configuring two instances of MiniCom on two separate channels, you can then use a transmission cable to allow both ports to communicate. It is important to use the proper cable, as the pin-outs vary between protocols.


Troubleshooting

Problem: When I connect the loopback and load/execute the model, I don't see any signals appearing,

Solution: First , ensure you have connected the loop-back on the correct port and that you are using the right wiring for the chosen protocol. If you are using the OPAL-RT Test Model, make sure that the serial communications block is properly configured to use the correct port id (ttyS4 etc.) If you are using a Third-Party serial client, ensure that Hardware Flow Control is disabled. Lastly, make sure the jumpers on the BlueStorm card are set for the correct protocol.


Problem: Using a third-party serial client, I see messages appearing but they are scrambled.

Solution: Make sure that the cable you are using is in good condition. A damaged cable will cause transmission errors and produce undesirable results.

 

CTIM_PCI_BlueStorm.pdf 1.3 Mb 1.3 Mb