chargelink hil
==============

Run the HIL adapter layer for bench-oriented MCS and hardware-backed execution paths.

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

   usage: chargelink hil [-h] {start,status,stop} ...

   positional arguments:
     {start,status,stop}

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

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

   * - Subcommand
     - Purpose
   * - ``start``
     - Start the HIL adapter service for MCS or hardware-backed flows.
   * - ``status``
     - Inspect the status of a running HIL service.
   * - ``stop``
     - Stop a HIL service.

start
-----

Start the HIL adapter service for MCS or hardware-backed flows.

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

   usage: chargelink hil start [-h] [--runtime-root RUNTIME_ROOT]
                               [--run-id RUN_ID] [--profile-id PROFILE_ID]
                               [--hardware-profile HARDWARE_PROFILE]
                               [--driver {mock,ni_daqmx,veristand}]
                               [--veristand-endpoint VERISTAND_ENDPOINT]
                               [--bind-host BIND_HOST] [--bind-port BIND_PORT]
                               [--artifact-root ARTIFACT_ROOT]
                               [--mcs-plca-role {coordinator,follower}]
                               [--mcs-plca-node-id MCS_PLCA_NODE_ID]
                               [--mcs-plca-node-count MCS_PLCA_NODE_COUNT]
                               [--max-runtime-s MAX_RUNTIME_S] [--foreground]
                               [--dry-run]

   options:
     -h, --help            show this help message and exit
     --runtime-root RUNTIME_ROOT
     --run-id RUN_ID
     --profile-id PROFILE_ID
     --hardware-profile HARDWARE_PROFILE
     --driver {mock,ni_daqmx,veristand}
     --veristand-endpoint VERISTAND_ENDPOINT
     --bind-host BIND_HOST
     --bind-port BIND_PORT
     --artifact-root ARTIFACT_ROOT
     --mcs-plca-role {coordinator,follower}
     --mcs-plca-node-id MCS_PLCA_NODE_ID
     --mcs-plca-node-count MCS_PLCA_NODE_COUNT
     --max-runtime-s MAX_RUNTIME_S
     --foreground
     --dry-run

Production examples
~~~~~~~~~~~~~~~~~~~
**Start a dry-run MCS HIL service with the direct NI profile.**

.. code-block:: bash

   chargelink hil start --run-id 'hil-mcs-direct' --profile-id 'mcs_reference_bench' --hardware-profile 'ni_mcs_direct_ivn8563' --driver 'mock' --artifact-root 'artifacts/hil_runtime' --foreground --dry-run

**Start a VeriStand-backed HIL service for the PXI bench profile.**

.. code-block:: bash

   chargelink hil start --run-id 'hil-mcs-veristand' --profile-id 'mcs_reference_bench' --hardware-profile 'ni_mcs_pxi_ivn8563_pxie8623' --driver 'veristand' --veristand-endpoint 'http://127.0.0.1:8081' --artifact-root 'artifacts/hil_runtime' --foreground


status
------

Inspect the status of a running HIL service.

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

   usage: chargelink hil status [-h] [--runtime-root RUNTIME_ROOT] run_id

   positional arguments:
     run_id

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Check a named runtime run.**

.. code-block:: bash

   chargelink hil status 'demo-run' --runtime-root '.tmp/runtime'

**Check a second run in the same runtime root.**

.. code-block:: bash

   chargelink hil status 'release-smoke' --runtime-root '.tmp/runtime'


stop
----

Stop a HIL service.

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

   usage: chargelink hil stop [-h] [--runtime-root RUNTIME_ROOT] run_id

   positional arguments:
     run_id

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

Production examples
~~~~~~~~~~~~~~~~~~~
**Stop a named run.**

.. code-block:: bash

   chargelink hil stop 'demo-run' --runtime-root '.tmp/runtime'

**Stop a second named run.**

.. code-block:: bash

   chargelink hil stop 'release-smoke' --runtime-root '.tmp/runtime'