内部公开▲

技 术 文 件
技术文件名称：UMaker 工具操作指导手册
技术文件编号：
版 本：V2.10

拟 制 陈磊
审 核
会 签

标准化
批 准

中兴通讯股份有限公司

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播
 UMaker 工具操作指导手册 内部公开▲

修改记录
拟制人/ 拟制日期/ 主要更改内容
文件编号 版本号 更改理由
修改人 修改日期 （写要点即可）

陈磊
V1.0 2012-01-18 新建 UMaker 使用说明
10092102
陈磊
V2.0 2012-04-23 工具版本更新
10092102

陈磊 增加对自检请求文件的支
V2.03 2012-07-06 工具版本更新
10092102 持

陈磊
V2.05 2012-08-07 工具版本更新 增加对 RRU 规格包的支持
10092102

陈磊 修改对基站配置数据文件
V2.07 2012-10-10 修改错误
10092102 来源的描述

增加格式化基站场景下的
陈磊
V2.09 2012-12-04 修改错误 开展描述、新的闪灯方案。
10092102
根据售后评审意见修改

陈磊 创建自检请求文件功能变
V2.10 2013-01-07 工具更新
10092102 更，修改相关描述

注：文件第一次归档时，“更改理由”、“主要更改内容”栏写“无”。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 1
 UMaker 工具操作指导手册 内部公开▲

目 录

1 概述.............................................................................................................................................3

2 USB 开站过程............................................................................................................................3

2.1 USB 开站前提条件..................................................................................................................4

2.2 USB 开站平台版本限制..........................................................................................................4
2.3 准备基站版本文件...................................................................................................................5
2.4 准备基站配置数据文件...........................................................................................................5
2.5 使用 UMAKER 制作开站所用的 U 盘......................................................................................6
2.6 将开站 U 盘插入主控板..........................................................................................................6
2.7 观察主控板闪灯状态...............................................................................................................6
2.7.1 基站内部的 USB 开站过程.............................................................................................6
2.7.2 V1.2.0.1B5 及之前版本的闪灯方案....................................................................................6
2.7.3 V1.2.0.1B6 至 V1.2.1.0B3 版本的闪灯方案........................................................................7
2.7.4 V1.2.1.0B4 及之后版本的闪灯方案....................................................................................7

3 UMAKER 工具操作说明...........................................................................................................7

3.1 制作 U 盘整体流程..................................................................................................................7
3.2 运行 UMAKER 工具..................................................................................................................8
3.3 输入 U 盘路径..........................................................................................................................9
3.4 输入基站配置数据文件路径...................................................................................................9
3.5 创建基站自检请求文件.........................................................................................................10
3.6 输入基站 BBU 版本文件路径...............................................................................................13
3.7 输入基站 RRU 版本文件路径...............................................................................................15
3.8 清空 U 盘内容........................................................................................................................16
3.9 制作 U 盘内容........................................................................................................................17
3.10 其他操作说明.........................................................................................................................18
3.10.1 提前检查输入文件的有效性........................................................................................18
3.10.2 打开 UMaker 工具所在路径.........................................................................................19
3.10.3 打开 U 盘所在路径.......................................................................................................19
3.10.4 只更新 U 盘中的 MO 数据文件....................................................................................19

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 2
 UMaker 工具操作指导手册 内部公开▲

1 概述
USB 版 本 和 配 置 数 据 制 作 工 具 （ USB Version and Configuration Data Maker ， 简 称
UMaker），是用于将版本规格包及对应的配置数据文件进行处理并写入 U 盘的工具 。
UMaker 工具随 OMMB 版本发布。
该工具能够将版本（产品和平台规格包）、XML 配置文件按照 USB 开站功能的要求进
行数据转换和处理，然后写入到 U 盘中，以满足 USB 开站功能对版本和数据配置的需要。
使用 UMaker 制作后的版本，应用于 USB 开站，可大大降低站点开通成本、降低站点
开通时对基站开通人员的技能要求，提高站点开通效率，从而大大提升产品交付能力。
本文先介绍 USB 开站的基本流程，然后介绍 UMaker 工具的使用方法。

