changelog.md

   1 # Change log
   2
   3 This is a listing of all changes and prototypes for the Atreus
   4 keyboard design. Changes to the
   5 [Atreus Deck](https://atreus.technomancy.us/marki) are elsewhere.
   6
   7 ## Keyboardio Atreus: 2020-03-17
   8
   9 * Completely redesigned factory-produced case.
  10 * Metal switch plate.
  11 * USB C port.
  12 * Optionally labeled XDA keycaps.
  13 * 15mm smaller in two dimensions.
  14
  15 ## NX-04: 2019-05-25
  16
  17 This was the first prototype to incorporate the redesigned PCB by
  18 Jesse Vincent.
  19
  20 * 2 additional keys.
  21 * wooden case with 4 layers instead of 5.
  22 * detachable USB cable.
  23 * swappable Cherry MX switches.
  24 * surface-mount controller and diodes.
  25 * Kaleidoscope is the default firmware.
  26
  27 ## Mark 3.8: 2018-7-28
  28
  29 * QMK is the default firmware for all boards now.
  30
  31 ## Mark 3.7: 2017-6-29
  32
  33 * Manually bending middle switch pins on Alps is no longer necessary.
  34 * Spacer layer is split into three pieces to be less wasteful with materials.
  35
  36 ## Mark 3.6: 2016-3-14
  37
  38 * TMK is the default firmware.
  39 * New layout with arrows on the fn layer.
  40 * PCB is now label-side up by default.
  41
  42 ## Mark 3.5: 2015-6-23
  43
  44 * Change to Matias switches.
  45
  46 ## NX-03: 2015-05-08
  47
  48 * Matias Clicky switches.
  49 * Alps-compatible switch plate.
  50
  51 ## Mark 3.1: 2014-11-25
  52
  53 * [Second revision of circuit board](http://gerblook.org/pcb/jweM8BcTbgKCL4zsj8tEYj).
  54 * Arrows on L2 shifted over one column.
  55 * Circuit board license changed to match the rest of the Atreus project.
  56
  57 The second revision of the circuit board exposes the reset pin,
  58 removing the need for hookup wire described below. It also removes
  59 [the need to cut a notch in the circuit board](https://www.flickr.com/photos/technomancy/15862732742)
  60 to allow the USB connector more clearance.
  61
  62 The layout changed slightly by shifting the arrow keys on L2 over one
  63 column so they can be hit from the normal position without the pinky key.
  64
  65 ## Mark 3: 2014-10-30
  66
  67 * Initial [board design](http://gerblook.org/pcb/zqMY66AEsKz3xehSrdoDV6) in KiCAD + Racket.
  68 * Assembly guide updated to include wood finishing.
  69 * Cable hole in case spacer has rounded edges.
  70 * New layout: multidvorak.
  71 * Switch to Pololu A-Star Micro controller. (also USB mini->micro)
  72
  73 A
  74 [circuit board was designed in KiCAD with the switch placement logic written in Racket](http://technomancy.us/176). The
  75 first revision of the circuit board does not expose the reset pin, so
  76 hookup wire is needed to provide a backup reset mechanism once the board
  77 is fully assembled. The firmware contains a reset mechanism, but if
  78 bugs in the firmware prevent it from being activated, the back case
  79 can be removed and the hookup wires can be connected twice in a second
  80 to initiate a reset.
  81
  82 The new design replaced the Teensy 2 microcontroller with the smaller
  83 [A-Star Micro](http://www.pololu.com/product/3101) which uses a USB
  84 Micro connector instead of USB Mini.
  85
  86 The new multidvorak layout allows the firmware to support hardware
  87 dvorak and software dvorak simultaneously. The edges of the cable hole
  88 are rounded off to reduce strain on the cable.
  89
  90 ## NX-02: 2014-08-05
  91
  92 * Matias Quiet Click switches.
  93 * Teensy 3: ARM-based microcontroller.
  94 * Orestes: firmware written in Forth.
  95
  96 An
  97 [experimental prototype](https://www.flickr.com/photos/technomancy/14654421878)
  98 using Matias Quiet Click switches and the ARM-based Teensy 3
  99 controller. The Matias switch shape was supported by cutting the
 100 notches out of each switch hole individually with a knife.
 101
 102 Porting the firmware to the ARM platform was accompanied by porting
 103 [an implementation of Forth](https://github.com/technomancy/orestes/tree/teensy3)
 104 and porting the firmware logic to that.
 105
 106 ## Mark 2: 2014-04-22
 107
 108 * New OpenSCAD [case design](https://www.flickr.com/photos/technomancy/14719013574) by Constantine.
 109 * New layouts: hardware dvorak, hardware colemak.
 110 * Assembly guide.
 111
 112 The case was
 113 [redesigned in OpenSCAD](https://github.com/technomancy/atreus/blob/master/case/openscad/atreus_case.scad)
 114 to be easier to produce from mail-order laser cutting services. This
 115 revision can be recognized by its use of eight screws instead of the
 116 original seven. The cuts in the top plate around the switches are also
 117 much closer to the switches themselves.
 118 [A second independent build](http://geekhack.org/index.php?topic=57007.msg1292144)
 119 was documented.
 120
 121 The assembly process is documented properly.
 122
 123 ## Mark 1: 2014-04-01
 124
 125 * Custom Atreus firmware in C.
 126 * Layout changes; new layer.
 127
 128 A
 129 [custom Atreus-specific firmware codebase](https://github.com/technomancy/atreus-firmware)
 130 was started. Digits were moved to a numpad arrangement and the L2
 131 layer (function and arrow keys) was added. The first
 132 [third-party build](http://blog.tarn-vedra.de/2014/04/reproducing-keyboard-science_1707.html)
 133 was documented.
 134
 135 ## NX-01: 2014-02-22
 136
 137 * [Initial prototype](https://www.flickr.com/photos/technomancy/12805226463)!
 138 * Case hand-drawn in Inkscape.
 139 * Teensy 2 microcontroller, hand-wired matrix.
 140 * Uses TMK firmware.
 141
 142 This was the first Atreus,
 143 [created solely for personal use](http://technomancy.us/173) and
 144 meticulously hand-wired with a number of errors. Support for the
 145 Atreus was
 146 [added to the TMK firmware codebase](https://github.com/technomancy/tmk_keyboard/tree/atreus),
 147 but power-saving bugs in TMK meant that it occasionally dropped key
 148 presses on low-voltage laptops.