知识门户

返回

2 参考文献和约定

views | comments

参考文献和约定#

2.1 行业文档#

以下文档与本规范相关。

2.1.1 相关文档#

[1] UM10204 I2C-bus specification and user manual, NXP Rev. 6.0, 2014, https://www.nxp.com/docs/en/user-guide/UM10204.pdf

[2] QSFP-DD/QSFP-DD800/QSFP112 Hardware Specification for QSFP Double Density 8x and QSFP 4x Pluggable Transceivers, Rev. 6.01, QSFP-DD MSA, 2021, http://www.qsfp-dd.com/specification

[3] OSFP MSA Specification for OSFP Octal Small Form Factor Pluggable Module, OSFP MSA, Rev. 4.1, 2021, https://osfpmsa.org/specification.html

[4] COBO 8-Lane & 16-Lane On-Board Optics Specification, Consortium for On-Board Optics (COBO), Rev 1.1, 2018, https://www.onboardoptics.org/specifications

[5] SFF-8024, SFF Module Management Reference Code Tables, SNIA: SFF TA TWG (Storage Networking Industry Association: Small-Form-Factor Technology Affiliate Technical Working Group) Rev 4.12, 2024, https://www.snia.org/technology-communities/sff/specifications

2.1.2 CMIS 扩展和补充规范#

[6] OIF-CMIS-VCS-01.0, CMIS Versatile Control Sets(待发布)

[7] OIF-C-CMIS-01.3, Implementation Agreement for Coherent CMIS(2023 年 10 月)

[8] OIF-CMIS-FF-01.0, CMIS Form Factor Specific Management Features(待发布)

[9] OIF-CMIS-LT-01.0, CMIS Support for Link Training(待发布)

[10] OIF-CMIS-ELSFP-01.0, CMIS for External Laser Small Formfactor Pluggable Modules(待发布)

2.1.3 一般背景资料#

[11] CFP MSA Management Interface Specification Version 2.6, http://www.cfp-msa.org/documents.html

[12] SFF-8074, SFP (Small Formfactor Pluggable) Transceiver, Rev 1.0, 2001

[13] SFF-8636, Management Interface for 4-lane Modules and Cables, Rev. 2.10a, 2019

[14] SFF-8679, QSFP+ 4X Hardware and Electrical Specification, Rev. 1.8, 2018

[15] OIF Common Electrical Interface (CEI) Specifications

[16] IEEE Std 802.3-2022, IEEE Standard for Ethernet, https://standards.ieee.org/ieee/802.3/10422

[17] INCITS Fibre Channel Specification, https://standards.incits.org/apps/group_public/download.php

[18] IEEE Organizationally Unique Identifiers (OUI)

[19] PCI-SIG 5.0/6.0 CopprLink External Cable Specification, PCI-SIG(待发布)

2.2 来源#

2.2.1 标准和规范#