2 USB 开站过程
USB 开站是指：在基站上，插入 U 盘，基站自动复位，主控板加载 U 盘上的 cpu 和
fpga 版本以及配置数据，并根据 U 盘中的预设指令，进行规格包下载、激活、基站自检等操
作。保证可以只通过 U 盘就可以让处于出厂状态的基站正常运行。
上述描述中的“基站自检”指的是：为开站或者基站检查时不方便通过后台操作的场
景开发的诊断功能，以方便开站人员定位问题，减少上站次数，从而节约成本。自检流程
为：基站插入 U 盘，U 盘中的版本被加载、激活后，基站根据 U 盘中的自检请求文件进行
自检，自检完成后结果文件写入 U 盘中。基站自检不是 USB 开站必需的步骤，制作 U 盘时
可以在工具中设置不进行自检。
U 盘中同时只保存一个基站的版本和数据文件。根据开站的实际情况，可以给每一个开
通的基站制作一个 U 盘；也可以多个基站共用一个 U 盘，这种情况下在开通下一个基站前
需要更新一下 U 盘中的配置数据和版本文件；如果目标版本相同也可以只更新配置数据文
件。图 2.1 所示为 USB 开站的操作步骤。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 3
 UMaker 工具操作指导手册 内部公开▲

开始

准备版本规格包文
件、基站配置数据
文件

使用UMaker工具将
规格包和配置数据
文件制作进USB设
备中

将USB设备插入基
站主控板上

观察主控板闪灯状
态判断开站是否成
功

结束

图 2.1 USB 开站操作步骤

2.1 USB 开站前提条件

基站要求：
1）基站主控板类型为 CCC 或 CCE；
2）CCC 的 boot 版本号最低为 10186，CCE 的 boot 版本号最低位必须为 10192。
U 盘要求：
1）分区格式为 FAT16 或 FAT32，容量为 32G 或以下，推荐型号为 Kingston DT 101 G2
(8G/16G)。
2）准备一根 USB 转接线，一头是标准 USB 的母口，一头是 mini USB 的公头。
UMaker 工具使用要求：
1）准备一台支持 USB 接口的 PC 机，操作系统为 Windows XP 或 Windows 7；
2）PC 机已安装 JRE，版本为 6.x 系列。

2.2 USB 开站平台版本限制

不同的平台版本所支持的 USB 开站功能不同，开站时应注意这些版本差异。下面所说
的版本号指得是 BBU 平台规格包版本所对应的 SDR 平台版本号。
1）从 V1.1.8B6 版本开始（指的是基站当前运行版本），主控板在插入 U 盘后才会自
动复位，否则需手动复位基站来触发 USB 开站；
2）从 V1.2.0.1B5 版本开始（指的是 U 盘中的版本），USB 开站才支持 RRU 版本包；
3）从 V1.2.1.0B4 版本开始（指的是 U 盘中的版本），USB 开站的闪灯由 RUN 灯更换
为 MS 灯。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 4
 UMaker 工具操作指导手册 内部公开▲

2.3 准备基站版本文件
开站所需的基站版本文件是给 UMaker 工具使用的，UMaker 工具会将输入的版本文件
制作进 U 盘中。所要准备的版本文件是基站外发版本中的规格包文件，包括平台 BBU 软件
规格包、产品 BBU 软件规格包和 RRU 规格包。

