diff --git a/docs/README.md b/docs/README.md index 996dc32..044a543 100644 --- a/docs/README.md +++ b/docs/README.md @@ -15,6 +15,14 @@ A tárgy összeállítása során olyan nemzetközileg is elismert egyetemek tananyagát vettük alapul, mint az MIT, ETH Zürich, TU München, Univerisity of Virginia vagy a Stanford University. A megfelelő licenc betarása mellett bizonyos tanangyag részeket át is vettünk, másokat inspirációként használtunk, [erről részletesen itt](https://github.com/sze-info/arj#acknowledgement) lehet olvasni. 2023-ban a tantárgy az ROS 2 Humble verzióját használja, ez a disztribúció 2027 májusáig támogatott. +A tantárgy teljesítése például következő autóipari / autonóm járműves cégeknél előnyt jelenthet (ABC sorrendben): + +- [AiMotive Kft.](https://aimotive.com/) **(Budapest)** +- [AVL Hungary Kft.](https://www.avl.com/en-hu/locations/avl-hungary-kft) **(Budapest, Érd, Kecskemét)** +- [Bosch: Robert Bosch Kft.](https://www.bosch.hu/karrier/) **(Budapest, Győr, Zalaegerszeg)** +- [Continental Autonomous Mobility Hungary Kft.](https://www.continental.com/hu-hu/vallalat/continental-vallalatok-magyarorszagon/am-hungary/) **(Budapest, Győr, Debrecen)** +- [Járműipari Kutatóközpont, SZE](https://jkk-web.sze.hu/szakmai-kompetenciak/autonom-kozlekedesi-rendszerek-kozpont/) **(Győr)** + {: .highlight } A tárgyban bemutatott ismeretekre alapozva diplomamunka, szakdolgozat, projektmunka, TDK dolgozat is készíthető, illetve van lehetőség a kötelező szakmai gyakorlat teljesítésére is. diff --git a/docs/_images/gitworkflow01.gif b/docs/_images/gitworkflow01.gif new file mode 100644 index 0000000..d5fe6d6 Binary files /dev/null and b/docs/_images/gitworkflow01.gif differ diff --git a/docs/bevezetes/linux.md b/docs/bevezetes/linux.md index 5f6b709..a1bb59f 100644 --- a/docs/bevezetes/linux.md +++ b/docs/bevezetes/linux.md @@ -1,6 +1,6 @@ --- layout: default -title: Linux +title: Linux, git parent: Bevezetés --- @@ -154,6 +154,12 @@ A megszokott `ctrl`+`v`, `ctrl`+`c` helyett itt a `ctrl`+`shift`+`v`, `ctrl`+`sh > > A legtöbb művelet VS code-dal elvégezhető terminál nélkül is. [Erről bővebben itt lehet olvasni](https://sze-info.github.io/arj/bevezetes/vscode.html). + +
+ +*Forrás*: [link](https://www.linkedin.com/posts/chaima-haj-taher-1093881ba_git-softwaredevelopment-workflow-activity-7177685446787751936-atW_) + + ## Szöveges fájlok - `wget`: webes tartalmak letöltése terminalból - `cat`: fájl tartalmának kiíratása diff --git a/docs/bevezetes/vscode.md b/docs/bevezetes/vscode.md index 0c28aa1..54f7340 100644 --- a/docs/bevezetes/vscode.md +++ b/docs/bevezetes/vscode.md @@ -1,6 +1,6 @@ --- layout: default -title: VS code IDE +title: VS code, git parent: Bevezetés --- diff --git a/docs/onallo/ros2git.md b/docs/onallo/ros2git.md index a382d03..8bbad8e 100644 --- a/docs/onallo/ros2git.md +++ b/docs/onallo/ros2git.md @@ -36,6 +36,10 @@ parent: Önálló feladatok - `git checkout -- .`: Minden nem staged (unstaged) változás elvetése lokálisan. VS code-ban kb ez a "discard all changes" parancs. (Újabb git verziókban a `git restore .` is hasonló módon működik.) - `git merge `: a jelenlegi branch-be mergeli a branch-t +
+ +*Forrás*: [link](https://www.linkedin.com/posts/chaima-haj-taher-1093881ba_git-softwaredevelopment-workflow-activity-7177685446787751936-atW_) + ## Terminológia - **Local repository**: a helyi munka repo, pl lokálisan a `~/ros2_ws/src/my_repo` diff --git a/docs/telepites/README.md b/docs/telepites/README.md index 11a94dd..3106b11 100644 --- a/docs/telepites/README.md +++ b/docs/telepites/README.md @@ -8,11 +8,17 @@ permalink: /telepites/ # Telepítés +{: .note-title } +> ROS 2 +> +> ROS 1 verziókat csak történelmi okokból tárgyalunk, a jelenlegi fejlesztésekhez a ROS 2-t ajánljuk. + `ROS 1` alapvetően Linux rendszereken támogatott, bár voltak próbálkozások más operációs rendszerekre is. Ezzel szemben az `ROS 2` már támogatja a natív Windows, Mac OS vagy egyéb Real-Time operációs rendszen történő futtatást. Tehát alapvetően négy lehetőség adott: -1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu) -2. WSL2, könnyűsúlyú Linux virtuális gép Windowsra -3. Virtuális gép Windowsra -4. Windows build + +1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu) ✅ [leírás](https://sze-info.github.io/arj/telepites/ubuntu.html) +2. Windows WSL2, könnyűsúlyú Linux virtuális gép ✅ [leírás](https://sze-info.github.io/arj/telepites/win10.html) +3. Virtuális gép Windowsra 🟠 +4. Windows build 🟠 Ebből a 4 lehetőségből az első kettőt ajánljuk, de telmészetesen a többi sem tiltott. A dual boot betekintést nyújt a Linux világba, ami egy mérnöknél hasznos tudást jelent manapság. Telepítésnél körültekintően kell eljárni, hiszen egy rossz beállítás adatvesztést okoz, így a biztonsági mentés is ajánlott. A WSL (Windows Subsystem for Linux) egy könnyűsúlyú kompatibilitási réteg Linux-alapú elemek futtatásához Windows 10, vagy Windows 11 alapú rendszereken. Ahogy a következő ábrán is látszik, a Linux kernel ugyanolyan egyszerűen érheti el a hardverelemeket (CPU, memória, GPU), mint a Windows kernel. Ehhez képest a virtuális gép (3. lehetőség) egy jóval lassabb , több absztrakciós réteget használó megoldás, annak ajánlott, akinek vagy nagyon modern, gyors gépe van, vagy már eleve telepített ilyen rendszereket. A natív Windows build (4. lehetőség) elvileg adott, de mivel a dokumenátió túlnyomó része Linuxra érhető el, így nagyon sok extra munkát fog jelenteni. @@ -42,7 +48,7 @@ Az első három opció szemléltetése: {: .warning } -> Az ROS melodic python 2.7-et támogat. +> Az ROS 1 melodic python 2.7-et támogat, ez nem ajánlott. # Ubuntu és Python diff --git a/docs/telepites/ros_humble.md b/docs/telepites/ros_humble.md index b3e2f5e..a7e45da 100644 --- a/docs/telepites/ros_humble.md +++ b/docs/telepites/ros_humble.md @@ -1,6 +1,6 @@ --- layout: default -title: ROS2 humble +title: ROS 2 humble parent: Telepítés --- @@ -19,13 +19,19 @@ parent: Telepítés -# ROS2 humble +# ROS 2 humble -Alapvetően négy lehetőség adott `ROS 2 Humble` telepítésére: -1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu 22.04) -2. WSL2, könnyűsúlyú Linux virtuális gép Windowsra -3. Virtuális gép Windowsra -4. Windows build +{: .note-title } +> Egyszerű telepítés +> +> A telepítés lépésről-lépésre is végrehajtható, de készítettünk egy [egyszerű shell script alapú telepítést](#otthoni--géptermi-telepítés) is. + +Ahogy abevezetőben írtuk, alapvetően négy lehetőség adott `ROS 2 Humble` telepítésére: + +1. Dual boot, Windows mellé telepített natív Linux (leginkább Ubuntu) ✅ [leírás](https://sze-info.github.io/arj/telepites/ubuntu.html) +2. Windows WSL2, könnyűsúlyú Linux virtuális gép ✅ [leírás](https://sze-info.github.io/arj/telepites/win10.html) +3. Virtuális gép Windowsra 🟠 +4. Windows build 🟠 Ebből a 4 lehetőségből az első kettőt ajánljuk, de telmészetesen a többi sem tiltott. A dual boot betekintést nyújt a Linux világba, ami egy mérnöknél hasznos tudást jelent manapság. Telepítésnél körültekintően kell eljárni, hiszen egy rossz beállítás adatvesztést okoz, így a biztonsági mentés is ajánlott. A WSL (Windows Subsystem for Linux) egy könnyűsúlyú kompatibilitási réteg Linux-alapú elemek futtatásához Windows 10, vagy Windows 11 alapú rendszereken. Ahogy a következő ábrán is látszik, a Linux kernel ugyanolyan egyszerűen érheti el a hardverelemeket (CPU, memória, GPU stb), mint a Windows kernel. Ehhez képest a virtuális gép (3. lehetőség) egy jóval lassabb, több absztrakciós réteget használó megoldás, annak ajánlott, akinek vagy nagyon modern, gyors gépe van, vagy már eleve telepített ilyen rendszereket. A natív Windows build (4. lehetőség) elvileg adott, de mivel a dokumenátió túlnyomó része Linuxra érhető el, így nagyon sok extra munkát fog jelenteni. @@ -150,7 +156,7 @@ Részletek: [docs.ros.org/en/humble/Tutorials/Beginner-Client-Libraries/Colcon-T # Otthoni / géptermi telepítés -Gépteremben a [következő `install_humble.sh`](https://github.com/sze-info/arj/blob/main/docs/telepites/install_humble.sh) fájlt futtatuk minden gépen. +Gépteremben a [következő `install_humble.sh`](https://github.com/sze-info/arj/blob/main/docs/telepites/install_humble.sh) fájlt (shell scriptet) futtatuk minden gépen. ``` bash wget https://raw.githubusercontent.com/sze-info/arj/main/docs/telepites/install_humble.sh diff --git a/docs/telepites/ros_melodic.md b/docs/telepites/ros_melodic.md deleted file mode 100644 index 9b78392..0000000 --- a/docs/telepites/ros_melodic.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -layout: default -title: ROS melodic -parent: Telepítés ---- - -# ROS melodic - -A következő lépések végrehajtásával az ROS Melodic változatát fogjuk telepíteni. - -{: .warning } -> Az ROS melodic 2023 júniusa óta **nem támogatott** (EOL - End of Life disztibúció). - -## Forrás megadása - -Adjuk hozzá a packages.ros.org helyet a telepítési források listájához: - -``` -sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list' -``` - -## Kulcs megadása - -Állítsuk be az ROS Melodic telepítéséhez szükséges kulcsot: - -``` -sudo apt install curl -curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add - -``` - -## Telepítés - -Frissítsük a Debian csomagokat: - -``` -sudo apt update -``` -A következő parancs a tényleges telepítést fogja indítani: -``` -sudo apt install ros-melodic-desktop-full -``` -A telepítést követően tegyük a basrc-be az ROS környezeti változóját: - -``` -echo "source /opt/ros/melodic/setup.bash" >> ~/.bashrc -source ~/.bashrc -``` - -Az ROS Melodic telepítését bemutató videó [itt](https://youtu.be/e-VjpK5mYOI) tekinthető meg: - - - -### Megjegyzés - -További, *hivatalos* információk a telepítéssel kapcsolatban elérhetőek itt: [wiki.ros.org/melodic/Installation/Ubuntu](http://wiki.ros.org/melodic/Installation/Ubuntu) \ No newline at end of file diff --git a/docs/telepites/ros_noetic.md b/docs/telepites/ros_noetic.md deleted file mode 100644 index 7be656c..0000000 --- a/docs/telepites/ros_noetic.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -layout: default -title: ROS noetic -parent: Telepítés ---- - -# ROS noetic - -{: .warning } -Az ROS noetic az utolsó `ROS 1` disztribúció. Miután elérte az EOL (End of Life) időpontját, csak `ROS 2`-es rendszerek maradnak aktív fejlesztés alatt. Éppen ezért a tantárgyban is csak `ROS 2`-t oktatunk. \ No newline at end of file diff --git a/docs/telepites/ubuntu.md b/docs/telepites/ubuntu.md new file mode 100644 index 0000000..3bfb82a --- /dev/null +++ b/docs/telepites/ubuntu.md @@ -0,0 +1,9 @@ +--- +layout: default +title: Ubuntu dual boot +parent: Telepítés +--- + +# Ubuntu dual boot + + \ No newline at end of file diff --git a/docs/telepites/win10.md b/docs/telepites/win10.md index ba56845..4ede47c 100644 --- a/docs/telepites/win10.md +++ b/docs/telepites/win10.md @@ -1,28 +1,37 @@ --- layout: default -title: Windows 10 WSL2 +title: Windows WSL2 parent: Telepítés --- -# Windows 10 WSL2 +# Windows WSL2 A **Windows Subsystem for Linux** egy kompatibilitási réteg Linux-alapú elemek natív futtatásához Windows 10, vagy Windows 11 alapú rendszereken. Akkor érdemes választani a WSL használatát, ha nem szeretnétek natív Ubuntu-t (pl 18.04 / 22.04) telepíteni a számítógépeitekre. +A WSL telepítését bemutató Windows 11-es videó (Windows 10 lejjebb, de nagyrészt ugyanez): + + + +A videó lépései szövegesen: + - Rendszergazdaként futtatva nyissatok egy PowerShell ablakot. - Másoljátok be az alábbi parancsot. Ezzel engedélyezitek a WSL használatát. -``` +``` bash Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux ``` -- Indítsátok újra a számítógépet az ```Y``` betű beírásával. +- Indítsátok újra a számítógépet az ```Y``` betű beírásával. *(opcionális)* - Nyissátok meg a Microsoft Store-t, és keressetek rá a Windows Subsystem for Linux Preview-ra. Telepítsétek. -- Szintén a Microsoft Store-ban keressetek rá az Ubuntu 22.04-re, és telepítsétek. +- Szintén a Microsoft Store-ban keressetek rá az Ubuntu 22.04-re, és telepítsétek, **vagy** PowerShell (Admin): +``` bash +wsl --install -d Ubuntu-22.04 +``` - A könnyebb kezelhetőség érdekében érdemes telepíteni a Windows Terminal programot is. Szintén a Microsoft Store-ban keressetek rá a Windows Terminal-ra, és telepítsétek. - Indítsátok el a Windows Terminal programot, és a Ctrl+, (Control és vessző) billentyűkombinációval nyissátok meg a beállításokat. A Default Profile beállítási sor legördülő listájából válasszátok az Ubuntu 22.04-et. - Indítsátok újra a Windows Terminal-t. Az első induláskor adjatok meg tetszőleges felhasználónevet és jelszót. - A megoldás kidolgozásához a VS Code szerkesztőt javasoljuk. Telepítsétek innen: [code.visualstudio.com/download](https://code.visualstudio.com/download) - Végül telepítsétek a VS Code Remote Development kiegészítőjét, hogy WSL használatával is elérhető legyen: [marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack) -A WSL telepítését bemutató videó [itt](https://youtu.be/S1U-f5pzO7s) érhető el: +A WSL telepítését bemutató Windows 10-es videó [itt](https://youtu.be/S1U-f5pzO7s) érhető el: diff --git a/docs/telepites/win11.md b/docs/telepites/win11.md deleted file mode 100644 index e98ac69..0000000 --- a/docs/telepites/win11.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -layout: default -title: Windows 11 WSL2 -parent: Telepítés ---- - -# Windows 11 WSL2 - -A **Windows Subsystem for Linux** egy kompatibilitási réteg Linux-alapú elemek natív futtatásához Windows 10, vagy Windows 11 alapú rendszereken. Akkor érdemes választani a WSL használatát, ha nem szeretnétek natív Ubuntu-t (pl 18.04 / 22.04) telepíteni a számítógépeitekre. - -[github.com/microsoft/wslg](https://github.com/microsoft/wslg){: .btn } - -Windows 11 WSL telepítése nagyon hasonlít a részletesebben leírt [Windows 10 WSL telepítéshez](https://sze-info.github.io/arj/telepites/win10.html). \ No newline at end of file