diff --git a/SCSI-Bus-Capture.md b/SCSI-Bus-Capture.md index 9fb1768..aeac7f2 100644 --- a/SCSI-Bus-Capture.md +++ b/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. -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.