mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-11-22 14:19:57 +08:00
* feat(simulator_sih): add a GeoTIFF terrain elevation model for SITL SIH only simulates flat ground. This adds the loader for a terrain elevation model (DEM) in a GeoTIFF file, the base for non-flat terrain in SITL. The DEM is read with libtiff and libgeotiff. A DEM in a projected CRS is resampled once at load time with PROJ onto a WGS84 lat/lon grid, so a lookup in the simulation loop is a plain bilinear interpolation. It is built only for px4_sitl and only when the three libraries are found, so hardware builds and SITL without them are unchanged. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> * feat(simulator_sih): use the terrain DEM for ground contact and the rangefinder With PX4_SIH_TERRAIN set to a GeoTIFF DEM, SIH in SITL places the vehicle on the terrain at start, lands it on the terrain, ray-casts the downward distance sensor against it, and publishes it as the groundtruth terrain_alt. Outside the DEM the ground stays flat at SIH_LOC_H0. Terrain is only used for multicopters, VTOLs and fixed-wing; other vehicle types keep flat ground. The DEM is loaded in task_spawn() so a bad file fails the start command, and because the SIH task stack is too small for libtiff and PROJ. The groundtruth terrain_alt now holds the WGS84 terrain altitude, as the message documents, instead of the height above the origin. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> * build(setup): install the SIH terrain dependencies with the simulation tools Install libtiff, libgeotiff and PROJ so SITL builds SIH with terrain elevation (DEM) support. They are optional: without them SIH builds as before. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> * docs(sim_sih): document terrain elevation from a GeoTIFF DEM Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> * docs(sim_sih): fix and clarify the terrain elevation section Address review findings on the new terrain section: list the sample types the loader actually reads, note that the prebuilt px4 package and px4io/px4-sitl container are built without terrain support, and say when SIH_LOC_H0 still sets the start altitude. Also add a version badge, link GeoTIFF, EPSG and GDAL, mention the dist_bottom groundtruth field, and correct the GLO-30 coverage. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Hamish Willee <hamishwillee@gmail.com> * fix: cast to double for MAC builds Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> * chore: implement TerrainBase interface Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> * chore: improve isolation of terrain logic from sih core Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> * refactor(simulator_sih): move DEM handling into the terrain classes SIH should only use the terrain, not manage it. TerrainFlat becomes the base class, since flat ground is what every terrain model builds on, and TerrainDem falls back to it until a DEM is loaded. Terrain.hpp picks the model at compile time, so SIH holds the terrain by value with no #ifdef, new/delete or pointer handover, and NuttX builds only get the flat model. Tracking whether the vehicle is inside the DEM, and the matching warnings and status, move from SIH into TerrainDem. The DEM is still loaded in task_spawn() because the SIH task stack is too small for libtiff and PROJ, so the terrain is a static member that the instance uses directly instead of moving it. A terrain file with an unsupported vehicle type now fails the start like a bad file instead of silently using flat ground. --------- Signed-off-by: Beniamino Pozzan <beniamino.pozzan@auterion.com> Signed-off-by: Hamish Willee <hamishwillee@gmail.com> Co-authored-by: Hamish Willee <hamishwillee@gmail.com> Co-authored-by: Matthias Grob <maetugr@gmail.com>
143 lines
3.0 KiB
Bash
Executable File
143 lines
3.0 KiB
Bash
Executable File
#! /usr/bin/env bash
|
|
|
|
## Bash script to setup PX4 development environment on Arch Linux.
|
|
## Tested on Arch 2023-03-01
|
|
##
|
|
## Installs:
|
|
## - Common dependencies and tools for nuttx
|
|
## - NuttX toolchain (omit with arg: --no-nuttx)
|
|
## - Simulation dependencies (omit with arg: --no-sim-tools)
|
|
## - Gazebo simulator (not by default, use --gazebo)
|
|
##
|
|
|
|
INSTALL_NUTTX="true"
|
|
INSTALL_SIM="true"
|
|
INSTALL_GAZEBO="false"
|
|
|
|
# Parse arguments
|
|
for arg in "$@"
|
|
do
|
|
if [[ $arg == "--no-nuttx" ]]; then
|
|
INSTALL_NUTTX="false"
|
|
fi
|
|
|
|
if [[ $arg == "--no-sim-tools" ]]; then
|
|
INSTALL_SIM="false"
|
|
fi
|
|
|
|
if [[ $arg == "--gazebo" ]]; then
|
|
INSTALL_GAZEBO="true"
|
|
fi
|
|
done
|
|
|
|
# script directory
|
|
DIR=$(dirname $0)
|
|
|
|
# check requirements.txt exists (script not run in source tree)
|
|
REQUIREMENTS_FILE="requirements.txt"
|
|
if [[ ! -f "${DIR}/${REQUIREMENTS_FILE}" ]]; then
|
|
echo "FAILED: ${REQUIREMENTS_FILE} needed in same directory as arch.sh (${DIR})."
|
|
return 1
|
|
fi
|
|
|
|
echo
|
|
echo "Installing PX4 general dependencies"
|
|
|
|
sudo pacman -Sy --noconfirm --needed \
|
|
astyle \
|
|
base-devel \
|
|
clang \
|
|
cmake \
|
|
cppcheck \
|
|
doxygen \
|
|
fuse2 \
|
|
gdb \
|
|
git \
|
|
gnutls \
|
|
nettle \
|
|
ninja \
|
|
python-pip \
|
|
rsync \
|
|
shellcheck \
|
|
tar \
|
|
unzip \
|
|
wget \
|
|
zip \
|
|
;
|
|
|
|
# Python dependencies
|
|
echo "Installing PX4 Python3 dependencies"
|
|
pip install --break-system-packages -r ${DIR}/${REQUIREMENTS_FILE}
|
|
if [[ -f "${DIR}/test-requirements.txt" ]]; then
|
|
pip install --break-system-packages -r ${DIR}/test-requirements.txt
|
|
fi
|
|
|
|
# NuttX toolchain (arm-none-eabi-gcc)
|
|
if [[ $INSTALL_NUTTX == "true" ]]; then
|
|
echo
|
|
echo "Installing NuttX dependencies"
|
|
|
|
sudo pacman -S --noconfirm --needed \
|
|
arm-none-eabi-gcc \
|
|
arm-none-eabi-newlib \
|
|
;
|
|
|
|
if [ ! -z "$USER" ]; then
|
|
# add user to dialout group (serial port access)
|
|
sudo echo usermod -aG uucp $USER
|
|
fi
|
|
|
|
# don't run modem manager (interferes with PX4 serial port usage)
|
|
sudo systemctl disable --now ModemManager
|
|
fi
|
|
|
|
# Simulation tools
|
|
if [[ $INSTALL_SIM == "true" ]]; then
|
|
echo
|
|
echo "Installing PX4 simulation dependencies"
|
|
|
|
# SIH terrain elevation (GeoTIFF DEM) support
|
|
sudo pacman -S --noconfirm --needed \
|
|
libgeotiff \
|
|
libtiff \
|
|
proj \
|
|
;
|
|
|
|
# Gazebo setup
|
|
if [[ $INSTALL_GAZEBO == "true" ]]; then
|
|
echo
|
|
echo "Installing gazebo and dependencies for PX4 gazebo simulation"
|
|
|
|
# PX4 gazebo simulation dependencies
|
|
sudo pacman -S --noconfirm --needed \
|
|
dmidecode \
|
|
eigen \
|
|
hdf5 \
|
|
opencv \
|
|
protobuf \
|
|
vtk \
|
|
yay \
|
|
;
|
|
|
|
# enable multicore gazebo compilation
|
|
sudo sed -i '/MAKEFLAGS=/c\MAKEFLAGS="-j4"' /etc/makepkg.conf
|
|
|
|
# install gazebo from AUR
|
|
yay -S gazebo --noconfirm
|
|
|
|
if sudo dmidecode -t system | grep -q "Manufacturer: VMware, Inc." ; then
|
|
# fix VMWare 3D graphics acceleration for gazebo
|
|
exportline="export SVGA_VGPU10=0"
|
|
|
|
if !grep -Fxq "$exportline" $HOME/.profile; then
|
|
echo $exportline >> $HOME/.profile;
|
|
fi
|
|
fi
|
|
fi
|
|
fi
|
|
|
|
if [[ $INSTALL_NUTTX == "true" ]]; then
|
|
echo
|
|
echo "Reboot or logout, login computer before attempting to flash NuttX targets"
|
|
fi
|