The logic on the CoCoVGA main board is mostly contained within the larger surface-mounted FPGA. FPGA stands for Field Programmable Gate Array. This means that in the field (such as in your home or office), you may upgrade the configuration of the hardware logic gates within the FPGA chip using a hardware release provided via this web site. This programming/configuration is performed serially by way of a protocol defined by and therefore known as JTAG (Joint Test Action Group).
From time-to-time, new CoCoVGA FPGA hardware releases may be made to fix bugs or provide feature enhancements. These can be used either temporarily (by programming the CoCoVGA FPGA directly) or permanently, by updating the flash memory on the CoCoVGA main board.
You will need:
- an Altera Byte Blaster USB cable
- Quartus Prime Pro Edition Programmer and Tools software for your PC (more details in step 2, below)
- an FPGA image from the Downloads page, either:
- .sof file for temporary updates - OR -
- .jic file for permanent updates
Pictured below is one example of an Altera Byte Blaster USB cable:
If you happen to have one with a circuit-board style adapter, instead, use these pictures to help you orient the adapter and USB Blaster correctly:
- If you have not already installed your CoCoVGA main board in your computer, please do so. See Installation for more information.
- If you do not already have it installed, download and install the Quartus Prime Pro Edition Programmer and Tools provided on Intel/Altera's web site. It may be necessary to sign up for a free account. From the link, select the Additional Software tab, then under Stand-Alone Software, check only Quartus Prime Pro Edition Programmer and Tools and click Download Selected Files. (At this time, only the Windows version of the Quartus Prime Programmer has been heavily tested. Some users have been able to use the Linux version of the Quartus Prime Programmer if permissions are set properly. Additional guidance on using Quartus with Linux can be found here: https://wiki.archlinux.org/index.php/Altera_Design_Software.)
- Turn off your computer which has CoCoVGA installed in it and disconnect disk drives, IDE/SDC/MMC/flash and other data storage peripherals.
- Plug in your Altera Byte Blaster USB cable, first to an available USB port on your computer, and then to the small JTAG header connector on your CoCoVGA main board (labeled "JTAG").
- Turn on the computer which has CoCoVGA installed in it.
- Start up the Quartus Prime Programmer Pro Edition.
- Click "Hardware Setup..." and select the USB Blaster plugged into one of your USB ports. Close this pop-up. If your computer is unable to recognize the USB Blaster it may not show up in the list, in which case, please see Troubleshooting, below.
- If you have an AMC2 board, then skip to step 11, otherwise, continue with step 9.
- (Only for F1, AMC3, KMC1, T1) Click the "Auto Detect" button. The programmer will ask you to select a device. Click the radio button by EP4CE6 and then OK. A window may pop up saying that "The auto-detected device chain does not match the Programmer's device list." Click Yes.
- (Only for F1, AMC3, KMC1, T1) Left click once on the "UNKNOWN_29604093" device and then right click once on the same device, select Edit > Change Device... Scroll to the bottom of the "Device family" list and click "User Defined". (In the "Device name" list, if "XC9572XL-VQ64" is not listed, click New... and enter this name into the "Device Name:" blank. If a mask is required, the default is ok. Then click OK.) In the "Device name" list, click the checkbox next to "XC9572XL-VQ64" and then OK. (Note: older versions of Quartus may allow you to ignore this device, in which case, please use that feature.)
- Left click once on the "EP4CE6E22" device and then the "Change File..." button from the left (or alternatively, right click on the "EP4CE6E22" device and select Edit > Change File). Select the .sof or .jic file you would like to program. For a .sof file, ensure that Program/Configure is checked for only the EP4CE6E22 (which should be the first and perhaps only device in the list). For a .jic file, ensure that Program/Configure is checked for the EPCS4 or EPCS16 device (this will also check the EP4CE6, which is ok). Verify and Blank-Check are optional, but should also only be applied to the EP4CE6E22 or EPCS4 or EPCS16 device.
- Click Start to begin programming.
- See below for next steps - generally, a temporary .sof causes automatic FPGA reconfiguration whereas a .jic is permanent and requires power cycling your CoCo or Dragon system upon completion of the programming step.
If programming a temporary .sof, the "Progress:" bar should reach "100% (Successful)" and then CoCoVGA should reconfigure itself and you should see the appropriate version number in the banner. This configuration will stay present and active within the FPGA until you either reboot your CoCo or Dragon or press the "RECONFIG" button on the CoCoVGA main board.
AMC3, F1, KMC1, T1 example:
If programming a permanent .jic, wait until the "Progress:" bar has reached "100% (Successful)" and then power-cycle your CoCo or Dragon. Once your VGA monitor syncs, you should see the appropriate version number in the banner.
AMC3, F1, KMC1, T1 example:
Marty Jenkins, after having some difficulty with recognizing his USB blaster from Windows, provided this document which may help those who are having trouble with their FPGA update in versions of Windows from 7 to 10. Thank you, Marty!
Some additional issues not covered by this document may be related to getting the USB Blaster driver installed in the first place under Windows 10. If you find in your Device Manager that your Altera USB Blaster device is recognized but has an exclamation point icon next to it and/or no driver installed or available, then the missing auto-installation of the driver could be the problem. This is related to the fact that Intel is currently (as of 2020) not producing signed drivers. To install them requires rebooting your PC with driver signature checks disabled. Courtesy this forum, take the following steps:
- Go to Windows 10 settings and search for "advanced startup options" .
- Under Advanced Startup, hit "Restart now"
- Choose "Troubleshoot", then "Advanced options", then "Startup Settings".
- You'll get a screen telling you what you will be able to change. Click the "Restart" button.
- As part of the reboot, you'll be given a menu of options; item 7 disables driver signature enforcement.
- Once done booting, use Device Manager to update the drivers. Point it to the location on your system where you have installed the Quartus software, for example C:\intelFPGA_lite\20.1\quartus\drivers. When installing the driver, expect to see a warning about the signature. Despite this, the driver should install successfully.
- Now you should be able to see your USB Blaster in your Quartus Programmer software. If you are satisfied that the driver is installed properly you may reboot to re-enable signature enforcement.