1 files changed, 16 insertions, 17 deletions
diff --git a/electronics/fpga-toolchain.page b/electronics/fpga-toolchain.page
index 2663576..f60062e 100644
--- a/electronics/fpga-toolchain.page
+++ b/electronics/fpga-toolchain.page
@@ -157,30 +157,29 @@ uploaded, and can be created with the programmer GUI):
 
     sudo /usr/local/diamond/3.1_x64/bin/lin64/pgrcmd -infile program_breakout_example.xcf -cabletype USB2
 
-Troubleshooting:
+Troubleshooting Notes
+~~~~~~~~~~~~~~~~~~~~~~~~
 
-- only the programmer can be open; otherwise the IDE latches on?
-- better way is DIY with a script or using udev rules
-- udevadm test /dev/bus/usb/###/###
-- programming might not work ever?
-- bundled ftdi errors ("[122032.033366] pgrcmain[10879]: segfault at 50 ip 00007f4cf1508b5e sp 00007fffb86dc210 error 4 in libftd2xx.so[7f4cf14fe000+2c000]")
-- "Another instance of this program is running": 
+When programming, only the programmer GUI can be open; if the IDE is run at the
+same time it will connect to and block the device. Aka, "Another instance of
+this program is running".
 
+Perhaps a better way to handle permissions is with udev rules or a DIY script.
+To test udev rules, try:
 
------
-Please could someone add description to Troubleshooting section?
------
+    sudo udevadm test /dev/bus/usb/###/###
 
-ie udevadm test /dev/bus/usb/###/###
+A permissions problem that comes us is, eg:
 
-unable to open device '/sys/dev/bus/usb/003/004'
+    unable to open device '/sys/dev/bus/usb/003/004'
 
-in this case.....
+An error that comes up with the bundled FTDI driver is:
 
+    [122032.033366] pgrcmain[10879]: segfault at 50 ip 00007f4cf1508b5e sp 00007fffb86dc210 error 4 in libftd2xx.so[7f4cf14fe000+2c000]
 
-or:
+Other problems needing solutions:
 
-Board with FTDI USB Host Chip detected.
+    Board with FTDI USB Host Chip detected.
 
-Programming XCF Contents... Connected to Lattice Cable Server.
-Failed.
+    Programming XCF Contents... Connected to Lattice Cable Server.
+    Failed.