mirror of
https://github.com/lumapu/ahoy.git
synced 2025-08-02 16:08:26 +02:00
reworked getting started
new footer
This commit is contained in:
lumapu
parent
6d90874724
commit
0f73a0542d
12 changed files with 369 additions and 195 deletions
|
|
@ -1,9 +0,0 @@
|
|||
---
|
||||
title: "About"
|
||||
date: 2022-10-26T21:34:10Z
|
||||
tags: []
|
||||
draft: false
|
||||
---
|
||||
|
||||
AhoyDTU is a firmware for ESP8266 and ESP32 modules to read values from a hoymiles inverter of the 3rd generation.
|
||||
It is generally based on reverse engineering which started in [Mikrocontroller.net Forum](https://www.mikrocontroller.net/topic/525778).
|
||||
|
|
@ -1,11 +0,0 @@
|
|||
---
|
||||
title: "Install Firmware"
|
||||
date: 2022-10-26T22:49:15Z
|
||||
tags: []
|
||||
draft: false
|
||||
type: flash
|
||||
layout: flash
|
||||
---
|
||||
|
||||
|
||||
You can easily upload the latest firmware to your ESP.
|
||||
302
content/getting_started.html
Normal file
302
content/getting_started.html
Normal file
|
|
@ -0,0 +1,302 @@
|
|||
---
|
||||
title: "Getting Started"
|
||||
date: 2022-10-26T21:27:10Z
|
||||
tags: []
|
||||
draft: false
|
||||
---
|
||||
<script type="module" src="https://unpkg.com/esp-web-tools@9.0.3/dist/web/install-button.js?module"></script>
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<div class="row flex-lg-row align-items-center g-5 py-5">
|
||||
<div class="col-lg-6">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-3">Hardware / Einkaufsliste</h1>
|
||||
<p class="lead">
|
||||
Die Hardware für AhoyDTU besteht nur aus zwei Modulen. Einem WLAN-Modul und einem 2.4GHz Funkmodul. Für die Systemstabilität wird noch ein Kondensator empfohlen.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Der Gesamtpreis spiegelt wider was eine Hardware für Ahoy kosten darf. Auf gängigen Platformen wird diese zu völlig überzogenen Preisen angeboten. Also besser selbst zusammenbauen und dabei noch etwas lernen.
|
||||
</p>
|
||||
<div class="alert alert-secondary" role="alert">
|
||||
Die extern verlinkten Angebote sind willkürlich und dienen nur als Beispiel. Die Angebote können zwischenzeitlich ausverkauft oder entfernt worden sein.
|
||||
</div>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<table class="table table-striped">
|
||||
<thead>
|
||||
<tr>
|
||||
<th scope="col">Bauteil</th>
|
||||
<th scope="col">Anzahl</th>
|
||||
<th scope="col">Preis (ca.)</th>
|
||||
<th scope="col">Makershop</th>
|
||||
<th scope="col">Ebay</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td>Wemos D1 Mini</td>
|
||||
<td>1</td>
|
||||
<td>4,40 €</td>
|
||||
<td><a href="https://www.makershop.de/plattformen/d1-mini/wemos-d1-mini/" target="_blank">link</a></td>
|
||||
<td><a href="https://www.ebay.de/itm/153891459582" target="_blank">link</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NRF24L01+</td>
|
||||
<td>1</td>
|
||||
<td>3,45 €</td>
|
||||
<td><a href="https://www.makershop.de/unkategorisiert/nrf24l01-smd-modul-24-ghz-wi-fi-funkmodul-arduino-raspberry-pi/" target="_blank">link</a></td>
|
||||
<td>-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>NRF24L01+ PA LNA SMA mit Antenne</td>
|
||||
<td>(optional)</td>
|
||||
<td>4,50 €</td>
|
||||
<td><a href="https://www.makershop.de/module/funk/nrf24l01-pa-lna-sma-antenne/" target="_blank">link</a></td>
|
||||
<td><a href="https://www.ebay.de/itm/291793085079" target="_blank">link</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Jumper Kabel</td>
|
||||
<td>(optional)</td>
|
||||
<td>2,05 €</td>
|
||||
<td><a href="https://www.makershop.de/zubehoer/kabel/40p-10cm/" target="_blank">link</a></td>
|
||||
<td><a href="https://www.ebay.de/itm/334558008501" target="_blank">link</a></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>Kondensator 100uF</td>
|
||||
<td>(optional)</td>
|
||||
<td>2,89 €</td>
|
||||
<td>-</td>
|
||||
<td>-</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<th scope="row">Summe</th>
|
||||
<td>-</td>
|
||||
<th>9,90 €</th>
|
||||
<td>-</td>
|
||||
<td>-</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
<div class="alert alert-primary" role="alert">
|
||||
Vom Funkmodul <strong>NRF24L01+</strong> wird nur eines benötigt. Je nach Reichweite / Umgebung kann hier variiert werden.
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="b-example-divider"></div>
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<div class="row flex-lg-row align-items-center g-5 py-5">
|
||||
<div class="col-lg-6">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-3">Zusammenbau</h1>
|
||||
<p class="lead">
|
||||
Für den Zusammenbau wird in der Regel ein Lötkolben benötigt. Es gibt zwei verschiedene Vorgehen, steckbar (mit Dunpont Kabeln) und fest verdrahtet.<br/>
|
||||
Es wird die feste Verdrahtung empfohlen, da sie weniger anfällig ist.<br/><br/>
|
||||
Optional kann noch für die Stabilität ein 100uF (oder größer) Kondensator an das NRF24 Modul gebaut werden, da dieses beim Senden hohe Ströme fordert.<br/>
|
||||
Dieser Kondensator sollte möglichst nahe am NRF24 an Pin 1 (sw) und Pin 2 (rt) positioniert werden.
|
||||
</p>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<a href="/img/fritzing/AhoyWemos_Steckplatine.jpg" target="_blank"><img src="/img/fritzing/AhoyWemos_Steckplatine.jpg" class="d-block mx-lg-auto img-fluid" alt="schematics" width="450" loading="lazy"></a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="b-example-divider"></div>
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<div class="row flex-lg-row align-items-center g-5 py-5">
|
||||
<div class="col-lg-6">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-3">Firmware flashen</h1>
|
||||
<p class="lead">
|
||||
Ist die Hardware zusammengebaut / -gesteckt kann über den Web Installer die Firmware (letztes Release) auf den ESP geladen werden.<br/>
|
||||
Hierzu die Ahoy-Hardware per USB Kabel an den PC stecken und evtl. warten, bis die Treiber installiert sind. Anschließend auf den <strong>connect</strong> Button klicken.
|
||||
</p>
|
||||
<div class="alert alert-primary" role="alert">
|
||||
<strong>Hinweis: </strong>Der Web Installer kann sowohl für ESP8266 als auch ESP32 verwendet werden.
|
||||
</div>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<esp-web-install-button manifest="/firmware/manifest.json">
|
||||
<span slot="unsupported">
|
||||
<div class="alert alert-warning" role="alert">
|
||||
Your browser does not support installing things on ESP devices. Use Google Chrome or Microsoft Edge.
|
||||
</div>
|
||||
</span>
|
||||
<span slot="not-allowed">
|
||||
<div class="alert alert-danger" role="alert">
|
||||
You are not allowed to do this using http!
|
||||
</div>
|
||||
</span>
|
||||
</esp-web-install-button>
|
||||
<div class="alert alert-secondary mt-3" role="alert">
|
||||
Der Online Installer wird von <a href="https://esphome.github.io/esp-web-tools/" target="_blank">ESP Home Web Tools</a> bereitgestellt
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="b-example-divider"></div>
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<div class="row flex-lg-row align-items-center g-5 py-5">
|
||||
<div class="col-lg-6">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-4">Ahoy Einrichten</h1>
|
||||
<h4><span class="badge rounded-pill bg-primary">1</span> Start</h4>
|
||||
<p class="lead">
|
||||
Nach einer erfolgreichen Installation sollte der Ahoy durch ab- und anstecken neu gestartet werden.<br/>
|
||||
</p>
|
||||
<p class="lead">
|
||||
Der Ahoy spannt automatisch ein WLAN mit dem Namen <strong>AHOY-DTU</strong> auf. Verbinden Sie ein beliebiges WLAN-fähiges Gerät mit diesem WLAN. Nach einer erfolgreichen Verbindung muss im Browser die Adresse <a href="http://192.168.1.1" target="_blank">http://192.168.1.1</a> aufgerufen werden.
|
||||
</p>
|
||||
<div class="alert alert-primary mt-3" role="alert">
|
||||
Das Passwort für das WLAN <strong>AHOY-DTU</strong> ist <strong>esp_8266</strong>
|
||||
</div>
|
||||
|
||||
<h4><span class="badge rounded-pill bg-primary mt-5">2</span> Ahoy als WLAN Client einrichten</h4>
|
||||
<p class="lead">
|
||||
Damit Ahoy von jedem Gerät in Ihrem Netzwerk erreicht werden kann, soll er sich automatisch mit dem heimischen WLAN verbinden.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Hierzu muss in die Einstellungen navigiert werden, dies geschieht über den Menüpunkt <a href="http://192.168.1.1/setup" target="_blank">Settings</a>.
|
||||
</p>
|
||||
<p class="lead">
|
||||
In der Rubrik <strong>WiFi</strong> müssen <strong>SSID</strong> und das <strong>WLAN Passwort</strong> eingetragen werden.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Um den Schritt abzuschließen müssen die Einstellungen mit einem Klick auf <strong>save</strong> gespeichert werden.<br/>
|
||||
Durch einen Neustart meldet sich der Ahoy automatisch in dem eingestellten WLAN an.
|
||||
</p>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<h4><span class="badge rounded-pill bg-primary">3</span> Ahoy in Netzwerk finden</h4>
|
||||
<p class="lead">
|
||||
Wurde in den Einstellungen der Defaultwert für den Gerätename nicht verändert kann mit einem <strong>ping AHOY-DTU</strong> die IP-Adresse herausgefunden werden.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Als weitere Möglichkeit bietet sich die Suche im heimische WLAN Router (z.B. Fritz!Box) an.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Die dritte Möglichkeit ist über die Serielle Console (integriert in Web Installer). Während dem Start von Ahoy wird die zugewiesene IP Adresse ausgegeben.
|
||||
</p>
|
||||
|
||||
<h4><span class="badge rounded-pill bg-primary mt-5">4</span> Wechselrichter hinzufügen</h4>
|
||||
<p class="lead">
|
||||
Jeder Wechelrichter hat eine eindeutige Seriennummer. Diese muss in den Einstellungen eingetragen werden. Hierzu wieder die Einstellungen über die zuvor ermittelte IP-Adresse aufrufen.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Die Rubrik <strong>Inverter</strong> öffnen und die 12-stellige Serinennummer eingeben.<br/>
|
||||
Der Name im nächsten Feld ist frei wählbar und dient der späteren Erkennung z.B. über MQTT.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Unter <i>Max Module Power (Wp)</i> wird die maximale Peak-Leistung der Solarmodule pro Eingang des Wechselrichters eingetragen.<br/>
|
||||
Die <i>Module Namen</i> sind optional, auch diese dienen der späteren Erkennung.
|
||||
</p>
|
||||
<div class="alert alert-primary mt-3" role="alert">
|
||||
Die Seriennummer des Wechselrichters klebt zweifach unten auf dem Wechselrichter.
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="b-example-divider"></div>
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-2 pt-5">Daten empfangen</h1>
|
||||
<div class="row flex-lg-row g-5 pb-5">
|
||||
<div class="col-lg-6">
|
||||
<p class="lead">
|
||||
Der ESP versucht in der Standardeinstellung alle 30 Sekunden Daten vom Wechselrichter abzufragen. Hierzu benötig er eine gültige Zeit.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Man kann auf der Startseite von Ahoy prüfen, ob die Zeit <i>ESP-Time</i> korrekt ist. Falls nicht kann man über das Setup in der Rubrik <strong>NTP Server</strong> die Zeit neu setzen.
|
||||
</p>
|
||||
<div class="alert alert-primary mt-3" role="alert">
|
||||
<strong>Hinweis: </strong>Ahoy kann den Wechselrichter nur bei Tageslicht erreichen, da dessen Funkmodul ausschließlich von den Solarmodulen versorgt wird.
|
||||
</div>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<p class="lead">
|
||||
Nach kurzer Zeit werden die ersten Daten von Ahoy empfangen. Hierfür ist die Rubrik <strong>Statistics</strong> auf der Startseite sehr hilfreich.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Der Zähler hinter <i>RX success</i> gibt an, wie viele Pakete erfolgreich empfangen wurden. Um festzustellen, ob der Wechelrichter überhaupt antwortet kann der Zähler hinter <i>Frames received</i> herangezogen werden.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="b-example-divider"></div>
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-2 pt-5">Weiterführende Einstellungen</h1>
|
||||
<div class="row flex-lg-row g-5 pb-5">
|
||||
<div class="col-lg-6">
|
||||
<h4>MQTT verbinden</h4>
|
||||
<p class="lead">
|
||||
Um Ahoy in das Smarthome einzubinden, bietet sich MQTT als gängige Schnittstelle an. Hierüber werden automatisch die vom Wechselrichter gelesenen Werte an einen sog. MQTT-Broker (z.B. <a href="https://mosquitto.org/" target="_blank"> Mosquitto</a>) gesendet.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Hierzu muss in den Einstellungen in der Rubrik <strong>MQTT</strong> der Broker, dessen Port (Standard ist 1883) und ein (frei wählbares) <i>Topic</i> angegeben werden.
|
||||
</p>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<h4>Sonnenauf und -untergang</h4>
|
||||
<p class="lead">
|
||||
Da der Wechselrichter nur bei tageslicht Daten sendet, kann optional eine Nachabschaltung konfiguriert werden. Hierzu sind die Geo-koorinaten vom Standort nötig. Sind diese korrekt eingetragen, wird automatisch der lokale Sonnenauf- und Untergang berechnet.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Die Koordinaten müssen mit Dezimalpunkt angegeben werden, z.B. <strong>51.1</strong> und <strong>10.2</strong>.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="b-example-divider"></div>
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-2 pt-5">Wie geht es weiter?</h1>
|
||||
<div class="row flex-lg-row g-5 pb-5">
|
||||
<div class="col-lg-6">
|
||||
<h4>Beitragen / Unterstützen</h4>
|
||||
<p class="lead">
|
||||
Inzwischen zählt die Community von Ahoy schon ca. 1000 Leute. Jeder ist herzlich willkommen.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Es gibt verschiedene Themen, die die Gemeinschaft voranbringen:
|
||||
<ul class="lead">
|
||||
<li>Erweiterungen / Verbesserungen am Code</li>
|
||||
<li>Dokumentation der Features</li>
|
||||
<li>Diskussion mit anderen Mitgliedern</li>
|
||||
<li>Testen und berichten von Fehlern</li>
|
||||
<li>Support von neuen Mitgliedern</li>
|
||||
<li>Entwerfen von Platinen / Gehäusen für Ahoy</li>
|
||||
<li>Spende an die Entwickler</li>
|
||||
</ul>
|
||||
</p>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<h4>Links</h4>
|
||||
<p class="lead">
|
||||
<ul class="lead">
|
||||
<li><a href="https://github.com/lumapu/ahoy" target="_blank">Github Repository</a></li>
|
||||
<li><a href="https://discord.gg/WzhxEY62mB" target="_blank">Discord Server</a></li>
|
||||
<li><a href="https://paypal.me/lupusch" target="_blank">Donation</a></li>
|
||||
</ul>
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
|
@ -1,39 +0,0 @@
|
|||
---
|
||||
title: "Getting Started"
|
||||
date: 2022-10-26T21:27:10Z
|
||||
tags: []
|
||||
draft: false
|
||||
---
|
||||
|
||||
## Hardware
|
||||
|
||||
The hardware insists only in two modules:
|
||||
* ESP8266 / ESP32 Wifi module
|
||||
* NRF24L01+ module
|
||||
|
||||
### Part list
|
||||
|
||||
| Component | ~ Price (including shipment) |
|
||||
|-----------------|------------------------------|
|
||||
| ESP8266 | 4,55 € |
|
||||
| NRF24L01+ | 5,65 € |
|
||||
| Dunpont Cables | 2,65 € |
|
||||
| 100uF Capacitor | 2,89 € |
|
||||
| | |
|
||||
| Sum | 15,74 € |
|
||||
|
||||
|
||||
### Connection diagram
|
||||
|
||||
## Software / Firmware
|
||||
|
||||
### Guided Installation
|
||||
Switch to our [Online Installer](/flash)
|
||||
|
||||
### manual Installation
|
||||
The firmware can be found on [Github](https://github.com/lumapu/ahoy). Point to the releases section on the right part of the page and download the zip-file. It contains binaries for both ESP models.
|
||||
|
||||
### Compile firmware from sources
|
||||
n/a
|
||||
|
||||
### Flash
|
||||
47
content/imprint.html
Normal file
47
content/imprint.html
Normal file
|
|
@ -0,0 +1,47 @@
|
|||
---
|
||||
title: "Impressum"
|
||||
date: 2022-10-26T22:49:15Z
|
||||
tags: []
|
||||
draft: false
|
||||
---
|
||||
|
||||
|
||||
<div class="container col-xxl-8 px-4 py-5">
|
||||
<h1 class="display-5 fw-bold lh-1 mb-2 pt-5">Impressum</h1>
|
||||
<div class="row flex-lg-row g-5 pb-5">
|
||||
<div class="col-lg-6">
|
||||
<h4>Kontakt</h4>
|
||||
<p class="lead">
|
||||
<ul class="lead">
|
||||
<li>E-Mail: contact@ahoydtu.de</li>
|
||||
<li>Probleme melden: <a href="https://github.com/lumapu/ahoy/issues" target="_blank"> Github Issues</a></li>
|
||||
</ul>
|
||||
</p>
|
||||
<h4>Haftung für Inhalte</h4>
|
||||
<p class="lead">
|
||||
Die Inhalte unserer Seiten wurden mit größter Sorgfalt erstellt. Für die Richtigkeit, Vollständigkeit und Aktualität der Inhalte wird jedoch keine Gewähr übernehmen.
|
||||
</p>
|
||||
<h4>Urheberrecht</h4>
|
||||
<p class="lead">
|
||||
Alle Inhalte dieser Website, sofern auf nicht auf der jeweiligen Seite anders ausgezeichnet, unterliegen der CC BY-NC-SA 4.0
|
||||
</p>
|
||||
</div>
|
||||
<div class="col-10 col-sm-8 col-lg-6">
|
||||
<h4>Datenschutz</h4>
|
||||
<p class="lead">
|
||||
Die Nutzung dieser Webseite ist ohne Angabe personenbezogener Daten möglich.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Diese Website wird auf <a href="https://github.com/lumapu/ahoy/tree/gh-pages-src" target="_blank">GitHub</a> gehostet, es gelten die entsprechenden Richtlinien von GitHub.
|
||||
</p>
|
||||
|
||||
<h4>Cookies</h4>
|
||||
<p class="lead">
|
||||
Die Nutzung dieser Webseite ist ohne Angabe personenbezogener Daten möglich.
|
||||
</p>
|
||||
<p class="lead">
|
||||
Diese Website benutzt keine Cookies.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
---
|
||||
title: "Impressum"
|
||||
date: 2022-10-26T22:49:15Z
|
||||
tags: []
|
||||
draft: false
|
||||
---
|
||||
|
||||
### Kontakt
|
||||
* E-Mail: contact@ahoydtu.de
|
||||
* Probleme melden: [Github Issues](https://github.com/lumapu/ahoy/issues)
|
||||
|
||||
### Haftung für Inhalte
|
||||
Die Inhalte unserer Seiten wurden mit größter Sorgfalt erstellt. Für die Richtigkeit, Vollständigkeit und Aktualität der Inhalte wird jedoch keine Gewähr übernehmen.
|
||||
|
||||
### Urheberrecht
|
||||
Alle Inhalte dieser Website, sofern auf nicht auf der jeweiligen Seite anders ausgezeichnet, unterliegen der CC BY-NC-SA 4.0
|
||||
|
||||
### Datenschutz
|
||||
Die Nutzung dieser Webseite ist ohne Angabe personenbezogener Daten möglich.
|
||||
|
||||
Diese Website wird auf [GitHub](https://github.com/lumapu/ahoy/tree/gh-pages-src) gehostet, es gelten die entsprechenden Richtlinien von GitHub
|
||||
|
||||
### Cookies
|
||||
|
||||
Diese Website benutzt keine Cookies.
|
||||
Loading…
Add table
Add a link
Reference in a new issue