chargelink profile
==================

List, inspect, validate, clone, and derive connection settings from profiles.

Reference syntax
----------------
.. code-block:: text

   usage: chargelink profile [-h] {list,show,validate,clone,connectors} ...

   positional arguments:
     {list,show,validate,clone,connectors}

   options:
     -h, --help            show this help message and exit

Subcommands
-----------
.. list-table::
   :header-rows: 1
   :widths: 25 75

   * - Subcommand
     - Purpose
   * - ``list``
     - List registered profiles.
   * - ``show``
     - Show the resolved content of one profile.
   * - ``validate``
     - Validate a profile file.
   * - ``clone``
     - Clone an existing profile into a new custom profile name.
   * - ``connectors``
     - Compute connector-facing settings such as addresses, ports, and protocol hints.

list
----

List registered profiles.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink profile list [-h] [--runtime-root RUNTIME_ROOT]

   options:
     -h, --help            show this help message and exit
     --runtime-root RUNTIME_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**List the current catalog.**

.. code-block:: bash

   chargelink profile list

**List the same catalog under an explicit runtime root.**

.. code-block:: bash

   chargelink profile list --runtime-root '.tmp/runtime'


show
----

Show the resolved content of one profile.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink profile show [-h] [--runtime-root RUNTIME_ROOT] name

   positional arguments:
     name

   options:
     -h, --help            show this help message and exit
     --runtime-root RUNTIME_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Show the production DC PnC profile.**

.. code-block:: bash

   chargelink profile show 'abb_pnc_realistic'

**Show the realistic AC ISO 15118-20 profile.**

.. code-block:: bash

   chargelink profile show 'abb_iso20_ac_eim_realistic'


validate
--------

Validate a profile file.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink profile validate [-h] file

   positional arguments:
     file

   options:
     -h, --help  show this help message and exit

Production examples
~~~~~~~~~~~~~~~~~~~
**Validate one production input.**

.. code-block:: bash

   chargelink profile validate 'profiles/dc_fast/abb_pnc.yaml'

**Validate a second representative input.**

.. code-block:: bash

   chargelink profile validate 'profiles/ac_wallbox/abb_iso20_ac_eim_realistic.yaml'


clone
-----

Clone an existing profile into a new custom profile name.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink profile clone [-h] [--runtime-root RUNTIME_ROOT]
                                   base_profile name

   positional arguments:
     base_profile
     name

   options:
     -h, --help            show this help message and exit
     --runtime-root RUNTIME_ROOT

Production examples
~~~~~~~~~~~~~~~~~~~
**Clone the DC realistic profile for a customer-specific lab.**

.. code-block:: bash

   chargelink profile clone 'abb_pnc_realistic' 'customer_dc_lab' --runtime-root '.tmp/runtime'

**Clone the AC realistic profile.**

.. code-block:: bash

   chargelink profile clone 'abb_iso20_ac_eim_realistic' 'customer_ac_lab' --runtime-root '.tmp/runtime'


connectors
----------

Compute connector-facing settings such as addresses, ports, and protocol hints.

CLI help
~~~~~~~~
.. code-block:: text

   usage: chargelink profile connectors [-h]
                                        [--protocol {iso15118-2,iso15118-20,mcs,din70121}]
                                        [--tls] [--host HOST]
                                        [--udp-port UDP_PORT]
                                        [--tcp-port TCP_PORT] [--export EXPORT]
                                        [name]

   positional arguments:
     name

   options:
     -h, --help            show this help message and exit
     --protocol {iso15118-2,iso15118-20,mcs,din70121}
     --tls
     --host HOST
     --udp-port UDP_PORT
     --tcp-port TCP_PORT
     --export EXPORT

Production examples
~~~~~~~~~~~~~~~~~~~
**Derive connector settings for an ISO 15118-2 EVSE profile.**

.. code-block:: bash

   chargelink profile connectors 'abb_pnc_realistic' --protocol 'iso15118-2' --tls --host 'fe80::640b:3f3d:c4fe:3d9f%19' --udp-port 15118 --tcp-port 55000 --export 'artifacts/profiles/abb_pnc_realistic_connectors.json'

**Derive connector settings for an ISO 15118-20 AC profile.**

.. code-block:: bash

   chargelink profile connectors 'abb_iso20_ac_eim_realistic' --protocol 'iso15118-20' --tls --host 'fe80::640b:3f3d:c4fe:3d9f%19' --udp-port 15118 --tcp-port 55000 --export 'artifacts/profiles/abb_iso20_ac_eim_realistic_connectors.json'