0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

自作MCPサーバー その21

0
Last updated at Posted at 2026-11-15

概要

MCPサーバーが気になったので、調べてみた。
AIに聞いた。
自分が出来なかった、shrike-liteのSPIスレーブをClaudeDesktopに解いてもらった。

これを

URLだけ届いたので、記事の要約をまとめます。聞きたいことが別にあれば教えてください。

記事の内容

Raspberry Pi Pico系のFPGAボード「Shrike-lite」で、自作の8bitスタックマシンCPUを動かし、MicroPythonからSPI経由で操作する実験です(シリーズ第47回、2026-10-16投稿)。

CPUの仕様

8bitのスタックを4段持ち、RAMはなし
命令は12bit(上位4bitがオペコード、下位8bitがオペランド)
ROMは64ワード、PCとアドレスレジスタは6bit
命令は push / adr / 条件ジャンプ / jmp / emit(出力) / 四則演算・比較 / dup / drop など

動作

ROMに「U」を3回出力して \r\n を送り、停止するプログラムを入れています。
Verilogのトップモジュールには、SPIターゲット、モード切替、CPU本体が入っています。
SPIで 1 を送るとCPUが動いて文字列を返し、2 を送ると固定値 0x55(U)を返します。
リソース使用量はLUT 129個(約11.5%)、FF 83個、BRAMは未使用でした。
MicroPython側の main.py はビットストリームを書き込み、リセットしてSPIでコマンドを送る構成です。

実行結果

コマンド1では UUUU が返りました。
コマンド2では 0x55 が5回返りました。
気づいた点
仕様ではPCとアドレスが6bitですが、コードでは7bitで宣言されています。
命令表のifeq/ifneは「TOPが真/偽なら」と書かれています。一方コードでは、JEQは q0 == 0 で、JNEは q0 == 1 でジャンプします。表と実装の意味が逆に見えます。
冒頭では「UUUを返す」とありますが、実行結果は4文字の UUUU です。emitがSPIクロックの立ち上がりを数えて同期する作りなので、送信タイミングのずれが原因かもしれません。
「出力はuart」とありますが、実際の出力はSPIのMISOです。

コードのレビュー、不具合の原因調査、命令セットの拡張案など、必要なものがあれば手伝います。

作業フォルダーはohisa/claude ,デスクトップコマンダー使って iverilogはc:\にあります

D
desktop-commander · list_directory
D
desktop-commander · list_directory
D
desktop-commander · write_file
D
desktop-commander · write_file
D
desktop-commander · write_file

C:\Users\ohisa\claude で、記事のCPUをiverilogでシミュレーションしました。実機と同じ UUUU がシミュレーションでも再現でき、原因も分かりました。

作成したファイルは次の4つです。

cpu0.v: 記事のCPU。$monitor だけ削除しました。
spi_target.v: Shrike標準の spi_target は手元にないので、同じ動作をする簡易モデルを自作しました。
cpu0_tb.v: SPIマスタ役のテストベンチ。コマンド送信、10µs待ち、ダミー読み出しというMicroPython側と同じ手順です。
cpu0.vcd、cpu0.vvp: シミュレーション出力。
結果
コマンド1: 読み出しは U U U U \r \n \n \n … で、Uが4個出ました(記事の実行結果と同じです)。
コマンド2: 0x55 が5回返り、これも記事どおりです。
UUUUになる原因

emit はSPIクロックの立ち上がりを11回数えるまで待ちますが、1バイトの転送は8クロックです。そのため out が1バイト分より長く保持され、約1.4バイト分になります。

テストベンチの読み出しは、バイトごとにその時点の out を取ります。1文字が1回で済むか2回読まれるかは位相しだいです。シミュレーションでは最初の「U」が2回読まれて4個になりました。末尾も、haltで out が \n のまま残るので \n が繰り返されます。

修正案

