slaclab · bengineerd · May 22, 2026 · May 22, 2026 · May 22, 2026 · May 22, 2026
diff --git a/docs/plans/rssi-regression/README.md b/docs/plans/rssi-regression/README.md
@@ -0,0 +1,15 @@
+# RSSI Regression Task
+
+This directory tracks the plan for adding focused cocotb regressions for the
+SURF RSSI RTL under `protocols/rssi/v1/`.
+
+Current status: the RSSI regression suite now covers the original leaf-FSM and
+core integration findings plus the 2026-05-28 follow-up expansion for partial
+`TKEEP`, BUSY recovery, reconnect lifecycle, full-core AXI-Lite control,
+checksum-disabled integration, and transport-output backpressure. The latest
+coverage notes and validation commands are in `progress.md`; compact resume
+context is in `handoff.md`.
+
+Start with `handoff.md` when resuming implementation. Use `plan.md` for the
+original test strategy, `progress.md` for chronological status and validation,
+and `rtl-changes.md` for production RTL changes made during the task.
diff --git a/docs/plans/rssi-regression/handoff.md b/docs/plans/rssi-regression/handoff.md
diff --git a/docs/plans/rssi-regression/plan.md b/docs/plans/rssi-regression/plan.md
diff --git a/docs/plans/rssi-regression/progress.md b/docs/plans/rssi-regression/progress.md
diff --git a/docs/plans/rssi-regression/references/README.md b/docs/plans/rssi-regression/references/README.md
@@ -0,0 +1,52 @@
+# RSSI Reference Bundle
+
+This directory holds local reference material for the RSSI regression task.
+Use these files before reaching back to external sites or the Rogue checkout.
+
+## Confluence
+- `confluence/reliable-slac-streaming-protocol-rssi.html`
+  - Local copy of the SLAC Confluence page:
+    <https://confluence.slac.stanford.edu/spaces/ppareg/pages/211782868/Reliable+SLAC+Streaming+Protocol+RSSI>
+  - This is the primary RSSI protocol reference for header format, connection
+    behavior, parameter negotiation, data flow, retransmission, NULL segments,
+    BUSY flow control, and known deviations from RUDP.
+- `confluence/attachments/`
+  - Local copies of the diagrams and Word export linked from the primary RSSI
+    protocol page.
+- `confluence/rssi-discussions.html`
+  - Attempted local copy of:
+    <https://confluence.slac.stanford.edu/spaces/ppareg/pages/198085574/RSSI+Discussions>
+  - The retrieved page redirects to SLAC SSO from this environment.
+- `confluence/rssi-discussions-viewpage.html`
+  - Same page requested through `viewpage.action?pageId=198085574`; also
+    redirects to SLAC SSO.
+- `confluence/rssi-discussions-rest.json`
+  - REST API retrieval attempt. The saved response shows rate limiting after
+    the SSO redirects. Treat the RSSI Discussions content as not locally
+    available until someone with authenticated Confluence access exports it.
+
+## RFC And RUDP Background
+- `rfc/rfc908.txt`
+  - RFC 908, Reliable Data Protocol.
+- `rfc/rfc1151.txt`
+  - RFC 1151, Version 2 of the Reliable Data Protocol.
+- `rfc/draft-ietf-sigtran-reliable-udp-00.txt`
+  - Reliable UDP Protocol Internet-Draft.
+- `rfc/draft-ietf-sigtran-reliable-udp-00.html`
+  - Datatracker HTML copy of the same draft.
+
+These are background references. The SLAC Confluence RSSI page and SURF/Rogue
+implementation define the concrete RSSI subset under test.
+
+## Rogue Documentation
+- `rogue/built_in_protocols_rssi_index.rst`
+- `rogue/built_in_protocols_rssi_client.rst`
+- `rogue/built_in_protocols_rssi_server.rst`
+- `rogue/built_in_protocols_network.rst`
+- `rogue/api_cpp_protocols_rssi_*.rst`
+- `rogue/api_python_rogue_protocols_rssi_index.rst`
+- `rogue/api_python_pyrogue_network_udprssipack.rst`
+
+These are copied from `/Users/bareese/rogue/docs/src/` and document how Rogue
+uses RSSI in normal UDP/RSSI/packetizer deployments.
+
diff --git a/docs/plans/rssi-regression/references/confluence/attachments/RssiDoc.docx b/docs/plans/rssi-regression/references/confluence/attachments/RssiDoc.docx
diff --git a/...plans/rssi-regression/references/confluence/attachments/rssi-connection-fsm.png b/...plans/rssi-regression/references/confluence/attachments/rssi-connection-fsm.png
diff --git a/...rssi-regression/references/confluence/attachments/rssi-flow-control-example.png b/...rssi-regression/references/confluence/attachments/rssi-flow-control-example.png
diff --git a/...rssi-regression/references/confluence/attachments/rssi-flow-control-summary.png b/...rssi-regression/references/confluence/attachments/rssi-flow-control-summary.png
diff --git a/.../rssi-regression/references/confluence/attachments/rssi-full-duplex-example.png b/.../rssi-regression/references/confluence/attachments/rssi-full-duplex-example.png
diff --git a/.../rssi-regression/references/confluence/attachments/rssi-half-duplex-example.png b/.../rssi-regression/references/confluence/attachments/rssi-half-duplex-example.png
diff --git a/.../plans/rssi-regression/references/confluence/attachments/rssi-header-format.png b/.../plans/rssi-regression/references/confluence/attachments/rssi-header-format.png
diff --git a/.../plans/rssi-regression/references/confluence/attachments/rssi-null-segments.png b/.../plans/rssi-regression/references/confluence/attachments/rssi-null-segments.png
diff --git a/...si-regression/references/confluence/attachments/rssi-retransmission-example.png b/...si-regression/references/confluence/attachments/rssi-retransmission-example.png
diff --git a/docs/plans/rssi-regression/references/confluence/attachments/rssi-syn-segment.png b/docs/plans/rssi-regression/references/confluence/attachments/rssi-syn-segment.png
diff --git a/docs/plans/rssi-regression/references/confluence/reliable-slac-streaming-protocol-rssi.html b/docs/plans/rssi-regression/references/confluence/reliable-slac-streaming-protocol-rssi.html
diff --git a/docs/plans/rssi-regression/references/confluence/rssi-discussions-rest.json b/docs/plans/rssi-regression/references/confluence/rssi-discussions-rest.json
@@ -0,0 +1 @@
+<!doctype html><html lang="en"><head><title>HTTP Status 429 – Too Many Requests</title><style type="text/css">body {font-family:Tahoma,Arial,sans-serif;} h1, h2, h3, b {color:white;background-color:#525D76;} h1 {font-size:22px;} h2 {font-size:16px;} h3 {font-size:14px;} p {font-size:12px;} a {color:black;} .line {height:1px;background-color:#525D76;border:none;}</style></head><body><h1>HTTP Status 429 – Too Many Requests</h1><hr class="line" /><p><b>Type</b> Status Report</p><p><b>Message</b> Rate limit exceeded.</p><p><b>Description</b> The user has sent too many requests in a given amount of time ("rate limiting").</p><hr class="line" /><h3>Apache Tomcat/9.0.113</h3></body></html>
diff --git a/docs/plans/rssi-regression/references/confluence/rssi-discussions-viewpage.html b/docs/plans/rssi-regression/references/confluence/rssi-discussions-viewpage.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="decorator" content="none"/><script src="/s/7ylds/9114/1yg1r0c/5.1.24/_/download/resources/com.atlassian.plugins.authentication.atlassian-authentication-plugin:save-fragment/js.cookie.js"></script><script>if(window.location.hash) {var expirationDate = new Date(); expirationDate.setTime(expirationDate.getTime() + 60000 * 5); Cookies.set('atlassian-authentication-plugin-url-fragment_aabc7e8f-9b3a-440c-82c7-0dc2427010de', window.location.hash.substr(1), {expires : expirationDate, path : '', secure: true, SameSite: 'None' });}window.location.assign("https://slac-rs2.proxy.cirrusidentity.com/saml2/idp/SSOService.php?SAMLRequest=jZJRb8IgFIX%2FSsN7S8vWpiFq4uaymThrbLeHvSxIUUla6Lhg3L8frZq5F7M3DnA%2BzrlhBKxtOjp1dq%2FW4ssJsMGxbRTQ4WCMnFFUM5BAFWsFUMtpOX1dUBLFtDPaaq4bdGW57WAAwlipFQrmszEqlk%2BL4nm%2B%2FGS52MZ3LA9Zzjfh%2FYZlflWTMM04T5MkzfNEoOBdGPDeMfIoDwBwYq7AMmX9VkyyME5DQqokoymhCflAwcz3kYrZwbW3tgOKMTSMhwZI5PMfvyMujXEga6GstF7qFvdFCJZ1h8uyKIU5SC6ibt%2BhYHWu%2FCBVLdXudtvN6RLQl6pahauirFAwvUzgUStwrTBn%2FNt68ZuQa7VtnFD%2B1T5s1HfcalNHona4a9xOKsCec2iEHcLyMwxNRr2kw2zM5D%2B8Eb52nNTfDzH5AQ%3D%3D&RelayState=aabc7e8f-9b3a-440c-82c7-0dc2427010de");</script></head><body></body></html>
diff --git a/docs/plans/rssi-regression/references/confluence/rssi-discussions.html b/docs/plans/rssi-regression/references/confluence/rssi-discussions.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="decorator" content="none"/><script src="/s/7ylds/9114/1yg1r0c/5.1.24/_/download/resources/com.atlassian.plugins.authentication.atlassian-authentication-plugin:save-fragment/js.cookie.js"></script><script>if(window.location.hash) {var expirationDate = new Date(); expirationDate.setTime(expirationDate.getTime() + 60000 * 5); Cookies.set('atlassian-authentication-plugin-url-fragment_5c345168-12bf-4166-828b-3c6a80a62940', window.location.hash.substr(1), {expires : expirationDate, path : '', secure: true, SameSite: 'None' });}window.location.assign("https://slac-rs2.proxy.cirrusidentity.com/saml2/idp/SSOService.php?SAMLRequest=jZJfb8IgFMW%2FSsN7S8usf4iauLlsJk6N7fawl4VSVJIWOi4Y9%2B1Hq8vci9njgXt%2BnHPDGFhdNXTm7EFtxacTYINTXSmg3cUEOaOoZiCBKlYLoJbTbPaypCSKaWO01VxX6Mpy28EAhLFSKxQs5hO0Xj0u10%2BL1UecFEwQUYbxMB2EvaS8C4esl4S9IRsNeJGOSJGi4E0Y8N4J8igPAHBiocAyZf1RTPphnIaE5EmfpglN03cUzH0fqZjtXAdrG6AYQ8V4aIBEPv%2FpK%2BLSGAeyFMpK66WucVuEYFk2OMvWmTBHyUXUHBoUbC6V76Uqpdrfbluch4A%2B5%2Fkm3KyzHAWznw08aAWuFuaCf90ufxNyrXaVE8q%2F2oaN2o47bcpIlA43ldtLBdhzjpWwXVh%2BgaHpuJW0242Z%2Foc3xteOs%2Fr7Iabf&RelayState=5c345168-12bf-4166-828b-3c6a80a62940");</script></head><body></body></html>
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		<!doctype html><html lang="en"><head><title>HTTP Status 429 – Too Many Requests</title><style type="text/css">body {font-family:Tahoma,Arial,sans-serif;} h1, h2, h3, b {color:white;background-color:#525D76;} h1 {font-size:22px;} h2 {font-size:16px;} h3 {font-size:14px;} p {font-size:12px;} a {color:black;} .line {height:1px;background-color:#525D76;border:none;}</style></head><body><h1>HTTP Status 429 – Too Many Requests</h1><hr class="line" /><p><b>Type</b> Status Report</p><p><b>Message</b> Rate limit exceeded.</p><p><b>Description</b> The user has sent too many requests in a given amount of time ("rate limiting").</p><hr class="line" /><h3>Apache Tomcat/9.0.113</h3></body></html>
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"/><meta name="decorator" content="none"/><script src="/s/7ylds/9114/1yg1r0c/5.1.24/_/download/resources/com.atlassian.plugins.authentication.atlassian-authentication-plugin:save-fragment/js.cookie.js"></script><script>if(window.location.hash) {var expirationDate = new Date(); expirationDate.setTime(expirationDate.getTime() + 60000 * 5); Cookies.set('atlassian-authentication-plugin-url-fragment_aabc7e8f-9b3a-440c-82c7-0dc2427010de', window.location.hash.substr(1), {expires : expirationDate, path : '', secure: true, SameSite: 'None' });}window.location.assign("https://slac-rs2.proxy.cirrusidentity.com/saml2/idp/SSOService.php?SAMLRequest=jZJRb8IgFIX%2FSsN7S8vWpiFq4uaymThrbLeHvSxIUUla6Lhg3L8frZq5F7M3DnA%2BzrlhBKxtOjp1dq%2FW4ssJsMGxbRTQ4WCMnFFUM5BAFWsFUMtpOX1dUBLFtDPaaq4bdGW57WAAwlipFQrmszEqlk%2BL4nm%2B%2FGS52MZ3LA9Zzjfh%2FYZlflWTMM04T5MkzfNEoOBdGPDeMfIoDwBwYq7AMmX9VkyyME5DQqokoymhCflAwcz3kYrZwbW3tgOKMTSMhwZI5PMfvyMujXEga6GstF7qFvdFCJZ1h8uyKIU5SC6ibt%2BhYHWu%2FCBVLdXudtvN6RLQl6pahauirFAwvUzgUStwrTBn%2FNt68ZuQa7VtnFD%2B1T5s1HfcalNHona4a9xOKsCec2iEHcLyMwxNRr2kw2zM5D%2B8Eb52nNTfDzH5AQ%3D%3D&RelayState=aabc7e8f-9b3a-440c-82c7-0dc2427010de");</script></head><body></body></html>