autopilot_arming_yaw.h

Go to the documentation of this file.

/*
 * Copyright (C) 2012 The Paparazzi Team
 *
 * 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.
 */

#ifndef AUTOPILOT_ARMING_YAW_H
#define AUTOPILOT_ARMING_YAW_H

#include "autopilot_rc_helpers.h"

#ifndef MOTOR_ARMING_DELAY
#define MOTOR_ARMING_DELAY  40
#endif

enum arming_state {
  STATUS_INITIALISE_RC,
  STATUS_MOTORS_AUTOMATICALLY_OFF,
  STATUS_MOTORS_AUTOMATICALLY_OFF_SAFETY_WAIT,
  STATUS_MOTORS_OFF,
  STATUS_M_OFF_STICK_PUSHED,
  STATUS_START_MOTORS,
  STATUS_MOTORS_ON,
  STATUS_M_ON_STICK_PUSHED,
  STATUS_STOP_MOTORS
};

uint32_t autopilot_motors_on_counter;
enum arming_state autopilot_check_motor_status;


static inline void autopilot_arming_init(void)
{
  autopilot_motors_on_counter = 0;
  autopilot_check_motor_status = STATUS_INITIALISE_RC;
}


static inline void autopilot_arming_set(bool motors_on)
{
  if (motors_on) {
    autopilot_check_motor_status = STATUS_MOTORS_ON;
  } else {
    autopilot_check_motor_status = STATUS_MOTORS_AUTOMATICALLY_OFF;
  }
}

static inline void autopilot_arming_check_motors_on(void)
{
  /* only allow switching motor if not in KILL mode */
  if (autopilot_get_mode() != AP_MODE_KILL) {

    switch (autopilot_check_motor_status) {
      case STATUS_INITIALISE_RC: // Wait until RC is initialised (it being centered is a good pointer to this)
        if (THROTTLE_STICK_DOWN() && YAW_STICK_CENTERED() && PITCH_STICK_CENTERED() && ROLL_STICK_CENTERED()) {
          autopilot_check_motor_status = STATUS_MOTORS_OFF;
        }
        break;
      case STATUS_MOTORS_AUTOMATICALLY_OFF: // Motors were disarmed externally
        //(possibly due to crash)
        //wait extra delay before enabling the normal arming state machine
        autopilot.motors_on = false;
        autopilot_motors_on_counter = 0;
        if (THROTTLE_STICK_DOWN() && YAW_STICK_CENTERED()) { // stick released
          autopilot_check_motor_status = STATUS_MOTORS_AUTOMATICALLY_OFF_SAFETY_WAIT;
        }
        break;
      case STATUS_MOTORS_AUTOMATICALLY_OFF_SAFETY_WAIT:
          autopilot_motors_on_counter++;
          if (autopilot_motors_on_counter >= MOTOR_ARMING_DELAY) {
            autopilot_check_motor_status = STATUS_MOTORS_OFF;
          }
        break;
      case STATUS_MOTORS_OFF:
        autopilot.motors_on = false;
        autopilot_motors_on_counter = 0;
        if (THROTTLE_STICK_DOWN() && YAW_STICK_PUSHED()) { // stick pushed
          autopilot_check_motor_status = STATUS_M_OFF_STICK_PUSHED;
        }
        break;
      case STATUS_M_OFF_STICK_PUSHED:
        autopilot.motors_on = false;
        autopilot_motors_on_counter++;
        if (autopilot_motors_on_counter >= MOTOR_ARMING_DELAY) {
          autopilot_check_motor_status = STATUS_START_MOTORS;
        } else if (!(THROTTLE_STICK_DOWN() && YAW_STICK_PUSHED())) { // stick released too soon
          autopilot_check_motor_status = STATUS_MOTORS_OFF;
        }
        break;
      case STATUS_START_MOTORS:
        autopilot.motors_on = true;
        autopilot_motors_on_counter = MOTOR_ARMING_DELAY;
        if (!(THROTTLE_STICK_DOWN() && YAW_STICK_PUSHED())) { // wait until stick released
          autopilot_check_motor_status = STATUS_MOTORS_ON;
        }
        break;
      case STATUS_MOTORS_ON:
        autopilot.motors_on = true;
        autopilot_motors_on_counter = MOTOR_ARMING_DELAY;
        if (THROTTLE_STICK_DOWN() && YAW_STICK_PUSHED()) { // stick pushed
          autopilot_check_motor_status = STATUS_M_ON_STICK_PUSHED;
        }
        break;
      case STATUS_M_ON_STICK_PUSHED:
        autopilot.motors_on = true;
        autopilot_motors_on_counter--;
        if (autopilot_motors_on_counter == 0) {
          autopilot_check_motor_status = STATUS_STOP_MOTORS;
        } else if (!(THROTTLE_STICK_DOWN() && YAW_STICK_PUSHED())) { // stick released too soon
          autopilot_check_motor_status = STATUS_MOTORS_ON;
        }
        break;
      case STATUS_STOP_MOTORS:
        autopilot.motors_on = false;
        autopilot_motors_on_counter = 0;
        if (!(THROTTLE_STICK_DOWN() && YAW_STICK_PUSHED())) { // wait until stick released
          autopilot_check_motor_status = STATUS_MOTORS_OFF;
        }
        break;
      default:
        break;
    }
  }
}

#endif /* AUTOPILOT_ARMING_YAW_H */