---
title: "Getting Started"
date: 2022-11-05T21: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 ein Kondensator nahe am Funkmodul empfohlen. 
            </p>
            <p class="lead">
                Der Gesamtpreis spiegelt wider was eine Hardware für Ahoy kosten darf. Auf gängigen Plattformen (z.B. ebay Kleinanzeigen) wird diese zu völlig überzogenen Preisen angeboten, also besser selbst zusammenbauen.
            </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/module/funk/nrf24l01/" 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 (ohne Versand)</th>
                        <td>-</td>
                        <th>7,85 €</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/>
                Für die Stabilität ist es wichtig, einen 100uF (oder größeren) Kondensator an das NRF24 Modul anzubinden, 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 class="alert alert-primary" role="alert">
                <strong>Hinweis: </strong>Es kann auch zuerst der ESP geflasht werden, dann hängen noch nicht so viele Kabel dran.
            </div>
        </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.
            </p>
            <p class="lead" >
                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.<br/>
                Beim ESP32 ist es notwendig den BOOT-Button gedrückt zu halten während man kurz den EN-Button drückt (um in den Bootloader zu kommen). Danach kann der BOOT-Button wieder losgelassen werden und der Flashvorgang gestartet 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>
            <p class="lead">
                Alternativ kann auch die aktuelle Entwicklerversion heruntergeladen werden: <a href="https://nightly.link/lumapu/ahoy/workflows/compile_development/development03/ahoydtu_dev.zip" target="_blank">latest Development Build</a> (das zip enthält auch WebTools um die Version zu installieren)<br/>
                (Die Entwicklerversion kann uU. instabil sein oder Fehler enthalten!)
            </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">Ahoy Einrichten</h1>
    <div class="row flex-lg-row g-5 pb-5">
        <div class="col-lg-6">
            <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.4.1" target="_blank">http://192.168.4.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, ist es erforderlich, dass er sich mit dem heimischen WLAN verbindet.
            </p>
            <p class="lead">
                Hierzu muss in die Einstellungen navigiert werden, dies geschieht über den Menüpunkt <a href="http://192.168.4.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.
            </p>
            <p class="lead">
                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 Wechselrichter 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 Seriennummer eingeben.
            </p>
            <p class="lead">
                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.
            </p>
            <p class="lead">
                Die <i>Modul 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ötigt 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 Wechselrichter ü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 ein Smarthome (ioBroker, Homeassistant, etc.) 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 Nachtabschaltung konfiguriert werden. Hierzu sind die Geokoordinaten 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 besteht die Community von Ahoy schon aus ca. 1000 Leuten, jeder ist herzlich willkommen.
            </p>
            <p class="lead">
                Es gibt verschiedene Themen, welche 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>