Developers (Advanced)


Development Environment

BlueSCSI v2 uses PlatformIO as it’s dependency and build tool. You can install the PlatformIO IDE or use the PlatformIO Core CLI to build BlueSCSI.

PlatformIO IDE

Install Visual Studio Code or VSCodium.

Clone the BlueSCSI-v2 git repo and open the cloned folder in the IDE.

You will be prompted to install PlatformIO - follow the prompts to install the PlatformIO extension.

Run the “Build” task.

Flash the the .pio/build/BlueSCSI_Pico/firmware.uf2 file to the Pico following the flashing instructions.

USB Serial Debug

Connect the Pico via USB to your computer. Use a terminal program like Tera Term (Win) or CoolTerm (Mac/Win) to view real time logs from the Pico. Note the first logs may go by faster than the USB Serial starts. You can start with the SD Card out then insert it to see the config log.

Setting up PicoProbe

Analyzing Crash

arm-none-eabi-addr2line is needed and not installed by default on PlatformIO.

# Mac
$ brew install gcc-arm-embedded
# Usage:
#    utils/analyze_crashlog.sh                # paste log to console, press ctrl-D to end
#    utils/analyze_crashlog.sh log.txt        # read log from file
#    utils/analyze_crashlog.sh log.txt path   # read log from file and find firmware at path

Release

  • On main edit src/BlueSCSI_config.h - set the date and rel, commit and tag, eg v2024.09.15
  • Edit src/BlueSCSI_config.h back to date + 1 and dev
  • Push tag git push origin v2024.09.15
  • While action is running, create a release off the tag (GH Action should really do this itself)
  • Generate release notes, note any commits or PR’s.
  • Once action is done and notes updated push main.

List of SCSI Commands implemented

I wrote this up quite a while ago, so may be outdated. Clause sections are in https://www.staff.uni-mainz.de/tacke/scsi/SCSI2.html

Command OpCode Type Clause BlueSCSI v1 BlueSCSI v2 PiSCSI
TEST UNIT READY 00h Mandatory 8.2.16 Y Y Y
REZERO UNIT 01h Optional 9.2.13 Y Y Y
REQUEST SENSE 03h Mandatory 8.2.14 Y Y Y
FORMAT UNIT 04h Mandatory 9.2.1 N Y Y
REASSIGN BLOCKS 07h Optional 9.2.10 N N Y
READ6 08h Mandatory 9.2.5 Y Y Y
WRITE6 0Ah Optional 9.2.20 Y Y Y
SEEK6 0Bh Optional 9.2.15 N Y N
SCSI Write sector buffer? 0Fh ?   N Y N
INQUIRY 12h Mandatory 8.2.5 Y Y Y
MODE SELECT6 15h Optional 8.2.9 Y Y Y
RESERVE 16h Mandatory 9.2.12 N Y Y
RELEASE 17h Mandatory 9.2.12 N Y Y
COPY 18h Optional 8.2.3 N N N
MODE SENSE6 1Ah Optional 8.2.10 Y Y Y
START STOP UNIT 1Bh Optional 9.2.17 N Y Y
RECEIVE DIAGNOSTICS RESULTS 1Ch Optional 8.2.13 N Y N
SEND DIAGNOSTIC 1Dh Mandatory 8.2.15 Y Y Y
PREVENT-ALLOW MEDIUM REMOVAL 1Eh Optional 9.2.4 Y Y Y
READ CAPACITY 25h Mandatory 9.2.7 Y Y Y
READ10 28h Mandatory 9.2.6 Y Y Y
WRITE10 2Ah Optional 9.2.21 Y Y Y
SEEK10 2Bh Optional 9.2.15 N Y N
WRITE AND VERIFY 2Eh Optional 9.2.22 N Y N
VERIFY 2Fh Optional 9.2.19 Y Y Y
SEARCH DATA HIGH 30h Optional 9.2.14.2 N N N
SEARCH DATA EQUAL 31h Optional 9.2.14.1 N N N
SEARCH DATA LOW 32h Optional 9.2.14.3 N N N
SET LIMITS 33h Optional 9.2.16 N N N
PRE_FETCH 34h Optional 9.2.3 Y Y N
SYNCHRONIZE CACHE 35h Optional 9.2.18 Y Y Y
LOCK-UNLOCK CACHE 36h Optional 9.2.2 Y Y N
READ DEFECT DATA 37h Optional 9.2.8 N Y Y
COMPARE 39h Optional 8.2.2 N N N
COPY AND VERIFY 3Ah Optional 8.2.4 N N N
WRITE BUFFER 3Bh Optional 8.2.17 Y Y N
READ BUFFER 3Ch Optional 9.2.12 Y Y N
READ LONG 3Eh Optional 9.2.9 N N Y
WRITE LONG 3Fh Optional 9.2.23 N N Y
CHANGE DEFINITION 40h Optional 8.2.1 N N N
WRITE SAME 41h Optional 9.2.24 N N N
READ TOC 43h ?   N N Y
GET EVENT STATUS NOTIFICATION 4Ah ?   N N Y
LOG SELECT 4Ch Optional 8.2.6 N N N
LOG SENSE 4Dh Optional 8.2.7 N N N
MODE SELECT10 55h Optional 8.2.8 Y Y Y
MODE SENSE10 5Ah Optional 8.2.11 Y Y Y
READ 16 88h ?   N N Y
WRITE 16 8Ah ?   N N Y
VERIFY 16 8Fh ?   N N Y
SYNC CACHE 16 91h ?   N N Y
READ CAPACITY 16 9Eh ?   N N Y
REPORT LUNS A0h ?   N N Y
SKIP READ E8h IBM proprietary, e.g. AS/400 IBM Enterprise Storage Server SCSI Command Reference N N N
SKIP WRITE EAh IBM proprietary, e.g. AS/400 IBM Enterprise Storage Server SCSI Command Reference N N N
Generated 2024-09-19