ChargeLink documentation
========================

ChargeLink is a software-defined EVSE simulator and validation platform built for CCS interoperability, conformance-style execution, evidence capture, and bench-linked hardware validation. This site is structured for both newcomers and advanced lab operators.

.. image:: _static/architecture.svg
   :alt: ChargeLink runtime architecture

What is included in this site
-----------------------------
- Newcomer-friendly explanations of EVCC, EVSE, SECC, EXI, TLS, HIL, MCS, and bench proof.
- Step-by-step installation and first-run guides for Windows 11 PowerShell and Linux operators.
- A full CLI reference for 36 top-level ``chargelink`` command groups plus ``chargelink-monitor``.
- Catalog pages generated from the snapshot: 72 built-in profiles, 8 EVCC profiles, 5 hardware profiles, 20 campaign packages, and 17 named suites.
- An API overview generated from 83 FastAPI route handlers and the websocket event endpoint.

.. note::

   This documentation reflects the provided snapshot. It intentionally documents both the strong current baselines and the current claim boundaries, especially around MCS and commercial-core cleanup.

.. toctree::
   :maxdepth: 2
   :caption: Overview

   overview/what-is-chargelink
   overview/simulator-roles
   overview/standards-and-conformance
   overview/product-status-and-claim-boundaries

.. toctree::
   :maxdepth: 2
   :caption: Getting started

   getting-started/installation
   getting-started/quickstart

.. toctree::
   :maxdepth: 2
   :caption: Guides

   guides/evse-operations
   guides/evcc-operations
   guides/scenarios-campaigns-and-suites
   guides/trace-replay-reporting
   guides/mcs-hil-and-bench
   guides/ui-and-api

.. toctree::
   :maxdepth: 2
   :caption: Reference

   reference/data-and-artifacts
   reference/profile-catalog
   reference/hardware-profiles
   reference/package-and-suite-catalog
   reference/api-reference
   reference/monitor
   reference/cli/index
   reference/glossary