Skip to content

v0.3.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 18 May 09:18
· 71 commits to master since this release
v0.3.1
ccd90ca

馃殌 v0.3.1 - The Semantic Framework Update

This major release marks the transformation of omcipcap from a basic packet parser into a comprehensive GPON/XGS-PON OMCI Semantic Analysis Framework. It introduces a pluggable semantic registry, enhanced JSON IR for AI-driven analysis, and critical stability fixes for standalone binaries.

馃専 Major Highlights

1. Dynamic Semantic Framework

  • Pluggable Translators: Introduced the OMCISemantic registry to decouple G.988 logic from the core protocol parser.
  • Runtime Extensions: Added the --semantic-dir argument, allowing users to dynamically load external Python scripts (e.g., extensions/add_me134_option.py) to override or extend ME attribute decoding logic without modifying the core source code.
  • Intelligent Decoding: Native support for human-readable IPv4 addresses, MAC addresses, and VLAN filter lists (ME 84/171) instead of raw hexadecimal strings.

2. AI-Ready Topology & JSON IR

  • Topology Command: Rebranded the graphic command to topology with enhanced data depth.
  • Machine-Readable Relations: The Topology JSON now includes explicit semantic relations (pointers) between MEs, specifically optimized for path analysis by LLMs (e.g., GPT-4, Claude).
  • Standardized JSON Output: Added -j/--json-output support across all sub-commands (mibdb, diff, check, vlan-tbl, tcont-flow).

3. Advanced MIB Management

  • mibdb Command: A powerful new command to snapshot and analyze the entire ONU MIB state from PCAP files.
  • Semantic diff: Implemented semantic-aware MIB comparisons. You can now see logical changes like VID: 100 -> VID: 200 instead of binary/hex differences.
  • Custom MIB Definitions: Support for --mib-json to load vendor-specific Managed Entity (ME) definitions.

4. CLI & UI Revamp

  • Kebab-case Standardization: Standardized all sub-commands to POSIX/GNU style (e.g., vlan-tbl, tcont-flow).
  • Rich UI: Integrated the rich library for beautiful, color-coded terminal tables and hierarchical trees.

馃敡 Fixes & Maintenance (v0.3.1 Hotfix)

  • Absolute Import Enforcement: Resolved ImportError issues on Windows and Linux standalone binaries by migrating from relative to absolute imports in cli.py.
  • CI/CD Integration: Implemented a GitHub Actions workflow for automated testing on Ubuntu 24.04.
  • Code Quality: Standardized copyright headers and performed a comprehensive cleanup of unused imports.

馃摉 Example Usage

# Analyze MIB state with custom vendor extensions
omcipcap mibdb --class-id=134 --semantic-dir ./extensions sample.pcapng

# Compare two MIB states with semantic-aware output
omcipcap diff base.pcap target.pcap

Full Changelog: v0.2.4...v0.3.1

Assets 7
Loading