From eff014599bcf72ecc70e1c30472c5b06258fd44a Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Sat, 10 Oct 2026 21:05:37 +0100 Subject: [PATCH 01/13] Create downloads folder Used to store programs that can be downloaded directly from the website --- docs/media/downloads.gitkeep | 1 + 1 file changed, 1 insertion(+) create mode 100644 docs/media/downloads.gitkeep diff --git a/docs/media/downloads.gitkeep b/docs/media/downloads.gitkeep new file mode 100644 index 0000000..8b13789 --- /dev/null +++ b/docs/media/downloads.gitkeep @@ -0,0 +1 @@ + From 330be695f9c5873f37ab3ed7d541ff2fe0d97f4a Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Sat, 10 Oct 2026 21:11:57 +0100 Subject: [PATCH 02/13] Delete downloads.gitkeep Created this by mistake --- docs/media/downloads.gitkeep | 1 - 1 file changed, 1 deletion(-) delete mode 100644 docs/media/downloads.gitkeep diff --git a/docs/media/downloads.gitkeep b/docs/media/downloads.gitkeep deleted file mode 100644 index 8b13789..0000000 --- a/docs/media/downloads.gitkeep +++ /dev/null @@ -1 +0,0 @@ - From 94e3a5768f420473d4929e0a3744579d42e06c5b Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Sat, 10 Oct 2026 21:15:28 +0100 Subject: [PATCH 03/13] Create downloads folder -Created downloads folder to store programs that can be downloaded from the website -Added FormulaTrinitySetup.bat --- docs/media/downloads/FormulaTrinitySetup.bat | 583 +++++++++++++++++++ 1 file changed, 583 insertions(+) create mode 100644 docs/media/downloads/FormulaTrinitySetup.bat diff --git a/docs/media/downloads/FormulaTrinitySetup.bat b/docs/media/downloads/FormulaTrinitySetup.bat new file mode 100644 index 0000000..8e4849e --- /dev/null +++ b/docs/media/downloads/FormulaTrinitySetup.bat @@ -0,0 +1,583 @@ +@echo off +setlocal EnableExtensions EnableDelayedExpansion + +title Formula Trinity Autonomous Setup + +:: ============================================================ +:: Formula Trinity Windows / WSL Bootstrapper +:: +:: Target: +:: Windows 10/11 +:: WSL2 +:: Ubuntu 22.04 +:: +:: IMPORTANT: +:: - Existing FT installations are checked BEFORE anything +:: is downloaded or modified. +:: - Windows Administrator access is requested only when +:: WSL / Ubuntu needs to be installed. +:: HOW TO USE: +:: - Simply download, run the program and follow all the +:: instructions +:: +:: Please contact Muirinn if there are any issues +:: ============================================================ + + +:: ------------------------------------------------------------ +:: Configuration +:: ------------------------------------------------------------ + +set "DISTRO=Ubuntu-22.04" + +:: ------------------------------------------------------------ +:: Header +:: ------------------------------------------------------------ + +cls + +echo. +echo ============================================================ +echo FORMULA TRINITY AUTONOMOUS +echo SETUP INSTALLER +echo ============================================================ +echo. +echo This installer will check your computer before making +echo any changes. +echo. +echo If the Formula Trinity suiteis already installed, you will +echo be given the option to exit without modifying anything. +echo. +echo ============================================================ +echo. + + +:: ============================================================ +:: STEP 1 - Check WSL +:: ============================================================ + +echo [1/5] Checking WSL... +echo. + +where wsl.exe >nul + +if %errorlevel% neq 0 ( + + echo [INFO] WSL is not installed. + echo. + + goto :INSTALL_WSL +) + +echo [OK] WSL is available. + + +:: ============================================================ +:: STEP 2 - Check WSL configuration +:: ============================================================ + +echo. +echo [2/5] Checking WSL configuration... +echo. + +wsl --status >nul + +if %errorlevel% neq 0 ( + + echo [WARNING] WSL exists but does not appear to be + echo fully configured. + echo. + + goto :INSTALL_WSL +) + +echo [OK] WSL is configured. + + +:: ============================================================ +:: STEP 3 - Check Ubuntu 22.04 +:: ============================================================ + +echo. +echo [3/5] Checking for %DISTRO%... +echo. + +:: ------------------------------------------------------------ +:: Rather than parsing "wsl --list", directly ask WSL to run +:: a harmless command inside the requested distribution. +:: +:: This avoids encoding problems with the output of wsl -l. +:: Nothing is installed or modified by this test. +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- /bin/true >nul + +if %errorlevel% equ 0 ( + echo [OK] %DISTRO% is installed. + goto :UBUNTU_FOUND +) + +echo [INFO] %DISTRO% was not found. +echo. +echo Installed WSL distributions: +echo. +wsl.exe --list --verbose +echo. +echo The installer expected a distribution named: +echo. +echo %DISTRO% +echo. +echo If Ubuntu 22.04 appears above under a different name, +echo the installer should not install another copy. +echo. + +pause +goto :INSTALL_UBUNTU + + +:UBUNTU_FOUND +:: ============================================================ +:: STEP 4 - Check Ubuntu +:: ============================================================ + +echo. +echo [4/5] Checking Ubuntu Setup... +echo. + +set "CHECK_FILE=%TEMP%\ft_wsl_check_%RANDOM%.txt" + +wsl -d %DISTRO% -- bash -lc "printf 'FT_WSL_READY\n'" > "%CHECK_FILE%" + +findstr /C:"FT_WSL_READY" "%CHECK_FILE%" >nul + +if %errorlevel% neq 0 ( + + del "%CHECK_FILE%" >nul + + echo [WARNING] Ubuntu is installed but could not be + echo started normally. + echo. + echo Ubuntu may not have completed its first-time setup. + echo. + echo An Ubuntu terminal will now be opened. + echo. + echo If prompted, create your Linux username and password. + echo. + echo When finished, close Ubuntu and run this installer + echo again. + echo. + + pause + + start "" wsl.exe -d %DISTRO% + + exit /b 0 +) + +del "%CHECK_FILE%" >nul + +echo [OK] Ubuntu is ready. + +:: ============================================================ +:: STEP 5 - READ-ONLY Formula Trinity installation check +:: ============================================================ + +echo. +echo [5/5] Checking existing Formula Trinity suite installation... +echo. + +:: ------------------------------------------------------------ +:: IMPORTANT: +:: These checks are READ ONLY. +:: Nothing is downloaded, installed or modified. +:: +:: Each component is checked separately. This avoids complex +:: Bash commands being parsed incorrectly by Windows CMD. +:: ------------------------------------------------------------ + +set "ROS_OK=0" +set "REPO_OK=0" +set "WORKSPACE_OK=0" +set "EUFS_OK=0" +set "SYSTEM_OK=0" + + +:: ------------------------------------------------------------ +:: Check ROS2 Humble +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- test -f /opt/ros/humble/setup.bash >nul + +if not errorlevel 1 ( + set "ROS_OK=1" +) + +:: ------------------------------------------------------------ +:: Check FT-FSAI-Core repository +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- bash -c "test -d \"$HOME/ft/FT-FSAI-Core/.git\"" >nul + +if not errorlevel 1 ( + set "REPO_OK=1" +) + + +:: ------------------------------------------------------------ +:: Check built ROS workspace +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- bash -c "test -f \"$HOME/ft/install/setup.bash\"" >nul + +if not errorlevel 1 ( + set "WORKSPACE_OK=1" +) + +:: ------------------------------------------------------------ +:: Check EUFS package +:: +:: Only attempt this if ROS and the workspace exist. +:: ------------------------------------------------------------ + +if "!ROS_OK!"=="1" if "!WORKSPACE_OK!"=="1" ( + + wsl.exe -d %DISTRO% -- bash -c "source /opt/ros/humble/setup.bash && source \"$HOME/ft/install/setup.bash\" && ros2 pkg prefix eufs_launcher >/dev/null" + + if not errorlevel 1 ( + set "EUFS_OK=1" + ) +) + + +:: ------------------------------------------------------------ +:: Check ft_system package +:: ------------------------------------------------------------ + +if "!ROS_OK!"=="1" if "!WORKSPACE_OK!"=="1" ( + + wsl.exe -d %DISTRO% -- bash -c "source /opt/ros/humble/setup.bash && source \"$HOME/ft/install/setup.bash\" && ros2 pkg prefix ft_system >/dev/null" + + if not errorlevel 1 ( + set "SYSTEM_OK=1" + ) +) + +:: ------------------------------------------------------------ +:: Display results +:: ------------------------------------------------------------ + +echo. +echo Formula Trinity components: +echo. + +if "!ROS_OK!"=="1" ( + echo [OK] ROS2 Humble +) else ( + echo [MISSING] ROS2 Humble +) + +if "!REPO_OK!"=="1" ( + echo [OK] FT-FSAI-23 repository +) else ( + echo [MISSING] FT-FSAI-23 repository +) + +if "!WORKSPACE_OK!"=="1" ( + echo [OK] ROS workspace build +) else ( + echo [MISSING] ROS workspace build +) + +if "!EUFS_OK!"=="1" ( + echo [OK] EUFS +) else ( + echo [MISSING] EUFS +) + +if "!SYSTEM_OK!"=="1" ( + echo [OK] ft_system +) else ( + echo [MISSING] ft_system +) +echo. + +:: ============================================================ +:: Determine whether installation is complete +:: ============================================================ + +if "!ROS_OK!"=="1" if "!REPO_OK!"=="1" if "!WORKSPACE_OK!"=="1" if "!EUFS_OK!"=="1" if "!SYSTEM_OK!"=="1" ( + + goto :ALREADY_INSTALLED +) + + +:: ============================================================ +:: Installation incomplete +:: ============================================================ + +echo. +echo ============================================================ +echo INSTALLATION INCOMPLETE +echo ============================================================ +echo. +echo One or more Formula Trinity components are missing. +echo. +echo Unfortunatly there is an issue with git (windows 11 & WSL2) +echo so please follow these instructions for Windows 11 +echo https://www.freecodecamp.org/news/github-cli-wsl2-guide/ +echo to set up an SSH key and then clone the FT-FSAI-23 repo. +echo. +echo Follow these instructions if you have Windows 10 +echo https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent +echo. +echo How to clone FT-FSAI-Core repo +echo wsl +echo cd ~/ft +echo git clone --recurse-submodules git@github.com:FT-Autonomous/FT-FSAI-Core.git +echo +echo Options: +echo. +echo [1] FT-FSAI-Core is cloned and I am ready for the next step +echo [2] Exit without making changes + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :SAFE_EXIT +if errorlevel 1 goto :ASK_INSTALLER + +:ASK_INSTALLER +echo ============================================================ +echo INSTALLATION INCOMPLETE +echo ============================================================ +echo The setup process can run install.sh which will install +echo missing components of the suite. +echo. +echo No Formula Trinity files have been changed yet. +echo. +echo Options: +echo. +echo [1] Continue setup +echo [2] Exit without making changes +echo. + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :SAFE_EXIT +if errorlevel 1 goto :RUN_INSTALLER + + +:: ============================================================ +:: Already installed +:: ============================================================ + +:ALREADY_INSTALLED + +echo. +echo ============================================================ +echo FORMULA TRINITY SUITE IS ALREADY INSTALLED +echo ============================================================ +echo. +echo All checked components were found. +echo No files have been downloaded or modified. +echo. +echo Options: +echo. +echo [1] Exit +echo. +echo [2] Run install.sh anyway +echo. + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :RUN_INSTALLER +if errorlevel 1 goto :SAFE_EXIT + + +:: ============================================================ +:: Safe exit +:: ============================================================ + +:SAFE_EXIT + +echo. +echo ============================================================ +echo NO CHANGES MADE +echo ============================================================ +echo. +echo Formula Trinity setup has been cancelled. +echo. + +pause +exit /b 0 + + +:: ============================================================ +:: Run Linux installer +:: ============================================================ +:RUN_INSTALLER + +echo. +echo ============================================================ +echo FORMULA TRINITY SUITE +echo ============================================================ +echo The Formula Trinity install.sh script will now be run within +echo the wsl and it will download the Formula Trinity suite. +echo. + +:: uses Jakubs code assuming its in FT-FSAI-Core +wsl.exe -d Ubuntu-22.04 -- bash -c "cd ~/ft/FT-FSAI-Core && ls && bash setup.sh" + +:: ============================================================ +:: Installation successful +:: ============================================================ + +echo. +echo ============================================================ +echo FORMULA TRINITY SETUP COMPLETE +echo ============================================================ +echo. +echo Formula Trinity has been installed successfully. +echo. +echo ============================================================ +echo HOW TO RUN +echo ============================================================ +echo. +echo Open cmd and send the command wsl to open a Ubuntu terminal +echo. +echo Open 3 wsl terminals +echo Run the following command in them all +echo. +echo source ~/ft-wsl/environment.bash +echo. +echo Then enter the following commands in each terminal +echo Terminal 1: +echo ros2 launch eufs_launcher eufs_launcher.launch.py +echo. +echo Choose and launch a circuit in EUFS. Keep that terminal running. +echo. +echo Termial 2: +echo ros2 launch ft_launch system_sim.launch.py +echo. +echo Terminal 3, to select Autocross on a suitable circuit: +echo ros2 service call /ros_can/set_mission eufs_msgs/srv/SetCanState '{ami_state: 13}' +echo ros2 topic echo /ros_can/state --once +echo. +echo Autocross is mission 13; driving is AS state 2. This uses the simulator's +echo mission service rather than publishing a fake driving state. +echo. +echo ============================================================ +echo. + +pause +exit /b 0 + + + +:: ============================================================ +:: Install WSL +:: ============================================================ + +:INSTALL_WSL + +echo ============================================================ +echo WSL SETUP +echo ============================================================ +echo. +echo WSL needs to be installed or configured. +echo. +echo Windows Administrator privileges are required for this +echo Windows-level operation. +echo. +echo The Formula Trinity installer itself will NOT run as +echo Windows Administrator. +echo. +echo Options: +echo. +echo [1] Continue setup +echo [2] Exit without making changes +echo. + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :SAFE_EXIT +if errorlevel 1 goto :WSL_INSTALLER +echo. + +:WSL_INSTALLER +powershell -NoProfile -ExecutionPolicy Bypass ^ + -Command "Start-Process -FilePath 'wsl.exe' -ArgumentList '--install','-d','%DISTRO%' -Verb RunAs -Wait" + +if %errorlevel% neq 0 ( + + echo. + echo [ERROR] WSL installation did not complete successfully. + echo. + + pause + exit /b 1 +) + +:: ============================================================ +:: Install Ubuntu +:: ============================================================ + +:INSTALL_UBUNTU + +echo ============================================================ +echo UBUNTU SETUP +echo ============================================================ +echo. +echo %DISTRO% needs to be installed. +echo. +echo Windows may request Administrator privileges for this +echo operation. +echo. +echo Press any key to continue or close this window to cancel. +echo. +powershell wsl --install %DISTRO% + +if %errorlevel% neq 0 ( + + echo. + echo [ERROR] Ubuntu installation did not complete + echo successfully. + echo. + + pause + exit /b 1 +) + + +echo. +echo ============================================================ +echo UBUNTU INSTALLATION COMPLETE +echo ============================================================ +echo. +echo Ubuntu now needs its first-time setup. +echo. +echo Create your Linux username and password when prompted. +echo. +echo Once finished: +echo. +echo 1. Close Ubuntu +echo 2. Run this installer again +echo. + +pause + +start "" wsl.exe -d %DISTRO% + +exit /b 0 + +:: ============================================================ +:: FAIL +:: ============================================================ +:fail +echo. +echo ================================================================ +echo [FAILED] Formula Trinity setup did not complete. +echo ================================================================ +echo. +echo This window will remain open so you can read the error. +pause +exit /b 1 From a0517e0bf6f283095be5dc23e72687bbb6927819 Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Sat, 10 Oct 2026 21:19:36 +0100 Subject: [PATCH 04/13] Add windows 2026 setup --- docs/tutorials/Setup_2026.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/tutorials/Setup_2026.md diff --git a/docs/tutorials/Setup_2026.md b/docs/tutorials/Setup_2026.md new file mode 100644 index 0000000..4cbf4f5 --- /dev/null +++ b/docs/tutorials/Setup_2026.md @@ -0,0 +1,25 @@ +# Formula Trinity Windows Setup + +## HOW TO USE + +- Download [FormulaTrinitySetup.bat](/media/downloads/FormulaTrinitySetup.bat), run it, and follow the on-screen instructions. +- Please contact Muirinn if there are any issues. + +## Target + +- Windows 10/11 +- WSL2 +- Ubuntu 22.04 + +## Important + +- Existing Formula Trinity installations are checked **before anything is downloaded or modified**. +- Windows Administrator access is requested only when WSL or Ubuntu needs to be installed. + +## Git issue + +- There is currently a reported Git issue with Windows 11 and WSL2. Therefore, the `FT-FSAI-Core` repository is not cloned as part of setup and must be cloned manually partway through the setup process. +- An SSH key must be configured. See the following guides: + - [Windows 10: Git Credentials](https://docs.formulatrinity.ie/resources/git/) + - [Windows 11: GitHub CLI guide](https://www.freecodecamp.org/news/github-cli-wsl2-guide/) +- These steps are also described in the program instructions. From d923ede73cc2ed03bf86d45667117dc55563bf3f Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Sat, 10 Oct 2026 21:22:34 +0100 Subject: [PATCH 05/13] Fix link in Setup_2026.md --- docs/tutorials/Setup_2026.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/Setup_2026.md b/docs/tutorials/Setup_2026.md index 4cbf4f5..07807b3 100644 --- a/docs/tutorials/Setup_2026.md +++ b/docs/tutorials/Setup_2026.md @@ -2,7 +2,7 @@ ## HOW TO USE -- Download [FormulaTrinitySetup.bat](/media/downloads/FormulaTrinitySetup.bat), run it, and follow the on-screen instructions. +- Download [FormulaTrinitySetup.bat](../media/downloads/FormulaTrinitySetup.bat), run it, and follow the on-screen instructions. - Please contact Muirinn if there are any issues. ## Target From e86f14171fbfd5c7dff197a3870cfccb5c4b123a Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Mon, 12 Oct 2026 15:27:25 +0100 Subject: [PATCH 06/13] Put FormulaTrinitySetup.bat in the right media folder --- .../media/downloads/FormulaTrinitySetup.bat | 609 ++++++++++++++++++ 1 file changed, 609 insertions(+) create mode 100644 docs/tutorials/media/downloads/FormulaTrinitySetup.bat diff --git a/docs/tutorials/media/downloads/FormulaTrinitySetup.bat b/docs/tutorials/media/downloads/FormulaTrinitySetup.bat new file mode 100644 index 0000000..c95e567 --- /dev/null +++ b/docs/tutorials/media/downloads/FormulaTrinitySetup.bat @@ -0,0 +1,609 @@ +@echo off +setlocal EnableExtensions EnableDelayedExpansion + +title Formula Trinity Autonomous Setup + +:: ============================================================ +:: Formula Trinity Windows / WSL Bootstrapper +:: +:: Target: +:: Windows 10/11 +:: WSL2 +:: Ubuntu 22.04 +:: +:: IMPORTANT: +:: - Existing FT installations are checked BEFORE anything +:: is downloaded or modified. +:: - Windows Administrator access is requested only when +:: WSL / Ubuntu needs to be installed. +:: HOW TO USE: +:: - Simply download, run the program and follow all the +:: instructions +:: +:: Please contact Muirinn if there are any issues +:: ============================================================ + + +:: ------------------------------------------------------------ +:: Configuration +:: ------------------------------------------------------------ + +set "DISTRO=Ubuntu-22.04" + +:: ------------------------------------------------------------ +:: Header +:: ------------------------------------------------------------ + +cls + +echo. +echo ============================================================ +echo FORMULA TRINITY AUTONOMOUS +echo SETUP INSTALLER +echo ============================================================ +echo. +echo This installer will check your computer before making +echo any changes. +echo. +echo If the Formula Trinity suit is already installed, you will +echo be given the option to exit without modifying anything. +echo. +echo ============================================================ +echo. + + +:: ============================================================ +:: STEP 1 - Check WSL +:: ============================================================ + +echo [1/6] Checking WSL... +echo. + +where wsl.exe >nul + +if %errorlevel% neq 0 ( + + echo [INFO] WSL is not installed. + echo. + + goto :INSTALL_WSL +) + +echo [OK] WSL is available. + + +:: ============================================================ +:: STEP 2 - Check WSL configuration +:: ============================================================ + +echo. +echo [2/6] Checking WSL configuration... +echo. + +wsl --status >nul + +if %errorlevel% neq 0 ( + + echo [WARNING] WSL exists but does not appear to be + echo fully configured. + echo. + + goto :INSTALL_WSL +) + +echo [OK] WSL is configured. + + +:: ============================================================ +:: STEP 3 - Check Ubuntu 22.04 +:: ============================================================ + +echo. +echo [3/6] Checking for %DISTRO%... +echo. + +:: ------------------------------------------------------------ +:: Rather than parsing "wsl --list", directly ask WSL to run +:: a harmless command inside the requested distribution. +:: +:: This avoids encoding problems with the output of wsl -l. +:: Nothing is installed or modified by this test. +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- /bin/true >nul + +if %errorlevel% equ 0 ( + echo [OK] %DISTRO% is installed. + goto :UBUNTU_FOUND +) + +echo [INFO] %DISTRO% was not found. +echo. +echo Installed WSL distributions: +echo. +wsl.exe --list --verbose +echo. +echo The installer expected a distribution named: +echo. +echo %DISTRO% +echo. +echo If Ubuntu 22.04 appears above under a different name, +echo the installer should not install another copy. +echo. + +pause +goto :INSTALL_UBUNTU + + +:UBUNTU_FOUND +:: ============================================================ +:: STEP 4 - Check Ubuntu +:: ============================================================ + +echo. +echo [4/6] Checking Ubuntu Setup... +echo. + +set "CHECK_FILE=%TEMP%\ft_wsl_check_%RANDOM%.txt" + +wsl -d %DISTRO% -- bash -lc "printf 'FT_WSL_READY\n'" > "%CHECK_FILE%" + +findstr /C:"FT_WSL_READY" "%CHECK_FILE%" >nul + +if %errorlevel% neq 0 ( + + del "%CHECK_FILE%" >nul + + echo [WARNING] Ubuntu is installed but could not be + echo started normally. + echo. + echo Ubuntu may not have completed its first-time setup. + echo. + echo An Ubuntu terminal will now be opened. + echo. + echo If prompted, create your Linux username and password. + echo. + echo When finished, close Ubuntu and run this installer + echo again. + echo. + + pause + + start "" wsl.exe -d %DISTRO% + + exit /b 0 +) + +del "%CHECK_FILE%" >nul + +echo [OK] Ubuntu is ready. + +:: ============================================================ +:: STEP 5 - Check if ~/ft exists in WSL +:: ============================================================ +echo. +echo [5/6] Checking Formula Trinity directory... +echo. + +wsl.exe -d %DISTRO% -- bash -c "test -d ~/ft" + +if not errorlevel 1 goto :FT_FOLDER_EXISTS + +:: Directory does not exist - create it +wsl.exe -d %DISTRO% -- bash -c "mkdir -p ~/ft" + +if errorlevel 1 goto :ERROR_EXIT + +echo [OK] ~/ft directory created +goto :FT_FOLDER_READY + +:FT_FOLDER_EXISTS +echo [OK] ~/ft directory found + +:FT_FOLDER_READY + +:: ============================================================ +:: STEP 6 - READ-ONLY Formula Trinity installation check +:: ============================================================ + +echo. +echo [5/6] Checking existing Formula Trinity suite installation... +echo. + +:: ------------------------------------------------------------ +:: IMPORTANT: +:: These checks are READ ONLY. +:: Nothing is downloaded, installed or modified. +:: +:: Each component is checked separately. This avoids complex +:: Bash commands being parsed incorrectly by Windows CMD. +:: ------------------------------------------------------------ + +set "ROS_OK=0" +set "REPO_OK=0" +set "WORKSPACE_OK=0" +set "EUFS_OK=0" +set "SYSTEM_OK=0" + + +:: ------------------------------------------------------------ +:: Check ROS2 Humble +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- test -f /opt/ros/humble/setup.bash >nul + +if not errorlevel 1 ( + set "ROS_OK=1" +) + +:: ------------------------------------------------------------ +:: Check FT-FSAI-Core repository +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- bash -c "test -d \"$HOME/ft/FT-FSAI-Core/.git\"" >nul + +if not errorlevel 1 ( + set "REPO_OK=1" +) + + +:: ------------------------------------------------------------ +:: Check built ROS workspace +:: ------------------------------------------------------------ + +wsl.exe -d %DISTRO% -- bash -c "test -f ~/ft-wsl/install/setup.bash" >nul +if not errorlevel 1 ( + set "WORKSPACE_OK=1" +) + +:: ------------------------------------------------------------ +:: Check EUFS package +:: +:: Only attempt this if ROS and the workspace exist. +:: ------------------------------------------------------------ + +if "!ROS_OK!"=="1" if "!WORKSPACE_OK!"=="1" ( + + wsl.exe -d %DISTRO% -- bash -c "source ~/ft-wsl/environment.bash && ros2 pkg prefix eufs_launcher" >nul + if not errorlevel 1 ( + set "EUFS_OK=1" + ) +) + + +:: ------------------------------------------------------------ +:: Check FT simulation package +:: ------------------------------------------------------------ + +if "!WORKSPACE_OK!"=="0" goto :SYSTEM_CHECK_DONE + +wsl.exe -d %DISTRO% -- bash -c "source ~/ft-wsl/environment.bash && ros2 pkg prefix ft_launch" >nul 2>&1 + +if errorlevel 1 goto :SYSTEM_CHECK_DONE + +set "SYSTEM_OK=1" + +:SYSTEM_CHECK_DONE + +:: ------------------------------------------------------------ +:: Display results +:: ------------------------------------------------------------ + +echo. +echo Formula Trinity components: +echo. + +if "!ROS_OK!"=="1" ( + echo [OK] ROS2 Humble +) else ( + echo [MISSING] ROS2 Humble +) + +if "!REPO_OK!"=="1" ( + echo [OK] FT-FSAI-Core repository +) else ( + echo [MISSING] FT-FSAI-Core repository +) + +if "!WORKSPACE_OK!"=="1" ( + echo [OK] ROS workspace build +) else ( + echo [MISSING] ROS workspace build +) + +if "!EUFS_OK!"=="1" ( + echo [OK] EUFS +) else ( + echo [MISSING] EUFS +) + +if "!SYSTEM_OK!"=="1" ( + echo [OK] FT system launch +) else ( + echo [MISSING] FT system launch +) +echo. + +:: ============================================================ +:: Determine whether installation is complete +:: ============================================================ + +if "!ROS_OK!"=="1" if "!REPO_OK!"=="1" if "!WORKSPACE_OK!"=="1" if "!EUFS_OK!"=="1" if "!SYSTEM_OK!"=="1" ( + + goto :ALREADY_INSTALLED +) + + +:: ============================================================ +:: Installation incomplete +:: ============================================================ + +echo. +echo ============================================================ +echo INSTALLATION INCOMPLETE +echo ============================================================ +echo. +echo One or more Formula Trinity components are missing. +echo. +echo Unfortunatly there is an issue with git (windows 11 and WSL2) +echo so please follow these instructions for Windows 11 +echo https://www.freecodecamp.org/news/github-cli-wsl2-guide/ +echo to set up an SSH key and then clone the FT-FSAI-Core repo. +echo. +echo Follow these instructions if you have Windows 10 +echo https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent +echo. +echo How to clone FT-FSAI-Core repo +echo wsl +echo cd ~/ft +echo git clone --recurse-submodules git@github.com:FT-Autonomous/FT-FSAI-Core.git +echo. +echo Options: +echo. +echo [1] FT-FSAI-Core is cloned and I am ready for the next step +echo [2] Exit without making changes + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :SAFE_EXIT +if errorlevel 1 goto :ASK_INSTALLER + +:ASK_INSTALLER +echo ============================================================ +echo INSTALLATION INCOMPLETE +echo ============================================================ +echo The setup process can run install.sh which will install +echo missing components of the suite. +echo. +echo No Formula Trinity files have been changed yet. +echo. +echo Options: +echo. +echo [1] Continue setup +echo [2] Exit without making changes +echo. + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :SAFE_EXIT +if errorlevel 1 goto :RUN_INSTALLER + + +:: ============================================================ +:: Already installed +:: ============================================================ + +:ALREADY_INSTALLED + +echo. +echo ============================================================ +echo FORMULA TRINITY SUITE IS ALREADY INSTALLED +echo ============================================================ +echo. +echo All checked components were found. +echo No files have been downloaded or modified. +echo. +echo Options: +echo. +echo [1] Exit +echo. +echo [2] Run install.sh anyway +echo. + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :RUN_INSTALLER +if errorlevel 1 goto :SAFE_EXIT + + +:: ============================================================ +:: Safe exit +:: ============================================================ + +:SAFE_EXIT + +echo. +echo ============================================================ +echo NO CHANGES MADE +echo ============================================================ +echo. +echo Formula Trinity setup has been cancelled. +echo. + +pause +exit /b 0 + + +:: ============================================================ +:: Run Linux installer +:: ============================================================ +:RUN_INSTALLER + +echo. +echo ============================================================ +echo FORMULA TRINITY SUITE +echo ============================================================ +echo The Formula Trinity install.sh script will now be run within +echo the wsl and it will download the Formula Trinity suite. +echo. + +:: uses Jakubs code assuming its in FT-FSAI-Core +wsl.exe -d Ubuntu-22.04 -- bash -c "cd ~/ft/FT-FSAI-Core && ls && bash setup.sh" + +:: ============================================================ +:: Installation successful +:: ============================================================ + +echo. +echo ============================================================ +echo FORMULA TRINITY SETUP COMPLETE +echo ============================================================ +echo. +echo Formula Trinity has been installed successfully. +echo. +echo ============================================================ +echo HOW TO RUN +echo ============================================================ +echo. +echo Open cmd and send the command wsl to open a Ubuntu terminal +echo. +echo Open 3 wsl terminals +echo Run the following command in them all +echo. +echo source ~/ft-wsl/environment.bash +echo. +echo Then enter the following commands in each terminal +echo Terminal 1: +echo ros2 launch eufs_launcher eufs_launcher.launch.py +echo. +echo Choose and launch a circuit in EUFS. Keep that terminal running. +echo. +echo Termial 2: +echo ros2 launch ft_launch system_sim.launch.py +echo. +echo Terminal 3, to select Autocross on a suitable circuit: +echo ros2 service call /ros_can/set_mission eufs_msgs/srv/SetCanState '{ami_state: 13}' +echo ros2 topic echo /ros_can/state --once +echo. +echo Autocross is mission 13; driving is AS state 2. This uses the simulator's +echo mission service rather than publishing a fake driving state. +echo. +echo ============================================================ +echo. + +pause +exit /b 0 + + + +:: ============================================================ +:: Install WSL +:: ============================================================ + +:INSTALL_WSL + +echo ============================================================ +echo WSL SETUP +echo ============================================================ +echo. +echo WSL needs to be installed or configured. +echo. +echo Windows Administrator privileges are required for this +echo Windows-level operation. +echo. +echo The Formula Trinity installer itself will NOT run as +echo Windows Administrator. +echo. +echo Options: +echo. +echo [1] Continue setup +echo [2] Exit without making changes +echo. + +choice /C 12 /N /M "Select an option [1-2]: " + +if errorlevel 2 goto :SAFE_EXIT +if errorlevel 1 goto :WSL_INSTALLER +echo. + +:WSL_INSTALLER +powershell -NoProfile -ExecutionPolicy Bypass ^ + -Command "Start-Process -FilePath 'wsl.exe' -ArgumentList '--install','-d','%DISTRO%' -Verb RunAs -Wait" + +if %errorlevel% neq 0 ( + + echo. + echo [ERROR] WSL installation did not complete successfully. + echo. + + pause + exit /b 1 +) + +:: ============================================================ +:: Install Ubuntu +:: ============================================================ + +:INSTALL_UBUNTU + +echo ============================================================ +echo UBUNTU SETUP +echo ============================================================ +echo. +echo %DISTRO% needs to be installed. +echo. +echo Windows may request Administrator privileges for this +echo operation. +echo. +echo This terminal may close after installation. If this happens +echo please run the program again. +echo. +echo Press any key to continue or close this window to cancel. +echo. +powershell wsl --install %DISTRO% + +if %errorlevel% neq 0 ( + + echo. + echo [ERROR] Ubuntu installation did not complete + echo successfully. + echo. + + pause + exit /b 1 +) + + +echo. +echo ============================================================ +echo UBUNTU INSTALLATION COMPLETE +echo ============================================================ +echo. +echo Ubuntu now needs its first-time setup. +echo. +echo Create your Linux username and password when prompted. +echo. +echo Once finished: +echo. +echo 1. Close Ubuntu +echo 2. Run this installer again +echo. + +pause + +start "" wsl.exe -d %DISTRO% + +exit /b 0 + +:: ============================================================ +:: FAIL +:: ============================================================ +:fail +echo. +echo ================================================================ +echo [FAILED] Formula Trinity setup did not complete. +echo ================================================================ +echo. +echo This window will remain open so you can read the error. +pause +exit /b 1 From 89b6311e37603b06d86d597a3f184b02996c894a Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Mon, 12 Oct 2026 15:28:35 +0100 Subject: [PATCH 07/13] Delete docs/media/downloads directory --- docs/media/downloads/FormulaTrinitySetup.bat | 583 ------------------- 1 file changed, 583 deletions(-) delete mode 100644 docs/media/downloads/FormulaTrinitySetup.bat diff --git a/docs/media/downloads/FormulaTrinitySetup.bat b/docs/media/downloads/FormulaTrinitySetup.bat deleted file mode 100644 index 8e4849e..0000000 --- a/docs/media/downloads/FormulaTrinitySetup.bat +++ /dev/null @@ -1,583 +0,0 @@ -@echo off -setlocal EnableExtensions EnableDelayedExpansion - -title Formula Trinity Autonomous Setup - -:: ============================================================ -:: Formula Trinity Windows / WSL Bootstrapper -:: -:: Target: -:: Windows 10/11 -:: WSL2 -:: Ubuntu 22.04 -:: -:: IMPORTANT: -:: - Existing FT installations are checked BEFORE anything -:: is downloaded or modified. -:: - Windows Administrator access is requested only when -:: WSL / Ubuntu needs to be installed. -:: HOW TO USE: -:: - Simply download, run the program and follow all the -:: instructions -:: -:: Please contact Muirinn if there are any issues -:: ============================================================ - - -:: ------------------------------------------------------------ -:: Configuration -:: ------------------------------------------------------------ - -set "DISTRO=Ubuntu-22.04" - -:: ------------------------------------------------------------ -:: Header -:: ------------------------------------------------------------ - -cls - -echo. -echo ============================================================ -echo FORMULA TRINITY AUTONOMOUS -echo SETUP INSTALLER -echo ============================================================ -echo. -echo This installer will check your computer before making -echo any changes. -echo. -echo If the Formula Trinity suiteis already installed, you will -echo be given the option to exit without modifying anything. -echo. -echo ============================================================ -echo. - - -:: ============================================================ -:: STEP 1 - Check WSL -:: ============================================================ - -echo [1/5] Checking WSL... -echo. - -where wsl.exe >nul - -if %errorlevel% neq 0 ( - - echo [INFO] WSL is not installed. - echo. - - goto :INSTALL_WSL -) - -echo [OK] WSL is available. - - -:: ============================================================ -:: STEP 2 - Check WSL configuration -:: ============================================================ - -echo. -echo [2/5] Checking WSL configuration... -echo. - -wsl --status >nul - -if %errorlevel% neq 0 ( - - echo [WARNING] WSL exists but does not appear to be - echo fully configured. - echo. - - goto :INSTALL_WSL -) - -echo [OK] WSL is configured. - - -:: ============================================================ -:: STEP 3 - Check Ubuntu 22.04 -:: ============================================================ - -echo. -echo [3/5] Checking for %DISTRO%... -echo. - -:: ------------------------------------------------------------ -:: Rather than parsing "wsl --list", directly ask WSL to run -:: a harmless command inside the requested distribution. -:: -:: This avoids encoding problems with the output of wsl -l. -:: Nothing is installed or modified by this test. -:: ------------------------------------------------------------ - -wsl.exe -d %DISTRO% -- /bin/true >nul - -if %errorlevel% equ 0 ( - echo [OK] %DISTRO% is installed. - goto :UBUNTU_FOUND -) - -echo [INFO] %DISTRO% was not found. -echo. -echo Installed WSL distributions: -echo. -wsl.exe --list --verbose -echo. -echo The installer expected a distribution named: -echo. -echo %DISTRO% -echo. -echo If Ubuntu 22.04 appears above under a different name, -echo the installer should not install another copy. -echo. - -pause -goto :INSTALL_UBUNTU - - -:UBUNTU_FOUND -:: ============================================================ -:: STEP 4 - Check Ubuntu -:: ============================================================ - -echo. -echo [4/5] Checking Ubuntu Setup... -echo. - -set "CHECK_FILE=%TEMP%\ft_wsl_check_%RANDOM%.txt" - -wsl -d %DISTRO% -- bash -lc "printf 'FT_WSL_READY\n'" > "%CHECK_FILE%" - -findstr /C:"FT_WSL_READY" "%CHECK_FILE%" >nul - -if %errorlevel% neq 0 ( - - del "%CHECK_FILE%" >nul - - echo [WARNING] Ubuntu is installed but could not be - echo started normally. - echo. - echo Ubuntu may not have completed its first-time setup. - echo. - echo An Ubuntu terminal will now be opened. - echo. - echo If prompted, create your Linux username and password. - echo. - echo When finished, close Ubuntu and run this installer - echo again. - echo. - - pause - - start "" wsl.exe -d %DISTRO% - - exit /b 0 -) - -del "%CHECK_FILE%" >nul - -echo [OK] Ubuntu is ready. - -:: ============================================================ -:: STEP 5 - READ-ONLY Formula Trinity installation check -:: ============================================================ - -echo. -echo [5/5] Checking existing Formula Trinity suite installation... -echo. - -:: ------------------------------------------------------------ -:: IMPORTANT: -:: These checks are READ ONLY. -:: Nothing is downloaded, installed or modified. -:: -:: Each component is checked separately. This avoids complex -:: Bash commands being parsed incorrectly by Windows CMD. -:: ------------------------------------------------------------ - -set "ROS_OK=0" -set "REPO_OK=0" -set "WORKSPACE_OK=0" -set "EUFS_OK=0" -set "SYSTEM_OK=0" - - -:: ------------------------------------------------------------ -:: Check ROS2 Humble -:: ------------------------------------------------------------ - -wsl.exe -d %DISTRO% -- test -f /opt/ros/humble/setup.bash >nul - -if not errorlevel 1 ( - set "ROS_OK=1" -) - -:: ------------------------------------------------------------ -:: Check FT-FSAI-Core repository -:: ------------------------------------------------------------ - -wsl.exe -d %DISTRO% -- bash -c "test -d \"$HOME/ft/FT-FSAI-Core/.git\"" >nul - -if not errorlevel 1 ( - set "REPO_OK=1" -) - - -:: ------------------------------------------------------------ -:: Check built ROS workspace -:: ------------------------------------------------------------ - -wsl.exe -d %DISTRO% -- bash -c "test -f \"$HOME/ft/install/setup.bash\"" >nul - -if not errorlevel 1 ( - set "WORKSPACE_OK=1" -) - -:: ------------------------------------------------------------ -:: Check EUFS package -:: -:: Only attempt this if ROS and the workspace exist. -:: ------------------------------------------------------------ - -if "!ROS_OK!"=="1" if "!WORKSPACE_OK!"=="1" ( - - wsl.exe -d %DISTRO% -- bash -c "source /opt/ros/humble/setup.bash && source \"$HOME/ft/install/setup.bash\" && ros2 pkg prefix eufs_launcher >/dev/null" - - if not errorlevel 1 ( - set "EUFS_OK=1" - ) -) - - -:: ------------------------------------------------------------ -:: Check ft_system package -:: ------------------------------------------------------------ - -if "!ROS_OK!"=="1" if "!WORKSPACE_OK!"=="1" ( - - wsl.exe -d %DISTRO% -- bash -c "source /opt/ros/humble/setup.bash && source \"$HOME/ft/install/setup.bash\" && ros2 pkg prefix ft_system >/dev/null" - - if not errorlevel 1 ( - set "SYSTEM_OK=1" - ) -) - -:: ------------------------------------------------------------ -:: Display results -:: ------------------------------------------------------------ - -echo. -echo Formula Trinity components: -echo. - -if "!ROS_OK!"=="1" ( - echo [OK] ROS2 Humble -) else ( - echo [MISSING] ROS2 Humble -) - -if "!REPO_OK!"=="1" ( - echo [OK] FT-FSAI-23 repository -) else ( - echo [MISSING] FT-FSAI-23 repository -) - -if "!WORKSPACE_OK!"=="1" ( - echo [OK] ROS workspace build -) else ( - echo [MISSING] ROS workspace build -) - -if "!EUFS_OK!"=="1" ( - echo [OK] EUFS -) else ( - echo [MISSING] EUFS -) - -if "!SYSTEM_OK!"=="1" ( - echo [OK] ft_system -) else ( - echo [MISSING] ft_system -) -echo. - -:: ============================================================ -:: Determine whether installation is complete -:: ============================================================ - -if "!ROS_OK!"=="1" if "!REPO_OK!"=="1" if "!WORKSPACE_OK!"=="1" if "!EUFS_OK!"=="1" if "!SYSTEM_OK!"=="1" ( - - goto :ALREADY_INSTALLED -) - - -:: ============================================================ -:: Installation incomplete -:: ============================================================ - -echo. -echo ============================================================ -echo INSTALLATION INCOMPLETE -echo ============================================================ -echo. -echo One or more Formula Trinity components are missing. -echo. -echo Unfortunatly there is an issue with git (windows 11 & WSL2) -echo so please follow these instructions for Windows 11 -echo https://www.freecodecamp.org/news/github-cli-wsl2-guide/ -echo to set up an SSH key and then clone the FT-FSAI-23 repo. -echo. -echo Follow these instructions if you have Windows 10 -echo https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent -echo. -echo How to clone FT-FSAI-Core repo -echo wsl -echo cd ~/ft -echo git clone --recurse-submodules git@github.com:FT-Autonomous/FT-FSAI-Core.git -echo -echo Options: -echo. -echo [1] FT-FSAI-Core is cloned and I am ready for the next step -echo [2] Exit without making changes - -choice /C 12 /N /M "Select an option [1-2]: " - -if errorlevel 2 goto :SAFE_EXIT -if errorlevel 1 goto :ASK_INSTALLER - -:ASK_INSTALLER -echo ============================================================ -echo INSTALLATION INCOMPLETE -echo ============================================================ -echo The setup process can run install.sh which will install -echo missing components of the suite. -echo. -echo No Formula Trinity files have been changed yet. -echo. -echo Options: -echo. -echo [1] Continue setup -echo [2] Exit without making changes -echo. - -choice /C 12 /N /M "Select an option [1-2]: " - -if errorlevel 2 goto :SAFE_EXIT -if errorlevel 1 goto :RUN_INSTALLER - - -:: ============================================================ -:: Already installed -:: ============================================================ - -:ALREADY_INSTALLED - -echo. -echo ============================================================ -echo FORMULA TRINITY SUITE IS ALREADY INSTALLED -echo ============================================================ -echo. -echo All checked components were found. -echo No files have been downloaded or modified. -echo. -echo Options: -echo. -echo [1] Exit -echo. -echo [2] Run install.sh anyway -echo. - -choice /C 12 /N /M "Select an option [1-2]: " - -if errorlevel 2 goto :RUN_INSTALLER -if errorlevel 1 goto :SAFE_EXIT - - -:: ============================================================ -:: Safe exit -:: ============================================================ - -:SAFE_EXIT - -echo. -echo ============================================================ -echo NO CHANGES MADE -echo ============================================================ -echo. -echo Formula Trinity setup has been cancelled. -echo. - -pause -exit /b 0 - - -:: ============================================================ -:: Run Linux installer -:: ============================================================ -:RUN_INSTALLER - -echo. -echo ============================================================ -echo FORMULA TRINITY SUITE -echo ============================================================ -echo The Formula Trinity install.sh script will now be run within -echo the wsl and it will download the Formula Trinity suite. -echo. - -:: uses Jakubs code assuming its in FT-FSAI-Core -wsl.exe -d Ubuntu-22.04 -- bash -c "cd ~/ft/FT-FSAI-Core && ls && bash setup.sh" - -:: ============================================================ -:: Installation successful -:: ============================================================ - -echo. -echo ============================================================ -echo FORMULA TRINITY SETUP COMPLETE -echo ============================================================ -echo. -echo Formula Trinity has been installed successfully. -echo. -echo ============================================================ -echo HOW TO RUN -echo ============================================================ -echo. -echo Open cmd and send the command wsl to open a Ubuntu terminal -echo. -echo Open 3 wsl terminals -echo Run the following command in them all -echo. -echo source ~/ft-wsl/environment.bash -echo. -echo Then enter the following commands in each terminal -echo Terminal 1: -echo ros2 launch eufs_launcher eufs_launcher.launch.py -echo. -echo Choose and launch a circuit in EUFS. Keep that terminal running. -echo. -echo Termial 2: -echo ros2 launch ft_launch system_sim.launch.py -echo. -echo Terminal 3, to select Autocross on a suitable circuit: -echo ros2 service call /ros_can/set_mission eufs_msgs/srv/SetCanState '{ami_state: 13}' -echo ros2 topic echo /ros_can/state --once -echo. -echo Autocross is mission 13; driving is AS state 2. This uses the simulator's -echo mission service rather than publishing a fake driving state. -echo. -echo ============================================================ -echo. - -pause -exit /b 0 - - - -:: ============================================================ -:: Install WSL -:: ============================================================ - -:INSTALL_WSL - -echo ============================================================ -echo WSL SETUP -echo ============================================================ -echo. -echo WSL needs to be installed or configured. -echo. -echo Windows Administrator privileges are required for this -echo Windows-level operation. -echo. -echo The Formula Trinity installer itself will NOT run as -echo Windows Administrator. -echo. -echo Options: -echo. -echo [1] Continue setup -echo [2] Exit without making changes -echo. - -choice /C 12 /N /M "Select an option [1-2]: " - -if errorlevel 2 goto :SAFE_EXIT -if errorlevel 1 goto :WSL_INSTALLER -echo. - -:WSL_INSTALLER -powershell -NoProfile -ExecutionPolicy Bypass ^ - -Command "Start-Process -FilePath 'wsl.exe' -ArgumentList '--install','-d','%DISTRO%' -Verb RunAs -Wait" - -if %errorlevel% neq 0 ( - - echo. - echo [ERROR] WSL installation did not complete successfully. - echo. - - pause - exit /b 1 -) - -:: ============================================================ -:: Install Ubuntu -:: ============================================================ - -:INSTALL_UBUNTU - -echo ============================================================ -echo UBUNTU SETUP -echo ============================================================ -echo. -echo %DISTRO% needs to be installed. -echo. -echo Windows may request Administrator privileges for this -echo operation. -echo. -echo Press any key to continue or close this window to cancel. -echo. -powershell wsl --install %DISTRO% - -if %errorlevel% neq 0 ( - - echo. - echo [ERROR] Ubuntu installation did not complete - echo successfully. - echo. - - pause - exit /b 1 -) - - -echo. -echo ============================================================ -echo UBUNTU INSTALLATION COMPLETE -echo ============================================================ -echo. -echo Ubuntu now needs its first-time setup. -echo. -echo Create your Linux username and password when prompted. -echo. -echo Once finished: -echo. -echo 1. Close Ubuntu -echo 2. Run this installer again -echo. - -pause - -start "" wsl.exe -d %DISTRO% - -exit /b 0 - -:: ============================================================ -:: FAIL -:: ============================================================ -:fail -echo. -echo ================================================================ -echo [FAILED] Formula Trinity setup did not complete. -echo ================================================================ -echo. -echo This window will remain open so you can read the error. -pause -exit /b 1 From aa2c0e7b6135c97388b875ae202248e0e9724ba5 Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Mon, 12 Oct 2026 15:30:00 +0100 Subject: [PATCH 08/13] Update FormulaTrinitySetup.bat location --- docs/tutorials/Setup_2026.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/Setup_2026.md b/docs/tutorials/Setup_2026.md index 07807b3..4cbf4f5 100644 --- a/docs/tutorials/Setup_2026.md +++ b/docs/tutorials/Setup_2026.md @@ -2,7 +2,7 @@ ## HOW TO USE -- Download [FormulaTrinitySetup.bat](../media/downloads/FormulaTrinitySetup.bat), run it, and follow the on-screen instructions. +- Download [FormulaTrinitySetup.bat](/media/downloads/FormulaTrinitySetup.bat), run it, and follow the on-screen instructions. - Please contact Muirinn if there are any issues. ## Target From e8b95a97d90237278f6cfde2b02ebd50ae3ddd87 Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Mon, 12 Oct 2026 15:30:35 +0100 Subject: [PATCH 09/13] Update FormulaTrinitySetup.bat location properly --- docs/tutorials/Setup_2026.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tutorials/Setup_2026.md b/docs/tutorials/Setup_2026.md index 4cbf4f5..e5fa925 100644 --- a/docs/tutorials/Setup_2026.md +++ b/docs/tutorials/Setup_2026.md @@ -2,7 +2,7 @@ ## HOW TO USE -- Download [FormulaTrinitySetup.bat](/media/downloads/FormulaTrinitySetup.bat), run it, and follow the on-screen instructions. +- Download [FormulaTrinitySetup.bat](media/downloads/FormulaTrinitySetup.bat), run it, and follow the on-screen instructions. - Please contact Muirinn if there are any issues. ## Target From ce2c65aafea18488bf837c2dc2ba1dfd007986ed Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Mon, 12 Oct 2026 15:35:37 +0100 Subject: [PATCH 10/13] Fix FormulaTrinitySetup.bat minor print errors --- docs/tutorials/media/downloads/FormulaTrinitySetup.bat | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/tutorials/media/downloads/FormulaTrinitySetup.bat b/docs/tutorials/media/downloads/FormulaTrinitySetup.bat index c95e567..a4a951e 100644 --- a/docs/tutorials/media/downloads/FormulaTrinitySetup.bat +++ b/docs/tutorials/media/downloads/FormulaTrinitySetup.bat @@ -45,7 +45,7 @@ echo. echo This installer will check your computer before making echo any changes. echo. -echo If the Formula Trinity suit is already installed, you will +echo If the Formula Trinity suite is already installed, you will echo be given the option to exit without modifying anything. echo. echo ============================================================ @@ -207,7 +207,7 @@ echo [OK] ~/ft directory found :: ============================================================ echo. -echo [5/6] Checking existing Formula Trinity suite installation... +echo [6/6] Checking existing Formula Trinity suite installation... echo. :: ------------------------------------------------------------ From 1856bd75d217557cc174a400974e880cf747250b Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Mon, 12 Oct 2026 18:52:54 +0100 Subject: [PATCH 11/13] Update FormulaTrinitySetup.bat --- docs/tutorials/media/downloads/FormulaTrinitySetup.bat | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/tutorials/media/downloads/FormulaTrinitySetup.bat b/docs/tutorials/media/downloads/FormulaTrinitySetup.bat index a4a951e..cb0dcb2 100644 --- a/docs/tutorials/media/downloads/FormulaTrinitySetup.bat +++ b/docs/tutorials/media/downloads/FormulaTrinitySetup.bat @@ -372,7 +372,7 @@ if errorlevel 1 goto :ASK_INSTALLER echo ============================================================ echo INSTALLATION INCOMPLETE echo ============================================================ -echo The setup process can run install.sh which will install +echo The setup process can run setup.sh which will install echo missing components of the suite. echo. echo No Formula Trinity files have been changed yet. @@ -407,7 +407,7 @@ echo Options: echo. echo [1] Exit echo. -echo [2] Run install.sh anyway +echo [2] Run setup.sh anyway echo. choice /C 12 /N /M "Select an option [1-2]: " @@ -443,7 +443,7 @@ echo. echo ============================================================ echo FORMULA TRINITY SUITE echo ============================================================ -echo The Formula Trinity install.sh script will now be run within +echo The Formula Trinity setup.sh script will now be run within echo the wsl and it will download the Formula Trinity suite. echo. From 7718166a5a25b04b462d2f3a6b77dea99fed19fb Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Thu, 15 Oct 2026 13:50:54 +0100 Subject: [PATCH 12/13] Update mkdocs.yml --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index cd6a126..335bd8a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -156,6 +156,7 @@ nav: # This is the structure of the sidebar - Other Relevant Sites: resources/relevant.md - Tutorials: + - Setup Guide 2026: tutorials/Setup_2026.md - Getting Started Guide: tutorials/Getting_started.md - Onboarding Videos: tutorials/onboarding_videos.md - Cutting Bags Down to Size: tutorials/cutting_bags.md From 625fb2f14ae9a8a840cc3b7228eea7f13f93e2ce Mon Sep 17 00:00:00 2001 From: MuirinnD <115172215+MuirinnD@users.noreply.github.com> Date: Thu, 15 Oct 2026 13:55:09 +0100 Subject: [PATCH 13/13] Update Getting_started.md Added link to 2026 setup page --- docs/tutorials/Getting_started.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/tutorials/Getting_started.md b/docs/tutorials/Getting_started.md index f622e63..551a796 100644 --- a/docs/tutorials/Getting_started.md +++ b/docs/tutorials/Getting_started.md @@ -1,5 +1,7 @@ # Getting Started Guide +If you are using windows please use the [Setup 2026 Guide](../tutorials/Setup_2026.md) + This guide assumes that you are running on some distribution of Ubuntu, preferrably Ubuntu 22.04. It should work in either WSL or a native Linux install. We're working on making an article about how to run the stack on distros such as Arch Linux [here](../tutorials/run_code_not_ubuntu.md). **FASTEST (EUFS) SETUP: MATTEW POWER FROM PATH PLANNING IN 1 hr 30 Mins, if setup faster, please contact docs boss**