- [Flash the Firmware on your Ahoy DTU Hardware](#flash-the-firmware-on-your-ahoy-dtu-hardware)
+ [Compiling your own Version (the geek way)](#compiling-your-own-version)
- [Optional Configuration before compilation](#optional-configuration-before-compilation)
+ [Using a ready-to-flash binary using nodemcu-pyflasher (the easy way)](#using-a-ready-to-flash-binary-using-nodemcu-pyflasher)
- [Connect to your Ahoy DTU](#connect-to-your-ahoy-dtu)
+ [Your Ahoy DTO is very verbose using the Serial Console](#your-ahoy-dto-is-very-verbose-using-the-serial-console)
+ [Connect to the Ahoy DTU Webinterface using your Browser](#connect-to-the-ahoy-dtu-webinterface-using-your-browser)
- [HTTP based Pages](#http-based-pages)
- [MQTT command to set the DTU without webinterface](#mqtt-command-to-set-the-dtu-without-webinterface)
- [Used Libraries](#used-libraries)
- [Used Libraries](#used-libraries)
- [Contact](#contact)
- [Contact](#contact)
- [ToDo's - remove when done](#todo)
***
***
## Overview
## Overview
This page describes how the module of a Wemos D1 mini and ESP8266 is wired to the radio module, flashed and how the further steps are to communicate with the WR HM series.
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/>
Further information will help you to communicate to the compatible inverters.
## Compatiblity
For now the following Inverters should work out of the box:
Hoymiles Inverters
- HM300
- HM350
- HM400
- HM600
- HM700
- HM800
- HM1000?
- HM1200
- HM1500
TSun Inverters:
- TSOL-350
- TSOL-400
- othery may work as well (need to be veryfied).
## Things needed
In order to build your own Ahoy DTU, you will need some things.<br/>
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.<br/>
Make sure it has the "+" in its name as we depend on some features provided with the plus-variant.<br/>
Any other ESP8266 Board with at least 4MBytes of ROM could work as well, depending on your skills.
## Wiring things up
The NRF24L01+ radio module is connected to the
The NRF24L01+ radio module is connected to the
standard SPI pins:
standard SPI pins:
@ -21,55 +62,35 @@ standard SPI pins:
- MISO (Master In Slave Out) and
- MISO (Master In Slave Out) and
- MOSI (Master Out Slave In)
- MOSI (Master Out Slave In)
Additional there are 3 pins, which can be set individual:
*These pins need to be configured in the config.h.*
Additional, there are 3 pins, which can be set individual:
- CS (Chip Select),
- CS (Chip Select),
- CE (Chip Enable) and
- CE (Chip Enable) and
- IRQ (Interrupt)
- IRQ (Interrupt)
These pins can be changed from the /setup URL
*These pins can be changed from the /setup URL.*
#### Compatiblity
#### ESP8266 wiring example
For now the following inverters should work out of the box:
ToDo: (this one needs to be reworked - also a generified one would be helpful)
When everything is wired up and the firmware is flashed, it is time to connect to your Ahoy DTU.
| /setup | |
| /save | open the setup site |
| /cmdstat | show stat from the home site |
#### Your Ahoy DTU is very verbose using the Serial Console
| /visualization | |
When connected to your computer, you can open a Serial Console to obtain additional information.
| /livedata | |
This might be useful in case of any troubles that might occur as well as to simply obtain information about the converted values which were read out of the inverter(s).
| /json | json output from the livedata |
| /api | |
#### Connect to the Ahoy DTU Webinterface using your Browser
## Usage
After you have sucessfully flashed and powered your Ahoy DTU, you can access it via your Browser.
If your Ahoy DTU was able to log into the configured WiFi Network, it will try to obtain an IP-Address from your local DHCP Server (in most cases thats your Router).
The webinterface has the following abilities:
In case it could not connect to your configured Network, it will provide its own WiFi Network that you can connect to for furter configuration. The WiFi SSID *(the WiFi Name)* and Passwort is configured in the config.h and defaults to the SSID "AHOY-DTU" with the Passwort "esp_8266".
- OTA Update (over the air update)
The Ahoy DTU will keep that Network open for a certain amount of time (also configurable in the config.h and defaults to 60secs). If nothing connects to it and that time runs up, it will retry to connect to the configured network an so on.
If connected to your local Network, you just have to find out the used IP Address. In most cases your Router will give you a hint.
If you connect to the WiFi the Ahoy DTU opens in case it could not connect to any other Network, the IP-Address of your Ahoy DTU is 192.168.1.1.
- [ ] MQTT Discovery (HomeAssistant) im Setup optional machen
- [x] MQTT Subscribe nur beim Reconnect [Das subscribe in der Reconnect Procedure sollte doch nur nach einem conect ausgeführt werden und nicht bei jedem Duchlauf #139](https://github.com/grindylow/ahoy/issues/139)
## Contact
## Contact
We run a Discord Server that can be used to get in touch with the Developers and Users.
We run a Discord Server that can be used to get in touch with the Developers and Users.
https://discord.gg/WzhxEY62mB
https://discord.gg/WzhxEY62mB
## ToDo
[See this post](https://github.com/grindylow/ahoy/issues/142)
lumapu
2 years ago