mission_rotorcraft_nav.c

Go to the documentation of this file.

/*
 * Copyright (C) 2014 Kadir Cimenci
 *
 * This file is part of paparazzi.
 *
 * paparazzi is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2, or (at your option)
 * any later version.
 *
 * paparazzi is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with paparazzi; see the file COPYING.  If not, write to
 * the Free Software Foundation, 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 *
 */
 
#include <stdio.h>
#include "modules/mission/mission_common.h"
#include "autopilot.h"
#include "firmwares/rotorcraft/navigation.h"
#include "generated/flight_plan.h"
 
 
//Buffer zone in [m] before MAX_DIST_FROM_HOME
#define BUFFER_ZONE_DIST 10
 
bool mission_point_of_lla(struct EnuCoor_f *point, struct LlaCoor_i *lla)
{
  // return FALSE if there is no valid local coordinate system
  if (!state.ned_initialized_i) {
    return false;
  }
 
  // change geoid alt to ellipsoid alt
  lla->alt = lla->alt - stateGetHmslOrigin_i() + stateGetLlaOrigin_i().alt;
 
  //Compute ENU components from LLA with respect to ltp origin
  struct EnuCoor_i tmp_enu_point_i;
  enu_of_lla_point_i(&tmp_enu_point_i, stateGetNedOrigin_i(), lla);
  struct EnuCoor_f tmp_enu_point_f;
  // result of enu_of_lla_point_i is in cm, convert to float in m
  VECT3_SMUL(tmp_enu_point_f, tmp_enu_point_i, 0.01);
 
  //Bound the new waypoint with max distance from home
  struct FloatVect2 home;
  home.x = waypoint_get_x(WP_HOME);
  home.y = waypoint_get_y(WP_HOME);
  struct FloatVect2 vect_from_home;
  VECT2_DIFF(vect_from_home, tmp_enu_point_f, home);
  //Saturate the mission wp not to overflow max_dist_from_home
  //including a buffer zone before limits
  float dist_to_home = float_vect2_norm(&vect_from_home);
  dist_to_home += BUFFER_ZONE_DIST;
  if (dist_to_home > MAX_DIST_FROM_HOME) {
    VECT2_SMUL(vect_from_home, vect_from_home, (MAX_DIST_FROM_HOME / dist_to_home));
  }
  // set new point
  VECT2_SUM(*point, home, vect_from_home);
  point->z = tmp_enu_point_f.z;
 
  return true;
}
bool mission_point_of_lla(struct EnuCoor_f *point, struct LlaCoor_i *lla) {…}
 
// navigation time step
static const float dt_navigation = 1.0f / ((float)NAVIGATION_FREQUENCY);
 
//  last_mission_wp, last target wp from mission elements, not used actively and kept for future implementations
struct EnuCoor_f last_mission_wp = { 0.f, 0.f, 0.f };
 
static inline bool mission_nav_wp(struct _mission_element *el)
{
  struct EnuCoor_f *target_wp = &(el->element.mission_wp.wp);
 
  //Check proximity and wait for 'duration' seconds in proximity circle if desired
  if (nav.nav_approaching(target_wp, NULL, CARROT)
#ifdef MISSION_ALT_PROXIMITY
      && fabsf(stateGetPositionEnu_f()->z - target_wp->z) <= MISSION_ALT_PROXIMITY
#endif
      ) {
    last_mission_wp = *target_wp;
 
    if (el->duration > 0.f) {
      if (nav_check_wp_time(target_wp, el->duration)) { return false; }
    } else { return false; }
 
  }
  //Go to Mission Waypoint
  nav.nav_goto(target_wp);
  NavVerticalAutoThrottleMode(RadOfDeg(0.f));
  NavVerticalAltitudeMode(target_wp->z, 0.f);
 
  return true;
}
static inline bool mission_nav_wp(struct _mission_element *el) {…}
 
static inline bool mission_nav_circle(struct _mission_element *el)
{
  struct EnuCoor_f *center_wp = &(el->element.mission_circle.center);
  float radius = el->element.mission_circle.radius;
 
  //Draw the desired circle for a 'duration' time
  nav.nav_circle(center_wp, radius);
  NavVerticalAutoThrottleMode(RadOfDeg(0.f));
  NavVerticalAltitudeMode(center_wp->z, 0.f);
 
  if (el->duration > 0.f && mission.element_time >= el->duration) {
    return false;
  }
 
  return true;
}
static inline bool mission_nav_circle(struct _mission_element *el) {…}
 
