diff --git a/README.adoc b/README.adoc index 5c09be5..7e8e92e 100644 --- a/README.adoc +++ b/README.adoc @@ -29,11 +29,11 @@ If your computer is not listed below - it may be compatible but there is no guar ### Compatible -https://github.com/erichelgeson/BlueSCSI/wiki/Supported-Systems +https://github.com/erichelgeson/BlueSCSI/wiki/Supported-Systems[Supported-Systems] ## Performance -https://github.com/erichelgeson/BlueSCSI/wiki/Performance +https://github.com/erichelgeson/BlueSCSI/wiki/Performance[Performance] ## Assembly @@ -43,56 +43,7 @@ See docs/assembly.md ## Usage -Hard Disk image files are placed in the root directory of a `ExFat` or `FAT32` formatted SD card. https://twitter.com/theory_retro/status/1376571371694723076[`ExFat` may be much faster]. Use a premade or blank disk below. These images are compatible with the RaSCSI device and Basilisk II emulator. - -The naming convention is as follows (file name max 32 characters). Note you may mount multiple drives at a time to different SCSI ID's. - -`HDxy_512.hda` -``` -HD - Hard Disk -x - SCSI ID to attach to. 0-7 (though 7 on a Macintosh is the System) -y - LUN id usually 0. -512 - Sector size. Usually 512. 256, 512, & 1024 supported. -``` - -### Examples - -`HD10_512.hda` - Hard Disk at SCSI ID 1, LUN 0, sector size of 512. - -`HD51_512 System 6.0.8L LC.hda` - Hard Disk at SCSI ID 5, LUN 1, sector size of 512. Text between block size and .hda is ignored. - -#### Bad - -`HD99_712 foo bar fizz buzz bang.hda` Over 32 chars and invalid SCSI/LUN/Block size - -If no image files are found PC13 will pulse on and off. Check the LOG.txt on the root of the SD card for any errors. - -### Premade Images - -Premade images are handy to just drop onto your SD card and go. You can use an emulator such as https://www.emaculation.com/doku.php/basiliskii_osx_setup[Basilisk II] on your modern machine to get software from places like the https://macintoshgarden.com[Macintosh Garden] to your vintage mac. - -* Premade from RaSCSI in BlueSCSI too - Rename the files based on the Usage instructions above. - http://macintoshgarden.org/apps/rascsi-68kmla-edition - -### Blanks - -These are blank, formatted drives. If you want to install an OS or software on an empty drive, use one of these. - -* Preformatted HFS blank images in various sizes - https://github.com/erichelgeson/BlueSCSI/tree/main/docs/MacHD.zip - -### Custom Disk Images (Advanced) - -This technique is useful when you would like a disk image larger than the pre-built images in the previous section. - -The following instructions demonstrates the process using https://ss64.com/osx/dd.html[dd] on a modern Mac: - -1. Open terminal. -2. The following command will create a blank disk image. You can modify the command to suit your use. - * `dd if=/dev/zero of=example.hda bs=1m count=500` - * The `count` field defines the number of megabytes (`bs=1m`) the total disk image should be. - * The output file from the command is "example.hda". This can be changed in the `of=example.hda` field. -3. Place the new blank disk image in the root directory of your SD card. -4. If you do not already have a tool to format SCSI drives, https://macintoshgarden.org/apps/lido-756[download LIDO]. You can use an emulator such as https://www.emaculation.com/doku.php/basiliskii_osx_setup[Basilisk II] to move files to the image to prepare your installation. -5. After booting into your target machine with the working Mac OS disk image on your BlueSCSI from step 3, format the blank disk. +https://github.com/erichelgeson/BlueSCSI/wiki/Usage[Usage] ### Termination @@ -124,44 +75,7 @@ First release ## Development (Advanced) -Below is for users who wish to edit or develop on the BluePill - normal users should not need to worry about this. - -### Setup PlatformIO IDE - -Open the project in https://platformio.org/platformio-ide[PlatformIO IDE] and everything is pre-configured. - -## Flashing - -When flashing you have two options: - -Flash by setting up the IDE and re-compiling and programming. If you are a developer and plan to contribute this method is what you should use. - -You may also flash the `.bin` file directly from https://www.st.com/en/development-tools/stm32cubeprog.html[STM32CubeProgrammer]. Use this method if you are not a developer and just wish to get the code to the BluePill. - -### Using STLink v2 (prefered) - -1. Remove SD Card -2. Make sure the STLink is up to date - https://www.st.com/en/development-tools/stsw-link007.html[Latest Firmware] -3. Connect pins `SWDIO`(2), `GND`(4), `SWCLK`(6), and `3.3v`(8) from the programmer to the Blue Pill. NOTE: These are not the same as Serial ports. -4. Run the https://docs.platformio.org/en/latest/integration/ide/vscode.html#project-tasks[PlatformIO: Upload] task. -5. You should see the LED `PC_13` flashing indicating no SD Card detected. -6. Insert SD Card, boot on your favorite Mac! - -The following YoutTube video demonstrates the steps of flashing & updating your BlueSCSI https://www.youtube.com/watch?v=bRLAOts_MTM - -#### Trouble Shooting - -If the device is not detected you may need to hold reset, click program, once it is detected release reset. - -If you are unable to get the device in DFU mode for programming you may need to use https://www.st.com/en/development-tools/stm32cubeprog.html[STM32CubeProgrammer] to erase the chip. - -### Alterantive upload methods - -See the https://docs.platformio.org/en/latest/boards/ststm32/bluepill_f103c8.html#uploading[uploading] documentation on PlatformIO for alterantives. - -### Using USB HID - -Note: I have not been able to get this method to work. Please contribute to this document if you do. +https://github.com/erichelgeson/BlueSCSI/wiki/Flashing[Flashing] ## Notes