From 2f7a755478b64ea0ae70b1c84c689c8ef60d5eef Mon Sep 17 00:00:00 2001 From: Ramon Roche Date: Wed, 11 Feb 2026 10:31:45 -0800 Subject: [PATCH] docs: remove outdated Ubuntu/Gazebo Classic references docker.md: - Update container hierarchy from focal to jammy - Replace ROS Noetic/Foxy references with ROS 2 Humble - Update docker run example to use humble container - Update SITL example from gazebo-classic to gz_x500 - Update VM tested version from Ubuntu 14.04 to 22.04 vscode.md: - Remove "Ubuntu 18.04" from inotify troubleshooting header (this issue is not Ubuntu-version-specific) dev_env_linux_centos.md: - Update GCC warning to reference current Ubuntu LTS toolchain instead of old Focal Docker file Signed-off-by: Ramon Roche --- docs/en/dev_setup/dev_env_linux_centos.md | 5 +++-- docs/en/dev_setup/vscode.md | 4 ++-- docs/en/test_and_ci/docker.md | 25 ++++++++++------------- 3 files changed, 16 insertions(+), 18 deletions(-) diff --git a/docs/en/dev_setup/dev_env_linux_centos.md b/docs/en/dev_setup/dev_env_linux_centos.md index e9b23dee5f..92398f30d8 100644 --- a/docs/en/dev_setup/dev_env_linux_centos.md +++ b/docs/en/dev_setup/dev_env_linux_centos.md @@ -39,8 +39,9 @@ You may want to also install `python-pip` and `screen`. Execute the script below to install GCC 7-2017-q4: :::warning -This version of GCC is out of date. -At time of writing the current version on Ubuntu is `9-2020-q2-update` (see [focal nuttx docker file](https://github.com/PX4/PX4-containers/blob/master/docker/Dockerfile_nuttx-focal#L28)) +This version of GCC is very outdated. +PX4 now uses the `gcc-arm-none-eabi` package from the current Ubuntu LTS (GCC 13.2.1 on Ubuntu 24.04). +This CentOS guide is community-maintained and may not produce working builds. ::: ```sh diff --git a/docs/en/dev_setup/vscode.md b/docs/en/dev_setup/vscode.md index 302e68b250..9a4b60a480 100644 --- a/docs/en/dev_setup/vscode.md +++ b/docs/en/dev_setup/vscode.md @@ -124,10 +124,10 @@ Once that is done you don't need to do anything else; the toolchain will automat This section includes guidance on setup and build errors. -### Ubuntu 18.04: "Visual Studio Code is unable to watch for file changes in this large workspace" +### "Visual Studio Code is unable to watch for file changes in this large workspace" This error surfaces on startup. -On some systems, there is an upper-limit of 8192 file handles imposed on applications, which means that VSCode might not be able to detect file modifications in `/PX4-Autopilot`. +On some systems, there is an upper-limit on file handles imposed on applications, which means that VSCode might not be able to detect file modifications in `/PX4-Autopilot`. You can increase this limit to avoid the error, at the expense of memory consumption. Follow the [instructions here](https://code.visualstudio.com/docs/setup/linux#_visual-studio-code-is-unable-to-watch-for-file-changes-in-this-large-workspace-error-enospc). diff --git a/docs/en/test_and_ci/docker.md b/docs/en/test_and_ci/docker.md index 43f0ee5eb8..03121ff5ab 100644 --- a/docs/en/test_and_ci/docker.md +++ b/docs/en/test_and_ci/docker.md @@ -1,6 +1,6 @@ # PX4 Docker Containers -Docker containers are provided for the complete [PX4 development toolchain](../dev_setup/dev_env.md#supported-targets) including NuttX and Linux based hardware, [Gazebo Classic](../sim_gazebo_classic/index.md) simulation, and [ROS](../simulation/ros_interface.md). +Docker containers are provided for the complete [PX4 development toolchain](../dev_setup/dev_env.md#supported-targets) including NuttX and Linux based hardware, [Gazebo](../sim_gazebo_gz/index.md) simulation, and [ROS 2](../ros2/user_guide.md). This topic shows how to use the [available docker containers](#px4_containers) to access the build environment in a local Linux computer. @@ -41,22 +41,19 @@ The available containers are on [GitHub here](https://github.com/PX4/PX4-contain These allow testing of various build targets and configurations (the included tools can be inferred from their names). The containers are hierarchical, such that containers have the functionality of their parents. -For example, the partial hierarchy below shows that the docker container with NuttX build tools (`px4-dev-nuttx-focal`) does not include ROS 2, while the simulation containers do: +For example, the partial hierarchy below shows that the docker container with NuttX build tools (`px4-dev-nuttx-jammy`) does not include ROS 2, while the simulation containers do: ```plain -- px4io/px4-dev-base-focal - - px4io/px4-dev-nuttx-focal - - px4io/px4-dev-simulation-focal - - px4io/px4-dev-ros-noetic - - px4io/px4-dev-ros2-foxy - - px4io/px4-dev-ros2-rolling - px4io/px4-dev-base-jammy - px4io/px4-dev-nuttx-jammy + - px4io/px4-dev-simulation-jammy + - px4io/px4-dev-ros2-humble + - px4io/px4-dev-ros2-rolling ``` -The most recent version can be accessed using the `latest` tag: `px4io/px4-dev-nuttx-focal:latest` +The most recent version can be accessed using the `latest` tag: `px4io/px4-dev-nuttx-jammy:latest` (available tags are listed for each container on _hub.docker.com_. -For example, the `px4io/px4-dev-nuttx-focal` tags can be found on [hub.docker.com here](https://hub.docker.com/r/px4io/px4-dev-nuttx-focal/tags?page=1&ordering=last_updated)). +For example, the `px4io/px4-dev-nuttx-jammy` tags can be found on [hub.docker.com here](https://hub.docker.com/r/px4io/px4-dev-nuttx-jammy/tags?page=1&ordering=last_updated)). :::tip Typically you should use a recent container, but not necessarily the `latest` (as this changes too often). @@ -137,7 +134,7 @@ docker run -it --privileged \ -v /tmp/.X11-unix:/tmp/.X11-unix:ro \ -e DISPLAY=:0 \ --network host \ ---name=px4-ros px4io/px4-dev-ros2-foxy:2022-07-31 bash +--name=px4-ros px4io/px4-dev-ros2-humble:latest bash ``` ::: info @@ -155,7 +152,7 @@ Verify if everything works by running, for example, SITL: ```sh cd src/PX4-Autopilot #This is -make px4_sitl_default gazebo-classic +make px4_sitl gz_x500 ``` ### Re-enter the Container @@ -219,7 +216,7 @@ This ensures that all files created within the container will be accessible on t #### Graphics Driver Issues -It's possible that running Gazebo Classic will result in a similar error message like the following: +It's possible that running Gazebo will result in a similar error message like the following: ```sh libGL error: failed to load driver: swrast @@ -239,7 +236,7 @@ Any recent Linux distribution should work. The following configuration is tested: -- OS X with VMWare Fusion and Ubuntu 14.04 (Docker container with GUI support on Parallels make the X-Server crash). +- OS X with VMWare Fusion and Ubuntu 22.04 (Docker container with GUI support on Parallels make the X-Server crash). **Memory**