================================================================================
Rapid Eye Analysis — 演示资产 / Demo Assets
================================================================================

本文件夹提供开箱即用的演示数据。第一次使用请打开 帮助 → 快速入门指南 —
它基于本文件夹手把手走遍全部常用功能; 详细操作见 帮助 → 操作手册 (F1)。
This folder provides ready-to-use demo data. First time here? Open
Help -> Quick Start Guide — a hands-on tour built entirely on these files.
For details see Help -> Manual (F1).

--------------------------------------------------------------------------------
1. sparams\ — S 参数通道文件 / S-parameter channel files
--------------------------------------------------------------------------------
  demo_channel_clean.s4p   低损短通道 (0-30 GHz)。快速入门第一张眼图用它:
                           清空输入文件 → 添加此文件 → 加载 configs 下的
                           NRZ_28G_baseline.json → 生成眼图。
                           Clean short channel. Use it for your first eye
                           (manual Chapter 3): clear inputs, add this file,
                           load NRZ_28G_baseline.json, then Generate.

  lossy_channel_10dB.s4p   高损通道 (约 10 dB @ 26.56 GHz)。配合 PAM4
                           53.125 GBaud 演示均衡器效果: 未均衡时眼几乎闭合,
                           从 NRZ 基准配置开始，改为 PAM4 53.125 GBaud，
                           优化 TX FFE → CTLE (IEEE 802.3 / 802.3ck-C2C)
                           → RX FFE + DFE 联合优化。参照快速入门第 3 步。
                           Lossy channel (~10 dB @ Nyquist for 53.125 GBaud
                           PAM4). Start from the NRZ baseline, set PAM4/53.125,
                           optimize TX FFE, select IEEE 802.3 / 802.3ck-C2C and
                           optimize CTLE, then jointly optimize RX FFE + DFE.

  demo_trace.s2p           2 端口走线, 适合 TDR / 史密斯圆图 / 格式转换演示。
                           2-port trace for TDR / Smith chart / conversion.

  fixture_2inch.s2p        短测试夹具 (0.15 ns, 低损)。级联/去嵌教学:
                           级联 = 夹具+走线+夹具; 去嵌 = 从
                           trace_with_fixture.s2p 中扣除左右夹具还原走线。
                           Short test fixture. Cascade = fixture + trace +
                           fixture; de-embed removes it from
                           trace_with_fixture.s2p.

  trace_with_fixture.s2p   "带着夹具测出来"的走线 (fixture ⊗ demo_trace ⊗
                           fixture 预级联)。去嵌演示的 DUT。
                           The trace "as measured with fixtures" — DUT for
                           the de-embedding demo.

  xtalk_aggressor.s4p      串扰侵扰通道 (耦合线)。眼图页勾选"串扰注入"
                           添加为 FEXT, 幅度建议 0.1 V。
                           Crosstalk aggressor. Add as FEXT under
                           "Crosstalk Injection"; 0.1 V amplitude suggested.

  long_channel.s4p         长通道。"分割"窗口按 2x-thru 拆两半的演示件。
                           Long channel for the Split window (2x-thru).

--------------------------------------------------------------------------------
2. com_import\ — COM 导入模板 / COM import templates
--------------------------------------------------------------------------------
  三套 IEEE 802.3 COM 参考场景 (50G / 120G / 212G), 每套含:
    *_results.csv  — COM 工具结果 (菜单"COM 导入"选择它)
    config.xlsx    — COM 配置 Excel (对话框第二栏选择它)
    thru.s4p       — 对应通道 (对话框 Victim S 参数选择它)
  Three IEEE 802.3 COM reference scenarios (50G / 120G / 212G). In the
  "COM Import" dialog pick the CSV, the Excel, and thru.s4p, then OK —
  all signal/equalizer/package/noise parameters are imported in one click
  and a baseline eye is generated automatically.

  50G_KR_10dB    50 GbE KR,  9.8 dB 通道 / channel
  120G_C2C_10dB  120G C2C,   9.7 dB 通道 / channel
  212G_KR_8dB    212G KR dj, 8 dB 通道 / channel

