Products supported for this script

The script is intended for use with all Brainboxes UC, CC-525/530 and PX-275/279, PX-263/295, PX-272/306 products

 

Features

  • The script automatically adds and edits the necessary files for your Linux system to install your Brainboxes UC/PX card
  • It automatically detects problems that may occur and instruct you on what you need to do to fix it
  • It will make backup files of the anything it changes
  • Fully tested with Debian 8.3
  • A configuration file where the user can edit the parameters which will tell the script to point towards the correct files necessary for the installation

 

When is it used?

The user will need to run the script any time the PCI/PCIe card(s) or motherboard LPT ports are changed

 

What does it do?

The script uses lspci to find Brainboxes cards and the I/O addresses of their serial and LPT ports. It will first change the /etc/init.d/boot.local (or equivalent) to add calls to setserial which will install each of the Brainboxes serial ports found. It then uses modprobe to load the ppdev and lp modules for LPT port support

The script also changes /etc/modprobe.conf.local or /etc/modprobe.d/parport_pc.conf to add an ‘options parport_pc’ line with the configuration of all the LPT ports, for both the motherboard and your Brainboxes device

 

Steps on running the script

  1. Power down the PC and plug in your Brainboxes PCI/PCIe card
  2. Power up your PC and go into the BIOS settings
  3. In the BIOS settings, you will need to find the addresses and IRQs of any motherboards LPT ports you wish to be available, and make a note of them
  4. Boot up Linux, download the script from the link above and unzip the file
  5. From this file, you will need to copy the “bbportinst.conf” to the /etc/ directory (as superuser)
  6. Edit the settings in /etc/bbportinst.conf and add the address & IRQs of the LPT port you took note of from the BIOS
  7. Now run the script by entering ‘sudo perl bbportinst’

 

It says I need something else, what do I do?

The script is made to detect and identify problems during the process of installing the Brainboxes PCI/PCIe drivers. Below is a list of problems that may occur during the installation and how to solve the problem:

 

It doesn’t find ‘setserial’?

If setserial is not installed, you will need to install it using your system’s package management system. For example, on Debian-based systems you can run ‘apt-get install setserial’.

After it has finished, you simply need to run the script again by running ‘sudo perl bbportinst’

 

I haven’t got enough devnodes for the serial ports?

Normally by default on a Linux based system, the default number of devnodes is 0-3. Some of Brainboxes products require more devnodes to use all the ports. When you run the script for the first time, it will detect how many devnodes you will need to have access to all of the Brainboxes PCI/PCIe ports. Below are steps on how to add more devnodes:

Debian

  1. Open up ‘/etc/default/grub’ for editing
  2. Inside, edit the line to match the parameters below
    GRUB_CMDLINE_LINUX_DEFAULT=”quiet8250.nr_uarts=20
  3. Save the changes
  4. Apply the new changes by running ‘update-grub’
  5. Reboot your PC
  6. Run the script again ‘sudo perl bbportinst’

SLE 11

  1. Open up ‘/boot/grub/menu.lst’ for editing
  2. You will need to add or adjust the “8250.nr_uarts” kernel boot option:
    kernel /vmlinux-2.6.18-194.el5 ro root=/dev/VolGroup00/LogVol00 rhgb quiet 8250.nr_uarts=20
  3. Save the changes and reboot your PC
  4. Run the script again with ‘sudo perl bbportinst’

 

I’m still getting an error but I don’t know what it is?

If you’re still having issues installing your Brainboxes PCI/PCIe card, then you can get additional help from the Brainboxes support team at support@brainboxes.com



This FAQ Applies to the following Brainboxes Product Ranges: