| 44 | | == Linux == |
| 45 | | |
| 46 | | [https://youtu.be/i3G8sQlwzcU Click here for instructional video baised on this section, mkimage and jtag_usbv4 are demonstrated] |
| 47 | | |
| 48 | | The Gateworks '''jtag_usb''' utility supports x86 32bit and 64bit Linux systems. Ubuntu is supported, however most x86 Linux distros should work as well. |
| 49 | | |
| 50 | | * ''' Note virtual machines are NOT recommended''' |
| 51 | | |
| | 40 | == Linux |
| | 41 | |
| | 42 | [https://youtu.be/i3G8sQlwzcU Click here for instructional video based on this section, mkimage and jtag_usbv4 are demonstrated] |
| | 43 | |
| | 44 | The Gateworks {{{jtag_usb}}} utility supports x86 32bit and 64bit Linux systems. Ubuntu is supported, however most x86 Linux distros should work as well. |
| | 45 | * Virtual Machines should work fine as long as they allow access to USB devices (ie Virtualbox has been known to work well) |
| 82 | | * Latest Linux x86 jtag_usb download: http://dev.gateworks.com/jtag/linux/x86/ |
| 83 | | |
| 84 | | |
| 85 | | === Conflict with ftdi-sio driver === |
| 86 | | The jtag_usb application requires that the Linux ftdi_sio kernel module not be loaded to run. You can temporarily unload it, then reload it (ie by hotplugging the jtag dongle) when done if you require it: |
| | 76 | * Latest Linux x86 jtag_usb download: http://dev.gateworks.com/jtag/ |
| | 77 | |
| | 78 | |
| | 79 | === Conflict with ftdi-sio driver |
| | 80 | The {{{jtag_usb}}} application requires that the Linux {{{ftdi_sio}}} kernel module not be loaded to run. You can temporarily unload it, then reload it (ie by hotplugging the jtag dongle) when done if you require it: |
| 278 | | |
| 279 | | |
| 280 | | |
| 281 | | == Windows == |
| 282 | | |
| 283 | | ** Please note ** |
| 284 | | Gateworks no longer maintains the Windows JTAG software and thus it is not recommended. Gateworks recommends using the provided Linux JTAG software as found on this page. |
| 285 | | |
| 286 | | ***WARNING*** This software is incapable of programming GSC firmware, your board will be bricked by doing so. |
| 287 | | |
| 288 | | [[CollapsibleStart(Windows Programming Software - No Longer Maintained)]] |
| 289 | | |
| 290 | | |
| 291 | | === Installing the Drivers for Windows === |
| 292 | | |
| 293 | | 1. Download and run the file CDM20814_Setup.exe on to your windows machine ([http://dev.gateworks.com/jtag/ Download JTAG Executables]). A window should open and close on its own: |
| 294 | | |
| 295 | | [[Image(wiki:jtag_instructions:winjtag.JPG)]] |
| 296 | | |
| 297 | | 2. Once that is finished running, download and install winjtagsetup_0_1_5.msi |
| 298 | | |
| 299 | | [[Image(wiki:jtag_instructions:winjtag2.JPG)]] |
| 300 | | |
| 301 | | 3. Choose a location to install the Gateworks Win JTAG. |
| 302 | | |
| 303 | | [[Image(wiki:jtag_instructions:winjtag3.JPG)]] |
| 304 | | |
| 305 | | {{{ |
| 306 | | #!html |
| 307 | | <h3 style="color:red">NOTE: There have been reports of an error regarding a missing DLL file. If this error is seen, please try to find the DLL on the system, and copy it into the same directory as the executable.</h3> |
| 308 | | }}} |
| 309 | | |
| 310 | | |
| 311 | | [=#windows-jtag] |
| 312 | | === Operating Instructions For Programming === |
| 313 | | ''' Please note, Windows Programming is not supported for Ventana''' |
| 314 | | |
| 315 | | 1. Connect the Gateworks JTAG-USB Programmer to the JTAG header on the board using the attached ribbon cable. |
| 316 | | |
| 317 | | 2. Power on the board and connect the Gateworks JTAG-USB Programmer to a Windows PC using the supplied USB cable. |
| 318 | | |
| 319 | | 3. Run the Gateworks !WinJTAG program. |
| 320 | | |
| 321 | | 4. Click on Open next to the Program File field and select the file location of a binary image. |
| 322 | | * '''Note''' - For Laguna boards, please do not flash a squashfs file to the board. A proper JTAG binary must be created with instructions [wiki:OpenWrt/building#BuildingJTAGBinaryFile here] |
| 323 | | |
| 324 | | 5. If desired, select a verify file or click on "Set Verify to Program File." |
| 325 | | |
| 326 | | [[Image(wiki:jtag_instructions:winjtag4.JPG)]] |
| 327 | | |
| 328 | | 6. Click on Go and wait for the programming to be complete. |
| 329 | | |
| 330 | | [[CollapsibleEnd]] |
| 331 | | |
| | 271 | == Windows |
| | 272 | **Gateworks no longer maintains the Windows JTAG software and thus it is not recommended.** |
| | 273 | |
| | 274 | Gateworks recommends using the provided [#Linux Linux] JTAG software as found [#Linux above]. |
| 334 | | === Windows Operating Instructions For Serial === |
| 335 | | You can use a terminal program for windows such as [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty] / Hyperterminal to connect to the Gateworks board serially over the JTAG / or serial port. |
| 336 | | |
| 337 | | Connect the jtag programmer to the computer, or connect a serial cable from the Gateworks board to the computer (if serial is available) |
| 338 | | |
| 339 | | Please reference the device manager area on your windows computer to detect which 'COM' port the JTAG is connected on. |
| | 277 | === Windows Operating Instructions For Serial |
| | 278 | You can use a terminal program for windows such as [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html Putty] / Hyperterminal to connect to the Gateworks board serially over the JTAG / or serial port as long as the FTDI Virtual COM port drivers are installed on your system: |
| | 279 | * https://www.ftdichip.com/Drivers/VCP.htm - Downloads for x86 (32bit) and x64 (64bit) Windows drivers |
| | 280 | |
| | 281 | To see if you have the proper drivers installed simply connect the Gateworks JTAG dongle to your Windows PC and look in the 'Device Manager' application under 'COM Ports' to see if a new serial device was added. |
