EAGLE Exporter Mapping Guide
Informative guidance for mapping EAGLE source data into CGES payloads.
Status
| Guide Type | Informative (non-normative) |
| Primary Contract | CGES-CORE-1.0 + CGES-JSON-1.0 |
| Last Updated | 2026-03-13 |
Normative requirements are defined in /standard/index.html. This guide cannot override profile MUST statements.
Recommended exporter workflow is summarized in docs/implementer-workflow.html.
Human-readable EPSA transport semantics and canonical JSON field names are summarized in docs/reference/epsa-extension.html.
Recommended Source Mapping
| CGES Field | Recommended EAGLE Source | Notes |
|---|---|---|
identity.board_pn | PCB1.PART_NUMBER | Default to UNKNOWN per standard if missing. |
identity.board_rev | PCB1.REVISION | Default to - per standard if missing. |
metadata.schematic_revision | DWG1.REVISION or project-defined schematic/document revision attribute (fallback: PCB1.REVISION) | May equal identity.board_rev when no separate schematic revision exists. |
metadata.revision | Deprecated legacy alias for metadata.schematic_revision | Do not emit in new CGES-CORE-1.0 payloads unless backward compatibility requires it. If emitted, it must equal metadata.schematic_revision. |
metadata.project_name | PCB1.TITLE | May be empty. |
metadata.analysis_context.epsa_board | PCB1.EPSA_* board attributes | Use when claiming CGES-EPSA-BOARD-0.1. |
components[].refdes | Part name / reference designator | Must be non-empty and unique in scope. |
components[].value | VALUE attribute | May be empty. |
components[].footprint | PACKAGE / package variant | May be empty. |
components[].role | role attribute (fallback: EPSA_ROLE) | Emit unspecified when unresolved. |
components[].function | function attribute (fallback: EPSA_FUNCTION) | Emit unspecified when unresolved. |
components[].analysis_modules.epsa | tolerance, v_rating, i_rating, p_rating, and EPSA_* aliases | Normalize into canonical keys such as tolerance, voltage_rating, current_rating, and power_rating. Use when claiming CGES-EPSA-COMPONENT-0.1. |
nets[].name | Signal/net name | Use empty string only when unnamed. |
nets[].connections[].pin | Resolved gate/pin reference | Follow longest-available deterministic pin resolution. |
test_integration.test_points | Parts with TP* designator | Case-insensitive prefix match. |
PCB1 is an EAGLE-oriented source-side convention, not a required source object name in the core CGES contract.
Determinism Checklist
- Sort emitted component arrays by sheet index, then reference designator.
- Sort nets by normalized net name; keep stable ordering for unnamed nets.
- Emit warnings for identity conflicts and duplicate candidate markers.
- Preserve unknown
EPSA_keys when converting toanalysis_modules.epsa. - Do not declare board-level or component-level EPSA extension tokens unless the matching normalized payload is emitted.