Skip to content

Commit

Permalink
Updated documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
oe1wkl committed May 11, 2020
1 parent 132fea4 commit 16174c9
Show file tree
Hide file tree
Showing 7 changed files with 132 additions and 23 deletions.
Binary file modified .DS_Store
Binary file not shown.
10 changes: 6 additions & 4 deletions Documentation/User Manual/Version 3.x/m32_user-Manual_v3.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -571,9 +571,11 @@ Should you require a LoRa frequency either around 868 MHz or around 920 MHz, the

==== Wifi Trx [[wifitrx]]

You can use this transceiver mode to communicate with your CW buddy using the Internet protocol, either on your local area network, or across the Internet. On your local network it is very easy: just select this transceiver mode form the menu, and you will be able to communicate (without configuring anything it will send to the IP address 255.255.255.255, which is a broadcast address and will be received by all devices on this network). The Morserino-32 uses UDP port 7373 for asynchronous communication.
You can use this transceiver mode to communicate with your CW buddy using the Internet protocol, either on your local area network, or across the Internet. As it uses WiFi, you need to make sure you can connected to WiFi - so you must have performed the function "WiFi Config" before. On your local network it is very easy to use this transceiver mode: just select it from the menu, and you will be able to communicate (without configuring a peer address it will send to the IP address 255.255.255.255, which is a broadcast address and can be received by all devices on this network). The Morserino-32 uses UDP port 7373 for asynchronous communication.

If you want to communciate with a specific Morserino-32 over the Internet, you need to configure the IP address of your buddy - this is done through the menu item 'Config WiFi', which shows now a third field beyond SSID and Password. In this field you need to enter the IP address of your peer, and then the Wifi Transceiver will send the packets to that specific IP address.
When you start Wifi Trx, the IP address of your peer (or "IP Broadcast") will be shown for a moment on the display.

If you want to communciate with a specific Morserino-32 over the Internet, you need to configure the IP address of your buddy - this is done through the menu item 'Config WiFi', which shows now a third field beyond SSID and Password. In this field you need to enter the IP address of your peer (or its DNS host name), and then the Wifi Transceiver will send the packets to that specific IP address.

If that IP address is not on your local network, and if you are behind some form of firewall or a router that treats your network as a private network, the Morserino will be able to send out to the Internet (unless specific firewall rules are blocking most UDP ports), but the packets coming from your buddy will be blocked at the router. In this case you need to configure "Port Forwarding", telling the router to send all UDP packets on port 7373 to your Morserino. At the same time, you need to tell your buddy your OUTSIDE IP address (i.e. the IP address of your router interface to your Internet provider), and your buddy has to do the same (configure port forwarding, and telling you his Internet-facing IP address, which you will enter into your Morserino). Sounds a bit complicated at first, but isn't really that bad.

Expand Down Expand Up @@ -634,14 +636,14 @@ The device will start WiFi as an *access point*, thus creating its own WiFi Netw

Once you are connected, enter "http://m32.local" into your browser on your computer. If your computer or smartphone does not support mDNS (Android, for example, is not supporting it, and Windows only rudimentary), you have to enter the IP address **192.168.4.1** into the browser instead of m32.local. You will then see a little form with just 3 empty fields in your browser: "SSID of WiFi network?", "WiFi Password?" and "WiFi TRX Peer IP?". Enter the name of your local WiFi network, and the corresponding password (you can leave the third field empty for now), and click on the "Submit" button. Your Morserino-32 will store these network credentials and then restart itself (so the network "morserino" will disappear).

