unified_retro_keyboard/hardware/keyboard-sol-integrated/README.md

# SOL keyboard with built-in encoder

This keyboard with integrated encoder replicates the keyboard on the SOL-20.

This keyboard has a sibling Sol-20 keyboard without integrated
encoder [(here)](../keyboard-sol). The two keyboards are identical except for the following differences:

1. This integrated version places the connector closer to the main board keyboard
   socket, so the original cable fits more easily.

1. The non-integrated version requires a piggy-back encoder board. When
   installing in a Sol-20, this piggyback board must be mounted on the right
   side of the keyboard, and connected with a cable, to avoid mechanical
   interference from the Sol main board.
   
1. The piggy-back encoder is more flexible for use with other machines, via the Apple-1 and
   Apple-2 sockets, and two different user-configurable headers.
   
1. The piggy-back encoder also includes a UART interface.

The keyboard is designed using KiCad in order to be the most useful for anybody
wishing to modify the keyboard for more specific uses, or to add to the project.

The keyset for the SOL-20 keyboard consists of the Unified Keyboard Project
classic ASCII keyset, with a special SOL-20 add-on keyset.

## Differences from the original include:

1. The original keyboard is a capacitive keyboard. This keyboard uses standard
   switches (either Cherry or Futaba).
   
1. The original keycaps have an 11 degree angled stem. It may be possible to
   find such keycaps, but I was unable to find any. It also may be possible to
   create 11 degree adapters. But this keyboard uses straight keycaps. I have
   tried both styles, and do not find a difference in typing comfort or speed,
   althought there is an aesthetic difference. There is s tiny bit of space
   between keys using straight keycaps, so an 11 degree adapter may not require
   any change to the layout.
   
   
1. The original uses UPPERCASE+REPEAT to reset the system. For technical
   reasons, this version uses CTRL+MODE_SELECT to RESET the system. 

<img alt="Sol 20 Keyboard" src="images/sol-integrated-pcb.png" width=90%>
<img alt="Sol 20 Keyboard" src="images/sol_20_kbd.jpg" width=90%>
<img alt="Sol 20 Keyboard" src="images/kbd_fit.jpg" width=90%>