この記事を作った動機

 JLCpcbで基盤を発注しようとしたときに、主導でいちいち部品表(BOM)とかを調整するのはあまりにしんどいので、ツールを使おうと思った。

 そこで、KiCAD JLCPCB tools という拡張機能を使おうとしたのだが、どうもREADMEどうりにしても、うまくいかないことが分かった。どうあがいても、ダウンロードしたファイルのハッシュが合わないというエラーで止まってしまう。

問題のエラー

 それで、拡張機能のダウンロードだけでもやってみようと、エラーも無視してしてみると、なぜか 1kb だけの zip ファイルがダウンロードされ、展開できない。

 ひょっとしてと思って、テキストファイルとして開いてみたら、案の定サーバからエラーメッセージが返されていた。どうも kicad と拡張機能側との間で何か問題があることだけは分かった。

問題のファイル

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN""http://www.w3.org/TR/html4/strict.dtd">
<HTML>
    <HEAD>
        <TITLE>Bad Request</TITLE>
        <META HTTP-EQUIV="Content-Type" Content="text/html; charset=us-ascii">
    </HEAD>
    <BODY>
        <h2> Bad Request</h2>
        <hr>
        <p>HTTP Error 400. The request is badly formed.</p>
    </BODY>
</HTML>

 そこで、今回はどのようにしてそれを対処したのか記録しようという話。

環境

  • kicad 9.0
  • KiCAD JLCPCB tools 2025.04.02
  • windows 11 24H2

対処方法

タグリストを開く

 KiCAD JLCPCB toolsの公式ページにのページから以下のようにして、Tags のリストページへ遷移する。

タグリストを開く

インストールしたいバージョンを選ぶ

 私は最新を選んだが、以下の画像で囲っているバージョン以外でも動くようなら大丈夫だと思う。

インストールしたいバージョンを選ぶ

拡張機能本体をダウンロード

拡張機能をダウンロードする

kicad のパッケージマネージャを開く

パッケージマネージャを開く

ファイルからインストールを選択

ファイルからインストール
ダウンロードしたzipを選択
インストールされた様子

問題に気付くまでの過程でやってたこと

公式に書かれている方法をやってみる

1. パッケージマネージャを使う方法

  • kicadのパッケージマネージャを開く
    パッケージマネージャを開く
  • パッケージマネージャに、リポジトリ追加
    リポジトリの追加
    リポジトリの追加画面
    リポジトリを追加
    リポジトリが追加された様子
  • 追加したリポジトリを開く
    追加したリポジトリを選ぶ
  • リポジトリを選択しインストールを試みる
    インストールを試みる
    まだインストールされていない
     ちなみに、以下の画像は、問題を再現しようとして、なぜか成功してしまって、エラーが出たときのスクリーンショットを取り損ねたので、雰囲気だけでも置いているだけ。
     今回遭遇した問題では、ハッシュ値が合わないというエラーがそのダイアログにも出る。どうも一度 zip 経由からインストールに成功して前提条件が変わった結果、問題が再発しなくなった模様。
     でもそのために kicad を完全にクリーンインストールして検証するのも面倒なので、そこらへんは置いておくことにする。
    なぜがエラーを再現しようとしたらインストールに成功してしまう
    問題のエラー
  • リポジトリを選択しとりあえずダウンロードだけでも試みる
    ダウンロードを試みる
    問題のエラー
    問題のファイル
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN""http://www.w3.org/TR/html4/strict.dtd">
<HTML>
    <HEAD>
        <TITLE>Bad Request</TITLE>
        <META HTTP-EQUIV="Content-Type" Content="text/html; charset=us-ascii">
    </HEAD>
    <BODY>
        <h2> Bad Request</h2>
        <hr>
        <p>HTTP Error 400. The request is badly formed.</p>
    </BODY>
</HTML>

2. 開発者的な手法

 これについては疲れたので詳細は省くが、以下のような感じだった。

  • 公式ページから特定のディレクトリにリポジトリをクローン
  • kicad を再起動してみる
  • 結局何も出てこず。。。
     もしかしたらやり方間違ってるのかもしれない。

手動でパッケージのインストールを試みる

  1. JSONを追いかける
     KiCAD JLCPCB toolsの公式ページに書いてある以下の部分に注目してリンクをchromeとかのブラウザで踏む。

KiCAD PCM

Add my custom repo to the Plugin and Content Manager, the URL is:

https://raw.githubusercontent.com/Bouni/bouni-kicad-repository/main/repository.json
  1. packages の url の場所へ飛ぶ
https://raw.githubusercontent.com/Bouni/bouni-kicad-repository/main/packages.json
{
    "$schema": "https://gitlab.com/kicad/code/kicad/-/raw/master/kicad/pcm/schemas/pcm.v1.schema.json#/definitions/Repository",
    "maintainer": {
        ...
    },
    "name": "Bouni's KiCad repository",
    "packages": {
        "sha256": "e7116006e8f31ef1bf5703ec5a0967c01f0481a34307821fa85e2262f68ac471",
        "update_time_utc": "2025-04-02 11:56:04",
        "update_timestamp": 1743594964,
        "url": "https://raw.githubusercontent.com/Bouni/bouni-kicad-repository/main/packages.json"
    },
    "resources": {
        ...
    }
}
  1. パッケージのzipをダウンロード
     versions の download_url の項目に注目し、インストールしたいパッケージを選び直接リンクをブラウザ踏んでダウンロードする。たとえばurlは以下のような形式をしている。
https://github.com/Bouni/kicad-jlcpcb-tools/releases/download/2021.12.1/KiCAD-PCM-2021.12.1.zip
{
    "packages": [
        {
            "$schema": "https://go.kicad.org/pcm/schemas/v1",
            ...
            "versions": [
                {
                    "version": "2021.12.1",
                    "status": "testing",
                    "kicad_version": "6.0",
                    "download_sha256": "48611b125a44c254576a809f30c339d3dd876f29ef19dd501892997593e51e51",
                    "download_size": 66118,
                    "download_url": "https://github.com/Bouni/kicad-jlcpcb-tools/releases/download/2021.12.1/KiCAD-PCM-2021.12.1.zip",
                    "install_size": 147111
                },
                {
                    "version": "2021.12.2",
                    "status": "testing",
                    "kicad_version": "6.0",
                    "download_sha256": "6ec44b5911f8b795dfe77380f683798e8d935dffd40b0f0d48e2a2884ef2c615",
                    "download_size": 66205,
                    "download_url": "https://github.com/Bouni/kicad-jlcpcb-tools/releases/download/2021.12.2/KiCAD-PCM-2021.12.2.zip",
                    "install_size": 147592
                },
                ....
  1. zip 経由でインストール
     kicad のパッケージマネージャを開くと同じようにする。

  2. URLをよく見てみると、githubのページであることに気づく。
     拡張機能本体をダウンロードと同じwebページで、ダウンロードできるファイルのURLであることに気づく。

参考にしたサイトとか