{"id":43894245,"url":"https://github.com/spali/go-rscp","last_synced_at":"2026-02-06T17:14:14.302Z","repository":{"id":38844198,"uuid":"313545000","full_name":"spali/go-rscp","owner":"spali","description":"Go library to communicate with a E3DC system implementing the RSCP (Remote Storage Control Protocol) ","archived":false,"fork":false,"pushed_at":"2026-02-02T19:26:25.000Z","size":407,"stargazers_count":29,"open_issues_count":6,"forks_count":10,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-02-03T09:47:07.668Z","etag":null,"topics":["battery","binary","client","command-line","commandline","e3-dc","e3dc","go","go-e3dc","go-rscp","golang","hauskraftwerk","json","quattroporte","rscp","s10","smart","smarthome","solar","speicher"],"latest_commit_sha":null,"homepage":"https://github.com/spali/go-rscp","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spali.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["spali"],"custom":["paypal.me/paySpali"]}},"created_at":"2020-11-17T07:49:02.000Z","updated_at":"2026-01-03T23:00:56.000Z","dependencies_parsed_at":"2023-12-06T20:44:05.599Z","dependency_job_id":"63d83559-b5cf-4760-a20c-cc54c03a5045","html_url":"https://github.com/spali/go-rscp","commit_stats":{"total_commits":128,"total_committers":4,"mean_commits":32.0,"dds":0.2265625,"last_synced_commit":"5494bd851a80af016586af9cb64a7356d0af830c"},"previous_names":["spali/go-e3dc"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/spali/go-rscp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spali%2Fgo-rscp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spali%2Fgo-rscp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spali%2Fgo-rscp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spali%2Fgo-rscp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spali","download_url":"https://codeload.github.com/spali/go-rscp/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spali%2Fgo-rscp/sbom","scorecard":{"id":330043,"data":{"date":"2025-08-11","repo":{"name":"github.com/spali/go-rscp","commit":"49bc9c95c291200d18eb223e5b8c16c40474c055"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4,"checks":[{"name":"Maintained","score":0,"reason":"1 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":1,"reason":"Found 3/24 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/codeql.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/build.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/build.yml:55: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/codeql.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/codeql.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/codeql.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/codeql.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/codeql.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/codeql.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:15: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/release.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/release.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/spali/go-rscp/release.yml/master?enable=pin","Info:   0 out of  11 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   3 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/release.yml:10"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.2.1 not signed: https://api.github.com/repos/spali/go-rscp/releases/188365377","Warn: release artifact v0.2.0 not signed: https://api.github.com/repos/spali/go-rscp/releases/153828498","Warn: release artifact v0.2.0-beta5 not signed: https://api.github.com/repos/spali/go-rscp/releases/152833355","Warn: release artifact v0.2.0-beta4 not signed: https://api.github.com/repos/spali/go-rscp/releases/152736679","Warn: release artifact v0.2.0-beta3 not signed: https://api.github.com/repos/spali/go-rscp/releases/151726884","Warn: release artifact v0.2.1 does not have provenance: https://api.github.com/repos/spali/go-rscp/releases/188365377","Warn: release artifact v0.2.0 does not have provenance: https://api.github.com/repos/spali/go-rscp/releases/153828498","Warn: release artifact v0.2.0-beta5 does not have provenance: https://api.github.com/repos/spali/go-rscp/releases/152833355","Warn: release artifact v0.2.0-beta4 does not have provenance: https://api.github.com/repos/spali/go-rscp/releases/152736679","Warn: release artifact v0.2.0-beta3 does not have provenance: https://api.github.com/repos/spali/go-rscp/releases/151726884"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":8,"reason":"SAST tool detected but not run on all commits","details":["Info: SAST configuration detected: CodeQL","Warn: 5 commits out of 10 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-18T03:21:05.774Z","repository_id":38844198,"created_at":"2025-08-18T03:21:05.774Z","updated_at":"2025-08-18T03:21:05.774Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29169397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T16:33:35.550Z","status":"ssl_error","status_checked_at":"2026-02-06T16:33:30.716Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["battery","binary","client","command-line","commandline","e3-dc","e3dc","go","go-e3dc","go-rscp","golang","hauskraftwerk","json","quattroporte","rscp","s10","smart","smarthome","solar","speicher"],"created_at":"2026-02-06T17:14:13.649Z","updated_at":"2026-02-06T17:14:14.293Z","avatar_url":"https://github.com/spali.png","language":"Go","funding_links":["https://github.com/sponsors/spali","paypal.me/paySpali"],"categories":[],"sub_categories":[],"readme":"# go-rscp \u0026 e3dc command line utility\n\n[![Build Status](https://github.com/spali/go-rscp/actions/workflows/build.yml/badge.svg?branch=master)](https://github.com/spali/go-rscp/actions/workflows/build.yml?query=branch%3Amaster)\n[![Coverage Status](https://codecov.io/gh/spali/go-rscp/branch/master/graph/badge.svg)](https://codecov.io/gh/spali/go-rscp)\n[![CodeQL](https://github.com/spali/go-rscp/workflows/CodeQL/badge.svg)](https://github.com/spali/go-rscp/actions?query=workflow%3A%22CodeQL%22)\n[![Go Report Card](https://goreportcard.com/badge/github.com/spali/go-rscp)](https://goreportcard.com/report/github.com/spali/go-rscp)\n[![GoDoc](https://godoc.org/github.com/spali/go-rscp?status.svg)](https://pkg.go.dev/github.com/spali/go-rscp)\n[![GitHub license](https://img.shields.io/github/license/spali/go-rscp)](https://github.com/spali/go-rscp/blob/master/LICENSE)\n\nGo library (rscp) and command line utility (e3dc) to communicate with a E3DC system implementing the RSCP (Remote Storage Control Protocol).\n\nPlease be gentle with me, this is my first real go project and it's bigger than I thought ;)\nThere is still a lot to improve to be a good reusable library, but most works for my specific usecase using it as a command line utility.\nContributions are very welcome, see also the check [TODO](#TODO) or search in the code for `TODO:` comments.\n\n## Usage\n\nAll arguments can also be set as `E3DC_` prefixed environment variable or in a config file like:\n\n```\nhost 127.0.0.1\nuser myuser\npassword mypassword\nkey mykey\n```\n\n### rscp library\n\nSee [cmd/example](https://github.com/spali/go-rscp/blob/master/cmd/example/e3dc.go) for a small example with different requests and responses.\n\n### e3dc command line utility\n\nRequest sent, is always last argument or can be piped through `stdin` as json string.\n\nSee the examples below for more information.\n\n#### Examples\n\n**\\*Note**: top element has always to be an array\\*\n\n**\\*Note**: these examples assume you have the default `.config` file setup or exported the environment variables.\\*\n\n**\\*Note**: all example use the default output format, check the help `./e3dc -help` for other formats.\\*\n\n- Short tag only notation just request some information\n\n  ```sh\n  ./e3dc '[[\"EMS_REQ_START_MANUAL_CHARGE\",0]]' | jq\n  ```\n\n  Output:\n\n  ```json\n  {\n    \"EMS_START_MANUAL_CHARGE\": true\n  }\n  ```\n\n- Short tag only notation just request some information\n\n  ```sh\n  ./e3dc '[\"INFO_REQ_MAC_ADDRESS\", \"INFO_REQ_UTC_TIME\"]' | jq\n  ```\n\n  Output:\n\n  ```json\n  {\n    \"INFO_MAC_ADDRESS\": \"00:00:00:00:00:00\",\n    \"INFO_UTC_TIME\": \"1970-01-01T00:00:00.000000Z\"\n  }\n  ```\n\n- Tuple notation of tag's to request information\n\n  ```sh\n  ./e3dc '[[\"INFO_REQ_MAC_ADDRESS\"], [\"INFO_REQ_UTC_TIME\"]]' | jq\n  ```\n\n  Output:\n\n  ```json\n  {\n    \"INFO_MAC_ADDRESS\": \"00:00:00:00:00:00\",\n    \"INFO_UTC_TIME\": \"1970-01-01T00:00:00.000000Z\"\n  }\n  ```\n\n- Tuple notation of tag's and values to send information (data type is inferred by the tag)\n  ```sh\n  ./e3dc '[[\"EMS_REQ_START_MANUAL_CHARGE\", 3000]]' | jq\n  ```\n  Output:\n  ```json\n  {\n    \"EMS_START_MANUAL_CHARGE\": true\n  }\n  ```\n- Tuple notation of tag's and values to send information (with explicit data type)\n\n  _Note: data type of the tag can be overriden by the user_\n\n  ```sh\n  ./e3dc '[[\"INFO_REQ_MAC_ADDRESS\",\"None\",\"\"], [\"INFO_REQ_UTC_TIME\"]]' | jq\n  ```\n\n  Output:\n\n  ```json\n  {\n    \"INFO_MAC_ADDRESS\": \"00:00:00:00:00:00\",\n    \"INFO_UTC_TIME\": \"1970-01-01T00:00:00.000000Z\"\n  }\n  ```\n\n## TODO\n\n- [ ] more testing\n- [ ] more documentation\n- [ ] check the generic data type logic (i.e. pointer vs value in interface), this should do a pro ;)\n- [ ] `cmd/e3dc`\n  - [x] read config file (security)\n  - [x] read from environment variables (security)\n  - [x] streamline logging\n  - [x] optional experimental mode which accepts any custom message (including tag, datatype and value)\n  - [ ] implement optional (by flag) pair output (same as the tuple input without datatype)\n- [ ] `rscp`\n  - [ ] cleanup API\n    - [x] probably expose `Message` as interface and make the struct internal (would allow to move the complete cmd/e3dc specific json stuff out)\n  - [ ] streamline logging\n  - [ ] client: improve implementation to make it stable for keeping stable and connected when used in a service\n  - [x] move `cmd/e3dc` specific json marshalling out of `rscp` to command line utility `cmd/e3dc`\n  - [x] move `cmd/e3dc` specific json unmarshaling out of `rscp` to command line utility `cmd/e3dc`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspali%2Fgo-rscp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspali%2Fgo-rscp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspali%2Fgo-rscp/lists"}