Add details on encoder build

Home.md

@@ -6,11 +6,10 @@ This wiki will collect technical notes, assembly and configuration guides, tips
 
 [Classic Keyboard build guide](classic-keyboard-build)
 
-[Apple II build guide](apple-ii-notes/building.md)
-
 [Apple II notes](apple-ii-notes/apple-ii-notes)
 
-[Encoder nodes (2560-based)](encoder-2560-notes)
+[Encoder notes (2560-based)](encoder-2560-notes)
+
 <details>
 <summary>Programming the Atmega chips</summary>
 Make sure that the DIV8 flag is OFF (or the chip will run at 1 MHz and you will find the encoder to be very sluggish), and the ISP programming flag is enabled (if you want to be able to program via the ISP header)

apple-ii-notes/apple-ii-notes.md

@@ -1,4 +1,4 @@
-Building the keyboard
+# Building the keyboard
 
 This document walks through the keyboard assembly process for the classic keyboard in Apple II configuration, using Cherry MX keys.
 
@@ -20,6 +20,8 @@ If you got the kit from ReActiveMicro, then your kit will include:
 
 </details>
 
+
+## Building the Keyboard
 <details>
 <summary>Prepare the keyboard PCB</summary>
 
@@ -117,9 +119,14 @@ Notes:
 <summary>Install the LED</summary>
 Install the LED on the POWER switch. There is a slot along the bottom of the switch that provides access to the LED pads on the PCB.  The long lead is the anode (the + side), and should be on the LEFT side as you face the keyboard.  
 
+[[images/led-orientation.jpg]]
+
+[[images/led-installed.jpg]]
+
 An amber LED is included in the components kit, but feel free to choose any color you prefer.
 
 If you plan on populating the full classic layout, you may also want to install an LED at the position marked "caps lock" on the PCB
+
 </details>
 
 <details>
@@ -129,6 +136,58 @@ As you can see, the classic keycap set includes additional keycaps beyond the Ap
 
 </details>
 
+## Building the Encoder
+
+<details>
+
+<summary>Install the SMT crystal (optional)</summary>
+
+You may optionally install a 16 MHz crystal. By default the microcontroller uses
+the internal 8 MHz clock, even if you do install the 16 MHz crystal. If you wish
+to enable the crystal, you will have to set the appropriate fuses, and you also
+may wish to adjust the firmware key-repeat rate. The current firmware runs just
+fine without the crystal.
+
+[[images/encoder-crystal.jpg]]
+
+</details>
+
+<details>
+<summary>Install the parallel out connector</summary>
+
+The parallel out connector interfaces with the host computer.  If you plan to use the keyboard with an Apple 1, Mimeo 1, or similar clone, then install the 16-pin socket in the Apple 1 location.  If you plan to use the keyboard with an Apple II/II+ or a Replica 1, then use the Apple 2 connector.  Of course, you can install sockets in both connectors if you want to use the keyboard with either type of machine.
+
+**Note:** For the computer interface, I recomment using a dual-wipe socket, and ***not** a machine-pin socket.  Machine-pin sockets grip the pins more tightly and are more likely to bend pins on the ribbon cable as you remove and re-insert the cable connectors.
+
+</details>
+
+<details>
+<summary>install the programming, output, and config headers</summary>
+
+1. Install the 6-pin right-angle ICSP (In circuit serial programming) header in the space labeled "ISP" on header J6.  If you plan to use JTAG for debugging or programming, then you can use a 14-pin header to cover the entire J6 footprint.
+
+1. Install the 5-pin control/output header at J4.
+
+1. Install the 16-pin configuration header at SW1.  If you desire, you can install a DIP switch at SW1 instead.  The DIP switch is a tidy option.  However, I have gravitated toward the header because DIP switches have different numbering from the PCB silk-screen, which can be confusing, and it's sometimes hard to tell which position is open and which is closed.  Also, many DIP switches are hard to access without removing the encoder from the keyboard.  Headers and jumpers are unambiguous, and easy to manipulate with the encoder mounted to the keyboard.
+
+[[images/encoder-misc-connectors.jpg]]
+
+</details>
+
+<details>
+<summary>install the 40-pin keyboard header</summary>
+
+Next install the 40-pin male keyboard header as shown.  The two resistor arrays shown are discussed further down.
+
+[[images/encoder-kbd-connector.jpg]]
+
+</details>
+
+<details>
+<summary></summary>
+
+</details>
+
 Notes on Apple II configuration
 
 Mount the keyboard to the case using 6-32 Male/Femail standoffs.  This will keep the keys from protruding too much, and provides room for the lid to slide between the case and the keyboard.