From 14eef91da1d2f9f93ba66d9728408b1a12d37758 Mon Sep 17 00:00:00 2001 From: Pete Johanson <peter@peterjohanson.com> Date: Fri, 7 Aug 2020 15:05:20 -0400 Subject: [PATCH] Better user setup docs. --- .../assets/user-setup/firmware-archive.png | Bin 0 -> 13312 bytes .../assets/user-setup/github-actions-link.png | Bin 0 -> 10573 bytes docs/docs/user-setup.md | 65 ++++++++++++++++-- docs/sidebars.js | 2 +- 4 files changed, 61 insertions(+), 6 deletions(-) create mode 100644 docs/docs/assets/user-setup/firmware-archive.png create mode 100644 docs/docs/assets/user-setup/github-actions-link.png diff --git a/docs/docs/assets/user-setup/firmware-archive.png b/docs/docs/assets/user-setup/firmware-archive.png new file mode 100644 index 0000000000000000000000000000000000000000..9cb6f7deba370ec5496b488bce762db4b353da7c GIT binary patch literal 13312 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 H;`RRmo)2{u literal 0 HcmV?d00001 diff --git a/docs/docs/assets/user-setup/github-actions-link.png b/docs/docs/assets/user-setup/github-actions-link.png new file mode 100644 index 0000000000000000000000000000000000000000..c12483b1154d3401614e6183a28b6abb79f68479 GIT binary patch literal 10573 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 Y$d{io+B%#NBM%@esU%S&_9f(h0bhm^6#xJL literal 0 HcmV?d00001 diff --git a/docs/docs/user-setup.md b/docs/docs/user-setup.md index e90bef80..90886dc8 100644 --- a/docs/docs/user-setup.md +++ b/docs/docs/user-setup.md @@ -6,6 +6,7 @@ sidebar_label: Installing ZMK import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; +import Image from '@theme/IdealImage'; Unlike other keyboard firmwares, ZMK Firmware has been built from the ground up to allow users to manage their own keyboard configurations, including keymaps, specific hardware details, etc. all outside of the @@ -41,6 +42,10 @@ The remainder of this guide assumes the following prequisites: 1. You have an active, working [GitHub](https://github.com/) account. 1. You have installed and configured the [`git`](https://git-scm.com/) version control tool. +:::note +If you need to, a quick read of [Learn The Basics Of Git In Under 10 Minutes](https://www.freecodecamp.org/news/learn-the-basics-of-git-in-under-10-minutes-da548267cc91/) will help you get started. +::: + ## GitHub Repo Before running the setup script, you will first need to create a new GitHub repository to host the config. @@ -101,6 +106,18 @@ Keyboard Shield Selection: Pick an keyboard: ``` +### Keymap Customization + +At the next prompt, you have an opportunity to decide if you want the stock keymap file copied in +for further customization: + +``` +Copy in the stock keymap for customization? [Yn]: +``` + +Hit `Enter` or type `yes`/`y` to accept this. If you want to keep the stock keymap, or write a keymap +from scratch, type in `no`/`n`. + ### GitHub Details In order to have your new configuration automatically pushed, and then built using GitHub Actions, enter @@ -108,8 +125,8 @@ some information about your particular GitHub info: ``` GitHub Username (leave empty to skip GitHub repo creation): petejohanson -GitHub Repo Name [zmk-config]: -GitHub Repo [https://github.com/petejohanson/zmk-config.git]: +GitHub Repo Name: zmk-config +GitHub Repo: https://github.com/petejohanson/zmk-config.git ``` Only the GitHub username is required; if you are happy with the defaults offered in the square brackets, you can simply hit `Enter`. @@ -137,11 +154,49 @@ push the initial commit. ::: -## Accessing Built Firmware +## Installing The Firmware + +### Download The Archive Once the setup script is complete and the new user config repository has been pushed, GitHub will automatically run the action to build your keyboard firmware files. You can view the actions by clicking on the "Actions" tab on your GitHub repository. -## Keymap Changes + -TODO: Document how to add your own keymap! +Once you have loaded the Actions tab, select the top build from the list. Once you load it, the right side panel will include +a link to download the `firmware` upload: + + + +Once downloaded, extract the zip and you can verify it should contain one or more `uf2` files, which will be copied to +your keyboard. + +### Installing UF2 Files + +To flash the firmware, first put your board into bootloader mode by double clicking the reset button (either on the MCU board itself, +or the one that is part of your keyboard). The controller should appear in your OS as a new USB storage device. + +Once this happens, copy the correct UF2 file (e.g. left or right if working on a split), and paste it onto the root of that USB mass +storage device. One the flash is complete, the controller should automatically restart, and load your newfly flashed firmware. + +## Customization + +### Configuration Changes + +The setup script creates a `config/<shield>.conf` file that allows you to add additional configuration options to +control what features and options are built into your firmware. Opening that file with your text editor you should see +various config settings that can be commented/uncommented to modify how your firmware is built. + +### Keymap + +Once you have the basic user config completed, you can find the file in `config/<shield>.keymap` and customize from there. +Refer to the [Keymap](/docs/feature/keymaps) documentation to learn more. + +### Publishing + +After making any changes you want, you should commit the changes and then push them to GitHub. That will trigger a new +GitHub Actions job to build your firmware which you can download once it completes. + +:::note +If you need to, a review of [Learn The Basics Of Git In Under 10 Minutes](https://www.freecodecamp.org/news/learn-the-basics-of-git-in-under-10-minutes-da548267cc91/) will help you get these steps right. +::: diff --git a/docs/sidebars.js b/docs/sidebars.js index f6256725..43d4ea7c 100644 --- a/docs/sidebars.js +++ b/docs/sidebars.js @@ -1,6 +1,6 @@ module.exports = { someSidebar: { - "Getting Started": ["intro", "hardware", "user-setup", "faq"], + "Getting Started": ["intro", "hardware", "faq", "user-setup"], Features: [ "feature/keymaps", "feature/displays",