Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
8d02f9d
Initial reworking of the communicaiton layer spec
wilcowijbrandi Nov 18, 2025
4712716
Improved communication layer specification, still wip
wilcowijbrandi Nov 20, 2025
e22a40c
Expanded architecture section
wilcowijbrandi Nov 24, 2025
158730e
Expandend informative and normative sections
wilcowijbrandi Nov 25, 2025
4c49365
Further expanded the specification
wilcowijbrandi Nov 27, 2025
bd8da58
Minor improvements to the spec
wilcowijbrandi Dec 1, 2025
b4591d6
Further expandend the specification
wilcowijbrandi Dec 2, 2025
b63931f
Made some changes to the specification
wilcowijbrandi Dec 4, 2025
e1d7f7d
added security requirements
GerbenBroenink Dec 8, 2025
6cd533e
changed pairing token lenght requirements
GerbenBroenink Dec 11, 2025
4b32d5d
added security checks to all communication
GerbenBroenink Dec 11, 2025
88fca33
fixed layout error
GerbenBroenink Dec 11, 2025
7bde26e
removed wrong check in checklist
GerbenBroenink Dec 11, 2025
246cfb4
added explicit cybersecurity check in communication description
GerbenBroenink Dec 16, 2025
0b042a9
Expanded S2 connection initiation section
wilcowijbrandi Jan 6, 2026
b62ddc3
Further expanded pairing documentation
wilcowijbrandi Jan 9, 2026
48660fe
Made TODO's a bit nicer, so the document is ready for a first review
wilcowijbrandi Jan 12, 2026
f20331b
Update URI references to URL in documentation
jorritn Jan 13, 2026
a156187
Use TLS more often to indicate more explicitly the certificate use + …
jorritn Jan 13, 2026
97346d5
Correct definitions and typos in discovery pairing doc (#55)
jorritn Jan 14, 2026
9ed05b3
Merge branch 'pairing-update' into pairing-update-URL-instead-of-URI
jorritn Jan 20, 2026
a8391ce
Fix image paths in discovery-pairing-authentication.md
MauriceHendrix Jan 26, 2026
e90443a
also adjusted links for resu of docs
MauriceHendrix Jan 26, 2026
4514a25
Merge pull request #57 from flexiblepower/fix_images_docs
MauriceHendrix Jan 26, 2026
13b1cb4
Merge pull request #54 from flexiblepower/pairing-update-URL-instead-…
wilcowijbrandi Jan 30, 2026
84dfb42
Added specification for DNS-SD
wilcowijbrandi Feb 2, 2026
644b0b4
Merge pull request #56 from flexiblepower/pairing-update-refer-to-TLS…
wilcowijbrandi Feb 3, 2026
30f9c5f
Merge pull request #59 from flexiblepower/pairing-update-dnssd
wcoenraads Feb 19, 2026
8e7904b
Added regex patterns for pairing token and code
wilcowijbrandi Feb 27, 2026
9d1dd56
Merge branch 'pairing-update' into pairing-update-regex
wilcowijbrandi Feb 27, 2026
2cded42
Wrote the section on long-polling
wilcowijbrandi Feb 27, 2026
731a5ea
Improved long-polling description based on review
wilcowijbrandi Mar 6, 2026
3ad633f
Merge pull request #60 from flexiblepower/pairing-update-regex
wcoenraads Mar 10, 2026
7842aad
Merge branch 'pairing-update' into pairing-update-longpolling
wcoenraads Mar 10, 2026
169ae9b
Merge pull request #61 from flexiblepower/pairing-update-longpolling
wcoenraads Mar 10, 2026
047f385
Merge branch 'main' into pairing-update
wcoenraads Mar 10, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1,120 changes: 964 additions & 156 deletions website/docs/communication-layer/discovery-pairing-authentication.md

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions website/docs/communication-layer/security-considerations.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ In the image below, the relevant security communication is visualized. Note that

The following sequence diagram focuses on validation of certificates and tokens. Please refer to the other sequence diagrams that contain more details about the pairing and connection initiation.

![image](/img/communication-layer/pairing-security.png)
![image](../../static/img/communication-layer/pairing-security.png)

<details>
<summary>Image generated using the following PlantUML code:</summary>
Expand Down Expand Up @@ -135,7 +135,7 @@ There are two possible types of certificates. The first option is a public serve

In the following image, the difference is shown. On the left a public root CA that's publicly known and trusted, on the right, a self signed root certificate, that's unknown and it's trustworthiness has to be achieved in another way.

![image.png](/img/communication-layer/certificate-chains.png)
(../../static/imgge.png](/img/communication-layer/certificate-chains.png)

<details>
<summary>Image generated using the following PlantUML code:</summary>
Expand Down
2 changes: 1 addition & 1 deletion website/docs/communication-layer/why-not-oauth.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Given our requirements on the pairing and authentication process, the following

The pairing and authentication process based on OAuth 2.0 would be specified as follows:

![image](/img/communication-layer/oauth2-s2.png)
![image](../../static/img/communication-layer/oauth2-s2.png)
<details>
<summary>Image generated using the following PlantUML code:</summary>

Expand Down
2 changes: 1 addition & 1 deletion website/docs/examples/ev.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "Example: Electric Vehicle"
hide_title: true
---

![image not found](/img/example-ev-header.png)
![image not found](../../static/img/example-ev-header.png)

This page serves as a guide for implementing a S2 RM for an electric vehicle (charge point), or to give a CEM developer a better understanding of what to expect when controlling the energy flexibility of electric vehicles. It provides some example S2 messages for a (fictional) EV as well.

Expand Down
2 changes: 1 addition & 1 deletion website/docs/examples/heat-pump.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "Example: Heat Pump"
hide_title: true
---

![image not found](/img/example-heat-pumps-header.png)
![image not found](../../static/img/example-heat-pumps-header.png)

This page serves as a guide for implementing an S2 RM for a heat pump, or to give a CEM developer a better understanding of what to expect when controlling the energy flexibility of a heat pump. It provides some example S2 messages for same (fictional) heat pumps.

Expand Down
2 changes: 1 addition & 1 deletion website/docs/examples/pv.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: "Example: PV Installation"
hide_title: true
---

![image not found](/img/example-pv-header.png)
![image not found](../../static/img/example-pv-header.png)

This page serves as a guide for implementing an S2 RM for a PV installation. It provides example S2 messages that help developers to understand how to interact with PV installations and what kind of flexibility they can offer.

Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

Large diffs are not rendered by default.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.