qmk_firmware

QMK firmware for my keyboards (Corne, Sweep Ferris) and trackball (Ploopy Adept)
Log | Files | Refs | Submodules | LICENSE

readme.md (4157B)


      1 # mini42
      2 
      3 ![mini42](https://i.imgur.com/xrSKhqRh.png)
      4 ![mini42PCB](https://i.imgur.com/R7u1KB8h.png)
      5 
      6 *A pre-built, low profile, split mechanical keyboard based on the RP2040 processor*
      7 
      8 * Keyboard Maintainer: [Kevin Gee](https://github.com/controller-works)
      9 * Hardware Supported: *mini42 split ergonomic keyboard*
     10 * Hardware Availability: *https://controller.works/products/mini42-low-profile-ergonomic-keyboard* Hardware is available as pre-built units only.
     11 
     12 Make example for this keyboard (after setting up your build environment):
     13 
     14 ```sh
     15     make controllerworks/mini42:default
     16 ```
     17 
     18 Flashing example for this keyboard:
     19 
     20 ```sh
     21     make controllerworks/mini42:default:flash
     22 ```
     23 See the [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) and the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information. Brand new to QMK? Start with our [Complete Newbs Guide](https://docs.qmk.fm/#/newbs).
     24 
     25 ## Features
     26 - Highly integrated design with microcontroller, USB and TRRS connectors, and OLED all integrated on the main board with no secondary modules
     27 - RP2040 processor by Raspberry Pi Foundation running at 130 MHz with 16MB flash memory
     28 - CNC milled aluminum case with only 8mm thickness
     29 - "PCB art" shine through back plate with gold surface finish
     30 - 128x32 OLED on each keyboard half
     31 - 42 per-key RGB LEDs and 12 backlight RGB LEDS are individually addressable
     32 - ESD and over-current protection on USB and TRRS connectors
     33 - Reset and boot tactile switches
     34 - USB C host connection
     35 - Hot swap connectors for Kailh Chocolate PG1350 switches
     36 - Chocolate key spacing (18mm horizontal x 17mm vertical) 
     37 ## Bootloader
     38 
     39 Enter the bootloader in 3 ways:
     40 
     41 * **Bootmagic reset**: Hold down the upper left key on the left hand keyboard half or the upper right key on the right hand keyboard half while plugging in USB
     42 * **Physical reset button**: Press the RST button twice, rapidly
     43 * **Keycode in layout**: Press the key mapped to `QK_BOOT` if it is available
     44 
     45 ## Pin Assignment
     46 | Name   | Pin  |  Left Row | Left Column | Right Row | **Right Column |
     47 |--------|------|-----------|-------------|-----------|--------------|
     48 | LED    | GP0  |           |             |           |              |
     49 | DATA   | GP1  |           |             |           |              |
     50 | DATA2* | GP28 |           |             |           |              |
     51 | KEY0   | GP2  | 0         | 0           | 4         | 0            |
     52 | KEY1   | GP3  | 0         | 1           | 4         | 1            |
     53 | KEY2   | GP4  | 0         | 2           | 4         | 2            |
     54 | KEY3   | GP5  | 0         | 3           | 4         | 3            |
     55 | KEY4   | GP6  | 0         | 4           | 4         | 4            |
     56 | KEY5   | GP7  | 0         | 5           | 4         | 5            |
     57 | KEY6   | GP8  | 1         | 0           | 5         | 0            |
     58 | KEY7   | GP9  | 1         | 1           | 5         | 1            |
     59 | KEY8   | GP10 | 1         | 2           | 5         | 2            |
     60 | KEY9   | GP11 | 1         | 3           | 5         | 3            |
     61 | KEY10  | GP12 | 1         | 4           | 5         | 4            |
     62 | KEY11  | GP13 | 1         | 5           | 5         | 5            |
     63 | KEY12  | GP14 | 2         | 0           | 6         | 0            |
     64 | KEY13  | GP15 | 2         | 1           | 6         | 1            |
     65 | KEY14  | GP16 | 2         | 2           | 6         | 2            |
     66 | KEY15  | GP17 | 2         | 3           | 6         | 3            |
     67 | KEY16  | GP18 | 2         | 4           | 6         | 4            |
     68 | KEY17  | GP19 | 2         | 5           | 6         | 5            |
     69 | KEY18  | GP20 | 3         | 0           | 7         | 0            |
     70 | KEY19  | GP21 | 3         | 1           | 7         | 1            |
     71 | KEY20  | GP22 | 3         | 2           | 7         | 2            |
     72 | SDA    | GP24 |           |             |           |              |
     73 | SCL    | GP25 |           |             |           |              |
     74 
     75 \*DATA2 on production units, not connected on prototype units
     76 
     77 \** Right Column numbers run right (pinky position) to left (thumb position)