--------------------------------------------------------------------------------
3. configs\ — 配置文件 / Configuration files
--------------------------------------------------------------------------------
  通过菜单 文件 → 加载配置 使用。两个 Normal 配置不含通道文件路径 — 请先在"输入文件"
  中添加 sparams\ 下的对应通道, 再加载配置, 最后点击"生成眼图"。
  Load via File -> Load Configuration. The two Normal configs omit channel paths:
  add the matching channel from sparams\ first, then load the config, then
  click Generate Eye.

  NRZ_28G_baseline.json    NRZ 28 GBaud 出厂默认风格配置
                           (搭配 demo_channel_clean.s4p)。
                           Factory-default style NRZ 28 GBaud
                           (pair with demo_channel_clean.s4p).

  PAM4_53G_full_EQ.json    PAM4 53.125 GBaud + 已优化的
                           TX FFE / CTLE / RX FFE / DFE 全链均衡
                           (搭配 lossy_channel_10dB.s4p)。
                           PAM4 53.125 GBaud with a fully optimized equalizer
                           chain (pair with lossy_channel_10dB.s4p).

  QuickStart_Optical_TDECQ.json
                           Expert: PAM4 53.125 / PRBS13 / 32 samples per UI
                           → E/O (40 GHz / ER 6 dB) → TDECQ → Eye Probe。
                           加载后点击运行；无需添加 S 参数文件。
                           Load and Run; no S-parameter input is needed.

  QuickStart_IBIS_AMI.json Expert: source → IBIS TX → lossy channel → IBIS RX
                           → Eye Probe。相对路径指向本 demo 内的模型和通道，
                           保留整个 demo 目录结构即可跨机器移动。
                           Load and Run. Paths are relative to this JSON file;
                           keep the demo folder structure when relocating it.
                           rea_ref 是演示参考模型，并非器件厂商模型。
                           rea_ref is a demonstration reference model.

--------------------------------------------------------------------------------
4. scpi_example.txt — SCPI 程控示例 / SCPI automation example
--------------------------------------------------------------------------------
  最常用的远程控制命令序列 (需 SCPI 选件授权), 可直接对 127.0.0.1:5025
  逐行发送。完整命令表见手册第 13 章。
  A ready-to-send command sequence for port 5025 (SCPI option required).
  Full command reference: manual Chapter 13.
================================================================================

