前回でも少し触れたが、KiCad
のフットプリント・モジュールライブラリには、github
と連携する機能が備わっている。
Kicadのgithubリポジトリにも大量のフットプリントが登録されており、とりあえずこのリポジトリに接続しておけば基板設計ができる。今回は自分のgithubリポジトリをKiCadのフットプリントライブラリとして登録し、フットプリントエディタで編集して保存、リポジトリへpushする一連の流れをまとめる。
githubでモジュール用リポジトリの作成
まず、github
にログイン(またはアカウント作成)して、KiCad用のリポジトリを作成する。リポジトリ名は、名前+.pretty
にする。
URLを確認して、ローカルディレクトリに作成したリポジトリのクローンを作成する。
> git clone https://github.com/(your-acount)/MyMod.pretty.git
Cloning into 'MyMod.pretty'...
warning: You appear to have cloned an empty repository.
を実行したディレクトリにリポジトリが作成される。このディレクトリ内には、gitの管理フォルダ(.git)のみの空リポジトリである。
> ls
MyMod.pretty
とりあえず、READMEテキストでもリモートリポジトリへ追加しておく。どうも一度もコミットされていない初期状態のリポジトリだと、フットプリントエディタでSaveするときにエラーになる為
> git clone https://github.com/(your-acount)/MyMod.pretty.git
Cloning into 'MyMod.pretty'...
warning: You appear to have cloned an empty repository.
> cd MyMod.pretty
> echo "MyMod module library." > README.md
> git add README.md
> git commit -m "initial commit"
[master (root-commit) aa50ea7] initial commit
1 file changed, 1 insertion(+)
create mode 100644 README.md
>git push -u origin master
Username for 'https://github.com': (login id)
Password for 'https://(your account id)@github.com': (login password)
Counting objects: 3, done.
Writing objects: 100% (3/3), 226 bytes, done.
Total 3 (delta 0), reused 0 (delta 0)
To https://github.com/(your account)/MyMod.pretty
* [new branch] master -> master
Branch master set up to track remote branch master from origin.
KiCadで自分用モジュールライブラリを指定する。
最低限ネットワーク上のgithubリポジトリ
を指定する。ネットワーク上のリポジトリを指定することにより、KiCadが自動的にライブラリ内のフットプリントの一覧情報を取得・表示したり、選択したフットプリントをダウンロードして使用できるようになる。
KiCadのPcbnew
を起動し、設定
-ライブラリリスト
を選択してリストを表示する。リストでは全プロジェクトで有効になるグローバルライブラリ
タブと、カレントプロジェクトでのみ有効になるプロジェクト特有のライブラリ
タブのどちらかを選択し、Append with Wizard
ボタンを押下する。
Library Format
からGitHub
を選択し、URLにGiwtHubのホームページ(リポジトリの1つ上の階層)を入力して次へ進む。
Pathをどのように定義するかを選択する。とりあえずUse absolute path
(絶対パス)を選択して次へ。
リポジトリを選択する。Github Libs List
でリストアップされそうだが、何かが足りないのかエラーになるので、Add Libs with WebViewer
ボタンを押下して専用ブラウザを起動する。
画面上部のURLバーにGithubのURLを入力する(デフォルトはKiCad本家のURL)。
自分のリポジトリ一覧が表示されたら、URLバー右にある”検索アイコンボタン”を選択すると、現在のURL内にある*.pretty*が付いたリポジトリ一覧が列挙されるので、必要なリポジトリをチェックしてブラウザを閉じる。
元のWizard画面に戻ると、リポジトリが選択された状態になっているので、”Finish“ボタンで終了する。
ライブラリ一覧にGithubリポジトリが追加されたことを確認。
次は、この空のリポジトリにフットプリントを保存できるようにする。Option Editor
を選択して、オプション設定画面を表示する。
allow_pretty_writing_to_this_dir
を追加して、定数にローカルのクローンリポジトリのパスを追加設定する。
モジュールライブラリにフットプリントを追加、登録する
Footprint Editor
を起動してフットプリントを作成してみる。とりあえず追加したモジュールライブラリをアクティブにする。
New footprint
で試しに抵抗っぽいものを作成後、Save footprint in active library
でローカルリポジトリに保存する。以降、作成したフットプリントが使用可能になる。
フットプリントをリモートリポジトリへ登録する
フットプリント・エディタで保存すると、ローカルリポジトリ内にフットプリント名.kicad_mod
というファイル名で保存されるが、あくまでファイルが保存・更新されるだけであり、リポジトリへの追加・更新・コミットなどが連動して行われるわけではない。
ローカルまたはリモートリポジトリへの登録はあくまでgitコマンド
を使って行う。
> ls
Test_Resistor.kicad_mod
> git add Test_Resistor.kicad_mod
> git commit -a
> git push