2.4 准备基站配置数据文件
UMaker 工具需要基站的配置数据文件为 xml 格式的 MO 数据文件。而目前可以得到的
xml 格式 MO 数据文件有两种：
第一种为 OMMB 导出数据功能所导出文件的格式，为了方便，下文中称之为“数据导
出”格式；
第二种为 OMMB 同步数据功能中选中“仅生成文件”选项所生成文件的格式，下文中
称之为“数据同步”格式，LMT 所导出的基站数据文件也是这种格式。
这两种文件都是 xml 格式的，容易混淆，但可以通过文件内容来区分，以“Root”为
根元素的是“数据导出”格式，如图 2.2；以“ObjItf”为根元素的是“数据同步”格式，
如图 2.3。

图 2.2 “数据导出”格式

图 2.3 “数据同步”格式
基站不能直接识别“数据导出”格式的文件，此格式数据导入 OMMB 后，需要转换成
“数据同步”格式的文件才能配置给基站。
注意：UMaker 工具只支持“数据同步”格式的基站配置数据文件。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 5
 UMaker 工具操作指导手册 内部公开▲

UMaker 所需的基站配置数据文件可以通过上述 OMMB 同步数据功能或 LMT 导出数

据功能获得。实际进行 USB 开站时，此文件可以通过 BCT 工具批量生成。BCT 支持上两种
格式的文件作为输入，而且输出文件和输入文件的格式是一致的，所以使用 BCT 生成
UMaker 的所需文件时要选择“数据同步”格式的文件作为输入模板。

2.5 使用 UMaker 制作开站所用的 U 盘

准备好基站版本文件和配置数据文件之后就可以通过 UMaker 将这些文件制作进 U 盘
中，详细的操作步骤参见第 3 节。

2.6 将开站 U 盘插入主控板

U 盘内容制作好之后，要把它通过转接线插到主控板的 mini USB 口中。
有些时候需要在基站电子盘已经被格式化的场景下进行 USB 开站，这时主控板插入
USB 之后是没有任何反应的，无法自动复位，需要开站人员手动复位基站。
如果基站当前运行的平台版本是 V1.1.8B6 之前的版本也需要开站人员手动复位基站。
除了上述两种情况，正常情况下一旦 U 盘插入主控板，基站就能够检测到所插入的 U
盘，然后会自动重启，重启之后开始加载 U 盘中基站版本文件。开站人员这时要观察主控
板的闪灯状态以判断开站过程是否结束。

2.7 观察主控板闪灯状态

2.7.1 基站内部的 USB 开站过程

1）USB 守护进程检测到有 U 盘插入并且自动复位主控板；

2）主控板从 U 盘中加载 cpu、fpga 版本及配置数据；
3）删除基站中所有规格包；
3）从 U 盘下载平台规格包及产品规格包；
4）下载完成后激活产品规格包；
5）收集开站自检内容。
以上步骤都是基站自动完成的，不需要人工参与，开站人员只能通过主控板的闪灯状
态来判断开站过程是否已结束。V1.2.0.1B5 和 V1.2.1.0B4 这两个平台版本（指的是 U 盘中
的版本）的 USB 开站闪灯方案发生变更，开站时应注意确认版本信息。

2.7.2 V1.2.0.1B5 及之前版本的闪灯方案

1）主控板运行阶段，检测到 U 盘插入，复位基站；
2）USB 开站和自检过程中，RUN 正常闪烁，闪烁周期为 0.5s；
3）USB 开站完成，RUN 灯慢闪，闪烁周期为 1.5s；
4）拔出 U 盘，RUN 灯恢复正常闪烁，闪烁周期为 0.5s。

2.7.3 V1.2.0.1B6 至 V1.2.1.0B3 版本的闪灯方案

1）主控板运行阶段，检测到 U 盘插入，复位基站；
2）USB 开站和自检过程中，RUN 灯慢闪，闪烁周期为 1.5s；
3）USB 开站完成，RUN 灯会以一秒内连续闪三次灭一次的方式进行闪烁；
4）拔出 U 盘，RUN 灯恢复正常闪烁，闪烁周期为 0.5s。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 6
 UMaker 工具操作指导手册 内部公开▲

