#include "Copter.h" /***************************************************************************** * Functions to check and perform ESC calibration *****************************************************************************/ #define ESC_CALIBRATION_HIGH_THROTTLE 950 // check if we should enter esc calibration mode void Copter::esc_calibration_startup_check() { if (motors->is_brushed_pwm_type()) { // ESC cal not valid for brushed motors return; } #if FRAME_CONFIG != HELI_FRAME // delay up to 2 second for first radio input uint8_t i = 0; while ((i++ < 100) && (last_radio_update_ms == 0)) { hal.scheduler->delay(20); read_radio(); } // exit immediately if pre-arm rc checks fail if (!arming.rc_calibration_checks(true)) { // clear esc flag for next time if ((g.esc_calibrate != ESCCalibrationModes::ESCCAL_NONE) && (g.esc_calibrate != ESCCalibrationModes::ESCCAL_DISABLED)) { g.esc_calibrate.set_and_save(ESCCalibrationModes::ESCCAL_NONE); } return; } // check ESC parameter switch (g.esc_calibrate) { case ESCCalibrationModes::ESCCAL_NONE: // check if throttle is high if (channel_throttle->get_control_in() >= ESC_CALIBRATION_HIGH_THROTTLE) { // we will enter esc_calibrate mode on next reboot g.esc_calibrate.set_and_save(ESCCalibrationModes::ESCCAL_PASSTHROUGH_IF_THROTTLE_HIGH); // send message to gcs gcs().send_text(MAV_SEVERITY_CRITICAL,"ESC calibration: Restart board"); // turn on esc calibration notification AP_Notify::flags.esc_calibration = true; // block until we restart while(1) { hal.scheduler->delay(5); } } break; case ESCCalibrationModes::ESCCAL_PASSTHROUGH_IF_THROTTLE_HIGH: // check if throttle is high if (channel_throttle->get_control_in() >= ESC_CALIBRATION_HIGH_THROTTLE) { // pass through pilot throttle to escs esc_calibration_passthrough(); } break; case ESCCalibrationModes::ESCCAL_PASSTHROUGH_ALWAYS: // pass through pilot throttle to escs esc_calibration_passthrough(); break; case ESCCalibrationModes::ESCCAL_AUTO: // perform automatic ESC calibration esc_calibration_auto(); break; case ESCCalibrationModes::ESCCAL_DISABLED: default: // do nothing break; } // clear esc flag for next time if (g.esc_calibrate != ESCCalibrationModes::ESCCAL_DISABLED) { g.esc_calibrate.set_and_save(ESCCalibrationModes::ESCCAL_NONE); } #endif // FRAME_CONFIG != HELI_FRAME } // esc_calibration_passthrough - pass through pilot throttle to escs void Copter::esc_calibration_passthrough() { #if FRAME_CONFIG != HELI_FRAME // send message to GCS gcs().send_text(MAV_SEVERITY_INFO,"ESC calibration: Passing pilot throttle to ESCs"); esc_calibration_setup(); while(1) { // flash LEDs esc_calibration_notify(); // read pilot input read_radio(); // we run at high rate to make oneshot ESCs happy. Normal ESCs // will only see pulses at the RC_SPEED hal.scheduler->delay(3); // pass through to motors auto &srv = AP::srv(); srv.cork(); motors->set_throttle_passthrough_for_esc_calibration(channel_throttle->get_control_in() * 0.001f); srv.push(); } #endif // FRAME_CONFIG != HELI_FRAME } // esc_calibration_auto - calibrate the ESCs automatically using a timer and no pilot input void Copter::esc_calibration_auto() { #if FRAME_CONFIG != HELI_FRAME // send message to GCS gcs().send_text(MAV_SEVERITY_INFO,"ESC calibration: Auto calibration"); esc_calibration_setup(); // raise throttle to maximum auto &srv = AP::srv(); srv.cork(); motors->set_throttle_passthrough_for_esc_calibration(1.0f); srv.push(); // delay for 5 seconds while outputting pulses uint32_t tstart = millis(); while (millis() - tstart < 5000) { srv.cork(); motors->set_throttle_passthrough_for_esc_calibration(1.0f); srv.push(); esc_calibration_notify(); hal.scheduler->delay(3); } // block until we restart while(1) { srv.cork(); motors->set_throttle_passthrough_for_esc_calibration(0.0f); srv.push(); esc_calibration_notify(); hal.scheduler->delay(3); } #endif // FRAME_CONFIG != HELI_FRAME } // flash LEDs to notify the user that ESC calibration is happening void Copter::esc_calibration_notify() { AP_Notify::flags.esc_calibration = true; uint32_t now = AP_HAL::millis(); if (now - esc_calibration_notify_update_ms > 20) { esc_calibration_notify_update_ms = now; notify.update(); } } void Copter::esc_calibration_setup() { // clear esc flag for next time g.esc_calibrate.set_and_save(ESCCAL_NONE); if (motors->is_normal_pwm_type()) { // run at full speed for oneshot ESCs (actually done on push) motors->set_update_rate(g.rc_speed); } else { // reduce update rate to motors to 50Hz motors->set_update_rate(50); } // disable safety if requested BoardConfig.init_safety(); // wait for safety switch to be pressed uint32_t tstart = 0; while (hal.util->safety_switch_state() == AP_HAL::Util::SAFETY_DISARMED) { const uint32_t tnow = AP_HAL::millis(); if (tnow - tstart >= 5000) { gcs().send_text(MAV_SEVERITY_INFO,"ESC calibration: Push safety switch"); tstart = tnow; } esc_calibration_notify(); hal.scheduler->delay(3); } // arm and enable motors motors->armed(true); SRV_Channels::enable_by_mask(motors->get_motor_mask()); hal.util->set_soft_armed(true); }