docs(arch): Add ARCHITECTURE.md and CLAUDE.md, init repo

Bring the Blanton Tera Term TTL test suite under version control and
document how the pieces fit together.

- ARCHITECTURE.md: A/B/C script roles, host-to-DUT-to-FPGA data path,
  config/settings/profile data models, PCIe AER + EDAC topology table,
  10 key constraints, and 6 development phases derived from the
  Status_20260814 spreadsheet's On-Going items
- CLAUDE.md: stack, smoke-test commands, conventions, and the hardware
  footguns (per-unit BDF, VSPI vs VI2C timing, repeated START,
  STORE_USER_ALL, ARB_LOST false positives)
- secret/: gitignored credential store with README + .example template,
  so the DUT login stops living in 1_Blanton_Script_A.ttl
- .gitignore: secret/*, For_AI/, *.log, publish/, *.DSN

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014RetWKFZFG1ZHcitQAyhwM
This commit is contained in:
2026-08-17 08:52:11 +08:00
co-authored by Claude Opus 5
commit 24c704c667
60 changed files with 8637 additions and 0 deletions
@@ -0,0 +1,2 @@
wait prompt_sonic_root
sendln "kill $(jobs -p)"
@@ -0,0 +1,4 @@
wait prompt_sonic_root
sendln "lspci -tvvv"
wait prompt_sonic_root
sendln "lspci -vv"
@@ -0,0 +1,14 @@
wait prompt_sonic_root
sendln "show platform summary"
wait prompt_sonic_root
sendln "show platform fan"
wait prompt_sonic_root
sendln "show platform temperature"
wait prompt_sonic_root
sendln "show platform psustatus"
wait prompt_sonic_root
sendln "show platform voltage"
wait prompt_sonic_root
sendln "show platform current"
wait prompt_sonic_root
sendln "show platform ssdhealth"
@@ -0,0 +1,8 @@
wait prompt_sonic_root
sendln "date"
wait prompt_sonic_root
sendln "dmesg | grep -i error"
wait prompt_sonic_root
sendln "dmesg | grep -i fail"
wait prompt_sonic_root
sendln "dmesg | grep -i warning"
@@ -0,0 +1,46 @@
wait prompt_sonic_root
sendln "source ~/Blanton_Script/LTC2980_Margin_Script/script/margin_status_all.sh"
/*
wait prompt_sonic_root
sendln "margin_init Blanton_CB_CONN13.conf"
wait prompt_sonic_root
sendln "margin_init Blanton_CB_CONN13.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB0_CONN13.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB0_CONN14.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB0_CONN15.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB0_CONN16.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB1_CONN13.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB1_CONN14.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB1_CONN15.conf"
wait prompt_sonic_root
sendln "margin_status"
wait prompt_sonic_root
sendln "margin_init Blanton_SWB1_CONN16.conf"
wait prompt_sonic_root
sendln "margin_status"
*/
@@ -0,0 +1,10 @@
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000\:00\:01.2/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000\:00\:01.2/aer_dev_fatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000\:00\:01.2/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank0/dimm_ce_count"
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank0/dimm_ue_count"
@@ -0,0 +1,15 @@
;Endpoint AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:03:00.0/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:03:00.0/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:03:00.0/aer_dev_fatal"
;Upstream root-port AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.4/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.4/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.4/aer_dev_fatal"
@@ -0,0 +1,23 @@
;EDAC channel 0 (sysfs rank0)
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank0/dimm_ce_count"
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank0/dimm_ue_count"
;EDAC channel 1 (sysfs rank1)
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank1/dimm_ce_count"
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank1/dimm_ue_count"
;EDAC channel 2 (sysfs rank2)
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank2/dimm_ce_count"
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank2/dimm_ue_count"
;EDAC channel 3 (sysfs rank3)
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank3/dimm_ce_count"
wait prompt_sonic_root
sendln "cat /sys/devices/system/edac/mc/mc0/rank3/dimm_ue_count"
@@ -0,0 +1,7 @@
;Shared upstream root-port AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.5/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.5/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.5/aer_dev_fatal"
@@ -0,0 +1,15 @@
;Endpoint AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:07:00.0/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:07:00.0/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:07:00.0/aer_dev_fatal"
;Upstream root-port AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:02.4/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:02.4/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:02.4/aer_dev_fatal"
@@ -0,0 +1,15 @@
;Endpoint AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:06:00.0/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:06:00.0/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:06:00.0/aer_dev_fatal"
;Upstream root-port AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:02.1/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:02.1/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:02.1/aer_dev_fatal"
@@ -0,0 +1,15 @@
;Endpoint AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:01:00.0/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:01:00.0/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:01:00.0/aer_dev_fatal"
;Upstream root-port AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.1/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.1/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.1/aer_dev_fatal"
@@ -0,0 +1,15 @@
;Endpoint AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:02:00.0/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:02:00.0/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:02:00.0/aer_dev_fatal"
;Upstream root-port AER
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.2/aer_dev_correctable"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.2/aer_dev_nonfatal"
wait prompt_sonic_root
sendln "cat /sys/bus/pci/devices/0000:00:01.2/aer_dev_fatal"