UB File Parsing

Description

Parses the UB maintenance and test information file.

To obtain the Unified Bus (UB) file, export the UB file by referring to section " Exporting System Logs and Other Maintenance and Test Information from the Device > Exporting System Logs and Other Maintenance and Test Information from the Device at a Time" in msnpureport Tool.

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	√
Atlas A2 training product/Atlas A2 inference product	√
Atlas 200I/500 A2 inference product	√
Atlas inference product	√
Atlas training product	√

Command

asys analyze -r=ub --path=directory --output=path

Parameters

r : specifies the parsing mode. This parameter is mandatory. Set it to ub to parse the UB maintenance and test information collection file in binary format for subsequent fault locating.
path: specifies a directory, which is used to parse binary files in the specified directory. This parameter is mandatory in UB mode. The asys reads the following binary files in the path and parses them into TXT files with the same names.
- Ubnl_dfx_config_item.bin: UB network layer configuration entry
- ubnl_dfx_statistic.bin: UB network layer statistics
- Ubnl_dfx_ssu_schedule.bin: system scheduling unit (SSU) scheduling queue statistics and queue packet loss statistics at the UB network layer
- ubmem_daw.bin: configuration entries of the UB memory
- ubtpl_acl_src.bin: key entries and configurations at the UB transport layer
- sl_to_vl.bin: UB QOS (Quality of Service) configuration & entry
output (optional): Its value is used as the prefix of the result output directory of the asys tool. That is, the final output directory is {output}/asys_output_timestamp. If the command does not contain the output parameter, the output is stored in the command execution directory. If the value of output is empty or invalid, the specified directory does not have the write permission, or the directory fails to be created, the asys tool exits and reports an error.

Usage Example and Output Description

asys analyze -r=ub --path=/home/test/msnpureport/device-0/ub

After the command is executed, you can obtain the parsed .txt file based on the path displayed on the terminal. The following is an example:

2026-02-12 14:23:10,020 [ASYS] [INFO]: asys start.
2026-02-12 14:23:10,021 [ASYS] [INFO]: asys output directory: /home/test/asys_output_20260212142310021
2026-02-12 14:23:10,032 [ASYS] [INFO]: Conversion successful! /home/test/msnpureport/device-0/ub/ubnl_dfx_statistic.bin has been converted to text file /home/test/asys_output_20260212142310021/ubnl_dfx_statistic.txt
......
2026-02-12 14:23:10,049 [ASYS] [INFO]: analyze task execute finish.
2026-02-12 14:23:10,049 [ASYS] [INFO]: asys finish.

Parent topic: asys Tool Usage Guide