paparazzi/sw/airborne/autopilot.c

/*
 * Copyright (C) 2003  Pascal Brisset, Antoine Drouin
 * Copyright (C) 2008-2012 The Paparazzi Team
 * Copyright (C) 2016-2017 Gautier Hattenberger <gautier.hattenberger@enac.fr>
 *
 * 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, see
 * <http://www.gnu.org/licenses/>.
 */

/**
 * @file autopilot.c
 *
 * Core autopilot interface common to all firmwares.
 * Using either static or generated autopilot logic,
 * which depends on the firmware.
 *
 */

#include "autopilot.h"

#include "generated/modules.h"

#include "mcu_periph/uart.h"
#include "mcu_periph/sys_time.h"
#include "mcu_periph/gpio.h"
#include "subsystems/radio_control.h"
#include "subsystems/commands.h"
#include "subsystems/actuators.h"
//#include "subsystems/electrical.h"
#include "subsystems/datalink/telemetry.h"

#include "subsystems/settings.h"
#include "generated/settings.h"

#include "pprz_version.h"

struct pprz_autopilot autopilot;


static void send_autopilot_version(struct transport_tx *trans, struct link_device *dev)
{
  static uint32_t ap_version = PPRZ_VERSION_INT;
  static char *ver_desc = PPRZ_VERSION_DESC;
  pprz_msg_send_AUTOPILOT_VERSION(trans, dev, AC_ID, &ap_version, strlen(ver_desc), ver_desc);
}

static void send_alive(struct transport_tx *trans, struct link_device *dev)
{
  pprz_msg_send_ALIVE(trans, dev, AC_ID, 16, MD5SUM);
}

static void send_attitude(struct transport_tx *trans, struct link_device *dev)
{
  struct FloatEulers *att = stateGetNedToBodyEulers_f();
  pprz_msg_send_ATTITUDE(trans, dev, AC_ID, &(att->phi), &(att->psi), &(att->theta));
};

static void send_dl_value(struct transport_tx *trans, struct link_device *dev)
{
  PeriodicSendDlValue(trans, dev);
}

#ifdef RADIO_CONTROL
static void send_rc(struct transport_tx *trans, struct link_device *dev)
{
  pprz_msg_send_RC(trans, dev, AC_ID, RADIO_CONTROL_NB_CHANNEL, radio_control.values);
}
#endif

#ifdef ACTUATORS
static void send_actuators(struct transport_tx *trans, struct link_device *dev)
{
  pprz_msg_send_ACTUATORS(trans, dev, AC_ID , ACTUATORS_NB, actuators);
}
#endif


void autopilot_init(void)
{
#ifdef MODE_AUTO2
  autopilot.mode_auto2 = MODE_AUTO2; // FIXME
#endif
  autopilot.flight_time = 0;
  autopilot.motors_on = false;
  autopilot.kill_throttle = true;
  autopilot.in_flight = false;
  autopilot.ground_detected = false;
  autopilot.detect_ground_once = false;
  autopilot.use_rc = true;
  autopilot.power_switch = false;
#ifdef POWER_SWITCH_GPIO
  gpio_setup_output(POWER_SWITCH_GPIO);
  gpio_clear(POWER_SWITCH_GPIO); // POWER OFF
#endif

  // call firmware specific init
  autopilot_firmware_init();

  // static / generated AP init part is called later by main program
  // and will set the correct initial mode

  // register messages
  register_periodic_telemetry(DefaultPeriodic, PPRZ_MSG_ID_AUTOPILOT_VERSION, send_autopilot_version);
  register_periodic_telemetry(DefaultPeriodic, PPRZ_MSG_ID_ALIVE, send_alive);
  register_periodic_telemetry(DefaultPeriodic, PPRZ_MSG_ID_ATTITUDE, send_attitude);
  register_periodic_telemetry(DefaultPeriodic, PPRZ_MSG_ID_DL_VALUE, send_dl_value);
#ifdef ACTUATORS
  register_periodic_telemetry(DefaultPeriodic, PPRZ_MSG_ID_ACTUATORS, send_actuators);
#endif
#ifdef RADIO_CONTROL
  register_periodic_telemetry(DefaultPeriodic, PPRZ_MSG_ID_RC, send_rc);
#endif
}

