Merge pull request #68 from RoboticsBrno/Robutek-docs

Robutek docs
RoboticsBrno · Jul 11, 2024 · bbde3a4 · bbde3a4
2 parents be809d9 + f1d6512
commit bbde3a4
Show file tree

Hide file tree

Showing 21 changed files with 104 additions and 5 deletions.
diff --git a/docs/robot/docs/assets/add-wifi-network.png b/docs/robot/docs/assets/add-wifi-network.png
diff --git a/docs/robot/docs/assets/config-wifi-btn.png b/docs/robot/docs/assets/config-wifi-btn.png
diff --git a/docs/robot/docs/assets/disable-wifi.png b/docs/robot/docs/assets/disable-wifi.png
diff --git a/docs/robot/docs/assets/display-wifi-config.png b/docs/robot/docs/assets/display-wifi-config.png
diff --git a/docs/robot/docs/assets/input-ip.png b/docs/robot/docs/assets/input-ip.png
diff --git a/docs/robot/docs/assets/input-password.png b/docs/robot/docs/assets/input-password.png
diff --git a/docs/robot/docs/assets/input-ssid.png b/docs/robot/docs/assets/input-ssid.png
diff --git a/docs/robot/docs/assets/ip-address.png b/docs/robot/docs/assets/ip-address.png
diff --git a/docs/robot/docs/assets/open-port.png b/docs/robot/docs/assets/open-port.png
diff --git a/docs/robot/docs/assets/select-socket.png b/docs/robot/docs/assets/select-socket.png
diff --git a/docs/robot/docs/assets/wifi-added.png b/docs/robot/docs/assets/wifi-added.png
diff --git a/docs/robot/docs/assets/wifi-ap-mode.png b/docs/robot/docs/assets/wifi-ap-mode.png
diff --git a/docs/robot/docs/assets/wifi-station-mode.png b/docs/robot/docs/assets/wifi-station-mode.png
diff --git a/docs/robot/docs/index.md b/docs/robot/docs/index.md
@@ -0,0 +1,3 @@
+# Docs - Robůtek
+
+V této sekci najdete dokumentaci k programování a ovládáni Robůtka a jeho částí.
diff --git a/docs/robot/motors/index.md → docs/robot/docs/motors.md b/docs/robot/motors/index.md → docs/robot/docs/motors.md
diff --git a/docs/robot/sens/index.md → docs/robot/docs/sens.md b/docs/robot/sens/index.md → docs/robot/docs/sens.md
diff --git a/docs/robot/sim/index.md → docs/robot/docs/sim.md b/docs/robot/sim/index.md → docs/robot/docs/sim.md
@@ -7,7 +7,7 @@ ze stolu, nebo pokreslili něco co nemáte.
 
 Při otevření odkazu vás uvítá následující obrazovka:
 
-	![](assets/sim.png)
+![](assets/sim.png)
 
 Vidíte zde hlavní okno s želvičkou (která reprezentuje našeho robůtka), programovací okno,
 a textové okno na výstup našich programů.