static inline bool mission_nav_segment(struct _mission_element *el)
{
  struct EnuCoor_f *from_wp = &(el->element.mission_segment.from);
  struct EnuCoor_f *to_wp   = &(el->element.mission_segment.to);
 
  //Check proximity and wait for 'duration' seconds in proximity circle if desired
  if (nav.nav_approaching(to_wp, from_wp, CARROT)
#ifdef MISSION_ALT_PROXIMITY
      && fabsf(stateGetPositionEnu_f()->z - to_wp->z) <= MISSION_ALT_PROXIMITY
#endif
      ) {
    last_mission_wp = *to_wp;
 
    if (el->duration > 0.f) {
      if (nav_check_wp_time(to_wp, el->duration)) { return false; }
    } else { return false; }
  }
 
  //Route Between from-to
  nav.nav_route(from_wp, to_wp);
  NavVerticalAutoThrottleMode(RadOfDeg(0.f));
  NavVerticalAltitudeMode(to_wp->z, 0.f);
 
  return true;
}
static inline bool mission_nav_segment(struct _mission_element *el) {…}
 
 
#ifndef MISSION_PATH_SKIP_GOTO
#define MISSION_PATH_SKIP_GOTO FALSE
#endif
 
static inline bool mission_nav_path(struct _mission_element *el)
{
  if (el->element.mission_path.nb == 0) {
    return false; // nothing to do
  }
 
  if (el->element.mission_path.path_idx == 0) { //first wp of path
    el->element.mission_wp.wp = el->element.mission_path.path[0];
    if (MISSION_PATH_SKIP_GOTO || !mission_nav_wp(el)) { el->element.mission_path.path_idx++; }
  }
 
  else if (el->element.mission_path.path_idx < el->element.mission_path.nb) { //standart wp of path
 
    struct EnuCoor_f *from_wp = &(el->element.mission_path.path[(el->element.mission_path.path_idx) - 1]);
    struct EnuCoor_f *to_wp   = &(el->element.mission_path.path[el->element.mission_path.path_idx]);
 
    //Check proximity and wait for t seconds in proximity circle if desired
    if (nav.nav_approaching(to_wp, from_wp, CARROT)
#ifdef MISSION_ALT_PROXIMITY
      && fabsf(stateGetPositionEnu_f()->z - from_wp->z) <= MISSION_ALT_PROXIMITY
#endif
        ) {
      last_mission_wp = *to_wp;
 
      if (el->duration > 0.f) {
        if (nav_check_wp_time(to_wp, el->duration)) {
          el->element.mission_path.path_idx++;
        }
      } else { el->element.mission_path.path_idx++; }
    }
    //Route Between from-to
    nav.nav_route(from_wp, to_wp);
    NavVerticalAutoThrottleMode(RadOfDeg(0.f));
    NavVerticalAltitudeMode(from_wp->z, 0.f);
  } else { return false; } //end of path
 
  return true;
}
static inline bool mission_nav_path(struct _mission_element *el) {…}
 
static inline bool mission_nav_custom(struct _mission_custom *custom, bool init)
{
  if (init) {
    return custom->reg->cb(custom->nb, custom->params, MissionInit);
  } else {
    return custom->reg->cb(custom->nb, custom->params, MissionRun);
  }
}
static inline bool mission_nav_custom(struct _mission_custom *custom, bool init) {…}
 
#ifndef MISSION_WAIT_TIMEOUT
#define MISSION_WAIT_TIMEOUT 30 // wait 30 seconds before ending mission
#endif
 
static bool mission_wait_started = false;
#if MISSION_WAIT_TIMEOUT
static float mission_wait_time = 0.f;
static struct _mission_element mission_wait_wp;
static bool mission_wait_pattern(void) {
  if (!mission_wait_started) {
    mission_wait_wp.element.mission_wp.wp = *stateGetPositionEnu_f();
    mission_wait_time = 0.f;
    mission_wait_started = true;
  }
  mission_nav_wp(&mission_wait_wp);
  mission_wait_time += dt_navigation;
  return (mission_wait_time < (float)MISSION_WAIT_TIMEOUT); // keep flying until TIMEOUT
}
#else
static bool mission_wait_pattern(void) {
  return false; // no TIMEOUT, end mission now
}
static bool mission_wait_pattern(void) {…}
#endif
 
int mission_run()
{
  // current element
  struct _mission_element *el = NULL;
  if ((el = mission_get()) == NULL) {
    return mission_wait_pattern();
  }
  mission_wait_started = false;
 
  bool el_running = false;
  switch (el->type) {
    case MissionWP:
      el_running = mission_nav_wp(el);
      break;
    case MissionCircle:
      el_running = mission_nav_circle(el);
      break;
    case MissionSegment:
      el_running = mission_nav_segment(el);
      break;
    case MissionPath:
      el_running = mission_nav_path(el);
      break;
    case MissionCustom:
      el_running = mission_nav_custom(&(el->element.mission_custom), mission.element_time < dt_navigation);
      break;
    default:
      // invalid type or pattern not yet handled
      break;
  }
 
  // increment element_time
  mission.element_time += dt_navigation;
 
  if (!el_running) {
    // reset timer
    mission.element_time = 0.;
    // go to next element
    mission.current_idx = (mission.current_idx + 1) % MISSION_ELEMENT_NB;
  }
  return true;
}
int mission_run() {…}