From 9b159aa6cddb8069b8179ea3f265cec59c091bab Mon Sep 17 00:00:00 2001 From: Daniel Bechter Date: Wed, 21 Jan 2026 16:55:02 +0100 Subject: [PATCH 1/4] Update README with instructions --- README.md | 105 +++++++++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 100 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 8c144d6..4300fe4 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,105 @@ -## ControlBox +# ControlBox ControlBox is a sample EEBUS GridGuard implementation that implements these EEBUS use cases: - EnergyGuard Limitation of Power Consumption (LPC) -- EneryGuard Limitation of Power Production (LPP) -- MonitoringApplicance Monitoring of Power Consumption (MPC) -- MonitoringApplicance Monitoring of Grid Connection Point (MGCP) +- EnergyGuard Limitation of Power Production (LPP) +- MonitoringAppliance Monitoring of Power Consumption (MPC) +- MonitoringAppliance Monitoring of Grid Connection Point (MGCP) -Forked from https://github.com/vollautomat/eebus-go, based on https://github.com/enbility/eebus-go. +Forked from [vollautomat's eebus-go](https://github.com/vollautomat/eebus-go), based on [enbility's eebus-go](https://github.com/enbility/eebus-go). + +### Installation & Execution + +#### ControlBox + +Generate EEBUS certificate, key and SKI: +``` +cd /path/to/controlbox +go run . 4712 + +-----BEGIN CERTIFICATE----- +MIIB4DCCAYagAwIBAgIUNZ5cJ2xKkKz3N7r0K9vK2A5x5EkwCgYIKoZIzj0EAwIw +STELMAkGA1UEBhMCREUxEzARBgNVBAoMCkVFQlVTIERFTU8xJTAjBgNVBAMMHEVF +QlVTIERldmljZSBDZXJ0ICMwMjAeFw0yNjAxMjAwMDAwMDBaFw0zNjAxMjAwMDAw +MDBaMEkxCzAJBgNVBAYTAkRFMRMwEQYDVQQKDApFRUJVUyBERU1PMRkwFwYDVQQD +DBBFRUJVUyBEZXZpY2UgMjBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABKqkH+5T +uZyPzVYzY5n1L8Qz6ZcQZbQ+0z0J9n5W2XvX8Kz3C3XWkFJ9B1k9g7y8wE3D8N6M +z3W8AqejUzBRMB0GA1UdDgQWBBQmC8kY8X1d6T2Jq1p4k8Yt9Jq3ETAfBgNVHSME +GDAWgBQmC8kY8X1d6T2Jq1p4k8Yt9Jq3ETAPBgNVHRMBAf8EBTADAQH/MAoGCCqG +SM49BAMCA0cAMEQCIGc5N6F6cF8mZQ3KkXyX9Z3kY1z4kMZx8Y1XKp7pAiA6c2VQ +nYF9s6XK2E5p3Yy2F1J6kKp8F7F5HcN4w== +-----END CERTIFICATE----- + +-----BEGIN EC PRIVATE KEY----- +MHcCAQEEIO3ZkY4pWZ7k4cZP0Kp0Z4QvV7yZ0pJ7nY2kN2Vf9FQBoAoGCCqGSM49 +AwEHoUQDQgAEKqkH+5TuZyPzVYzY5n1L8Qz6ZcQZbQ+0z0J9n5W2XvX8Kz3C3XW +kFJ9B1k9g7y8wE3D8N6Mz3W8AqejUw== +-----END EC PRIVATE KEY----- + +Local SKI: A46D9C217B8F335E921C4FAA087E615C9D2A73F0 +``` + +Note the local SKI and save certificate and key to respective files (e.g. `cb.crt` and `cb.key`) and run the ControlBox: +``` +go run . 4712 cb.crt cb.key +``` + +#### evcc + +Generate EEBUS certificate and key for evcc via evcc CLI… +``` +evcc eebus-cert +``` + +and add them to the `evcc.yaml` config file: +``` +eebus: + certificate: + public: | + -----BEGIN CERTIFICATE----- + MIIB3TCCAYOgAwIBAgIUWZp7lZ9JcM8xE5cQ6+4JkF0yZVswCgYIKoZIzj0EAwIw + RDELMAkGA1UEBhMCREUxEjAQBgNVBAoMCUVFQlVTIFRFU1QxHTAbBgNVBAMMFEVF + QlVTIERldmljZSBDZXJ0MB4XDTI2MDEyMDAwMDAwMFoXDTM2MDEyMDAwMDAwMFow + RDELMAkGA1UEBhMCREUxEjAQBgNVBAoMCUVFQlVTIFRFU1QxHTAbBgNVBAMMFEVF + QlVTIERldmljZSBDZXJ0MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE9G5xQK+S + M6a9uY+qF8bB9n3GJ3Xh7V1Z5zM2Y3m1K1j9m1W5l0yBzYVZbF3gY7Cw7b7F1P0E + Yt7D6kUq8aNTMFEwHQYDVR0OBBYEFN5C8sKx8c7K8Zx9+5J7n8Z2cJ5LMB8GA1Ud + IwQYMBaAFN5C8sKx8c7K8Zx9+5J7n8Z2cJ5LMA8GA1UdEwEB/wQFMAMBAf8wCgYI + KoZIzj0EAwIDSAAwRQIhAKF4Ewz5kD3qgC9Z7U8xZ5M1X8J6cJ3FZp6n3mMRAiB + 4YF8uQ5pJwYVZJ4n9GZPZJmM9H4k7Z0n9F5YVQ== + -----END CERTIFICATE----- + private: | + -----BEGIN EC PRIVATE KEY----- + MHcCAQEEIDP6JmP0kK6J7QFZ6NnZ4qFZQ1T+9n9C5k9Z8FZqz0ZBoAoGCCqGSM49 + AwEHoUQDQgAE9G5xQK+SM6a9uY+qF8bB9n3GJ3Xh7V1Z5zM2Y3m1K1j9m1W5l0yB + zYVZbF3gY7Cw7b7F1P0EYt7D6kUq8Q== + -----END EC PRIVATE KEY----- +``` + +Add ControlBox to the `evcc.yaml`: +``` +hems: + type: eebus + ski: A46D9C217B8F335E921C4FAA087E615C9D2A73F0 # local SKI of the ControlBox +``` + +Restarting evcc will automatically connect evcc to the ControlBox. + +#### ControlBox Frontend + +Install dependencies: +``` +cd /path/to/controlbox/frontend +npm install +``` + +Run web server: +``` +npm run dev +``` + +Open ControlBox UI via web browser URI: +``` +http://localhost:7081/ +``` From 54e65a757634997c1549dc804dd0a210a5fc300f Mon Sep 17 00:00:00 2001 From: CiNcH83 Date: Tue, 27 Jan 2026 09:25:35 +0100 Subject: [PATCH 2/4] simplified README.md based on PR #2 --- README.md | 35 ++++++----------------------------- 1 file changed, 6 insertions(+), 29 deletions(-) diff --git a/README.md b/README.md index 4300fe4..75731ac 100644 --- a/README.md +++ b/README.md @@ -7,52 +7,29 @@ ControlBox is a sample EEBUS GridGuard implementation that implements these EEBU - MonitoringAppliance Monitoring of Power Consumption (MPC) - MonitoringAppliance Monitoring of Grid Connection Point (MGCP) -Forked from [vollautomat's eebus-go](https://github.com/vollautomat/eebus-go), based on [enbility's eebus-go](https://github.com/enbility/eebus-go). +Forked from [vollautomat's eebus-go repository](https://github.com/vollautomat/eebus-go), based on [enbility's eebus-go implementation](https://github.com/enbility/eebus-go). ### Installation & Execution #### ControlBox -Generate EEBUS certificate, key and SKI: +Run ControlBox: ``` cd /path/to/controlbox go run . 4712 - ------BEGIN CERTIFICATE----- -MIIB4DCCAYagAwIBAgIUNZ5cJ2xKkKz3N7r0K9vK2A5x5EkwCgYIKoZIzj0EAwIw -STELMAkGA1UEBhMCREUxEzARBgNVBAoMCkVFQlVTIERFTU8xJTAjBgNVBAMMHEVF -QlVTIERldmljZSBDZXJ0ICMwMjAeFw0yNjAxMjAwMDAwMDBaFw0zNjAxMjAwMDAw -MDBaMEkxCzAJBgNVBAYTAkRFMRMwEQYDVQQKDApFRUJVUyBERU1PMRkwFwYDVQQD -DBBFRUJVUyBEZXZpY2UgMjBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABKqkH+5T -uZyPzVYzY5n1L8Qz6ZcQZbQ+0z0J9n5W2XvX8Kz3C3XWkFJ9B1k9g7y8wE3D8N6M -z3W8AqejUzBRMB0GA1UdDgQWBBQmC8kY8X1d6T2Jq1p4k8Yt9Jq3ETAfBgNVHSME -GDAWgBQmC8kY8X1d6T2Jq1p4k8Yt9Jq3ETAPBgNVHRMBAf8EBTADAQH/MAoGCCqG -SM49BAMCA0cAMEQCIGc5N6F6cF8mZQ3KkXyX9Z3kY1z4kMZx8Y1XKp7pAiA6c2VQ -nYF9s6XK2E5p3Yy2F1J6kKp8F7F5HcN4w== ------END CERTIFICATE----- - ------BEGIN EC PRIVATE KEY----- -MHcCAQEEIO3ZkY4pWZ7k4cZP0Kp0Z4QvV7yZ0pJ7nY2kN2Vf9FQBoAoGCCqGSM49 -AwEHoUQDQgAEKqkH+5TuZyPzVYzY5n1L8Qz6ZcQZbQ+0z0J9n5W2XvX8Kz3C3XW -kFJ9B1k9g7y8wE3D8N6Mz3W8AqejUw== ------END EC PRIVATE KEY----- - -Local SKI: A46D9C217B8F335E921C4FAA087E615C9D2A73F0 +2025-04-10 16:39:14 INFO Local SKI: A46D9C217B8F335E921C4FAA087E615C9D2A73F0 ``` -Note the local SKI and save certificate and key to respective files (e.g. `cb.crt` and `cb.key`) and run the ControlBox: -``` -go run . 4712 cb.crt cb.key -``` +Note the local SKI which is logged on ControlBox startup. Certificate and key are automatically created and saved to respective files. -#### evcc +#### Connect evcc Generate EEBUS certificate and key for evcc via evcc CLI… ``` evcc eebus-cert ``` -and add them to the `evcc.yaml` config file: +... and add them to the `evcc.yaml` config file: ``` eebus: certificate: From 1fe69de345fef860bf7f83761f5114b0bc1e9519 Mon Sep 17 00:00:00 2001 From: CiNcH83 Date: Thu, 26 Mar 2026 08:16:42 +0100 Subject: [PATCH 3/4] simplified evcc configuration --- README.md | 34 ++++------------------------------ 1 file changed, 4 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index 75731ac..e4f83a7 100644 --- a/README.md +++ b/README.md @@ -22,37 +22,9 @@ go run . 4712 Note the local SKI which is logged on ControlBox startup. Certificate and key are automatically created and saved to respective files. -#### Connect evcc +#### evcc -Generate EEBUS certificate and key for evcc via evcc CLI… -``` -evcc eebus-cert -``` - -... and add them to the `evcc.yaml` config file: -``` -eebus: - certificate: - public: | - -----BEGIN CERTIFICATE----- - MIIB3TCCAYOgAwIBAgIUWZp7lZ9JcM8xE5cQ6+4JkF0yZVswCgYIKoZIzj0EAwIw - RDELMAkGA1UEBhMCREUxEjAQBgNVBAoMCUVFQlVTIFRFU1QxHTAbBgNVBAMMFEVF - QlVTIERldmljZSBDZXJ0MB4XDTI2MDEyMDAwMDAwMFoXDTM2MDEyMDAwMDAwMFow - RDELMAkGA1UEBhMCREUxEjAQBgNVBAoMCUVFQlVTIFRFU1QxHTAbBgNVBAMMFEVF - QlVTIERldmljZSBDZXJ0MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE9G5xQK+S - M6a9uY+qF8bB9n3GJ3Xh7V1Z5zM2Y3m1K1j9m1W5l0yBzYVZbF3gY7Cw7b7F1P0E - Yt7D6kUq8aNTMFEwHQYDVR0OBBYEFN5C8sKx8c7K8Zx9+5J7n8Z2cJ5LMB8GA1Ud - IwQYMBaAFN5C8sKx8c7K8Zx9+5J7n8Z2cJ5LMA8GA1UdEwEB/wQFMAMBAf8wCgYI - KoZIzj0EAwIDSAAwRQIhAKF4Ewz5kD3qgC9Z7U8xZ5M1X8J6cJ3FZp6n3mMRAiB - 4YF8uQ5pJwYVZJ4n9GZPZJmM9H4k7Z0n9F5YVQ== - -----END CERTIFICATE----- - private: | - -----BEGIN EC PRIVATE KEY----- - MHcCAQEEIDP6JmP0kK6J7QFZ6NnZ4qFZQ1T+9n9C5k9Z8FZqz0ZBoAoGCCqGSM49 - AwEHoUQDQgAE9G5xQK+SM6a9uY+qF8bB9n3GJ3Xh7V1Z5zM2Y3m1K1j9m1W5l0yB - zYVZbF3gY7Cw7b7F1P0EYt7D6kUq8Q== - -----END EC PRIVATE KEY----- -``` +As of evcc 0.301.0, EEBUS is enabled by default with certifacte/key being automatically created, dramatically simplifying setup. Add ControlBox to the `evcc.yaml`: ``` @@ -80,3 +52,5 @@ Open ControlBox UI via web browser URI: ``` http://localhost:7081/ ``` + + From cd01d942c5329aed4d930f7a83d4b77c12661a49 Mon Sep 17 00:00:00 2001 From: CiNcH83 Date: Thu, 26 Mar 2026 08:49:37 +0100 Subject: [PATCH 4/4] screenshot added --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index e4f83a7..84f24dc 100644 --- a/README.md +++ b/README.md @@ -53,4 +53,6 @@ Open ControlBox UI via web browser URI: http://localhost:7081/ ``` +

image

+