USB Power Deliveryの交渉と負荷測定を音楽にする、オフラインのツールです。 要求と応答を掛け合いに変換し、実測電力が大きくなるほどギターやドラム、音数が増えます。 リセットや測定のfailed状態も、それぞれの音で表現します。
python pd_musicus.py --playerブラウザーが開き、同梱の0.5 A／5 Aサンプルを選んで再生できます。 現在のイベント、Source／Sink間の方向、前後の履歴、実測電圧・電流・電力を表示します。 一時停止やシークに追従し、履歴のイベントをクリックして再生位置を移動できます。
Open your recording で、WAVと対応する .score.json（schema 1）をまとめて選択できます。
処理はブラウザー内で行い、ファイルはアップロードしません。CTS版は測定ケースを表示し、
PD版はSoft Reset／Hard Resetを区別します。
サーバーは 127.0.0.1 限定で、プレイヤーと同梱サンプルだけを配信します。
停止はターミナルでCtrl+C。--port 18765 でポート指定、--no-browser で自動起動を抑制できます。
指定ポートが利用できない場合は空きポートへ切り替え、起動URLを表示します。
player/index.html を直接開いてローカルWAV／JSONを選ぶこともできますが、同梱サンプルボタンにはサーバーが必要です。
表示は編曲後の音声時間に対応し、実際の通信遅延ではありません。実測値はその測定点の値です。 動くバーは再生状態と電力の演出で、音声スペクトラムではありません。
WAVと対応するスコアから、プロトコル表示・通信方向・電力に応じた動きを含む 1280×720の音付きMP4を生成できます。画面録画ではなく、各フレームを直接描画します。 音声はWAVからAACに変換されます。
libx264／AAC対応のFFmpegをインストールしてPATHを通し、追加のPython依存を入れます。
python -m pip install -r requirements-video.txt
python pd_musicus.py examples/avs_5a_pd.csv --asd examples/avs_5a_asd.csv --mode power --plan-only --out output/avs_5a_video.wav
python pd_musicus_video.py examples/avs_5a.wav --score output/avs_5a_video.score.json --out output/avs_5a.mp4 --title "EPR AVS / 5 A"--plan-only のコマンドは同梱WAVに対応する既定テンポのスコアだけを生成します。
自分のログでは、同じ生成処理から得たWAVとスコアを指定してください。
長さの一致は検証しますが、同一セッション由来であることまでは判定できません。
--fps 24|30|60（既定30）、--font フォント.ttf、--ffmpeg 実行ファイル、
--overwriteを指定できます。動画は最大600秒です。
音楽上の時刻に同期し、リセットも表示します。CTS入力では測定ケースを表示します。
書き出しは専用CLIから行います。ブラウザのプレイヤーに書き出しボタンはありません。
手元のログに合わせて、音楽生成の引数を選びます。
| 手元のログ | pd_musicus.py に渡す引数 |
|---|---|
| CY4500 Utility形式のPD CSV：通信全体の掛け合い | captures/pd.csv --mode duet |
| CY4500 Utility形式のPD CSV：EPR AVS掃引 | captures/pd.csv --mode avs |
| 同一試験のPD CSV＋ASD AVS CSV | captures/pd.csv --asd captures/asd.csv --mode power |
| ASDのCTS-like測定CSV | captures/cts.csv --mode cts |
例えば実測電力に応じた音楽と動画を作る場合：
python pd_musicus.py "captures/pd.csv" --asd "captures/asd.csv" --mode power --out "output/my_session.wav"
python pd_musicus_video.py "output/my_session.wav" --score "output/my_session.score.json" --out "output/my_session.mp4" --title "My PD session"入力パスを自分のファイルに置き換えてください。1行目でWAVと対応するスコアJSONを生成し、
2行目でMP4にします。各コマンドはPowerShellでもそのまま1行で実行できます。
作り直す場合は各コマンドに --overwrite を追加します。
音楽生成の長さ上限は既定180秒。長い編曲には pd_musicus.py 側に
--max-seconds 600 を付けられます（最大600秒）。
対応するCSV形式が対象で、任意の測定器の出力を読み込めるわけではありません。 CTSだけなら測定ケースを表示し、PDメッセージは推測しません。 実測電力の表示には対応するASDデータが必要で、PD要求値だけでは実測値になりません。
同じ21 → 48 → 21 VのEPR AVS掃引を、異なる負荷で演奏しました。
| サンプル | 音の特徴 | WAV |
|---|---|---|
| 0.5 A：約10～24 W | 柔らかいピアノ／マリンバ風 | 試聴・ダウンロード |
| 5 A：約105～239 W | 電力に応じてギター・ドラム・連打が増加 | 試聴・ダウンロード |
どちらも約45秒。同じ電力連動モードとテンポを使っています。 ブラウザーによってはダウンロードして再生してください。 元データと再生成手順も同梱しています。
Python 3.10以降。音楽生成とブラウザープレイヤーには外部パッケージは不要です。
MP4出力だけはPillow（requirements-video.txt）とlibx264／AAC対応のFFmpegが必要です。
各Pythonファイルを同じフォルダーに置き、リポジトリのルートで実行します。
保存済みログを使うため、試聴・再生成に測定機器は必要ありません。
python pd_musicus.py examples/avs_5a_pd.csv --asd examples/avs_5a_asd.csv --out output/demo.wav独自のPDキャプチャから掛け合いを作る例：
python pd_musicus.py captures/session_pd.csv --out output/duet.wav| モード | 入力 | 内容 |
|---|---|---|
auto（既定） |
CSV | CTS列があればcts、PD＋--asdならpower、それ以外はduet |
conversation |
CY4500 Utility形式のPD CSV | 電子音による掛け合い |
duet |
同上 | 拍に揃えたピアノ／マリンバ風と伴奏 |
avs |
同上 | EPR AVS要求電圧を五音音階へ変換 |
power |
PD CSV＋同一試験のASD AVS CSV | 実測ワット数でギター・ドラムの密度を変更 |
cts |
ASD CTS-like CSV | 要求電圧と実測電力をギターリフへ変換 |
python pd_musicus.py captures/sweep_pd.csv --mode avs --bpm 120 --out output/avs.wav
python pd_musicus.py captures/cts_asd.csv --mode cts --out output/guitar.wav
python pd_musicus.py captures/session_pd.csv --plan-only --out output/preview.wav
python pd_musicus.py --help--bpm：30～240。既定値はモードによって異なります。--out：保存先。省略時はoutput/<入力名>_musicus.wav。--plan-only：音声を作らずJSONだけ生成。--overwrite：既存の出力を明示的に上書き。--max-seconds：編曲の長さ上限。既定180秒、最大600秒。途中で切らず、長すぎる入力を拒否します。
電圧で音域、実測ワット数で音色・音数・リズム密度が変わります。 powerモードは30 W以下で追加パートなし、240 Wで最大強度です。 ctsは0～240 Wを強度0～1に対応させます。
Soft Resetは下降するベル、Hard Resetは低い歪み音として区別します。 AVS中心の編曲でもリセットを残しますが、再生位置は前後の編曲イベントから補間したものです。 CTSのfailed状態は不協和音で残し、測定失敗から実際のPDリセットを推測することはしません。
音色は合成音で、和音・リフ・伴奏・ドラムの具体的な譜面は創作です。 演奏時間は圧縮・再配置され、実際の通信遅延を表しません。
- 44.1 kHz／16 bit／ステレオWAV。ピークを0.82に正規化。
- 同名の
.score.json。元ログの参照、実測値、再生時刻、全音符を保存。
ログ読込み、編曲、音声化を分離しています。タイムライン仕様は、 将来のプロトコル逐次表示や電力連動の視覚効果に使えます。 同期プレイヤーと動画書き出しを同梱しています。録音サンプル音源は未実装です。
- PD入力はUtility形式CSVのみ。旧CLIのバイト列表現CSV、JSONL、scope CSVは未対応。
- EPR AVSはEPR_REQUEST同梱PDOで単位を判別。PPS／SPR AVSの電圧解釈、拡張PDO再構成は未実装。
- powerはASDの
avs-continuous行とPD要求の点数・順序・要求電圧／電流を照合。初期負荷ランプは省きます。 - PD／ASD間のクロック同期は行いません。必ず同一試験のファイルを指定してください。
- ctsは同一ケースの連続行をまとめて実測電力の中央値を使います。欠損値や未対応形式は拒否する場合があります。
- 認証の合否判定や測定エラーの原因診断をするツールではありません。
python -m unittest -v
node player/test_timeline.cjsテストは人工データを使用し、ハードウェア不要です。
JavaScriptテストの実行だけはNode.jsが必要です。プレイヤーの利用には不要です。
入口は pd_musicus.py。同じフォルダーの pd_music.py、avs_music.py、
power_music.py、cts_music.py も必要です。旧コマンドは互換用に残しています。
個人の測定ログ・生成音声はGit対象外です。examples/ のサンプルだけを公開しています。
コード、同梱CSV、合成WAVはMITライセンスです。第三者の楽器録音は含みません。