/** AP periodic call
 */
void autopilot_periodic(void)
{
#if USE_GENERATED_AUTOPILOT
  autopilot_generated_periodic();
#else
  autopilot_static_periodic();
#endif
}

/** AP event call
 */
void WEAK autopilot_event(void) {}

/** RC frame handler
 */
void autopilot_on_rc_frame(void)
{
#if USE_GENERATED_AUTOPILOT
  autopilot_generated_on_rc_frame();
#else
  autopilot_static_on_rc_frame();
#endif
}

/** set autopilot mode
 */
bool autopilot_set_mode(uint8_t new_autopilot_mode)
{
#if USE_GENERATED_AUTOPILOT
  autopilot_generated_set_mode(new_autopilot_mode);
#else
  autopilot_static_set_mode(new_autopilot_mode);
#endif
  return (autopilot.mode != new_autopilot_mode);
}

/** AP mode setting handler
 */
void autopilot_SetModeHandler(float mode)
{
#if USE_GENERATED_AUTOPILOT
  autopilot_generated_SetModeHandler(mode);
#else
  autopilot_static_SetModeHandler(mode);
#endif
}

/** get autopilot mode
 */
uint8_t autopilot_get_mode(void)
{
  return autopilot.mode;
}

/** reset flight time and launch
 */
void autopilot_reset_flight_time(void)
{
  autopilot.flight_time = 0;
  autopilot.launch = false;
}

/** turn motors on/off, eventually depending of the current mode
 *  set kill_throttle accordingly FIXME is it true for FW firmware ?
 */
void autopilot_set_motors_on(bool motors_on)
{
#if USE_GENERATED_AUTOPILOT
  autopilot_generated_set_motors_on(motors_on);
#else
  autopilot_static_set_motors_on(motors_on);
#endif
  autopilot.kill_throttle = ! autopilot.motors_on;
}

/** get motors status
 */
bool autopilot_get_motors_on(void)
{
  return autopilot.motors_on;
}

/** set kill throttle
 */
void autopilot_set_kill_throttle(bool kill)
{
  if (kill) {
    autopilot_set_motors_on(false);
  } else {
    autopilot_set_motors_on(true);
  }
}

/** get kill status
 */
bool autopilot_throttle_killed(void)
{
  return autopilot.kill_throttle;
}

/** in flight check utility function
 *  actual implementation is firmware dependent
 */
void WEAK autopilot_check_in_flight(bool motors_on __attribute__((unused))) {}

/** reset in_flight counter
 *  actual implementation is firmware dependent
 */
void WEAK autopilot_reset_in_flight_counter(void) {}

/** set in_flight flag
 */
void autopilot_set_in_flight(bool in_flight)
{
  autopilot.in_flight = in_flight;
  if (!in_flight) {
    autopilot_reset_in_flight_counter();
  }
}

/** get in_flight flag
 */
bool autopilot_in_flight(void)
{
  return autopilot.in_flight;
}

/** set power switch
 */
void autopilot_set_power_switch(bool power_switch)
{
#ifdef POWER_SWITCH_GPIO
  if (power_switch) {
    gpio_set(POWER_SWITCH_GPIO);
  } else {
    gpio_clear(POWER_SWITCH_GPIO);
  }
#endif
  autopilot.power_switch = power_switch;
}

/** store settings
 */
void autopilot_store_settings(void)
{
  if (autopilot.kill_throttle) {
    settings_store_flag = true;
    settings_store();
  }
}

/** clear settings
 */
void autopilot_clear_settings(void)
{
  if (autopilot.kill_throttle) {
    settings_clear_flag = true;
    settings_clear();
  }
}

/** send autopilot version
 */
void autopilot_send_version(void)
{
  send_autopilot_version(&(DefaultChannel).trans_tx, &(DefaultDevice).device);
}

/** send autopilot mode
 *  actual implementation is firmware dependent
 */
void WEAK autopilot_send_mode(void) {}