Files

===========================
=   BitfileHeaderEdit     =
=    Version 0.1          =
===========================
Author: v.van.beveren@nikhef.nl


This is a simple Java application to edit the header of a bit-file. The actual bit-file
is packed in a meta-format. This application allows editing of the fields of the meta-format.

bhe <commands>...
  where command may be:
    help                        - Show this help
    load <filename>             - load a bit-file
    save <filename>             - load the bit-file
    list                        - list field in the loaded bit-file
    show <field>                - show the value of a specific field
    set <field> <value>         - set the specified field to the provided value:
      * if the field is binary a hex-encoded string is expected
      * if the field is text a character string is expected
    upd <field> <key> <value>   - update a semicolumn separated text-string

Note that the actual information edited by this application is not used by the FPGA it self,
but is used by Xilinx tools, such as Impact. 

Examples  (newlines and comments should not be in the actual invocation)
========================================================================

Listing all fields van values in the bit-file header
----------------------------------------------------
   bhe load testfiles/fpga2.bit	
       list

	   
Modifying the userID in 0xAABBCCDD
----------------------------------
   bhe load testfiles/fpga1.bit	
       upd user UserID 0xAABBCCDD
	   show user							# shows the new user ID
       save output.bit
   
Adding a firmware version to the user-field
-------------------------------------------
   bhe load testfiles/fpga1.bit	
       upd user FirmwareVersion 0.9			# will append FirmwareVersion=0.9 to the user field
       save output.bit

Changing the bit-file version to 2 (will prevent loading in Impact)
-------------------------------------------------------------------
   bhe load testfiles/fpga1.bit	
       set version 02
       save output.bit