EAE Solution Overview

Analyzes EcoStruxure Automation Expert (EAE) projects and generates comprehensive reports.

Quick Start

# Basic analysis - generates markdown report
python scripts/analyze_project.py --project-dir /path/to/project

# JSON output for automation
python scripts/analyze_project.py --project-dir /path/to/project --json

# Quick summary
python scripts/analyze_project.py --project-dir /path/to/project --format summary

# Save report to file
python scripts/analyze_project.py --project-dir /path/to/project --output report.md

Triggers

Use this skill when:

• "analyze EAE project"
• "generate project report"
• "project overview"
• "solution summary"
• "show project quality"
• "what's in this EAE project"
• /eae-sln-overview

Quick Reference

Report Sections

1. Executive Summary

Quick metrics table with quality score, project count, device count, blocks, and I/O points.

2. Network Architecture

ASCII diagram showing device topology with:

• Device names and types
• Resource counts
• CAT instance counts

3. Protocol Inventory

4. Library Matrix

• SE Standard Libraries: Runtime.Base, SE.App2CommonProcess, etc.
• Custom Libraries: Project-specific namespaces with dependencies

5. I/O Summary

6. ISA88 Hierarchy

System/Subsystem hierarchy from System.sys:

System: System
  +-- Subsystem: JetMix (JetMix)
      +-- Equipment modules...
  +-- Subsystem: JetSpray (JetSpray)
      +-- Equipment modules...

Parsed from Device.FolderPath attribute and CAT instances in System.sys.

7. Quality Score

8-dimension scoring system (100 points total):

Grades: A (90+), B (80-89), C (70-79), D (60-69), F (<60)

Commands

Main Orchestrator

python scripts/analyze_project.py --project-dir PATH [OPTIONS]

Options:
  --project-dir PATH    EAE project root directory (required)
  --format FORMAT       Output: markdown, json, summary (default: markdown)
  --output PATH         Write to file instead of stdout
  --json                Shortcut for --format json

Individual Scripts

Run individual analysis modules for targeted inspection:

# Solution structure
python scripts/parse_solution.py --project-dir PATH [--json]

# System topology
python scripts/parse_system_topology.py --project-dir PATH [--json]

# Protocol detection
python scripts/parse_protocols.py --project-dir PATH [--json]

# Library analysis
python scripts/parse_libraries.py --project-dir PATH [--json]

# I/O counting
python scripts/count_io.py --project-dir PATH [--json] [--details]

# ISA88 hierarchy
python scripts/parse_isa88.py --project-dir PATH [--json]

# Project description
python scripts/parse_description.py --project-dir PATH [--json]

# Quality scoring
python scripts/calculate_quality.py --project-dir PATH [--json]

Exit Codes

Output Formats

Markdown (default)

Full report with tables, ASCII diagrams, and formatted sections. Best for documentation.

JSON

Structured data for automation and integration:

{
  "project_dir": "/path/to/project",
  "analyzed_at": "2024-01-15T10:30:00",
  "solution": { ... },
  "topology": { ... },
  "protocols": { ... },
  "libraries": { ... },
  "io": { ... },
  "isa88": { ... },
  "quality": { ... }
}

Summary

One-line-per-metric quick overview:

Project: MyProject
Description: MyProject is an IEC 61499 automation project for food and beverage processing.
EAE Version: 24.0.0.0
Quality: 75/100 (Grade C)
Projects: 3
Blocks: 250
I/O Points: 8,287
SE Libraries (16): Runtime.Base, SE.AppBase, ...
Custom Libraries (3): MyLib.IoLink, ...
Protocols: OPC-UA (0 refs), Modbus (334 refs), EtherNet/IP (1475 refs)
System: System
Subsystems (4): JetMix, JetSpray, JetFlam, Ligne
Equipment Modules: 114

Project Locations

Default EAE project locations:

• C:\Users\{user}\Documents\Schneider Electric\EcoStruxureAutomationExpertProjects
• C:\Users\{user}\Documents\GitHub

Files Analyzed

Integration with Other Skills

Anti-Patterns

Verification

After running analysis:

• Quality score calculated (not error)
• All 8 analysis sections present (solution, topology, protocols, libraries, io, isa88, description, quality)
• No critical warnings
• Library list includes SE and custom libraries
• Protocol detection shows expected communication types
• ISA88 subsystems match expected configuration

Troubleshooting

"Project directory not found"

Ensure the path points to the root containing .sln or IEC61499/ folder.

"No .dfbproj files found"

The project may not be an IEC61499 project or may have a non-standard structure.

"System directory not found"

The project doesn't have a configured system topology yet. This is normal for library-only projects.

"No subsystems found"

ISA88 hierarchy is not configured in System.sys. Ensure Device.FolderPath is defined with subsystem names.

Changelog

v1.1.0

• Added parse_description.py - hybrid description generation (docs + metadata inference)
• Enhanced protocol detection from .hcf files and library references
• Added EAE version detection from .dfbproj files
• Fixed ISA88 parsing to use System.sys instead of Assets.json
• Improved custom library detection via ProjectReference elements
• Added compatibility field to frontmatter

v1.0.0

• Initial release
• 7 analysis modules
• 8-dimension quality scoring
• Markdown, JSON, summary output formats
• ASCII network diagrams