update

Author: te9no

docs/src/content/docs/guides/05.firmware.md

@@ -44,7 +44,7 @@ title: MeKaBuファームウェア取り扱いガイド
 │  
 ├─.github  
 │  └─workflows  
-│          build-nix.yml・・・nix版build.yml  
+│          build-nix.yml・・・nix版build.yml→⚠️Outdated  
 │          build.yml・・・通常のbuild.yml  
 │          draw-keymap.yml・・・キーマップ画像ファイル生成用  
 │  
@@ -73,8 +73,6 @@ title: MeKaBuファームウェア取り扱いガイド
 │              MKB_L_TPD.conf・・・トラックパッドモジュールconfig  
 │              MKB_L_TPD.overlay・・・トラックパッドモジュールdevice tree  
 │              MKB_pinctrl_L.dtsi・・・OLED用ピン配置設定  
-│              MKB_L_JOY.conf・・・アナログスティック＆エンコーダモジュールconfig  
-│              MKB_L_JOY.overlay・・・アナログスティック＆エンコーダモジュールdevice tree  
 
 ～以下右手～  
 │              MKB_pinctrl_R.dtsi  
@@ -84,17 +82,28 @@ title: MeKaBuファームウェア取り扱いガイド
 │              MKB_R_ENC.overlay  
 │              MKB_R_JOY.conf  
 │              MKB_R_JOY.overlay  
+│              MKB_R_KEY.conf  
+│              MKB_R_KEY.overlay  
 │              MKB_R_RZT.conf  
 │              MKB_R_RZT.overlay  
 │              MKB_R_TB.conf  
-│              MKB_R_TB.overlay  
+│              MKB_R_TB.overlay 
+│              MKB_R_TBv3.conf  ・・・（旧開発版）トラックボールモジュールconfig
+│              MKB_R_TBv3.overlay  ・・・（旧開発版）トラックボールモジュールdevice tree  
+│              MKB_R_TPD.conf  
+│              MKB_R_TPD.overlay 
 │  
 ├─config  
 │      kle.json・・・kle用json  
 │      MKB.json・・・keymap drawer用json  
 **│      MKB.keymap・・・キーマップ**  
 │      west.yml・・・module定義  
 │  
+├─snippets  ・・・snippet（overlayの一種）  
+│  └─Default  ・・・snippet名  
+│             Default.overlay  ・・・左手input-listener用overlay  
+│             snippet.yml    ・・・左手input-listener用overlay用snippet定義  
+│  
 ├─firmware・・・ファームウェア置き場  
 │  ├─main・・・ブランチ名  
 │  │  └─firmware  
@@ -105,7 +114,8 @@ title: MeKaBuファームウェア取り扱いガイド
 │  │          MKB_R_MODULE_ENC.uf2  
 │  │          MKB_R_MODULE_JOY.uf2  
 │  │          MKB_R_MODULE_RZT.uf2  
-│  │          MKB_R_MODULE_TB.uf2  
+│  │          MKB_R_MODULE_TBv3.uf2    ・・・（旧開発版）右手トラックボールモジュール用⚠️通常は使用しません
+│  │          MKB_R_MODULE_TBv4.uf2  
 │  │          settings_reset-seeeduino_xiao_ble-zmk.uf2  
 │  │・・・  
 │  
@@ -115,15 +125,25 @@ title: MeKaBuファームウェア取り扱いガイド
 │      MKB.yaml  
 │  
 └─zephyr・・・だいじなやつ  
-module.yml  
+    module.yml  
 
 # ファームウェアの書き込み方法
 
 [https://zmk.dev/docs/user-setup#flashing-uf2-files](https://zmk.dev/docs/user-setup#flashing-uf2-files)
 
+例：標準構成（左手エンコーダ、右手トラックボール）の場合  
+→左手側に「MKB_L_MODULE_ENC.uf2」、右手側に「MKB_R_MODULE_TBv4.uf2」（⚠️MKB_R_MODULE_TBv3.uf2ではありません）を書き込む。  
+
+例：左手アナログスティック、右手トラックボールの場合  
+→左手側に「MKB_L_MODULE_JOY.uf2」、右手側に「MKB_R_MODULE_TBv4.uf2」を書き込む。  
+
+例：左手トラックボール、右手トラックボールの場合  
+→左手側に「MKB_L_MODULE_TB.uf2」、右手側に「MKB_R_MODULE_TBv4.uf2」を書き込む。  
+
 # キーマップの更新方法
 
 リポジトリをフォークして編集するか、[Keymap Editor](https://nickcoutsos.github.io/keymap-editor/)を使用してください。
+[ZMK Studio](https://zmk.studio//)や[DYA Studio](https://studio.dya.cormoran.works/)にも対応しています。
 
 # モジュールとファームウェアの交換方法
 
@@ -134,18 +154,39 @@ module.yml
 - ボトムケースを取り付ける
 - PCと接続して、新しいモジュールに対応するファームウェアを書き込む
 
-# Nixビルドの無効化＆標準ビルドの有効化
-
-/zmk-config-MKB/.github/workflows/build.ymlを編集
-
-![image.png](firmware/image.png)
-
-![image.png](firmware/image .png)
-
-不要であれば/zmk-config-MKB/.github/workflows/build-nix.ymlを削除
-
 # FAQ
 
-Q.AMLをOFFにする方法を教えていただけないでしょうか
+Q.AMLをONにする方法を教えていただけないでしょうか
+DYA StudioでTemporary Layerを指定
+![alt text](./firmware/AML.png)
+
+Q.トラックパッドモジュールの上下を反転したい
+https://github.com/te9no/zmk-config-MKB2/blob/main/snippets/Default/Default.overlay#L67-L72
+```dsti
+input-processors = <&zip_xy_transform (INPUT_TRANSFORM_XY_SWAP)>,
+<&zip_xy_transform INPUT_TRANSFORM_Y_INVERT>, 
+<&scroll_runtime_input_processor>;
+
+scroller {
+  layers = <5>;
+  input-processors = <&zip_xy_transform (INPUT_TRANSFORM_XY_SWAP)>,
+    <&zip_xy_transform INPUT_TRANSFORM_Y_INVERT>, 
+    <&zip_xy_to_scroll_mapper>, 
+    <&scroll_runtime_input_processor>;
+};
+```
 
-MKB_L_Base.overlayの zip_temp_layerをOFF（コメントアウトか消去）にする
+左右も反転したいなら
+```dsti
+input-processors = <&zip_xy_transform (INPUT_TRANSFORM_XY_SWAP)>,
+<&zip_xy_transform (INPUT_TRANSFORM_X_INVERT | INPUT_TRANSFORM_Y_INVERT)>, 
+<&scroll_runtime_input_processor>;
+
+scroller {
+  layers = <5>;
+  input-processors = <&zip_xy_transform (INPUT_TRANSFORM_XY_SWAP)>,
+    <&zip_xy_transform (INPUT_TRANSFORM_X_INVERT | INPUT_TRANSFORM_Y_INVERT)>, 
+    <&zip_xy_to_scroll_mapper>, 
+    <&scroll_runtime_input_processor>;
+};
+```