MCP 서버에 관심이 생겨서 조사해 보았습니다.
AI에게 질문했습니다.
제가 직접 구현하지 못했던 shrike-lite의 SPI 슬레이브를 ClaudeDesktop에게 디코딩(해석)을 맡겼습니다.
URL만 전달받았기 때문에, 기사의 요약 내용을 정리합니다. 궁금한 점이 있다면 알려주세요.
[기사 내용]
Raspberry Pi Pico 계열의 FPGA 보드인 'Shrike-lite'에서 자작 8비트 스택 머신 CPU를 구동하고, MicroPython을 통해 SPI 방식으로 제어하는 실험입니다 (시리즈 제47회, 2026-10-16 게시).
CPU 사양
- 스택은 8비트를 4단 보유하며 RAM은 없습니다.
- 명령어는 12비트(상위 4비트가 오퍼코드, 하위 8비트가 오퍼랜드)입니다.
- ROM은 64워드이며 PC와 주소 레지스터는 6비트입니다.
- 명령어에는 push / adr / 조건 점프 / jmp / emit(출력) / 사칙연산・비교 / dup / drop 등이 있습니다.
동작 방식
ROM에 'U'를 세 번 출력하고 \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와 주소는 6비트이지만, 코드에서는 7비트로 선언되어 있습니다.
- 명령표의 ifeq/ifne는 'TOP이 참/거짓일 경우'라고 되어 있습니다. 반면 코드는 JEQ가 q0 == 0이고, JNE는 q0 == 1일 때 점프합니다. 표와 구현된 의미가 반대로 보이는 것 같습니다.
- 서두에는 'UUU를 반환한다'고 했지만, 실제 실행 결과는 네 글자인 UUUU입니다. emit이 SPI 클럭의 상승을 세어 동기화되는 구조라 전송 타이밍의 어긋남 때문일 수 있습니다.
- '출력은 uart'라고 되어 있지만, 실제 출력은 SPI의 MISO입니다.
코드 리뷰, 결함 원인 조사, 명령어 셋 확장안 등 필요한 것이 있다면 도와드리겠습니다.
D
desktop-commander · list_directory
D
desktop-commander · list_directory
Dndesktop-commander · write_file
Dndesktop-commander · write_file
Dndesktop-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을 가져옵니다. 한 문자가 한 번으로 끝날지 두 번 읽힐지는 위상에 달려 있습니다. 시뮬레이션에서는 첫 번째 'U'가 두 번 읽혀 4개가 되었습니다. 마지막도, halt에서 out이 \n 상태로 남아있기 때문에 \n이 반복됩니다.
수정안
emit을, 10번 기다리는 대신 rx_valid_pulse(1바이트 전송 완료)를 기다리는 방식으로 변경하면, 한 문자가 한 번만 읽힙니다. 종료 시 out을 0으로 되돌리면, 마지막 \n의 반복도 사라집니다.
수정판을 만들어서 같은 테스트벤치로 확인해 볼까요?
Ddesktop-commander · write_file
Ddesktop-commander · edit_block
다음으로 와이어 선언(wire declaration), emit 대기 조건(wait condition), 그리고 정지 처리(halt handling)가 있습니다.
Ddesktop-commander · edit_block
Ddesktop-commander · edit_block
Ddesktop-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 하강 시점과, 바이트마다의 SCK 하강 에지에서 나옵니다. 기다려야 할 대상은 이것이었습니다.
간단한 모델과 실제 모델은 전송 데이터를 가져오는 타이밍이 거의 같았습니다. 따라서, 지난번 결론은 그대로 성립합니다.
수정 내용(cpu1.v, 원본과의 차이는 4곳)
o_tx_data_hold를 tx_hold로 연결했습니다.
emit은 'SPI 클럭 11개 대기'를 중단하고, tx_hold (SPI 측이 out을 가져간 신호)를 기다리도록 했습니다.
halt에서 out을 0으로 되돌렸습니다.
선언문을 한 줄 추가했습니다.
주의사항
검증은 iverilog 시뮬레이션만으로 했으며, 실제 장치에서는 시험하지 않았습니다. 실제 장치에 반영하려면 Go Configure를 통해 비트스트림을 다시 만들고 확인해야 합니다.
실제 장치에서는 CPU의 부팅과 SPI 전송 타이밍이 약간 어긋날 가능성이 있습니다. 수정판은 'emit 이후 가져오기를 기다리는' 구조이므로, 오차에는 강할 것입니다.
테스트벤치의 $dumpfile은 공통된 cpu0.vcd에 출력되므로, 실행할 때마다 덮어쓰여집니다.
파일은 모두 C:\Users\ohisa\claude 에 있습니다.
Ddesktop-commander · list_directory
Ddesktop-commander · edit_block
Ddesktop-commander · write_file
GTKWave를 2개 실행했습니다. 하나는 원래 CPU(wave_old.vcd)이고, 다른 하나는 수정판(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에 나옵니다.
특정 부분을 확대해서 본 화면을 보고 설명해 주기를 원할 때는 스크린샷을 보내주세요.
이상입니다.