产品版本命名及使用规范

产品版本命名及使用规范
目录
1目的 (3)
2范围 (3)
3术语和定义 (3)
4产品版本组成示意图 (5)
5版本命名规范 (5)
5.1产品版本命名 (5)
5.1.1产品版本命名规范 (5)
5.1.2产品版本名称使用说明 (7)
5.1.3产品版本归档说明 (8)
5.2系统软件版本命名规范 (8)
5.3单板软件版本命名规范 (8)
5.3.1单板软件上报版本规范 (9)
5.3.2单板软件归档版本命名 (9)
5.4逻辑软件版本命名规范 (9)
5.4.1逻辑软件上报版本规范 (9)
5.4.2逻辑软件归档版本规范 (9)
6版本命名规范的实施方法 (9)
6.1各产品线质量部 (9)
6.2产品数据管理中心 (10)
产品版本命名及使用规范
1目的
明确产品版本及其主要组成部分版本的命名规则及使用规范。

2范围
本规范规定了研发管理、生产使用和上报给网管的产品版本、系统软件、单板软件等的命名规范及其在资料、操作维护终端、后台/网管显示的使用说明。

本规范适用于公司所有产品的主机软件(终端软件)、单板软件、逻辑软件版本命名。

3术语和定义
产品版本是指实现一定规格特性并提供给用户使用或辅助主要功能完成特定功能的软硬件及资料阶段性的实体，版本名称是整个产品以及产品的各级软件、硬件部件实体的标识名称，用于反映产品的规格和特性差异及演进过程的标识。

版本名称在实际使用中视情况决定是否需要，以及使用到版本的哪个层次。

对本文中所指的主要术语做如下说明：
•系统软件：系统运行所需要的所有软件集合，本文定义中指主机软件、单板软件与逻辑软件。

•主机软件：指我司开发的在标准的计算机平台(如PC、工控机、服务器、大型机等)上安装、运行或使用的软件，如BAM、维护终端、网管等上安装使用的主机应用/业务软件或主机操作系统软件。

•终端软件：是指公司公司自行开发或合作开发、定制的，在标准计算机平台(一般是作为设备后台)上运行的软件，如在发货前已安装在后台计算机硬盘上的并且将在后台计算机环境下运行的软件；存储在光盘、软盘或其它移动介质上，准备在系统安装调试时或由用户根据需要安装在后台计算机上的并且将在后台计算机环境下运行的软件；在设备运行状况下，由设备从通讯端口获取的（例如远程加载）并将在后台计算机环境下运行的软件。

该术语主要用于我司生产系统，与主机软件对应。

•单板软件：是指在公司公司自行开发或合作开发、定制的单板(即:不包括采购来的标准计算机中的单板)上运行的软件和逻辑，如单板发货前烧制在器件内的逻辑文件；成品板上没有加载，而是在设备启动时，通过上层软件加载到器件上的逻辑；上电后从单板内的FLASH或ROM、NVRAM中加载到单板上的软件(包括BIOS、OS、应用软件、DSP中的数据处理软件)；上电后从后台（或硬盘）中加载到单板上的软件(包括BIOS、OS、应用软件、DSP中的数据处理软件)；在上电后，单板硬件通过访问某些地址、通讯端口获取的程序，驻留在单板各类存储器内(包括CPU/DSP内部的存储器内)运行的软件。

该术语
在生产系统与研发系统中的范围不同，生产系统在使用该术语时包括逻辑软件，而研发系统的分类中将逻辑从单板软件中剥离出来，作为单独一类。

单板业务软件；在本公司自行开发或定制的单板上运行的业务功能处理软件，包括实现任务调度、业务数据处理等功能的软件。

举例：包括在CPU、DSP上运行的数据处理、
协议处理软件、专用处理器中的微码等；属于应用软件层次；
单板平台操作系统软件（OS）；在本公司自行开发或定制的单板上运行的，用于对设备的状态和硬件资源进行综合管理，并对应用软件和相关资源进行调度控制，但不直接
操作硬件物理地址的软件（个别功能除外）。

