]> git.armaanb.net Git - atreides.git/commitdiff
Add description of circuit board to readme.
authorPhil Hagelberg <phil@hagelb.org>
Sat, 24 Jan 2015 08:37:48 +0000 (15:37 +0700)
committerPhil Hagelberg <phil@hagelb.org>
Sat, 24 Jan 2015 08:37:48 +0000 (15:37 +0700)
README.org
atreus.rkt

index 61028e8e8e826382a5fd30c5c0792229c9a483a6..ef19386c722bf0b36da3bdc81b8fa764f66db1fc 100644 (file)
@@ -106,11 +106,25 @@ correct number for each row, so it's more wasteful.
 
 ** Circuit Board
 
-TODO: describe
+The =atreus.rkt= program calculates switch and diode positions based
+on row/column counts, spacing, and rotation factors, and emits a
+=atreus.kicad_pcb= file. The board outline and traces are done by hand
+and are stored in the =header.rktd= and =traces.rktd= files
+respectively. The =atreus.kicad_pcb= file can be imported into [[http://kicad.org][Kicad]]
+which can export Gerber files suitable for fabrication. A copy of the
+Kicad PCB file is included in the repository if you don't want to
+recompile it using Racket. Recompiling is only required if you want to
+make changes to the procedurally-generated portions of the board.
+
+Unfortunately most PCB fabricators require a minimum order of 10 or
+so, making this impractical for one-offs. The PCB is not required, so
+for one-off boards it's usually more sensible to stick with a [[http://atreus.technomancy.us/assembly-hand-wired.pdf][hand-wired build]] instead.
 
 ** Case
 
-bottom side. The [[http://geekhack.org/index.php?topic%3D54759.msg1304117#msg1304117][mark II case]] (in the `case/dxf` directory) is
+Layered laser-cut wood or acrylic. The original case (=case-mk-i.svg=)
+is slightly less wide and has a minor asymmetry with the screws on the
+bottom side. The [[http://geekhack.org/index.php?topic%3D54759.msg1304117#msg1304117][mark II case]] (in the =case/dxf= directory) is
 available as a DFX file that you can convert to SVG or EPS for a laser
 cutter using Inkscape. Mark II features 8 screw holes and a kind of "stair
 step" design around the top and bottom of the key clusters; mark I is
index 2195de9e4f707eea146bb5b20c6232d7afd9a042..43c0ae3c156d685461659aba0150059ac2565802 100644 (file)
                  (curry read-string 999999)) op)
       (display ")" op))))
 
-(write-placement "/tmp/atreus.kicad_pcb")
+(write-placement "atreus.kicad_pcb")