[misc.handicap] CBFB_REVIEWS diskdriv.txt

robertj@tekgen.bv.tek.com (Robert Jaquiss) (05/13/91)

Index Number: 15531

       ACCESS PC DISKS FROM YOUR VERSABRAILLE II or CLASSIC

                         By David Goldstein

     (Copyright 1991 by VersaNews.  VersaNews is a magazine for
users of the VersaBraille, Navigator and other paperless braille
devices.  It is available on PC disk, VersaBraille II disk,
Versabraille tape (not audio) and print.  For more information,
contact David Goldstein, Editor, 87 Sanford Lane, Stamford, CT
06905.)

     VersaBraille users now have a way to exchange files with IBM
PC users, thanks to a new all-purpose disk drive from Blazie
Engineering.  Designed principally for the Braille 'n Speak, this
little box, measuring 5-1/2 by 8-1/2 by 2 inches and costing $495,
can connect to a VersaBraille or any device that has a standard
serial port, and will serve as a disk storage and retrieval system
for that device.  The disks used are the VersaBraille-sized
3-1/2-inch floppies, but in the standard format used on IBM PC's
equipped with this sized drive.  Disks made on the
battery-operated drive may be read on a PC, and PC disks may be
read on the drive and transferred to the VersaBraille.  The disks
can be either low density, 720K, or the high density 1.2 Meg.  The
drive cannot read Apple PRODOS disks.

     For the VersaBraille user who does not have a computer, the
Blazie disk drive eliminates the need to transfer files by cabling
the VersaBraille to a computer or by using Cornucopia Software's
IBM-VBII program.  It can be used to read PC disks
from Computerized books for the Blind, avoiding the need
to have books converted into VersaBraille II format.

     It is important to understand the disk drive's limitations.
It does not replace the disk drive in the VersaBraille II.  The
drive is connected to the serial port, so that information must be
sent or received from it as with a serial printer or modem.  Even
at 9600 BAUD, transfers are slow.  If you use it to read a long PC
file, you will be subject to the same constraints as with long
VersaBraille files.  The drive cannot read information from
compressed files.  You will be able to read the straight ASCII
files generated by Computerized Books for the Blind and download
them to your VersaBraille, but you will not be able to read the
compressed files in which the dictionary and catalogs are normally
packaged for PC users.  CBFB has always shown a willingness to
accommodate users' needs, and I have no doubt that arrangements
could be worked out to receive most, if not all, of the files in
uncompressed form.  It should also be made clear that you cannot
use this drive to run programs written for the PC.  If you were
hoping to use it to run WordPerfect on your VersaBraille, you will
be disappointed.  In fact, you cannot read files generated by
WordPerfect unless they have been saved in an ASCII "nondocument"
mode.

     This article provides instructions on how to use the drive
with the VersaBraille II and VersaBraille Classic.  It can also be
read as a product review.  I wish to thank Blazie Engineering for
the loan of the device to VersaNews for the purpose of writing
this article.

Hooking Up

     The back of the disk drive contains the power switch and
