信号与性能类指南tec10t25-软硬件接口模板

1、项目名称软硬件接口主送对象抄送对象评审者蓝色字体使用时删除1）文档提交评审时需要给评审者预留足够的评审时间。需要哪些人评审依据项目的范围由项目团队界定。2）在本文档的撰写过程中，需要与相关利益人交流（清勿到开始评审时才与相关利益人进行交流，这样效率低，而且评审效果也比较差），请将撰写过程流的列在附件里面。修订日期修订版本修改者审核人修改描述部门/专业组评审者评审日期目录1.2.说明3软硬件约束说明32.1.2.2.2.3.2.4.2.5.适用的硬件基本信息3固件/微码版本3需要需要规避的硬件 BUG 简述43规避的硬件bug 详细信息4ERRATA 分析.53.软硬件接口说明653.1.管理部

2、分需求-地址分配653.1.1.3.1.2.3.1.3.3.1.4.3.1.5.3.1.6.Lbc 片选和地址空间65PCI 及PCIE 资源分配6中断分配6I2C 地址分配6PIO 分配76其他地址分配763.2.管理部分需求-寄存器配置73.2.1.基本接口寄存器配置73.3.交换部分软硬件接口15103.3.1.3.3.2.3.3.3.3.3.4.3.3.5.3.3.6.PHY 地址1510SMI 接口时钟（即确认 MDC 时钟）1511PP/MAC/FA/Crossbar 的地址说明1511PP/MAC 或PHY 的 GPP/GPIO1511链路对应关系说明1511其他16113.4.

3、通信部分软硬件接口16123.4.1.3.4.2.3.4.3.3.4.4.3.4.5.时钟源定义及分配1612时序操作要求评估1612端口对应说明1612寄存器配置要求评估1612其他1612插软硬件接口16123.5.3.6.其他接口说明17124.客户可见功能验收标准说明17134.1.客户可见功能具体说明17134.1.1.4.1.2.4.1.3.4.1.4.4.1.5.指示灯1713端口对应关系1814按键功能1814功能1915其他客户可见功能1915第 2 页 共 19 页1. 说明1目的1.1设计格式，避免软硬件上的疏漏明确接口人，同时为项目调试等及时做好准备，避免软硬件脱节。明

4、确软硬件适用范围等约束条件，避免软硬件使用错位；明确客户可见部分的验收标准，辅助软硬件建立测试用例，避免漏测；2说明1.1 本模板适用于所有网络自研产品。1.2 若有其他指南/模板有与本文档内容，以本文档内容为准。1.3 正文中的表格格式供参考，可根据实际情况作调整。1.4 为了便于查看，对于不适用的部分，可删除。2. 软硬件约束说明2.1. 适用的硬件基本信息共 PCB 设计产品差异说明：（例如 M8600-48GT/4SFP 与 M8600P-48GT/4SFP 的区别等）版本升级涉及变更点说明：(所有涉及到的变更均需作出说明)例：V1.00 升级为 V1.01ISP1562 变更为 SA

5、F1562.主要兼容情况：（USB 驱动，内存，flash，CPU，MAC，PHY 等）2.2. 固件/微码版本明确、固件/微码版本要求，并在备注中明确对SDK 的升级约束等。明确验收方法，比如哪些寄存器或者版本信息,以及如何。需要将硬件版本检查纳入硬件测试，需要可提交需求到测试。第 3 页 共 19 页型号固件/微码验收方式备注说明适用版本禁用版本备注说明硬件版本V1.10V1.0 xLED 点灯方式有变同步到 V1.0 x 版本版本10.4（2b19）P110.4（2b19）同上CPU 型号2.3. 需要规避的硬件 BUG 简述Bug 简述中需要对所有的 bug 分别做出简的产品及版本。明

6、。需要包括产品型号，bug，bug 现象以及适用2.4. 需要规避的硬件 bug 详细信息Bug 的详细信息中，需要包括如下内容，以方便后续查证，以表格方式填写填写说明问题严重级别判定方法按照问题的严重级别分为以下三种级别：最高：在合理的用户环境中导致产品不能稳定运行，或产品的某个子系统不能工作，或导致其他设备宕机。中等：某些功能无法使用，而且这种 BUG 并没有规避措施，但是产品的其他功能并且网络上的其他设备可正常使用。轻微：在某些特殊环境中一些功能无法使用，或者是一些小功能无法使用，或者某些功能失效但有相应的规避措施。规避方法内容该 BUG 是如何通过来规避及规避方法，如通过关闭相应功能或

