> 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 ## Toucan FAQ ### 液晶・表示について #### Q. 液晶に緑のラインが入っています。不具合でしょうか？ A. 不具合ではありません。 緑のラインは、保護フィルムが貼られていることを識別するために意図的に入っているものです。液晶本体の表示不良ではありません。 保護フィルムを剥がすと、緑のラインは消えます。液晶自体の不具合ではありませんので、安心して組み立て作業を進めてください。 *** ### キー入力・スイッチについて #### Q. ホットスワップソケットにキースイッチを挿入した後、一部のキーが反応しません。 A. 以下の原因が考えられます。 * キースイッチの足（ピン）が曲がっている * ホットスワップソケットのはんだ付け不良 * ホットスワップソケット部分のパッド剥離 * ダイオードのはんだ付け不良 まずはキースイッチのピンが曲がっていないか確認してください。問題がない場合は、ホットスワップソケットやダイオード周辺のはんだ付け状態をご確認ください。 *** #### Q. 右手側のキーが反応しませんが、タッチパッドは動作しています。 A. タッチパッドが動作している場合でも、キー入力部分のみが正しく動作していない可能性があります。 まず、左右を同時にUSBケーブルでPCに接続した状態で、キー入力が反応するか確認してください。 左右同時にUSB給電することで、以下を切り分けることができます。 * 初期設定 * ペアリング状態 * 電源供給状態 それでも改善しない場合は、以下の箇所をご確認ください。 * マイコン周辺のはんだ付け状態 * コントローラー周辺のはんだ付け状態 確認が難しい場合は、はんだ付け部分の写真を添えて、サポート（）までお問い合わせください。 *** ### キーキャップについて #### Q. SMOLO low profile keycapはToucanで使用できますか？ A. 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) *** #### Q. 遊舎工房などで販売されている狭ピッチ用キーキャップはToucanで使用できますか？ A. 狭ピッチ対応として設計されたキーキャップであれば、Toucanで使用可能です。 Toucanは狭ピッチ専用設計のキーボードです。そのため、以下の条件を満たすキーキャップであれば問題なくご使用いただけます。 使用可能なキーキャップの条件： * 狭ピッチ向けに設計されていること * Choc系／ロープロファイルスイッチ向けであること * キー同士が干渉しない寸法であること 遊舎工房などで販売されているキーキャップでも、「狭ピッチ対応」と明記されている製品であれば、Toucanで使用可能です。 ただし、商品説明に「標準ピッチ」「MX用」などの記載がある場合は、Toucanでは非対応の可能性が高いためご注意ください。 サイズや対応可否が不明な場合は、購入前にサポート（）までお問い合わせください。 *** ### キーマップ・ファームウェアについて #### Q. 40%キーボードに最適なキーマップは何ですか？ A. キーマップをカスタマイズする方法のひとつとして、既存のキーマップを参考にするのがおすすめです。 以下のリンクが参考になります。 * Miryoku\ * Home Row Mods\ * KeymapDB\ *** #### Q. キーマップはどこで編集できますか？ A. ToucanはZMKを使用しています。 キーマップはGitHub上のZMKファームウェア用リポジトリで管理・編集し、ファームウェアとしてビルドします。 また、ZMK StudioおよびZMKキーマップエディタも使用できます。 *** #### Q. 左手側／右手側用のUF2ファームウェアはどこにありますか？ A. ToucanのUF2ファームウェアは、以下のGitBookページからダウンロードできます。 クイックスタート（ZMKファームウェア）\ このページ内に、左手側用・右手側用それぞれのUF2ファイルが用意されています。 UF2ファイル名に、以下のような表記があります。 * 左手側用：`left` が含まれているもの * 右手側用：`right` が含まれているもの それぞれ対応する側の基板をUSB接続し、マウントされたドライブに該当するUF2ファイルをコピーしてください。 *** #### Q. Windowsでファームウェアを書き込むとエラーが出たり、USBドライブが消えたりします。 A. Windows環境でSeeed Studio XIAO nRF52840 PlusにZMKファームウェア（UF2）を書き込む際、以下の挙動が発生することがあります。 * 「デバイスが存在しません」などのエラーが表示される * 書き込み後にUSBストレージがPCから消える * UF2ファイルがドライブ上に表示されない * XIAOのLEDが一瞬点灯したあと消灯する これらの挙動は、多くの場合正常です。 ZMKファームウェアは、書き込みが完了するとUSBストレージとしては認識されなくなります。 書き込みが成功しているかは、以下をご確認ください。 * XIAOのLEDの点灯パターンが変わっている * キー入力に反応し、PC上で文字入力ができる これらが確認できる場合、ファームウェアは正しく書き込まれています。エラー表示やUSBドライブが見えなくなった場合でも、必ずしも書き込み失敗を意味するものではありません。 *** #### Q. キーマップ変更後にZMK Studioのロックを解除できなくなりました。 A. 設定リセット用ファームウェアを一度書き込むことで復旧できます。 対処方法： 1. `settings_reset-seeeduino_xiao_ble-zmk.uf2` をフラッシュします。 2. その後、デフォルトのZMKファームウェアを書き込みます。 3. `&studio_unlock` キーが復元されます。 注意：この操作を行うと、以下の設定はすべてリセット（消去）されます。 * 変更したキーマップ * Bluetoothプロファイル設定 ファームウェアのダウンロード先：\ ※リンクをここに挿入してください。 *** #### Q. ZMK Studioをより使いやすくする方法はありますか？ A. `CONFIG_ZMK_STUDIO_LOCKING` を `n` に設定することで、ZMK Studioのロック／アンロック操作を簡略化できる場合があります。 *** ### トラックパッド・マウス操作について #### Q. マウススクロールやジェスチャー操作は使えますか？ A. デフォルトのファームウェアでは、マウススクロールに対応しています。 より高度なジェスチャー操作を利用したい場合は、カスタムファームウェアをビルドする必要があります。 *** #### Q. トラックパッドのスクロール速度は変更できますか？ A. はい、変更できます。 ただし、ZMK StudioやZMKキーマップエディタからは変更できません。スクロール速度を変更するには、ZMKファームウェア内の設定ファイルを直接編集する必要があります。 編集するファイル： `boards/shields/toucan/toucan.dtsi` 現在のデフォルト設定： `&zip_scroll_scaler 1 5` これは、スクロール速度を1/5倍に設定しています。 さらにスクロールを遅くしたい場合の例： `&zip_scroll_scaler 1 8` この場合、スクロール速度は1/8倍になります。 数値を調整することで、ご自身の好みに合わせてスクロール速度を変更できます。 *** #### Q. タッチパッドで左クリック・右クリックはできますか？ A. デフォルトのファームウェアでは、左クリックに対応しています。 右クリックは、ZMKのレイヤーに「Mouse Key Press」→「MB2」を割り当てることで利用可能です。 *** #### Q. オートマウスレイヤーは使えますか？ A. 現在、Cirqueトラックパッド用ドライバではオートマウスレイヤーはサポートされていません。 そのため、マウス操作用のレイヤーは手動で切り替えてご利用ください。 将来的にCirqueトラックパッドの利用が増えた場合、オートマウスレイヤーがサポートされる可能性はありますが、現時点では未定です。 *** ### Bluetooth接続について #### Q. Mac（Apple Silicon）でToucanが表示されますが、ペアリングが完了しません。 A. macOS、特にApple Silicon Macにおいて、Toucan KeyboardがBluetoothデバイス一覧には表示されるものの、「接続」をクリックしてもペアリングが完了しない場合があります。 この場合、以下の手順をお試しください。 1. macOSのBluetooth設定を開きます。 2. Toucanに関連するデバイスが表示されている場合は、すべて削除します。 3. 左右それぞれにリセット用ファームウェアを書き込みます。 4. その後、左右それぞれに通常のZMKファームウェアを書き直します。 この手順により、Bluetoothのペアリング情報が初期化され、接続できるようになる場合があります。 また、BT1がすでに他の端末とペアリングされている場合、BT2〜BT5に切り替えることで接続できる場合があります。 BT2〜BT5を試しても改善しない場合は、上記のリセット→再書き込み手順をお試しください。 *** ### 片側が動作しない場合 #### Q. 片側（右手側）が動作しません／トラックパッドが反応しません。 A. 以下の手順で切り分けを行ってください。 1. **USB給電での動作確認**\ 左右それぞれをUSBケーブルでPCに直接接続し、各ユニットが起動・動作するかを確認してください。 2. **はんだ付け状態の確認**\ 以下の箇所について、はんだ付けに不備がないかご確認ください。 * コントローラー周辺のはんだ付け * バッテリーコネクタ部分のはんだ付け 目視で判断が難しい場合は、該当箇所が分かる写真をサポートまでお送りください。 3. **ファームウェアの再書き込み**\ 片側が反応しない場合、ZMKの左右ペアリングが正しく行われていないケースがあります。 以下の手順をお試しください。 * 左右両方にリセット用ファームウェアを書き込む * その後、左右それぞれに通常のZMKファームウェアを再書き込みする この手順により、以下のような問題が解消する場合があります。 * 片側が認識されない * トラックパッドが反応しない 4. トラックパッド（FPCケーブル）の確認\ FPCケーブルの両端の向きが正しいか確認し、奥までしっかり挿入されていることを確認してください。 5. 上記を試しても改善しない場合\ 以下を添えて、サポート（）までお問い合わせください。 * 症状の詳細 * 使用しているPC環境（OSなど） * 該当箇所の写真（バッテリーコネクタ部分を含む） 状況に応じて、個別にご案内いたします。 *** ### サイズ・重量について #### Q. 重さとサイズはどれくらいですか？ A. 下記画像をご参照ください。
*** ### アクセサリー・ケースについて #### Q. Toucan用の収納バッグは販売されていますか？ A. 現時点では、Toucan専用の純正収納バッグは販売していません。 ただし、持ち運び時の保護を目的として、Toucanに対応するバッグ／ケース（外部製品を含む）の紹介ページを近日中に追加予定です。 持ち運び用途については、こちらでフォローできるよう準備しています。 *** #### Q. Toucan用の3DPケースデータは公開されますか？ A. 3DPケース制作に使用できるPCBアウトラインデータは公開予定です。 一方で、3DPケースデータ全体（3Dデータ等）の公開については、現在慎重に検討している段階です。 これは、近年AliExpress等における製品写真や設計データの無断使用・著作権トラブルが増えている状況を踏まえた判断です。 そのため、公開時期や公開範囲は現時点では未定です。 *** ### カスタム・修理について #### Q. コントローラー（Seeed Studio XIAO nRF52840 Plus）とPCBのはんだを綺麗に取り外す方法はありますか？ A. PCBからコントローラーを取り外したい場合は、MINIWARE MHP50やFnirsi HT-P1のようなミニヒートプレートの使用をおすすめしています。 無理にこて先だけで取り外そうとすると、PCBのパッド剥離や部品破損につながる可能性があります。作業に不安がある場合は、無理に取り外さず、経験のある方にご相談ください。 *** #### Q. Toucanキーボードのタッチパッドとディスプレイを左右入れ替えできますか？ A. 現在、タッチパッドやディスプレイ位置の変更などのカスタム注文は承っておりません。 なお、ご自身でカスタムされる場合、ToucanのPCBは左右反転可能な設計となっています。 ただし、ケースデータおよびファームウェアデータの提供は行っておりませんので、あらかじめご了承ください。 *** ## お問い合わせについて 不明点や環境依存の問題については、ケースごとに原因が異なるため、一概には断定できません。 問題が解決しない場合は、以下の情報を添えてサポートまでお問い合わせください。 * 症状の詳細 * 使用しているPC環境（OSなど） * 該当箇所の写真 * 書き込んだファームウェアの種類 サポート： ***