--------------------------------------------------------------------------------
6. ibis\ — IBIS / IBIS-AMI 参考模型 / IBIS / IBIS-AMI reference models
--------------------------------------------------------------------------------
  rea_ref.ibs              IBIS 8.0 参考缓冲器: [Model] rea_ref_tx (25 Ω CML 类驱动,
                           Vcc 1.0 V, 12 ps 边沿, C_comp 0.12 pF) / rea_ref_rx (50 Ω
                           端接接收, C_comp 0.10 pF), SerDes 级 [Package]/[Pin] 寄生,
                           [Algorithmic Model] 指向下面的 AMI 文件。Expert 模式:
                           source → IBIS(TX) → S-Parameter → IBIS(RX) → Eye Probe,
                           IBIS 节点选此文件即自动填入 .ami/.dll。
                           IBIS 8.0 reference buffers (TX driver / RX termination)
                           with SerDes-class package parasitics and [Algorithmic
                           Model] entries. Expert: source -> IBIS(TX) -> channel ->
                           IBIS(RX) -> probe; picking this file auto-fills .ami/.dll.

  rea_ref_tx.ami/.dll      参考 AMI 发射器: 3 抽头 FFE (tap_pre/tap_post 可改),
                           Init 统计流 + GetWave 时域流均支持。
                           Reference AMI transmitter: 3-tap FFE, Init + GetWave.

  rea_ref_rx.ami/.dll      参考 AMI 接收器: CTLE (0/3/6 dB) + 自适应 DFE (0-4 抽头)
                           + bang-bang CDR (GetWave 返回 clock_times), Ignore_Bits 200。
                           Reference AMI receiver: CTLE + adaptive DFE + bang-bang
                           CDR returning clock_times; Ignore_Bits 200.

  rea_ref_tx_v8.ami /      IBIS 8.0 变体 (2026-09-09): §10.10 Ts4file 4 端口模拟缓冲
  rea_ref_rx_v8.ami        (rea_ref_tx_buf.s4p 13-24 / rea_ref_rx_buf.s4p 12-34) + Tx_V/
                           Tx_R/Rx_R、AMI_Resolve 依赖参数 (drive_level full/half → Tx_V)、
                           Max_Init_Aggressors 2 (串扰 aggressor 列)、8.0 Adaptation_Valid、
                           PAMn (Modulation_Levels/PAM_Thresholds)、BCI 链路训练 (私有协议
                           REA_BCI_1, Impulse/GetWave/Both)。IBIS 节点里把 .ami 指向它们即可。
                           IBIS 8.0 variants: Ts4file analog buffers, AMI_Resolve dependent
                           parameters, aggressor columns, Adaptation_Valid, PAMn, BCI training.

  rea_ref_rx_retimer.ami / 中继 RX 变体 (Repeater_Type Retimer / Redriver, IBIS §10.8): 链上
  rea_ref_rx_redriver.ami  IBIS(RX) 紧接 IBIS(TX) 即构成中继对, 可级联。
                           Repeater RX variants: an IBIS(RX) node directly followed by an
                           IBIS(TX) node forms a Retimer / Redriver pair.

  rea_ref.ibs (8.0)        第二组件 REA_REF_SERDES_IC (引脚 A1/A2/B1/B2) 带 [Package Model] RLC
  + rea_ref_ic.ims         矩阵、[Interconnect Model Group] Touchstone 封装 (rea_ref_pkg_tx/rx.s4p,
  + rea_ref_pkg_*.s4p      RX 对在 rea_ref_ic.ims) 与 [Repeater Pin]; 选引脚 A1/B1 并用节点的
                           "封装来源" 切换 §7.2 优先级 (interconnect / package_model / lumped)。
                           [AMI Test Configuration] ×3 (rea_ref_tc_*.txt golden 数据): SCPI
                           FETC:PIPE:IBIS:TEST? <节点>[,<配置名>] 跑模型并与 golden 比对。
                           Second component with [Package Model] / [Interconnect Model Group]
                           / [Repeater Pin] and three [AMI Test Configuration] golden sets.

  rea_ref_pkg.iss /        IBIS-ISS 1.0 子电路 (2026-09-09 补缺口批): [Interconnect Model Group]
  rea_ref_ic.ims           REA_IC_GROUP_ISS (节点"互连模型组"选它) → TX 对 = 键合线 + 焊盘电容 +
                           2 导体耦合有损 W 线, RX 对 = S 元件包裹的 Touchstone 封装; REA 内置
                           IBIS-ISS 线性求解器直接求解 (R/L/C/K/V/T/W/S/E/F/G/H/X, .param, .include)。
                           IBIS-ISS subcircuit packages solved by REA's built-in evaluator.

  rea_ref_ccomp.iss /      [C Comp Model] (IBIS 7.0+ §6.1): TX 裸片电容为 IBIS-ISS 网络 (0.12 pF +
  rea_ref_ccomp_rx.s2p     2 Ω ESR, Param Corner 三角), RX 为 Touchstone 2 端口 (Buffer_I/O 0.10 pF →
                           5 Ω → Buffer_I 0.02 pF, 接收输入取在 Buffer_I); 节点"C_comp 来源"可退回集总。
                           [C Comp Model] die networks (TX IBIS-ISS, RX Touchstone with Buffer_I).

  rea_ref_rx_support.txt   rea_ref_rx_v8.ami 的 Supporting_Files 条目: 接收器经 §10.5 DLL_Path 占位定位
                           该文件, 读取 gain_trim_db 并在输出参数报 support_file "found" / instance_id
                           (= DLL_ID)。 Located by the RX DLL through the DLL_Path placeholder.

  rea_ref_tx_jtable.ami /  §10.6 Table 格式抖动: Tx_Jitter 11 行概率表 (秒) / Rx_Clock_PDF 7 行 (UI, 统计流
  rea_ref_rx_pdftable.ami  采样时钟); REA 直接按表采样。 Table-format jitter PDFs sampled directly.

  rea_ref_rx_initonly_v8.ami  Init-only 的 8.0 接收器: 演示 §10.2.2 步骤 6d 方法 2 (单位冲激 aggressor 列
                           取 RX 滤波器; 节点 tx_getwave_rx_init=auto 默认优先)。
                           Init-only IBIS 8.0 receiver for step 6d method 2.

  注: 这些是 REA 自研的合成参考模型 (非任何真实硅片), 用于验证工具与演示; 真实
  IBIS-AMI 模型 (.ibs + .ami + 64 位 .dll) 由硅片厂商提供, 同样在 IBIS 节点里选取。
  支持范围: IBIS 8.0 §5-§7/§10/§12 的 SerDes 相关部分 (不含 DDR 类非线性 I-V/V-T 瞬态、
  [Submodel]/[Driver Schedule]、Rx_Use_Clock_Input 双输入时钟、IBIS-ISS 子电路)。
  Note: synthetic models authored for REA (not real silicon). Vendor IBIS-AMI kits
  (.ibs + .ami + 64-bit .dll) are loaded the same way.

