cdma2000 BSC BAM调试命令指导书-20030927-A-1.1.doc

CDMA2000BSC BAM调试命令指导书内部公开资料编码产品名称Cdma2000 BSC6600使用对象技术支持工程师产品版本V100R002B03编写部门CBSC资料版本1.0cdma2000 BSC BAM调试命令指导书拟 制：张星、维护组日 期：2003/07/15审 核：日 期：审 核：日 期：批 准：日 期：华 为 技 术 有 限 公 司版权所有 侵权必究修订记录日期修订版本描述作者2003/09/231.00初稿完成张星2003/09/121.01根据维护组意见修改张星2003/09/271.1根据PDM意见修改张星，袁海勋，张建胜目 录第1章 简介51.1 目的5第2章 命令使用方法52.1 DBG STR命令52.1.1 命令简述52.1.2 使用方法52.1.3 参考样例62.1.4 注意事项72.2 DBG END命令72.2.1 命令简述72.2.2 使用方法72.2.3 参考样例82.2.4 注意事项82.3 DBG LNK命令82.3.1 命令简述82.3.2 使用方法82.3.3 参考样例92.3.4 注意事项92.4 DBG BRK命令92.4.1 命令简述92.4.2 使用方法92.4.3 参考样例102.4.4 注意事项102.5 DBG CMD命令102.5.1 命令简述102.5.2 使用方法102.5.3 参考样例11第3章 调试命令执行样例123.1 打开前台2框7槽MUX板的调试开关123.2 与调试单板建立连接123.3 执行调试命令133.4 断开与调试单板的连接133.5 结束调试状态14第4章 解密工具使用方法15第5章 附件155.1 附件115图目录图2-1 DBG STR调试命令执行界面6图2-2 DBG END 调试命令执行界面7图2-3 DBG LNK 调试命令执行界面8图2-4 DBG BRK 调试命令执行界面10图2-5 DBG CMD 调试命令执行界面11cdma2000 BSC BAM调试命令指导书第1章 简介1.1 目的BAM中新增加的支持调试台命令，用来替代原调试台的功能，可以把一条或多条原调试台命令发到前台单板；该功能随产品一起发布，增加了产品对调试台的支持功能，使开局现场的定位问题的手段更加丰富完善。第2章 命令使用方法注意：调试台命令在BAM中都定义为隐含命令，不对客户开放，在客户端输入该类命令，不会产生联想。实际应用时，把已编写好的脚本，直接拷贝到命令窗口执行。主要目的是用于开局现场，没有调试台工具，直接由后方提供测试脚本，执行后，把结果文件发回后方进行问题定位。CBSC问题定位必须的调试台操作及命令，请见附件2。NOTE:调试命令的使用会对BSC主机的性能造成一定的影响，一般只在定位问题时启用。如果要使用，务必要得到用服地区部和CBSC维护部的许可！2.1 DBG STR命令2.1.1 命令简述执行此命令，进入调试状态，否则，无法执行链接单板命令。2.1.2 使用方法图2-1 DBG STR调试命令执行界面使用DBG STR命令进入调试状态；只有在调试状态下，才能进行其它调试命令执行。单板记录文件名如果缺省，则默认为“Boards.log”；它存放于AirbridgeServicesBoardLog目录下；2.1.3 参考样例DBG STR: FILENAME=Test, FILESIZE=20, MINFC=12, MAXFC=55, ENCRYPT=0;命令参数解释l FILENAME 可以为空，缺省文件名为“Boards.log”;输入的文件名，即为保存单板调试日志和前台上报信息的文件。l FILESIZE 文件大小（MByte），最大为20M；当保存的文件超过最大值时，自动生成一个备份文件，原文件清空。l DURATION 调试周期，缺省值是60分钟；在此时间内用户可以对前台单板进行调试，超过该时间，自动释放所有链接，结束调试状态。l MINFC 最小流控门限，当前后台调试信息流量小于该值时，恢复前台上报；建议用缺省值(10KBYTES/S)。l MAXFC 最大流控门限，当前后台调试信息流量大于该值时，禁止前台上报；建议用缺省值(50KBYTES/S)。l ENCRYPT 加密标志，选0为不加密，单板记录文件内容，可直接阅读查看；缺省为1，为加密，单板文件内容被加密，需要用专门的解密工具进行解密，才能阅读文件内容。2.1.4 注意事项l 流控参数不要随意设置，建议用缺省参数；如果MAXFC过大，或MINFC过小，都有可能导致前台单板不能上报信息。l 执行该命令，如果命令中的文件已存在，则清除原来文件内容，该文件只记录一次调试状态下，单板上报和日志信息。如果上次调试状态下的记录需要保留，一定要在执行该命令前拷贝保存该文件到其它目录，或改为其它文件名。2.2 DBG END命令2.2.1 命令简述执行该命令，结束调试状态。结束所有已建立的链接。2.2.2 使用方法图2-2 DBG END 调试命令执行界面只有在执行成功DBG STR命令后，才能成功执行该命令。否则，会提示不在调试状态。2.2.3 参考样例DBG END:;2.2.4 注意事项l 执行该命令，调试进程断开已建立的所有调试单板的链接。确认不再需要前台上报调试信息，再执行该命令。l 该命令不能加在批命令中执行，这样会导致前台上报信息还未结束，BAM就已脱离调试状态，导致前台上报信息不能完整记录。l 关闭维护台窗口，对正在进行的调试状态无任何影响。2.3 DBG LNK命令2.3.1 命令简述执行该命令，与需要调试的单板建立链接。2.3.2 使用方法图2-3 DBG LNK 调试命令执行界面在执行完DBG STR命令后，BAM进入调试状态，此时，可以在客户端执行该命令与前台单板建立链接。2.3.3 参考样例DBG LNK: FN=2, CN=7, SSN=1, CPUNO=1;命令参数解释l FN 调试单板所在的框l CN 调试单板的CELLBUS号l SSN 调试单板的子系统号l CPUNO 调试单板的CPU编号2.3.4 注意事项链接建立不成功时，检查是否有调试台、维和台与该单板已建立链接；或网络连接是否正常。2.4 DBG BRK命令2.4.1 命令简述执行该命令，与已建立链接的单板断开链接。2.4.2 使用方法图2-4 DBG BRK 调试命令执行界面在已建立与前台单板的连接下，如果需要强制中断这个连接，执行该命令，可以断开与指定单板已建立的连接。2.4.3 参考样例DBG BRK: FN=2, CN=7, SSN=1, CPUNO=1;命令参数解释l FN 调试单板所在的框l CN 调试单板的CELLBUS号l SSN 调试单板的子系统号l CPUNO 调试单板的CPU编号2.4.4 注意事项确认所需要的调试信息都已完全上报记录2.5 DBG CMD命令2.5.1 命令简述执行该命令，向前台调试单板发送调试命令。2.5.2 使用方法图2-5 DBG CMD 调试命令执行界面在客户端执行该命令，前台2框7槽单板打印开关打开。2.5.3 参考样例DBG CMD: FN=2, CN=7, CMD=set=0x02, SUB_COM=0x02, LEVEL=0x02;命令参数解释l FN 调试单板所在的框。l CN 调试单板的CELLBUS号。l CMD 调试命令参数，即原调试台命令。注意事项l 命令参数CMD输入一定要符合下面的规范：l 命令中的CMD参数，可支持多条调试台命令，但最多不超过250个字符；l CMD参数可由多个调试台子命令组成，每个子命令之间用“，”隔开，如“SET= 0x02, SUB_COM= 0x03”；每个子命令可包含一个或多个十六进制参数，两个以上的参数，之间用空格隔开，如“PID= 0x00 0x01 0x0A”， 每个参数为一个字节，必须按“0xab”格式书写，小于或等于0xF的参数，必须补0，构成二位形式，如“0x03”，不能写成“0x3”。l 命令参数的结尾，一定不能加“；”。l 命令参数样例set=0x02, SUB_COM=0x02, LEVEL=0x02执行成功携带该命令参数的DBG CMD调试命令，对应的前台调试单板所有打印开关打开。第3章 调试命令执行样例3.1 打开前台2框7槽MUX板的调试开关按缺省值进入调试状态3.2 与调试单板建立连接上面的命令执行成功后，执行该命令，与要调试的单板建立连接。3.3 执行调试命令上面命令执行成功后，可执行该命令，向调试单板下发调试命令。命令执行成功后，前台打印开关打开。3.4 断开与调试单板的连接执行该命令，可立即与已建立连接的单板断开连接；如果不执行该命令，当“DBG STR”命令中设置的调试时间到时，系统会自动断开所有已建的连接。3.5 结束调试状态执行该命令，会立即断开已建的连接；如果不执行该命令，当“DBG STR”命令中设置的调试时间到时，系统会自动断开所有已建的连接第4章 解密工具使用方法l 运行WatchSpy.exe弹出下面的对话框点击“Source file”对应的按钮，