xref: /aosp_15_r20/external/trace-cmd/scripts/debug/tsync_readme (revision 58e6ee5f017f6a8912852c892d18457e4bafb554)
1*58e6ee5fSAndroid Build Coastguard WorkerPTP-like algorithm debug
2*58e6ee5fSAndroid Build Coastguard Worker========================
3*58e6ee5fSAndroid Build Coastguard Worker
4*58e6ee5fSAndroid Build Coastguard Workertsync_*.py scripts can be used to visualise debug files, written when the PTP-like algorithm
5*58e6ee5fSAndroid Build Coastguard Workeris compiled with TSYNC_DEBUG defined. The files are located in the guest machine:
6*58e6ee5fSAndroid Build Coastguard Worker    s-cid*.txt - For each offset calculation: host and guest clocks and calculated offset.
7*58e6ee5fSAndroid Build Coastguard Worker    res-cid*.txt - For each tracing session: all calculated clock offsets.
8*58e6ee5fSAndroid Build Coastguard Worker
9*58e6ee5fSAndroid Build Coastguard Workertsync_hist.py plots a histogram, using data from a s-cid*.txt file:
10*58e6ee5fSAndroid Build Coastguard Worker	"python tsync_hist.py s-cid2_1.txt"
11*58e6ee5fSAndroid Build Coastguard Workertsync_res.py plots a line, using data from res-cid*.txt file:
12*58e6ee5fSAndroid Build Coastguard Worker	"python tsync_res.py res-cid2.txt"
13