/* This program 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 3 of the License, or (at your option) any later version. This program 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 this program. If not, see . */ /* SRV_Channel_aux.cpp - handling of servo auxiliary functions */ #include "SRV_Channel.h" #include #include #include #include #if NUM_SERVO_CHANNELS == 0 #pragma GCC diagnostic ignored "-Wtype-limits" #endif extern const AP_HAL::HAL& hal; /// map a function to a servo channel and output it void SRV_Channel::output_ch(void) { #ifndef HAL_BUILD_AP_PERIPH int8_t passthrough_from = -1; bool passthrough_mapped = false; // take care of special function cases switch(function.get()) { case k_manual: // manual passthrough_from = ch_num; break; case k_rcin1 ... k_rcin16: // rc pass-thru passthrough_from = int8_t((int16_t)function - k_rcin1); break; case k_rcin1_mapped ... k_rcin16_mapped: passthrough_from = int8_t((int16_t)function - k_rcin1_mapped); passthrough_mapped = true; break; } if (passthrough_from != -1) { // we are doing passthrough from input to output for this channel RC_Channel *c = rc().channel(passthrough_from); if (c) { if (SRV_Channels::passthrough_disabled()) { output_pwm = c->get_radio_trim(); } else { // non-mapped rc passthrough int16_t radio_in = c->get_radio_in(); if (passthrough_mapped) { if (rc().has_valid_input()) { switch (c->get_type()) { case RC_Channel::ControlType::ANGLE: radio_in = pwm_from_angle(c->norm_input_dz() * 4500); break; case RC_Channel::ControlType::RANGE: // convert RC normalised input from -1 to +1 range to 0 to +1 and output as range radio_in = pwm_from_range((c->norm_input_ignore_trim() + 1.0) * 0.5 * 4500); break; } } else { // no valid input. If we are in radio // failsafe then go to trim values (if // configured for this channel). Otherwise // use the last-good value if ( ((1U< c->get_dead_zone()) { output_pwm = radio_in; ign_small_rcin_changes = false; } } } } } #endif // HAL_BUILD_AP_PERIPH if (!(SRV_Channels::disabled_mask & (1U<write(ch_num, output_pwm); } } /* call output_ch() on all channels */ void SRV_Channels::output_ch_all(void) { uint8_t max_chan = NUM_SERVO_CHANNELS; #if NUM_SERVO_CHANNELS >= 17 if (_singleton != nullptr && _singleton->enable_32_channels.get() <= 0) { max_chan = 16; } #endif for (uint8_t i = 0; i < max_chan; i++) { channels[i].output_ch(); } } /* return the current function for a channel */ SRV_Channel::Aux_servo_function_t SRV_Channels::channel_function(uint8_t channel) { if (channel < NUM_SERVO_CHANNELS) { return channels[channel].function; } return SRV_Channel::k_none; } /* setup a channels aux servo function */ void SRV_Channel::aux_servo_function_setup(void) { if (type_setup) { return; } switch (function.get()) { case k_flap: case k_flap_auto: case k_egg_drop: case k_lift_release: set_range(100); break; case k_heli_rsc: case k_heli_tail_rsc: case k_motor_tilt: case k_boost_throttle: case k_thrust_out: set_range(1000); break; case k_aileron_with_input: case k_elevator_with_input: case k_aileron: case k_elevator: case k_dspoilerLeft1: case k_dspoilerLeft2: case k_dspoilerRight1: case k_dspoilerRight2: case k_rudder: case k_steering: case k_flaperon_left: case k_flaperon_right: case k_tiltMotorLeft: case k_tiltMotorRight: case k_tiltMotorRear: case k_tiltMotorRearLeft: case k_tiltMotorRearRight: case k_elevon_left: case k_elevon_right: case k_vtail_left: case k_vtail_right: case k_scripting1: case k_scripting2: case k_scripting3: case k_scripting4: case k_scripting5: case k_scripting6: case k_scripting7: case k_scripting8: case k_scripting9: case k_scripting10: case k_scripting11: case k_scripting12: case k_scripting13: case k_scripting14: case k_scripting15: case k_scripting16: case k_roll_out: case k_pitch_out: case k_yaw_out: case k_rcin1_mapped ... k_rcin16_mapped: set_angle(4500); break; case k_throttle: case k_throttleLeft: case k_throttleRight: case k_airbrake: // fixed wing throttle set_range(100); break; default: break; } } /// setup the output range types of all functions void SRV_Channels::update_aux_servo_function(void) { if (!channels) { return; } function_mask.clearall(); for (uint16_t i = 0; i < SRV_Channel::k_nr_aux_servo_functions; i++) { functions[i].channel_mask = 0; } invalid_mask = 0; // set auxiliary ranges for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { if (!channels[i].valid_function()) { invalid_mask |= 1U<set_default_rate(uint16_t(_singleton->default_rate.get())); update_aux_servo_function(); // enable all channels that are set to a valid function. This // includes k_none servos, which allows those to get their initial // trim value on startup for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { SRV_Channel &c = channels[i]; // see if it is a valid function if (c.valid_function() && !(disabled_mask & (1U<enable_ch(c.ch_num); } else { hal.rcout->disable_ch(c.ch_num); } // output some servo functions before we fiddle with the // parameter values: if (c.function == SRV_Channel::k_min) { c.set_output_pwm(c.servo_min); c.output_ch(); } else if (c.function == SRV_Channel::k_trim) { c.set_output_pwm(c.servo_trim); c.output_ch(); } else if (c.function == SRV_Channel::k_max) { c.set_output_pwm(c.servo_max); c.output_ch(); } } // propagate channel masks to the ESCS hal.rcout->update_channel_masks(); #if HAL_SUPPORT_RCOUT_SERIAL blheli.update(); #endif } /* for channels which have been marked as digital output then the MIN/MAX/TRIM values have no meaning for controlling output, as the HAL handles the scaling. We still need to cope with places in the code that may try to set a PWM value however, so to ensure consistency we force the MIN/MAX/TRIM to be consistent across all digital channels. We use a MIN/MAX of 1000/2000, and set TRIM to either 1000 or 1500 depending on whether the channel is reversible */ void SRV_Channels::set_digital_outputs(uint32_t dig_mask, uint32_t rev_mask) { digital_mask |= dig_mask; reversible_mask |= rev_mask; // add in NeoPixel and ProfiLED functions to digital array to determine anything else // that should be disabled for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { SRV_Channel &c = channels[i]; switch (c.function.get()) { case SRV_Channel::k_LED_neopixel1: case SRV_Channel::k_LED_neopixel2: case SRV_Channel::k_LED_neopixel3: case SRV_Channel::k_LED_neopixel4: case SRV_Channel::k_ProfiLED_1: case SRV_Channel::k_ProfiLED_2: case SRV_Channel::k_ProfiLED_3: case SRV_Channel::k_ProfiLED_Clock: dig_mask |= 1U<get_disabled_channels(dig_mask); for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { SRV_Channel &c = channels[i]; if (digital_mask & (1U<enable_ch(i); } } } /* set radio_out for all channels matching the given function type */ void SRV_Channels::set_output_pwm(SRV_Channel::Aux_servo_function_t function, uint16_t value) { if (!function_assigned(function)) { return; } for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { if (channels[i].function == function) { channels[i].set_output_pwm(value); channels[i].output_ch(); } } } /* set radio_out for all channels matching the given function type trim the output assuming a 1500 center on the given value reverses pwm output based on channel reversed property */ void SRV_Channels::set_output_pwm_trimmed(SRV_Channel::Aux_servo_function_t function, int16_t value) { if (!function_assigned(function)) { return; } for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { if (channels[i].function == function) { int16_t value2; if (channels[i].get_reversed()) { value2 = 1500 - value + channels[i].get_trim(); } else { value2 = value - 1500 + channels[i].get_trim(); } channels[i].set_output_pwm(constrain_int16(value2,channels[i].get_output_min(),channels[i].get_output_max())); channels[i].output_ch(); } } } /* set and save the trim value to current output for all channels matching the given function type */ void SRV_Channels::set_trim_to_servo_out_for(SRV_Channel::Aux_servo_function_t function) { if (!function_assigned(function)) { return; } for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { if (channels[i].function == function) { channels[i].servo_trim.set_and_save_ifchanged(channels[i].get_output_pwm()); } } } #if AP_RC_CHANNEL_ENABLED /* copy radio_in to radio_out for a given function */ void SRV_Channels::copy_radio_in_out(SRV_Channel::Aux_servo_function_t function, bool do_input_output) { if (!function_assigned(function)) { return; } for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { if (channels[i].function == function) { RC_Channel *c = rc().channel(channels[i].ch_num); if (c == nullptr) { continue; } channels[i].set_output_pwm(c->get_radio_in()); if (do_input_output) { channels[i].output_ch(); } } } } /* copy radio_in to radio_out for a channel mask */ void SRV_Channels::copy_radio_in_out_mask(uint32_t mask) { for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { if ((1U<get_radio_in()); } } } #endif // AP_RC_CHANNEL_ENABLED /* setup failsafe value for an auxiliary function type to a Limit */ void SRV_Channels::set_failsafe_pwm(SRV_Channel::Aux_servo_function_t function, uint16_t pwm) { if (!function_assigned(function)) { return; } for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { const SRV_Channel &c = channels[i]; if (c.function == function) { hal.rcout->set_failsafe_pwm(1U<set_failsafe_pwm(1U<set_radio_in(pwm); } } #endif } } } /* return true if a particular function is assigned to at least one RC channel */ bool SRV_Channels::function_assigned(SRV_Channel::Aux_servo_function_t function) { if (!initialised) { update_aux_servo_function(); } return function_mask.get(uint16_t(function)); } /* set servo_out and angle_min/max, then calc_pwm and output a value. This is used to move a AP_Mount servo */ void SRV_Channels::move_servo(SRV_Channel::Aux_servo_function_t function, int16_t value, int16_t angle_min, int16_t angle_max) { if (!function_assigned(function)) { return; } if (angle_max <= angle_min) { return; } float v = float(value - angle_min) / float(angle_max - angle_min); v = constrain_float(v, 0.0f, 1.0f); for (uint8_t i = 0; i < NUM_SERVO_CHANNELS; i++) { SRV_Channel &c = channels[i]; if (c.function == function) { float v2 = c.get_reversed()? (1-v) : v; uint16_t pwm = c.servo_min + v2 * (c.servo_max - c.servo_min); c.set_output_pwm(pwm); } } } /* set the default channel an auxiliary output function should be on */ bool SRV_Channels::set_aux_channel_default(SRV_Channel::Aux_servo_function_t function, uint8_t channel) { if (function_assigned(function)) { // already assigned return true; } if (channels[channel].function != SRV_Channel::k_none) { if (channels[channel].function == function) { return true; } hal.console->printf("Channel %u already assigned function %u\n", (unsigned)(channel + 1), (unsigned)channels[channel].function.get()); return false; } channels[channel].type_setup = false; channels[channel].function.set_and_default(function); channels[channel].aux_servo_function_setup(); function_mask.set((uint16_t)function); if (SRV_Channel::valid_function(function)) { functions[function].channel_mask |= 1U<next) { if (slew->func == function) { if (!is_positive(slew->max_change)) { // treat negative or zero slew rate as disabled break; } return constrain_float(functions[function].output_scaled, slew->last_scaled_output - slew->max_change, slew->last_scaled_output + slew->max_change); } } // no slew limiting return functions[function].output_scaled; } /* get mask of output channels for a function */ uint32_t SRV_Channels::get_output_channel_mask(SRV_Channel::Aux_servo_function_t function) { if (!initialised) { update_aux_servo_function(); } if (SRV_Channel::valid_function(function)) { return functions[function].channel_mask; } return invalid_mask; } // set the trim for a function channel to given pwm void SRV_Channels::set_trim_to_pwm_for(SRV_Channel::Aux_servo_function_t function, int16_t pwm) { for (uint8_t i=0; iset_esc_scaling(channels[chan].get_output_min(), channels[chan].get_output_max()); } } /* auto-adjust channel trim from an integrator value. Positive v means adjust trim up. Negative means decrease */ void SRV_Channels::adjust_trim(SRV_Channel::Aux_servo_function_t function, float v) { if (is_zero(v)) { return; } for (uint8_t i=0; i 0 && trim_scaled < 0.6f) { new_trim++; } else if (change < 0 && trim_scaled > 0.4f) { new_trim--; } else { continue; } c.servo_trim.set(new_trim); trimmed_mask |= 1U<next) { if (slew->func == function) { // found existing item, update max change slew->max_change = max_change; return; } } if (!is_positive(max_change)) { // no point in adding a disabled slew limit return; } // add new item slew_list *new_slew = NEW_NOTHROW slew_list(function); if (new_slew == nullptr) { return; } new_slew->last_scaled_output = functions[function].output_scaled; new_slew->max_change = max_change; new_slew->next = _slew; _slew = new_slew; } // call set_angle() on matching channels void SRV_Channels::set_angle(SRV_Channel::Aux_servo_function_t function, uint16_t angle) { for (uint8_t i=0; i max_pwm; channels[i].servo_min.set_and_save(reversed ? max_pwm : min_pwm); channels[i].servo_max.set_and_save(reversed ? min_pwm : max_pwm); channels[i].reversed.set_and_save(reversed ? 1 : 0); } } } // constrain to output min/max for function void SRV_Channels::constrain_pwm(SRV_Channel::Aux_servo_function_t function) { for (uint8_t i=0; iset_freq(mask, frequency_hz); } }