title:"[ESP8266/ESP32/RaspberryPi] Problem Description / Beschreibung"
title:"[Bug]"
labels:["bug","needs-triage"]
labels:["bug","needs-triage"]
assignees:
assignees:
- stefan123t
- lumapu
body:
body:
- type:markdown
- type:markdown
attributes:
attributes:
value:|
value:|
Bitte die Posting Guide lines lesen, Vorlage kopieren und ausfüllen und in Eurem Support Forum Eintrag posten.
Bitte die Posting Guide lines lesen, Vorlage kopieren und ausfüllen und in Eurem Support Forum Eintrag posten.
Wir lesen auch gerne Deutsch, bitte fülle die u.a. Fragen aus damit wir Dir bestmöglich helfen können Danke!
Wir lesen auch gerne Deutsch, bitte fülle die u.a. Fragen aus damit wir Dir bestmöglich helfen können Danke!
Bitte unser FAQ als Hilfestellung prüfen:https://ahoydtu.de/faq
Please read, copy & fill in the template from our Posting Guide lines into your Support Forum post.
Please read, copy & fill in the template from our Posting Guide lines into your Support Forum post.
We do enjoy the english language, but we need a couple of things to best support you in your goal, please fill in all / most of the details given below. Thanks!
We do enjoy the english language, but we need a couple of things to best support you in your goal, please fill in all / most of the details given below. Thanks!
Check our FAQ:https://ahoydtu.de/faq
- type:markdown
- type:markdown
attributes:
attributes:
value:"## Hardware"
value:"## Hardware"
@ -35,11 +37,21 @@ body:
placeholder:
placeholder:
validations:
validations:
required:false
required:false
- type:dropdown
id:assembly-type
attributes:
label:Assembly
description:
options:
- I did the assebly by myself
- the DTU was already assembled
validations:
required:true
- type:dropdown
- type:dropdown
id:nrf24l01-module
id:nrf24l01-module
attributes:
attributes:
label:nRF24L01+ Module
label:nRF24L01+ Module
description:|
description:|
What type of nRF24L01+ chip is on your nRF24L01+ module ?
What type of nRF24L01+ chip is on your nRF24L01+ module ?
*you verified this is a **nRF24L01+ plus** model capable of the required 256kBit/s mode ?
*you verified this is a **nRF24L01+ plus** model capable of the required 256kBit/s mode ?
***squaredot** indicates original Nordic Semicon chip ?
***squaredot** indicates original Nordic Semicon chip ?
@ -69,43 +81,11 @@ body:
*special **voltage stabilizing board**
*special **voltage stabilizing board**
***nothing**(yet)
***nothing**(yet)
options:
options:
- ~100uF Elko
- Elko (~100uF)
- board
- board
- nothing
- nothing
validations:
validations:
required:true
required:true
- type:textarea
id:connection-diagram
attributes:
label:Connection diagram
description:Tell us which connection diagram you used?
value:|
## Connection diagram I used:
| nRF24L01+ Pin | ESP8266 GPIO |
| ------------- | -------------- |
| Pin 1 GND [*] | GND |
| Pin 2 +3.3V | +3.3V |
| Pin 3 CE | GPIO2 CE D4 |
| Pin 4 CSN | GPIO15 CS D8 |
| Pin 5 SCK | GPIO14 SCLK D5 |
| Pin 6 MOSI | GPIO13 MOSI D7 |
| Pin 7 MISO | GPIO12 MISO D6 |
| Pin 8 IRQ | GPIO0 IRQ D3 |
| nRF24L01+ Pin | ESP32 GPIO |
| ------------- | --------------- |
| Pin 1 GND [*] | GND |
| Pin 2 +3.3V | +3.3V |
| Pin 3 CE | GPIO4 CE D4 |
| Pin 4 CSN | GPIO5 CS D5 |
| Pin 5 SCK | GPIO18 SCLK D18 |
| Pin 6 MOSI | GPIO23 MOSI D23 |
| Pin 7 MISO | GPIO19 MISO D19 |
| Pin 8 IRQ | GPIO0 IRQ D0 |
Note:[*]GND Pin 1 has a square mark on the nRF24L01+ module
validations:
required:true
- type:checkboxes
- type:checkboxes
id:connection-picture
id:connection-picture
attributes:
attributes:
@ -123,7 +103,7 @@ body:
attributes:
attributes:
label:Version
label:Version
description:What version of our software are you running ?
description:What version of our software are you running ?
placeholder:0.5.17
placeholder:0.6.0
validations:
validations:
required:true
required:true
- type:input
- type:input
@ -131,7 +111,7 @@ body:
attributes:
attributes:
label:Github Hash
label:Github Hash
description:Which GitHub hash has the build of our software ?
description:Which GitHub hash has the build of our software ?
placeholder:5402e9b
placeholder:0000000
validations:
validations:
required:true
required:true
- type:dropdown
- type:dropdown
@ -140,19 +120,11 @@ body:
label:Build & Flash Method
label:Build & Flash Method
description:What software do you use to flash / build & flash our firmware images ?
description:What software do you use to flash / build & flash our firmware images ?
options:
options:
- AhoyDTU Webinstaller
- VSCode - Platform IO (build & flash)
- ESP Tools (flash)
- ESP Tools (flash)
- Platform IO (build & flash)
- Arduino IDE
validations:
- was already installed
required:true
- type:dropdown
id:desktop-os
attributes:
label:Desktop
description:Which operating system are you using on your desktop to build & flash ?
options:
- Linux
- Mac OS
- Windows
validations:
validations:
required:true
required:true
- type:textarea
- type:textarea
@ -160,49 +132,12 @@ body:
attributes:
attributes:
label:Setup
label:Setup
description:|
description:|
Which settings are configured under http://ahoy-dtu/setup ?
Which settings were modified to which values? Check this page on your DTU:http://ahoy-dtu/setup
Document any relevant setup values correctly.
Do not post private data here (SSID / passwords / serial numbers)!
Copy and paste the Inverter Section if you have multiple Inverters.
placeholder:|
value:|
Some examples:
### Device Host Name
- MqTT:only broker was added
- Device Name:AHOY-DTU
- Inverter:set intervall to 5 seconds ..
### WiFi
- SSID:YOUR_WIFI_SSID *don't paste here*
- Password:YOUR_WIFI_PWD *don't paste here*
### Inverter
#### Inverter 0
- Address:1141752123456
- Name:HM-600
- Active Power Limit:65535
- Active Power Limit Control Type:nopowerlimit
- Max Module Power (Wp):375,375
- Module Name:link, rech
### General
- Interval [s]:30
- Max retries per Payload:5
### NTP Server
- NTP Server / IP:pool.ntp.org
- NTP Port:123
### MQTT
- Broker / Server IP:
- Port:1883
- Username (optional):
- Password (optional):
- Topic:inverter
### System Config
#### Pinout (Wemos)
- CS:D8 (GPIO15)
- CE:D4 (GPIO2)
- IRQ:D3 (GPIO0)
#### Radio (NRF24L01+)
- Amplifier Power Level:LOW
#### Serial Console
- print inverter data:[x]
- Serial Debug:[x]
- Interval [s]:5
- Reboot device after successful save:[x]
- SAVE
validations:
validations:
required:true
required:true
- type:textarea
- type:textarea
@ -219,12 +154,9 @@ body:
attributes:
attributes:
label:Error description
label:Error description
description:Please describe what you expected and what happened instead.
description:Please describe what you expected and what happened instead.
value:|
placeholder:|
1) Go to http://ahoy-dtu/setup
1) I went to https://ahoy-dtu.de/web_install and installed latest release
This page describes how the module of a Wemos D1 mini and ESP8266 is wired to the radio module and is flashed with the latest Firmware.<br/>
On this page, you'll find detailed instructions on how to wire the module of a Wemos D1 mini or ESP32 to the radio module, as well as how to flash it with the latest firmware. This information will enable you to communicate with compatible inverters.
Further information will help you to communicate to the compatible inverters.
You find the full [User_Manual here](User_Manual.md)
You find the full [User_Manual here](User_Manual.md)
## Compatiblity
## Compatiblity
For now the following Inverters should work out of the box:
The following inverters are currently supported out of the box:
Hoymiles Inverters
Hoymiles Inverters
@ -55,12 +54,11 @@ Solenso Inverters:
## Things needed
## Things needed
In order to build your own Ahoy DTU, you will need some things.<br/>
If you're interested in building your own AhoyDTU, you'll need a few things to get started. While we've provided a list of recommended boards below, keep in mind that the maker community is constantly developing new and innovative options that we may not have covered in this readme..
This list is not closing as the Maker Community offers more Boards than we could cover in this Readme.<br/><br/>
We suggest to use a WEMOS D1 mini Board as well as a NRF24L01+ Breakout Board as a bare minimum.<br/>
For optimal performance, we recommend using a Wemos D1 mini or ESP32 along with a NRF24L01+ breakout board as a bare minimum. However, if you have experience working with other ESP boards, any board with at least 4MBytes of ROM may be suitable, depending on your skills.
Any other ESP8266 Board with at least 4MBytes of ROM could work as well, depending on your skills and goals.<br/>
Make sure the NRF24L01+ module has the "+" in its name as we depend on the 250kbps features provided only with the plus-variant.
Just be sure that the NRF24L01+ module you choose includes the "+" in its name, as we rely on the 250kbps features that are only provided by the plus-variant.
| **Parts** | **Price** |
| **Parts** | **Price** |
| --- | --- |
| --- | --- |
@ -70,7 +68,7 @@ Make sure the NRF24L01+ module has the "+" in its name as we depend on the 250kb
| Jumper Wire Steckbrücken Steckbrett weiblich-weiblich | 2,49 Euro |
| Jumper Wire Steckbrücken Steckbrett weiblich-weiblich | 2,49 Euro |
| **Total costs** | **10,34 Euro** |
| **Total costs** | **10,34 Euro** |
To also run our sister project OpenDTU and be upwards compatible for the future we would recommend to spend some more money on an ESP32 board which has two CPU cores and a NRF24L01+ module with external antenna.
If you're interested in using our sister project OpenDTU or you want to future-proof your setup, we recommend investing in an ESP32 board that features two CPU cores. As Radio you can also use a NRF24L01+ module with an external antenna. While this option may cost a bit more, it will provide superior performance and ensure compatibility with upcoming developments.
| **Parts** | **Price** |
| **Parts** | **Price** |
| --- | --- |
| --- | --- |
@ -154,7 +152,7 @@ Example wiring for a 38pin ESP32 module
##### ESP32 GPIO settings
##### ESP32 GPIO settings
For this wiring, set the 3 individual GPIOs under the /setup URL:
CS, CE, IRQ must be set according to how they are wired up. For the diagram above, set the 3 individual GPIOs under the /setup URL as follows:
```
```
CS D1 (GPIO5)
CS D1 (GPIO5)
@ -162,14 +160,14 @@ CE D2 (GPIO4)
IRQ D0 (GPIO16 - no IRQ!)
IRQ D0 (GPIO16 - no IRQ!)
```
```
ATTENTION: From development version 108 onwards, also MISO, MOSI and SCLK
IMPORTANT: From development version 108/release 0.6.0 onwards, also MISO, MOSI, and SCLK
are configurable. Their defaults are correct for 'standard' ESP32 boards
are configurable. On new installations, their defaults are correct for most ESP32 boards.
and non-settable for ESP8266 (as this chip cannot move them elsewhere).
These pins cannot be configured for ESP82xx boards, as this chip cannot move them elsewhere.
If you have an existing install though, you might see '0' in the web GUI.
Set MISO=19, MOSI=23, SCLK=18 in GUI and save for existing installs, this is the old
If you are upgrading an existing install though, you might see that these pins are set to '0' in the web GUI.
correct default for most ESP32 boards, for ESP82xx, a simple settings save should suffice.
Communication with the NRF module wont work. For upgrading an existing installations, set MISO=19, MOSI=23, SCLK=18 in the settings.
Reboot afterwards.
This is the correct default for most ESP32 boards. On ESP82xx, simply saving the settings without changes should suffice.
**Communicate with Hoymiles inverters via radio**. Get actual values like power, current, daily energy and set parameters like the power limit via web interface or MQTT. In this repository you will find different approaches means Hardware / Software to realize the described functionalities.
This repository offers hardware and software solutions for communicating with Hoymiles inverters via radio. With our system, you can easily obtain real-time values such as power, current, and daily energy. Additionally, you can set parameters like the power limit of your inverter to achieve zero export. You can access these functionalities through our user-friendly web interface, MQTT, or JSON. Whether you're monitoring your solar panel system's performance or fine-tuning its settings, our solutions make it easy to achieve your goals.
Table of approaches:
Table of approaches:
@ -29,6 +29,7 @@ Table of approaches:
## Getting Started
## Getting Started
[Guide how to start with a ESP module](Getting_Started.md)
[Guide how to start with a ESP module](Getting_Started.md)
- [The root of development](https://www.mikrocontroller.net/topic/525778)
- [The root of development](https://www.mikrocontroller.net/topic/525778)
### Development
### Development
If you encounter issues use the issues here on github.
If you run into any issues, please feel free to use the issue tracker here on Github. When describing your issue, please be as detailed and precise as possible, and take a moment to consider whether the issue is related to our software. This will help us to provide more effective solutions to your problem.
Please try to describe your issues as precise as possible and think about if this is a issue with the software here in the repository or other software components.