IEEE 标准副本可从电气与电子工程师协会(IEEE)获取(https://www.ieee.org)。

InfiniBand 标准副本可从 InfiniBand 贸易协会(IBTA)获取(http://www.infinibandta.org)。

OIF 实施协议副本可从光互联网论坛(OIF)获取(http://www.oiforum.com/technical-work/implementation-agreements-ias)。

小外形规格(SFF)规范副本可从 SNIA SFF 技术联盟站点获取:https://www.snia.org/technology-communities/sff/specifications

2.2.2 管理材料#

通用语言设备标识(CLEI)规范副本可从 http://www.commonlanguage.com 获取。

OUI 注册信息可从 IEEE 注册机构获取:https://standards.ieee.org/products-services/regauth/index

2.3 约定#

本节定义的约定在本规范全文中使用。

2.3.1 通用约定#

定义

在本规范中,英文单词或通用术语可能被用作技术术语,具有明确定义的特定含义,该含义可能与一般上下文中的普通英文含义不同或更为狭窄。技术术语最好在第 3 章(定义)中定义,否则在其首次出现在正文流程中时定义。

注:技术术语可能会根据上下文以粗体印刷,以帮助读者识别其附加的特殊含义。印刷约定在第 2.3.3 小节中定义。

优先顺序

如果文本、表格或图形的解释之间出现冲突,解决冲突的优先顺序为:文本优先,其次是表格,最后是图形。例外:提供详细和主要规范文本(不仅仅是概述或说明)的表格优先于引用这些表格的文本。用于传达精确图形规范(不仅仅是说明)的图表,如状态转换图,优先于文本和表格。

图形和表格

提供在其他地方指定的详细信息概述的图形和表格是说明性的。原始指定数据、格式和值的表格是规范性的。并非所有表格或图形都在正文中有完整描述。

列表

按小写或大写字母排序的列表不表示列表项之间的排序关系。按数字排序的列表表示列表项之间的排序关系。

名称

分配给寄存器、位、字段或常量的符号名称在本规范内仅具有局部意义。虽然可以理解软件实现可能使用相似甚至相同的名称,但这既不是假设也不是要求。本规范中定义的名称在特殊情况下可能会更改。

无编号子标题

较长的文本段可以通过非正式的、无编号的子标题进行子结构化以提高可读性,包括放在长段落开头的段落标题。此类子标题以粗体字体设置。

2.3.2 符号约定#

字段和寄存器名称

字段和寄存器名称是为规范便利性而定义的,允许读者通过名称而非地址来引用内存映射位置。

字段和寄存器名称被识别为一个连续的标记(无空格的单词),首字母大写以指示单词边界。此表示法有助于清晰地区分字段名称和一般文本。

字段名称中的星号 ***** 用作通配符,表示引用所有与名称模式匹配的字段。通常为了可读性,通配符会省略与字段数组元素名称末尾的实例标识匹配的部分。

配置寄存器的首选名称结构为 <名词><动词>,其中名词表示应用动作的对象,动词表示动作,例如 OutputDisable。

对于具有多个实例的对象,通常会附加用于实例标识的名称部分,如 OutputDisableRx<i>,这允许在编程语言中使用数组。

寄存器结构和容器

对于重复的寄存器结构,可以在这些寄存器名称前加上容器名称以获得全局唯一名称。容器名称和寄存器名称用双冒号分隔,语法为 <容器名称>::<寄存器名称>

尖括号用于括起命名占位符的名称。

十进制数#

使用美式十进制数表示法,逗号作为千位分隔符,句点作为小数点。

美式ISO
0.60.6
1,000.01 000.0
1,323,462.91 323 462.9
非十进制数#

十六进制数用后缀 h 标记(例如 10h),通常带有前导零(0010h)。非数字的十六进制数字(ABCDEF)使用大写(例如 0Fh)。

二进制数用后缀 b 标记(例如 10000b),通常带有前导零(00010000b)。

没有基数指示后缀的数字理解为十进制表示法(例如 16)。

对于明确的情况,如 0=0b=0h 和 1=1b=1h,可以省略基数指示后缀。

可以插入空格以使较长的十六进制或二进制数字字符串更易读(例如 0001 0000b)。

逻辑运算符和表达式

逻辑运算符使用大写(ORANDNOT),括号用于明确优先级。

逻辑值

逻辑值为 TRUE 和 FALSE。

TRUE 和 FALSE 的默认编码分别为 1b 和 0b。

逻辑硬件信号值

对于通用硬件信号,其中物理信号电平取决于信号逻辑编码,使用符号信号电平 ASSERTED 和 DEASSERTED,分别对应 TRUE 和 FALSE(或 1 和 0)。

为了允许在本规范的逻辑表达式中使用符号信号电平 ASSERTED 和 DEASSERTED,引入了两个逻辑谓词(即映射到值集合 {TRUE, FALSE} 或 {1,0} 的映射):

  • ASSERTED(信号):当信号的符号电平为 ASSERTED 时映射为逻辑值 TRUE(或二进制值 1),否则为 FALSE(或二进制值 0)。

  • DEASSERTED(信号):当信号的符号电平为 DEASSERTED 时映射为逻辑值 TRUE(或二进制值 1),否则为 FALSE(或二进制值 0)。

逻辑表达式

逻辑表达式可以通过内存映射中的位、硬件信号电平和逻辑值的组合来定义。内存映射中的值通常表示为 1b 或 0b,硬件信号表示为 ASSERTED 或 DEASSERTED,布尔逻辑值表示为 TRUE 或 FALSE。

为了简化本规范中的真值表和逻辑方程,使用以下等价关系。

CMIS 位布尔逻辑硬件信号
0FALSEDEASSERTED
1TRUEASSERTED

逻辑表达式中的无关项用 X 表示。

命名逻辑表达式

在状态转换图中表示退出条件的逻辑表达式称为转换信号,与状态机电路类比。

当为转换信号分配符号名称时,使用名称后缀 S(例如 ResetS),作为转换信号(Transition Signal)的助记符。

当为一般逻辑表达式分配符号名称时,使用名称后缀 T(例如 ModuleReadyT),作为逻辑项(Logic Term)的助记符。

2.3.3 印刷约定#

技术术语#

本规范以特定含义使用某些英文单词作为技术术语。这些技术术语的特定含义在第 3.3 节中定义。为避免与本规范之外的其他含义可能产生的混淆,用作特定技术术语的单词首字母大写。

缩窄含义

本规范可能以比传统英文含义更窄的含义使用某些英文单词、复合词或通用技术术语。此类单词或技术术语的缩窄含义也在第 3.3 节中描述,作为对读者的提示。此类单词通常不进行印刷标记。

强调文本

局部强调的文本(为提高可读性而强调)以粗体字体排版。

辅助文本

非规范性的、信息性的和辅助性文本,如示例、提示、注释或解释,以斜体字体印刷,以帮助在视觉上区分辅助文本和规范性规范文本。

语法变量(命名占位符)

寄存器名称或字段名称中的语法变量(命名占位符)可以通过尖括号或斜体或粗体字体来表示,例如 <n>、n 或 n。例如,术语 OutputStatusRx<n> 表示 8 个位 OutputStatusRx1、OutputStatusRx2、……、OutputStatusRx8。

2.3.4 寻址和引用约定#

注:本小节中的约定可能需要理解术语表中定义的特定术语(见第 3.3 节)。

引用被管理模块资源(按通道)

在本规范中,被管理的传输相关内部模块资源通过与该被管理资源相关联或连接的通道编号(见下一段)来标识。

在被管理资源的被管理状态或控制方面与复用或解复用后发生的通道相关的情况下,该状态或控制方面适用于包含作为参考给出的通道编号的数据路径的所有通道,除非另有说明。

每当使用非特定术语”通道”而非”主机通道”或”介质通道”,且上下文不明确允许消除其含义歧义时,假定为主机通道视角。

通道编号和通道编号引用

通道编号在整个 CMIS 中用于标识通过管理内存映射中可命名的可寻址寄存器(或字段)管理的通道和通道相关资源(见第 8 章)。

用作寄存器名称一部分的通道编号最初在物理名称绑定参考点¹处定义。这些名称绑定参考点始终位于物理模块边界处;示例包括连接器中介质触点或插座的几何位置,在多通道传输方案的情况下可能包括物理信道参数(如载波波长)。

主机侧,递增的主机通道编号序列(例如 1 到 8)始终与相关电气主机接口连接器触点名称中的递增编号序列(如 Rx1 到 Rx8)一一映射,这些触点是相关硬件规范中定义的物理可标识的名称绑定参考点。

介质侧,介质通道编号到物理可标识的介质侧实体(如光纤、波长或介质侧光纤连接器位置)没有通用映射。相反,此映射由模块通告,并且可能取决于相关的介质接口标准(详见第 8.10.8 节)。

注:虽然介质通道定义可能因接口标准而异,但 CMIS 假设介质通道始终带有一些相关联的光学属性,如发射功率或接收功率。

此描述适用于第 6 章中描述的 CMIS 核心中的固定名称绑定。一旦引入了通道段之间的灵活连接,此描述仅适用于未进行交换的平凡交换配置。参见例如第 7.8 节。

通道编号和通道数据索引#

主机必须定位(寻址)特定寄存器(或字段),在该寄存器中,具有给定通道编号的通道的所需信息(属性)在管理内存映射中呈现给主机。通常,通道相关信息(通道属性)以数据结构数组的形式排列——至少在概念上是这样——使得地址偏移(或更一般的:从零开始的通道索引)可用于访问数组中的任何所需实例。通常,通道的通道索引是该通道编号减一。

引用管理内存映射的元素(字节、位、字段)

结构化内部管理内存映射中每个主机可访问的字节可通过由 Bank 索引(0-255)、Page 索引(00h-FFh)和字节地址(0-255)组成的地址三元组来标识。有关此三维寻址结构的更多信息,请参见第 7.8 章。

不支持 Bank 的页面隐含 Bank 索引为 0(可省略)。

所谓的低位内存隐含 Bank 索引为 0 和 Page 索引为 00h(两者均可省略)。

使用以下冒号分隔的字节寻址语法(斜体表示语法变量):

  • Bank**:Page:**Byte(寄存器内存映射中的通用字节)
  • Page**:**Byte(不支持 Banking 的页面中的字节)
格式说明
0:Page:Byte完全指定的替代格式
Byte低位内存中的字节
00h:Byte替代格式
0:00h:Byte完全指定的替代格式

在每个寻址级别(即在 Bank、Page 或字节寻址级别),可以通过短横线分隔的起止地址指示范围

示例:

  • Banks 0-1
  • Pages A0h-AFh
  • Pages 0:9Fh-AFh
  • Bytes 1:9Fh:128-129
  • Bytes 0-3:9Fh:128

字节中的位从 0 到 7 索引,其中索引值表示算术有效位,可以使用以下点分隔表示法来标识单个或位字段

  • Bank**:Page:Byte.**Bit(单个位)
  • Bank**:Page:Byte.Bit-**Bit(从 Bit 到 Bit 的位字段)

示例:

  • 字段 2:10h:128.7-4:10h 页高位内存 Bank 2 中字节 128 的位 7-4 的 4 位字段
  • 位 04h:128.0:04h 页(未指定 Bank)中字节 128 的最低有效位 0
  • 字节 126:低位内存中字节地址 126 处的字节
  • 字 04h:128-129:04h 页中的 16 位字(字节序约定见第 8.1.3.5 节)

引用字段值

当上下文明确时,字段的地址也可以表示存储在该字段中的值。否则,字段地址周围的方括号表示存储在该字段中的值。

  • Address = Value — 赋值
  • [Address] = Value — 表达式,例如在比较中

示例:当 10h:132 = 0 时,模块……

Comment seems to stuck. Try to refresh?✨