mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-10-24 13:53:34 +08:00
pwm_limit: rename to output_limit
As there is nothing pwm-specific about it.
This commit is contained in:
Beat Küng
@@ -0,0 +1,34 @@
|
||||
############################################################################
|
||||
#
|
||||
# Copyright (c) 2018 PX4 Development Team. All rights reserved.
|
||||
#
|
||||
# Redistribution and use in source and binary forms, with or without
|
||||
# modification, are permitted provided that the following conditions
|
||||
# are met:
|
||||
#
|
||||
# 1. Redistributions of source code must retain the above copyright
|
||||
# notice, this list of conditions and the following disclaimer.
|
||||
# 2. Redistributions in binary form must reproduce the above copyright
|
||||
# notice, this list of conditions and the following disclaimer in
|
||||
# the documentation and/or other materials provided with the
|
||||
# distribution.
|
||||
# 3. Neither the name PX4 nor the names of its contributors may be
|
||||
# used to endorse or promote products derived from this software
|
||||
# without specific prior written permission.
|
||||
#
|
||||
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||||
# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||
# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
||||
# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
||||
# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||||
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
||||
# BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
||||
# OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
||||
# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
# POSSIBILITY OF SUCH DAMAGE.
|
||||
#
|
||||
############################################################################
|
||||
|
||||
px4_add_library(output_limit output_limit.cpp)
|
||||
@@ -0,0 +1,226 @@
|
||||
/****************************************************************************
|
||||
*
|
||||
* Copyright (c) 2013-2015 PX4 Development Team. All rights reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in
|
||||
* the documentation and/or other materials provided with the
|
||||
* distribution.
|
||||
* 3. Neither the name PX4 nor the names of its contributors may be
|
||||
* used to endorse or promote products derived from this software
|
||||
* without specific prior written permission.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||||
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
||||
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
||||
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
||||
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
||||
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
||||
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
* POSSIBILITY OF SUCH DAMAGE.
|
||||
*
|
||||
****************************************************************************/
|
||||
|
||||
#include "output_limit.h"
|
||||
|
||||
#include <px4_defines.h>
|
||||
#include <math.h>
|
||||
#include <stdbool.h>
|
||||
#include <drivers/drv_hrt.h>
|
||||
#include <stdio.h>
|
||||
|
||||
#define PROGRESS_INT_SCALING 10000
|
||||
|
||||
void output_limit_init(output_limit_t *limit)
|
||||
{
|
||||
limit->state = OUTPUT_LIMIT_STATE_INIT;
|
||||
limit->time_armed = 0;
|
||||
limit->ramp_up = true;
|
||||
}
|
||||
|
||||
void output_limit_calc(const bool armed, const bool pre_armed, const unsigned num_channels, const uint16_t reverse_mask,
|
||||
const uint16_t *disarmed_output, const uint16_t *min_output, const uint16_t *max_output,
|
||||
const float *output, uint16_t *effective_output, output_limit_t *limit)
|
||||
{
|
||||
|
||||
/* first evaluate state changes */
|
||||
switch (limit->state) {
|
||||
case OUTPUT_LIMIT_STATE_INIT:
|
||||
|
||||
if (armed) {
|
||||
|
||||
/* set arming time for the first call */
|
||||
if (limit->time_armed == 0) {
|
||||
limit->time_armed = hrt_absolute_time();
|
||||
}
|
||||
|
||||
if (hrt_elapsed_time(&limit->time_armed) >= INIT_TIME_US) {
|
||||
limit->state = OUTPUT_LIMIT_STATE_OFF;
|
||||
}
|
||||
}
|
||||
|
||||
break;
|
||||
|
||||
case OUTPUT_LIMIT_STATE_OFF:
|
||||
if (armed) {
|
||||
if (limit->ramp_up) {
|
||||
limit->state = OUTPUT_LIMIT_STATE_RAMP;
|
||||
|
||||
} else {
|
||||
limit->state = OUTPUT_LIMIT_STATE_ON;
|
||||
}
|
||||
|
||||
/* reset arming time, used for ramp timing */
|
||||
limit->time_armed = hrt_absolute_time();
|
||||
}
|
||||
|
||||
break;
|
||||
|
||||
case OUTPUT_LIMIT_STATE_RAMP:
|
||||
if (!armed) {
|
||||
limit->state = OUTPUT_LIMIT_STATE_OFF;
|
||||
|
||||
} else if (hrt_elapsed_time(&limit->time_armed) >= RAMP_TIME_US) {
|
||||
limit->state = OUTPUT_LIMIT_STATE_ON;
|
||||
}
|
||||
|
||||
break;
|
||||
|
||||
case OUTPUT_LIMIT_STATE_ON:
|
||||
if (!armed) {
|
||||
limit->state = OUTPUT_LIMIT_STATE_OFF;
|
||||
}
|
||||
|
||||
break;
|
||||
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
/* if the system is pre-armed, the limit state is temporarily on,
|
||||
* as some outputs are valid and the non-valid outputs have been
|
||||
* set to NaN. This is not stored in the state machine though,
|
||||
* as the throttle channels need to go through the ramp at
|
||||
* regular arming time.
|
||||
*/
|
||||
|
||||
unsigned local_limit_state = limit->state;
|
||||
|
||||
if (pre_armed) {
|
||||
local_limit_state = OUTPUT_LIMIT_STATE_ON;
|
||||
}
|
||||
|
||||
unsigned progress;
|
||||
|
||||
/* then set effective_output based on state */
|
||||
switch (local_limit_state) {
|
||||
case OUTPUT_LIMIT_STATE_OFF:
|
||||
case OUTPUT_LIMIT_STATE_INIT:
|
||||
for (unsigned i = 0; i < num_channels; i++) {
|
||||
effective_output[i] = disarmed_output[i];
|
||||
}
|
||||
|
||||
break;
|
||||
|
||||
case OUTPUT_LIMIT_STATE_RAMP: {
|
||||
hrt_abstime diff = hrt_elapsed_time(&limit->time_armed);
|
||||
|
||||
progress = diff * PROGRESS_INT_SCALING / RAMP_TIME_US;
|
||||
|
||||
if (progress > PROGRESS_INT_SCALING) {
|
||||
progress = PROGRESS_INT_SCALING;
|
||||
}
|
||||
|
||||
for (unsigned i = 0; i < num_channels; i++) {
|
||||
|
||||
float control_value = output[i];
|
||||
|
||||
/* check for invalid / disabled channels */
|
||||
if (!PX4_ISFINITE(control_value)) {
|
||||
effective_output[i] = disarmed_output[i];
|
||||
continue;
|
||||
}
|
||||
|
||||
uint16_t ramp_min_output;
|
||||
|
||||
/* if a disarmed output value was set, blend between disarmed and min */
|
||||
if (disarmed_output[i] > 0) {
|
||||
|
||||
/* safeguard against overflows */
|
||||
unsigned disarmed = disarmed_output[i];
|
||||
|
||||
if (disarmed > min_output[i]) {
|
||||
disarmed = min_output[i];
|
||||
}
|
||||
|
||||
unsigned disarmed_min_diff = min_output[i] - disarmed;
|
||||
ramp_min_output = disarmed + (disarmed_min_diff * progress) / PROGRESS_INT_SCALING;
|
||||
|
||||
} else {
|
||||
|
||||
/* no disarmed output value set, choose min output */
|
||||
ramp_min_output = min_output[i];
|
||||
}
|
||||
|
||||
if (reverse_mask & (1 << i)) {
|
||||
control_value = -1.0f * control_value;
|
||||
}
|
||||
|
||||
effective_output[i] = control_value * (max_output[i] - ramp_min_output) / 2 + (max_output[i] + ramp_min_output) / 2;
|
||||
|
||||
/* last line of defense against invalid inputs */
|
||||
if (effective_output[i] < ramp_min_output) {
|
||||
effective_output[i] = ramp_min_output;
|
||||
|
||||
} else if (effective_output[i] > max_output[i]) {
|
||||
effective_output[i] = max_output[i];
|
||||
}
|
||||
}
|
||||
}
|
||||
break;
|
||||
|
||||
case OUTPUT_LIMIT_STATE_ON:
|
||||
|
||||
for (unsigned i = 0; i < num_channels; i++) {
|
||||
|
||||
float control_value = output[i];
|
||||
|
||||
/* check for invalid / disabled channels */
|
||||
if (!PX4_ISFINITE(control_value)) {
|
||||
effective_output[i] = disarmed_output[i];
|
||||
continue;
|
||||
}
|
||||
|
||||
if (reverse_mask & (1 << i)) {
|
||||
control_value = -1.0f * control_value;
|
||||
}
|
||||
|
||||
effective_output[i] = control_value * (max_output[i] - min_output[i]) / 2 + (max_output[i] + min_output[i]) / 2;
|
||||
|
||||
/* last line of defense against invalid inputs */
|
||||
if (effective_output[i] < min_output[i]) {
|
||||
effective_output[i] = min_output[i];
|
||||
|
||||
} else if (effective_output[i] > max_output[i]) {
|
||||
effective_output[i] = max_output[i];
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
break;
|
||||
|
||||
default:
|
||||
break;
|
||||
}
|
||||
|
||||
}
|
||||
@@ -0,0 +1,80 @@
|
||||
/****************************************************************************
|
||||
*
|
||||
* Copyright (c) 2013-2015 PX4 Development Team. All rights reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in
|
||||
* the documentation and/or other materials provided with the
|
||||
* distribution.
|
||||
* 3. Neither the name PX4 nor the names of its contributors may be
|
||||
* used to endorse or promote products derived from this software
|
||||
* without specific prior written permission.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
||||
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
||||
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
||||
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
||||
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
||||
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
||||
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
||||
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
||||
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||
* POSSIBILITY OF SUCH DAMAGE.
|
||||
*
|
||||
****************************************************************************/
|
||||
|
||||
/**
|
||||
* @file output_limit.h
|
||||
*
|
||||
* Library for output limiting (PWM for example)
|
||||
*
|
||||
* @author Julian Oes <julian@px4.io>
|
||||
*/
|
||||
|
||||
#pragma once
|
||||
|
||||
#include <stdint.h>
|
||||
#include <stdbool.h>
|
||||
|
||||
__BEGIN_DECLS
|
||||
|
||||
/*
|
||||
* time for the ESCs to initialize
|
||||
* (this is not actually needed if the signal is sent right after boot)
|
||||
*/
|
||||
#define INIT_TIME_US 50000
|
||||
/*
|
||||
* time to slowly ramp up the ESCs
|
||||
*/
|
||||
#define RAMP_TIME_US 500000
|
||||
|
||||
enum output_limit_state {
|
||||
OUTPUT_LIMIT_STATE_OFF = 0,
|
||||
OUTPUT_LIMIT_STATE_INIT,
|
||||
OUTPUT_LIMIT_STATE_RAMP,
|
||||
OUTPUT_LIMIT_STATE_ON
|
||||
};
|
||||
|
||||
typedef struct {
|
||||
enum output_limit_state state;
|
||||
uint64_t time_armed;
|
||||
bool ramp_up; ///< if true, motors will ramp up from disarmed to min_output after arming
|
||||
} output_limit_t;
|
||||
|
||||
__EXPORT void output_limit_init(output_limit_t *limit);
|
||||
|
||||
__EXPORT void output_limit_calc(const bool armed, const bool pre_armed, const unsigned num_channels,
|
||||
const uint16_t reverse_mask, const uint16_t *disarmed_output,
|
||||
const uint16_t *min_output, const uint16_t *max_output,
|
||||
const float *output, uint16_t *effective_output, output_limit_t *limit);
|
||||
|
||||
__END_DECLS
|
||||
|
||||
Reference in New Issue
Block a user