- HEX2BITS -

USAGE:
HEX2BITS [-k] <hexadecimal file> <output file name>

'HEX2BITS' translates a file of hexadecimal characters into ascii '1's
and '0's. It is primarily designed to operate on a hexadecimal PROM file
that has first been stripped of its PROM formatting by the 'STRIPHEX' program.
If the original PROM file was for an LCA bitstream, the 'HEX2BITS' version
of the 'stripped' PROM file will be an ascii '1's and '0's representation
of the LCA binary bitstream.

In it's default mode, 'HEX2BITS' will 'bit-swap' each byte of
hexadecimal data (ie. bit 7 of a byte becomes bit 0, bit 6 becomes bit 1).
It does this in order to restore the original order of the bitstream, since
it was 'bit-swapped' by the MAKEPROM program before being placed in
the PROM file. The 'bit-swapping' process is done to accommodate the
PROM-to-LCA loading process.

The '-k' option inhibits the 'bit-swapping', and keeps the ascii bits
in the same order as they appear in the hexadecimal file.

SAMPLE
------

This Intel MCS-86 Hexadecimal PROM-formatted file....

---------------------------------------------------------
| :020000020000FC |
| :10000000FF04400FFBEEFFFFFFFFFFFFFFFFB7FD09 |
| :10001000FDFBFFFBF7F7FFBFFFF7EDFFEFDFFFFF94 |
| :10002000FFFDFFFDFFFFFFFFFFFFEFFFFDFBFBFB02 |
| ......... |
| :1005D000F9F3FBF3E7E6F6DFFFFDFFFFFF7F777739 |
| :0205E000FFFF1B |
| :00000001FF |
---------------------------------------------------------

submitted to 'STRIPHEX', produces the following file...

-----------------------------------------
| FF04400FFBEEFFFFFFFFFFFFFFFFB7FD |
| FDFBFFFBF7F7FFBFFFF7EDFFEFDFFFFF |
| FFFDFFFDFFFFFFFFFFFFEFFFFDFBFBFB |
| ..... |
| F9F3FBF3E7E6F6DFFFFDFFFFFF7F7777 |
| FFFF |
-----------------------------------------


When the stripped file above is submitted to 'HEX2BITS',
the following file is produced....

-------------------------------------------------------------------------------
| Produced by Xilinx HEX2BITS version 0.02 |
| File dice.bits |
| Wed Aug 17 14:41:13 1988 |
| 1111111100100000000000101111000011011111 |
| 011101111111111111111111111111111111111111111111111111111111111111111111111 |
| 011011011111110111111110111111111111111011111111011111110111111111111111111 |
| 011111111111101111101101111111111111110111111110111111111111111111111111111 |
| ... |
| 001111110111111001111111001111110111111100111111100111011001110110111111111 |
| 011111111111011111111111111111111111111111111111110111011101110111011111111 |
| 11111111 |
-------------------------------------------------------------------------------
DISCLAIMER
==========

XILINX IS PROVIDING THIS SOFTWARE TO USERS OF XILINX PRODUCTS SOLELY FOR
USE IN SUPPORT OF THOSE PRODUCTS. XILINX DOES NOT ASSUME ANY LIABILITY
ARISING OUT OF THE APPLICATION OR USE OF THIS SOFTWARE OR FOR ANY ERRORS
OR DEFECTS THAT MAY EXIST IN THIS SOFTWARE. XILINX EXPRESSLY DISCLAIMS ANY
WARRANTY, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE.