Skip to the content
2 layers150.6 × 127.4 mmErgodash, the printed circuit board in 3D

Documentation of product ERGODASH MOD with OLED and KNOB that use QMK as Firmware and Suppot VIA

Size
150.6 × 127.4 mm
Copper layers
2
Thickness
1.6 mm
Parts
119
Nets
77
Pads
734
Tracks, vias
2,027, 292
Pours
2
Routed
Yes
KiCad
KiCad 6 (file 20211014)
Created
18 Mar 2024
Updated
10 Oct 2026

Overview

Ergodash is an open-source printed circuit board by juarendra, from the juarendra/ENCHDASH-QMK-VIA repository on GitHub. It is a 2-layer board of 150.6 × 127.4 mm with 119 parts on 77 nets, routed with 2,027 tracks and 292 vias.

Its parts include 47 diodes, 40 switches, 8 ICs, 4 connectors and 2 resistors. It belongs with the lEDs and displays boards and the AVR (ATmega, ATtiny) boards of this library.

README

README.md

ENCHDASH

ENCHDASH is an independent keyboard design derived from ErgoDash by omkbd. It is not an official ErgoDash revision and is not maintained, approved, or endorsed by omkbd.

Original ErgoDash hardware:
Copyright (c) 2018 omkbd
https://github.com/omkbd/ErgoDash
Licensed under the MIT License.

ENCHDASH modifications:
Copyright (c) 2024–2026 Juarendra Ramadhani
Commercial identity: Positron Electronic

Previously sold as ERGODASH-MOD-ENCH-OLED-QMK_VIA. Legacy firmware and VIA JSON for units sold under that name remain available; physical compatibility must be confirmed before new flashing. See Legacy Support.


Table of Contents


Product Specification

  • Controller: Arduino Pro Micro (ATmega32u4) with USB Type-C
  • Firmware: QMK with VIA support
  • Layout: Split ergonomic, 7×6 matrix per half
  • Features:
    • Rotary encoder support (1 per half)
    • OLED display (128×32, master/slave split display)
    • RGB underglow (WS2812, 24 LEDs total, 12 per half)
    • Hotswap sockets (Kailh)
    • 4 layers
  • Case: 3D-printed enclosure
  • Communication: TRRS cable between halves

Architecture

Split topology & data flow

The two halves are connected by a single TRRS cable. The master half (whichever side holds the USB connection) talks to the host over USB and drives the status OLED; the slave half is scanned over the serial link and shows a static logo.

mermaid
flowchart LR
    Host["Host PC\n(USB Type-C)"]
    subgraph Master["Master half"]
        MC["ATmega32u4"]
        MM["Matrix 6x7"]
        ME["Encoder"]
        MO["OLED: layer / caps"]
        ML["RGB 12x WS2812"]
    end
    subgraph Slave["Slave half"]
        SC["ATmega32u4"]
        SM["Matrix 6x7"]
        SE["Encoder"]
        SO["OLED: logo"]
        SL["RGB 12x WS2812"]
    end
    Host <-->|USB| MC
    MC <-->|"SOFT_SERIAL (D2) over TRRS"| SC
    MM --> MC
    ME --> MC
    MC --> MO
    MC --> ML
    SM --> SC
    SE --> SC
    SC --> SO
    SC --> SL

Layer model

Four layers. MO() holds a momentary layer; the CYCLE custom keycode rotates the base layers (QWERTY ↔ COLEMAK). LOWER and RAISE are reached by holding their respective keys.

mermaid
stateDiagram-v2
    [*] --> QWERTY
    QWERTY --> COLEMAK: CYCLE
    COLEMAK --> QWERTY: CYCLE
    QWERTY --> LOWER: hold MO(LOWER)
    LOWER --> QWERTY: release
    QWERTY --> RAISE: hold MO(RAISE)
    RAISE --> QWERTY: release

Firmware feature map

mermaid
flowchart TD
    QMK["QMK core (GPL-2.0)"] --> VIA["VIA support\n(runtime remap)"]
    QMK --> SPLIT["SPLIT_KEYBOARD"]
    QMK --> ENC["ENCODER + ENCODER_MAP"]
    QMK --> RGBL["RGBLIGHT (WS2812, D3)"]
    QMK --> OLEDF["OLED (128x32, 270 deg)"]
    QMK --> NKRO["NKRO + EXTRAKEY"]
    VIA --> JSON["VIA JSON definition"]

