wip

Author: AkiyukiOkayasu

CLAUDE.md

@@ -1,57 +1,53 @@
 # CLAUDE.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
 ## プロジェクト概要
 
-ADAT受信機のRTL実装。TOSLINK ADAT信号を受信し、8チャンネル24bit PCMデータを出力する。Veryl言語で実装。
+ADAT送受信機のRTL実装。Veryl言語で記述し、Verilatorでシミュレーションする。
+
+- **RX**: ADAT光入力 → 8ch 24bit PCM出力（クロック自動復元）
+- **TX**: 8ch 24bit PCM入力 → ADAT光出力
 
 ## コマンド
 
 ```bash
-# フォーマット
-veryl fmt
-
-# ビルド（Veryl → SystemVerilog生成）
-veryl build
-
-# テスト実行
-veryl test
-
-# 波形付きテスト（FST出力）
-veryl test --wave
-
-# 波形表示（macOS）
-surfer src/tb_adat_rx.fst
-
-# クリーン
-veryl clean
+veryl fmt           # フォーマット
+veryl build         # Veryl → SystemVerilog生成
+veryl test          # テスト実行
+veryl test --wave   # 波形付きテスト（FST出力）
+veryl clean         # クリーン
 ```
 
 ## アーキテクチャ
 
-パイプライン構成でADAT信号を処理：
-
+### RX パイプライン
 ```
 ADAT入力 → timing_tracker → bit_decoder → frame_parser → output_interface → PCM出力
-              (エッジ検出)    (NRZI/4B5B)   (30bit→24bit)   (ワードクロック)
+             (エッジ検出)    (NRZI/4B5B)   (30bit→24bit)   (ワードクロック)
+```
+
+### TX パイプライン
+```
+PCM入力 → tx_frame_builder → tx_bit_serializer → tx_nrzi_encoder → ADAT出力
+           (256bitフレーム構築)  (MSB-firstシリアル化)  (NRZI変換)
 ```
 
+### 共有
+- `adat_pkg` — `AdatFamily` enum等の共有型定義
+
 ## コーディング規約
 
-- ドキュメントコメント・実装コメントは日本語を使用
-- ポート命名: 入力は`i_`、出力は`o_`、アクティブローは`_n`接尾辞
-- 共有型を使う場合は `adat_pkg::*` をインポート
+- コメントは日本語
+- ポート命名: 入力`i_`、出力`o_`、アクティブロー`_n`接尾辞
+- 共有型は `adat_pkg::*` をインポート
 - リセットは全モジュールでアクティブハイ `i_rst`
 
-## 編集禁止ファイル
+## 編集禁止
 
-- `target/` - 生成されたSystemVerilog（`veryl build`で再生成）
-- `dependencies/std/` - vendored標準ライブラリ
-- `doc/` - 生成ドキュメント
+- `target/` — 生成SystemVerilog
+- `dependencies/std/` — vendored標準ライブラリ
+- `doc/` — 生成ドキュメント
 
 ## テスト
 
-- シミュレータ: Verilator
-- 波形フォーマット: FST
-- 波形ビューワー: Surfer
+- シミュレータ: Verilator / 波形: FST / ビューワー: Surfer
+- `surfer src/<テストベンチ名>.fst` で波形表示