Anleitung
=========



Um das Auto "startklar" zu bekommen, findet sich hier die :download:`Aufbauanleitung <_static/startacus_assembly_instructions.pdf>`. Zusätzlich wird folgendes Software-Paket benötigt:
:download:`Software_Paket <_static/startacus_software.zip>` 

Das vollständige Paket, mit dem auch das Auto über eine Website ferngesteuert werden kann, findet sich hier: :download:`Software_Paket <_static/startacus_software_full.zip>` 

Anleitung Fernbedienung:

1. Das Auto macht einen WLAN-Hotspot auf, auf den sich das Handy verbinden kann. Der Name kann in der Datei ``config.h`` geändert werden.
2. Handy mit Hotspot verbinden
3. Im Browser die IP-Adresse ``192.168.1.1`` eingeben`


Zusätzlich wird Visual Studio Code und GIT benötigt.

VS-Code
-------

1.  Visual Studio Code von der offiziellen Website herunterladen: https://code.visualstudio.com/
2.  Visual Studio Code installieren. Es wird empfohlen, die Option "mit Code öffnen" zu aktivieren.

GIT
---
1. GIT von der offiziellen Website herunterladen: https://git-scm.com/
2. Kann mit den Standardeinstellungen installiert werden.


Projektinitialisierung
----------------------

1. zip entpacken und Ordner mit VS-Code öffnen
2. Ordner kann entweder über "Datei" -> "Ordner öffnen" oder im Datei-Explorer über "Rechtsklick" -> "Mit Code öffnen" geöffnet werden
3. In VS-Code wird unten rechts eine Meldung angezeigt, dass PlatformIO installiert werden muss -> auf "Install" klicken
4. Es erscheint die Meldung, dass VS-Code neu gestartet werden muss -> neu starten
5. Es werden einige Bibliotheken installiert, dies kann einige Zeit in Anspruch nehmen
6. Die Datei ``main.cpp`` unter ``src`` öffnen und unten rechts auf den Haken klicken (PlatformIO: Build), um die Software zu kompilieren
7. Code wurde erfolgreich kompiliert, wenn keine Fehlermeldung erscheint
8. Um den Code auf den Mikrocontroller zu laden, muss dieser mit einem USB-Kabel an den Computer angeschlossen werden
9. Neben dem Haken auf den Pfeil (PlatformIO: Upload) klicken, um die Software auf den Mikrocontroller zu laden
10. Über den seriellen Monitor (Stecker-Symbol) kann die Ausgabe des Mikrocontrollers überwacht werden

Fehlerbehebung
--------------

Der richtige Port, um den Code auf den Mikrocontroller zu laden und den seriellen Monitor zu starten sollte automatisch ausgewählt werden. Ist das nicht der Fall, kann der Port manuell ausgewählt werden. Dazu auf das Symbol mit dem Stecker und "Auto" klicken, um den richtigen Port auszuwählen.

Sollte kein Port verfügbar sein, muss der Mikrocontroller in den Downloadmodus gesetzt werden. Dazu den Boot-Button (gekennzeichnet mit "0") gedrückt halten und den Reset-Button (gekennzeichnet mit "RST") kurz drücken. Anschließend sollte der Port verfügbar sein.
Es kann auch ein Neustart des Autos (Schalter oben) helfen, um den Port verfügbar zu machen.

Es wird empfohlen, den Port auf "Auto" zu lassen, selbst wenn der Mikrocontroller in den Downloadmodus versetzt wurde.

Wenn der Port verfügbar ist, kann der Code auf den Mikrocontroller geladen werden. 
Wenn der Mikrocontroller im Downloadmodus war, erscheint nach dem Hochladen des Codes folgende Fehlermeldung.

.. code-block:: none

   Leaving...
   WARNING: ESP32-S2FNR2 (revision v1.0) chip was placed into download mode using GPIO0.
   esptool.py can not exit the download mode over USB. To run the app, reset the chip manually.       
   To suppress this note, set --after option to 'no_reset'.
   *** [upload] Error 1


Diese kann ignoriert werden, da der Code trotzdem erfolgreich auf den Mikrocontroller geladen wurde. Um den Code zu starten, muss der Mikrocontroller manuell neu gestartet werden, indem der Reset-Button (RST) gedrückt wird.


.. image:: /_static/Schaltplan-1.png
   :alt: Schaltplan
   :scale: 30

|