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

Analysis	Description	Script
Solution	Projects, blocks, library refs, EAE version	parse_solution.py
Topology	Devices, resources, CAT instances	parse_system_topology.py
Protocols	OPC-UA, Modbus, EtherNet/IP, IO-Link	parse_protocols.py
Libraries	SE vs custom, dependencies	parse_libraries.py
I/O	Event/data inputs/outputs	count_io.py
ISA88	System/subsystem hierarchy	parse_isa88.py
Description	Project description (docs or inferred)	parse_description.py
Quality	8-dimension scoring	calculate_quality.py

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

Protocol	What's Detected
OPC-UA Server	Exposed node count, over-exposure warnings
OPC-UA Client	Cross-device connections
Modbus TCP/RTU	Masters and slaves
EtherNet/IP	Scanner instances
Other	DNP3, PROFINET, IO-Link, etc.

4. Library Matrix

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

5. I/O Summary

Category	Description
Event Inputs	INIT, REQ, etc.
Event Outputs	INITO, CNF, etc.
Data Inputs	Interface variables (inputs)
Data Outputs	Interface variables (outputs)
Internal Vars	Private variables
Adapters	Socket/Plug connections

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):

Dimension	Max	Description
Naming Compliance	20	SE naming convention adherence
Library Organization	15	SE/custom separation, dependencies
Documentation	15	.doc.xml coverage, comments
ISA88 Hierarchy	15	Asset structure and CAT linking
Protocol Config	10	OPC-UA exposure, clean configs
Code Organization	10	Folder structure, consistency
Block Complexity	10	Variable counts, event fanout
Reusability	5	Adapter usage, composition

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

Code	Meaning
0	Analysis complete, quality >= 70%
1	Error (project not found, critical failure)
10	Analysis complete with warnings, or quality 50-69%
11	Analysis complete, quality < 50%

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

Pattern	Purpose
*.sln, *.nxtsln	Solution structure
*.dfbproj	Project metadata, library refs, EAE version
*.fbt	Function blocks (interfaces)
*.adp	Adapters
*.dt	Data types
System.cfg, System.sys	Topology, CAT instances, ISA88 hierarchy
*.opcua.xml	OPC-UA server configuration
*.hcf	Hardware configuration (protocol detection)
*.doc.xml	Documentation (description extraction)
Folders.xml	Code organization
README.md	Project documentation

Integration with Other Skills

Skill	Integration
eae-naming-validator	Quality scoring uses naming patterns
eae-performance-analyzer	Can be run after overview for deep analysis
eae-skill-router	Parent skill for routing

Anti-Patterns

Avoid	Why	Instead
Analyzing without reading	May miss context	Review report sections
Ignoring quality warnings	Technical debt	Address recommendations
Over-exposed OPC-UA	Security risk	Review exposed nodes
Empty ISA88	Missing asset management	Configure hierarchy

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