mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-10-26 17:43:33 +08:00
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 <mrpollo@gmail.com>
This commit is contained in:
@@ -39,8 +39,9 @@ You may want to also install `python-pip` and `screen`.
|
|||||||
Execute the script below to install GCC 7-2017-q4:
|
Execute the script below to install GCC 7-2017-q4:
|
||||||
|
|
||||||
:::warning
|
:::warning
|
||||||
This version of GCC is out of date.
|
This version of GCC is very outdated.
|
||||||
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))
|
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
|
```sh
|
||||||
|
|||||||
@@ -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.
|
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.
|
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.
|
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).
|
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).
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# PX4 Docker Containers
|
# 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.
|
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).
|
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.
|
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
|
```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-base-jammy
|
||||||
- px4io/px4-dev-nuttx-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_.
|
(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
|
:::tip
|
||||||
Typically you should use a recent container, but not necessarily the `latest` (as this changes too often).
|
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 \
|
-v /tmp/.X11-unix:/tmp/.X11-unix:ro \
|
||||||
-e DISPLAY=:0 \
|
-e DISPLAY=:0 \
|
||||||
--network host \
|
--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
|
::: info
|
||||||
@@ -155,7 +152,7 @@ Verify if everything works by running, for example, SITL:
|
|||||||
|
|
||||||
```sh
|
```sh
|
||||||
cd src/PX4-Autopilot #This is <container_src>
|
cd src/PX4-Autopilot #This is <container_src>
|
||||||
make px4_sitl_default gazebo-classic
|
make px4_sitl gz_x500
|
||||||
```
|
```
|
||||||
|
|
||||||
### Re-enter the Container
|
### 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
|
#### 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
|
```sh
|
||||||
libGL error: failed to load driver: swrast
|
libGL error: failed to load driver: swrast
|
||||||
@@ -239,7 +236,7 @@ Any recent Linux distribution should work.
|
|||||||
|
|
||||||
The following configuration is tested:
|
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**
|
**Memory**
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user