// ArduSub position hold flight mode // GPS required // Jacob Walser August 2016 #include "Sub.h" #if POSHOLD_ENABLED == ENABLED // poshold_init - initialise PosHold controller bool Sub::poshold_init() { // fail to initialise PosHold mode if no GPS lock if (!position_ok()) { return false; } // initialize vertical speeds and acceleration pos_control.set_max_speed_accel_xy(wp_nav.get_default_speed_xy(), wp_nav.get_wp_acceleration()); pos_control.set_correction_speed_accel_xy(wp_nav.get_default_speed_xy(), wp_nav.get_wp_acceleration()); pos_control.set_max_speed_accel_z(-get_pilot_speed_dn(), g.pilot_speed_up, g.pilot_accel_z); pos_control.set_correction_speed_accel_z(-get_pilot_speed_dn(), g.pilot_speed_up, g.pilot_accel_z); // initialise position and desired velocity pos_control.init_xy_controller_stopping_point(); // Stop all thrusters attitude_control.set_throttle_out(0.75,true,100.0); pos_control.init_z_controller(); // initialise position and desired velocity float pos = stopping_distance(); float zero = 0; pos_control.input_pos_vel_accel_z(pos, zero, zero); last_pilot_heading = ahrs.yaw_sensor; return true; } // poshold_run - runs the PosHold controller // should be called at 100hz or more void Sub::poshold_run() { uint32_t tnow = AP_HAL::millis(); // When unarmed, disable motors and stabilization if (!motors.armed()) { motors.set_desired_spool_state(AP_Motors::DesiredSpoolState::GROUND_IDLE); // Sub vehicles do not stabilize roll/pitch/yaw when not auto-armed (i.e. on the ground, pilot has never raised throttle) attitude_control.set_throttle_out(0.75f ,true, g.throttle_filt); attitude_control.relax_attitude_controllers(); pos_control.relax_velocity_controller_xy(); pos_control.relax_z_controller(0.5f); last_pilot_heading = ahrs.yaw_sensor; return; } // set motors to full range motors.set_desired_spool_state(AP_Motors::DesiredSpoolState::THROTTLE_UNLIMITED); /////////////////////// // update xy outputs // float pilot_lateral = channel_lateral->norm_input(); float pilot_forward = channel_forward->norm_input(); float lateral_out = 0; float forward_out = 0; if (position_ok()) { // Allow pilot to reposition the sub if (fabsf(pilot_lateral) > 0.1 || fabsf(pilot_forward) > 0.1) { pos_control.init_xy_controller_stopping_point(); } translate_pos_control_rp(lateral_out, forward_out); pos_control.update_xy_controller(); } else { pos_control.init_xy_controller_stopping_point(); } ///////////////////// // Update attitude // // get pilot's desired yaw rate float yaw_input = channel_yaw->pwm_to_angle_dz_trim(channel_yaw->get_dead_zone() * gain, channel_yaw->get_radio_trim()); float target_yaw_rate = get_pilot_desired_yaw_rate(yaw_input); // convert pilot input to lean angles // To-Do: convert get_pilot_desired_lean_angles to return angles as floats float target_roll, target_pitch; get_pilot_desired_lean_angles(channel_roll->get_control_in(), channel_pitch->get_control_in(), target_roll, target_pitch, aparm.angle_max); // update attitude controller targets if (!is_zero(target_yaw_rate)) { // call attitude controller with rate yaw determined by pilot input attitude_control.input_euler_angle_roll_pitch_euler_rate_yaw(target_roll, target_pitch, target_yaw_rate); last_pilot_heading = ahrs.yaw_sensor; last_pilot_yaw_input_ms = tnow; // time when pilot last changed heading } else { // hold current heading // this check is required to prevent bounce back after very fast yaw maneuvers // the inertia of the vehicle causes the heading to move slightly past the point when pilot input actually stopped if (tnow < last_pilot_yaw_input_ms + 250) { // give 250ms to slow down, then set target heading target_yaw_rate = 0; // Stop rotation on yaw axis // call attitude controller with target yaw rate = 0 to decelerate on yaw axis attitude_control.input_euler_angle_roll_pitch_euler_rate_yaw(target_roll, target_pitch, target_yaw_rate); last_pilot_heading = ahrs.yaw_sensor; // update heading to hold } else { // call attitude controller holding absolute absolute bearing attitude_control.input_euler_angle_roll_pitch_yaw(target_roll, target_pitch, last_pilot_heading, true); } } // Update z axis // control_depth(); motors.set_forward(motors.get_forward() + forward_out + pilot_forward); motors.set_lateral(motors.get_lateral() + lateral_out + pilot_lateral); } #endif // POSHOLD_ENABLED == ENABLED