docs: Record V1.2.5 in Script A's history and add the release note

Script A: header to V1.2.5 / 2026-10-21; entries for
blanton_ber_debug.sh, retimer_lanes.sh, unused_lanes.sh, the PMON power
readback, the --force on the USB stress, the boot cycle title and the
fast boot cycle, with notes on p=p31 vs blanton_ber.sh's p=3, the
missing port 268, the double read in Script 4, the exec bits and the
EN_Cold_Warm_boot = 0 hang.

CLAUDE.md / ARCHITECTURE.md: status and release to V1.2.5, the new
scripts in the overview, the tree and the commands.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0131orciRKrejchsuDk6UpXk
This commit is contained in:
2026-10-21 09:01:55 +08:00
co-authored by Claude Opus 5.5
parent f378340f41
commit 16da1c68f2
4 changed files with 139 additions and 7 deletions
+56 -2
View File
@@ -1,7 +1,7 @@
; =============================================================================
; Script A for Blanton
; Version : V1.2.4
; Date : 2026-10-01
; Version : V1.2.5
; Date : 2026-10-21
; Author : ETWen
; =============================================================================
; Version History:
@@ -794,6 +794,60 @@
; Diag vs SONiC comparison
; !! measures unit 0 only, port 268 not in the list, yet
; wait_init still waits for BOTH units (SWB_UNIT0/1 = 1)
; V1.2.5 2026-10-21 Blanton_Script/blanton_ber_debug.sh Created v1.0.0 - raw BER run of tools/BER_Test.txt
; prbs set p=p31, prbs get x2, prbsstat STArt Interval=30,
; sleep 40, Ber, STOp, prbs clear. Every bcmcmd output is
; printed as is under a '### [time] unit N: ...' header - no
; parsing, no PASS/FAIL, no summary. -u 0 / -u 1, default both
; BER_POLY / BER_INTERVAL / BER_WAIT / BER_PORTS overridable
; !! the port list is the 200G ports only, no 268 - same as
; BER_Test.txt. BER_PORTS="...,268" adds the 100G uplink
; !! p=p31 is verified on the bench. blanton_ber.sh (and so
; Script A / C) still sets p=3 - the two runs do not measure
; the same pattern unless p=3 is PRBS31 as well
; !! standalone, no TTL calls it
; Blanton_Script/retimer_lanes.sh Created - TX off / on / status for lanes of one Agera3 retimer
; retimer_lanes.sh <asic 0|1> <addr> <lane_map> <off|on|status>
; Acts on the sys AND the line side. --method squelch (default,
; TX squelch, lanes stay powered) or power (TX+RX power-down,
; needs an agera3 with the 'power' command - exit 4 if not)
; Reads back after the change: PASS / FAIL, exit 3 on mismatch
; !! 'off' is REFUSED (exit 2) on a lane with RX PMD lock, i.e.
; one that receives a signal. --force overrides
; !! runs agera3 through sudo, 30 s timeout per call
; Blanton_Script/unused_lanes.sh Created - apply off / on / status to every unused lane
; Table at the top: 14 retimer rows (7 fully unused, 7 with
; lanes 4,5 unused) and 1 direct-TH6 row (TSC31, cd112-cd115),
; the same rows on both switch boards. Retimer rows go through
; retimer_lanes.sh, TH6 rows through 'port ... enable=' in
; syncdN's bcmcmd. --asic 0|1|all; --th6 also turns off the TH6
; ports behind the retimer rows; --only <target> for one row
; Ends with ok / refused / failed counts, exit 1 if any failed
; !! calls retimer_lanes.sh from its own directory and checks
; its exec bit - chmod +x both after deploying
; !! bash only (mapfile, [[ =~ ]]), not sh
; utils/setup_pmon.ttl Add TH6_SWB0 / TH6_SWB1 power readback after show platform current
; Every PMON snapshot (A / B / C / 4 / 5) now has the 19 rails
; of each switch board with V x I and TOTAL POWER
; !! Script 4 already called both readbacks in its loop right
; after setup_pmon - it now reads them TWICE per round
; !! every Script B soak round gets longer by both readbacks
; ScriptB Add --force to qfx5252-stress-usb
; 5_.._Boot_Cycle.ttl Window title shows the cycle count every round
; 'Reboot Cycle Test : n' (EN_Cold_Warm_boot = 1) or
; 'Power Cycle Test : n' (= 2), set with settitle
; Add --force to qfx5252-stress-usb, same as Script B
; 5_1_Blanton_Script_Boot_Cycle_Fast.ttl Added - Script 5 without the traffic run, a STANDALONE macro
; Identical to 5_.._Boot_Cycle.ttl except that Check Pt8 runs
; only 'blanton_traffic_linespeed ps' - no init / clear / show
; / start / pause 15 / stop / report. A shorter cycle when the
; point is the number of boots
; !! a second copy of the same macro: a fix to one has to be
; made to the other as well
; !! EN_Cold_Warm_boot = 0 (the config.ttl default) hangs it,
; same as Script 5
; tools/BER_Test.txt p=3 -> p=p31; add a unit 1 block, a both-units block and
; port en=0 / en=1 for all cabled ports on each unit
; =============================================================================
include "config.ttl"