### Overview ###

Repo for BaseJump ASIC Motherboards.

See http://bjump.org/basejump_motherboards_socket_352.html


### Dependencies ###

Firmware codes may require following repos:

bsg_ip_cores
bsg_designs
bsg_packaging
bsg_manycore
bsg_rocket


### Organization ###

A sample directory structure for bsg_motherboards is:



    bsg_motherboards
    |
    `-- trouble_series
        |
        |-- common                                # Shared by double, real and super trouble
        |    |
        |    |-- document                         # all docs needed
        |    |    |-- datasheet
        |    |    `-- fpga_ref
        |    |
        |    `-- ip                               # shared ip blocks (similar to current ip dir in bsg_fpga repo)
        |         |                               
        |         |-- bsg_gateway                 # The gateway library
        |         |   |-- bsg_gateway_fmc
        |         |   |-- bsg_gateway_chipscope
        |         |   |-- bsg_gateway_serdes
        |         |   |-- bsg_gateway_tag
        |         |   |-- bsg_gateway_pll
        |         |   |-- bsg_gateway_microblaze
        |         |   `-- ...
        |         |
        |         |-- bsg_ml605                   # The ml605 library
        |         |   |-- bsg_ml605_fmc
        |         |   |-- bsg_ml605_chipscope
        |         |   `-- ...    
        |         |   
        |         `-- bsg_zedboard                # The zedboard library
        |             |-- bsg_zedboard_fmc
        |             |-- bsg_zedboard_rocket
        |             `-- ...            
        |
        |-- double_trouble                        # ASIC emulation platform
        |   `-- (see super_trouble hierachy)
        |
        |-- real_trouble                          # prototyping platform for BSX
        |   `-- (see super_trouble hierachy)
        |
        `-- super_trouble                         # prototyping platform for Celerity
            |
            |-- pcb_development                   # all pcb related file
            |   |-- pcb_design                    # include schematic, layout and library
            |   |-- pcb_fabrication               # include stackup information, CAM files and docs related to fab
            |   `-- pcb_assembly                  # include BOM, component_map and scripts
            |   
            |-- firmware                          # all projects available for this board
            |   |
            |   |-- common                        # codes same among all projects
            |   |   |
            |   |   |-- bsg_gateway               # project-specific files for gateway
            |   |   |   |-- Makefile
            |   |   |   |-- fdc
            |   |   |   |-- tcl
            |   |   |   |-- trace
            |   |   |   |-- ucf
            |   |   |   `-- v
            |   |   |
            |   |   `-- bsg_gateway_no_serdes     # slow but scalable gateway design
            |   |       `-- ...
            |   |
            |   |-- bsg_celerity_rocket_loopback  # ml605 project for Celerity testing
            |   |   |
            |   |   |-- Makefile                  # Makefile for the project, can choose using serdes or not
            |   |   |   
            |   |   `-- bsg_ml605                 # project-specific files for ml605
            |   |       |-- Makefile
            |   |       |-- fdc
            |   |       |-- tcl
            |   |       |-- trace
            |   |       `-- v
            |   |    
            |   |-- bsg_celerity_zedboard         # Normal general project for Celerity testing
            |   |   |
            |   |   |-- Makefile                  # Makefile for the project, can choose using serdes or not
            |   |   |
            |   |   `-- bsg_zedboard              # project-specific files for zedboard
            |   |       |-- Makefile
            |   |       |-- xdc
            |   |       |-- tcl
            |   |       `-- v  
            |   `-- ...
            |
            `-- software                          # all host programs
            |    `-- trouble_master               # host python program to communicate with board via UART
            |
            `-- misc_docs                         # misc docs for supertrouble