ZSA's fork of QMK Firmware

This purpose of this fork is maintain a clean repo that only contains the keyboard code that we need, and as little else as possible. This is to keep it lightweight, since we only need a couple of keyboards. This is the repo that the EZ Configurator will pull from.

Documentation

• See the official documentation on docs.qmk.fm

The docs are powered by Docsify and hosted on GitHub. They are also viewable offline; see Previewing the Documentation for more details.

You can request changes by making a fork and opening a pull request, or by clicking the "Edit this page" link at the bottom of any page.

Supported Keyboards

• ErgoDox EZ
• Planck EZ
• Moonlander Mark I
• Voyager

Building

To set up the local build environment to create the firmware image manually, head to the Newbs guide from QMK. And instead of using just qmk setup, you will want to run this instead:

qmk setup zsa/qmk_firmware -b firmware23

Creating Firmware Based on a User-Configured Layout

1. To create or edit a layout, use ZSA Oryx, a user-friendly keyboard configuration tool developed by ZSA.
2. If a layout is compiled, you should see a 'Download Source' link. If not, press 'Compile this layout,' and it should become available.
3. After downloading the archive, extract it. Inside, you'll find a folder named yourlayoutname_source. Keep the files within this folder and remove the rest.
4. Ensure that your environment is set up correctly by following the QMK documentation on setting up your environment.
5. In a QMK firmware directory, run make keyboard:yourlayoutname. For example, to build firmware corresponding to the 'Lit Voyager' layout, run make voyager:lit.
6. Use any flashing tool to install the firmware on your keyboard.

Maintainers

QMK is developed and maintained by Jack Humbert of OLKB with contributions from the community, and of course, Hasu. The OLKB product firmwares are maintained by Jack Humbert, the Ergodox EZ by ZSA Technology Labs, the Clueboard by Zach White, and the Atreus by Phil Hagelberg.

Update Process

1. Check out branch from ZSA's master branch:

   1. git remote add zsa https://github.com/zsa/qmk_firmware.git
   2. git fetch --all
   3. git checkout -B branchname zsa/master
   4. git push -u zsa branchname

2. Check for core changes:

   • https://github.com/qmk/qmk_firmware/commits/master/quantum
   • https://github.com/qmk/qmk_firmware/commits/master/tmk_core
   • https://github.com/qmk/qmk_firmware/commits/master/util
   • https://github.com/qmk/qmk_firmware/commits/master/drivers
   • https://github.com/qmk/qmk_firmware/commits/master/lib
   • These folders are the important ones for maintaining the repo and keeping it properly up to date. Most, but not all, changes on this list should be pulled into our repo.

3. git merge (hash|tag)

   • git rm -rf docs users layouts .vscode to remove the docs and user code that we don't want.
   • To remove all of the keyboard exept the ones we want:

     find ./keyboards -mindepth 1 -maxdepth 1 -type d -not -name ergodox_ez -not -name planck -not -name moonlander -not -name pytest -exec git rm -rf '{}' \;
     find ./keyboards/planck -mindepth 1 -maxdepth 1 -type d -not -name ez -not -name base -not -name glow -not -name keymaps -exec git rm -rf '{}' \;

   • To remove all of the keymaps from folder that we don't want:

     find ./keyboards/ -mindepth 3 -maxdepth 3 -type d -not -name default -not -name oryx -not -name webusb -not -name glow -not -name reactive -not -name shine -not -name keymaps -not -name halfmoon -exec git rm -rf '{}' \;

   • Restore necessary files/folders:

     git checkout HEAD -- keyboards/handwired/pytest
     git checkout HEAD -- layouts

   • Resolve merge conflicts, and commit.

4. Commit update

   • Include commit info in [changelog.md](changelog.md)

5. Open Pull request, and include information about the commit

Strategy

To keep PRs small and easier to test, they should ideally be 1:1 with commits from QMK Firmware master. They should only group commits if/when it makes sense. Such as multiple commits for a specific feature (split RGB support, for instance)