#include "AP_Parachute.h" #include #include #include #include #include #include #include #include extern const AP_HAL::HAL& hal; const AP_Param::GroupInfo AP_Parachute::var_info[] = { // @Param: ENABLED // @DisplayName: Parachute release enabled or disabled // @Description: Parachute release enabled or disabled // @Values: 0:Disabled,1:Enabled // @User: Standard AP_GROUPINFO_FLAGS("ENABLED", 0, AP_Parachute, _enabled, 0, AP_PARAM_FLAG_ENABLE), // @Param: TYPE // @DisplayName: Parachute release mechanism type (relay or servo) // @Description: Parachute release mechanism type (relay or servo) // @Values: 0:First Relay,1:Second Relay,2:Third Relay,3:Fourth Relay,10:Servo // @User: Standard AP_GROUPINFO("TYPE", 1, AP_Parachute, _release_type, AP_PARACHUTE_TRIGGER_TYPE_RELAY_0), // @Param: SERVO_ON // @DisplayName: Parachute Servo ON PWM value // @Description: Parachute Servo PWM value in microseconds when parachute is released // @Range: 1000 2000 // @Units: PWM // @Increment: 1 // @User: Standard AP_GROUPINFO("SERVO_ON", 2, AP_Parachute, _servo_on_pwm, AP_PARACHUTE_SERVO_ON_PWM_DEFAULT), // @Param: SERVO_OFF // @DisplayName: Servo OFF PWM value // @Description: Parachute Servo PWM value in microseconds when parachute is not released // @Range: 1000 2000 // @Units: PWM // @Increment: 1 // @User: Standard AP_GROUPINFO("SERVO_OFF", 3, AP_Parachute, _servo_off_pwm, AP_PARACHUTE_SERVO_OFF_PWM_DEFAULT), // @Param: ALT_MIN // @DisplayName: Parachute min altitude in meters above home // @Description: Parachute min altitude above home. Parachute will not be released below this altitude. 0 to disable alt check. // @Range: 0 32000 // @Units: m // @Increment: 1 // @User: Standard AP_GROUPINFO("ALT_MIN", 4, AP_Parachute, _alt_min, AP_PARACHUTE_ALT_MIN_DEFAULT), // @Param: DELAY_MS // @DisplayName: Parachute release delay // @Description: Delay in millseconds between motor stop and chute release // @Range: 0 5000 // @Units: ms // @Increment: 1 // @User: Standard AP_GROUPINFO("DELAY_MS", 5, AP_Parachute, _delay_ms, AP_PARACHUTE_RELEASE_DELAY_MS), // @Param: CRT_SINK // @DisplayName: Critical sink speed rate in m/s to trigger emergency parachute // @Description: Release parachute when critical sink rate is reached // @Range: 0 15 // @Units: m/s // @Increment: 1 // @User: Standard AP_GROUPINFO("CRT_SINK", 6, AP_Parachute, _critical_sink, AP_PARACHUTE_CRITICAL_SINK_DEFAULT), AP_GROUPEND }; /// enabled - enable or disable parachute release void AP_Parachute::enabled(bool on_off) { _enabled = on_off; // clear release_time _release_time = 0; AP::logger().Write_Event(_enabled ? DATA_PARACHUTE_ENABLED : DATA_PARACHUTE_DISABLED); } /// release - release parachute void AP_Parachute::release() { // exit immediately if not enabled if (_enabled <= 0) { return; } gcs().send_text(MAV_SEVERITY_INFO,"Parachute: Released"); AP::logger().Write_Event(DATA_PARACHUTE_RELEASED); // set release time to current system time if (_release_time == 0) { _release_time = AP_HAL::millis(); } _release_initiated = true; // update AP_Notify AP_Notify::flags.parachute_release = 1; } /// update - shuts off the trigger should be called at about 10hz void AP_Parachute::update() { // exit immediately if not enabled or parachute not to be released if (_enabled <= 0) { return; } // check if the plane is sinking too fast for more than a second and release parachute uint32_t time = AP_HAL::millis(); if((_critical_sink > 0) && (_sink_rate > _critical_sink) && !_release_initiated && _is_flying) { if(_sink_time == 0) { _sink_time = AP_HAL::millis(); } if((time - _sink_time) >= 1000) { release(); } } else { _sink_time = 0; } // calc time since release uint32_t time_diff = AP_HAL::millis() - _release_time; uint32_t delay_ms = _delay_ms<=0 ? 0: (uint32_t)_delay_ms; // check if we should release parachute if ((_release_time != 0) && !_release_in_progress) { if (time_diff >= delay_ms) { if (_release_type == AP_PARACHUTE_TRIGGER_TYPE_SERVO) { // move servo SRV_Channels::set_output_pwm(SRV_Channel::k_parachute_release, _servo_on_pwm); }else if (_release_type <= AP_PARACHUTE_TRIGGER_TYPE_RELAY_3) { // set relay _relay.on(_release_type); } _release_in_progress = true; _released = true; } }else if ((_release_time == 0) || time_diff >= delay_ms + AP_PARACHUTE_RELEASE_DURATION_MS) { if (_release_type == AP_PARACHUTE_TRIGGER_TYPE_SERVO) { // move servo back to off position SRV_Channels::set_output_pwm(SRV_Channel::k_parachute_release, _servo_off_pwm); }else if (_release_type <= AP_PARACHUTE_TRIGGER_TYPE_RELAY_3) { // set relay back to zero volts _relay.off(_release_type); } // reset released flag and release_time _release_in_progress = false; _release_time = 0; // update AP_Notify AP_Notify::flags.parachute_release = 0; } } // singleton instance AP_Parachute *AP_Parachute::_singleton; namespace AP { AP_Parachute *parachute() { return AP_Parachute::get_singleton(); } }