diff --git a/docs/robot/docs/socket.md b/docs/robot/docs/socket.md
@@ -0,0 +1,18 @@
+# Docs - Bezdrátové programování
+
+Robůtka můžeme monitoroovat a programovat bezdrátově.
+
+## Připojení k Robůtkovi
+
+1. Klikneme na tlačítko vybírání portu (někdy zůstane předvyplněný z minula)<br>
+![](assets/open-port.png) <br>
+
+2. Vybereme `Socket` (úplně dole)<br>
+![](assets/select-socket.png) <br>
+
+3. Zadáme IP adresu ([získání IP adresy](../wifi/#zjištení-ip-adresy)) <br>
+![](assets/input-ip.png) <br>
+
+4. Poté můžeme bezdrátově programovat jako kdyby byl Robůtek připojený kabelem.
+
+    !!! warning "Někdy bůže nastat chyba. Pokud nastane, stačí zmáčknout `Ctrl+C` a zkusit to znovu."
diff --git a/docs/robot/vl53/index.md → docs/robot/docs/vl53.md b/docs/robot/vl53/index.md → docs/robot/docs/vl53.md
diff --git a/docs/robot/docs/wifi.md b/docs/robot/docs/wifi.md
@@ -0,0 +1,74 @@
+# Docs - WiFi
+
+K Robůtkovi se můžeme připojit i bezdrátově pomocí WiFi. K tomu ale potřebujeme aby se Robůtek buď [připojil k existující síti](#pripojeni-k-existujici-siti) nebo [vytvořil novou síť](#vytvoreni-nove-site).
+
+## Připojení k existující síti
+
+1. Klikneme na tlačítko `Config WiFi` na dolní liště. Zde budeme dělat všechno nastavení WiFi. <br>
+![](assets/config-wifi-btn.png) <br>
+
+2. Vybereme možnost `Add WiFi network`.
+![](assets/add-wifi-network.png) <br>
+
+3. A zadáme název sítě (SSID)
+![](assets/input-ssid.png) <br>
+
+    !!! note "Co dělat když název sítě má v sobě mezeru"
+        - Pokud název sítě má v sobě mezeru, musíme ho vložit do uvozovek, například `"Hele mezera"`.
+
+4. Dole v terminále se nám zobrazí místo na zadání hesla.
+![](assets/input-password.png) <br>
+
+5. Po zadání hesla be se nám zobrazí správa že vše proběhlo v pořádku.
+![](assets/wifi-added.png) <br>
+
+6. Poté musíme znovu kliknout na tlačítko `Config WiFi` a vybrat možnost `Set WiFI to Station mode (connect to WiFi)`.
+![](assets/wifi-station-mode.png) <br>
+
+## Vytvoření nové sítě
+
+1. Klikneme na tlačítko `Config WiFi` na dolní liště. Zde budeme dělat všechno nastavení WiFi. <br>
+![](assets/config-wifi-btn.png) <br>
+
+2. Vybereme možnost `Set WiFi to AP mode (create a hotspot)`.
+![](assets/add-wifi-network.png) <br>
+
+3. A zadáme název sítě (SSID)
+![](assets/input-ssid.png) <br>
+
+    !!! note "Co dělat když název sítě má v sobě mezeru"
+        - Pokud název sítě má v sobě mezeru, musíme ho vložit do uvozovek, například `"Hele mezera"`.
+
+4. Dole v terminále se nám zobrazí místo na zadání hesla.
+![](assets/input-password.png) <br>
+
+## Vypnutí WiFi
+
+1. Klikneme na tlačítko `Config WiFi` na dolní liště. <br>
+![](assets/config-wifi-btn.png) <br>
+
+2. Vybereme možnost `Disable WiFi`.
+![](assets/disable-wifi.png) <br>
+
+## Zjištení IP adresy
+
+1. Klikneme na tlačítko `Config WiFi` na dolní liště. <br>
+![](assets/config-wifi-btn.png) <br>
+
+2.  Vybereme možnost `Display current WiFI config`.<br>
+![](assets/display-wifi-config.png) <br>
+
+3. A v terminále se zobrazí IP adresa (Nějakou dobu trvá než se Robůtek připojí k sítí, takže je možné že to bude chvíly trvat) <br>
+![](assets/ip-address.png) <br>
+
+Nebo v kódu můžete získat IP adresu pomocí funkce `currentIp()`:
+
+```ts
+import * as wifi from "wifi";
+
+console.log(wifi.currentIp())
+```
+
+## Připojení k síti
+
+1.
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -148,11 +148,15 @@ nav:
       - robot/lekce9/index.md
       - robot/project_sumo/index.md
       - robot/project_maze/index.md
-      - robot/motors/index.md
-      - robot/sens/index.md
-      - robot/sim/index.md
-      - robot/vl53/index.md
   - Příslušenství robota:
       - robotAccessories/ledStrip.md
       - robotAccessories/button.md
       - robotAccessories/tof.md
+  - Dokumentace:
+      - robot/docs/index.md
+      - robot/docs/wifi.md
+      - robot/docs/socket.md
+      - robot/docs/motors.md
+      - robot/docs/sens.md
+      - robot/docs/sim.md
+      - robot/docs/vl53.md
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		# Docs - Robůtek

		V této sekci najdete dokumentaci k programování a ovládáni Robůtka a jeho částí.