This topic shows how to quickly install a DroneKit-Python development environment and run a simple example to get vehicle attributes from a simulated Copter.
DroneKit-Python and the dronekit-sitl simulator are installed from pip on all platforms.
On Linux you will first need to install pip and python-dev:
sudo apt-get install python-pip python-dev
pip is then used to install dronekit and dronekit-sitl.
Mac and Linux may require you to prefix these commands with
pip install dronekit pip install dronekit-sitl
The script below first launches the simulator. It then
imports and calls the
specifying the simulator’s connection string (
The method returns a
Vehicle object that
we then use to query the attributes.
print "Start simulator (SITL)" import dronekit_sitl sitl = dronekit_sitl.start_default() connection_string = sitl.connection_string() # Import DroneKit-Python from dronekit import connect, VehicleMode # Connect to the Vehicle. print("Connecting to vehicle on: %s" % (connection_string,)) vehicle = connect(connection_string, wait_ready=True) # Get some vehicle attributes (state) print "Get some vehicle attribute values:" print " GPS: %s" % vehicle.gps_0 print " Battery: %s" % vehicle.battery print " Last Heartbeat: %s" % vehicle.last_heartbeat print " Is Armable?: %s" % vehicle.is_armable print " System status: %s" % vehicle.system_status.state print " Mode: %s" % vehicle.mode.name # settable # Close vehicle object before exiting script vehicle.close() # Shut down simulator sitl.stop() print("Completed")
Copy the text above into a new text file (hello.py) and run it in the same way as you would any other standalone Python script.
You should see the following output from the simulated vehicle:
Start simulator (SITL) Downloading SITL from http://dronekit-assets.s3.amazonaws.com/sitl/copter/sitl-win-copter-3.3.tar.gz Extracted. Connecting to vehicle on: 'tcp:127.0.0.1:5760' >>> APM:Copter V3.3 (d6053245) >>> Frame: QUAD >>> Calibrating barometer >>> Initialising APM... >>> barometer calibration complete >>> GROUND START Get some vehicle attribute values: GPS: GPSInfo:fix=3,num_sat=10 Battery: Battery:voltage=12.587,current=0.0,level=100 Last Heartbeat: 0.713999986649 Is Armable?: False System status: STANDBY Mode: STABILIZE Completed
That’s it- you’ve run your first DroneKit-Python script.