The third field ("WiFi TRX Peer IP?") is used, when you want to uset Wifi Transceiver functionality, i.e. to talk to another Morserino user over the Internet. In such a case you have to enter the IP address of the other Morserino into this field. See section <<wifitrx>> above. If you communciate with other Morserinos in your local network, you don`t need an IP address there (it will use the broadcast address by default, so all Morserinos will receive what one of them sends).
The third field ("WiFi TRX Peer IP/Host?") is used, when you want to use the Wifi Transceiver functionality, i.e. to talk to another Morserino user over the Internet. In such a case you have to enter the IP address or the DNS host name, if it has any, of the other Morserino into this field. See section <<wifitrx>> above. If you communicate with other Morserinos in your local network, you don't need an IP address there (it will use the broadcast address by default, so all Morserinos can receive what one of them sends).

IMPORTANT: Your Morserino cannot make use of a WiFi network with a "captive portal", as they are often used on public networks. These networks require that a browser is available on the device that wants to connect to the network, and the Morserino-32 does not have a browser...

IMPORTANT: Your Morserino-32 only supports WiFi networks in the 2.4 GHz band, not in the 5 GHz band. It also sometimes seems to have problems with Apple Airport routers.


TIP: If you have configured your WiFi before, and perform this step again, the previously entered SSID name will be pre-fileld in the form, and you only need to change it if necessary. The password field will be empty, but if you do not enter a new one, the old password will still be stored. The TRX Peer IP address field will also be pre-filled with a value if you have entered one before. If you now delete the values in this field, this IP address will be deleted.
TIP: If you have configured your WiFi before, and perform this step again, the previously entered SSID name will be pre-filled in the form, and you only need to change it if necessary. The password field will be empty, but if you do not enter a new one, the old password will still be stored. The TRX Peer IP address field will also be pre-filled with a value if you have entered one before. If you now delete the values in this field, this IP address will be deleted.

TIP: The network configuration will be stored in Snapshots, this means you can use snapshots to recall different network settings, if you frequently use the Morserino-32 in different network environments.

Expand Down
Binary file modified Documentation/User Manual/Version 3.x/m32_user-Manual_v3.pdf
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -566,9 +566,9 @@ Sollte man eine LoRa-Frequenz entweder um 868 MHz oder um 920 MHz benötigen, ka

==== Wifi Trx

Du kannst diesen Transceiver-Modus verwenden, um mit deinem CW-Freund über das Internetprotokoll zu kommunizieren, entweder in deinem lokalen Netzwerk oder über das Internet. In deinem lokalen Netzwerk ist dies sehr einfach: Wähle einfach diesen Transceiver-Modus aus dem Menü aus, und ihr könnt kommunizieren (ohne etwas zu konfigurieren, wird alles an die IP-Adresse 255.255.255.255 gesendet, das ist eine Broadcast-Adresse und wird von allen Geräten in diesem Netzwerk empfangen). Der Morserino-32 verwendet den UDP-Port 7373 für die asynchrone Kommunikation.
Du kannst diesen Transceiver-Modus verwenden, um mit deinem CW-Freund über das Internetprotokoll zu kommunizieren, entweder in deinem lokalen Netzwerk oder über das Internet. Da dazu das WLAN benutzt wird, musst du sicher stellen, dass du deinen Morserino mit deinem WLAN verbinden kannst - die Funktion "WiFi Config" muss als vorher einmal ausgeführt worden sein. In deinem lokalen Netzwerk ist die Benutzung dieses Transceiver Modus sehr einfach: Wähle ihn einfach aus dem Menü aus, und ihr könnt kommunizieren (ohne eine Peer IP Adresse zu konfigurieren, wird alles an die IP-Adresse 255.255.255.255 gesendet, das ist eine Broadcast-Adresse und kann von allen Geräten in diesem Netzwerk empfangen werden). Der Morserino-32 verwendet den UDP-Port 7373 für die asynchrone Kommunikation.

Wenn du über das Internet mit einem bestimmten Morserino-32 kommunizieren möchtest, musst du die IP-Adresse deines Freundes konfigurieren. Dies erfolgt über den Menüpunkt 'Config WiFi' (WLAN konfigurieren), in dem nun ein drittes Feld neben SSID und Passwort angezeigt wird. In dieses Feld muss man die IP-Adresse deines Partners eingeben. Anschließend sendet der Wifi-Transceiver die Pakete an diese bestimmte IP-Adresse.
Wenn du über das Internet mit einem bestimmten Morserino-32 kommunizieren möchtest, musst du die IP-Adresse deines Freundes konfigurieren. Dies erfolgt über den Menüpunkt 'Config WiFi' (WLAN konfigurieren), in dem nun ein drittes Feld neben SSID und Passwort angezeigt wird. In dieses Feld muss man die IP-Adresse deines Partners eingeben, oder, falls vorhanden, der DNS Hostname. Anschließend sendet der Wifi-Transceiver die Pakete an diese bestimmte IP-Adresse.

Wenn sich diese IP-Adresse nicht in deinem lokalen Netzwerk befindet und du dich hinter einer Firewall oder einem Router befindest, der dein Netzwerk als privates Netzwerk behandelt, kann der Morserino zwar an das Internet senden (es sei denn, bestimmte Firewall-Regeln blockieren die meisten UDP-Ports), aber die von deinem Buddy kommenden Pakete werden am Router blockiert. In diesem Fall musst du "Port Forwarding" konfigurieren und den Router anweisen, alle UDP-Pakete an Port 7373 deiness Morserino zu senden. Gleichzeitig musst du deinem Kumpel deine vom Internet sichtbare IP-Adresse (dh die IP-Adresse deiner Router-Schnittstelle zu deinem Internetprovider) mitteilen, und dein Kumpel muss dasselbe tun (Portweiterleitung konfigurieren und dir seine IP-Adresse, die vom Internet sichtbar ist, mitteilen, die du in deinen Morserino eingeben musst). Klingt zunächst etwas kompliziert, ist aber nicht so schlimm.

Expand Down Expand Up @@ -629,7 +629,7 @@ Das Gerät startet WLAN als **Access Point** und erstellt so ein eigenes WLAN-Ne

Sobald du mit dem WLAN "morserino" "verbunden bist, gib "http://m32.local" im Browser auf deinem Computer ein. Wenn dein Computer oder Smartphone mDNS nicht unterstützt (Android z.B. unterstützt es nicht, auch Windows nur mangelhaft), musst du die IP-Adresse **192.168.4.1** im Browser anstelle von m32.local eingeben. Es erscheint dann dann ein kleines Formular mit nur 3 leeren Feldern im Browser: "SSID of WiFi network?", "WiFi Password?" und "WiFi TRX Peer IP?". Gib nun den Namen deines lokalen WLAN-Netzwerks und das entsprechende Passwort ein (das dritte Feld kann leer bleiben) und klicke auf die Schaltfläche "Submit". Der Morserino-32 speichert diese Netzwerk-Anmeldeinformationen und startet sich dann neu (das Netzwerk "morserino" verschwindet dann wieder).

Das dritte Feld ("WiFi TRX Peer IP?") wird benutzt, um die Wifi Transceiver Funktionalität zu konfigurieren, dh. um mit einem anderen Morserino über das Internet zu kommunizieren. Mann muss dann in diesem Feld die IP aAdresse des Gegenübers eintragen. Falls man nur mit Morserinos im eigenen lokalen Netzwerk kommunizieren möchte, braucht man hier keine IP Adresse einzugeben (es wird dann die Broadcast Adresse benutzt, so dass alle Morserinos empfangen, was einer von ihnen sendet).
Das dritte Feld ("WiFi TRX Peer IP/Host?") wird benutzt, um die Wifi Transceiver Funktionalität zu konfigurieren, dh. um mit einem anderen Morserino über das Internet zu kommunizieren. Mann muss dann in diesem Feld die IP Adresse (oder, falls vorhanden, den DNS Hostnamen) des Gegenübers eintragen. Falls man nur mit Morserinos im eigenen lokalen Netzwerk kommunizieren möchte, braucht man hier keine IP Adresse einzugeben (es wird dann die Broadcast Adresse benutzt, so dass alle Morserinos empfangen können, was einer von ihnen sendet).

IMPORTANT: Morserino kann kein WiFi-Netzwerk mit einem "Captive Portal" nutzen, wie sie oft in öffentlichen Netzwerken verwendet werden. Diese Netzwerke erfordern, dass auf dem Gerät, das sich mit dem Netzwerk verbinden möchte, ein Browser verfügbar ist, und der Morserino-32 hat keinen solchen ...

Expand Down
Binary file modified Documentation/User Manual/Version 3.x/m32_user-Manual_v3_de.pdf
Binary file not shown.
Loading

0 comments on commit 16174c9

Please sign in to comment.