7、配置进行规避。并对规避方法的风险，效率，副作用等方面进行描述。规避方法影响说明对规避方法的风险，效率，副作用等方面进行描述第 4 页 共 19 页Bug 1s575048GT/4SFP 长线驱动能力问题硬件 BUG-IDBUG 系统 IDBUG 发现时间适用的产品及版本问题描述Bug 序号Bug 名称Bug 简述适用的产品及版本2.5. 需要规避 bug 的寄存器约束表2.6. ERRATA 分析硬件需要解决的ERRATA 分析。，所有的 Errata 都要在这里进行说明和分析。确认已经解决或者无影响的可以简单说明；有解决对策的要给出详细的对策说明（寄存器修改、导入没有解决对策的，要给出风险评

8、估；的处理流程等）；第 5 页 共 19 页型号涉及产品型号ERRATA 分析寄存器地址命令完整命令行，包括地址位名称设置值写 16 进制格式测试模型对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值重现步骤原因问题严重级别规避方法规避方法影响提交人项目主管审核及时间3. 软硬件接口说明3.1. 管理部分需求-地址分配3.1.1.Lbc 片选和地址空间3.1.2.PCI 及 PCIE 资源分配3.1.3.中断分配3.1.4.I2C 地址分配第 6 页 共 19 页IIC地址分配说明备注器件I2C 地址RTCPCF85631010 001MPC8248 I2C

9、总线主板硬件信息24C021010 111MPC8248 I2C 总线PCA9548_aPCA95481110101MPC8248 I2C 总线PCA9548_bPCA95481110000MPC8248 I2C 总线SIC 124C021010 110PCA9548_a 扩展 I2C 通道 0中断资源分配中断引脚备注CPLDIRQ0#用作 SD 的中断BCM56024IRQ1#，IRQ2PCI 资源分配总线仲裁设备号备注5650XREQ0#，GNT0#,CLK0#,IDSEL=AD19。8248 的一级总线PCI2050BREQ1#，GNT1#,1#,CLK1#,IDSEL=AD20。824

10、8 的一级总线82551（连接 NMX 槽 1）REQ1#，GNT1#,CLK1#IDSEL=AD21PCI2050B 的二级总线片选起始地址结束地址R/W总 线宽度描述CS00 xfe0000000 xFER/W8并行 flash（2M）/ GPCMCS10 xe28000000 xe2807R/W8FCM 控制器的地址空间/NandflashCS20XF00000000XF001FR8128KBYTE/XCS30 xfA0000000 xFAR/W816MBYTE 地址空间/CPLD说明：对于 I2C 总扩展下挂的 I2C 设备，必须指明是挂在哪个桥的哪个二级接口上。3.1.5. PIO

11、分配3.1.6. 其他地址分配上述没有体现的管理部分的其他地址分配在此处描述。3.2. 管理部分需求-寄存器配置3.2.1. 基本接口寄存器配置3.2.1.1.Nor flash相关寄存器设置说明【注】寄存器的设置可参考本行所列的形式编写，也可以参考下一行的格式，将寄存器中关键的、与硬件相关的部分单独提出来。下面的各个寄存器的填写方式也参考本表格第 7 页 共 19 页寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读

12、此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明PIO 分配功能输出/输入备注GPIO0点 LED输出告警指示灯。点亮，低电平灭。GPIO1点 LEDGPIO2点 LEDGPIO3点 LEDGPIO4点 LEDSIC 224C021010 110PCA9548_a 扩展 I2C 通道 13.2.1.2.Nand flash相关寄存器设置说明3.2.1.3.其他 Lbc 设备相关寄存器设置说明第 8 页 共 19 页寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在

13、左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明3.2.1.4.Dram 接口相关寄存器设置说明3.2.1.5.eTsec 接口相关寄存器设置说明

14、第 9 页 共 19 页寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明

15、如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明3.2.1.6.I2c 接口相关寄存器设置说明3.2.1.7.Spi 接口相关寄存器设置说明第 10 页 共 19 页寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明2 如果此寄存器要先写入某个值的话，请在这边寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名

16、称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明3.2.1.8.Uart 接口相关寄存器设置说明3.2.1.9.Pci 接口相关寄存器设置说明第 11 页 共 19 页寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命

17、令和值界面进行说明号隔开，相减的用-号隔开输入命令和值3界面进行说明3.2.1.10.Pcie 接口相关寄存器设置说明第 12 页 共 19 页寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位

18、在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明3.2.1.11.Usb 接口相关寄存器设置说明3.2.1.12.Sd 接口相关寄存器设置说明第 13 页 共 19 页寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边

19、输入命令和值界面进行说明寄 存器注意：只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复位值写16 进制格式设置值写16 进制格式说明对此位进行适当的说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明3.2.1.13.关闭接口寄存器配置3.2.1.14.可编程接口相关寄存器包括 CPLD/FPGA 在内的可编程接口相关的寄存器在此处描述。3.2.1.15. 其他接口寄存器配置主要描述一些未在模板中定义，但是项目使用到的接口的寄存器第 14 页 共 19

