回路 CAD のネットリストを AI エージェントに読ませて、Pico のピン設定を書かせた
目次
AI と作ったデモ機 - この記事は連載の一部です
この記事は、入口編・中編 の続きです。テクノメッセ東大阪2026 で展示したデモ機の、今回はファームウェア側の話になります。 マイコンのピン設定を、回路図を見ながら手で打ち込んでいる方は多いと思います。 けれども、回路 CAD のネットリストには、どのピンが何につながっているかが最初から機械で読める形で入っています。 今回はそれを AI エージェント(Claude Code)に読ませて、Raspberry Pi Pico のピン設定を書かせました。 うまくいった所と、エージェントが人と同じ間違い方をした所の両方を、ネットリストの実物とともに書きます。
以前は、回路図を見て手で打っていた#
デモ機は、RGBW のアドレス制御 LED を 16 個載せた基板を 8 枚並べ、制御基板(P26024A)の Pico から 8 本の信号線で駆動します。 ほかに ToF センサ(VL53L0X)、DIP スイッチ、状態表示の LED、電源電圧の監視をつないでいます。

これまで、Pico くらいのピン数なら、回路図を見てピン設定を手で打っていました。照明の制御に使う PIC でも同じです。 大きな事故はありませんでしたが、時間はかかります。 実機で RGB LED の色がおかしい、という程度の間違いもありました。 もうひとつ多かったのが、プルアップの設定のような「ピン番号以外の情報」の書き漏れです。
ネットリストを読ませて config.h を書かせた#
PDF では決めきれなかった#
依頼は展示会の 6 日前(2026-10-29)です。最初に渡したのは回路図の PDF でした。
エージェントは PDF から文字とその座標を取り出し、配置から接続を読もうとしました。 途中までは合っていましたが、Pico の片側は行の間隔が少しずれていて、GP16〜22 の行き先を決めきれませんでした。 PDF の文字の配置は、接続そのものを表しているわけではありません。
正確に読めていないのではと気になって、「正しく読めているか? ネットリストが必要か?」と聞いたところ、エージェントはネットリストを希望しました。 OrCAD Capture から出したネットリスト(テキスト)を渡し、以降はこちらを正としました。
ネットリストからピン定義へ#
ネットリストは、ネット名と、そのネットにつながる部品のピンを並べたテキストです。
DIPSW_0; R6.1 SW1.1 U1.15
DIPSW_1; R5.1 SW1.2 U1.14
I2C0_SCL; R4.1 CN5.4 U1.17
I2C0_SDA; R3.1 CN5.3 U1.16U1 が Pico です。U1.15 は Pico の物理ピン 15 番で、GPIO 番号では GP11 になります。
物理ピンの間に GND が挟まるので、GP 番号は単純な引き算では出ません。
エージェントはこの変換をして、次の config.h を書きました(抜粋)。
/* ---- ピン(制御基板 P26024A のネットリスト RGBW_CONTROL_BOARD_P26024A.NET より。2026-10-29) ---- */
#define LED_PIN_BASE 2 /* GP2〜GP9 の連続8本。SN74LV8T541 で 5V に変換(OE は GND 固定) */
#define TOF_I2C_INDEX 0 /* i2c0 */
#define TOF_SDA_PIN 12 /* 基板に 2.4k のプルアップ(3.3V) */
#define TOF_SCL_PIN 13
#define TOF_XSHUT_PIN 14 /* Low でセンサーの電源断。基板にプルアップなし */
#define DIPSW0_PIN 11 /* DIPスイッチ0(SW1 の1番)。基板に 10k のプルアップ、ON で Low */
#define DIPSW1_PIN 10 /* DIPスイッチ1(SW1 の2番)。同上 */
#define VSENSE_5V_PIN 26 /* ADC0。5V を 39k/62k で分圧(5V で約 3.07V) */ネットリストには抵抗もつながって出てくるので、プルアップの有無と値がピンごとにコメントに入っています。 手で打っていたときに漏れやすかったのは、まさにここです。
写し間違いの種もネットリストの中にありました。
ネット名 DIPSW_0 は GP11、DIPSW_1 は GP10 で、名前の番号と GP 番号の大小が逆です。
また、ネットリストを渡す前の仮の設定では、ToF の I2C を I2C1(GP14/15)と推測で置いていました。実際は I2C0(GP12/13)です。
名前で読むと、エージェントも間違える#
8 本中 6 本の行き先が違った#
LED の信号線は、Pico の 3.3 V をレベル変換 IC(SN74LV8T541、以下 U2)で 5 V にしてからコネクタに出ています。
ネットリストでは、U2 の入力側が GP2_PIO〜GP9_PIO、出力側が GP2_PIO_5V〜GP9_PIO_5V という名前です。
エージェントは最初、この名前どおりに「GPn_PIO の信号は GPn_PIO_5V を通ってコネクタへ出る」と読み、基板の並びを決めました。
ところが U2 は、配線の都合で出力側のピンを入れ替えてあります。
ピン番号でたどると、たとえば GP3 は次のようになります。
GP3_PIO; U2.3 U1.5 ← Pico の物理 5 番(GP3)は U2 の 3 番(A2)へ
GP6_PIO_5V; CN4.1 U2.17 ← A2 の出力 Y2 は 17 番。17 番は GP6_PIO_5V のネットにあるGP3 の信号は、GP6_PIO_5V という名前のネットを通って CN4 の 1 番に出ていました。
8 本すべてを並べると、名前どおりだったのは 2 本だけです。
| GP | U2 の入力 | 名前どおりの想定 | 実際の出力ピン | 実際の行き先 |
|---|---|---|---|---|
| GP2 | A1(2 番) | CN2.1 | Y1(18 番) | CN2.1 |
| GP3 | A2(3 番) | CN2.3 | Y2(17 番) | CN4.1 |
| GP4 | A3(4 番) | CN2.5 | Y3(16 番) | CN2.3 |
| GP5 | A4(5 番) | CN2.7 | Y4(15 番) | CN4.3 |
| GP6 | A5(6 番) | CN4.1 | Y5(14 番) | CN2.5 |
| GP7 | A6(7 番) | CN4.3 | Y6(13 番) | CN4.5 |
| GP8 | A7(8 番) | CN4.5 | Y7(12 番) | CN2.7 |
| GP9 | A8(9 番) | CN4.7 | Y8(11 番) | CN4.7 |
回路図では、U2 は次のように描かれていました。