2.7.4 V1.2.1.0B4 及之后版本的闪灯方案

从此版本开始 USB 开站过程应观察主控板 MS 灯而非 RUN 灯。

1）主控板运行阶段，检测到 U 盘插入，MS 灯慢闪（0.3s 亮，0.3s 灭）5 次；
2）开始校验 U 盘，校验通过就复位基站，校验不通过，熄灭 MS 闪灯；
3）USB 开站和自检过程中，MS 灯快闪（70ms 亮，70ms 灭）；
4）USB 开站完成，恢复慢闪（0.3s 亮，0.3s 灭）；
5）拔出 U 盘，MS 灯恢复正常状态常亮。

3 UMaker 工具操作说明

3.1 制作 U 盘整体流程
使用 UMaker 工具把准备好的版本文件、配置数据文件写入到 U 盘的流程如图 3.1 所示。

开始

输入规格包文件的
运行UMaker工具 路径

输入USB设备路径
隐藏多余的输入项

输入配置数据文件 清空USB设备中的
路径 文件（可选）（建
议执行此步骤）

创建自检请求文件 点击“Make”按钮
（可选） 开始制作USB设备

结束

图 3.1 版本和配置数据写入 U 盘流程

3.2 运行 UMaker 工具
工具随 OMMB 版本发布，在 OMMB 发布目录的 tools 目录下以 UMaker.zip 压缩包的
形式发布，从 OMMB 发布版本中获取到此包之后解压到 PC 机的某一路径下，路径无要求，
解压后的目录结构如图 3.2。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 7
 UMaker 工具操作指导手册 内部公开▲

图 3.2 UMaker 工具解压后的目录结构

双击运行 UMaker.jar 文件，出现 UMaker 工具的 GUI 界面，如图 3.3。

图 3.3 UMaker 工具界面

3.3 输入 U 盘路径
点击“USB Device”输入行的“…”编辑按钮，选择 U 盘在 PC 上的根目录，如果 U
盘在 PC 的盘符为“E：”则选择“E：”，如果为“F：”则选择“F：”，根据实际情况
操作即可，如图 3.4 所示。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 8
 UMaker 工具操作指导手册 内部公开▲

图 3.4 选择 U 盘的根路径
选择了 U 盘后，“USB Device”输入行的“Status”栏内会显示当前 U 盘的状态，如
图 3.5 所示，只有在“Normal”状态下，才允许把版本和配置数据正确写入 U 盘。

图 3.5 U 盘状态

3.4 输入基站配置数据文件路径
点击“MO Data File”输入行的“…”编辑按钮，如图 3.6 所示，选择 MO 数据文件的
路径。有些场景下制作 U 盘时可以只更新 U 盘中的 MO 数据文件，详见 3.10.4 小节。
注意：UMaker 工具只支持“数据同步”格式的基站配置数据文件，详见 2.4 节。

图 3.6 选择配置数据文件路径

3.5 创建基站自检请求文件
基站自检不是 USB 开站的必需步骤，如果不打算让基站进行开站自检，可以在设置对
话框中进行设置。点击“Setting”按钮，弹出工具设置对话框，如图 3.7 所示。不勾选
“Need self-check instraction”这一项，然后点击“OK”按钮。此时界面上隐藏自检文件路
径输入栏。下次打开工具会依据上次的选择来显示。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 9
 UMaker 工具操作指导手册 内部公开▲

图 3.7 不让基站进行自检
如果需要基站自检请按下述描述操作。
点击“Self-check File”输入行的“…”编辑按钮，如图 3.8 所示。

图 3.8 编辑自检请求文件路径
弹出一个选择框，如图 3.9 所示。请选择是创建一个新的自检请求文件还是选择一个已
有的自检请求文件。自检请求文件中的单板信息要和上一步中输入的基站配置数据文件中
的单板信息匹配，因此建议此处选择新建自检请求文件，工具新建文件时会自动从基站配
置数据文件中读取单板信息，点击“OK”按钮。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 10
 UMaker 工具操作指导手册 内部公开▲

