Macintosh-HW
/
RASCSI
mirror of https://github.com/akuker/RASCSI.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Updated SCSI Bus Capture (markdown)

akuker 2020-11-15 14:46:40 -06:00
parent e6c5010246
commit bbfeb4a6c1
1 changed files with 20 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
SCSI-Bus-Capture.md

@ -1,31 +1,35 @@
This page is intended for developers only. Its no use to anyone else.
This page is intended for developers and/or advanced users only.
# What is scsimon?
The scsimon tool allows you to capture all of the traffic on the SCSI bus and log it to a file. The data is stored in a "Value Change Data" VCD file that can be read by GTKWave
```
+---------+ +-----------+ +----------+
| | | RaSCSI | | Other |
| HOST | | running | | SCSI |
| PC | | scsimon | | device(s)|
| | | | | |
+-+-------+ +--+-----+--+ +------+---+
| | | |
+---------------+ +--------------+
SCSI Bus SCSI Bus
```
# Checkout and build scsimon
Right now, scsimon isn't included in the master branch. When [#7](/akuker/RASCSI/issues/7) is fixed, this page should be updated. I'm assuming scsimon will be merged into master before that issue is closed.
```
cd ~
git clone https://github.com/akuker/RASCSI.git
cd ~/RASCSI
git checkout scsimon
cd ~/RASCSI/src/raspberrypi/
# If this is a new Raspberry Pi OS install, you'll need to run this command:
sudo apt install libspdlog-dev
make all
```
scsimon is included in the main installation of RaSCSI. It should be located in `/usr/local/bin/scsimon`. If its not, you may need to upgrade to a newer version of the RaSCSI software.
## Special RaSCSI 1.5/1.6 modification
If you're using a RaSCSI 2.x board ("FULLSPEC"), you do not need this modification!
If you're using a RaSCSI version 1.5 or 1.6, you will need to make the following modification to your board. This will force all of the transceivers into a RECEIVE-ONLY mode.
<a href="./images/scsimon_mods.png"><img src="./images/scsimon_mods.png" width="400"/></a>
Note: This tool hasn't been tested with RaSCSI board version 2.x.
# Capture data
Make sure you've stopped the RaSCSI service. Then run scsimon. If you're trying to capture a specific scenario, you'll want to wait to start scsimon until immediately before the scenario.
```
# TODO: I need to rename the executable to scsimon
sudo ./scsishark
sudo ./scsimon
```
Press CTRL-C when you're done capturing. You'll want to save the .VCD file.