From ba78e9b06c269822ba5221d6b0516b8b53f8b114 Mon Sep 17 00:00:00 2001 From: Eric Helgeson Date: Tue, 11 May 2021 10:09:43 -0500 Subject: [PATCH] Move troubleshooting to readme --- README.adoc | 31 +++++++++++++++++++++++-------- docs/troubleshooting-1.0-c.adoc | 24 ------------------------ 2 files changed, 23 insertions(+), 32 deletions(-) delete mode 100644 docs/troubleshooting-1.0-c.adoc diff --git a/README.adoc b/README.adoc index af2ac5a..ddda2d1 100644 --- a/README.adoc +++ b/README.adoc @@ -117,22 +117,37 @@ To enable termination place the two jumpers on the TERM block. Termination shoul ## Troubleshooting -### Check Log Files +### Review the LOG.txt -If your device is not working - check the `LOG.txt` in the root of the SD card. +There should logs that indicate what BlueSCSI did at startup. -### Performance is slower than expected +### LED Flashes on and off 3x -Use ExFat instead of FAT32 +This indicates BlueSCSI could not find any files on the SD card or communicate with the SD card. -Try a different SD card. Cheap/old SD cards can affect performance. +Ensure your files are named properly (case sensitive) following the naming convetion in the readme. -### Version Specific +If you recived a kit - verify all connections and that the outside of the SD holder is grounded. + + +### LED Flashes on and off 5x + +Format your card with https://www.sdcard.org/downloads/formatter/ + +### Slow performance + +Ensure you are using a good SD card. SD card quality can vary widely. + +Format your card as ExFat - users have seen quite a jump in performance. + +### (Kit Only) Verify you are not using a bad fake + +https://github.com/keirf/Greaseweazle/wiki/STM32-Fakes[How to tell if your STM32 is fake] + +### Older Version Specific Troubleshooting <> -<> - ## Hardware Versions ### 1.1-a (in testing) diff --git a/docs/troubleshooting-1.0-c.adoc b/docs/troubleshooting-1.0-c.adoc deleted file mode 100644 index 08788ec..0000000 --- a/docs/troubleshooting-1.0-c.adoc +++ /dev/null @@ -1,24 +0,0 @@ -# Troubleshooting 1.0-c -:toc: macro - -## Review the LOG.txt - -There should logs that indicate what BlueSCSI did at startup. - -## Green LED Flashes on and off 3x - -This indicates BlueSCSI could not find any files on the SD card or communicate with the SD card. - -Ensure your files are named properly (case sensitive) following the naming convetion in the readme. - -If you recived a kit - verify all connections and that the outside of the SD holder is grounded. - -## Slow performance - -Ensure you are using a good SD card. SD card quality can vary widely. - -Format your card as ExFat - users have seen quite a jump in performance. - -## (Kit Only) Verify you are not using a fake - -https://github.com/keirf/Greaseweazle/wiki/STM32-Fakes[How to tell if your STM32 is fake] \ No newline at end of file