ardupilot/libraries/Desktop
Andrew Tridgell 89041c6996 sitl: support MAVLink 1.0 builds 2012-04-24 22:24:58 +10:00
..
include SITL: added pgm_read_byte_far() 2012-03-11 20:59:47 +11:00
support sitl: support MAVLink 1.0 builds 2012-04-24 22:24:58 +10:00
Desktop.mk desktop: exclude I2C library 2011-12-28 20:41:53 +11:00
Makefile.desktop sitl: added build targets for different ACM frames 2012-01-04 21:45:46 +11:00
README Update the SIL README file 2011-10-31 21:56:25 +01:00

README

This provides some support files for building APM on normal desktop
systems. This makes it possible to use debugging tools (such as gdb
and valgrind) on the APM code

The code can then run on the PC instead of on the Arduino board and
simulate the behaviour of the real system by integrating it with
X-Plane of FlightGear to build a Software-In-the-Loop (SIL) simulator.

It will use TCP sockets to communicate between the several software
components (ArduPilot, GCS and Flight simulator). All the ArduPilot
serial ports that get initialised map to separate TCP ports, which
means you can separately test the telemetry port and the main serial
port. It also makes using a debugger easier, as the debugger can use
stdin/stdout.

So the new usage is:

 1) build with "make -f ../libraries/Desktop/Makefile.desktop hil"

 2) start in a terminal like this: /tmp/ArduPlane.build/ArduPlane.elf
    it will say something like this:

      Serial port 0 on TCP port 5760
      Waiting for connection ....

 3) start a GCS, pointing it at localhost:5760. For the current
    mavproxy, you would use:

       mavproxy.py --master=tcp:localhost:5760

    MichaelO has also added support in the GCS mission planner for TCP.
    You will see a TCP option in the drop down for the serial port, then
    choose port 5760.