20、 页寄 存器注意只能写一个寄存器地址包含 3 个地址（ CPU址器件 base 地址器件偏移地址）相加的地址用+号隔开，相减的用-号隔开位在左名称复 位值写 16 进制格式设 置值写 16 进制格式说明对此位进行适 当 的 说明；测试模型1对读此寄存器时的工作模式进行说明如果此寄存器要先写入某个值的话，请在这边输入命令和值界面进行说明关 闭 接口3.3. 交换部分软硬件接口3.3.1. PHY 地址3.3.2. SMI 接口时钟（即确认 MDC 时钟）如：对 BCM56504 一个 MAC 有 2 个 MDC 的可参考 MAC1 的格式填写，MIIM_MDC_GE 的时钟为 2.5M；MIIM

21、_MDC_XG 的时钟为 2.5M。对于一个 MAC 只有 1 个 MDC 的可参考 MAC2 的格式填写！3.3.3.PP/MAC/FA/Crossbar 的地址说明3.3.4.PP/MAC 或 PHY 的 GPP/GPIO3.3.5.描述链路对应关系说明以及端口之间的对应关系，说明形式不限如表格、等。端口不仅限于面板端口，也包括连接到背板的端口等。例：第 15 页 共 19 页MAC 端MAC1：XX01234567891011MAC 和 PHY 的接口QSGMIIQSGMIIQSGMIIPHY 端口对应PHY1：XXPHY2：XXPHY3：XXPIO/GPIO 分配功能备注PP/MACG

22、PP0PHY1GPIO1其它PP/MAC/FA/Crossbar 地址备注A 的地址B 的地址其它MDC 频率备注MAC1XXXXMAC2XX其它 PHY 地址备注A 的 PHY 地址如第一片：0000100100第二片：0010101000第三片：0100101100B 的 PHY 地址前面板的端口分布图：3.3.6. 其他（1）交换接口的外置接口功能随相应的寄存器配置不同而变比如 1145 的 LED 接口输出模式需要硬件给出配置的寄存器值3.4. 通信部分软硬件接口3.4.1.时钟源定义及分配如：CPM 设计中的时钟源选择3.4.2.时序操作要求评估如：要求在写寄存器要几个等待周期；复位

23、应该等待多少时间等。3.4.3.端口对应说明说明形式不限，只要能清楚表现面板/背板端口和交换部分相应参考格式。之间的对应关系即可。可参考3.4.4.寄存器配置要求评估如：时钟、环路时钟的切换；光/电端口的切换。3.4.5.其他通信部分其他未提及的内容在此处体现。3.5.插软硬件接口此处描述插过程中与的接口部分。第页 共页ClockCLKPIOSCC1 RxCLK4PC28SCC1 TxBRG4PC25SCC4 RxCLK6PC26SCC4 TxBRG1PC24FCC1 RxCLK10PC22FCC1 TxCLK11PC21FCC2 RxCLK13PC19FCC2 TxCLK14PC181041

24、234端口1234567891011线卡 13.6. 其他接口说明以上内容没有包括到的内容在此说明。如：特殊器件的特殊处理时间（比如喂狗信号的宽度，周期）特殊器件的上电时序控制时间的处理（比如交换器件的复位信号在时钟稳定后多长时间给出等）4. 客户可见功能验收标准说明说明 1：“客户可见功能”客户通过观察、作等方式，直接或者间接知悉的功能。但是，必须经由拆解硬件或者知悉的功能不算。说明 2：此处罗列出硬件共同作用才能实现的客户可见功能的验收标准，辅助硬件内部测试形成测试用例，避免测试遗漏。（单纯或者硬件功能则不在这里体现）说明 3：此章节的最主要目的是避免软硬件共同作用的客户可见功能被漏测或者

25、错测，所以原则上要求给出的功能描述具备明确的量化可测试性，此点请软硬件 PTM 在做测试完成承诺前注意 check，以免测试用例设计错误。说明 4：如果同一个系列的多个产品共用一份软硬件接口文档，当此系列中的具体型号体现在此章节的功能不相同，则需要根据具体型号分别编写，以便更准确地编写测试用例和进试验收。产品具备的客户可见功能汇总表4.1. 客户可见功能具体说明4.1.1. 指示灯说明：罗列客户可见的所有指示灯的作用，描述指示灯颜色、闪烁等代表的意义。第 17 页 共 19 页产品名称指示灯名称位号规格备注AP220-E v2.0Radio 灯 1D11灭：端口 DOWN绿色：2.4G UP产品名称客户可见功能功能是否注 1：以上表格只是示例，指示灯种类和数量以产品实际数量为准，自行增加或者删减；4.1.2. 端口对应关系说明：在 Main 的 CLI 中 show 出来的端质属性（光口、电口）必须相同。产品名称：S3760E-24P V1.20必须与硬件面板上的标号对应，且软硬件显示的端口介端口描述：1）1、224：2）25C-26C：口；3）25F-26F：显示端显示端必须和面板标识位号相对应，且都是 10M/100M 可自动协商电口；必须和面板标识位号相对应