Skip to content

Troubleshooting

Jump to bottom
Daniel Markstedt edited this page Jul 26, 2022 · 46 revisions

Table of Contents

Hardware troubleshooting

Schematics

Schematics for the RaSCSI Reloaded are available in pdf format. Choose the one that corresponds to the hardware revision of your particular board.

Full-size

Zero

Termination

First step in troubleshooting is to check the termination. Seriously. Check this.

https://lowendmac.com/1998/termination-explained/

Check the Termination again

Re-check it again.

Loopback Testing

A way to check out the RaSCSI hardware is to create a loopback cable. This can be done using jumper wires or a specially-constructed DB25 male jack connector can be created to allow easy re-use.

The diagram for the loopback connections is shown here. Note that the RaSCSI connector is a FEMALE connector. If you are using a gender changer (as in the previous picture), you want to use the MALE connector pinout

FEMALE connector pinout MALE connector pinout
Link to original drawing

Once you have the loopback connections made, you can checkout the RaSCSI source code and run the loopback test python script. (Note: This requires python3 to run)

Before running this test:

- Ensure that you have termination enabled before running this test!!

- Ensure that the RaSCSI service is NOT running `sudo systemctl stop rascsi`

- Double check your loopback that you do NOT have TERM POWER connected to Ground!!! 

cd ~
git clone https://github.com/akuker/RASCSI.git
cd ~/RASCSI
# FOR NOW, the code is only available on the 'develop' branch
git checkout develop
cd ~/RASCSI/src/loopback_test/
pip install RPi.GPIO
./test.py

The Python test script will list all of the SCSI signals that are not working properly. You can the use the schematicto debug if there are any broken traces, lifted pads or bad solder joints.

Note: this concept was original created by Saybur for the Scuznet board: https://github.com/saybur/scuznet/tree/master/testing

Example Successful Test Run

Example Test Run With Failures

In this case, there is something wrong with either the "C/D" SCSI signal or the "D4" SCSI data line or both.

Multimeter Testing

You can test each individual SCSI signal using a multimeter. This procedure is listed here.

Turn on the termination DIP switches

Pull out your trusty multimeter. With the RaSCSI software running, disconnect all SCSI devices and check the voltages:

  • TPWR should be 5v
  • D0-D7 should be around 3.08v
  • Control signals should be around 3.08v
STOP the RaSCSI service `sudo systemctl stop rascsi`.
  • Check the LEDS
 raspi-gpio set 4 op dh #  ACT LED should be ON
 raspi-gpio set 4 op dl #  ACT LED should be OFF
 raspi-gpio set 5 op dh #  ENB LED should be ON
 raspi-gpio set 5 op dl #  ENB LED should be OFF
  • Set the direction of the transceivers to be outputs
 raspi-gpio set 8 op dl #PI-DTD is GPIO 8 - set LOW for Pi->SCSI output
 raspi-gpio set 6 op dh #PI-IND is GPIO 6 - set HIGH for Pi->SCSI output
 raspi-gpio set 7 op dh #PI-TAD is GPIO 7 - set HIGH for Pi-SCSI output
  • Check Data 0
 raspi-gpio set 10 op dh # D0 output should be around 3v
 raspi-gpio set 10 op dl # D0 output should be around 0v
  • Repeat for all of the other data and control signals
 raspi-gpio set <GPIO> op dh # <Signal> output should be around 3v
 raspi-gpio set <Signal> op dl # <Signal> output should be around 0v
Signal GPIO Direction Control Direction: Pi->SCSI Direction: SCSI->PI
D0 10 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
D1 11 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
D2 12 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
D3 13 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
D4 14 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
D5 15 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
D6 16 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
D7 17 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
DP 18 DTD (GPIO 8) raspi-gpio set 8 op dl raspi-gpio set 8 op dh
I/O 25 TAD (GPIO 7) raspi-gpio set 7 op dh raspi-gpio set 7 op dl
REQ 22 TAD (GPIO 7) raspi-gpio set 7 op dh raspi-gpio set 7 op dl
C/D 24 TAD (GPIO 7) raspi-gpio set 7 op dh raspi-gpio set 7 op dl
MSG 23 TAD (GPIO 7) raspi-gpio set 7 op dh raspi-gpio set 7 op dl
BSY 26 TAD (GPIO 7) raspi-gpio set 7 op dh raspi-gpio set 7 op dl
SEL 27 IND (GPIO 6) raspi-gpio set 6 op dh raspi-gpio set 6 op dl
RST 20 IND (GPIO 6) raspi-gpio set 6 op dh raspi-gpio set 6 op dl
ACK 21 IND (GPIO 6) raspi-gpio set 6 op dh raspi-gpio set 6 op dl
ATN 19 IND (GPIO 6) raspi-gpio set 6 op dh raspi-gpio set 6 op dl

Software

SPDLOG compile error

If you see an error like the following, your Raspberry Pi OS may be too old. 

log.h:22:3: error: ‘log’ is not a member of ‘spdlog’
   spdlog::log(loglevel,buf);}while(0);

The easiest approach would be to generate a new SD card with the latest version of Raspberry Pi OS, using the Raspberry Pi Imager (https://www.raspberrypi.org/software/). You can also try to update libspdlog-dev to a newer version.

You can check which version of spdlog you're using with the following command: 

pi@rascsi:~ $ sudo apt search libspdlog
Sorting... Done
Full Text Search... Done
libspdlog-dev/stable,now 1:1.3.1-1+rpi1 armhf [installed]
  Very fast, header only, C++ logging library

pi@rascsi:~ $

Network Interface Instability

You may find that the network interface that your Pi is using to connect to your LAN and the internet keeps getting pulled down and restarted, causing temporary connectivity interruptions. While the root cause is not known at the time of writing, a workaround that has been proven effective is to disable network interfaces that you don't actively use, e.g. wlan and bluetooth if you're using eth.

This can be achieved by appending the following to the bottom of /boot/config.txt and rebooting your Pi (for disabling wlan and bluetooth): 

dtoverlay=disable-bt
dtoverlay=disable-wifi

The RaSCSI is behaving erratically

If your RaSCSI setup is starting up but behaving erratically, it may not be getting enough power from the power supply or SCSI bus. Symptoms include the network interface going down randomly, or the SCSI host not recognizing attached devices due to lack of termination power.

One way to determine that the Raspberry Pi isn't getting enough power, is to observe the syslog and look for Under-voltage detected! messages.

It is recommended to use a known good power supply rated for at least 5V / 2.5 amps -- maybe even higher for overclocked or more powerful future generations of Raspberry Pis.

Clone this wiki locally