--------------------------------------------------------------------------------
7. tdecq\ — 公众号《106.25 GBd 光眼的 TDECQ》可复现资产 / Assets of the TDECQ article
--------------------------------------------------------------------------------
  文章: 同一台 106.25 GBd PAM4 发射机在四档 ISI 下, 15 抽头 FFE 单独 vs 15 FFE + 1 DFE 联合、
  Table 180-16 钳制 / 去钳制 的 TDECQ 对比 (802.3dj Draft 3.1 Clause 180 预设)。
  The article compares 15-tap FFE alone vs 15 FFE + 1 DFE and clamped vs free Table 180-16
  limits for one 106.25 GBd PAM4 transmitter across four ISI cases (802.3dj D3.1 Clause 180 preset).

  host_mellitz_250mm.s4p        线性驱动那一档的主机走线 (IEEE 802.3dj 贡献 mellitz_3dj_02_2409, host package
                                + 250 mm 走线 case1, 差分配对 1)。 Host trace of the linear-drive case
                                (IEEE 802.3dj contribution mellitz_3dj_02_2409 case1, pairing 1).
  tdecq_bw32_ffe_only.json      调制器带宽 32 GHz, TDECQ 块只用 15 抽头 FFE (dfe_enabled 关)。
  tdecq_bw32_joint.json         调制器带宽 32 GHz, 15 FFE + 1 DFE 联合 (D3.1 预设原样)。
  tdecq_bw22_joint.json         调制器带宽 22 GHz, 联合。
  tdecq_host_mellitz_joint.json 主机走线 + 调制器 50 GHz, 联合 (载入时 S 参数按同目录同名回退, 无需改路径)。

  用法 / How to use: 文件 → 载入配置 → 选任一 json → 进入专家模式后点「运行管线」; 多眼视图给出均衡前/后
  两只光眼、直方图窗与 TDECQ / Ceq / 抽头 / b1。文章的"去钳制"对照 = 双击 TDECQ 节点把 规范档 (spec_profile)
  清空、dfe_b_max / dfe_tap_max 设 1.0; "单 FFE" = dfe_enabled 关。
  File -> Load Config -> pick a json -> Run Pipeline in Expert mode; the multi-eye view shows both eyes,
  the histogram windows and TDECQ / Ceq / taps / b1. "Free" = clear spec_profile and set dfe_b_max /
  dfe_tap_max to 1.0 in the TDECQ node; "FFE only" = dfe_enabled off.

  SCPI 序列 (文章数据即由此跑出; 端口 5025) / SCPI sequence used for the article:
    *RST
    CONF:MODE EXPERT
    CONF:PIPE:CLEAR
    CONF:PIPE:NODE:ADD source,src
    CONF:PIPE:NODE:ADD sparam,sp                   (仅主机走线档 / host-trace case only)
    CONF:PIPE:NODE:ADD eo,eo1
    CONF:PIPE:NODE:ADD fiber,f1
    CONF:PIPE:NODE:ADD tdecq,td1
    CONF:PIPE:CONN src,sp  /  CONF:PIPE:CONN sp,eo1  (无主机走线时 CONF:PIPE:CONN src,eo1)
    CONF:PIPE:CONN eo1,f1
    CONF:PIPE:CONN f1,td1
    CONF:PIPE:NODE:PAR src,data_rate,106.25
    CONF:PIPE:NODE:PAR src,signal_type,pam4
    CONF:PIPE:NODE:PAR src,pattern,PRBS13
    CONF:PIPE:NODE:PAR src,samples_per_ui,32
    CONF:PIPE:NODE:PAR src,amplitude,0.6
    CONF:PIPE:NODE:PAR src,snr_tx,30.0
    CONF:PIPE:NODE:PAR sp,file_path,<demo>/tdecq/host_mellitz_250mm.s4p
    CONF:PIPE:NODE:PAR sp,pairing,1
    CONF:PIPE:NODE:PAR eo1,lambda_nm,1310
    CONF:PIPE:NODE:PAR eo1,er_db,5
    CONF:PIPE:NODE:PAR eo1,drive_v_swing,0
    CONF:PIPE:NODE:PAR eo1,bandwidth_ghz,50        (或 32 / 22)
    CONF:PIPE:NODE:PAR f1,length_km,0.5
    CONF:PIPE:NODE:PAR f1,lambda_nm,1310
    CONF:PIPE:NODE:PAR td1,preset,IEEE 802.3dj D3.1 (Clause 180)
    CONF:PIPE:NODE:PAR td1,dfe_enabled,0            (单 FFE 口径 / FFE-only case)
    CONF:PIPE:NODE:PAR td1,spec_profile,            (去钳制 / free: 空值; 再设 dfe_b_max,1.0 与 dfe_tap_max,1.0)
    CONF:PIPE:RUN
    *OPC?
    FETC:PIPE:EYE? td1                              (TDECQ_dB / Ceq / ffe_taps / dfe_taps / opt_winner ...)
    FETC:PIPE:EYE? td1::before                      (均衡前眼 / eye before EQ)
