Controller Works Documentation

city42

mini36

mini42

Firmware

The easiest way to customize your keyboard is to use the pre-loaded firmware and apply a custom keymap using the Via app.

Another option is to load custom firmware.

Pre-Loaded Firmware

The mini42 comes with an official build of QMK Via firmware pre-installed. Follow these steps to view and edit your keymap using the Via application.

  1. Plug your keyboard into your computer or other host system.
  2. Navigate to https://usevia.app/#/ using a web browser such as Chrome or a browser based on Chrome with HID support (this allows the web app to communicate directly with your keyboard).
  3. Press Authorize Device +. A dialog should appear with Controller Works mini36 listed. Select that device and press Connect. The mini36 keymap should appear.
  4. Select the layer in the upper right quadrant of the app. Layers are sets of keyboard functions that are accessible through shifting the keyboard to that layer, similar to standard shift keys. The different key categories are listed in the lower left quadrant. There are many ways to access different layers. A good starting point is Fn1(Fn3) and Fn2(Fn3). These will select layer 1 and layer 2 if held down individually, and layer 3 if held down together. Make sure the same keys in the upper layers are set to KC_TRNS or the downward facing triangle .

Bootloader

Enter the bootloader in 3 ways:

Pre-Built Firmware

Get into bootloader mode (see above). The keyboard will appear as a USB drive on your host machine. Drag one of the .UF2 files below onto the USB drive. Plug the USB into the other half of the keyboard and repeat the process.

mini36 default firmware Via uf2 file Use this if in doubt Works with Via app

mini36 default firmware Vial uf2 file Works with Vial app

Build Your Own Firmware (Advanced)

The mini36 is officially supported in QMK. Please follow these instructions to build and customize your own firmware for the mini36.

The mini36 is also supported in the Vial fork of QMK. Please follow these instructions for using and customizing Vial.