THE BRLSTATX-HOWTO
==================

	By Osvaldo La Rosa - <http://brlstatx.brlspeak.net>

	Last updated: 10-11-2002

This document is a Quick Guide. It will tell how to use your brlstatx disk or
binary with a specific distribution / situation.

	For example:

#1. BrlStatX and Debian Woody installation 

For installing a Debian Woody while having braille support:
- put the 1st Debian CD in the CD-drive, let it boot-up
- after +/- ten secs, do:
  'enter'
  then alt+f2 to open a new console and 'enter'
- you should now mount the fd0 with: mount -t vfat /dev/fd0 /floppy
  or with: mount /dev/fd0 /floppy
  or try: mkdir brl then mount /dev/fd0 brl
- do now: cp /floppy/brltty . or cp brl/brltty .
- and now: ./brltty
- please wait ... until you hear a "bleep" and feel some braille under your
  fingers
- do now: umount /floppy or umount brl
- type now: dbootstrap
- proceed with the installation.

   NOTICE: Dbootstrap, The Way to the Light!
           submitted by Yannick Plassiard 

   The new Woody installation system has changed from the Potato
   distribution: in fact, the Debian Installer uses now a frame-buffer
   (graphical) device to print installation instructions, and this device is
   not accessible by BrlTty. So, we must do something to resolve
   that problem. We have two choices:
   - booting from the Debian Woody CD-Rom,
   - or making boot floppies.

    In the first situation, when we boot from the Debian CD, a frame-buffer
   is automatically opened by the kernel and the installation system is runned
   into the first console in "frame-buffered" mode i.e. in pseudo-graphical
   mode. At this point, that's why we must switch to the second shell, launch
   our statically compiled BrlTty, and then type:
    # dbootstrap
   This will run the installation system in another console which is not
   graphical and, consequently, will allow us to install our new Debian
   System.

    The second situation uses a kernel which doesn't use framebuffer.
   Have a look at files located at:
   ftp://ftp.debian.org/debian/dists/stable/main/disks-i386/images-1.44

   Once you have made your couple of boot and root floppies, you can boot the
   installation system, switch to the second console, launch BrlTty, and
   switch back to the first console to have the Debian installer accessible.
   You don't have to run dbootstrap anymore because the first dbootstrap, on
   the first console is not frame-buffered and so, accesible for us.

xxx

#2. BrlStatX and USB support 

Important option available in the Linux 2.4.19 kernel:

 Tieman Voyager USB Braille display support (EXPERIMENTAL)

If you are using a Voyager, then you will set this option "on" to be able
to use BrlTty with it.