> For the complete documentation index, see [llms.txt](https://beekeeb-japan.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://beekeeb-japan.gitbook.io/docs/toucan-keyboard/faq.md). # FAQ ### 液晶に緑のラインが入っていますが、不具合でしょうか？ 不具合ではありません。\ 液晶に見える緑のラインは、液晶表面に貼られている保護フィルム上の目印です。 #### 緑のラインについて * 緑のラインは、保護フィルムが貼られていることを識別するために意図的に入れているものです * 液晶本体の表示不良ではありません * 保護フィルムを剥がすと、緑のラインは消えます * 表示や動作には影響ありません そのため、液晶自体の不具合ではなく、\ 安心して組み立て作業を進めていただいて問題ありません。 ### ホットスワップソケットにキースイッチを挿入した後、一部のキーが反応しません。 考えられる原因は以下の通りです。 * キースイッチの足（ピン）が曲がっている * ホットスワップソケットのはんだ付け不良、またはパッドの剥離 * ダイオードのはんだ付け不良 ### 40%キーボードに最適なキーマップは何ですか？ キーマップをカスタマイズする方法のひとつとして、既存のキーマップを参考にするのがおすすめです。 以下のリンクが参考になります。 * * (QMK) * ### 重さとサイズはどれぐらいですか？ 下記画像を参照ください。
### **マウススクロールやジェスチャー操作は使えますか？** デフォルトのファームウェアでは、マウススクロールに対応しています。\ より高度なジェスチャー操作を利用したい場合は、カスタムファームウェアをビルドする必要があります。 ### トラックパッドのスクロール速度は変更できますか？ はい、変更できます。\ ただし、ZMK StudioやZMKキーマップエディタからは変更できません。 スクロール速度を変更するには、ZMK ファームウェア内の設定ファイルを直接編集する必要があります。 #### 設定方法 以下のファイルを編集してください。 ``` boards/shields/toucan/toucan.dtsi ``` 現在のデフォルト設定は以下のとおりです。 ``` &zip_scroll_scaler 1 5 ``` これは、スクロール速度を1/5倍に設定しています。 #### 例：さらにスクロールを遅くしたい場合 ``` &zip_scroll_scaler 1 8 ``` この場合、スクロール速度は1/8倍になります。 数値を調整することで、\ ご自身の好みに合わせてスクロール速度を変更できます。 ### SMOLO low profile keycapはToucanで使用できますか？ SMOLO low profile keycap（標準ピッチ用）はToucanでは使用できません。 Toucanは狭ピッチ専用設計のキーボードとなっており、\ 標準ピッチ向けに設計されたキーキャップ（SMOLOなど）を装着すると、キー同士が干渉し、正常に使用することができません。 Toucanでは、狭ピッチ対応のキーキャップのみ対応しておりますので、ご購入・ご使用の際はご注意ください。 [Choc v1 に対応するキーキャップ （狭ピッチ）](https://shop.beekeeb.jp/collections/%E3%82%AD%E3%83%BC%E3%82%AD%E3%83%A3%E3%83%83%E3%83%97-choc-v1-%E7%8B%AD%E3%81%84%E3%83%94%E3%83%83%E3%83%81)\ [Choc v2に対応するキーキャップ（ 狭ピッチ）](https://shop.beekeeb.jp/collections/%E3%82%AD%E3%83%BC%E3%82%AD%E3%83%A3%E3%83%83%E3%83%97-mx-%E3%83%AD%E3%83%BC%E3%83%97%E3%83%AD%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB-%E7%8B%AD%E3%81%84%E3%83%94%E3%83%83%E3%83%81) ### 遊舎工房などで販売されている狭ピッチ用キーキャップはToucanで使用できますか？ 狭ピッチ対応として設計されたキーキャップであれば、Toucanで使用可能です。 Toucanは狭ピッチ専用設計のキーボードです。\ そのため、以下の条件を満たすキーキャップであれば問題なくご使用いただけます。 #### 使用可能なキーキャップの条件 * 狭ピッチ向けに設計されていること * Choc 系／ロープロファイルスイッチ向けで、\ キー同士が干渉しない寸法であること 遊舎工房などで販売されているキーキャップでも、\ 狭ピッチ対応であることが明記されている製品であれば、Toucanで使用可能です。 #### 注意点 * 標準ピッチ向けキーキャップ（SMOLO など）は使用できません。 * 商品説明に「標準ピッチ」「MX用」などの記載がある場合は、Toucanでは非対応の可能性が高いです。 サイズや対応可否が不明な場合は、\ 購入前にサポート（）までお問い合わせください。 ### キーマップはどこで編集できますか？ ToucanはZMKを使用しています。\ キーマップは以下のリポジトリで管理・編集し、ZMKファームウェアとしてビルドします。\ また、ZMK StudioおよびZMKキーマップエディタを使用できます。 {% embed url="" %} ### タッチパッドで左クリック・右クリックはできますか？ デフォルトのファームウェアでは、左クリックに対応しています。\ 右クリックは、ZMK のレイヤーに「Mouse Key Press」→「MB2」を割り当てることで利用可能です。 ### オートマウスレイヤーは使えますか？ 現在、Cirqueトラックパッド用ドライバではオートマウスレイヤーはサポートされていません。\ そのため、マウス操作用のレイヤーは手動で切り替えてご利用ください。 将来的にCirqueトラックパッドの利用が増えた場合、\ オートマウスレイヤーがサポートされる可能性はありますが、現時点では未定です。 ### キーマップ変更後にZMK Studioが解除できなくなりました。 設定リセット用ファームウェアを一度書き込むことで復旧できます。 #### 【対処方法】 1. `settings_reset-seeeduino_xiao_ble-zmk.uf2` をフラッシュします。 2. その後、デフォルトのZMKファームウェアを書き込むことで\ `&studio_unlock` キーが復元されます。 ⚠この操作を行うと、 * 変更したキーマップ * Bluetooth プロファイル設定 はすべてリセット（消去）されます。 #### ファームウェアのダウンロード先 ⬇️ {% content-ref url="/pages/I9hlkhXIJ12IFcCsglzR" %} [ZMK ファームウェア](/docs/toucan-keyboard/zmk-fmuwea.md) {% endcontent-ref %} ### Mac（Apple Silicon）でToucanが表示されるが、ペアリングが完了しません macOS（特にApple Silicon Mac）において、\ Toucan KeyboardがBluetoothデバイス一覧には表示されるものの、\ 「接続」をクリックしてもペアリングが完了しない場合があります。 この場合、以下の手順をお試しください。 #### 【対処方法】 1. macOSのBluetooth設定を開き、Toucanに関連するデバイスが表示されている場合はすべて削除してください。 2. 左右それぞれにリセット用ファームウェアを書き込みます。 3. その後、左右それぞれに通常のZMKファームウェアを書き直してください。 この手順により、\ Bluetoothのペアリング情報が初期化され、接続できるようになるケースがあります。 BT1 がすでに他の端末とペアリングされている場合、BT2〜BT5 に切り替えることで接続できる場合があります。ただし、BT2〜BT5を試しても改善しない場合は、上記のリセット→再書き込み手順が有効です。 ### ZMK Studioをより使いやすくする方法はありますか？ `CONFIG_ZMK_STUDIO_LOCKING` を `n` に設定することで、\ ZMK Studioのロック／アンロック操作を簡略化できる場合があります。 ### 片側（右手側）が動作しません／トラックパッドが反応しません 以下の手順で切り分けを行ってください。 #### 1. USB給電での動作確認（左右をUSBで接続して確認） 左右合わせて、USBケーブルでPCに直接接続し、\ 各ユニットが起動・動作するかを確認してください。 #### 2. はんだ付け状態の確認 以下の箇所について、はんだ付けに不備がないかご確認ください。 * コントローラー周辺のはんだ付け * バッテリーコネクタ部分のはんだ付け 目視で判断が難しい場合は、\ 該当箇所が分かる写真をサポートまでお送りください。 #### 3. ファームウェアの再書き込み（重要） 片側が反応しない場合、\ ZMKの左右ペアリングが正しく行われていないケースがあります。 以下の手順をお試しください。 1. 左右両方にリセット用ファームウェアを書き込む 2. その後、左右それぞれに通常のZMKファームウェアを再書き込みする この手順により、 * 片側が認識されない * トラックパッドが反応しない といった問題が解消するケースがあります。 #### 4. トラックパッド（FPCケーブル）について FPCケーブルの両端の向きが正しいか確認し、\ 奥までしっかり挿入されていることを確認してください。 #### 5. 上記を試しても改善しない場合 上記すべてを確認しても問題が解消しない場合は、\ 以下を添えてサポート（）までご連絡ください。 * 症状の詳細 * 使用しているPC環境（OSなど） * 該当箇所の写真（バッテリーコネクタ含む） 状況に応じて、個別にご案内いたします。 ### 右手側のキーが反応しませんが、タッチパッドは動作しています。 右手側のキーが反応しない場合でも、\ タッチパッドが動作している場合は、故障ではない可能性があります。 まず、以下をご確認ください。 #### 確認手順 * 左右を同時にUSBケーブルでPCに接続した状態で、キー入力が反応するか確認してください 左右同時にUSB給電することで、 * 初期設定 * ペアリング状態 * 電源供給状態 を正しく切り分けることができます。 それでも改善しない場合 * マイコン周辺のはんだ付け状態 * コントローラー周辺のはんだ付け をご確認ください。 確認が難しい場合は、状況に応じて個別にご案内いたしますので、\ はんだ付け部分の写真をサポート（）までお送りください。 ### 左手側／右手側用のUF2ファームウェアはどこにありますか？ ToucanのUF2ファームウェアは、以下のGitBookページからダウンロードできます。 * クイックスタート（ZMKファームウェア）\ このページ内に、左手側用・右手側用それぞれのUF2ファイルが用意されています。 #### 左手側／右手側の見分け方 UF2ファイル名に、以下のような表記があります。 * 左手側用：`left`が含まれているもの * 右手側用：`right`が含まれているもの それぞれ対応する側の基板をUSB接続し、\ マウントされたドライブに該当するUF2ファイルをコピーしてください。 ### Windowsでファームウェアを書き込むとエラーが出たり、USBドライブが消えます。 Windows環境でSeeed XIAO nRF52840 Plusに\ ZMKファームウェア（UF2）を書き込む際、以下の挙動が発生することがあります。 * 「デバイスが存在しません」などのエラーが表示される * 書き込み後にUSBストレージがPCから消える * UF2ファイルがドライブ上に表示されない * XIAOのLED が一瞬点灯（例：緑 → 赤）したあと消灯する これらの挙動は、多くの場合正常です。 ZMKファームウェアは、書き込みが完了するとUSBストレージとしては認識されなくなります。 #### 書き込みが成功しているかの確認方法 以下を確認してください。 * XIAOのLEDが点灯パターンを変えている * キー入力に反応し、PC上で文字入力ができる これらが確認できる場合、ファームウェアは正しく書き込まれています。 エラー表示やファイルが見えなくなった場合でも、\ 必ずしも書き込み失敗を意味するものではありません。 ### Toucan 用の収納バッグは販売されていますか？ 現時点では、Toucan専用の純正収納バッグは販売していません。 ただし、持ち運び時の保護を目的として、\ Toucanに対応するバッグ／ケース（外部製品含む）の紹介ページを近日中に追加予定です。\ 持ち運び用途については、こちらでフォローできるよう準備しています。 ### Toucan 用の 3DP ケースデータは公開されますか？ 3DPケース制作用のPCBアウトラインデータは公開予定です。 一方で、\ 3DPケースデータ全体（3D データ等）の公開については、現在慎重に検討している段階です。 これは、近年AliExpress等における\ 製品写真や設計データの無断使用・著作権トラブルが増えている状況を踏まえた判断となります。 そのため、公開時期や公開範囲は現時点では未定です。 ### コントローラー（seeed studio nRF52840 XIAO plus）とPCBのハンダを綺麗に取り外す方法はありますか？ PCBからコントローラーを取り外したい場合、MINIWARE MHP50 や Fnirsi HT-P1 のようなミニヒートプレートのご使用をおすすめしております。 ### Toucanキーボードのタッチパッドとディスプレイを左右入れ替えできますか？ 現在、タッチパッドやディスプレイ位置の変更などのカスタム注文は承っておりません。 なお、ご自身でカスタムされる場合、ToucanのPCBは左右反転可能な設計となっております。 ただし、ケースデータおよびファームウェアデータの提供は行っておりませんので、あらかじめご了承ください。 ※不明点や環境依存の問題については、ケースごとに異なるため一概には断定できません。問題が解決しない場合は、サポート（）までお問い合わせください。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://beekeeb-japan.gitbook.io/docs/toucan-keyboard/faq.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.