Keymap → VIA JSON → firmware mapping

Each shipped firmware variant pairs with a specific VIA definition. Load the matching JSON or VIA will not map the keys correctly.

mermaid
flowchart LR
    SRC["FIRMWARE/QMK/* keymap.c"] --> HEX["Compiled .hex"]
    HEX --> V1["ergodash_rev1_via.hex"]
    HEX --> V2["omkbd_ergodash_rev1_nowpmmousekey.hex"]
    HEX --> V3["omkbd_ergodash_rev1_wpmnomousekey.hex"]
    V1 -. load .-> J1["ErgoDash_4key_mod_positron_elektronik.json\n(legacy non-V3)"]
    V2 -. load .-> J2["NEW_ErgoDash_4key_V3_mod_positron_elektronik.json\n(canonical)"]
    V3 -. load .-> J2

Hardware Revisions

RevisionNotesPCB SourceStatus
Rev1.2Only revision with source in this repositoryHardware/PCB/Rev1.2/Documented

Safety: Do not cross-flash firmware between unconfirmed hardware revisions. Check your PCB marking before flashing.


Firmware

The repository maps these artifacts to Rev1.2 source files. Physical sold-unit marking and compatibility are not independently evidenced here. Confirm the PCB marking and matching VIA definition before flashing; do not cross-flash an unconfirmed revision. The firmware and VIA JSON now declare USB VID:PID 0x1209:0x2013, allocated under the pid.codes open-source VID (org Positron-Electronic; registration PR pidcodes/pidcodes.github.com#1303). Units flashed with earlier binaries enumerate as the legacy 0x4D44:0x6061 and must be re-flashed with the current .hex to adopt the new identity.

Three legacy firmware variants are available:

FirmwareFeaturesVIA JSONDownload
ergodash_rev1_via.hexBase: Encoder + OLED + VIAErgoDash_4key_mod_positron_elektronik.jsonFIRMWARE/
omkbd_ergodash_rev1_nowpmmousekey.hexMouse keys enabled, no WPMNEW_ErgoDash_4key_V3_mod_positron_elektronik.jsonFIRMWARE/
omkbd_ergodash_rev1_wpmnomousekey.hexWPM tracking enabled, no mouse keysNEW_ErgoDash_4key_V3_mod_positron_elektronik.jsonFIRMWARE/

VIA JSON location: the VIA JSON files referenced by the manifest live in the repository root — NEW_ErgoDash_4key_V3_mod_positron_elektronik.json (canonical; includes the rgblight menu) and ErgoDash_4key_mod_positron_elektronik.json (legacy non-V3 layout).

Firmware provenance: See FIRMWARE/manifest.json for SHA-256 checksums, source paths, and build status.

Building from source: See FIRMWARE/README.md for build instructions.


VIA Configuration

Download VIA

Loading the VIA JSON

VIA may not auto-detect ENCHDASH. Load the JSON manually:

  1. Connect your keyboard to PC
  2. Open VIA
  3. Go to Settings tab → enable "Show Design Tab"
  4. Go to Design tab
  5. Click "Load" and select the correct JSON:
    • ErgoDash_4key_mod_positron_elektronik.json for ergodash_rev1_via.hex
    • NEW_ErgoDash_4key_V3_mod_positron_elektronik.json for the other two variants
  6. Go to Configure tab to remap keys

If VIA does not detect the keyboard: Verify you loaded the JSON matching your flashed firmware. USB VID:PID must match.


QMK Keycode Reference


Encoder Configuration

Encoders are programmed through VIA using QMK keycodes in the "Any" key field.

Examples:

  • LALT(KC_TAB) — Alt-Tab
  • LCTL(KC_C) — Ctrl-C
  • LGUI(KC_C) — Cmd-C / Win-C
  • LSFT(LCTL(KC_END)) — Shift-Ctrl-End
  • MO(1) — Momentarily activate layer 1
  • LCA(KC_DEL) — Ctrl-Alt-Del
  • MT(MOD_RSFT, KC_ENT) — Shift when held, Enter when tapped
  • MACRO(0) — Trigger macro 0

See https://docs.keeb.io/via for detailed encoder setup.


Macros

VIA supports macro recording and playback. Resources:


Hardware Preview

Video demo: https://github.com/juarendra/Zeapad-Pro-QMK-VIA/assets/43043633/afd7e68e-0a54-4b18-be12-b96c0f13611a


Flashing Firmware

Using QMK Toolbox (Recommended)

  1. Download QMK Toolbox
  2. Open QMK Toolbox
  3. Select the .hex file for your desired firmware variant
  4. Connect your keyboard
  5. Press the reset button (or bridge RST to GND twice quickly)
  6. Click Flash when the bootloader is detected

Using avrdude (Command Line)

bash
avrdude -p atmega32u4 -c avr109 -P COM# -U flash:w:FIRMWARE/ergodash_rev1_via.hex:i

Replace COM# with your port (Windows) or /dev/ttyACM0 (Linux/Mac).

Backup: Keep a working firmware .hex before testing new builds.


Documentation

Hardware Files

Firmware Source

Guides and Attribution

Manuals (Indonesian)


License and Attribution

Hardware

ENCHDASH hardware is derived from ErgoDash by omkbd.

  • Original design: Copyright (c) 2018 omkbd, MIT License
  • ENCHDASH modifications: Copyright (c) 2024–2026 Juarendra Ramadhani, MIT License

See LICENSES/MIT-ErgoDash.txt for the full original license.

Firmware

QMK-derived firmware is licensed under GPL-2.0-or-later. Original QMK and omkbd copyright notices are retained in source files.

Third-Party Components

This repository includes footprint libraries, 3D models, and other assets under various licenses. See THIRD_PARTY_NOTICES.md for a complete inventory.

Repository License

See LICENSE for the repository-wide license index.


FAQ

Q: Is this an official ErgoDash product?

No. ENCHDASH is an independent derivative. It is not maintained, approved, or endorsed by omkbd.

Q: Can I use legacy firmware on existing units?

Yes. Units sold as "ERGODASH-MOD-ENCH-OLED-QMK_VIA" remain supported; legacy downloads and matching VIA JSON remain available. Physical compatibility and historical build provenance must be confirmed before new flashing. You do not need to reflash or change VIA JSON files if your keyboard is working.

Q: Which firmware should I use?

  • Most users: ergodash_rev1_via.hex (base VIA firmware)
  • Need mouse keys: omkbd_ergodash_rev1_nowpmmousekey.hex
  • Need WPM display: omkbd_ergodash_rev1_wpmnomousekey.hex

Q: VIA does not detect my keyboard

  1. Ensure you loaded the correct VIA JSON file (see VIA Configuration)
  2. Verify your firmware is flashed correctly
  3. Try the VIA web version: https://usevia.app/

Q: Can I build custom firmware?

Yes. Source code is in FIRMWARE/QMK/. See FIRMWARE/README.md for build instructions. You will need the QMK toolchain installed.

Q: Where can I get replacement parts?

Contact Positron Electronic for hardware support.

Q: How do I update to ENCHDASH-branded firmware?

Future ENCHDASH firmware will be released separately. Existing units do not require updates unless you want new features. Legacy firmware will remain available.


Contact


Note: This keyboard is a hobbyist project and derivative work. It carries no warranty. Use at your own risk.

Parts

119
QtyValueFootprintReferences
37SW_PUSH-Lily58-cachesofle:CherryMX_HotswapSW42, SW43, SW44, SW45, SW46, SW47, SW48, SW49, SW50, SW51, SW52, SW53, SW54, SW55, SW56, SW59 +21
35DSofleKeyboard-footprint:Diode_SOD123D1, D2, D10, D11, D12, D13, D14, D15, D16, D17, D18, D19, D20, D21, D22, D23 +19
12YAEMK_SK6812MINI-Eprettylib:SK6812_mini_e_flipableD35, D36, D37, D38, D39, D40, D41, D42, D43, D44, D45, D46
9Jumper_NO_Small-DeviceSofleKeyboard-footprint:JumperJP1, JP2, JP3, JP4, JP5, JP6, JP7, JP8, JP9
7HOLElibrary:holeU1, U2, U4, U5, U7, U8, U9
24.7kSofleKeyboard-footprint:R_1206_DoubleSidedR1, R2
2Conn_01x03library:conn3J2, J3
2LOGORev1:gundamG***, G***
2LOGORev1:qr-positronG***, G***
2SW_PUSHlibrary:MX_ALPSSW13, SW14
1Audio-Jack-4sofle:MJ-4PP-9TRRS1
1D-Lily58-cacheSofleKeyboard-footprint:Diode_SOD123D_1
1Jumper_NC_Small-Devicesofle:jumper_dataJP10
1Jumper_NO_Small-Devicesofle:JumperJP11
1OLED-Lily58-cacheSofleKeyboard-footprint:OLED_4PinJ6
1ProMicro_2-Lily58-cachesofle:ArduinoProMicro-ZigZag-DoubleSidedU6
1Rotary_Encoder_Switch-DeviceSofleKeyboard-footprint:RotaryEncoder_Alps_EC11E-Switch_Vertical_H20mm-keebio_modifiedSW57
1SW_PUSHsofle:TACT_SWITCH_TVBP06RST_SW1
1i2c_pin-Lily58-cacheSofleKeyboard-footprint:1pin_connJ1

Similar boards

  • 2 layers209.6 × 115.3 mmTI84KE, the printed circuit board in 3D

    TI84KE

    hackclub/OnBoard

    💡 Join 1,000 teenagers and make your first PCB with a $100 grant!

    119 parts915
  • 2 layers285.5 × 95 mmReviung46 ver1 1, the printed circuit board in 3D

    Reviung46 ver1 1

    gtips/reviung

    The REVIUNG41 is 41-key column staggered keyboard.

    119 parts517MIT
  • 2 layers139.1 × 107.7 mmLotus58 Glow 127, the printed circuit board in 3D

    Lotus58 Glow 127

    TweetyDaBird/Lotus-58-Classic

    A split ergo linear keyboard derived from the Lily58 family

    119 parts390
  • 2 layers160 × 100 mmSender v3.0 geoeffnet, the printed circuit board in 3D

    Sender v3.0 geoeffnet

    Ardumower/ardumower

    Develop an open source robotic lawn mower (HW+SW reference platform)

    119 parts282
  • 2 layers202.1 × 133.6 mmCrosses matrix-4x6, the printed circuit board in 3D

    Crosses matrix-4x6

    Good-Great-Grand-Wonderful/crosses

    A modular ergonomic columar staggered keyboard

    119 parts167MIT
  • 2 layers226 × 74.4 mmSevenSegment, the printed circuit board in 3D

    SevenSegment

    BerkeleyHCI/PolymorphicBlocks

    A Python-based hardware description language for PCBs for higher-level (block-diagram / system-architecture level) PCB design through libraries of directly reusable subcircuit generators.

    119 parts94BSD-3-Clause
  • 2 layers73 × 94 mmSportiduino base, the printed circuit board in 3D

    Sportiduino base

    sportiduino/sportiduino

    Electronic timing system for orienteering and similar outdoor sports events on Arduino

    119 parts78GPL-3.0
  • 2 layers79 × 85 mmHbr mk2-bpfs, the printed circuit board in 3D

    Hbr mk2-bpfs

    afiskon/hbr-mk2

    All HF bands QRP CW/SSB transceiver

    119 parts76MIT

Questions

How big is the Ergodash PCB?

It measures 150.6 × 127.4 mm and has 2 copper layers, 1.6 mm thick.

What parts does the Ergodash use?

119 parts. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the Ergodash KiCad files?

From the juarendra/ENCHDASH-QMK-VIA repository on GitHub, at the commit this page was made from: the board is Hardware/PCB/Rev1.2/ergodash.kicad_pcb and its schematic Hardware/PCB/Rev1.2/ergodash.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the Ergodash design in my own project?

Its repository states no licence, so its author keeps all rights: ask juarendra before reusing the design.