jMAVSim 仿真模拟 · PX4 Developer Guide

jMAVSim是一个简单的多旋翼/四旋翼仿真软件，它可以允许你在仿真环境中飞行运行着 PX4 的 旋翼 无人机。 它很容易设置，可以用来测试您的工具是否可以起飞、飞行、降落、并对各种故障条件 (例如 gps 故障) 做出适当的反应。

支持机型：

• 四旋翼

本问主要演示如何设置 jMAVSim 以连接到 SITL 版本的 PX4 。

jMAVSim 也可以用 HITL 仿真(看这里

仿真环境

软件在环仿真在主机上运行仿真系统的全部组件，使用软件来模拟真实飞控， 并通过当地网络实现与仿真软件的连接。 整套仿真方案设置如下：

运行 SITL

在确保 仿真环境 已经搭建在电脑上了之后直接运行命令：便捷的 make target 命令会完成 POSIX 平台的交叉编译并启动仿真。

make px4_sitl_default jmavsim

该命令最终将得到如下 PX4 控制台显示界面：

[init] shell id: 140735313310464
[init] task name: px4

______  __   __    ___ 
| ___ \ \ \ / /   /   |
| |_/ /  \ V /   / /| |
|  __/   /   \  / /_| |
| |     / /^\ \ \___  |
\_|     \/   \/     |_/

Ready to fly.


pxh>

此外，它还会打开一个显示 jMAVSim 仿真器的3D视图的界面。

简单飞上天

系统将开始输出状态信息。 飞机完成位置锁定之后（控制台立刻提示： EKF commencing GPS fusion 信息之后不久 ）就可以开始飞行了。

在控制台输入以下命令进行起飞：

pxh> commander takeoff

你可以使用 QGroundControl 规划一个飞行任务，或者连接一个 操纵杆 。

可选参数配置

指定起飞位置

手动设定环境变量可以覆盖默认的起飞点坐标： PX4_HOME_LAT, PX4_HOME_LON, 以及 PX4_HOME_ALT 。

例如，要设置飞机的维度、经度和海拔高度：

export PX4_HOME_LAT=28.452386
export PX4_HOME_LON=-13.867138
export PX4_HOME_ALT=28.5
make px4_sitl_default jmavsim

更改仿真的时间流速

可以使用环境变量 PX4_SIM_SPEED_FACTOR 增长或者缩短仿真环境的时间流速相对于实际时间流速的大小。

export PX4_SIM_SPEED_FACTOR=2
make px4_sitl_default jmavsim

更多相关信息请参考：Simulation > Run Simulation Faster than Realtime.

使用游戏手柄

通过 QGroundControl 可引入游戏手柄或者拇指操纵杆（如何进行设置看这里）。

模拟一个 Wifi 无人机

有一个特殊的平台可以模拟通过本地 Wifi 网络进行连接无人机。

make broadcast jmavsim

模拟器会跟真实的该类无人机一样在当地网络中广播自己的位置信息等。

分别启动 JMAVSim 和 PX4

你可以单独启动 JMAVSim 和 PX4:

./Tools/jmavsim_run.sh -l
make px4_sitl none

此举可以缩短测试循环时间（重启 jMAVSim 需要耗费非常多的时间）。

无航向模式

要使用没有jMAVSim图形界面的仿真，请设置如下环境变量 HEADLESS=1

HEADLESS=1 make px4_sitl jmavsim

多机仿真

JMAVSim也常用做多机仿真，更多请参考：JMAVSim多机当真

扩展和自定义

如果要扩展或自定义仿真接口，可以编辑 Tools/jMAVSim 里面文件。 源码可以从 Github 上的 jMAVSim 库 获取。

编译系统会强制检查所有依赖项的子模块正确无误，其中就包括了模拟器。 但是，它不会直接覆盖你对目录中文件所做的更改， 当提交这些更改时你需要在 固件 库中重新为子模块注册新的哈希值。 为此,，使用 git add Tools/jMAVSim 并提交你的更改。 这就会更新仿真器中 GIT 哈希值。

ROS 交互

仿真器中跟真实飞机一样方式实现 与 ROS 交互 。

值得一看的脚本文件

• The startup scripts are discussed in System Startup.
• 已仿真的根文件系统 ("/" 目录) 是在编译文件里面生成的： build/px4_sitl_default/tmp/rootfs

常见问题处理

java.long.NoClassDefFoundError

如果你遇到如下的错误，原因可能是你的 Java 版本高于8：

Exception in thread "main" java.lang.NoClassDefFoundError: javax/vecmath/Tuple3d
at java.base/java.lang.Class.forName0(Native Method)
at java.base/java.lang.Class.forName(Class.java:374)
at org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader.main(JarRsrcLoader.java:56)
Caused by: java.lang.ClassNotFoundException: javax.vecmath.Tuple3d
at java.base/java.net.URLClassLoader.findClass(URLClassLoader.java:466)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:566)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:499)
... 3 more
Exception in thread "main" java.lang.NoClassDefFoundError: javax/vecmath/Tuple3d
at java.base/java.lang.Class.forName0(Native Method)
at java.base/java.lang.Class.forName(Class.java:374)
at org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader.main(JarRsrcLoader.java:56)
Caused by: java.lang.ClassNotFoundException: javax.vecmath.Tuple3d
at java.base/java.net.URLClassLoader.findClass(URLClassLoader.java:466)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:566)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:499)

更多详情，请查阅 GitHub issue 。

解决方法是安装 Java 8 ，如下各小节所示。

Ubuntu：

sudo apt install openjdk-8-jdk
sudo update-alternatives --config java # 选择Java 8 的指令
rm -rf Tools/jMAVSim/out

Mac系统：

要么直接下载 </a>Oracle Java 8 要么使用Brew下载：</p>

brew tap homebrew/cask-versions
brew cask install java8
brew install ant
export JAVA_HOME=$(/usr/libexec/java_home -v 1.8)
rm -rf Tools/jMAVSim/out

java.awt.AWTError: Assistive Technology not found: org.GNOME.Accessibility.AtkWrapper

Exception in thread "main" java.lang.reflect.InvocationTargetException
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
at java.lang.reflect.Method.invoke(Method.java:498)
at org.eclipse.jdt.internal.jarinjarloader.JarRsrcLoader.main(JarRsrcLoader.java:58)
Caused by: java.awt.AWTError: Assistive Technology not found: org.GNOME.Accessibility.AtkWrapper
at java.awt.Toolkit.loadAssistiveTechnologies(Toolkit.java:807)
at java.awt.Toolkit.getDefaultToolkit(Toolkit.java:886)
at java.awt.Window.getToolkit(Window.java:1358)
at java.awt.Window.init(Window.java:506)
at java.awt.Window.(Window.java:537)
at java.awt.Frame.(Frame.java:420)
at java.awt.Frame.(Frame.java:385)
at javax.swing.JFrame.(JFrame.java:189)
at me.drton.jmavsim.Visualizer3D.(Visualizer3D.java:104)
at me.drton.jmavsim.Simulator.(Simulator.java:157)
at me.drton.jmavsim.Simulator.main(Simulator.java:678)

如果遇到类似错误，可以尝试如下解决方法：

通过下面命令，修改 accessibility.properties 文件：

sudo gedit /etc/java-8-openjdk/accessibility.properties

并注释下面所指示的一行：

#assistive_technologies=org.GNOME.Acessibility.AtkWrapper

更多问题，请参阅 GitHub issue 。 该解决方案引自于 。