图 3.9 弹出选择框
弹出创建自检请求文件对话框，如图 3.10 所示。点击上方“Browse”按钮选择新建文
件的保持路径。

图 3.10 选择新建自检请求文件保存路径
根据实际需要选中各单板所需的自检项，点击“Create”按钮，创建文件。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 11
 UMaker 工具操作指导手册 内部公开▲

图 3.11 选择自检项创建文件
自检请求文件创建成功后，“Self-check File”输入行“Value”列的值就成了上面选择
的新建文件保存路径，如图 3.12。

图 3.12 创建自检请求文件成功
设置对话框中和开站自检功能相关的还有两个选项：“Self-check wait time”和“Self-
check timeout”。
“Self-check wait time”属性表示自检指令执行前的等待时间，单位为分钟，默认 20
分钟。在激活产品规格包后，需要等待所有外围单板全部上电完成进行自检才有意义。自检
等待时间包括外围单板向主控板下载版本、加载、业务运行。如果该时间设置过短则大量外

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 12
 UMaker 工具操作指导手册 内部公开▲

围单板未能加载成功，此时发起诊断自检，将会导致该单板的诊断超时。
“Self-check timeout”属性的属性值表示自检指令执行超时时间，单位为分钟，默认
15 分钟。自检需要的时间跟诊断请求数和单个请求超时时间有关。如果诊断请求文件中配置
的请求功能数目为 M，每个请求的超时时间为 T，则整个自检最长等待的时间为 M*T。单
个诊断超时时间平台功能一般为 10 秒，不排除个别产品诊断功能需要更长的时间。

图 3.13 基站自检相关的设置属性

3.6 输入基站 BBU 版本文件路径

点击“xxxx BBU Package”输入行的“…”编辑按钮，根据需要选择版本 BBU 规格包
文件的路径，如图 3.14 所示。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 13
 UMaker 工具操作指导手册 内部公开▲

图 3.14 选择 BBU 规格包文件路径

UMaker 工 具 目 前 支 持 六 种 产 品 制 式 ： UMTS 、 GSM 、 TD-
SCDMA、CDMA、LTEFDD、LTETDD。如果是第一次运行 UMaker，打开工具之后界面上会
显示所有制式的 BBU 规格包路径输入栏。如果发现界面上有不需要的产品制式，需要在设
置对话框中将其勾掉，否则在开始制作的时候会提示需要输入文件。
点击“Setting”按钮，弹出工具设置对话框，如图 3.15 所示。在“Products”一项中勾
掉不需要的产品制式，然后点击“OK”按钮。此时界面上会隐藏所有被勾掉产品制式的
BBU 规格包路径输入栏。下次打开工具会显示上次选择的产品制式。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 14
 UMaker 工具操作指导手册 内部公开▲

图 3.15 勾掉多余产品制式

3.7 输入基站 RRU 版本文件路径

有些制式的基站的 RRU 软件是一个单独的规格包，比如 LTE TDD 的基站，如果要对
此 基 站 进 行 开 站 ， U 盘 中 除 了 要 有 BBU 规 格 包 外 还 要 有 RRU 规 格 包 。 点 击 “ RRU
Package”输入行的“…”编辑按钮，选择版本 RRU 规格包文件的路径，如图 3.16 所示。

图 3.16 选择 RRU 规格包文件路径

如果不需要 RRU 规格包，请隐藏界面上的 RRU 规格包输入行：点击“Setting”按钮，
弹 出 工 具 设 置 对 话 框 ， 如 图 3.17 所 示 ， 勾 掉 “ Input RRU Package” 一 项 ， 然 后 点 击
“OK”按钮。此时界面上会隐藏 RRU 规格包输入行。下次打开工具会依据上次的选择进行
显示。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 15
 UMaker 工具操作指导手册 内部公开▲