说明：该类软件与应用软件和BIOS软
件有访问接口，通过BIOS软件来对硬件的详细状态（物理地址）进行访问控制。

此
类软件与硬件有一定的关系，但其中的指令不直接操作硬件物理地址（个别功能除
外）；属于操作系统层次。

举例：此类软件包括单板上运行的系统控制软件。

通常所
说的虚拟设备驱动程序(VXD)也属于该类软件中的一部分；
单板BIOS软件：在本公司自行开发或定制的单板上运行的，主要功能是对硬件电路的状态进行控制管理、能够直接访问硬件的物理地址的软件。

举例：POWER PC处理器上
的BSP软件、适用于一般CPU的BOOTROM中的引导软件属于此类。

•逻辑软件：在单板上的可编程逻辑器件(或阵列，包括FPGA、CPLD、EPLD等）以及部分ASIC器件环境中运行的软件，或对可编程逻辑器件进行初始化的设置文件。

该类软件主要是在可编程逻辑器件内部完成逻辑、时序、数据格式转换等功能。

基本逻辑：即“Glue Logic”，指在单板上用于实现电路信号连接和切换控制的逻辑，主要包括组合逻辑和时序逻辑，但不包括采用较复杂算法实现用于业务数据处理功能的逻
辑。

大规模逻辑：一般指采用较复杂算法实现用于数据处理功能的逻辑。

•补丁：通过软件裁剪与编程技术，在已有版本上增加的、能够通过独立后台、独立Install 程序或文件拷贝等方式独立加载和卸载的软件程序实体。

补丁由一个或多个变更组成，补丁加载后可影响原有部分程序。

纠正补丁：用于纠正已有缺陷的补丁。

功能补丁：用于增加新的功能的补丁。

4产品版本组成示意图
图 1. 产品版本组成示意图
图 2. 生产和研发部门软件分层分类列表和对应关系
5版本命名规范
本规范主要制定与明确产品版本命名规则及使用规范，各业务部、产品线、PDT必须严格遵守。

对于产品版本的各级软件、硬件的命名规范尚需进一步研究、讨论，以下对单板软件、逻辑软件的命名规则仅供参考，不做严格要求。

5.1 产品版本命名
5.1.1 产品版本命名规范
完整的产品版本名称规则为：
商标+[子商标]+型号+中(英)文名称+VxxxRxxx[LLL]CxxBxxy[SPxx]
说明：
1）[ ]表示可选。

2）"V"、"R"、"C"、"B"、"SP"为分隔符；V后面三位数字；R后面三位数字；LLL可选；C后面两位数字；B后面三位数字；SP后面两位数字，只在热补丁时使用。

3）商标、子商标、型号、中(英)文名称根据产品命名相关规范、指导及规则制定。

1. 对"Vxxx"的说明
"Vxxx"(version)代表某一产品或其系列产品，根据市场定位或开发平台的不同，一个产品分为若干个V 级版本。

每个V级版本根据市场竞争需要、技术、功能特性与成本因素等，有一个总体开发规划，按计划开发若干个R(Release)级版本。

V 版本可以包含若干个Release版本。

如果满足下列任何一种情况，则必须产生新的Version 版本，即产品的大版本：
•产品市场定位发生变化，引起产品特性的重大变化；
•产品平台发生变化，与原有平台不能兼容。

V版本以三位数字表示，数字间不准许有任何其它字母、符号出现，从100开始，不同平台或技术的同类产品尽量采用大数标示，即V后面第一位，如V100、V800。

2. 对"Rxxx"的说明
"Rxxx"(Release) 版本表示产品特性版本，可以包含若干个特性，形成一个具体的系列产品，一个Release 版本纳入什么特性，需要综合考虑市场竞争、技术与成本方面的因素，系列产品也可有自己的特性版本，系列产品可以在特性版本号上用特别的字母或数字表示。

产品路标规划确定了该产品所有的大版本(Version)，以及每个大版本(Version)包含的特性版本(Release)、系列产品的发布时间和所包含的特性。

特性版本需要按照产品开发流程所规定的各个评审决策点进行评审。

如果满足下列情况，则必须产生新的Release 版本：
•产品市场定位和产品平台没有发生变化，但是，衍生新的系列产品；
•综合考虑市场竞争、技术与成本方面的因素，产品特性发生变化，有计划地向市场发布的版本。

R版本以三位数字表示，数字间不准许有任何其它字母、符号出现，从001开始，在同一个V 下面以1为单位连续递增，例如：R001、R002。

3. 对"LLL"的说明
"LLL"为海外版本标识符，以三个字母表示，可选。

对于国内版本，此项可以省略。

具体的对应关系请见附表1( 海外版本标识符和相应的语言(国家)对照表)；如果某个版本可以用于某一个地区，可以在附录中选择本地区的主要国家的标识符作为版本的海外标识。

4. 对"Cxx"的说明
"Cxx"(Customer)表示计划提供给客户的版本，以两位数字表示，数字间不准许有任何其它字母，从01开始，以1为单位连续递增。

Cxx与某些Bxx对应，同一Bxx为Cxx版本时，Cxx不以Bxxy 的y位及SPxx而变化，即同一个Cxx可能对应一个Bxxy或同一Build的多个改错版本或热补丁版本。

5. 对"Bxxy"的说明
"Bxxy"(Build)表示开发与IBT过程中的Build版本。

B后面的三位中的前两位xx表示规划的Build 划，最后一位y表示每一个Build的过程改错版本。

其中，
xx从01开始，以1为单位连续递增；RXX变化时，Bxxy版本复位到B010。

y从0开始，以1为单位连续递增。

Bxx变化时，y复位到0开始。

6. 对"SPxx"的说明
SP是为了解决问题，对网上运行版本的热补丁版本，以两位数字表示，数字之间不允许有任何其它符号，如空格、"."、"-"等。

从01开始，以1为单位连续递增。

如果版本不是补丁，SPxx要省略。

例如：SP01、SP02。

SP为某一发布版本的补丁版本，只有对于已经发布的版本需要做补丁版本时才会有此项。

做SP时，前面的所有版本序号不变。

举例说明：
A. V100R001B010 表示V100R001的第1个Build的首个转测试版本，不发给客户。

B. V100R001B011 表示V100R001的第1个Build的第1个转测试改错版本。

C. V100R001C01B023 表示V100R001的第2个Build为第1个客户版本，一般用于试验局或ESS局。

实际交付件为第2个Build的第3个改错版本。

D. V100R001C01B023SP01 表示对V100R001C01B023的第一个热补丁版本。

E. V100R001B030 表示V100R001的第3个Build的首个转测试版本，不发给客户。

F. V100R001C02B053 表示V100R001的第5个Build为第2个客户版本，可用于试验局、ESS局、或ESP局。

实际交付件为第5个Build的第3个改错版本。

5.1.2 产品版本名称使用说明
1. 本显示与提供说明
完整的产品版本(商标+[子商标]+型号+中(英)文名称+VxxxRxxx[LLL]CxxBxxy[SPxx])可以通过特殊命令由开发人员或授权人员(如技术支援工程师等)进行查询、显示。

终端、后台界面、网管上显示的、客户可以看到的产品版本信息为产品商标(可选)、产品型号、产品V级、R级、C级版本及可能的SP版本。

如：OptiX BWS 1600G V100R001C02：OptiX BWS 1600G为产品名称，V100R001C02为第二个产品版本。

在通常情况下，对外提供给客户可以看到的产品版本名称原则上只能到R级(SP也不提供)，即：VxxxRxxx，如向电信管理部门、测试机构、运营商汇报或提供版本名称。

根据需要，提供给客户运维部门的产品版本可以到C级，即：VxxxRxxxCxxSPxx。

非计划发给客户的版本（即不带C的、用于内部渐增测试的B版本）不得提外部客户！
如：
对外版本原则上为：V100R001
对运维部门可以为：V100R001C01、V100R001C02
对内版本可能为：V100R001C01B020、V100R001C02B050
2. 资料中的版本使用
•提供给客户的随机发货用户资料、电子光盘、产品概述等只描述到R级版本即可。

•市场部用的宣传性资料、宣讲胶片一般只描述到版本的V级，根据需要可以描述到R级；
如果需要描述到R级以下，则必须经过产品线管理办公室市场技术处的批准。

市场部内部
指导资料按R级版本编写，随计划对外发行的B级版本（有对应的C版本）刷新；
•市场技术资料：由PDT编制提供产品行销部、产品工程部、定单管理等业务部门用于产品指导的《市场技术指导书》、《配置手册》等资料按R级版本编写，随B级版本刷新；
•技术支援指导资料：由PDT或产品工程部编制给技术支援或合作单位使用的指导版本使用的《版本使用指导书》、《版本配套表》、《升级指导书》等资料可以描述版本的全称，
但此类资料属于保密资料要严格控制使用权限。

5.1.3 产品版本归档说明
产品版本归档时，需要以完整的产品版本(商标+[子商标]+型号(简称) +VxxxRxxx[LLL] Cxx Bxxy [SPxx]，省略了名称描述)进行归档，以减少软件BOM数或由于控制BOM数量，软件使用相同BOM时的区分。

如文件名称长度受限制时，可进行简化，但需统一格式。

5.2 系统软件版本命名规范
目前系统软件版本标示了产品版本，系统软件版本命名规则、上报显示、归档同产品版本命名。

产品/模块名称+VxxxRxxx[LLL]CxxBxxy[SPxx]
5.3 单板软件版本命名规范
“单板业务软件”与“单板平台操作系统软件”统一采用系统软件版本命名规则。

备注：产品已经以3位数字制订版本的仍可继续沿用）。

“单板BIOS软件”以3位数字表示，从001开始，版本修改时以1为单位连续递增，中间不得跳跃。

备注：因历史原因造成研发版本与生产版本不一致时，下一版本必须基于两者最高的版本号升级。

例如：原来某软件版本的研发版本号为113，生产版本号为101，则升级后的版本号必须大于113。

5.3.1 单板软件上报版本规范
通过特殊命令(由OMC与网管研究管理部统一定义)显示给公司授权人员(如技术支援工程师等)，版本显示同单板软件版本命名规范。

5.3.2 单板软件归档版本命名
同单板软件版本命名规范。

对于后台可加载的单板软件，版本命名规则同系统软件版本命名规则(由于历史原因，个别产品以三位数字制订的版本仍继续沿用)。

5.4 逻辑软件版本命名规范
逻辑软件包括基本逻辑软件与大规模逻辑软件，其版本名称以3位数字后加规模标示字母命名，用后缀"B"与"L"来表示逻辑的规模，B表示是基本逻辑软件，L表示是大规模逻辑软件，即：基本逻辑软件的版本以xxxB命名，大规模逻辑软件的版本以xxxL命名。

3位数字从001开始，版本修改时以1为单位连续递增，中间不得跳跃。

备注：因历史原因造成研发版本与生产版本不一致时，下一版本必须基于两者最高的版本升级。

例如：原来某软件版本的研发版本号为015，生产版本号为101，则升级后的版本号必须大于101。

5.4.1 逻辑软件上报版本规范
通过特殊命令(由OMC与网管研究管理部统一定义)显示给公司授权人员(如技术支援工程师等)，版本显示同逻辑软件版本命名规范。

5.4.2 逻辑软件归档版本规范
同逻辑软件版本命名规范。

6版本命名规范的实施方法
•版本命名只准许版本命名规范中定义的格式进行命名，特殊原因必须经过研发管理办公室市场技术处的审批。

•根据版本命名格式和各位的含义，各产品线可以定义各位的具体含义和变化规则。

•本规范由市场技术处和数据中心共同维护。

6.1 各产品线质量部
负责版本命名规范在本产品线的推行和监控；
负责根据公司版本命名规范制定适合本产品线的具体版本命名规范，负责制定并完成新旧版本命名转换对照规则，但必须经过质量管理部和市场技术处审核通过后才能实施；
负责指导配置经理和版本经理按照版本命名规范进行版本管理。

6.2 产品数据管理中心
对各产品线的软件版本命名规范进行宣传，对每个归档发布的软件版本命名规范进行审核。

附录 1海外版本标识符和相应的语言(国家)对照表。