Merge branch 'main' into development03

.github/ISSUE_TEMPLATE/report.yaml

@@ -1,9 +1,6 @@
-name: "AhoyDTU bug"
-description: "File a bug report"
-title: "[Bug]"
-labels: ["bug", "needs-triage"]
-assignees:
-  - lumapu
+name: "issue report"
+description: "issue report"
+labels: ["new", "needs-triage"]
 body:
   - type: markdown
     attributes:

.github/workflows/compile_release.yml

@@ -5,6 +5,7 @@ on:
     branches: main
     paths-ignore:
     - '**.md' # Do no build on *.md changes
+    - '**.yaml' # e.g. issue report
 
 jobs:
   check:

.gitignore

@@ -16,4 +16,4 @@ src/data/*
 src/output.map
 
 /.venv
-/scripts/__pycache__/htmlPreprocessorDefines.cpython-311.pyc
+/scripts/__pycache__/*

README.md

@@ -24,6 +24,7 @@ This repository provides hardware and software solutions for communicating with
 
 ## Changelog
 [latest Release](https://github.com/lumapu/ahoy/blob/main/src/CHANGES.md)
+
 [Development Version](https://github.com/lumapu/ahoy/blob/development03/src/CHANGES.md)
 
 
@@ -31,10 +32,9 @@ Table of approaches:
 
 | Board  | MI | HM | HMS/HMT | comment | HowTo start |
 | ------ | -- | -- | ------- | ------- | ---------- |
-| [ESP8266/ESP32, C++](manual/Getting_Started.md) | ✔️ | ✔️ | ✔️ |  👈 the most effort is spent here | [create your own DTU](https://ahoydtu.de/getting_started/) |
-| [Arduino Nano, C++](tools/nano/NRF24_SendRcv/) | ❌ | ✔️ | ❌ | |
-| [Raspberry Pi, Python](tools/rpi/) | ❌ | ✔️ | ❌ | |
-| [Others, C/C++](tools/nano/NRF24_SendRcv/) | ❌ | ✔️ | ❌ |  |
+| [ESP32, C++](manual/Getting_Started.md) | ✔️ | ✔️ | ✔️ |  [create your own DTU](https://ahoydtu.de/getting_started/) |
+| ESP8266, C++ | ✔️ | ✔️ | ❌ | ⚠️ not recommended for new DTU |
+
 
 ⚠️ **Warning: HMS-XXXXW-2T WiFi inverters are not supported. They have a 'W' in their name and a DTU serial number on its sticker**
 
@@ -48,6 +48,8 @@ Table of approaches:
 ## Our Website
 [https://ahoydtu.de](https://ahoydtu.de)
 
+[Firmware Archive https://fw.ahoydtu.de](https://fw.ahoydtu.de)
+
 ## Success Stories
 - [Getting the data into influxDB and visualize them in a Grafana Dashboard](https://grafana.com/grafana/dashboards/16850-pv-power-ahoy/) (thx @Carl)
 

manual/Getting_Started.md

@@ -17,6 +17,7 @@ Hoymiles Inverters
 | ✔️ | HMS | 350, 500, 800, 1000, 1600, 1800, 2000 | |
 | ✔️ | HMT | 1600, 1800, 2250 | |
 | ⚠️ | TSUN | [TSOL-M350](https://www.tsun-ess.com/Micro-Inverter/M350-M400), [TSOL-M400](https://www.tsun-ess.com/Micro-Inverter/M350-M400), [TSOL-M800/TSOL-M800(DE)](https://www.tsun-ess.com/Micro-Inverter/M800) | others may work as well (need to be verified). |
+| 🟡 | HERF | (supported) | |
 
 ## Table of Contents
 
@@ -25,16 +26,16 @@ Hoymiles Inverters
 - [Things needed](#things-needed)
     - [There are fake NRF24L01+ Modules out there](#there-are-fake-nrf24l01-modules-out-there)
 - [Wiring things up](#wiring-things-up)
+    - [ESP32 wiring example](#esp32-wiring-example)
+      - [Schematic](#schematic-1)
+      - [Symbolic view](#symbolic-view-1)
+      - [ESP32 GPIO settings](#esp32-gpio-settings)
     - [ESP8266 wiring example on WEMOS D1](#esp8266-wiring-example)
       - [Schematic](#schematic)
       - [Symbolic view](#symbolic-view)
     - [ESP8266 wiring example on 30pin Lolin NodeMCU v3](#esp8266-wiring-example-2)
       - [Schematic](#schematic-2)
       - [Symbolic view](#symbolic-view-2)
-    - [ESP32 wiring example](#esp32-wiring-example)
-      - [Schematic](#schematic-1)
-      - [Symbolic view](#symbolic-view-1)
-      - [ESP32 GPIO settings](#esp32-gpio-settings)
 - [Flash the Firmware on your Ahoy DTU Hardware](#flash-the-firmware-on-your-ahoy-dtu-hardware)
     - [Compiling your own Version](#compiling-your-own-version)
     - [Using a ready-to-flash binary using nodemcu-pyflasher](#using-a-ready-to-flash-binary-using-nodemcu-pyflasher)
@@ -56,9 +57,10 @@ Solenso Inverters:
 
 To build your own AhoyDTU, you only need a few things. Remember that the maker community is always developing new and innovative options that we may not have covered in this readme.
 
-Start with an ESP8266 or ESP32, and combine it with an NRF24L01+ breakout board. Other ESP boards with at least 4MBytes of ROM may also be suitable.
+Start with an ESP32 or ESP8266 (not recommended), and combine it with an NRF24L01+ breakout board for HM-series inverters. To communicate with a HMS or HMT inverter you need to use a CMT2300A radio module.
+Other ESP boards with at least 4MBytes of ROM may also be suitable.
 
-Make sure to choose an NRF24L01+ module that includes the '+' in its name. This is important because we need the 250kbps features that are only available in the plus-variant.
+Note for NRF24 radio module: Make sure to choose an NRF24L01+ module that includes the '+' in its name. This is important because we need the 250kbps features that are only available in the plus-variant.
 
 **Attention**: The NRF24L01+ can only communicate with the MI/HM/TSUN inverter. For the HMS/HMT it is needed to use a CMT2300A!