dactyl-manuform/guide/README.org
BubblesToTheLimit 4eaab75cd3 makeup changes
2016-09-11 18:29:06 +02:00

11 KiB

Preparation and Cost

Get all the parts / raw material:

What I spend on my keyboard (should give you a rough estimate for your build):

item cost
filament 70
switch-tester 30
key-caps 70
teensy 2.0 30
switches 60
usb cable 10
IO Expander, TTRS jacks and cable 30
overall cost 300

My choices / advantages:

  • Using the soldering iron at the uni-workshop for free
  • 76 Diodes for free
  • Soldering wire and copper for free
  • All the resistors used for free (5 resistors are used)
  • Several files for working out the rough edges of the 3D-printout

Depending on what you have available you might spend more or less money than me, 300€ however is a good rough estimate.

After all the parts have arrived it is safe to move on to the next section.

Wiring

It is assumed that you have printed the casing successfully.

  1. Plug the switches into the Casing, no glue is needed, the casing provides the perfect fit.
  2. Put the keycaps on the switches

    • Note that in the pictures here some of the long keys on the thumb-part are too short, that's why it doesnt look symmetrical

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/application-of-switches-and-caps.jpg

Now going further on in the guide there are two options

  1. The first option is to print flexible PCBs. The advantage is that you save alot of wiring business, everything looks rather clean and you dont have to worry about your cables being too thick such that the casing doesnt close. However if you don't have the means to print out such PCBs there is the second option, wiring everything by hand.

    • The guide for this PCB-option is very rough indeed and it doesnt include the firmware used. Wiring and firmware play extremely close together, wiring before knowing your firmware is like buying a shoe without measuring your feet before. For this option information about the exact firmware is not published, this in addition to the fact that the pictures in this rough guide are incomplete makes this option extremely beginner-unfriendly. Going in blind-sided like this may lead to one of these things:

      1. reprogramming huge parts of the firmware to match your wiring which comes with a ton of debugging
      2. rewiring to adapt to what the firmware expects, which may easily double your work here
  2. The second option is to hand-wire everything. For people like me who had never soldered before this was great pain and pleasure.

    • Here too firmware and wiring go hand in hand, you pretty much have to have a detailed look at the firmware you are using before wiring anything. I provide my modification of the "ergodox-firmware" over here: https://github.com/BubblesToTheLimit/ergodox-firmware

      • TODO: Make a successfull pull-request, such that it is available in the official ergodox-firmware
    • Some of the steps of this guide may not be described in much detail, but in contrast to option one there is a whole lot more of information.

Route 1: Dactyl Flexible PCB Rough Guide

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/workbench.jpg

For now, take a look at the images and try to figure things out, I know that's not great (it's better than nothing!)

Making the PCB

Get two sheets of 6in square Pyralux™. Use the Toner Transfer method to etch the Pyralux sheets as you would a usual PCB

NOTE: If you only have an Inkjet make photocopies of the print out, voilà Toner based copies!

Here'sa handy toner transfer guide …

Print these PCB designs out…

Left hand:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/left-hand-pcb-pyralux.png

Right hand:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/right-hand-pcb-pyralux.png

When you're done etching, you'll need to carefully cut the pcb into pieces… See the images below.

Applying the PCB to the electronical parts

The thumb cluster pcb for the left hand:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/madness.jpg

Solder the MCP like so:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/left-hand-mcp-1.jpg /jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/left-hand-mcp-2.jpg

Solder the Teensy 2.0 like so:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/teensy-1.jpg

Some interesting pull up 10k resistor business here… (TODO add a small diagram and notes)

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/teensy-2-fuxor-reziztorrs.jpg

Each hand of the keyboard will wire up like so:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/right-hand-pcb-1.jpg

Teensy goes here… note the rows soldered to the teensy via the Pyralux:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/right-hand-pcb-with-teensy.jpg

Here the left hand:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/hotglue-left-hand.jpg

That's all for now, this guide will improve over time! (TODO!)

Route 2: Dactyl Hand-Wiring Guide

Step 1: Creating the rows

Using the copper wire you solder each row together, notice how the thumb-part gets its own row. If you take a close look you can see how I did do a messy job soldering, I had to redo some of the parts because they weren't soldered properly. Do this for both sides. Which ones of the two available pins of each switch you chose for the row doesnt matter, but for it to look clean you should decide for either one of them.

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/wiring_create_rows.jpg

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/wiring-create-rows-both-sides.jpg

You might want to go ahead and test each one of the 70 switches with a multimeter.

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/wiring-create-rows-testing.jpg

Step 2: Create the columns

The next step is to create the columns by soldering the diodes. There are two options for soldering the diodes, all heading towards the switch or all heading away from the switch. These two ways are called "row-driven" or "column-driven" and here again it is cruciual for the firmware and the actual wiring to be on the same page.

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/diode-diagram-drive-columns.png

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/diode-diagram-drive-rows.png

If you want to try and use the "tmk_keyboard" firmware which seems to be also interesting you want to wire the diodes in the according way (check whether the tmk_keyboard firmware expects a row-driven or a column-driven setup).

As you can see in these following pictures I went for the "row-driven" setup (visible by the direction of the diodes, the black line being towards the key-switches). This first picture doesnt show how the 6 thumb-keys are actually individually connected to the 6 main columns, but note the small black line on each diode.

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/wiring-create-columns-left.jpg

This second picture shows how the 6 thumb-keys are actually connected to the 6 main columns.

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/wiring-create-columns-right.jpg

How Thumb-keys are wired again depends on the firmware, the following picture shows the wiring of the thumb keys more clearly and also the part in the code that reflects this wiring (ergodox-firmware/src/keyboard/dactyl/matrix.h).

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/thumb-key-wiring.jpg

Step 3: Put the Teensy and the MCP in place

This next step is to wire the Teensy 2.0 and the MCP 23018 in place. Everything necessary for that really is the following circuit diagram

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/circuit-diagram.png

Things to note here:

  • The columns for the MCP go from 0 to 6, the columns for the Teensy go from 7 to D (counting in hexadecimal) which makes great sence, since the MCP is left to the Teensy and we read from left to right.
  • When debugging this and using the ergodox-firmware, both sides have to be wired completely and actually with the TTRS connected, dont expect the keyboard to work before that. The reason being is how the ergodox-firmware stops completely if either the Teensy or the MCP weren't initiated properly.
  • In the circuit-diagram the columns on the left side (MCP side) actually go from GPA5 to INTA (TODO: Update the circuit diagram and get rid of this point)
  • The LEDs are handy for debugging, definately go ahead and connect those. When the keyboard starts successfully two of the LEDs light up shortly.
  • From the Teensy over to the MCP go exactly 4 connections. The blue, the red and the two green ones. This is done using the TTRS jacks and cable.
  • Yes, the connection from B4 to VCC doesnt seem to make any sense, but the B4 port actually gets used directly in the ergodox-firmware, so just connect those connections that make no sense on first sight and either dont question it or find out why this is necessary by going through the firmware in great detail.

This is how the trrs jacks are wired:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/trrs-jack.jpg

After you are done you might have the following result:

/jasmine/dactyl-manuform/media/commit/2ab979f8e0e83e60eca454a9f6627c89e7df5299/guide/rows-and-columns-connected-to-chips.jpg

Good luck!