diff --git a/docs/docs/development/local-toolchain/setup/native.mdx b/docs/docs/development/local-toolchain/setup/native.mdx index ee552c5b3..822359f09 100644 --- a/docs/docs/development/local-toolchain/setup/native.mdx +++ b/docs/docs/development/local-toolchain/setup/native.mdx @@ -203,6 +203,12 @@ west zephyr-export pip install -r zephyr/scripts/requirements-base.txt ``` +If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies: + +```sh +pip install -r zephyr/scripts/requirements-extra.txt +``` + @@ -293,6 +299,12 @@ west zephyr-export ```sh pip3 install --user -r zephyr/scripts/requirements-base.txt +``` + +If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies: + +```sh +pip3 install -r zephyr/scripts/requirements-extra.txt ``` @@ -303,6 +315,12 @@ pip3 install --user -r zephyr/scripts/requirements-base.txt ```sh pip install -r zephyr/scripts/requirements-base.txt +``` + +If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies: + +```sh +pip install -r zephyr/scripts/requirements-extra.txt ``` @@ -312,6 +330,12 @@ pip install -r zephyr/scripts/requirements-base.txt ```sh pip3 install -r zephyr/scripts/requirements-base.txt +``` + +If you are going to build firmware with [ZMK Studio](../../../features/studio.md), also install `requirements-extra.txt` dependencies: + +```sh +pip3 install -r zephyr/scripts/requirements-extra.txt ``` diff --git a/docs/docs/features/studio.md b/docs/docs/features/studio.md index 3ef8d0d35..8b9556449 100644 --- a/docs/docs/features/studio.md +++ b/docs/docs/features/studio.md @@ -64,6 +64,13 @@ To use ZMK Studio over USB, you need permission to access the USB serial port. T ::: +:::note + +If you are connected to the computer over both USB and BLE endpoints, you should set the keyboard output to the same endpoint that you connect to ZMK Studio using. +For example, if you are connecting to ZMK Studio over USB, ensure that USB output is selected by invoking the `&out OUT_USB` [behavior](../keymaps/behaviors/outputs.md). + +::: + ## Building Building for ZMK Studio involves two main additional items.