Added basic installation guide

This commit is contained in:
Matthew Nielsen 2021-06-15 14:24:08 -06:00
parent 45c4fad81c
commit ce0d73340b
3 changed files with 128 additions and 77 deletions

View File

@ -10,28 +10,11 @@ https://github.com/xunker/blue-gs
- [Features](#features)
- [Compatible SCSI cards](#compatible-scsi-cards)
- [Performance](#performance)
- [Board](#board)
- [Assembly](#assembly)
- [Bill-of-Materials](#bill-of-materials)
- [Compatible Termination ICs](#compatible-termination-ics)
- [Assembly Steps](#assembly-steps)
- [MicroSD Slot](#microsd-slot)
- [Switch](#switch)
- [Set Jumpers](#set-jumpers)
- [LEDs and Resistors](#leds-and-resistors)
- [Termination ICs and Capacitors](#termination-ics-and-capacitors)
- [Auxiliary +12V input regulator, diodes, and capacitor](#auxiliary-12v-input-regulator-diodes-and-capacitor)
- [SCSI Card connections](#scsi-card-connections)
- [Blue Pill Module](#blue-pill-module)
- [Installation](#installation)
- [Bracket](#bracket)
- [Cables](#cables)
- [Auxiliary +12V connection](#auxiliary-12v-connection)
- [Slot Attachment](#slot-attachment)
- [Usage](#usage)
- [Board Pictures](#board-pictures)
- [Schematics](#schematics)
- [EDA/Kicad Files](#edakicad-files)
- [Version Changes](#version-changes)
- [Credits](#credits)
- [License](#license)
@ -83,71 +66,25 @@ If you have an SCSI card with an IDC-26/DB-25 connector that has not been tested
Using [BenchmarkD](https://www.brutaldeluxe.fr/products/apple2gs/benchmarked.html) with Apple IIgs (ROM 1, "Fast" speed), GS-RAM Plus w/ 2MB, GGLabs A2SCSI card.
* Read
* File: 52 KB/s
* Block-by-block: 36 KB/s
* With 64K buffer: 79 KB/s
* Write (File): 37 KB/s
# Board
# Assembly
If you purchased BlueGS as a self-assemble kit or are using your own PCBs, please follow the instructions in the "[assembly](assembly/)" directory.
If your BlueGS was purchased fully-assembled, please move on to the "[Installation](installation/)" section.
# Installation
Installation guides can be found in the "[installation](installation/)" directory.
# Board Pictures
![Rendering of front of board v1.2](images/bluescsi_iigs_internal_v1.2_front.jpg)
![Rendering of back of board v1.2](images/bluescsi_iigs_internal_v1.2_back.jpg)
TBA
# Assembly
## Bill-of-Materials
See [BOM.md](BOM.md).
### Compatible Termination ICs
See [TERMINATION.md](TERMINATION.md).
## Assembly Steps
### MicroSD Slot
### Switch
### Set Jumpers
### LEDs and Resistors
### Termination ICs and Capacitors
### Auxiliary +12V input regulator, diodes, and capacitor
### SCSI Card connections
### Blue Pill Module
# Installation
## Bracket
TBA
## Cables
TBA
## Auxiliary +12V connection
TBA
## Slot Attachment
TBA
# Usage
TBA
# Schematics
[V1.2 Schematic](schematics/schematic_v1.2.pdf)
@ -158,10 +95,6 @@ TBA
Kicad of current design can be found in [kicad](kicad/) directory.
# Version Changes
See [CHANGES.md](CHANGES.md).
# Credits
This project would not be possible without the work done by [ztto](https://github.com/ztto/ArdSCSino-stm32), [Tambo](https://twitter.com/h_koma2), [Eric Helgeson](https://github.com/erichelgeson/BlueSCSI), and many others.

14
assembly/README.md Normal file
View File

@ -0,0 +1,14 @@
# BlueGS Assembly Guide
https://github.com/xunker/blue-gs/assembly/README.md
<!-- TOC -->
- [BlueGS v1.2 Assembly Guide](#bluegs-v12-assembly-guide)
- [Deprecation Note](#deprecation-note)
- [Components](#components)
<!-- /TOC -->
# V1.3 Assembly Guide
The assembly guide for V1.3 of BlueGS is forthcoming, pending test results of the V1.2 design.

104
installation/README.md Normal file
View File

@ -0,0 +1,104 @@
# BlueGS Installation Guide
https://github.com/xunker/blue-gs/assembly/README.md
<!-- TOC -->
- [BlueGS Installation Guide](#bluegs-installation-guide)
- [Introduction](#introduction)
- [Steps](#steps)
- [Open computer case](#open-computer-case)
- [Remove rear slot cover](#remove-rear-slot-cover)
- [Unscrew DB-25 Connector](#unscrew-db-25-connector)
- [Remove SCSI card](#remove-scsi-card)
- [Move DB-25 connector](#move-db-25-connector)
- [Attach ribbon cable](#attach-ribbon-cable)
- [Install BlueGS in rear slot](#install-bluegs-in-rear-slot)
- [Reinstall DB-25 connector in rear slot](#reinstall-db-25-connector-in-rear-slot)
- [Reinstall SCSI card and close computer case](#reinstall-scsi-card-and-close-computer-case)
- [Insert MicroSD card](#insert-microsd-card)
- [Power on and enjoy!](#power-on-and-enjoy)
<!-- /TOC -->
# Introduction
Before continuing, please ensure you have all the required parts ready:
* Assembled BlueGS board, including "Blue Pill" module (See [assembly guide](../assembly/) for more info)
* Rear slot cover
* 2x screws for rear slot cover ("US Machine Screw" size: #4-40, length: > 0.75in/15mm)
* 26-pin ribbon cable
# Steps
## Open computer case
Turn off the computer power switch and unplug the power connector.
Open the top cover of the computer case.
Before continuing, it is recommended that your remove any static electricity from you body by "grounding" yourself. To do this, touch the metal part of any electrical appliance that uses a grounded/earthed electrical plug (the outside of a metal surge protector, for example).
## Remove rear slot cover
Find an unused DB-25 slot cover. The DB-25 slots are the longest, and a usable slot will be the same length as the slot already used for the external connector of your SCSI card.
To remove the cover, grasp the metal tab on the inside of the slot and turn counter-clockwise for 1/4 of a turn. Remove the metal tab, and the plastic slot cover should fall away.
Keep both the metal tab and the plastic cover for later re-use as these parts are very hard to replace.
## Unscrew DB-25 Connector
Find the existing connector for the SCSI card on the rear of the computer. It may look similar to connector for a serial card, so make sure you find the correct connector. Using a small socket or needle-nose pliers, loosen the two screw mounts on either end of the connector and remove them. The DB-25 connector should now be freed.
## Remove SCSI card
Find your SCSI card (typically in slot #7) and remove it by pulling it firmly upward.
IMPORTANT: While removing the card, ensure the cable for the DB-25 connector (see previous step) is kept away from the metal tabs on the rear of the computer case. These tabs can be **sharp** and can damage the cable.
## Move DB-25 connector
With the SCSI card out of the machine, look at the long rectangular connection where the DB-25 cable connects to the SCSI card (known as an "IDC connector"). Note where "Pin 1" is oriented. Pin 1 is usually marked by a red stripe.
Next, remove the DB-25 connector from the SCSI card. Do this by grasping the IDC connector on the SCSI card and gently pulling away from the board.
Next, take the IDC connector on the DB-25 cable and connect it the BlueGS board. It can connect to *either* connector J1 or J2.
When connecting the cable, make sure that **Pin 1** is correctly aligned. On the cable, Pin 1 is usually marked by a red stripe. On BlueGS, Pin 1 for connectors J1 and J2 are those closest to the top-left corner and the pins are marked with a "1" on the board next to them.
IMPORTANT: Again, *make sure* pin 1 is correctly aligned.
## Attach ribbon cable
Take the included ribbon cable and attach one end to BlueGS. Use either J1 or J2, whichever connector is not used by the DB-25 connector in the previous step. As before, ensure that Pin 1 is correctly aligned.
Then, connect the other end of the ribbon cable to the SCSI card. Plug it in so that Pin 1 of the ribbon cable is in the same place where Pin 1 of the DB-25 cable was previously.
## Install BlueGS in rear slot
Place BlueGS so the edge with the MicroSD slot, LEDs, and switch is inside one of the open slots on the rear of the computer. It is recommended to orient BlueGS so that the USB port is pointed upwards.
Place the included slot cover on the *outside* of the case over the appropriate slot and thread the included screws through the two screw holes and in to the brackets on BlueGS.
Once the screws are correctly threaded, gently tighten them down with a screwdriver until BlueGS is firmly attached to the slot.
## Reinstall DB-25 connector in rear slot
In the remaining open slot, reinstall the DB-25 connector.
## Reinstall SCSI card and close computer case
Reinstall the SCSI card in the correct slot and replace the cover on the computer.
## Insert MicroSD card, check termination
Take a MicroSD card that has been previously prepared (instruction [here](https://github.com/erichelgeson/BlueSCSI/wiki/Usage)) and insert it in to the slot on the rear.
If you have no other SCSI devices connected to your computer, the "Termination" switch should be set to "On".
## Power on and enjoy!
Reconnect all necessary cables, turn on the power and enjoy.
The "Power" LED should light the moment the computer turns on, and the "ACT" LED should light whenever the emulated SCSI drive is being read or written.