Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Cleanup of English by native speaker
Section
Column
width70%

Introduction

This page talk talks about Point of Interest (here called POI). You could use it for example in example for 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 (LP2Go LibrePilot2Go Android App , and GCS).

Prerequisites

  1. MAG and GPS works fine 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 works fine must work properly (see Altitude Hold)
  3. Do some successful flights in PathPlanner flightmode.
  4. You may need a an OPLink or simply use USB for telemetry connection.
Column
width30%
Panel
titleIn this page
Table of Contents

...

Section
Column
width60%

POI setup


Warning
titleAbout altitude

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

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

Look at the altitude displayed into in the Attitude tab > Settings

After a clear, this value should be updated automatically using a reliable GPS position and Geoid separation comming 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 till 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 . Cause This is because when changing HomeLocation, Waypoints will also change relative to your HomeLocation.
Anyway it will also work in PathPlanner flightmode.

Column
width30%


Section
Column
width60%

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 by where you are flying be . 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.

Column
width30%


Image 1

Image 1

Section
Column
width60%

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 before 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 aware ready to switch back to the first flightmode if something went goes wrong. 

Copter 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.

Column
width40%


Image 2

Image 2

...

Section

Use POI in PathPlanner FlightMode

Be aware that when using HomeLocation as your POI and when you change the HomeLocation all waypoints will move relative to your HomeLocation.
Its It's possible to change your waypoints 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 is 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. (its 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 finewell.
  8. Switch to PathPlanner flightmode and be ready to switch back to the first or second flightmode if something went 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 is are three waypoints around it.

POI - 3 waypoints

Section

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 finewell.
  5. Switch to PathPlanner flightmode and but be ready to switch back to first or second flightmode if something went 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