From 103a61450ee4e2f675423e61fb9f9eb411cf0dfe Mon Sep 17 00:00:00 2001 From: Ramon Roche Date: Wed, 11 Feb 2026 10:29:10 -0800 Subject: [PATCH] docs: update Ubuntu dev env to reflect supported LTS versions - Replace "older version" collapsible with info block stating supported versions: Ubuntu 24.04 (primary) and 22.04 - Remove Gazebo Classic references (Ubuntu 22.04 section, install step) - Note that GCC version comes from Ubuntu package manager - Clarify that GCC version depends on Ubuntu release Signed-off-by: Ramon Roche --- docs/en/dev_setup/dev_env_linux_ubuntu.md | 25 ++++++++--------------- 1 file changed, 9 insertions(+), 16 deletions(-) diff --git a/docs/en/dev_setup/dev_env_linux_ubuntu.md b/docs/en/dev_setup/dev_env_linux_ubuntu.md index 2c80b959ce..0c7917c8d3 100644 --- a/docs/en/dev_setup/dev_env_linux_ubuntu.md +++ b/docs/en/dev_setup/dev_env_linux_ubuntu.md @@ -4,20 +4,14 @@ The following instructions use a bash script to set up the PX4 development envir The environment includes: -- [Gazebo Simulator](../sim_gazebo_gz/index.md) ("Harmonic") -- [Build toolchain for Pixhawk (and other NuttX-based hardware)](../dev_setup/building_px4.md#nuttx-pixhawk-based-boards). - -On Ubuntu 22.04: - -- [Gazebo Classic Simulator](../sim_gazebo_classic/index.md) can be used instead of Gazebo. - Gazebo is nearing feature-parity with Gazebo-Classic on PX4, and will soon replace it for all use cases. +- [Gazebo Simulator](../sim_gazebo_gz/index.md) (Gazebo Harmonic) +- [Build toolchain for Pixhawk (and other NuttX-based hardware)](../dev_setup/building_px4.md#nuttx-pixhawk-based-boards) using the `gcc-arm-none-eabi` compiler from the Ubuntu package manager. The build toolchain for other flight controllers, simulators, and working with ROS are discussed in the [Other Targets](#other-targets) section below. -::: details Can I use an older version of Ubuntu? -PX4 supports the current and last Ubuntu LTS release where possible. -Older releases are not supported (so you can't raise defects against them), but may still work. -For example, Gazebo Classic setup is included in our standard build instructions for macOS, Ubuntu 18.04 and 20.04, and Windows on WSL2 for the same hosts. +:::info +PX4 targets the **current Ubuntu LTS** (24.04) for CI and release builds, with the **previous LTS** (22.04) also supported. +Older Ubuntu versions are not supported and may not work. ::: ## Simulation and NuttX (Pixhawk) Targets @@ -50,19 +44,18 @@ To install the toolchain: - Acknowledge any prompts as the script progress. - You can use the `--no-nuttx` and `--no-sim-tools` options to omit the NuttX and/or simulation tools. -3. If you need Gazebo Classic (Ubuntu 22.04 only) then you can manually remove Gazebo and install it by following the instructions in [Gazebo Classic > Installation](../sim_gazebo_classic/index.md#installation). - -4. Restart the computer on completion. +3. Restart the computer on completion. :::details Additional notes These notes are provided "for information only": - This setup is supported by the PX4 Dev Team. The instructions may also work on other Debian Linux based systems. -- You can verify the NuttX installation by confirming the `gcc` version as shown: +- You can verify the NuttX installation by confirming `gcc` is available. + The version depends on your Ubuntu release (e.g. GCC 13.2.1 on Ubuntu 24.04): ```sh - $arm-none-eabi-gcc --version + $ arm-none-eabi-gcc --version arm-none-eabi-gcc (15:13.2.rel1-2) 13.2.1 20231009 Copyright (C) 2023 Free Software Foundation, Inc.