{"id":18862706,"url":"https://github.com/zk-phi/1x2x3-keyboard","last_synced_at":"2026-02-24T09:02:55.970Z","repository":{"id":152679585,"uuid":"168316600","full_name":"zk-phi/1x2x3-keyboard","owner":"zk-phi","description":"DIY keyboard for everyone","archived":false,"fork":false,"pushed_at":"2023-07-12T07:48:08.000Z","size":135,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-02T17:42:06.975Z","etag":null,"topics":["keyboard"],"latest_commit_sha":null,"homepage":"","language":"OpenSCAD","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zk-phi.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-30T09:35:13.000Z","updated_at":"2025-02-22T19:36:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"28ee937a-53d1-4b25-87d4-bfaf4b7b39ff","html_url":"https://github.com/zk-phi/1x2x3-keyboard","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/zk-phi/1x2x3-keyboard","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2F1x2x3-keyboard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2F1x2x3-keyboard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2F1x2x3-keyboard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2F1x2x3-keyboard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zk-phi","download_url":"https://codeload.github.com/zk-phi/1x2x3-keyboard/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zk-phi%2F1x2x3-keyboard/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29777607,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T04:54:30.205Z","status":"ssl_error","status_checked_at":"2026-02-24T04:53:58.628Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["keyboard"],"created_at":"2024-11-08T04:35:32.940Z","updated_at":"2026-02-24T09:02:50.960Z","avatar_url":"https://github.com/zk-phi.png","language":"OpenSCAD","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hifumi Keyboard\n\n初心者向け自作キーボードキットです。\n\nA tiny DIY keyboard for newbs.\n\n実際にキーボードの組み立てを体験しながら自作キーボードに入門してもらえるよう、 [同人誌](https://riconken.bitbucket.io/hifumi/) の内容に合わせて設計しました。\n\n## ファームウェア\n\nビルド済みのファームウェアのダウンロード (右クリックから保存してください)：\n\n- [test キーマップ](https://raw.githubusercontent.com/zk-phi/1x2x3-keyboard/master/firmware/hifumi_test.hex)\n  - 動作確認のためのキーマップです\n\n- [default キーマップ](https://raw.githubusercontent.com/zk-phi/1x2x3-keyboard/master/firmware/hifumi_default.hex)\n  - スクリーンショット (PrScr) など実用的なキーが配置されたキーマップです\n\nソースコードからビルドしたい場合は [QMK Firmware の公式リポジトリ](https://github.com/qmk/qmk_firmware) を参照してください。\n\n## 組み立て\n\nわかる人向けの近道ガイド。丁寧な解説は同人誌の方をどうぞ。\n\n1. コンスルー (H=2.5mm) を ProMicro に実装\n\n   https://github.com/zk-phi/keyboard-buildguide-common/blob/master/conthrough.markdown\n\n2. SK6812mini Neopixel LED を実装 (optional)\n\n   https://github.com/zk-phi/keyboard-buildguide-common/blob/master/neopixel.markdown\n\n3. 1N4818 (または 1N4148w) ダイオードを実装\n\n   https://github.com/zk-phi/keyboard-buildguide-common/blob/master/diode.markdown\n\n4. MX 互換スイッチをトッププレートにはめ、基板と合体して半田付け\n\n   https://github.com/zk-phi/keyboard-buildguide-common/blob/master/switch.markdown\n\n5. M2 ネジ・高ナットでボトムプレートを連結\n\n## 基板の発注\n\n自分で基板を発注してみたい人向け。\n\n1. [KiCAD](https://kicad.org/) をインストールして、プロジェクト `pcb/surfboard.pro` を開く\n\n2. 基板データ `surfboard.kicad_pcb` をダブルクリックして基板エディタ (Pcbnew) を立ち上げる\n\n3. `ファイル (F) \u003e プロット (l)` で製造ファイルの出力画面を開き、設定する\n\n   必要なレイヤーにチェックを入れる他は、基本的にデフォルトのままで問題ないと思います\n\n   - 出力フォーマット：ガーバー\n\n   - 含まれるレイヤー：\n     - F.Cu (配線 - 表)\n     - B.Cu (配線 - 裏)\n     - F.SilkS (シルク印刷 - 表)\n     - B.SilkS (シルク印刷 - 裏)\n     - F.Mask (レジスト塗装 - 表)\n     - B.Mask (レジスト塗装 - 裏)\n     - Edge.Cuts (基板外形)\n\n   - 一般オプション：\n     - フットプリントの定数をプロット\n     - フットプリントのリファレンスをプロット\n     - 基板外形レイヤーのデータを他のレイヤーから除外 (外形専用のレイヤーに出力するので不要)\n     - シルクからパッドを除外 (シルク印刷がパッドに被っているところをいい感じにしてくれる)\n     - プロット前にゾーンの塗り潰しをチェック (データが変になってると警告してくれる)\n\n   `フットプリントの xx をプロット` 系のオプションは hifumi の場合どっちでもいいです (使っていないので)。\n\n4. `製造ファイルを出力` でガーバーデータを生成\n\n5. `ドリルファイルを生成` でドリルファイルの出力画面を開き、設定する\n\n   以下のデフォルト設定で特に困ったことがないです\n\n   - ファイル形式: Excellon\n   - 単位:  mm\n   - ゼロのフォーマット: 小数点フォーマット\n   - マップファイルフォーマット: (マップファイルは使用しません)\n   - ドリルファイルオプション: 特になし\n   - ドリル原点: 絶対位置\n\n6. `ドリルファイルを生成` でドリルファイルを生成\n\n7. 各製造業者の指定するファイル名に直す\n\n   便利スクリプトあります: `pcb/rename-elecrow.sh`\n\n   elecrow の場合、\n\n   - ガーバー\n     - `\u003cプロジェクト名\u003e-F.Cu.gbr` =\u003e `\u003cプロジェクト名\u003e.GTL`\n     - `\u003cプロジェクト名\u003e-B.Cu.gbr` =\u003e `\u003cプロジェクト名\u003e.GBL`\n     - `\u003cプロジェクト名\u003e-F.Mask.gbr` =\u003e `\u003cプロジェクト名\u003e.GTS`\n     - `\u003cプロジェクト名\u003e-B.Mask.gbr` =\u003e `\u003cプロジェクト名\u003e.GBS`\n     - `\u003cプロジェクト名\u003e-F.SilkS.gbr` =\u003e `\u003cプロジェクト名\u003e.GTO`\n     - `\u003cプロジェクト名\u003e-B.SilkS.gbr` =\u003e `\u003cプロジェクト名\u003e.GBO`\n     - `\u003cプロジェクト名\u003e-Edge.Cuts.gbr` =\u003e `\u003cプロジェクト名\u003e.GML`\n\n   - ドリル\n     - `\u003cプロジェクト名\u003e-PTH.drl` =\u003e `\u003cプロジェクト名\u003e.TXT`\n     - `\u003cプロジェクト名\u003e-NPTH.drl` =\u003e `\u003cプロジェクト名\u003e-NPTH.TXT`\n\n   と改名して、 zip に固めれば ok\n\n   ファイルが足りない場合は手順を確認してやり直してください\n\n8. 基板製造業者のオーダーページを開いて、ガーバーをアップロード\n\n   サイトによっては基板サイズなどをこの時点で自動計算してくれる場合があります\n\n9. フォームを埋めてオーダーする\n\n   どのサイトでも確認した方がいいのは主に以下：\n\n   - レイヤー数 layers: 2 (表と裏)\n   - サイズ dimensions: 65 x 46 mm (小数点以下は切り上げで ok)\n   - 作る枚数 qty\n   - デザイン数 different design: 1\n   - 厚み thickness: 1.6 mm\n   - レジストの色 PCB (mask) color: お好みで\n   - シルク印刷の色 silkscreen color: お好みで\n   - パッドの表面仕上げ surface finish: HASL (Lead-free にすると鉛フリー, Gold にすると金ピカ)\n\n   JLCPCB などの場合、追加料金を払わないと管理番号を印刷されてしまう場合があります:\n\n   - 製造番号を消す remove order no: お好みで\n\n   その他、サイトによって細かい技術仕様を申告する欄がありますが (すごい小さい穴を開けたい場合追加料金とか)、 hifumi の場合はそのままで大丈夫だと思います。\n\n## プレートのレーザーカット\n\n自分でプレートを切ってみたい人向け。\n\n1. [OpenSCAD](https://www.openscad.org/) をインストールして、 `case/surfbord.scad` を開く\n\n2. プログラム末尾の以下の行を書き換えて、必要な大きさのモデルを表示\n\n   ```scad\n   //cut_model_100x100();\n   //cut_model_150x100();\n   //cut_model_300x300();\n   preview();\n   ```\n\n   デフォルトではキーボード全体のプレビューが表示されています。\n\n   `prevew()` の行をコメントアウトして、たとえば `cut_model_100x100()` の行のコメントアウトを解除すると、 100mm x 100mm の板から切り出すためのモデルが表示されます。\n\n   ```diff\n   -//cut_model_100x100();\n   +cut_model_100x100();\n    //cut_model_150x100();\n    //cut_model_300x300();\n   -preview();\n   +//preview();\n   ```\n\n   発注先のサイトや、レンタルするマシンの仕様に応じて適切なものを選んでください\n\n   100x100 １枚からは１台分、 150x100 １枚からは２台分、 300x300 １枚からは１２台分が取れます。\n\n3. `Design \u003e Render (F6)` でレンダリングを実行\n\n   一瞬で終わります\n\n4. `File \u003e Export \u003e Export as DXF` で DXF ファイルを作成\n\n   レーザーカッターでよく使われるファイル形式です\n\n5. レーザーカットサービスに依頼したり、工房でレーザーカッターをレンタルして切る\n\n   板は 3mm 厚のものを選んでください\n\n   elecrow で `cut_model_100x100()` を切ってもらう場合の例:\n\n   - Size: `10cm x 10cm Max (Thickness 3.0mm)`\n   - Color: お好みで\n   - Lead Time: 3-5 日固定 (執筆時点)\n   - File: (`.dxf` を `.zip` に圧縮してアップロード)\n\n   まれに変な寸法で作られてしまうことがあるので、もし連絡欄などがあれば\n\n   - FYI: 四角い穴は 14mm x 14mm が正しいです\n\n   などと補足をいれておいてもいいかもしれないです\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzk-phi%2F1x2x3-keyboard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzk-phi%2F1x2x3-keyboard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzk-phi%2F1x2x3-keyboard/lists"}