Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
avmolaei authored Aug 19, 2022
1 parent 24a347e commit ec65d41
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# AV*labs* AV-KO 1 MK I

![screenshot of the fusion360 model](https://cdn.discordapp.com/attachments/712626945023672370/1010142379384254494/Capture_decran_2022-08-19_130352.png)
Welcome to the repository of the AVlabs AV-KO 1 MK I Ortholinear Mechanical Keyboard.
It stemmed from a joke with a friend about those hentai/ahegao keycaps, and lead to become my second keyboard build, after a split redox I finished recently.
I don't really like or understand the QMK Configurator Workflow, So I use KB Layout editor and KBfirmware.com, the latter being EOL/depreciated. Make of that what you will
Expand All @@ -9,7 +9,7 @@ Files made by me are under GPLv3 as always

# CAD & 3D Printing

The body of the AV-KO1 is made to be easily and quickly 3D printed on an average I3 style machine, thanks to it's compact size and simple design. The model has on its left side a small recessed area for a machined aluminium piece with the AVlabs logo on it. A simple extrude operation allow the removal of the aforementionned recessed area if you do not want the AVlabs logo plate : (
The body of the AV-KO1 is made to be easily and quickly 3D printed on an average I3 style machine, thanks to it's compact size and simple design. The model has on its left side a small recessed area for a machined aluminium piece with the AVlabs logo on it. A simple extrude operation allow the removal of the aforementioned recessed area if you do not want the AVlabs logo plate : (
Design tool: Autodesk Fusion 360


Expand All @@ -20,7 +20,7 @@ Design tool: Autodesk Fusion 360

# ELECTRONICS & WIRING

Simplicity and Frugality are the keywords of the AV-KO1. As such, it is a classic handwiring job with 1N4148 diodes for anti-ghosting, row & collumns; and has a peticular layout: indeed, even though the keyboard is a 5x14 grid, it is actually 2 5x7 keyboards, for ease of wiring. Yes, this implies the use of an internal (or external) USB hub, yes, this implies 2 different firmwares, and no, I really don't care why it's wrong. It's **my** shitty scrappy keeb.
Simplicity and Frugality are the keywords of the AV-KO1. As such, it is a classic handwiring job with 1N4148 diodes for anti-ghosting, row & columns; and has a peticular layout: indeed, even though the keyboard is a 5x14 grid, it is actually 2 5x7 keyboards, for ease of wiring. Yes, this implies the use of an internal (or external) USB hub, yes, this implies 2 different firmwares, and no, I really don't care why it's wrong. It's **my** shitty scrappy keeb.
The MCU (2 of them) I chose was the Arduino Pro Micro. Is it an obsolete, underpowered, beginner choice? Yes. Again, I do what I want.


Expand Down Expand Up @@ -49,11 +49,11 @@ I know this part is supposed to be called BOM, but don't expect an industry stan
- left: the sources, compiled .hex, and .json kbfirmwarebuilder export for the left half of the keeb
- right: the sources, compiled.hex, and .json kbfirmwarebuilder export for the right half of the keeb

As mentionned previously, I don't really like QMK and my workflow relies on EOL/depreciated solutions. Here is how I do it.
As mentioned previously, I don't really like QMK and my workflow relies on EOL/depreciated solutions. Here is how I do it.

- Start with the layout: http://www.keyboard-layout-editor.com/#/ . This is purely to generate a "cosmetic" map of your keep, really useful to get ideas of the map, see how it will end up. Go in the "Raw data" tab, and copy paste the whole block of text. It describes how your keys are arranged.
- Go to https://kbfirmware.com/ (WARNING: EOL/DEPRECIATED), and copy the layout from kb layout editor in the "Import from keyboard layout editor .com" text field. Click import, and you should see the shape of your keeb in the editor.
- From there, you do the magic: set the collumns and rows correctly, set the pins of the MCU, set your keymaps, the different layers, the macros, the RGB LIGHTING BABEHHH. It is QMK based, and as such allows for very powerfull features. In my case, the Layer 0 is a basic character layer, and the layer 1 has the function keys, the arrows, some other additionnal modifiers and calls a bunch of macros I can call later in autohotkey.
- From there, you do the magic: set the columns and rows correctly, set the pins of the MCU, set your keymaps, the different layers, the macros, the RGB LIGHTING BABEHHH. It is QMK based, and as such allows for very powerful features. In my case, the Layer 0 is a basic character layer, and the layer 1 has the function keys, the arrows, some other additional modifiers and calls a bunch of macros I can call later in autohotkey.
- Click on Compile, and boom. You've got the firmware file of your keeb.
- I flash it using AVRdudess, but you can use whatever you want. Identify the port your arduino is on, select the AVR109 Bootloader, and the ATmega 32U4 MCU. Select the .hex file you downloaded a minute ago and program! Your keeb should be flashed.

Expand All @@ -62,7 +62,7 @@ Note: for beginners, flashing firmware on the arduino pro might be frustrating.



Note 2: debugging..... debuggin a keyboard is... surprisingly easy. Most errors will stem from wiring errors (check keys in rows and collumns to detect mistakes faster) or keymap booboos. In this case, go back to kb firmware builder, and modify. Don't forget to always download the full zip sources and json layout from kbfirmwarebuilder, and to have some kind of versionning system. Better safe than sorry.
Note 2: debugging..... debugging a keyboard is... surprisingly easy. Most errors will stem from wiring errors (check keys in rows and columns to detect mistakes faster) or keymap booboos. In this case, go back to kb firmware builder, and modify. Don't forget to always download the full zip sources and json layout from kbfirmwarebuilder, and to have some kind of versionning system. Better safe than sorry.



Expand Down

0 comments on commit ec65d41

Please sign in to comment.