シンボルの右側は、上から Y1, Y3, Y5, Y7, Y2, Y4, Y6, Y8 の順です。
それでも左右の GPn_PIO と GPn_PIO_5V は、番号順に同じ高さに並んでいます。
名前と見た目の両方が、1 対 1 につながっているように見せていたわけです。
止めたのは、回路を知っている人だった#
この基板は私たちが設計したので、U2 で入れ替えていることは知っていました。 エージェントが自分で気づくならそのまま進めるつもりでしたが、気づいていない様子だったので「U2 でピンスワップしている」と伝えました。 エージェントはネットリストをピン番号とピンの機能でたどり直し、並びを直しました。
ネットリストを使っていても、名前で読めば間違いは防げません。 人が写しても、エージェントが写しても同じです。 間違えた原因は写し手が人かどうかではなく、名前で読んだことでした。
基板の外は、実機で確かめた#
ネットリストに出てくるのは基板の中の接続だけです。 制御基板から LED 基板へのケーブルの順番は、最初から現物合わせのつもりで決めていませんでした。 どの信号線がどの段の基板に行くかは、展示会の設営日(2026-11-02)に組み立ててから、実機のテストパターンで確かめました。 その手順は、別の記事にまとめています。

写させたら、機械で照合する#
このファームウェアでは、ほかにも「写す」作業をエージェントに任せています。 ToF センサ VL53L0X は、データシートに載っていない初期化用のレジスタ値が 80 組あります。 これをオープンソースの Arduino 向けドライバから C に写させ、写した後でソースから機械的に抜き出して比べ、一致を確かめました。
元のソースは、要約せずに原文のまま取得させています。要約を通すと、数値が変わるおそれがあるためです。 ネットリストのピン設定も、後日、短い使い捨ての Python スクリプトでネットリスト・config.h・仕様書の一致を照合しました。 写させたら、機械で照合する。どちらも同じ形です。
まとめ#
今回のピン設定で、エージェントがしたことと人がしたことを分けると、次のようになります。
| 工程 | 担当 |
|---|---|
| 回路図とネットリストを渡す | 人 |
| ネットリストを読み、config.h を書く(プルアップの注記も) | エージェント |
| U2 の入れ替えを指摘する | 人(基板の設計者) |
| ピン番号でたどり直す | エージェント |
| 写したものを機械で照合する | エージェント |
マイコンのピン設定をエージェントに任せるときは、次の点を押さえると間違いを減らせます。
- 回路図の PDF ではなく、ネットリストを渡す
- ネット名ではなく、ピン番号とピンの機能でたどらせる
- 基板の外(ケーブル)はネットリストに出てこないので、実機で確かめる
- 写させたものは、機械で照合する
照明の制御基板でも事情は同じで、PIC のピン設定とプルアップの書き漏れは、これで減らせます。

