chargelink campaign

Run packaged interoperability and conformance campaigns and inspect their outputs.

Reference syntax

usage: chargelink campaign [-h]
                           {run,report,export,packages,matrix,coverage,workstreams,verify} ...

positional arguments:
  {run,report,export,packages,matrix,coverage,workstreams,verify}

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

Subcommands

Subcommand	Purpose
`run`	Execute an interoperability or conformance campaign JSON document.
`report`	Render a report from an existing campaign output directory.
`export`	Export a campaign result as an archive or customer-facing bundle.
`packages`	List the licensed or licensable package catalog exposed by the snapshot.
`matrix`	Show the standards matrix for one package ID.
`coverage`	Show catalog or per-package coverage state.
`workstreams`	List package workstreams such as ISO 15118-2, DIN, ISO 15118-20, and MCS.
`verify`	Verify that a completed campaign contains the expected packages, codes, verdicts, and artifacts.

run

Execute an interoperability or conformance campaign JSON document.

CLI help

usage: chargelink campaign run [-h] [--artifact-root ARTIFACT_ROOT] campaign

positional arguments:
  campaign

options:
  -h, --help            show this help message and exit
  --artifact-root ARTIFACT_ROOT

Production examples

Run the ISO 15118-20 AC realistic negative campaign.

chargelink campaign run 'campaigns/interoperability/iso15118_20/ac/cl_int_iso20_ac_negative_realistic.json' --artifact-root 'artifacts/evcc_campaign_runs'

Run the ISO 15118-2 DC PnC conformance seed campaign.

chargelink campaign run 'campaigns/conformance/iso15118_2/dc_pnc/cl_conf_iso2_dc_pnc_seed.json' --artifact-root 'artifacts/evcc_campaign_runs'

report

Render a report from an existing campaign output directory.

CLI help

usage: chargelink campaign report [-h] [--artifact-root ARTIFACT_ROOT]
                                  [--output OUTPUT]
                                  path

positional arguments:
  path

options:
  -h, --help            show this help message and exit
  --artifact-root ARTIFACT_ROOT
  --output OUTPUT

Production examples

Render a report for an interoperability campaign.

chargelink campaign report 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic' --output 'artifacts/reports/iso20_ac_negative_report.json'

Render a report for a conformance campaign.

chargelink campaign report 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed' --output 'artifacts/reports/iso2_dc_pnc_report.json'

export

Export a campaign result as an archive or customer-facing bundle.

CLI help

usage: chargelink campaign export [-h] [--artifact-root ARTIFACT_ROOT]
                                  [--format FORMAT] [--output OUTPUT]
                                  path

positional arguments:
  path

options:
  -h, --help            show this help message and exit
  --artifact-root ARTIFACT_ROOT
  --format FORMAT
  --output OUTPUT

Production examples

Export a campaign as a customer-facing ZIP.

chargelink campaign export 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic' --format 'zip' --output 'artifacts/exports/iso20_ac_negative.zip'

Export a campaign to HTML for review.

chargelink campaign export 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed' --format 'html' --output 'artifacts/exports/iso2_dc_pnc.html'

packages

List the licensed or licensable package catalog exposed by the snapshot.

CLI help

usage: chargelink campaign packages [-h] [--output OUTPUT]

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

Production examples

List the package catalog.

chargelink campaign packages

Write the package catalog to JSON.

chargelink campaign packages --output 'artifacts/package_catalog.json'

matrix

Show the standards matrix for one package ID.

CLI help

usage: chargelink campaign matrix [-h] [--output OUTPUT] package_id

positional arguments:
  package_id

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

Production examples

View the standards matrix for the ISO 15118-20 DC conformance package.

chargelink campaign matrix 'CL-CONF-ISO20-DC' --output 'artifacts/package_matrices/iso20_dc_matrix.json'

View the matrix for the MCS EVCC differential package.

chargelink campaign matrix 'CL-INT-MCS-EVCC-DIFF' --output 'artifacts/package_matrices/mcs_evcc_diff_matrix.json'

coverage

Show catalog or per-package coverage state.

CLI help

usage: chargelink campaign coverage [-h] [--output OUTPUT] [package_id]

positional arguments:
  package_id

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

Production examples

Show full catalog coverage.

chargelink campaign coverage --output 'artifacts/coverage/catalog_coverage.json'

Show coverage for one package.

chargelink campaign coverage 'CL-CONF-ISO2-DC-PNC' --output 'artifacts/coverage/iso2_dc_pnc_coverage.json'

workstreams

List package workstreams such as ISO 15118-2, DIN, ISO 15118-20, and MCS.

CLI help

usage: chargelink campaign workstreams [-h] [--output OUTPUT]

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

Production examples

List the protocol workstreams.

chargelink campaign workstreams

Write the workstream catalog to JSON.

chargelink campaign workstreams --output 'artifacts/workstreams.json'

verify

Verify that a completed campaign contains the expected packages, codes, verdicts, and artifacts.

CLI help

usage: chargelink campaign verify [-h] [--artifact-root ARTIFACT_ROOT]
                                  [--expect-package EXPECT_PACKAGE]
                                  [--expect-code EXPECT_CODE]
                                  [--expect-case EXPECT_CASE]
                                  [--expect-verdict EXPECT_VERDICT]
                                  [--expect-case-count EXPECT_CASE_COUNT]
                                  [--expect-package-gate EXPECT_PACKAGE_GATE]
                                  [--expect-license-feature EXPECT_LICENSE_FEATURE]
                                  [--expect-signature-status EXPECT_SIGNATURE_STATUS]
                                  [--expect-release-status EXPECT_RELEASE_STATUS]
                                  [--require-artifact REQUIRE_ARTIFACT]
                                  [--strict] [--output OUTPUT]
                                  path

positional arguments:
  path

options:
  -h, --help            show this help message and exit
  --artifact-root ARTIFACT_ROOT
  --expect-package EXPECT_PACKAGE
  --expect-code EXPECT_CODE
  --expect-case EXPECT_CASE
  --expect-verdict EXPECT_VERDICT
  --expect-case-count EXPECT_CASE_COUNT
  --expect-package-gate EXPECT_PACKAGE_GATE
  --expect-license-feature EXPECT_LICENSE_FEATURE
  --expect-signature-status EXPECT_SIGNATURE_STATUS
  --expect-release-status EXPECT_RELEASE_STATUS
  --require-artifact REQUIRE_ARTIFACT
  --strict
  --output OUTPUT

Production examples

Verify an interoperability campaign root with strict artifact expectations.

chargelink campaign verify 'artifacts/evcc_campaign_runs/cl_int_iso20_ac_negative_realistic' --expect-package 'CL-INT-ISO20-AC' --expect-verdict 'passed' --require-artifact 'protocol_report.json' --strict --output 'artifacts/verification/iso20_ac_verify.json'

Verify a conformance campaign root.

chargelink campaign verify 'artifacts/evcc_campaign_runs/cl_conf_iso2_dc_pnc_seed' --expect-package 'CL-CONF-ISO2-DC-PNC' --expect-case-count 1 --require-artifact 'conformance_traceability.json' --strict --output 'artifacts/verification/iso2_dc_pnc_verify.json'