Paparazzi UAS v7.0_unstable
Paparazzi is a free software Unmanned Aircraft System.
Loading...
Searching...
No Matches
guidance_indi_hybrid.c
Go to the documentation of this file.
1/*
2 * Copyright (C) 2015 Ewoud Smeur <ewoud.smeur@gmail.com>
3 *
4 * This file is part of paparazzi.
5 *
6 * paparazzi is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2, or (at your option)
9 * any later version.
10 *
11 * paparazzi is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with paparazzi; see the file COPYING. If not, write to
18 * the Free Software Foundation, 59 Temple Place - Suite 330,
19 * Boston, MA 02111-1307, USA.
20 */
21
30#include "generated/airframe.h"
34#include "state.h"
35#include "mcu_periph/sys_time.h"
36#include "autopilot.h"
37#include "stdio.h"
39#include "modules/core/abi.h"
41
42
43// The acceleration reference is calculated with these gains. If you use GPS,
44// they are probably limited by the update rate of your GPS. The default
45// values are tuned for 4 Hz GPS updates. If you have high speed position updates, the
46// gains can be higher, depending on the speed of the inner loop.
47#ifndef GUIDANCE_INDI_SPEED_GAIN
48#define GUIDANCE_INDI_SPEED_GAIN 1.8
49#define GUIDANCE_INDI_SPEED_GAINZ 1.8
50#endif
51
52#ifndef GUIDANCE_INDI_POS_GAIN
53#define GUIDANCE_INDI_POS_GAIN 0.5
54#define GUIDANCE_INDI_POS_GAINZ 0.5
55#endif
56
57#ifndef GUIDANCE_INDI_LIFTD_ASQ
58#define GUIDANCE_INDI_LIFTD_ASQ 0.20
59#endif
60
61#ifndef GUIDANCE_INDI_MAX_PUSHER_INCREMENT
62#define GUIDANCE_INDI_MAX_PUSHER_INCREMENT MAX_PPRZ
63#endif
64
65/* If lift effectiveness at low airspeed not defined,
66 * just make one interpolation segment that connects to
67 * the quadratic part from 12 m/s onward
68 */
69#ifndef GUIDANCE_INDI_LIFTD_P50
70#define GUIDANCE_INDI_LIFTD_P80 (GUIDANCE_INDI_LIFTD_ASQ*12*12)
71#define GUIDANCE_INDI_LIFTD_P50 (GUIDANCE_INDI_LIFTD_P80/2)
72#endif
73
74#ifndef GUIDANCE_INDI_MAX_AIRSPEED
75#error "You must have an airspeed sensor to use this guidance"
76#endif
77
78#ifndef GUIDANCE_INDI_MIN_AIRSPEED
79#define GUIDANCE_INDI_MIN_AIRSPEED -10.f
80#endif
81
85#ifndef GUIDANCE_INDI_FWD_CLIMB_SPEED
86#define GUIDANCE_INDI_FWD_CLIMB_SPEED 4.0
87#endif
88
92#ifndef GUIDANCE_INDI_FWD_DESCEND_SPEED
93#define GUIDANCE_INDI_FWD_DESCEND_SPEED -4.0
94#endif
95
99#ifndef GUIDANCE_INDI_QUAD_CLIMB_SPEED
100#define GUIDANCE_INDI_QUAD_CLIMB_SPEED 2.0
101#endif
102
106#ifndef GUIDANCE_INDI_QUAD_DESCEND_SPEED
107#define GUIDANCE_INDI_QUAD_DESCEND_SPEED -2.0
108#endif
109
112 .pos_gainz = GUIDANCE_INDI_POS_GAINZ,
113
114 .speed_gain = GUIDANCE_INDI_SPEED_GAIN,
115 .speed_gainz = GUIDANCE_INDI_SPEED_GAINZ,
116
117 .heading_bank_gain = GUIDANCE_INDI_HEADING_BANK_GAIN,
118 .liftd_asq = GUIDANCE_INDI_LIFTD_ASQ, // coefficient of airspeed squared
119 .liftd_p80 = GUIDANCE_INDI_LIFTD_P80,
120 .liftd_p50 = GUIDANCE_INDI_LIFTD_P50,
121 .min_airspeed = GUIDANCE_INDI_MIN_AIRSPEED,
122 .max_airspeed = GUIDANCE_INDI_MAX_AIRSPEED,
123 .stall_protect_gain = 1.5, // m/s^2 downward acceleration per m/s airspeed loss
124 .climb_vspeed_fwd = GUIDANCE_INDI_FWD_CLIMB_SPEED,
125 .descend_vspeed_fwd = GUIDANCE_INDI_FWD_DESCEND_SPEED,
126 .climb_vspeed_quad = GUIDANCE_INDI_QUAD_CLIMB_SPEED,
127 .descend_vspeed_quad = GUIDANCE_INDI_QUAD_DESCEND_SPEED,
128};
129
130// Quadplanes can hover at various pref pitch
132
133
134// If using WLS, check that the matrix size is sufficient
135#if GUIDANCE_INDI_HYBRID_USE_WLS
136#if GUIDANCE_INDI_HYBRID_U > WLS_N_U_MAX
137#error Matrix-WLS_N_U_MAX too small: increase WLS_N_U_MAX in airframe file
138#endif
139
140#if GUIDANCE_INDI_HYBRID_V > WLS_N_V_MAX
141#error Matrix-WLS_N_V_MAX too small: increase WLS_N_V_MAX in airframe file
142#endif
143#endif
144
145
146// Tell the guidance that the airspeed needs to be zeroed.
147// Recomended to also put GUIDANCE_INDI_NAV_SPEED_MARGIN low in this case.
148#ifndef GUIDANCE_INDI_ZERO_AIRSPEED
149#define GUIDANCE_INDI_ZERO_AIRSPEED FALSE
150#endif
151
152/*Airspeed threshold where making a turn is "worth it"*/
153#ifndef TURN_AIRSPEED_TH
154#define TURN_AIRSPEED_TH 13.0
155#endif
156
157/*Boolean to force the heading to a static value (only use for specific experiments)*/
159
160bool force_forward = false;
161
163
164
165struct FloatVect3 sp_accel = {0.0,0.0,0.0};
166#ifdef GUIDANCE_INDI_SPECIFIC_FORCE_GAIN
168static void guidance_indi_filter_thrust(void);
169
170#ifdef GUIDANCE_INDI_THRUST_DYNAMICS
171#warning GUIDANCE_INDI_THRUST_DYNAMICS is deprecated, use GUIDANCE_INDI_THRUST_DYNAMICS_FREQ instead.
172#warning "The thrust dynamics are now specified in continuous time with the corner frequency of the first order model!"
173#warning "define GUIDANCE_INDI_THRUST_DYNAMICS_FREQ in rad/s"
174#warning "Use -ln(1 - old_number) * PERIODIC_FREQUENCY to compute it from the old value."
175#endif
176
177#ifndef GUIDANCE_INDI_THRUST_DYNAMICS_FREQ
178#ifndef STABILIZATION_INDI_ACT_FREQ_P
179#error "You need to define GUIDANCE_INDI_THRUST_DYNAMICS_FREQ to be able to use indi vertical control"
180#else // assume that the same actuators are used for thrust as for roll (e.g. quadrotor)
181#define GUIDANCE_INDI_THRUST_DYNAMICS_FREQ STABILIZATION_INDI_ACT_FREQ_P
182#endif
183#endif //GUIDANCE_INDI_THRUST_DYNAMICS_FREQ
184
185#endif //GUIDANCE_INDI_SPECIFIC_FORCE_GAIN
186
187#ifndef GUIDANCE_INDI_FILTER_CUTOFF
188#ifdef STABILIZATION_INDI_FILT_CUTOFF
189#define GUIDANCE_INDI_FILTER_CUTOFF STABILIZATION_INDI_FILT_CUTOFF
190#else
191#define GUIDANCE_INDI_FILTER_CUTOFF 3.0
192#endif
193#endif
194
195#ifndef GUIDANCE_INDI_AIRSPEED_FILT_CUTOFF
196#define GUIDANCE_INDI_AIRSPEED_FILT_CUTOFF 0.5
197#endif
198
199#ifndef GUIDANCE_INDI_MAX_LAT_ACCEL
200#define GUIDANCE_INDI_MAX_LAT_ACCEL 9.81
201#endif
202
203#ifndef GUIDANCE_INDI_COORDINATED_TURN_MIN_AIRSPEED
204#define GUIDANCE_INDI_COORDINATED_TURN_MIN_AIRSPEED 10.0
205#endif
206
207#ifndef GUIDANCE_INDI_COORDINATED_TURN_MAX_AIRSPEED
208#define GUIDANCE_INDI_COORDINATED_TURN_MAX_AIRSPEED 30.0
209#endif
210
211#ifndef GUIDANCE_INDI_COORDINATED_TURN_AIRSPEED_MARGIN
212#define GUIDANCE_INDI_COORDINATED_TURN_AIRSPEED_MARGIN 0.0
213#endif
214
215float inv_eff[4];
216
217// Max bank angle in radians
220
221#if defined(ROTWING_STATE_FW_MAX_AIRSPEED) && defined(ROTWING_STATE_QUAD_MAX_AIRSPEED)
224#else
227#endif
228
230
233
234float thrust_dyn = 0.f;
235float thrust_act = 0.f;
243static float previous_yaw_raw = 0.0f;
244float yaw_filt = 0.0f;
245
248
251
252float du_gih[GUIDANCE_INDI_HYBRID_U]; // = {0.0f, 0.0f, 0.0f};
253
254#if GUIDANCE_INDI_HYBRID_USE_WLS
255#include "math/wls/wls_alloc.h"
257struct WLS_t wls_guid_p = {
260 .gamma_sq = 100000.0,
261 .v = {0.0},
262#ifdef GUIDANCE_INDI_WLS_PRIORITIES
264#else // X,Y accel, Z accel
265 .Wv = { 100.f, 100.f, 1.f },
266#endif
267#ifdef GUIDANCE_INDI_WLS_WU
269#else
270 .Wu = {[0 ... GUIDANCE_INDI_HYBRID_U - 1] = 1.0},
271#endif
272 .u_pref = {0.0},
273 .u_min = {0.0},
274 .u_max = {0.0},
275 .PC = 0.0,
276 .SC = 0.0,
277 .iter = 0
278};
279#endif
280// The control objective
281float v_gih[3];
282
283// Filters
286
291
292struct FloatVect3 gi_speed_sp = {0.0, 0.0, 0.0};
293
294#ifndef GUIDANCE_INDI_VEL_SP_ID
295#define GUIDANCE_INDI_VEL_SP_ID ABI_BROADCAST
296#endif
298static void vel_sp_cb(uint8_t sender_id, struct FloatVect3 *vel_sp);
299struct FloatVect3 indi_vel_sp = {0.0, 0.0, 0.0};
300float time_of_vel_sp = 0.0;
301
303
304#if PERIODIC_TELEMETRY
313static void send_guidance_indi_hybrid(struct transport_tx *trans, struct link_device *dev)
314{
316 &sp_accel.x,
317 &sp_accel.y,
318 &sp_accel.z,
319 &euler_cmd.x,
320 &euler_cmd.y,
321 &euler_cmd.z,
322 &filt_accel_ned[0].o[0],
323 &filt_accel_ned[1].o[0],
324 &filt_accel_ned[2].o[0],
325 &gi_speed_sp.x,
326 &gi_speed_sp.y,
327 &gi_speed_sp.z);
328}
329
330#if GUIDANCE_INDI_HYBRID_USE_WLS
331static void send_wls_v_guid(struct transport_tx *trans, struct link_device *dev)
332{
333 send_wls_v("guid", &wls_guid_p, trans, dev);
334}
335static void send_wls_u_guid(struct transport_tx *trans, struct link_device *dev)
336{
337 send_wls_u("guid", &wls_guid_p, trans, dev);
338}
339#endif // GUIDANCE_INDI_HYBRID_USE_WLS
340
341#endif // PERIODIC_TELEMETRY
342
347{
348 /*AbiBindMsgACCEL_SP(GUIDANCE_INDI_ACCEL_SP_ID, &accel_sp_ev, accel_sp_cb);*/
350
351#ifdef GUIDANCE_INDI_SPECIFIC_FORCE_GAIN
352#ifdef GUIDANCE_INDI_THRUST_DYNAMICS
354#else
356#endif
357#endif
358
359 float tau = 1.0/(2.0*M_PI*filter_cutoff);
361 for(int8_t i=0; i<3; i++) {
363 }
367 previous_yaw_raw = 0.0f;
368 yaw_filt = 0.0f;
371
374
375#if GUIDANCE_INDI_HYBRID_USE_WLS
376 for (int8_t i = 0; i < GUIDANCE_INDI_HYBRID_V; i++) {
377 Bwls_gih[i] = Ga[i];
378 }
379#endif
380
381#if PERIODIC_TELEMETRY
384#if GUIDANCE_INDI_HYBRID_USE_WLS
387#endif
388#endif
389}
390
423
424void guidance_set_min_max_airspeed(float min_airspeed, float max_airspeed) {
425 gih_params.min_airspeed = min_airspeed;
427}
428
432
437
442
451{
452 // set global accel sp variable FIXME clean this
454
455 /* Obtain eulers with zxy rotation order */
457
458 /* Calculate the transition ratio so that the ctrl_effecitveness scheduling works */
461
462 // filter accel to get rid of noise and filter attitude to synchronize with accel
464
465#if GUIDANCE_INDI_RC_DEBUG
466#warning "GUIDANCE_INDI_RC_DEBUG lets you control the accelerations via RC, but disables autonomous flight!"
467 // for rc control horizontal, rotate from body axes to NED
468 float psi = eulers_zxy.psi;
469 float rc_x = -(radio_control.values[RADIO_PITCH]/9600.0)*8.0;
470 float rc_y = (radio_control.values[RADIO_ROLL]/9600.0)*8.0;
471 sp_accel.x = cosf(psi) * rc_x - sinf(psi) * rc_y;
472 sp_accel.y = sinf(psi) * rc_x + cosf(psi) * rc_y;
473
474 // for rc vertical control
475 sp_accel.z = -(radio_control.values[RADIO_THROTTLE]-4500)*8.0/9600.0;
476#endif
477
478 struct FloatVect3 accel_filt;
479 accel_filt.x = filt_accel_ned[0].o[0];
480 accel_filt.y = filt_accel_ned[1].o[0];
481 accel_filt.z = filt_accel_ned[2].o[0];
482
483 struct FloatVect3 a_diff;
484 VECT3_DIFF(a_diff, sp_accel, accel_filt);
485
486 // Bound the acceleration error so that the linearization still holds
487 Bound(a_diff.x, -6.0, 6.0);
488 Bound(a_diff.y, -6.0, 6.0);
489 Bound(a_diff.z, -9.0, 9.0);
490
491 // If the thrust to specific force ratio has been defined, include vertical control
492 // else ignore the vertical acceleration error
493#ifndef GUIDANCE_INDI_SPECIFIC_FORCE_GAIN
494#ifndef STABILIZATION_ATTITUDE_INDI_FULL
495 a_diff.z = 0.0;
496#endif
497#endif
498
499 // Calculate matrix of partial derivatives and control objective
501
502#if GUIDANCE_INDI_HYBRID_USE_WLS
503
504 // Calculate the maximum deflections
506
507 float du_gih[GUIDANCE_INDI_HYBRID_U]; // = {0.0f, 0.0f, 0.0f};
508
509 for (int i = 0; i < GUIDANCE_INDI_HYBRID_V; i++) {
510 wls_guid_p.v[i] = v_gih[i];
511 }
512 wls_alloc(&wls_guid_p, Bwls_gih, 0, 0, 10);
513 for (int i = 0; i < GUIDANCE_INDI_HYBRID_U; i++) {
514 du_gih[i] = wls_guid_p.u[i];
515 }
516 euler_cmd.x = du_gih[0];
517 euler_cmd.y = du_gih[1];
518 euler_cmd.z = du_gih[2];
519
520#else
521 // compute inverse matrix of Ga
522 float Ga_inv[3][3] = {};
524 // Calculate roll,pitch and thrust command
526#endif
527
528 // Coordinated turn
529 // feedforward estimate angular rotation omega = g*tan(phi)/v
530 float omega;
531 const float max_phi = RadOfDeg(60.0f);
532#if GUIDANCE_INDI_ZERO_AIRSPEED
533 float airspeed_turn = 0.f;
534#else
536#endif
537 // We are dividing by the airspeed, so a lower bound is important
539
542
543 //Bound euler angles to prevent flipping
546
547 // Use the current roll angle to determine the corresponding heading rate of change.
549
550 // When tilting backwards (e.g. waypoint behind the drone), we have to yaw around to face the direction
551 // of flight even when the drone is not rolling much (yet). Determine the shortest direction in which to yaw by
552 // looking at the roll angle.
553 if( (eulers_zxy.theta > 0.0f) && ( fabs(eulers_zxy.phi) < eulers_zxy.theta)) {
554 if (eulers_zxy.phi > 0.0f) {
556 } else {
558 }
559 }
560
562 omega = 9.81f / airspeed_turn * tanf(coordinated_turn_roll);
563 } else { //max 60 degrees roll
564 omega = 9.81f / airspeed_turn * 1.72305f * ((coordinated_turn_roll > 0.0f) - (coordinated_turn_roll < 0.0f));
565 }
566
567#ifdef FWD_SIDESLIP_GAIN
568 // Add sideslip correction
569 omega -= accely_filt.o[0]*FWD_SIDESLIP_GAIN;
570#endif
571
572 // We can pre-compute the required rates to achieve this turn rate:
573 // NOTE: there *should* not be any problems possible with Euler singularities here
575
576 struct FloatRates ff_rates;
577
578 ff_rates.p = -sinf(euler_zyx->theta) * omega;
579 ff_rates.q = cosf(euler_zyx->theta) * sinf(euler_zyx->phi) * omega;
580 ff_rates.r = cosf(euler_zyx->theta) * cosf(euler_zyx->phi) * omega;
581
582 // For a hybrid it is important to reduce the sideslip, which is done by changing the heading.
583 // For experiments, it is possible to fix the heading to a different value.
585 // heading is fixed by nav
586 guidance_euler_cmd.psi = heading_sp;
587 }
588 else {
589 // heading is free and controlled by guidance
592 // limit heading setpoint to be within bounds of current heading
593#ifdef STABILIZATION_ATTITUDE_SP_PSI_DELTA_LIMIT
598 if (delta_psi > delta_limit) {
600 } else if (delta_psi < -delta_limit) {
602 }
604#endif
606 }
607
608 // compute required thrust setpoint
609#ifdef GUIDANCE_INDI_SPECIFIC_FORCE_GAIN
611 // Add the increment in specific force * specific_force_to_thrust_gain to the filtered thrust
614#if GUIDANCE_INDI_RC_DEBUG
616 thrust_in = 0;
617 }
618#endif
619 // return required thrust
621
622#else
623 float thrust_vect[3];
624#if GUIDANCE_INDI_HYBRID_U > 3
625 thrust_vect[0] = du_gih[3];
628 }
629#else
630 thrust_vect[0] = 0;
631#endif
632 thrust_vect[1] = 0;
634 // specific force not defined, return required increment
636#endif
637
638 // Set the quaternion setpoint from eulers_zxy
639 struct FloatQuat sp_quat;
642
644}
645
646// compute accel setpoint from speed setpoint (use global variables ! FIXME)
648{
649 struct FloatVect3 accel_sp = { 0.f, 0.f, 0.f };
650
652
653 //for rc control horizontal, rotate from body axes to NED
654 float psi = eulers_zxy.psi;
655 float cpsi = cosf(psi);
656 float spsi = sinf(psi);
657 float speed_sp_b_x = cpsi * gi_speed_sp.x + spsi * gi_speed_sp.y;
658 float speed_sp_b_y = -spsi * gi_speed_sp.x + cpsi * gi_speed_sp.y;
659
660 // Get airspeed or zero it
661#if GUIDANCE_INDI_ZERO_AIRSPEED
662 float airspeed = 0.f;
663#else
664 float airspeed = stateGetAirspeed_f();
665 Bound(airspeed, 0.0f, 100.0f);
667 airspeed = guidance_indi_airspeed_filt.o[0];
668 }
669#endif
671 struct FloatVect2 airspeed_v = { cpsi * airspeed, spsi * airspeed };
672 struct FloatVect2 windspeed;
674
675 VECT2_DIFF(desired_airspeed, gi_speed_sp, windspeed); // Use 2d part of gi_speed_sp
677
679
680 // Check if some minimum airspeed is desired (e.g. to prevent stall)
683 }
684
686
687 // Make turn instead of straight line, control airspeed
688 if ((airspeed > TURN_AIRSPEED_TH) && (norm_des_as > (TURN_AIRSPEED_TH+2.0f))) {
689
690 // Give the wind cancellation priority.
692 float groundspeed_factor = 0.0f;
693
694 // if the wind is faster than we can fly, just fly in the wind direction
697 float bv = -2.f * (windspeed.x * gi_speed_sp.x + windspeed.y * gi_speed_sp.y);
699
700 float dv = bv * bv - 4.0f * av * cv;
701
702 // dv can only be positive, but just in case
703 if (dv < 0.0f) {
704 dv = fabsf(dv);
705 }
706 float d_sqrt = sqrtf(dv);
707
708 groundspeed_factor = (-bv + d_sqrt) / (2.0f * av);
709 }
710
713
715 }
716
717 if (force_forward) {
719 }
720
721 // Calculate accel sp in body axes, because we need to regulate airspeed
722 struct FloatVect2 sp_accel_b;
723 // In turn acceleration proportional to heading diff
727
729
730 // Control the airspeed
732
733 accel_sp.x = cpsi * sp_accel_b.x - spsi * sp_accel_b.y;
734 accel_sp.y = spsi * sp_accel_b.x + cpsi * sp_accel_b.y;
736 }
737 else { // Go somewhere in the shortest way
738
739 if (airspeed > 10.f) {
740 // Groundspeed vector in body frame
741 float groundspeed_x = cpsi * stateGetSpeedNed_f()->x + spsi * stateGetSpeedNed_f()->y;
743
744 // limit groundspeed setpoint to max_airspeed + (diff gs and airspeed)
745 if ((speed_increment + airspeed) > gih_params.max_airspeed) {
747 }
748 }
749
750 gi_speed_sp.x = cpsi * speed_sp_b_x - spsi * speed_sp_b_y;
751 gi_speed_sp.y = spsi * speed_sp_b_x + cpsi * speed_sp_b_y;
752
756 }
757
758 // Bound the acceleration setpoint
759 float accelbound = 3.0f + airspeed / gih_params.max_airspeed * 5.0f; // FIXME remove hard coded values
761 BoundAbs(accel_sp.z, 3.0);
762
763#ifdef ROTWING_FW_MIN_AIRSPEED
766 BoundAbs(accel_sp.z, 5.0);
767 }
768#endif
769
770 return accel_sp;
771}
772
773static float bound_vz_sp(float vz_sp)
774{
775 // Bound vertical speed setpoint
778 } else {
780 }
781 return vz_sp;
782}
783
785{
786 struct FloatVect3 pos_err = { 0 };
787 struct FloatVect3 accel_sp = { 0 };
788
789 // First check for velocity setpoint from module // FIXME should be called like this
790 float dt = get_sys_time_float() - time_of_vel_sp;
791 // If the input command is not updated after a timeout, switch back to flight plan control
792 if (dt < 0.5) {
796 accel_sp = compute_accel_from_speed_sp(); // compute accel sp
797 return guidance_indi_run(&accel_sp, gh->sp.heading);
798 }
799
801 //Linear controller to find the acceleration setpoint from position and velocity
809 } else if (v_mode == GUIDANCE_INDI_HYBRID_V_SPEED) {
811 } else {
812 gi_speed_sp.z = 0.f;
813 }
814 accel_sp = compute_accel_from_speed_sp(); // compute accel sp
816 accel_sp.z = (gi_speed_sp.z - stateGetSpeedNed_f()->z) * gih_params.speed_gainz + ACCEL_FLOAT_OF_BFP(gv->zdd_ref); // overwrite accel
817 }
818 return guidance_indi_run(&accel_sp, gh->sp.heading);
819 }
821 gi_speed_sp.x = SPEED_FLOAT_OF_BFP(gh->ref.speed.x);
822 gi_speed_sp.y = SPEED_FLOAT_OF_BFP(gh->ref.speed.y);
826 } else if (v_mode == GUIDANCE_INDI_HYBRID_V_SPEED) {
828 } else {
829 gi_speed_sp.z = 0.f;
830 }
831 accel_sp = compute_accel_from_speed_sp(); // compute accel sp
833 accel_sp.z = (gi_speed_sp.z - stateGetSpeedNed_f()->z) * gih_params.speed_gainz + ACCEL_FLOAT_OF_BFP(gv->zdd_ref); // overwrite accel
834 }
835 return guidance_indi_run(&accel_sp, gh->sp.heading);
836 }
837 else { // H_ACCEL
838 gi_speed_sp.x = 0.f;
839 gi_speed_sp.y = 0.f;
843 } else if (v_mode == GUIDANCE_INDI_HYBRID_V_SPEED) {
845 } else {
846 gi_speed_sp.z = 0.f;
847 }
848 accel_sp = compute_accel_from_speed_sp(); // compute accel sp in case z control is required
849 // overwrite accel X and Y
853 accel_sp.z = (gi_speed_sp.z - stateGetSpeedNed_f()->z) * gih_params.speed_gainz + ACCEL_FLOAT_OF_BFP(gv->zdd_ref); // overwrite accel
854 }
855 return guidance_indi_run(&accel_sp, gh->sp.heading);
856 }
857}
858
859#ifdef GUIDANCE_INDI_SPECIFIC_FORCE_GAIN
864{
865 // Actuator dynamics
867
868 // same filter as for the acceleration
870}
871
872#endif
873
881{
882 struct NedCoor_f *accel = stateGetAccelNed_f();
886
889
890 // Filter yaw delta instead of raw angle to handle wrapping properly
892 FLOAT_ANGLE_NORMALIZE(yaw_delta); // Normalize to [-pi, pi]
895 // Accumulate filtered delta
898
899 // Propagate filter for sideslip correction
902
903 float airspeed = stateGetAirspeed_f();
904 Bound(airspeed, 0.0f, 100.0f);
906}
907
908
916float WEAK guidance_indi_get_liftd(float airspeed, float theta) {
917 float liftd = 0.0f;
918
919 if (airspeed < 12.f) {
920 /* Assume the airspeed is too low to be measured accurately
921 * Use scheduling based on pitch angle instead.
922 * You can define two interpolation segments
923 */
924 float pitch_interp = DegOfRad(theta);
925 const float min_pitch = -80.0f;
926 const float middle_pitch = -50.0f;
927 const float max_pitch = -20.0f;
928
931 float ratio = (pitch_interp - max_pitch)/(middle_pitch - max_pitch);
932 liftd = -gih_params.liftd_p50*ratio;
933 } else {
934 float ratio = (pitch_interp - middle_pitch)/(min_pitch - middle_pitch);
936 }
937 } else {
938 liftd = -gih_params.liftd_asq*airspeed*airspeed;
939 }
940
941 //TODO: bound liftd
942 return liftd;
943}
944
949{
950 indi_vel_sp.x = vel_sp->x;
951 indi_vel_sp.y = vel_sp->y;
952 indi_vel_sp.z = vel_sp->z;
954}
955
956
957#if GUIDANCE_INDI_HYBRID_USE_AS_DEFAULT
958// guidance indi control function is implementing the default functions of guidance
959
960void guidance_h_run_enter(void)
961{
963}
964
965void guidance_v_run_enter(void)
966{
967 // nothing to do
968}
969
970static struct VerticalGuidance *_gv = &guidance_v;
972
974{
976}
977
979{
981}
982
984{
986}
987
989{
990 _gv = gv;
992 return thrust_sp;
993}
994
996{
997 _gv = gv;
999 return thrust_sp;
1000}
1001
1003{
1004 _gv = gv;
1006 return thrust_sp;
1007}
1008
1009#endif
1010
Main include for ABI (AirBorneInterface).
Event structure to store callbacks in a linked list.
Definition abi_common.h:68
Core autopilot interface common to all firmwares.
#define UNUSED(x)
static struct uart_periph * dev
float phi
in radians
float p
in rad/s
float theta
in radians
float psi
in radians
static void float_quat_normalize(struct FloatQuat *q)
#define FLOAT_ANGLE_NORMALIZE(_a)
void float_eulers_of_quat_zxy(struct FloatEulers *e, const struct FloatQuat *q)
euler rotation 'ZXY' This rotation order is useful if you need 90 deg pitch
void float_mat3_mult(struct FloatVect3 *vect_out, const float mat[3][3], const struct FloatVect3 vect_in)
Multiply 3D matrix with vector.
bool float_mat_inv_3d(float inv_out[3][3], const float mat_in[3][3])
3x3 matrix inverse
void float_quat_of_eulers_zxy(struct FloatQuat *q, const struct FloatEulers *e)
quat from euler rotation 'ZXY' This rotation order is useful if you need 90 deg pitch
void float_vect3_bound_in_2d(struct FloatVect3 *vect3, const float bound)
#define FLOAT_VECT2_NORM(_v)
euler angles
Roation quaternion.
angular rates
#define VECT2_DIFF(_c, _a, _b)
#define VECT3_DIFF(_c, _a, _b)
#define POS_FLOAT_OF_BFP(_ai)
#define SPEED_FLOAT_OF_BFP(_ai)
#define ACCEL_FLOAT_OF_BFP(_ai)
static struct NedCoor_f * stateGetAccelNed_f(void)
Get acceleration in NED coordinates (float).
Definition state.h:1203
static struct FloatEulers * stateGetNedToBodyEulers_f(void)
Get vehicle body attitude euler angles (float).
Definition state.h:1314
static struct FloatQuat * stateGetNedToBodyQuat_f(void)
Get vehicle body attitude quaternion (float).
Definition state.h:1302
static struct NedCoor_f * stateGetPositionNed_f(void)
Get position in local NED coordinates (float).
Definition state.h:839
static struct NedCoor_f * stateGetSpeedNed_f(void)
Get ground speed in local NED coordinates (float).
Definition state.h:1049
static struct Int32Vect3 * stateGetAccelBody_i(void)
Get acceleration in Body coordinates (int).
Definition state.h:1094
static float stateGetAirspeed_f(void)
Get airspeed (float).
Definition state.h:1598
int32_t max_airspeed
struct FloatMat33 Ga_inv
float thrust_vect[3]
float guidance_indi_specific_force_gain
struct FloatVect3 indi_vel_sp
bool force_forward
forward flight for hybrid nav
#define GUIDANCE_INDI_COORDINATED_TURN_AIRSPEED_MARGIN
Butterworth2LowPass accely_filt
static void vel_sp_cb(uint8_t sender_id, struct FloatVect3 *vel_sp)
ABI callback that obtains the velocity setpoint from a module.
float time_of_vel_sp
Butterworth2LowPass roll_filt
#define GUIDANCE_INDI_QUAD_DESCEND_SPEED
Descend speed when navigation is doing direct lines.
#define GUIDANCE_INDI_SPEED_GAINZ
#define GUIDANCE_INDI_COORDINATED_TURN_MIN_AIRSPEED
struct guidance_indi_hybrid_params gih_params
float thrust_in
#define GUIDANCE_INDI_MAX_LAT_ACCEL
struct FloatVect3 gi_speed_sp
float guidance_indi_min_pitch
float guidance_indi_max_bank
#define GUIDANCE_INDI_MIN_AIRSPEED
float gih_coordinated_turn_min_airspeed
struct StabilizationSetpoint guidance_indi_run_mode(bool in_flight UNUSED, struct HorizontalGuidance *gh, struct VerticalGuidance *gv, enum GuidanceIndiHybrid_HMode h_mode, enum GuidanceIndiHybrid_VMode v_mode)
void guidance_set_max_bank_angle(float max_bank)
float inv_eff[4]
#define GUIDANCE_INDI_FWD_DESCEND_SPEED
Descend speed when navigation is making turns instead of direct lines.
void guidance_set_max_climb_speed(float max_climb_speed_quad, float max_climb_speed_fwd)
float gih_coordinated_turn_max_airspeed
struct FloatVect3 sp_accel
struct FloatEulers guidance_euler_cmd
float guidance_indi_pitch_pref_deg
#define GUIDANCE_INDI_LIFTD_ASQ
#define GUIDANCE_INDI_QUAD_CLIMB_SPEED
Climb speed when navigation is doing direct lines.
float guidance_indi_airspeed_filt_cutoff
float thrust_act
void guidance_indi_enter(void)
Call upon entering indi guidance.
Butterworth2LowPass guidance_indi_airspeed_filt
Butterworth2LowPass pitch_filt
#define GUIDANCE_INDI_POS_GAIN
#define GUIDANCE_INDI_COORDINATED_TURN_MAX_AIRSPEED
#define GUIDANCE_INDI_FWD_CLIMB_SPEED
Climb speed when navigation is making turns instead of direct lines.
bool take_heading_control
void guidance_set_min_max_airspeed(float min_airspeed, float max_airspeed)
float guidance_indi_hybrid_heading_sp
float WEAK guidance_indi_get_liftd(float airspeed, float theta)
Get the derivative of lift w.r.t.
struct ThrustSetpoint thrust_sp
#define GUIDANCE_INDI_LIFTD_P50
static void send_guidance_indi_hybrid(struct transport_tx *trans, struct link_device *dev)
void guidance_indi_init(void)
Init function.
float yaw_filt
float filter_cutoff
static float previous_yaw_raw
#define GUIDANCE_INDI_FILTER_CUTOFF
static Butterworth2LowPass yaw_delta_filt
void guidance_set_max_descend_speed(float max_descend_speed_quad, float max_descend_speed_fwd)
#define GUIDANCE_INDI_MAX_PUSHER_INCREMENT
float Ga[GUIDANCE_INDI_HYBRID_V][GUIDANCE_INDI_HYBRID_U]
struct FloatVect3 euler_cmd
static float bound_vz_sp(float vz_sp)
struct FloatEulers eulers_zxy
state eulers in zxy order
Butterworth2LowPass filt_accel_ned[3]
float gi_unbounded_airspeed_sp
#define GUIDANCE_INDI_AIRSPEED_FILT_CUTOFF
#define GUIDANCE_INDI_POS_GAINZ
#define TURN_AIRSPEED_TH
float thrust_dyn
static void send_eff_mat_guid_indi_hybrid(struct transport_tx *trans, struct link_device *dev)
static struct FloatVect3 compute_accel_from_speed_sp(void)
#define GUIDANCE_INDI_VEL_SP_ID
struct StabilizationSetpoint guidance_indi_run(struct FloatVect3 *accel_sp, float heading_sp)
bool coordinated_turn_use_accel
float v_gih[3]
void guidance_indi_propagate_filters(void)
Low pass the accelerometer measurements to remove noise from vibrations.
bool guidance_indi_airspeed_filtering
#define GUIDANCE_INDI_LIFTD_P80
abi_event vel_sp_ev
Butterworth2LowPass thrust_filt
#define GUIDANCE_INDI_SPEED_GAIN
float du_gih[GUIDANCE_INDI_HYBRID_U]
struct FloatVect2 desired_airspeed
A guidance mode based on Incremental Nonlinear Dynamic Inversion Come to ICRA2016 to learn more!
void guidance_indi_calcg_wing(float Gmat[GUIDANCE_INDI_HYBRID_V][GUIDANCE_INDI_HYBRID_U], struct FloatVect3 a_diff, float v_body[GUIDANCE_INDI_HYBRID_V])
Perform WLS.
GuidanceIndiHybrid_VMode
@ GUIDANCE_INDI_HYBRID_V_POS
@ GUIDANCE_INDI_HYBRID_V_SPEED
@ GUIDANCE_INDI_HYBRID_V_ACCEL
GuidanceIndiHybrid_HMode
@ GUIDANCE_INDI_HYBRID_H_SPEED
@ GUIDANCE_INDI_HYBRID_H_ACCEL
@ GUIDANCE_INDI_HYBRID_H_POS
void WEAK guidance_indi_hybrid_set_wls_settings(float body_v[3], float roll_angle, float pitch_angle)
#define GUIDANCE_INDI_MAX_PITCH
#define GUIDANCE_INDI_MIN_PITCH
static enum GuidanceOneloop_VMode _v_mode
void guidance_v_run_enter(void)
static struct VerticalGuidance * _gv
struct ThrustSetpoint guidance_v_run_pos(bool in_flight UNUSED, struct VerticalGuidance *gv)
struct ThrustSetpoint guidance_v_run_speed(bool in_flight UNUSED, struct VerticalGuidance *gv)
struct ThrustSetpoint guidance_v_run_accel(bool in_flight UNUSED, struct VerticalGuidance *gv)
Simple first order low pass filter with bilinear transform.
float o[2]
output history
static void init_butterworth_2_low_pass(Butterworth2LowPass *filter, const float tau, const float sample_time, const float value)
Init a second order Butterworth filter.
static float update_butterworth_2_low_pass(Butterworth2LowPass *filter, const float value)
Update second order Butterworth low pass filter state with a new value.
Second order low pass filter structure.
uint16_t foo
Definition main_demo5.c:58
float z
in meters
float x
in meters
float y
in meters
vector in North East Down coordinates Units: meters
struct RadioControl radio_control
Generic interface for radio control modules.
pprz_t values[RADIO_CONTROL_NB_CHANNEL]
Some helper functions to check RC sticks.
void guidance_h_run_enter(void)
struct StabilizationSetpoint guidance_h_run_pos(bool in_flight, struct HorizontalGuidance *gh)
struct StabilizationSetpoint guidance_h_run_speed(bool in_flight, struct HorizontalGuidance *gh)
struct StabilizationSetpoint guidance_h_run_accel(bool in_flight, struct HorizontalGuidance *gh)
#define GUIDANCE_H_MAX_BANK
Max bank controlled by guidance.
Definition guidance_h.h:64
struct VerticalGuidance guidance_v
Definition guidance_v.c:60
struct RotorcraftNavigation nav
Definition navigation.c:51
Rotorcraft navigation functions.
float heading
heading setpoint (in radians)
Definition navigation.h:133
bool rotwing_state_pusher_motor_running(void)
bool rotwing_state_hover_motors_running(void)
struct Stabilization stabilization
struct ThrustSetpoint th_sp_from_incr_vect_f(float th_increment[3])
struct StabilizationSetpoint stab_sp_from_quat_ff_rates_f(struct FloatQuat *quat, struct FloatRates *rates)
struct ThrustSetpoint th_sp_from_thrust_i(int32_t thrust, uint8_t axis)
#define THRUST_AXIS_Z
float transition_ratio
transition percentage for hybrids (0.: hover; 1.: forward)
int32_t cmd[COMMANDS_NB]
output command vector, range from [-MAX_PPRZ:MAX_PPRZ] (store for messages)
float stabilization_attitude_get_heading_f(void)
Get attitude heading as float (avoiding jumps)
float g1g2[INDI_OUTPUTS][INDI_NUM_ACT]
API to get/set the generic vehicle states.
Stabilization setpoint.
Thrust setpoint // TODO to a setpoint header Structure to store the desired thrust vector with differ...
Architecture independent timing functions.
static float get_sys_time_float(void)
Get the time in seconds since startup.
Definition sys_time.h:168
int16_t register_periodic_telemetry(struct periodic_telemetry *_pt, uint16_t _id, telemetry_cb _cb)
Register a telemetry callback function.
Definition telemetry.c:51
Periodic telemetry system header (includes downlink utility and generated code).
#define DefaultPeriodic
Set default periodic telemetry.
Definition telemetry.h:66
unsigned char uint8_t
Typedef defining 8 bit unsigned char type.
signed char int8_t
Typedef defining 8 bit char type.
float heading
Definition wedgebug.c:258
void send_wls_v(char *name, struct WLS_t *WLS_p, struct transport_tx *trans, struct link_device *dev)
Definition wls_alloc.c:61
void wls_alloc(struct WLS_t *WLS_p, float **B, float *u_guess, float *W_init, int imax)
active set algorithm for control allocation
Definition wls_alloc.c:119
void send_wls_u(char *name, struct WLS_t *WLS_p, struct transport_tx *trans, struct link_device *dev)
Definition wls_alloc.c:71
int nu
Definition wls_alloc.h:67