emit を、10回待つ代わりに rx_valid_pulse(1バイト転送完了)を待つ方式に変えれば、1文字が1回だけ読まれます。終了時に out を0に戻せば、末尾の \n の繰り返しも消えます。

修正版を作って同じテストベンチで確認しましょうか。

D
desktop-commander · write_file
D
desktop-commander · edit_block

Next come the wire declaration, the emit wait condition, and the halt handling.

D
desktop-commander · edit_block
D
desktop-commander · edit_block
D
desktop-commander · edit_block

実物の spi_target に差し替えても UUUU は再現し、修正版では UUU\r\n に直りました。

差し替え結果
元のCPU(cpu0.v): 簡易モデルと同じで、U U U U \r \n \n … になりました。
修正版(cpu1.v): U U U \r \n のあとは 0x00 になりました。MicroPython側の「0x0A か 0x00 で終了」と合うので、UUU で正しく終わります。
コマンド2: 0x55 が5回返り、元のままで問題ありません。
実物の仕様で分かったこと
o_rx_data_valid はパルスではなくレベルです。 8ビット目で立ち上がり、次のバイトの最初のエッジか、CSが上がるまで1のままです。記事の変数名 rx_valid_pulse は誤解を招きます。私が先に挙げた「rx_valid_pulse を待つ」案は、そのままでは使えません。
o_tx_data_hold は、i_tx_data を取り込む1クロックのパルスです。 CS立ち下がり時と、1バイトごとのSCK下降エッジで出ます。待つべき相手はこれでした。
簡易モデルと実物は、送信データを取り込むタイミングがほぼ同じでした。そのため、前回の結論はそのまま成り立ちます。
修正内容(cpu1.v、元との差は4か所)
o_tx_data_hold を tx_hold として接続しました。
emit は「SPIクロック11個待ち」をやめ、tx_hold(SPI側が out を取り込んだ合図)を待つようにしました。
halt で out を0に戻しました。
宣言を1行追加しました。
注意
検証はiverilogのシミュレーションだけで、実機では試していません。実機への反映は、Go Configureでビットストリームを作り直してから確認してください。
実機では、CPUの起動とSPI転送のタイミングが少しずれる可能性があります。修正版は「emit 後の取り込みを待つ」作りなので、ずれには強いはずです。
テストベンチの $dumpfile は共通の cpu0.vcd に出力されるため、実行のたびに上書きされます。

ファイルはすべて C:\Users\ohisa\claude にあります。

gtkwaveを見せて

D
desktop-commander · list_directory
D
desktop-commander · edit_block
D
desktop-commander · write_file

GTKWaveを2つ起動しました。1つは元のCPU(wave_old.vcd)、もう1つは修正版(wave_new.vcd)で、どちらも spi.gtkw の信号を表示する設定です。ウィンドウが開いていなければ教えてください。ここからは画面を見られないので、見方だけ説明します。

表示される信号(上から)

ss_n、sck、mosi、miso、mode、pc、state、out、r_miso_data、o_tx_data_hold、o_rx_data_valid、sck_counter の順です。

見る場所
最初に Zoom Fit(虫眼鏡のアイコン)を押すと、全体が表示されます。
コマンド1の区間(約0〜95µs)を拡大してください。
old側: out が U のまま、o_tx_data_hold が2回出ても変わらない箇所があります。ここで同じ文字が2回読まれています。sck_counter が11まで数える間に、1バイト分(8クロック)を超えているのが原因です。
new側: o_tx_data_hold が出るたびに pc が進みます。out も1バイトごとに U → U → U → 0D → 0A → 00 と切り替わります。
補足
spi.gtkw の信号名は、このテストベンチの階層(cpu0_tb.dut.…)に合わせてあります。
cpu0_tb.v を少し変え、+vcd=ファイル名 で出力先を選べるようにしました。何も指定しなければ従来どおり cpu0.vcd に出ます。

特定の箇所を拡大した画面を見て説明してほしいときは、スクリーンショットを送ってください。

以上。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?