.. _gettingStarted_wifi:

WLAN-Verbindung herstellen
##########################

Schritt für Schritt - macOS
---------------------------
1. SD-Karte aus dem Raspberry Pi bzw. Roboter entnehmen.
2. Einstecken der SD-Karte in den Computer
3. Öffnen der SD-Karte mit dem Namen "boot" |bootImage|
4. Generieren des PSK auf `https://www.wireshark.org/tools/wpa-psk.html <https://www.wireshark.org/tools/wpa-psk.html>`_ |pskImage|
5. Öffnen der Datei "wpa_supplicant.conf" auf der SD-Karte
6. Einfügen der Konfiguration. Dabei muss die SSID und der vorher generierte PSK eingesetzt werden ::
    
    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
    update_config=1
    country=AT

    network={
        ssid="EinTollerNameFürDasWlan"
        psk="98117b165a48f25cbe36f288ddf597729a40feeea93054c19bfa8e5eab238541"
    }

7. Speichern, Auswerfen und wieder in den Raspberry Pi einbauen
8. Starten des Roboters
9. Die IP-Adresse sollte nun am Roboter angezeigt werden

.. |bootImage| image:: images/01_boot.png
.. |pskImage| image:: images/02_psk.png

Weitere Informationen
---------------------
Die "wpa_supplicant.conf" Datei wird beim Start des Rpasberry Pi automatisch an den richtigen Ort kopiert, damit sich der Roboter zum Wlan verbindet.
Eine genauere Anleitung wird vom Hersteller des Raspberry Pi `hier <https://www.raspberrypi.com/documentation/computers/configuration.html#configuring-networking-2>`_ bereitgestellt.

Windows......
-------------
Je nach Betriebssystem und Editor, mit dem Sie die Datei erstellen, könnte die Datei falsche Zeilenumbrüche oder eine falsche Dateierweiterung haben; stellen Sie also sicher, dass Sie einen Editor verwenden, der dies berücksichtigt. Linux erwartet das Zeilenumbruchzeichen LF (Line Feed).
Beispielsweise kann `Notepad++ <https://notepad-plus-plus.org/downloads/>`_ verwendet werden, um die Datei richtig zu speichern.
|notepadImage|

.. |notepadImage| image:: images/08_notepad.png


Fehlerbehandlung
----------------
Sollte es dazu kommen, dass der Roboter nicht automatisch die Verbindung mit dem Netzwerk herstellt, kann eine Kabelgebundene Verbindung zur Diagnose von Fehlern genutzt werden.
Dabei wird automatisch die IP-Adresse der Verbindung "eth" am Roboter angezeigt. Nach der erfolgreichen Verbindung zum Roboter mittels SSH kann die "wpa_cli" zur Fehlerbehandlung verwendet werden:
::
    
    > wpa_cli
        wpa_cli v2.9
        Copyright (c) 2004-2019, Jouni Malinen <j@w1.fi> and contributors

        This software may be distributed under the terms of the BSD license.
        See README for more details.


        Selected interface 'p2p-dev-wlan0'

        Interactive mode

    > interface wlan0
        Connected to interface 'wlan0.
    > scan
        OK
        <3>CTRL-EVENT-SCAN-STARTED
        <3>CTRL-EVENT-SCAN-RESULTS
    > scan_result
        bssid / frequency / signal level / flags / ssid
        68:02:b8:0c:d7:47	2462	-66	[WPA2-PSK-CCMP][ESS]	WG
        68:02:b8:0c:d7:40	5220	-63	[WPA2-PSK-CCMP][ESS]	WG
        34:2c:c4:da:dd:b9	5200	-65	[WPA-PSK-TKIP][WPA2-PSK-CCMP][WPS][ESS]	WLAN10573403
        98:da:c4:e5:21:d0	2437	-57	[WPA2-PSK-CCMP][ESS]	WG
        34:2c:c4:da:dd:c6	2412	-52	[WPA-PSK-][WPA2-PSK-CCMP+TKIP][WPS][ESS]	WLAN10573403
        20:83:f8:07:5b:90	2467	-67	[WPA2-PSK-CCMP][WPS][ESS]	A1-075b8c
        7c:39:53:94:49:82	5280	-77	[WPA2-PSK-CCMP][WPS][ESS]	A1-944980-5G
        7c:39:53:94:49:81	2427	-68	[WPA2-PSK-CCMP][WPS][ESS]	A1-944980
        90:fd:73:ac:d3:27	2452	-72	[WPA2-PSK-CCMP][WPS][ESS]	Drei_H288A_24G_eKy5
        50:e0:39:3c:e5:80	5180	-82	[WPA2-PSK-CCMP][WPS][ESS]	A1-393CE57F
        90:fd:73:ac:d3:28	5500	-83	[WPA2-PSK-CCMP][WPS][ESS]	Drei_H288A_5G_eKy5
        68:02:b8:41:42:f9	5180	-84	[WPA-PSK-TKIP][WPA2-PSK-CCMP][WPS][ESS]	WLAN18792472
        34:2c:c4:30:3c:65	5180	-89	[WPA-PSK-TKIP][WPA2-PSK-CCMP][WPS][ESS]	witt
        fa:0d:ac:d3:40:d4	2467	-80	[WPA2-PSK-CCMP][WPS][ESS][P2P]	DIRECT-d4-HP M28 LaserJet
        0e:84:dc:14:ac:27	2467	-85	[WPA2-PSK-CCMP][WPS][ESS][P2P]	DIRECT-wo-BRAVIA
    >