// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Copyright (c) 04.2007 Holger Buss
// + Nur f�r den privaten Gebrauch
// + www.MikroKopter.com
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Es gilt f�r das gesamte Projekt (Hardware, Software, Bin�rfiles, Sourcecode und Dokumentation),
// + dass eine Nutzung (auch auszugsweise) nur f�r den privaten und nicht-kommerziellen Gebrauch zul�ssig ist.
// + Sollten direkte oder indirekte kommerzielle Absichten verfolgt werden, ist mit uns (info@mikrokopter.de) Kontakt
// + bzgl. der Nutzungsbedingungen aufzunehmen.
// + Eine kommerzielle Nutzung ist z.B.Verkauf von MikroKoptern, Best�ckung und Verkauf von Platinen oder Baus�tzen,
// + Verkauf von Luftbildaufnahmen, usw.
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Werden Teile des Quellcodes (mit oder ohne Modifikation) weiterverwendet oder ver�ffentlicht,
// + unterliegen sie auch diesen Nutzungsbedingungen und diese Nutzungsbedingungen incl. Copyright m�ssen dann beiliegen
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Sollte die Software (auch auszugesweise) oder sonstige Informationen des MikroKopter-Projekts
// + auf anderen Webseiten oder Medien ver�ffentlicht werden, muss unsere Webseite "http://www.mikrokopter.de"
// + eindeutig als Ursprung verlinkt und genannt werden
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Keine Gew�hr auf Fehlerfreiheit, Vollst�ndigkeit oder Funktion
// + Benutzung auf eigene Gefahr
// + Wir �bernehmen keinerlei Haftung f�r direkte oder indirekte Personen- oder Sachsch�den
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Die Portierung der Software (oder Teile davon) auf andere Systeme (ausser der Hardware von www.mikrokopter.de) ist nur
// + mit unserer Zustimmung zul�ssig
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Die Funktion printf_P() unterliegt ihrer eigenen Lizenz und ist hiervon nicht betroffen
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
// + Redistributions of source code (with or without modifications) must retain the above copyright notice,
// + this list of conditions and the following disclaimer.
// + * Neither the name of the copyright holders nor the names of contributors may be used to endorse or promote products derived
// + from this software without specific prior written permission.
// + * The use of this project (hardware, software, binary files, sources and documentation) is only permittet
// + for non-commercial use (directly or indirectly)
// + Commercial use (for example: selling of MikroKopters, selling of PCBs, assembly, ...) is only permitted
// + with our written permission
// + * If sources or documentations are redistributet on other webpages, out webpage (http://www.MikroKopter.de) must be
// + clearly linked as origin
// + * porting to systems other than hardware from www.mikrokopter.de is not allowed
// + 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.
// ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
/************************************************************************/
/* Flight Attitude */
/************************************************************************/
#include <stdlib.h>
#include <avr/io.h>
#include "attitude.h"
#include "dongfangMath.h"
// For scope debugging only!
#include "rc.h"
// where our main data flow comes from.
#include "analog.h"
#include "configuration.h"
#include "output.h"
// Some calculations are performed depending on some stick related things.
#include "controlMixer.h"
#define CHECK_MIN_MAX(value, min, max) {if(value < min) value = min; else if(value > max) value = max;}
/*
* Gyro readings, as read from the analog module. It would have been nice to flow
* them around between the different calculations as a struct or array (doing
* things functionally without side effects) but this is shorter and probably
* faster too.
* The variables are overwritten at each attitude calculation invocation - the values
* are not preserved or reused.
*/
int16_t rate_ATT
[2], yawRate
;
// With different (less) filtering
int16_t rate_PID
[2];
int16_t differential
[2];
/*
* Gyro readings, after performing "axis coupling" - that is, the transfomation
* of rotation rates from the airframe-local coordinate system to a ground-fixed
* coordinate system. If axis copling is disabled, the gyro readings will be
* copied into these directly.
* These are global for the same pragmatic reason as with the gyro readings.
* The variables are overwritten at each attitude calculation invocation - the values
* are not preserved or reused.
*/
int16_t ACRate
[2], ACYawRate
;
/*
* Gyro integrals. These are the rotation angles of the airframe compared to the
* horizontal plane, yaw relative to yaw at start.
*/
int32_t angle
[2], yawAngleDiff
;
int readingHeight
= 0;
// Yaw angle and compass stuff.
// This is updated/written from MM3. Negative angle indicates invalid data.
int16_t magneticHeading
= -1;
// This is NOT updated from MM3. Negative angle indicates invalid data.
int16_t compassCourse
= -1;
// The difference between the above 2 (heading - course) on a -180..179 degree interval.
// Not necessary. Never read anywhere.
// int16_t compassOffCourse = 0;
uint8_t updateCompassCourse
= 0;
uint8_t compassCalState
= 0;
uint16_t ignoreCompassTimer
= 500;
int32_t yawGyroHeading
; // Yaw Gyro Integral supported by compass
int16_t yawGyroDrift
;
#define PITCHROLLOVER180 (GYRO_DEG_FACTOR_PITCHROLL * 180L)
#define PITCHROLLOVER360 (GYRO_DEG_FACTOR_PITCHROLL * 360L)
#define YAWOVER360 (GYRO_DEG_FACTOR_YAW * 360L)
int16_t correctionSum
[2] = { 0, 0 };
// For NaviCTRL use.
int16_t averageAcc
[2] = { 0, 0 }, averageAccCount
= 0;
/*
* Experiment: Compensating for dynamic-induced gyro biasing.
*/
int16_t driftComp
[2] = { 0, 0 }, driftCompYaw
= 0;
// int16_t savedDynamicOffsetPitch = 0, savedDynamicOffsetRoll = 0;
// int32_t dynamicCalPitch, dynamicCalRoll, dynamicCalYaw;
// int16_t dynamicCalCount;
uint16_t accVector
;
/************************************************************************
* Set inclination angles from the acc. sensor data.
* If acc. sensors are not used, set to zero.
* TODO: One could use inverse sine to calculate the angles more
* accurately, but since: 1) the angles are rather small at times when
* it makes sense to set the integrals (standing on ground, or flying at
* constant speed, and 2) at small angles a, sin(a) ~= constant * a,
* it is hardly worth the trouble.
************************************************************************/
int32_t getAngleEstimateFromAcc
(uint8_t axis
) {
//int32_t correctionTerm = (dynamicParams.levelCorrection[axis] - 128) * 256L;
return (int32_t)GYRO_ACC_FACTOR
* (int32_t)filteredAcc
[axis
];// + correctionTerm;
// return 342L * filteredAcc[axis];
}
void setStaticAttitudeAngles
(void) {
#ifdef ATTITUDE_USE_ACC_SENSORS
angle
[PITCH
] = getAngleEstimateFromAcc
(PITCH
);
angle
[ROLL
] = getAngleEstimateFromAcc
(ROLL
);
#else
angle
[PITCH
] = angle
[ROLL
] = 0;
#endif
}
/************************************************************************
* Neutral Readings
************************************************************************/
void attitude_setNeutral
(void) {
// Servo_Off(); // disable servo output. TODO: Why bother? The servos are going to make a jerk anyway.
// dynamicParams.axisCoupling1 = dynamicParams.axisCoupling2 = 0;
driftComp
[PITCH
] = driftComp
[ROLL
] = yawGyroDrift
= driftCompYaw
= 0;
correctionSum
[PITCH
] = correctionSum
[ROLL
] = 0;
// Calibrate hardware.
analog_setNeutral
();
// reset gyro integrals to acc guessing
setStaticAttitudeAngles
();
yawAngleDiff
= 0;
// update compass course to current heading
compassCourse
= magneticHeading
;
// Inititialize YawGyroIntegral value with current compass heading
yawGyroHeading
= (int32_t) magneticHeading
* GYRO_DEG_FACTOR_YAW
;
// Servo_On(); //enable servo output
}
/************************************************************************
* Get sensor data from the analog module, and release the ADC
* TODO: Ultimately, the analog module could do this (instead of dumping
* the values into variables).
* The rate variable end up in a range of about [-1024, 1023].
*************************************************************************/
void getAnalogData
(void) {
uint8_t axis
;
analog_update
();
for (axis
= PITCH
; axis
<= ROLL
; axis
++) {
rate_PID
[axis
] = gyro_PID
[axis
] + driftComp
[axis
];
rate_ATT
[axis
] = gyro_ATT
[axis
] + driftComp
[axis
];
differential
[axis
] = gyroD
[axis
];
averageAcc
[axis
] += acc
[axis
];
}
averageAccCount
++;
yawRate
= yawGyro
+ driftCompYaw
;
}
/*
* This is the standard flight-style coordinate system transformation
* (from airframe-local axes to a ground-based system). For some reason
* the MK uses a left-hand coordinate system. The tranformation has been
* changed accordingly.
*/
void trigAxisCoupling
(void) {
int16_t rollAngleInDegrees
= angle
[ROLL
] / GYRO_DEG_FACTOR_PITCHROLL
;
int16_t pitchAngleInDegrees
= angle
[PITCH
] / GYRO_DEG_FACTOR_PITCHROLL
;
int16_t cospitch
= cos_360
(pitchAngleInDegrees
);
int16_t cosroll
= cos_360
(rollAngleInDegrees
);
int16_t sinroll
= sin_360
(rollAngleInDegrees
);
ACRate
[PITCH
] = (((int32_t)rate_ATT
[PITCH
] * cosroll
- (int32_t)yawRate
* sinroll
) >> MATH_UNIT_FACTOR_LOG
);
ACRate
[ROLL
] = rate_ATT
[ROLL
] + (((((int32_t)rate_ATT
[PITCH
] * sinroll
+ (int32_t)yawRate
* cosroll
) >> MATH_UNIT_FACTOR_LOG
) * tan_360
(pitchAngleInDegrees
)) >> MATH_UNIT_FACTOR_LOG
);
ACYawRate
= ((int32_t)rate_ATT
[PITCH
] * sinroll
+ (int32_t)yawRate
* cosroll
) / cospitch
;
ACYawRate
= ((int32_t)rate_ATT
[PITCH
] * sinroll
+ (int32_t)yawRate
* cosroll
) / cospitch
;
}
// 480 usec with axis coupling - almost no time without.
void integrate
(void) {
// First, perform axis coupling. If disabled xxxRate is just copied to ACxxxRate.
uint8_t axis
;
if (staticParams.
bitConfig & CFG_AXIS_COUPLING_ACTIVE
) {
trigAxisCoupling
();
} else {
ACRate
[PITCH
] = rate_ATT
[PITCH
];
ACRate
[ROLL
] = rate_ATT
[ROLL
];
ACYawRate
= yawRate
;
}
/*
* Yaw
* Calculate yaw gyro integral (~ to rotation angle)
* Limit yawGyroHeading proportional to 0 deg to 360 deg
*/
yawGyroHeading
+= ACYawRate
;
yawAngleDiff
+= yawRate
;
if (yawGyroHeading
>= YAWOVER360
) {
yawGyroHeading
-= YAWOVER360
; // 360 deg. wrap
} else if (yawGyroHeading
< 0) {
yawGyroHeading
+= YAWOVER360
;
}
/*
* Pitch axis integration and range boundary wrap.
*/
for (axis
= PITCH
; axis
<= ROLL
; axis
++) {
angle
[axis
] += ACRate
[axis
];
if (angle
[axis
] > PITCHROLLOVER180
) {
angle
[axis
] -= PITCHROLLOVER360
;
} else if (angle
[axis
] <= -PITCHROLLOVER180
) {
angle
[axis
] += PITCHROLLOVER360
;
}
}
}
/************************************************************************
* A kind of 0'th order integral correction, that corrects the integrals
* directly. This is the "gyroAccFactor" stuff in the original code.
* There is (there) also a drift compensation
* - it corrects the differential of the integral = the gyro offsets.
* That should only be necessary with drifty gyros like ENC-03.
************************************************************************/
void correctIntegralsByAcc0thOrder
(void) {
// TODO: Consider changing this to: Only correct when integrals are less than ...., or only correct when angular velocities
// are less than ....., or reintroduce Kalman.
// Well actually the Z axis acc. check is not so silly.
uint8_t axis
;
int32_t temp
;
uint8_t ca
= controlActivity
>> 8;
uint8_t highControlActivity
= (ca
> staticParams.
maxControlActivity);
if (highControlActivity
) {
debugOut.
digital[1] |= DEBUG_ACC0THORDER
;
} else {
debugOut.
digital[1] &= ~DEBUG_ACC0THORDER
;
}
if (accVector
<= dynamicParams.
maxAccVector) {
debugOut.
digital[0] &= ~ DEBUG_ACC0THORDER
;
uint8_t permilleAcc
= staticParams.
zerothOrderCorrection;
int32_t accDerived
;
/*
if ((controlYaw < -64) || (controlYaw > 64)) { // reduce further if yaw stick is active
permilleAcc /= 2;
debugFullWeight = 0;
}
if ((maxControl[PITCH] > 64) || (maxControl[ROLL] > 64)) { // reduce effect during stick commands. Replace by controlActivity.
permilleAcc /= 2;
debugFullWeight = 0;
*/
if (highControlActivity
) { // reduce effect during stick control activity
permilleAcc
/= 4;
if (controlActivity
> staticParams.
maxControlActivity*2) { // reduce effect during stick control activity
permilleAcc
/= 4;
}
}
/*
* Add to each sum: The amount by which the angle is changed just below.
*/
for (axis
= PITCH
; axis
<= ROLL
; axis
++) {
accDerived
= getAngleEstimateFromAcc
(axis
);
debugOut.
analog[9 + axis
] = accDerived
/ (GYRO_DEG_FACTOR_PITCHROLL
/ 10);
// 1000 * the correction amount that will be added to the gyro angle in next line.
temp
= angle
[axis
];
angle
[axis
] = ((int32_t) (1000L - permilleAcc
) * temp
+ (int32_t) permilleAcc
* accDerived
) / 1000L;
correctionSum
[axis
] += angle
[axis
] - temp
;
}
} else {
debugOut.
analog[9] = 0;
debugOut.
analog[10] = 0;
// experiment: Kill drift compensation updates when not flying smooth.
// correctionSum[PITCH] = correctionSum[ROLL] = 0;
debugOut.
digital[0] |= DEBUG_ACC0THORDER
;
}
}
/************************************************************************
* This is an attempt to correct not the error in the angle integrals
* (that happens in correctIntegralsByAcc0thOrder above) but rather the
* cause of it: Gyro drift, vibration and rounding errors.
* All the corrections made in correctIntegralsByAcc0thOrder over
* DRIFTCORRECTION_TIME cycles are summed up. This number is
* then divided by DRIFTCORRECTION_TIME to get the approx.
* correction that should have been applied to each iteration to fix
* the error. This is then added to the dynamic offsets.
************************************************************************/
// 2 times / sec. = 488/2
#define DRIFTCORRECTION_TIME 256L
void driftCorrection
(void) {
static int16_t timer
= DRIFTCORRECTION_TIME
;
int16_t deltaCorrection
;
int16_t round
;
uint8_t axis
;
if (!--timer
) {
timer
= DRIFTCORRECTION_TIME
;
for (axis
= PITCH
; axis
<= ROLL
; axis
++) {
// Take the sum of corrections applied, add it to delta
if (correctionSum
[axis
] >=0)
round
= DRIFTCORRECTION_TIME
/ 2;
else
round
= -DRIFTCORRECTION_TIME
/ 2;
deltaCorrection
= (correctionSum
[axis
] + round
) / DRIFTCORRECTION_TIME
;
// Add the delta to the compensation. So positive delta means, gyro should have higher value.
driftComp
[axis
] += deltaCorrection
/ staticParams.
driftCompDivider;
CHECK_MIN_MAX
(driftComp
[axis
], -staticParams.
driftCompLimit, staticParams.
driftCompLimit);
// DebugOut.Analog[11 + axis] = correctionSum[axis];
// DebugOut.Analog[16 + axis] = correctionSum[axis];
// debugOut.analog[28 + axis] = driftComp[axis];
correctionSum
[axis
] = 0;
}
}
}
void calculateAccVector
(void) {
int16_t temp
;
temp
= filteredAcc
[0] >> 3;
accVector
= temp
* temp
;
temp
= filteredAcc
[1] >> 3;
accVector
+= temp
* temp
;
temp
= filteredAcc
[2] >> 3;
accVector
+= temp
* temp
;
//debugOut.analog[18] = accVector;
}
/************************************************************************
* Main procedure.
************************************************************************/
void calculateFlightAttitude
(void) {
getAnalogData
();
calculateAccVector
();
integrate
();
#ifdef ATTITUDE_USE_ACC_SENSORS
correctIntegralsByAcc0thOrder
();
driftCorrection
();
#endif
// We are done reading variables from the analog module.
// Interrupt-driven sensor reading may restart.
startAnalogConversionCycle
();
}
void updateCompass
(void) {
int16_t w
, v
, r
, correction
, error
;
if (compassCalState
&& !(MKFlags
& MKFLAG_MOTOR_RUN
)) {
if (controlMixer_testCompassCalState
()) {
compassCalState
++;
if (compassCalState
< 5)
beepNumber
(compassCalState
);
else
beep
(1000);
}
} else {
// get maximum attitude angle
w
= abs(angle
[PITCH
] / 512);
v
= abs(angle
[ROLL
] / 512);
if (v
> w
)
w
= v
;
correction
= w
/ 8 + 1;
// calculate the deviation of the yaw gyro heading and the compass heading
if (magneticHeading
< 0)
error
= 0; // disable yaw drift compensation if compass heading is undefined
else if (abs(yawRate
) > 128) { // spinning fast
error
= 0;
} else {
// compassHeading - yawGyroHeading, on a -180..179 deg interval.
error
= ((540 + magneticHeading
- (yawGyroHeading
/ GYRO_DEG_FACTOR_YAW
))
% 360) - 180;
}
if (!ignoreCompassTimer
&& w
< 25) {
yawGyroDrift
+= error
;
// Basically this gets set if we are in "fix" mode, and when starting.
if (updateCompassCourse
) {
beep
(200);
yawGyroHeading
= (int32_t) magneticHeading
* GYRO_DEG_FACTOR_YAW
;
compassCourse
= magneticHeading
; //(int16_t)(yawGyroHeading / GYRO_DEG_FACTOR_YAW);
updateCompassCourse
= 0;
}
}
yawGyroHeading
+= (error
* 8) / correction
;
/*
w = (w * dynamicParams.CompassYawEffect) / 32;
w = dynamicParams.CompassYawEffect - w;
*/
w
= dynamicParams.
compassYawEffect - (w
* dynamicParams.
compassYawEffect)
/ 32;
// As readable formula:
// w = dynamicParams.CompassYawEffect * (1-w/32);
if (w
>= 0) { // maxAttitudeAngle < 32
if (!ignoreCompassTimer
) {
/*v = 64 + (maxControl[PITCH] + maxControl[ROLL]) / 8;*/
v
= 64 + controlActivity
/ 100;
// yawGyroHeading - compassCourse on a -180..179 degree interval.
r
= ((540 + yawGyroHeading
/ GYRO_DEG_FACTOR_YAW
- compassCourse
)
% 360) - 180;
v
= (r
* w
) / v
; // align to compass course
// limit yaw rate
w
= 3 * dynamicParams.
compassYawEffect;
if (v
> w
)
v
= w
;
else if (v
< -w
)
v
= -w
;
yawAngleDiff
+= v
;
} else { // wait a while
ignoreCompassTimer
--;
}
} else { // ignore compass at extreme attitudes for a while
ignoreCompassTimer
= 500;
}
}
}
/*
* This is part of an experiment to measure average sensor offsets caused by motor vibration,
* and to compensate them away. It brings about some improvement, but no miracles.
* As long as the left stick is kept in the start-motors position, the dynamic compensation
* will measure the effect of vibration, to use for later compensation. So, one should keep
* the stick in the start-motors position for a few seconds, till all motors run (at the wrong
* speed unfortunately... must find a better way)
*/
/*
void attitude_startDynamicCalibration(void) {
dynamicCalPitch = dynamicCalRoll = dynamicCalYaw = dynamicCalCount = 0;
savedDynamicOffsetPitch = savedDynamicOffsetRoll = 1000;
}
void attitude_continueDynamicCalibration(void) {
// measure dynamic offset now...
dynamicCalPitch += hiResPitchGyro;
dynamicCalRoll += hiResRollGyro;
dynamicCalYaw += rawYawGyroSum;
dynamicCalCount++;
// Param6: Manual mode. The offsets are taken from Param7 and Param8.
if (dynamicParams.UserParam6 || 1) { // currently always enabled.
// manual mode
driftCompPitch = dynamicParams.UserParam7 - 128;
driftCompRoll = dynamicParams.UserParam8 - 128;
} else {
// use the sampled value (does not seem to work so well....)
driftCompPitch = savedDynamicOffsetPitch = -dynamicCalPitch / dynamicCalCount;
driftCompRoll = savedDynamicOffsetRoll = -dynamicCalRoll / dynamicCalCount;
driftCompYaw = -dynamicCalYaw / dynamicCalCount;
}
// keep resetting these meanwhile, to avoid accumulating errors.
setStaticAttitudeIntegrals();
yawAngle = 0;
}
*/