Autonomous POI setup

Introduction

This page talks about Point of Interest (here called POI). You could use it for example in aerial photography. Your vehicle nose will always point to the POI when using autonomous flight modes like Position Hold, PathPlanner or GPS Assist (not tested yet).

This is the manual use of POI, in future releases there will be easier ways to set the POI (LibrePilot2Go Android App and GCS).

Prerequisites

  1. MAG and GPS must work properly (see here for help with MAG problems Aux Mag Setup and Calibration or search the Forum https://forum.librepilot.org)
  2. Altitude Hold must work properly (see Altitude Hold)
  3. Do some successful flights in PathPlanner flightmode.
  4. You may need an OPLink or simply use USB for telemetry connection.
In this page



POI setup


About altitude

The WGS84 altitude in HomeLocation does not refer to the common altitude (usually MSL : Mean Sea Level) of a location but takes in account others parameters like the Geoid separation:

Altitude (WGS84) = Height (MSL) + Geoid Separation

Look at the altitude displayed in the Attitude tab > Settings

After a clear, this value should be updated automatically using a reliable GPS position and Geoid separation coming from GPS.
Next you should use this altitude value as reference for your HomeLocation/POI settings.

HomeLocation as POI Location

  1. Power your copter and connect to telemetry with GCS over OPLink or USB
  2. Wait until you get a good GPS signal and reliable position.
  3. Set your HomeLocation where your POI should be. Be sure to set height correctly (Its important because its needed for PathPlanner flightmode)

Now the POI is always there where your HomeLocation is set. That's not a good idea if you want to use pathplanner flightmode or use the HomeLocation for RTB . This is because when changing HomeLocation, Waypoints will also change relative to your HomeLocation.
Anyway it will also work in PathPlanner flightmode.


POI Location with fixed HomeLocation

  1. Power your copter and connect to telemetry with GCS over OPLink (USB will also work but then your copter is limited in movement, see step 4)
  2. Wait till you get a good GPS signal and reliable position.
  3. Set your HomePosition near where you are flying. Be sure to set height correctly (Its important because in PathPlanner flightmode copter will first fly to HomeLocation and then to the waypoints and heights for waypoints will be used from HomeLocation)
  4. Take your copter and move it to the location where POI should be and leave it there.
  5. Go to System > Data Objects  and open up PoiLocation and PositionState.
  6. Click on the North value (standard 0,0000) at PoiLocation and set it to the value of North from PositionState (Don't hit enter or click elsewhere with mouse after input value, otherwise it will be overwritten by telemetry data from flight controller).
  7. Click on the red Up arrow on the top
  8. Repeat step 6 and 7 for East and Down values

Now your POI is set to the actual position of your copter. If you want to move the POI you can just repeat steps 4 - 8. And the good thing is that you always have a safe HomeLocation for example in case of RTB.


Image 1

Image 1

Activate / Deactivate YAW Control

Now that you have set up the POI Location you must activate it for autonomous flight modes. Which means that your copters front will always point to the POI you defined earlier after activating the YAW control.

  • To activate YAW Control go to System > VtolPathFollowerSettings > YawControl and choose POI (see image 2)
  • To deactivate YAW Control go to System > VtolPathFollowerSettings > YawControl and choose Manual

Test it!

  1. Set up a first flightmode in normal Attitude mode for take off (or another mode just for take off)
  2. Set up a second flight mode with Position Hold
  3. Take off in first flightmode
  4. Switch to second flight mode (Position Hold) but be ready to switch back to the first flightmode if something goes wrong. 

The copter should now Yaw automatically and point to your defined POI. Be prepared, the initial Yawing could be really fast, it depends on your Rate YAW.


Image 2

Image 2




Use POI in PathPlanner FlightMode

Be aware that when using HomeLocation as your POI when you change the HomeLocation all waypoints will move relative to your HomeLocation.
It's possible to change your waypoint parameters to absolute coordinates (In WayPoint Editor set Relative to Home to false) but this has not been tested yet.

Example 1 (3 waypoints)

  1. Set up a flightmode in normal Attitude mode for take off (or another mode just for take off)
  2. Set up a second flight mode with Velocity Roam (just to be sure GPS mode is working fine)
  3. Set up a third flightmode with PathPlanner
  4. Do POI Setup (see above) and Activate YAW Control (see above).
  5. Go to Flight Data Tab and put in 3 waypoints (it's best if the waypoints are around your POI):
    1. Right click on the map and choose AddWaypoint.
    2. Do the same for the other 2 waypoints.
    3. Move the waypoints with leftmouse hold to the position where you want them to be.
    4. Right click on map and choose WaypointEditor.
    5. Double check Positions (they're relative to your Homeposition) and AltitudeAboveHome. (it's the height above your Homeposition, so again be sure your Homeposition height is set correctly)
    6. In WaypointEditor click on the green up Arrow to send the pathplan data to your copter.
  6. Take off in the first flightmode, it can be as simple as Attitude mode.
  7. Switch to Velocity roam and check if everything works well.
  8. Switch to PathPlanner flightmode and be ready to switch back to the first or second flightmode if something goes wrong.

Now your copter should fly first to HomeLocation and then to the waypoints with it's nose always pointing to your POI. It will repeat the flightplan until you switch to another flightmode.

See the picture below, in this example POI is set to HomeLocation and there are three waypoints around it.

POI - 3 waypoints

Example 2 (Circle around POI)

  1. See steps 1 - 4 in Example 1
  2. Go to the Flight Data Tab and put in 2 waypoints:
    1. Right click on the map and choose AddWaypoint.
    2. Do the same for the second waypoint
    3. Move the second waypoint to your POI location.
    4. Move the first waypoint to somewhere outside your POI. (this will be the radius of the circle)
    5. Right click on map and choose WaypointEditor.
    6. Double check Positions (they're relative to your Homeposition) and AltitudeAboveHome. (its the height above your Homeposition, so again be sure your Homeposition height is set correctly)
    7. Change the mode of the second waypoint to circle right or circle left
    8. In WaypointEditor click on the green up Arrow to send the pathplan to your copter
  3. Take off in the first flightmode, it can be as simple as Attitude mode.
  4. Switch to Velocity roam and check if everything works well.
  5. Switch to PathPlanner flightmode but be ready to switch back to first or second flightmode if something goes wrong.

Now your copter should fly first to the HomeLocation, then to the first waypoint and the begin to circle around your POI with nose always pointing to your POI. It will repeat the flightplan until you switch to another flightmode.

See the picture below, in this example POI is set to HomeLocation:

POI - Circle