# tux-evse/iso15118-encoders architecture

> Architecture diagram of the GitHub repository tux-evse/iso15118-encoders, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tux-evse/iso15118-encoders
- Repository: https://github.com/tux-evse/iso15118-encoders

## Overview

This repository is a C library of generated ISO 15118 EXI encoders and decoders, with shared EXI primitives and supporting transport, service-discovery, and signature utilities. A principal use is to represent a protocol message with the generated data types, then encode it to or decode it from an EXI bitstream; the tree and excerpts show codec implementations but not a calling application or a complete transport-to-codec workflow. README documents DIN, ISO 15118-2, and ISO 15118-20 coverage. Several protocol modules are represented at their exact enclosing directory because their implementations were not sampled.

Main entry points: [`src/encoders/iso-20`](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20) (ISO 15118-20 ACDP), [`src/encoders/appHandshake`](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/appHandshake) (App handshake), [`src/encoders/iso-2/iso2_msgDefDatatypes.h`](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/iso-2/iso2_msgDefDatatypes.h) (Message datatypes), [`src/encoders/common/exi_basetypes_decoder.c`](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_basetypes_decoder.c) (Base decoding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_protocol["Protocol codecs"]
  node_handshake["App handshake"]
  node_din["DIN 70121"]
  node_iso2["ISO 15118-2"]
  node_iso20_common["ISO 15118-20 common"]
  node_iso20_acdp["ISO 15118-20 ACDP"]
  node_iso20_ac["ISO 15118-20 AC"]
  node_iso20_dc["ISO 15118-20 DC"]
  node_iso20_wpt["ISO 15118-20 WPT"]
  node_datatypes["Message datatypes"]
end

subgraph group_exi["EXI runtime"]
  node_bitstream["EXI bitstream<br/>[exi_bitstream.c]"]
  node_base_types["EXI base types<br/>[exi_basetypes.c]"]
  node_base_decode["Base decoding"]
  node_base_encode["Base encoding"]
  node_type_decode["EXI type decoding"]
  node_header["EXI header<br/>[exi_header.c]"]
  node_errors["EXI errors<br/>[exi_error_codes.h]"]
end

subgraph group_transport["Transport discovery"]
  node_sdp["V2G service discovery<br/>[sdp-v2g-encoders.c]"]
  node_v2gtp["V2GTP framing<br/>[exi_v2gtp.c]"]
end

subgraph group_security["Signatures"]
  node_sign_iso2["ISO-2 signatures<br/>[iso2_sign.c]"]
  node_sign_iso20["ISO-20 signatures<br/>[iso20_sign.c]"]
  node_sign_common["Signature support<br/>[isox_sign.c]"]
end

node_client(("Calling application"))

node_client -.->|"uses"| node_handshake
node_client -.->|"uses"| node_din
node_client -.->|"uses"| node_iso2
node_client -.->|"uses"| node_iso20_common
node_client -.->|"uses"| node_iso20_acdp
node_client -.->|"uses"| node_iso20_ac
node_client -.->|"uses"| node_iso20_dc
node_client -.->|"uses"| node_iso20_wpt
node_iso20_acdp -->|"decodes with"| node_base_decode
node_iso20_acdp -->|"encodes with"| node_base_encode
node_handshake -->|"decodes with"| node_base_decode
node_iso20_acdp -.->|"uses types"| node_datatypes
node_handshake -.->|"uses types"| node_datatypes

click node_handshake "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/appHandshake"
click node_din "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/din"
click node_iso2 "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-2"
click node_iso20_common "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20"
click node_iso20_acdp "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20"
click node_iso20_ac "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20"
click node_iso20_dc "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20"
click node_iso20_wpt "https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20"
click node_datatypes "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/iso-2/iso2_msgDefDatatypes.h"
click node_bitstream "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_bitstream.c"
click node_base_types "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_basetypes.c"
click node_base_decode "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_basetypes_decoder.c"
click node_base_encode "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_basetypes_encoder.c"
click node_type_decode "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_types_decoder.c"
click node_header "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_header.c"
click node_errors "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_error_codes.h"
click node_sdp "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/sdp-encoders/sdp-v2g-encoders.c"
click node_v2gtp "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/v2gtp/exi_v2gtp.c"
click node_sign_iso2 "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/utils/iso2_sign.c"
click node_sign_iso20 "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/utils/iso20_sign.c"
click node_sign_common "https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/utils/isox_sign.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_handshake,node_din,node_iso2,node_iso20_common,node_iso20_acdp,node_iso20_ac,node_iso20_dc,node_iso20_wpt,node_datatypes toneBlue
class node_bitstream,node_base_types,node_base_decode,node_base_encode,node_type_decode,node_header,node_errors toneAmber
class node_sdp,node_v2gtp toneMint
class node_sign_iso2,node_sign_iso20,node_sign_common toneRose
class node_client toneIndigo
```

## Components

### Protocol codecs

- [App handshake](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/appHandshake): `src/encoders/appHandshake`
- [DIN 70121](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/din): `src/encoders/din`
- [ISO 15118-2](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-2): `src/encoders/iso-2`
- [ISO 15118-20 common](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20): `src/encoders/iso-20`
- [ISO 15118-20 ACDP](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20): `src/encoders/iso-20`
- [ISO 15118-20 AC](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20): `src/encoders/iso-20`
- [ISO 15118-20 DC](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20): `src/encoders/iso-20`
- [ISO 15118-20 WPT](https://github.com/tux-evse/iso15118-encoders/tree/main/src/encoders/iso-20): `src/encoders/iso-20`
- [Message datatypes](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/iso-2/iso2_msgDefDatatypes.h): `src/encoders/iso-2/iso2_msgDefDatatypes.h`

### EXI runtime

- [EXI bitstream](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_bitstream.c): `src/encoders/common/exi_bitstream.c`
- [EXI base types](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_basetypes.c): `src/encoders/common/exi_basetypes.c`
- [Base decoding](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_basetypes_decoder.c): `src/encoders/common/exi_basetypes_decoder.c`
- [Base encoding](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_basetypes_encoder.c): `src/encoders/common/exi_basetypes_encoder.c`
- [EXI type decoding](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_types_decoder.c): `src/encoders/common/exi_types_decoder.c`
- [EXI header](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_header.c): `src/encoders/common/exi_header.c`
- [EXI errors](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/common/exi_error_codes.h): `src/encoders/common/exi_error_codes.h`

### Transport discovery

- [V2G service discovery](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/sdp-encoders/sdp-v2g-encoders.c): `src/encoders/sdp-encoders/sdp-v2g-encoders.c`
- [V2GTP framing](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/v2gtp/exi_v2gtp.c): `src/encoders/v2gtp/exi_v2gtp.c`

### Signatures

- [ISO-2 signatures](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/utils/iso2_sign.c): `src/encoders/utils/iso2_sign.c`
- [ISO-20 signatures](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/utils/iso20_sign.c): `src/encoders/utils/iso20_sign.c`
- [Signature support](https://github.com/tux-evse/iso15118-encoders/blob/main/src/encoders/utils/isox_sign.c): `src/encoders/utils/isox_sign.c`

### Other components

- **Calling application**

## Connections

- Calling application → App handshake: uses
- Calling application → DIN 70121: uses
- Calling application → ISO 15118-2: uses
- Calling application → ISO 15118-20 common: uses
- Calling application → ISO 15118-20 ACDP: uses
- Calling application → ISO 15118-20 AC: uses
- Calling application → ISO 15118-20 DC: uses
- Calling application → ISO 15118-20 WPT: uses
- ISO 15118-20 ACDP → Base decoding: decodes with (evidence: `src/encoders/iso-20/iso20_ACDP_Decoder.c`)
- ISO 15118-20 ACDP → Base encoding: encodes with (evidence: `src/encoders/iso-20/iso20_ACDP_Encoder.c`)
- App handshake → Base decoding: decodes with (evidence: `src/encoders/appHandshake/appHand_Decoder.c`)
- ISO 15118-20 ACDP → Message datatypes: uses types
- App handshake → Message datatypes: uses types
