Solaris 10 Driver Installation Guide

Introduction

The driver was designed for the following product families:
·  All BlueStorm PCI based products
·  All BlueStorm PCI/Express based products
·  All Xtreme/104-plus products

Obtaining Driver

  • Download the install file from the Product Page
  • gunzip the install

Installing the Driver

  • # pkgadd pkgadd -d ./<package>
  • Follow instructions
  • Once the installation is done, a message appears indicating whether or not the installation was successful

Uninstalling the Driver

  • # pkgrm CTI-bli
  • Type y when asked if you want to remove this package
  • Once the uninstall is done, a message appears indicating whether or not the uninstallation was successful

BlueStorm/Xtreme Serial Devices

The devices are created as /dev/ttyblXX, /dev/term/blXX and /dev/cua/blXX. The ttyblXX devices are links to the term/blXX devices. XX is the port number, which corresponds to the minor number of the device.

Make sure the following lines are present in /etc/uucp/Devices

Direct /dev/ttyblxx – Any direct

Direct cua/blxx – Any direct

Solaris goes to a great deal of trouble to keep the users’ view of the hardware consistent. So much so that Solaris tracks the slot a PCI card is plugged into. If you make even the slightest change to your hardware setup, even just moving the BlueStorm/Xreme card to a different PCI slot, you may have to perform an extra step to get the devices to be created properly.

One way is to perform a reconfigure reboot while making the hardware change. There are two ways this can be accomplished:

Method 1:
# touch /reconfigure
# reboot

Method 2:
# reboot
Select (b)oot or (i)nterpreter: b -r

Another way is to reload the driver with the supplied utility bl_reload (look in /opt/CTI-bli):
# ./bl_reload

A reconfigure reboot may leave extra unused devices in /dev. We recommend using the reload utility as it ensures only the correct devices are created.

After this you may find that the device numbers have moved. What was ttybl00 might now be ttybl08 for example. This is a side-effect of Solaris’ hardware tracking and can’t be avoided.

Configuration File

Changes to the driver configuration file /kernel/drv/bl.conf won’t be picked up until a reboot or a driver reload. Use the provided script bl_reload to perform a reload of the driver. This will interrupt any prorgams or users using BlueStorm/Xtreme ports.
bl.conf contains documentation on the various flags that can be set.

RS485 Modes

The BlueStorm/Xtreme includes support for Full Duplex, Half Duplex and Multi-Drop Slave modes. Connect Tech provides the “set485” utility to enable and disable these modes.
The default mode is Full Duplex, so you will only need to invoke the set485 command if you need to run in Half Duplex or Multi-Drop Slave modes (look in /opt/CTI-bli).

Testing the Newly Installed Ports

You can use the utility ‘cu’ to test the installed ports.
# cu -l cua/blxx

This will ‘connect’ with the port and allow you to send and receive data.
Utilities like stty will allow you change other serial parameters (baud rate, parity, flow control, etc..) for testing.

Go to Top