↓ メインコンテンツへスキップ

回路 CAD のネットリストを AI エージェントに読ませて、Pico のピン設定を書かせた

··3140 文字·7 分 AI協働
目次
AI と作ったデモ機 - この記事は連載の一部です
パート 3: この記事

この記事は、入口編・中編 の続きです。テクノメッセ東大阪2026 で展示したデモ機の、今回はファームウェア側の話になります。 マイコンのピン設定を、回路図を見ながら手で打ち込んでいる方は多いと思います。 けれども、回路 CAD のネットリストには、どのピンが何につながっているかが最初から機械で読める形で入っています。 今回はそれを AI エージェント(Claude Code)に読ませて、Raspberry Pi Pico のピン設定を書かせました。 うまくいった所と、エージェントが人と同じ間違い方をした所の両方を、ネットリストの実物とともに書きます。

以前は、回路図を見て手で打っていた
#

デモ機は、RGBW のアドレス制御 LED を 16 個載せた基板を 8 枚並べ、制御基板(P26024A)の Pico から 8 本の信号線で駆動します。 ほかに ToF センサ(VL53L0X)、DIP スイッチ、状態表示の LED、電源電圧の監視をつないでいます。

デモ機の前面。LED パネルが白く光り、その下の支柱に Pico を載せた赤い制御基板が取り付けてある

これまで、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.16

U1 が 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 本だけです。

広告
GPU2 の入力名前どおりの想定実際の出力ピン実際の行き先
GP2A1(2 番)CN2.1Y1(18 番)CN2.1
GP3A2(3 番)CN2.3Y2(17 番)CN4.1
GP4A3(4 番)CN2.5Y3(16 番)CN2.3
GP5A4(5 番)CN2.7Y4(15 番)CN4.3
GP6A5(6 番)CN4.1Y5(14 番)CN2.5
GP7A6(7 番)CN4.3Y6(13 番)CN4.5
GP8A7(8 番)CN4.5Y7(12 番)CN2.7
GP9A8(9 番)CN4.7Y8(11 番)CN4.7

回路図では、U2 は次のように描かれていました。

レベル変換 IC SN74LV8T541(U2)の回路図。左に入力 A1〜A8 と GP2_PIO〜GP9_PIO、右に出力が上から Y1, Y3, Y5, Y7, Y2, Y4, Y6, Y8 の順に並び、GP2_PIO_5V〜GP9_PIO_5V が番号順に付いている

シンボルの右側は、上から Y1, Y3, Y5, Y7, Y2, Y4, Y6, Y8 の順です。 それでも左右の GPn_PIO と GPn_PIO_5V は、番号順に同じ高さに並んでいます。 名前と見た目の両方が、1 対 1 につながっているように見せていたわけです。

止めたのは、回路を知っている人だった
#

この基板は私たちが設計したので、U2 で入れ替えていることは知っていました。 エージェントが自分で気づくならそのまま進めるつもりでしたが、気づいていない様子だったので「U2 でピンスワップしている」と伝えました。 エージェントはネットリストをピン番号とピンの機能でたどり直し、並びを直しました。

ネットリストを使っていても、名前で読めば間違いは防げません。 人が写しても、エージェントが写しても同じです。 間違えた原因は写し手が人かどうかではなく、名前で読んだことでした。

基板の外は、実機で確かめた
#

ネットリストに出てくるのは基板の中の接続だけです。 制御基板から LED 基板へのケーブルの順番は、最初から現物合わせのつもりで決めていませんでした。 どの信号線がどの段の基板に行くかは、展示会の設営日(2026-11-02)に組み立ててから、実機のテストパターンで確かめました。 その手順は、別の記事にまとめています。

LED パネルの裏面。LED 基板 8 枚が縦に並び、基板どうしを赤黒の線で渡り配線し、各基板のコネクタに黄白の線が制御基板から来ている

写させたら、機械で照合する
#

このファームウェアでは、ほかにも「写す」作業をエージェントに任せています。 ToF センサ VL53L0X は、データシートに載っていない初期化用のレジスタ値が 80 組あります。 これをオープンソースの Arduino 向けドライバから C に写させ、写した後でソースから機械的に抜き出して比べ、一致を確かめました。

元のソースは、要約せずに原文のまま取得させています。要約を通すと、数値が変わるおそれがあるためです。 ネットリストのピン設定も、後日、短い使い捨ての Python スクリプトでネットリスト・config.h・仕様書の一致を照合しました。 写させたら、機械で照合する。どちらも同じ形です。

まとめ
#

今回のピン設定で、エージェントがしたことと人がしたことを分けると、次のようになります。

工程担当
回路図とネットリストを渡す人
ネットリストを読み、config.h を書く(プルアップの注記も)エージェント
U2 の入れ替えを指摘する人(基板の設計者)
ピン番号でたどり直すエージェント
写したものを機械で照合するエージェント

マイコンのピン設定をエージェントに任せるときは、次の点を押さえると間違いを減らせます。

  • 回路図の PDF ではなく、ネットリストを渡す
  • ネット名ではなく、ピン番号とピンの機能でたどらせる
  • 基板の外(ケーブル)はネットリストに出てこないので、実機で確かめる
  • 写させたものは、機械で照合する

照明の制御基板でも事情は同じで、PIC のピン設定とプルアップの書き漏れは、これで減らせます。

AI と作ったデモ機 - この記事は連載の一部です
パート 3: この記事
広告

関連記事

展示したデモ機は、AI エージェントと設計した

··1334 文字·3 分
テクノメッセ東大阪で展示したデモ機の機構を AI エージェントと設計した記録。「AI で設計する」とは絵ではなく条件とデータを渡し、画面と実物をつなぐループを回すこと。その全体像を紹介します。

AI に書かせた仕様書は、書いた本人に検証させない

··2418 文字·5 分
AI エージェントと進める FPGA の案件で、仕様書50本をソースと突き合わせると10件ずれていました。誤りの3つの種類と、書く役と検証する役を分ける5つの仕組みを紹介します。