From 25f62d4681050d0e947f0f4d8a0706b647f309a9 Mon Sep 17 00:00:00 2001 From: funghi999 <50140796+funghi999@users.noreply.github.com> Date: Fri, 31 May 2024 12:20:45 +0200 Subject: [PATCH] Update README.md --- README.md | 85 +++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 55 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index c61c8e60..151c2a0f 100644 --- a/README.md +++ b/README.md @@ -1,43 +1,68 @@ -# OpenDTU +# OpenDTU-DUO-Fusion + +This is a fork from the Hoymiles project [OpenDTU](https://github.com/tbnobody/OpenDTU). [![OpenDTU Build](https://github.com/tbnobody/OpenDTU/actions/workflows/build.yml/badge.svg)](https://github.com/tbnobody/OpenDTU/actions/workflows/build.yml) [![cpplint](https://github.com/tbnobody/OpenDTU/actions/workflows/cpplint.yml/badge.svg)](https://github.com/tbnobody/OpenDTU/actions/workflows/cpplint.yml) [![Yarn Linting](https://github.com/tbnobody/OpenDTU/actions/workflows/yarnlint.yml/badge.svg)](https://github.com/tbnobody/OpenDTU/actions/workflows/yarnlint.yml) -## !! IMPORTANT UPGRADE NOTES !! - -If you are upgrading from a version before 15.03.2023 you have to upgrade the partition table of the ESP32. Please follow the [this](docs/UpgradePartition.md) documentation! - -## Background - -This project was started from [this](https://www.mikrocontroller.net/topic/525778) discussion (Mikrocontroller.net). -It was the goal to replace the original Hoymiles DTU (Telemetry Gateway) with their cloud access. With a lot of reverse engineering the Hoymiles protocol was decrypted and analyzed. - ## Documentation -The documentation can be found [here](https://tbnobody.github.io/OpenDTU-docs/). -Please feel free to support and create a PR in [this](https://github.com/tbnobody/OpenDTU-docs) repository to make the documentation even better. +The origin documentation of openDTU can be found [here](https://tbnobody.github.io/OpenDTU-docs/). -## Breaking changes +### Ducumentation for openDTU-DUO-Fusion -Generated using: `git log --date=short --pretty=format:"* %h%x09%ad%x09%s" | grep BREAKING` +* Will comming soon! -```code -* 1b637f08 2024-01-30 BREAKING CHANGE: Web API Endpoint /api/livedata/status and /api/prometheus/metrics -* e1564780 2024-01-30 BREAKING CHANGE: Web API Endpoint /api/livedata/status and /api/prometheus/metrics -* f0b5542c 2024-01-30 BREAKING CHANGE: Web API Endpoint /api/livedata/status and /api/prometheus/metrics -* c27ecc36 2024-01-29 BREAKING CHANGE: Web API Endpoint /api/livedata/status -* 71d1b3b 2023-11-07 BREAKING CHANGE: Home Assistant Auto Discovery to new naming scheme -* 04f62e0 2023-04-20 BREAKING CHANGE: Web API Endpoint /api/eventlog/status no nested serial object -* 59f43a8 2023-04-17 BREAKING CHANGE: Web API Endpoint /api/devinfo/status requires GET parameter inv= -* 318136d 2023-03-15 BREAKING CHANGE: Updated partition table: Make sure you have a configuration backup and completly reflash the device! -* 3b7aef6 2023-02-13 BREAKING CHANGE: Web API! -* d4c838a 2023-02-06 BREAKING CHANGE: Prometheus API! -* daf847e 2022-11-14 BREAKING CHANGE: Removed deprecated config parsing method -* 69b675b 2022-11-01 BREAKING CHANGE: Structure WebAPI /api/livedata/status changed -* 27ed4e3 2022-10-31 BREAKING: Change power factor from percent value to value between 0 and 1 -``` +## Highlights of OpenDTU-DUO-Fusion + +This project is still under development and adds following features: + +* Supports the specially designed circuit board and pre-configures the connected components (CMT2300a, NRF24l01+, display, etc.). +* Disable the power-save mode for displays ## Currently supported Inverters -A list of all currently supported inverters can be found [here](https://www.opendtu.solar/hardware/inverter_overview/) +| Model | Required RF Module | DC Inputs | MPP-Tracker | AC Phases | +| ---------------------| ------------------ | --------- | ----------- | --------- | +| Hoymiles HM-300-1T | NRF24L01+ | 1 | 1 | 1 | +| Hoymiles HM-350-1T | NRF24L01+ | 1 | 1 | 1 | +| Hoymiles HM-400-1T | NRF24L01+ | 1 | 1 | 1 | +| Hoymiles HM-600-2T | NRF24L01+ | 2 | 2 | 1 | +| Hoymiles HM-700-2T | NRF24L01+ | 2 | 2 | 1 | +| Hoymiles HM-800-2T | NRF24L01+ | 2 | 2 | 1 | +| Hoymiles HM-1000-4T | NRF24L01+ | 4 | 2 | 1 | +| Hoymiles HM-1200-4T | NRF24L01+ | 4 | 2 | 1 | +| Hoymiles HM-1500-4T | NRF24L01+ | 4 | 2 | 1 | +| Hoymiles HMS-300-1T | CMT2300A | 1 | 1 | 1 | +| Hoymiles HMS-350-1T | CMT2300A | 1 | 1 | 1 | +| Hoymiles HMS-400-1T | CMT2300A | 1 | 1 | 1 | +| Hoymiles HMS-450-1T | CMT2300A | 1 | 1 | 1 | +| Hoymiles HMS-500-1T | CMT2300A | 1 | 1 | 1 | +| Hoymiles HMS-600-2T | CMT2300A | 2 | 2 | 1 | +| Hoymiles HMS-700-2T | CMT2300A | 2 | 2 | 1 | +| Hoymiles HMS-800-2T | CMT2300A | 2 | 2 | 1 | +| Hoymiles HMS-900-2T | CMT2300A | 2 | 2 | 1 | +| Hoymiles HMS-1000-2T | CMT2300A | 2 | 2 | 1 | +| Hoymiles HMS-1600-4T | CMT2300A | 4 | 4 | 1 | +| Hoymiles HMS-1800-4T | CMT2300A | 4 | 4 | 1 | +| Hoymiles HMS-2000-4T | CMT2300A | 4 | 4 | 1 | +| Hoymiles HMT-1600-4T | CMT2300A | 4 | 2 | 3 | +| Hoymiles HMT-1800-4T | CMT2300A | 4 | 2 | 3 | +| Hoymiles HMT-2000-4T | CMT2300A | 4 | 2 | 3 | +| Hoymiles HMT-1800-6T | CMT2300A | 6 | 3 | 3 | +| Hoymiles HMT-2250-6T | CMT2300A | 6 | 3 | 3 | +| Solenso SOL-H350 | NRF24L01+ | 1 | 1 | 1 | +| Solenso SOL-H400 | NRF24L01+ | 1 | 1 | 1 | +| Solenso SOL-H800 | NRF24L01+ | 2 | 2 | 1 | +| TSUN TSOL-M350 | NRF24L01+ | 1 | 1 | 1 | +| TSUN TSOL-M800 | NRF24L01+ | 2 | 2 | 1 | +| TSUN TSOL-M1600 | NRF24L01+ | 4 | 2 | 1 | +| E-Star HERF-800 | NRF24L01+ | 2 | 2 | 1 | +| E-Star HERF-1600 | NRF24L01+ | 4 | 2 | 1 | +| E-Star HERF-1800 | NRF24L01+ | 4 | 2 | 1 | + + +## Outline + +A very special thank you to Thomas Basler (tbnobody), the author of the original [OpenDTU](https://github.com/tbnobody/OpenDTU) project. You are doing an excellent job!