refactor(docs): Move `dev-` documents into `/development`
Aligns to conventions introduced by newer documentation.
This commit is contained in:
innovaker
Pete Johanson
parent
b6e63683d4
commit
532c1987b2
|
|
@ -39,7 +39,7 @@ If you need to, a review of [Learn The Basics Of Git In Under 10 Minutes](https:
|
|||
|
||||
## Building from a local `zmk` fork using `zmk-config`
|
||||
|
||||
[As outlined here](dev-build-flash), firmware comes in the form of .uf2 files, which can be built locally using the command `west build`. Normally,
|
||||
[As outlined here](development/build-flash), firmware comes in the form of .uf2 files, which can be built locally using the command `west build`. Normally,
|
||||
`west build` will default to using the in-tree .keymap and .conf files found in your local copy of the `zmk` repository. However, you can append the command, `-DZMK_CONFIG="C:/the/absolute/path/config"` to `west build` in order to use the contents of your `zmk-config` folder instead of the
|
||||
default keyboard settings.
|
||||
**Notice that this path should point to the folder labelled `config` within your `zmk-config` folder.**
|
||||
|
|
|
|||
|
|
@ -34,7 +34,7 @@ in the `app/boards/${arch}/${board_name}` directory, e.g. `app/boards/arm/planck
|
|||
|
||||
## Pro Micro Compatible Keyboard
|
||||
|
||||
|
||||
|
||||
|
||||
For keyboards that require a (usually Pro Micro compatible) add-on board to operate, the ZMK integration pieces are places
|
||||
in the _shield_ definition for that keyboard, allowing users to
|
||||
|
|
@ -90,7 +90,7 @@ This produces `left` and `right` subfolders under the `build` directory and two
|
|||
|
||||
### Building from `zmk-config` Folder
|
||||
|
||||
Instead of building .uf2 files using the default keymap and config files, you can build directly from your [`zmk-config` folder](user-setup#github-repo) by adding
|
||||
Instead of building .uf2 files using the default keymap and config files, you can build directly from your [`zmk-config` folder](../user-setup#github-repo) by adding
|
||||
`-DZMK_CONFIG="C:/the/absolute/path/config"` to your `west build` command. **Notice that this path should point to the folder labelled `config` within your `zmk-config` folder.**
|
||||
|
||||
For instance, building kyria firmware from a user `myUser`'s `zmk-config` folder on Windows 10 may look something like this:
|
||||
|
|
@ -4,7 +4,7 @@ title: New Keyboard Shield
|
|||
|
||||
import Tabs from '@theme/Tabs';
|
||||
import TabItem from '@theme/TabItem';
|
||||
import KeymapExampleFile from './keymap-example-file.md';
|
||||
import KeymapExampleFile from '../keymap-example-file.md';
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
@ -110,7 +110,7 @@ endif
|
|||
|
||||
## Shield Overlays
|
||||
|
||||
|
||||
|
||||
|
||||
ZMK uses the green color coded pin names to generate devicetree node references. For example, to refer to the node `D0` in the devicetree files, use `&pro_micro_d 0` or to refer to `A1`, use `&pro_micro_a 1`.
|
||||
|
||||
|
|
@ -474,7 +474,7 @@ west flash
|
|||
|
||||
:::note
|
||||
Further testing your keyboard shield without altering the root keymap file can be done with the use of `-DZMK_CONFIG` in your `west build` command,
|
||||
shown [here](dev-build-flash#building-from-zmk-config-folder)
|
||||
shown [here](build-flash#building-from-zmk-config-folder)
|
||||
:::
|
||||
|
||||
## Updating `build.yml`
|
||||
|
|
@ -80,9 +80,9 @@ sudo tio /dev/ttyACM0
|
|||
|
||||
On Windows, you can use [PuTTY](https://www.putty.org/). Once installed, use Device Manager to figure out which COM port your controller is communicating on (listed under 'Ports (COM & LPT)') and specify that as the 'Serial line' in PuTTY.
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
If you already have the Ardunio IDE installed you can also use its built-in Serial Monitor.
|
||||
|
||||
|
|
@ -411,7 +411,7 @@ cd zmk
|
|||
|
||||
Open the `zmk` checkout folder in VS Code. The repository includes a configuration for containerized development, so an alert will pop up:
|
||||
|
||||
|
||||
|
||||
|
||||
Click `Reopen in Container` in order to reopen the VS Code with the running container.
|
||||
|
||||
|
|
@ -449,7 +449,7 @@ This step pulls down quite a bit of tooling. Go grab a cup of coffee, it can tak
|
|||
:::info
|
||||
If you're using Docker, you're done with setup! You must restart the container at this point. The easiest way to do so is to close the VS Code window, verify that the container has stopped in Docker Dashboard, and reopen the container with VS Code.
|
||||
|
||||
Once your container is restarted, proceed to [Building and Flashing](./dev-build-flash.md).
|
||||
Once your container is restarted, proceed to [Building and Flashing](./development/build-flash.md).
|
||||
:::
|
||||
|
||||
#### Export Zephyr™ Core
|
||||
|
|
@ -480,23 +480,23 @@ On Windows, only two environment variables need to be set for ZMK to build prope
|
|||
|
||||
1. Open Start Menu and type 'env' to find the 'Edit the system environment variables' option. Open it.
|
||||
|
||||
|
||||
|
||||
|
||||
2. Click 'Environment Variables...'.
|
||||
|
||||
|
||||
|
||||
|
||||
3. Click "New..." under System variables to create a new system variable.
|
||||
|
||||
|
||||
|
||||
|
||||
4. Set the variable name to 'ZEPHYR_TOOLCHAIN_VARIANT' and value to 'gnuarmemb'. Click OK to save.
|
||||
|
||||
|
||||
|
||||
|
||||
5. Create another variable with variable name 'GNUARMEMB_TOOLCHAIN_PATH' and value set to wherever you installed your toolchain. **Make sure this path does not contain any spaces.** If it does, rename the folder and update here. Click OK to save.
|
||||
|
||||
|
||||
|
||||
|
||||
6. Close Command Prompt and reopen, or run `refreshenv` to apply the changes.
|
||||
|
||||
|
|
@ -3,7 +3,7 @@ title: Tests
|
|||
sidebar_label: Tests
|
||||
---
|
||||
|
||||
Running tests requires [native posix support](./dev-posix-board). Any folder under `/app/tests`
|
||||
Running tests requires [native posix support](posix-board). Any folder under `/app/tests`
|
||||
containing `native_posix.keymap` will be selected when running `./run-test.sh all`.
|
||||
|
||||
## Creating a New Test Set
|
||||
|
|
@ -41,4 +41,4 @@ Here, the left encoder is configured to control volume up and down while the rig
|
|||
|
||||
## Adding Encoder Support
|
||||
|
||||
See the [New Keyboard Shield](/docs/dev-guide-new-shield#encoders) documentation for how to add or modify additional encoders to your shield.
|
||||
See the [New Keyboard Shield](../development/guide-new-shield#encoders) documentation for how to add or modify additional encoders to your shield.
|
||||
|
|
|
|||
|
|
@ -47,4 +47,4 @@ Until detailed documentation is available, feel free to ask questions about how
|
|||
|
||||
## Contributing
|
||||
|
||||
If you'd like to add support for a new keyboard shield, head over to the [New Keyboard Shield](/docs/dev-guide-new-shield) documentation.
|
||||
If you'd like to add support for a new keyboard shield, head over to the [New Keyboard Shield](development/guide-new-shield) documentation.
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@ Variations of the warnings shown below occur when flashing the `<firmware>.uf2`
|
|||
### CMake Error
|
||||
|
||||
An error along the lines of `CMake Error at (zmk directory)/zephyr/cmake/generic_toolchain.cmake:64 (include): include could not find load file:` during firmware compilation indicates that the Zephyr Environment Variables are not properly defined.
|
||||
For more information, click [here](../docs/dev-setup#environment-variables).
|
||||
For more information, click [here](../docs/development/setup#environment-variables).
|
||||
|
||||
### dtlib.DTError
|
||||
|
||||
|
|
|
|||
|
|
@ -105,7 +105,7 @@ Pick an MCU board:
|
|||
:::note
|
||||
If you are building firmware for a new keyboard shield that is not included in the built-in
|
||||
list of shields, you can choose any shield from the list that is similar to yours to generate the repository,
|
||||
and edit / add necessary files according to the [guide for adding new keyboard shield](./dev-guide-new-shield.md).
|
||||
and edit / add necessary files according to the [guide for adding new keyboard shield](./development/guide-new-shield).
|
||||
:::
|
||||
|
||||
When prompted, enter the number for the corresponding keyboard shield you would like to target:
|
||||
|
|
|
|||
|
|
@ -45,7 +45,7 @@ module.exports = {
|
|||
},
|
||||
{
|
||||
label: "Development",
|
||||
to: "docs/dev-setup/",
|
||||
to: "docs/development/setup/",
|
||||
},
|
||||
],
|
||||
},
|
||||
|
|
|
|||
|
|
@ -37,13 +37,16 @@ module.exports = {
|
|||
"codes/power",
|
||||
],
|
||||
Development: [
|
||||
"dev-clean-room",
|
||||
"dev-setup",
|
||||
"dev-build-flash",
|
||||
"dev-boards-shields-keymaps",
|
||||
"dev-posix-board",
|
||||
"dev-tests",
|
||||
"development/clean-room",
|
||||
"development/setup",
|
||||
"development/build-flash",
|
||||
"development/boards-shields-keymaps",
|
||||
"development/posix-board",
|
||||
"development/tests",
|
||||
],
|
||||
"Dev Guides": [
|
||||
"development/guide-new-shield",
|
||||
"development/guide-usb-logging",
|
||||
],
|
||||
"Dev Guides": ["dev-guide-new-shield", "dev-guide-usb-logging"],
|
||||
},
|
||||
};
|
||||
|
|
|
|||
Loading…
Reference in New Issue