根据您提供的vdb报告内容和之前讨论的脚本化覆盖率收集方法，我将提供一个Python脚本，使用npi（Netlist Productivity Interface）来提取与文档格式一致的覆盖率信息。 ```python #!/usr/bin/env python3 """ VCS覆盖率报告解析脚本 - 使用npi提取vdb信息 与提供的报告格式保持一致 """ import sys import os import pandas as pd from datetime import datetime import npi class VDBCoverageExtractor: def __init__(self, vdb_path): """ 初始化覆盖率提取器 Args: vdb_path: vdb文件或目录路径 """ self.vdb_path = vdb_path self.coverage_data = {} self.uncovered_items = { 'line': [], 'toggle': [], 'condition': [], 'branch': [], 'fsm': [], 'function': [] } def load_vdb(self): """加载vdb文件""" try: # 初始化npi npi.initialize() # 加载覆盖率数据库 if os.path.isdir(self.vdb_path): # 如果是目录，查找.vdb文件 vdb_files = [f for f in os.listdir(self.vdb_path) if f.endswith('.vdb')] if vdb_files: self.cov_db = npi.CovDatabase() for vdb_file in vdb_files: self.cov_db.load(os.path.join(self.vdb_path, vdb_file)) else: raise FileNotFoundError(f"No .vdb files found in {self.vdb_path}") else: # 单个vdb文件 self.cov_db = npi.CovDatabase() self.cov_db.load(self.vdb_path) print(f"✓ Successfully loaded coverage database: {self.vdb_path}") return True except Exception as e: print(f"✗ Failed to load vdb: {e}") return False def extract_coverage_summary(self): """提取覆盖率汇总信息（与文档第一张表一致）""" try: # 获取各种覆盖率类型的统计 coverage_types = ['line', 'toggle', 'fsm', 'condition', 'branch', 'function', 'assert'] summary_data = [] for cov_type in coverage_types: try: # 获取覆盖率统计 cov_data = self.cov_db.getCoverage(cov_type) total_items = cov_data.total if hasattr(cov_data, 'total') else 0 covered_items = cov_data.covered if hasattr(cov_data, 'covered') else 0 uncovered_items = cov_data.uncovered if hasattr(cov_data, 'uncovered') else 0 # 计算覆盖率百分比 coverage_pct = (covered_items / total_items * 100) if total_items > 0 else 0 summary_data.append({ 'Coverage Type': cov_type, 'Total Items': total_items, 'Covered Items': covered_items, 'Uncovered Items': uncovered_items, 'Coverage %': f"{coverage_pct:.2f}%" }) # 存储未覆盖项用于详细分析 if uncovered_items > 0: self._extract_uncovered_details(cov_type) except Exception as e: print(f"Warning: Could not extract {cov_type} coverage: {e}") summary_data.append({ 'Coverage Type': cov_type, 'Total Items': 0.0, 'Covered Items': 0.0, 'Uncovered Items': 0.0, 'Coverage %': "0.00%" }) # 创建DataFrame（与文档格式一致） self.summary_df = pd.DataFrame(summary_data) return True except Exception as e: print(f"✗ Failed to extract coverage summary: {e}") return False def _extract_uncovered_details(self, cov_type): """提取未覆盖项的详细信息""" try: if cov_type == 'line': self._extract_uncovered_lines() elif cov_type == 'toggle': self._extract_uncovered_toggles() elif cov_type == 'condition': self._extract_uncovered_conditions() elif cov_type == 'branch': self._extract_uncovered_branches() except Exception as e: print(f"Warning: Could not extract {cov_type} details: {e}") def _extract_uncovered_lines(self): """提取未覆盖的行覆盖率信息""" try: # 获取所有未覆盖的行 uncovered_lines = self.cov_db.getUncoveredLines() for line_info in uncovered_lines: file_name = os.path.basename(line_info.file) if hasattr(line_info, 'file') else "unknown" line_no = line_info.line if hasattr(line_info, 'line') else 0 hdl_path = line_info.hier if hasattr(line_info, 'hier') else "" # 尝试获取行内容（需要源代码访问） line_content = self._get_line_content(file_name, line_no) self.uncovered_items['line'].append({ 'file_name': file_name, 'line_no': line_no, 'line_content': line_content, 'hdl_path': hdl_path, 'is_covered': False, 'need_coverage': None, 'coverage_scenario': None, 'new_testcase': None, 'remarks': None }) except Exception as e: print(f"Warning: Could not extract uncovered lines: {e}") def _extract_uncovered_toggles(self): """提取未覆盖的toggle信息（与文档第二张表一致）""" try: # 获取未覆盖的toggle uncovered_toggles = self.cov_db.getUncoveredToggles() for toggle_info in uncovered_toggles: file_name = os.path.basename(toggle_info.file) if hasattr(toggle_info, 'file') else "unknown" line_no = toggle_info.line if hasattr(toggle_info, 'line') else 0 signal_name = toggle_info.signal if hasattr(toggle_info, 'signal') else "" bin_scene = self._get_toggle_scene(toggle_info) # 获取toggle场景 is_port = toggle_info.isPort if hasattr(toggle_info, 'isPort') else False hdl_path = toggle_info.hier if hasattr(toggle_info, 'hier') else "" self.uncovered_items['toggle'].append({ 'file_name': file_name, 'line_no': line_no, 'signal_name': signal_name, 'bin_scene': bin_scene, 'is_port': is_port, 'hdl_path': hdl_path, 'is_covered': False, 'need_coverage': None, 'coverage_scenario': None, 'new_testcase': None, 'remarks': None }) except Exception as e: print(f"Warning: Could not extract uncovered toggles: {e}") def _get_toggle_scene(self, toggle_info): """获取toggle场景描述""" try: if hasattr(toggle_info, 'transition'): trans = toggle_info.transition if trans == '0->1': return '0 -> 1' elif trans == '1->0': return '1 -> 0' elif trans == 'X->0': return 'X -> 0' elif trans == 'X->1': return 'X -> 1' elif trans == '0->X': return '0 -> X' elif trans == '1->X': return '1 -> X' return 'unknown' except: return 'unknown' def _get_line_content(self, file_name, line_no): """尝试从源代码文件获取行内容""" try: # 这里需要根据实际情况调整源代码路径 source_paths = [ f"./src/{file_name}", f"./rtl/{file_name}", f"./design/{file_name}", file_name ] for path in source_paths: if os.path.exists(path): with open(path, 'r') as f: lines = f.readlines() if 0 <= line_no-1 < len(lines): return lines[line_no-1].strip() break return "Source not found" except: return "Source not found" def _extract_uncovered_conditions(self): """提取未覆盖的条件覆盖率信息""" try: uncovered_conds = self.cov_db.getUncoveredConditions() for cond_info in uncovered_conds: # 根据实际情况提取条件覆盖率信息 # 这里需要根据npi API调整 pass except Exception as e: print(f"Note: Condition extraction may require specific API calls: {e}") def _extract_uncovered_branches(self): """提取未覆盖的分支覆盖率信息""" try: uncovered_branches = self.cov_db.getUncoveredBranches() for branch_info in uncovered_branches: # 根据实际情况提取分支覆盖率信息 # 这里需要根据npi API调整 pass except Exception as e: print(f"Note: Branch extraction may require specific API calls: {e}") def generate_report(self, output_dir="./coverage_reports"): """生成与文档格式一致的报告""" try: # 创建输出目录 os.makedirs(output_dir, exist_ok=True) timestamp = datetime.now().strftime("%Y%m%d_%H%M%S") report_file = os.path.join(output_dir, f"coverage_report_{timestamp}.xlsx") # 使用Excel写入器创建多sheet报告 with pd.ExcelWriter(report_file, engine='openpyxl') as writer: # Sheet 1: 覆盖率汇总（与文档第一张表一致） self.summary_df.to_excel(writer, sheet_name='Coverage Summary', index=False) # Sheet 2: 函数覆盖率状态 function_status = pd.DataFrame({ 'Status': ['All function coverage items are covered! ✓'] }) function_status.to_excel(writer, sheet_name='Function Status', index=False) # Sheet 3: 未覆盖行详情 if self.uncovered_items['line']: line_df = pd.DataFrame(self.uncovered_items['line']) line_df.to_excel(writer, sheet_name='Uncovered Lines', index=False) # Sheet 4: 未覆盖toggle详情 if self.uncovered_items['toggle']: toggle_df = pd.DataFrame(self.uncovered_items['toggle']) toggle_df.to_excel(writer, sheet_name='Uncovered Toggles', index=False) # Sheet 5: 注释说明 note_df = pd.DataFrame({ 'Note': ['Individual sheets show only UNCOVERED items for focused analysis'] }) note_df.to_excel(writer, sheet_name='Notes', index=False) print(f"✓ Report generated: {report_file}") # 同时在控制台输出汇总信息 self._print_console_summary() return report_file except Exception as e: print(f"✗ Failed to generate report: {e}") return None def _print_console_summary(self): """在控制台输出格式化汇总信息""" print("\n" + "="*80) print("COVERAGE SUMMARY") print("="*80) # 打印汇总表 print("\n| Coverage Type | Total Items | Covered Items | Uncovered Items | Coverage % |") print("| ------------- | ----------- | ------------- | --------------- | ---------- |") for _, row in self.summary_df.iterrows(): cov_type = str(row['Coverage Type']).ljust(13) total = str(row['Total Items']).rjust(11) covered = str(row['Covered Items']).rjust(13) uncovered = str(row['Uncovered Items']).rjust(14) coverage_pct = str(row['Coverage %']).rjust(10) print(f"| {cov_type} | {total} | {covered} | {uncovered} | {coverage_pct} |") # 打印函数覆盖率状态 print("\n" + "|" + "-"*74 + "|") print("| All function coverage items are covered! ✓".ljust(74) + "|") print("|" + "-"*74 + "|") # 打印未覆盖行示例（前6行） if self.uncovered_items['line']: print("\n" + "="*80) print("UNCOVERED LINES (Sample)") print("="*80) print("\n| file_name | line_no | line_content | hdl_path | is_covered | need_coverage | coverage_scenario | new_testcase | remarks |") print("| --------- | ------- | ------------ | -------- | ---------- | ------------- | ----------------- | ------------ | ------- |") for i, line in enumerate(self.uncovered_items['line'][:6]): # 只显示前6行 file_name = str(line['file_name']).ljust(9) line_no = str(line['line_no']).rjust(7) line_content = str(line['line_content'])[:20].ljust(20) # 截断长内容 hdl_path = str(line['hdl_path']).ljust(8) is_covered = str(line['is_covered']).ljust(10) print(f"| {file_name} | {line_no} | {line_content} | {hdl_path} | {is_covered} | nan | nan | nan | nan |") # 打印未覆盖toggle示例（前10个） if self.uncovered_items['toggle']: print("\n" + "="*80) print("UNCOVERED TOGGLES (Sample)") print("="*80) print("\n| file_name | line_no | signal_name | bin_scene | is_port | hdl_path | is_covered | need_coverage | coverage_scenario | new_testcase | remarks |") print("| --------- | ------- | ----------- | --------- | ------- | -------- | ---------- | ------------- | ----------------- | ------------ | ------- |") for i, toggle in enumerate(self.uncovered_items['toggle'][:10]): # 只显示前10个 file_name = str(toggle['file_name']).ljust(9) line_no = str(toggle['line_no']).rjust(7) signal_name = str(toggle['signal_name']).ljust(11) bin_scene = str(toggle['bin_scene']).ljust(9) is_port = str(toggle['is_port']).ljust(6) hdl_path = str(toggle['hdl_path']).ljust(8) is_covered = str(toggle['is_covered']).ljust(10) print(f"| {file_name} | {line_no} | {signal_name} | {bin_scene} | {is_port} | {hdl_path} | {is_covered} | nan | nan | nan | nan |") print("\n" + "="*80) print(f"Note: Full details available in Excel report") print("="*80) def cleanup(self): """清理资源""" try: if hasattr(self, 'cov_db'): self.cov_db.close() npi.cleanup() print("✓ Resources cleaned up") except: pass def main(): """主函数""" import argparse parser = argparse.ArgumentParser(description='Extract VCS coverage from vdb files using npi') parser.add_argument('vdb_path', help='Path to vdb file or directory') parser.add_argument('-o', '--output', default='./coverage_reports', help='Output directory for reports (default: ./coverage_reports)') parser.add_argument('-v', '--verbose', action='store_true', help='Enable verbose output') args = parser.parse_args() print("="*80) print("VCS COVERAGE EXTRACTOR USING NPI") print("="*80) # 创建提取器实例 extractor = VDBCoverageExtractor(args.vdb_path) try: # 1. 加载vdb文件 if not extractor.load_vdb(): sys.exit(1) # 2. 提取覆盖率汇总信息 print("\nExtracting coverage summary...") if not extractor.extract_coverage_summary(): sys.exit(1) # 3. 生成报告 print("\nGenerating report...") report_path = extractor.generate_report(args.output) if report_path: print(f"\n✓ Report successfully generated at: {report_path}") # 显示关键统计 print("\n" + "="*80) print("KEY STATISTICS:") print("="*80) total_toggles = extractor.summary_df.loc[extractor.summary_df['Coverage Type'] == 'toggle', 'Total Items'].values[0] covered_toggles = extractor.summary_df.loc[extractor.summary_df['Coverage Type'] == 'toggle', 'Covered Items'].values[0] toggle_cov = extractor.summary_df.loc[extractor.summary_df['Coverage Type'] == 'toggle', 'Coverage %'].values[0] print(f"Toggle Coverage: {covered_toggles:.0f}/{total_toggles:.0f} ({toggle_cov})") print(f"Line Coverage: {extractor.summary_df.loc[extractor.summary_df['Coverage Type'] == 'line', 'Coverage %'].values[0]}") print(f"Condition Coverage: {extractor.summary_df.loc[extractor.summary_df['Coverage Type'] == 'condition', 'Coverage %'].values[0]}") print(f"Branch Coverage: {extractor.summary_df.loc[extractor.summary_df['Coverage Type'] == 'branch', 'Coverage %'].values