图 3.17 不需要 RRU 规格包

3.8 清空 U 盘内容
在开始制作 U 盘之前，如果不确定其内部的版本文件和配置数据的正确性和完整性，
那么可以使用“Clear USB”功能来对 U 盘内容进行清除处理。点击工具栏中的“ Clear
USB”按钮，如图 3.18，即可清空 U 盘中的内容。 “Clear USB”功能只会删除所选 U 盘中
和 USB 开站功能有关的文件。
建议：每次执行制作前都清空 U 盘中的文件，这样可以最大程度地保证 U 盘中数据的
正确性。

图 3.18 清空 U 盘

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 16
 UMaker 工具操作指导手册 内部公开▲

3.9 制作 U 盘内容
1、点击工具栏中的“Make”按钮，如图 3.19 所示，写入版本、配置文件到 U 盘中。

图 3.19 开始执行任务
2、如果 MO 数据文件中所配置的无线制式和用户所选的规格包产品制式不一致，会提
示用户是否进行继续进行，如图 3.20，如果选择“No”工具会结束制作过程。
建议：输入的 MO 数据文件制式要和所制作的规格包制式一致，以防出现开站失败的
问题。

图 3.20 提示用户数据文件制式和所选规格包制式不一致
3、如果 U 盘中已存在版本文件，会提示用户是否进行覆盖，如图 3.21，如果选择
“No”工具会结束制作过程。

图 3.21 提示用户覆盖文件
4、制作过程中工具状态栏中会显示当前的处理状态，开始制作任务时工具会自动检查
所有输入项的有效性，输入表格的“Status”列会显示输入文件是否是有效的。如果工具对
输入文件的检查结果为“Valid”说明输入的文件有效，可以写入 U 盘中；相反若检查结果
为“Invalid”说明输入的文件不允许写入 U 盘。写入成功后信息面板中会有“Making
operation succeed”提示信息。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 17
 UMaker 工具操作指导手册 内部公开▲

图 3.22 制作完成界面
成功制作完 U 盘会耗时两到十几分钟不等，这和所制作的版本文件大小、 USB 接口读
写速度有关。

3.10 其他操作说明

3.10.1 提前检查输入文件的有效性

用户可以再开始制作 U 盘前就检查所输入文件的有效性。点击界面上每一个输入行尾
的“Check”按钮，如图 3.23，就可以检查相应输入文件是否是有效的。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 18
 UMaker 工具操作指导手册 内部公开▲

图 3.23 提前检查输入文件的有效性

3.10.2 打开 UMaker 工具所在路径

选择“File | Open Work Directory” 菜单可以打开 UMaker 工具所在路径，如图 3.24。

图 3.24 打开 UMaker 工具所在路径

3.10.3 打开 U 盘所在路径

选择“File | Open USB Directory” 菜单可以打开所选 U 盘的路径，如图 3.25。

图 3.25 打开所选 U 盘的路径

3.10.4 只更新 U 盘中的 MO 数据文件

使用场景：用同一个 U 盘开通多个基站，基站的版本都是相同的，不同的只是各基站
的配置数据，此时可以只更新 U 盘中的 MO 数据文件。操作前提条件：U 盘中已经存在之
前通过 UMaker 写入的基站版本文件。

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 19
 UMaker 工具操作指导手册 内部公开▲

点击“Setting”按钮，弹出工具设置对话框，如图 3.26 所示。勾选“Only update MO

date file”这一项，然后点击“OK”按钮。此时界面只显示 U 盘路径和 MO 数据文件路径输
入栏。下次打开工具会依据上次的选择来显示。
接下来选择 U 盘路径和 MO 数据文件路径，点击“Make”按钮进行制作即可。

图 3.26 只更新 MO 数据文件

本文中的所有信息均为中兴通讯股份有限公司内部信息，不得向外传播 20