Skip to content

Expand bootstrap README and add test for /opt/Xilinx/14.7/ISE_DS/settings64.sh #85

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Oct 3, 2015
Merged

Expand bootstrap README and add test for /opt/Xilinx/14.7/ISE_DS/settings64.sh #85

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
b36f8ff
Expand on instructions and a few fixes to scripts/README.md on bootst…
sealne Oct 3, 2015
3b17043
Add test to see if /opt/Xilinx/14.7/ISE_DS/settings64.sh has been run…
sealne Oct 3, 2015
2dc1a10
Remove make lm32-firmware step as won't be needed shortly
sealne Oct 3, 2015
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 17 additions & 11 deletions scripts/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Building HDMI2USB-misoc-firmware

These scripts are designed to bootstrap a firmware build environment on Ubuntu 14.04 LTS.
These scripts are designed to bootstrap a firmware build environment on Ubuntu 14.04 LTS and also works on 15.04 though with less testing.

Instructions:
## Prerequisite

1. Install Xilinx ISE WebPACK 14.7 + activate a licence:
Install Xilinx ISE WebPACK 14.7 + activate a licence:

* Download from [http://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/design-tools.html]
* Install into the default location in /opt (requires X11 GUI):
Expand All @@ -25,18 +25,24 @@ Instructions:
```
Go to About > Licence, ensure under "information" you can see your ISE WebPACK licence.

2. Run the bootstrap script to build an environment required for flashing firmware:
## Bootstrap

Run the bootstrap script to build an environment required for flashing firmware:
```
curl -fsS https://raw.githubusercontent.com/timvideos/HDMI2USB-misoc-firmware/master/scripts/bootstrap.sh | bash
```

3. Initalise the environment (required for any of the build/load steps below[2]):
This clones the HDMI2USB-misoc-firmware repository, adds the timvideos fpga-support PPA, installs packages required then downloads misoc and its dependencies. Depending on your connection speed this could take a while to download.

## Building the firmware

1. Initalise the environment (required for any of the build/load steps below[2]):
```
cd ~/HDMI2USB-misoc-firmware
cd HDMI2USB-misoc-firmware
source scripts/setup-env.sh
```

4. Build the gateware:
2. Build the gateware:
```
make gateware
```
Expand All @@ -50,7 +56,7 @@ Instructions:

The built gateware will be in build/misoc/build/.

5. You've now built the HDMI2USB firmware/gateware. Ensure board has the right pins set before flashing anything, and plug it in:
3. You've now built the HDMI2USB firmware/gateware. Ensure board has the right pins set before flashing anything, and plug it in:

As the HDMI2USB firmware manipulates the EDID information the following jumpers must be removed;

Expand All @@ -62,19 +68,19 @@ Instructions:
* Plug board in using USB PROG port & switch on. If using a VM, ensure the device is passed through.
* Other USB port is for the HDMI2USB capture. Recommend plugging this in too so you can use/test the device.

6. Flash the gateware and firmware - see [1] if using a VM:
4. Flash the gateware and firmware - see [1] if using a VM:

```
PROG=fpgalink make load-gateware
```
(may need to run several times)

7. Load fx2 firmware to enable USB capture:
5. Load fx2 firmware to enable USB capture:
```
make load-fx2-firmware
```

8. Connect to lm32 softcore to send direct commands to the HDMI2USB such as changing resolution:
6. Connect to lm32 softcore to send direct commands to the HDMI2USB such as changing resolution:
```
make connect-lm32
```
Expand Down
6 changes: 6 additions & 0 deletions scripts/setup-env.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,12 @@ if [ ! -z $HDMI2USB_ENV ]; then
return
fi

if [ ! -z $SETTINGS_FILE ]; then
echo "You appear to have sourced the Xilinx ISE settings, these are incompatible with building."
echo "Please exit this terminal and run again from a clean shell."
return
fi

echo " This script is: $SETUP_SRC"
echo " Firmware directory: $TOP_DIR"
echo " Build directory is: $BUILD_DIR"
Expand Down