connectors for the power supply/battery charger and the interface
cable which connects to the VersaBraille.

     With regard to the power supply (which is identical to that
used by Braille 'n Speak), it is recommended that you use the disk
drive plugged in as much as possible.  The batteries are supposed
to last 5 to 10 hours, but you don't want to be caught in a
situation where there is not enough power to save your files to
disk.  With the December update, the drive will start beeping
continuously when the batteries are becoming dangerously low.  The
drive will also beep if left turned on for 5 minutes without being
used.  As with many battery-operated devices, the drive gets its
power through the battery even when it is charging.  If the
batteries are low or you have not used the drive in a long time,
it is best to let it charge for a while before using it plugged
in.  A full charge takes 8 hours.

     Cabling.  Be sure, when unpacking the unit, that you have the
right cable.  There is a short cable specifically for the Braille
'n Speak's auxiliary port, but there should also be another much
longer one for connecting to other devices.  This has a 15-pin
male connector to plug into the drive, and a 25-pin female
connector on the other end.

     Note that the disk drive will not turn on unless the cable is
plugged into it.  This is a safety feature to prevent the power
from being turned on in transit.  Be sure to plug in the cable
securely.  You may wish to tighten the screws on the connector to
make sure that a slight pull on the cable dosn't turn the disk
drive off in mid operation.

     The 25-pin end of the cable will plug directly into the male
connector at the end of the VersaBraille II cable.  The disk drive
is a "DCE" device, meaning that it connects up to things as a
modem would.  If you have a VersaBraille II Plus, you should plug
the VersaBraille cable into the port closest to the on/off switch.
On the VersaBraille II, use the connector next to the disk port.
The Classic requires no null modem adapter.  If your Classic has a
cable ending in a male, you can connect the disk drive cable
directly.  If your Classic cable ends with a female connector, you
will need a straight-through, male-to-male adapter to go between
the two cables.

Parameters

     The disk drive requires 9600 BAUD, 8 data bits, no parity and
one stop bit.  Deane Blazie recommends software handshaking.

     VersaBraille II.  We begin, as other writers do, with the
assumption that the machine has been set to its original defaults.
This is achieved by a full reset--holding down dots 1-2-3 while
turning on the power.  From that point, only a few parameters need
to be changed.  In the s: serial menu, set:
p: parity none (The default parity setting of "ignor" on the model
L1D seems to work just as well.)
i: dc in y
o: dc out y.
You may also wish to set d: duplex to Half so that you can see
what you are typing.
In the c: com mode menu you should set the C carriage return, and
A, ASCII parameters for whether you want to be able to see
carriage returns or control characters in the output.

     VB Classic.  With the VersaBraille Classic, it is suggested
you load the terminal overlay and set the CCP's as follows.  Only
the parameters pertaining to the disk drive are given here:
b 9600; d 8; p n; s 1; t c; ci y or space; et fs; dx h; hs dc3; ai
n; co cr; ak n; dci y; cts n; cd n.
Put the machine in remote mode with an r-chord r and use this mode
to send the disk drive commands discussed below.  You can read
short files in this mode and use x-chord s when the buffer fills.
For longer files, use the automatic transfer functions r-chord t
to save a disk file to tape, and r-chord i to transfer a tape
chapter to disk.

Operating the Drive from a VBII

     There is one more parameter you need to set if you wish to
hold two-way communication with the disk drive.  You must go to
the c: com mode parameter and set v: vb emulate to On.  This sets
up the VersaBraille for an interactive or terminal mode, permits
you to send commands to an external device and see messages from
that device on your display.  To get into this mode itself, you
must go to the main menu, and type f for files, p for print, i for
serial.in, and press Execute.  If you have done it correctly, you
will see the cursor on the first cell of the display.  If the
message "destroys ram fls" appears, push Execute again.

     Now you can talk to your disk drive.  You won't find it much
of conversationalist.  Unlike a computer, it does not give you
prompts to tell you that it's ready for the next command.  It will
give a doorbell sound and send an "at" sign @ when you turn the
power on.  It will also beep upon completing a command.  You will
see a control-z after each operation if you have turned on the
ASCII parameter.  Braille 'n Speak is programmed to speak error
messages in regular English.  When using other devices, errors are
noted with a terse single character.  If the command you send does
not exist, it returns ?.  If it cannot find a file, it says #.  If
you try to "kill" all files at once, which it considers
illegal--not to mention immoral, it sends an emphatic ".  A
complete chart of error messages will be found at the end of this
article.

     Commands are entered by preceding them with a control-e.
(This is the equivalent of an s chord from the Braille 'n Speak's
disk menu.) On the VersaBraille, you would enter a command by
typing a dots 4-5-chord and the letter e, and then the letter of
the command.  Do not space between the control-e and the command.
For example, control-e followed by the letter f will format the
disk.  Most commands require more information after them, and the
sequence must end with a carriage return (control-m) before
something happens.  Format does not require a return and starts
immediately and irrevocably.  Beware! By the way, the drive
determines whether a disk should be formatted for high or low
density by looking for the extra hole found on high density disks.

     An example of a command that requires a carriage return is
the Directory command, d, which gives you a listing of files on
the disk.  If you type control-e d, carriage return, you will see
all the files.  If you type ctrl-ed*.brl <return>, you will get a
list of just the files with the .brl extension.  The directory
always concludes by displaying the date of the drive's firmware.

     It is a good idea to test things out before getting to work
with the disk drive.  The easiest way to do this is by asking it
for a directory of the disk.  If you receive the directory on your
display, you know that communication is working.

     I have found that the disk drive and VersaBraille often lock
up when they are connected together.  If you type on the VB and
get no response, try one or all of the following: (1) type a
control-q; (2) unplug the interface cable from the VersaBraille;
(3) turn the drive's power switch off and on; (4) exit and and
return to terminal mode with an r chord and Execute.  I suspect
this lockup problem is caused by the drive's sending control
characters to the VersaBraille.  Experiments with hardware
handshaking did not improve matters.

     Command List.  The disk drive recognizes the following
commands.  All of these must be preceded by a control-e.
l load a file
s save a file
d directory
k "kill" or delete a file; k*.* is illegal.
f format
m make a new subdirectory
x delete a subdirectory (the directory must be empty of all files
before it can be deleted.)

Transferring Files from the PC Disk to the VersaBraille

     Let's say you have a PC disk with text files.  You want to
know what files it contains and then will put one of those files
on a VersaBraille disk so you can read it later.

     1.  Get into terminal mode by turning the VB-Emulate
parameter on and typing f, p, i and Execute from the main menu.

     2.  Turn on the disk drive.

     3.  Do a directory, control-e d followed by a carriage
return.

     4.  You now want to "load" a file from the disk.  Type
control-e l and the name of the file without spaces between the
control-e or the filename.  Do not type carriage return yet.  If
you type a return, the file will be sent to your VersaBraille
display and stored in RAM as versabrl.sav.  Those of you who have
used the VersaBraille as a terminal know that files of only about
10 K can be stored this way, and the result is not always
reliable.  You can certainly read short files this way if you want
to see what is on them, but you are much better off storing the
files to disk.

     5.  After you have entered the complete command sequence with
the exception of the carriage return, do an r-chord to get out of
terminal mode.  Return to the VersaBraille's main menu, and go
from there to the Parameters menu.  Shut VB-Emulate off.

     6.  Return to the serial.in state by typing f, p, i and
Execute.  With VB-Emulate off, the VersaBraille will display,
"enter filename." Enter the name that you would like this file to
be stored as, and select the drive number.

     7.  The VersaBraille will then prompt, "send command?" Type
Execute for yes.  You have entered most of the command, but you
still have to add the finishing carriage return.  Type a return,
and another Execute to get things started.

     8.  If things are working correctly, you will hear the disk
drive start up and the VersaBraille begin beeping after every 512
characters have been sent.  Because the disk drive sends a
control-z at the completion of each command, the completed file
will be saved to your VersaBraille disk automatically without your
needing to send a z chord.  If the VersaBraille just beeps once
and nothing happens afterwards, you probably made a mistake and
will need to get out by typing a z-chord and starting the
procedure over.

Transferring a VersaBraille File to the PC Disk

     1.  Get into terminal mode and do a directory to make sure
things are working and that there is room on the disk for a new
file.

     2.  You are going to "save" a file to disk, so type control-e
s and the name of the file without any spaces between the
control-e, the command and the filename.  Type carriage return.
This will put the drive in a waiting mode, and it will receive all
characters sent to it until the file is closed.

     3.  Do an r chord to leave serial.in mode and select s
prints.

     4.  Now go through the usual procedure for printing.  You
will have to decide whether you want the file to be formatted.
Remember that the reason you are transferring the file to PC disk
is so that it can be read by people who have standard equipment.
You will therefore need carriage returns in the file, and you
won't want any dollar-sign commands known only to VersaBraille and
Navigator.  So if your file has these symbols and is without
carriage returns, say Yes to the formatting question.  If it is
already set up for computer transfer and has carriage returns,
then the answer would be No. (One case where you might not want to
format a file containing VersaBraille symbols is if you plan to
use the disk on Navigator in its VBPC mode.)

     5.  As you continue through the printing procedure, you will
eventually be asked whether you want to pause between pages.  You
do not, so press any key except Execute.  When the file finishes
printing, the message "done" will appear.

     6.  You still need to tell the disk drive to close the file.
Return to terminal mode and type control z.

Subdirectories.

     Disks produced on PC's often have files in subdirectories,
and you can only see these files if you access the proper
subdirectory.  The disk drive accepts the PC's backslash command.
(On the VersaBraille this is entered by writing dots 1-2-5-6
preceded by a k chord for uppercase.)  You can load, save, or get
a directory of the files in a subdirectory by following a command
with the subdirectory name.  For example, if you were using this
disk drive to read an uncompressed version of the PC edition of
the CBFB magazine and wished to locate the announcement from
Blazie Engineering, you could type a control-e and l, followed
without a space by \magazine\announce\blazie.txt.

     Unfortunately, if you don't know ahead of time the
names of the subdirectories on
the disk, there is no way to find out.  Displaying the root
directory does not list subdirectory names, and there is no
equivalent of the MS-DOS TREE command to get a path listing.

Error Messages

     Here are all the error codes you might see the disk drive
send.
# file not found
! write protected disk
& format, CRC, or sector failure
% insufficient disk space
" illegal, sent when you try to kill *.*
$ no disk in drive
+ subdirectory already exists
- subdirectory does not exist
/ subdirectory not empty.

Conclusions.

     This disk drive could be a godsend to those who do not have a
PC and need to exchange text files with coworkers.  At $495 it is
rather expensive, but it is less costly and requires far less
learning than a computer.  With the firmware I have, dated
December 1990, there still seem to be problems with absolutely
perfect compatibility.  I was not able to read certain disks
generated by a computer, and other people have reported their
computers not being able to read all disks generated on the drive.
My unit was often inconsistent.  A disk it could not read one time
would be read flawlessly on another occasion.  In terms of
compatibility with the VersaBraille, the two devices worked well
together, except for the lockup problem I mentioned.  I
experienced an occasional loss of a few characters during
handshaking with the VersaBraille II; handshaking worked perfectly
with the Classic.  The inability to find out what subdirectories
are on a disk could be a major inconvenience if the user does not
have access to a computer.

     As always, Deane Blazie welcomes and acts upon user feedback.
The disk drive as it stands now is an excellent product.  I am
confident it will get even better with each update.

     For more information, contact Blazie Engineering at 3660 Mill
Green Road, Street, MD 21154; (301) 879-4944.