Paparazzi UAS  v5.18.0_stable
Paparazzi is a free software Unmanned Aircraft System.
mission_common.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2014 Paparazzi Team
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  */
22 
30 #ifndef MISSION_COMMON_H
31 #define MISSION_COMMON_H
32 
33 #include "std.h"
35 #include "math/pprz_geodetic_int.h"
36 
38  MissionWP = 1,
43 };
44 
51 };
52 
53 struct _mission_wp {
54  union {
55  struct EnuCoor_f wp_f;
56  struct EnuCoor_i wp_i;
57  } wp;
58 };
59 
61  union {
62  struct EnuCoor_f center_f;
63  struct EnuCoor_i center_i;
64  } center;
65 
66  float radius;
67 };
68 
70  union {
71  struct EnuCoor_f from_f;
72  struct EnuCoor_i from_i;
73  } from;
74 
75  union {
76  struct EnuCoor_f to_f;
77  struct EnuCoor_i to_i;
78  } to;
79 };
80 
81 #define MISSION_PATH_NB 5
82 struct _mission_path {
83  union {
84  struct EnuCoor_f path_f[MISSION_PATH_NB];
85  struct EnuCoor_i path_i[MISSION_PATH_NB];
86  } path;
87 
90 };
91 
92 #define MISSION_CUSTOM_MAX 12 // maximum number of parameters
93 #define MISSION_TYPE_SIZE 6
94 
101 typedef bool (*mission_custom_cb)(uint8_t nb, float *params, bool init);
102 
106 };
107 
112 };
113 
116  union {
117  struct _mission_wp mission_wp;
118  struct _mission_circle mission_circle;
119  struct _mission_segment mission_segment;
120  struct _mission_path mission_path;
121  struct _mission_custom mission_custom;
122  } element;
123 
124  float duration;
126 };
127 
131 #ifndef MISSION_ELEMENT_NB
132 #define MISSION_ELEMENT_NB 20
133 #endif
134 
138 #ifndef MISSION_REGISTER_NB
139 #define MISSION_REGISTER_NB 6
140 #endif
141 
142 struct _mission {
145  float element_time;
148 };
149 
150 extern struct _mission mission;
151 
154 extern void mission_init(void);
155 
161 extern bool mission_insert(enum MissionInsertMode insert, struct _mission_element *element);
162 
168 extern bool mission_register(mission_custom_cb cb, char *type);
169 
174 extern bool mission_element_convert(struct _mission_element *el);
175 
179 extern struct _mission_element *mission_get(void);
180 
187 extern bool mission_point_of_lla(struct EnuCoor_f *point, struct LlaCoor_i *lla);
188 
198 extern int mission_run(void);
199 
204 extern void mission_status_report(void);
205 
208 extern int mission_parse_GOTO_WP(uint8_t *buf);
209 extern int mission_parse_GOTO_WP_LLA(uint8_t *buf);
210 extern int mission_parse_CIRCLE(uint8_t *buf);
211 extern int mission_parse_CIRCLE_LLA(uint8_t *buf);
212 extern int mission_parse_SEGMENT(uint8_t *buf);
213 extern int mission_parse_SEGMENT_LLA(uint8_t *buf);
214 extern int mission_parse_PATH(uint8_t *buf);
215 extern int mission_parse_PATH_LLA(uint8_t *buf);
216 extern int mission_parse_CUSTOM(uint8_t *buf);
217 extern int mission_parse_GOTO_MISSION(uint8_t *buf);
218 extern int mission_parse_NEXT_MISSION(uint8_t *buf);
219 extern int mission_parse_END_MISSION(uint8_t *buf);
220 
221 #endif // MISSION_COMMON_H
222 
_mission_element::element
union _mission_element::@299 element
_mission_element::type
enum MissionType type
Definition: mission_common.h:115
ReplaceAll
@ ReplaceAll
remove all elements and add the new one
Definition: mission_common.h:49
mission_point_of_lla
bool mission_point_of_lla(struct EnuCoor_f *point, struct LlaCoor_i *lla)
Get the ENU component of LLA mission point This function is firmware specific.
Definition: mission_fw_nav.c:38
MISSION_PATH_NB
#define MISSION_PATH_NB
Definition: mission_common.h:81
MissionCircle
@ MissionCircle
Definition: mission_common.h:39
_mission::current_idx
uint8_t current_idx
current mission element index
Definition: mission_common.h:147
mission_parse_GOTO_WP_LLA
int mission_parse_GOTO_WP_LLA(uint8_t *buf)
Definition: mission_common.c:182
MISSION_TYPE_SIZE
#define MISSION_TYPE_SIZE
Definition: mission_common.h:93
_mission_element
Definition: mission_common.h:114
_mission_custom
Definition: mission_common.h:108
mission_register
bool mission_register(mission_custom_cb cb, char *type)
Register a new navigation or action callback function.
Definition: mission_common.c:99
pprz_geodetic_int.h
Paparazzi fixed point math for geodetic calculations.
mission_custom_cb
bool(* mission_custom_cb)(uint8_t nb, float *params, bool init)
custom mission element callback
Definition: mission_common.h:101
ReplaceCurrent
@ ReplaceCurrent
replace current element
Definition: mission_common.h:48
MissionCustom
@ MissionCustom
Definition: mission_common.h:42
_mission::elements
struct _mission_element elements[MISSION_ELEMENT_NB]
Definition: mission_common.h:143
ReplaceNexts
@ ReplaceNexts
replace the next element and remove all the others
Definition: mission_common.h:50
mission_parse_END_MISSION
int mission_parse_END_MISSION(uint8_t *buf)
Definition: mission_common.c:404
point
Definition: common_nav.h:39
mission_parse_NEXT_MISSION
int mission_parse_NEXT_MISSION(uint8_t *buf)
Definition: mission_common.c:393
MISSION_CUSTOM_MAX
#define MISSION_CUSTOM_MAX
Definition: mission_common.h:92
mission_init
void mission_init(void)
Init mission structure.
Definition: mission_common.c:37
_mission_segment::to
union _mission_segment::@297 to
Prepend
@ Prepend
add before the current element
Definition: mission_common.h:47
MissionWP
@ MissionWP
Definition: mission_common.h:38
std.h
pprz_geodetic_float.h
Paparazzi floating point math for geodetic calculations.
mission_parse_PATH_LLA
int mission_parse_PATH_LLA(uint8_t *buf)
Definition: mission_common.c:320
_mission::insert_idx
uint8_t insert_idx
inserstion index
Definition: mission_common.h:146
_mission_circle::radius
float radius
Definition: mission_common.h:66
mission_parse_CIRCLE_LLA
int mission_parse_CIRCLE_LLA(uint8_t *buf)
Definition: mission_common.c:221
mission_parse_SEGMENT_LLA
int mission_parse_SEGMENT_LLA(uint8_t *buf)
Definition: mission_common.c:263
Append
@ Append
add at the last position
Definition: mission_common.h:46
_mission_wp
Definition: mission_common.h:53
uint8_t
unsigned char uint8_t
Definition: types.h:14
mission_element_convert
bool mission_element_convert(struct _mission_element *el)
Convert mission element's points format if needed.
Definition: mission_common.c:126
mission_parse_CIRCLE
int mission_parse_CIRCLE(uint8_t *buf)
Definition: mission_common.c:203
EnuCoor_f
vector in East North Up coordinates Units: meters
Definition: pprz_geodetic_float.h:72
mission_get
struct _mission_element * mission_get(void)
Get current mission element.
Definition: mission_common.c:130
_mission::registered
struct _mission_registered registered[MISSION_REGISTER_NB]
Definition: mission_common.h:144
mission_parse_SEGMENT
int mission_parse_SEGMENT(uint8_t *buf)
Definition: mission_common.c:243
_mission_registered::cb
mission_custom_cb cb
navigation/action function callback
Definition: mission_common.h:104
mission_parse_CUSTOM
int mission_parse_CUSTOM(uint8_t *buf)
Definition: mission_common.c:359
MissionInsertMode
MissionInsertMode
Definition: mission_common.h:45
_mission_registered
Definition: mission_common.h:103
_mission_custom::reg
struct _mission_registered * reg
pointer to a registered custom mission element
Definition: mission_common.h:109
MISSION_ELEMENT_NB
#define MISSION_ELEMENT_NB
Max number of elements in the tasks' list can be redefined.
Definition: mission_common.h:132
mission_insert
bool mission_insert(enum MissionInsertMode insert, struct _mission_element *element)
Insert a mission element according to the insertion mode.
Definition: mission_common.c:55
init
bool init
Definition: nav_gls.c:57
_mission_registered::type
char type[MISSION_TYPE_SIZE]
mission element identifier (5 char max + 1 \0)
Definition: mission_common.h:105
_mission_custom::params
float params[MISSION_CUSTOM_MAX]
list of parameters
Definition: mission_common.h:110
mission_parse_PATH
int mission_parse_PATH(uint8_t *buf)
Definition: mission_common.c:288
_mission_circle::center
union _mission_circle::@295 center
MISSION_REGISTER_NB
#define MISSION_REGISTER_NB
Max number of registered nav/action callbacks can be redefined.
Definition: mission_common.h:139
mission_parse_GOTO_MISSION
int mission_parse_GOTO_MISSION(uint8_t *buf)
Definition: mission_common.c:381
_mission_segment
Definition: mission_common.h:69
LlaCoor_i
vector in Latitude, Longitude and Altitude
Definition: pprz_geodetic_int.h:59
_mission_path
Definition: mission_common.h:82
_mission_element::index
uint8_t index
index of mission element
Definition: mission_common.h:125
mission
struct _mission mission
Definition: mission_common.c:35
mission_parse_GOTO_WP
int mission_parse_GOTO_WP(uint8_t *buf)
Parsing functions called when a mission message is received.
Definition: mission_common.c:165
mission_status_report
void mission_status_report(void)
Report mission status.
Definition: mission_common.c:140
type
timer subsystem type(config options) --------------------------------------------(advanced timers using RCC_APB1) TIM1 adc(if USE_AD_TIM1) radio_control/ppm(if USE_PPM_TIM1
_mission_path::nb
uint8_t nb
Definition: mission_common.h:89
mission_run
int mission_run(void)
Run mission.
Definition: mission_fw_nav.c:148
MissionPath
@ MissionPath
Definition: mission_common.h:41
_mission_custom::nb
uint8_t nb
number of parameters
Definition: mission_common.h:111
_mission_element::duration
float duration
time to spend in the element (<= 0 to disable)
Definition: mission_common.h:124
_mission
Definition: mission_common.h:142
_mission_circle
Definition: mission_common.h:60
MissionSegment
@ MissionSegment
Definition: mission_common.h:40
_mission_path::path_idx
uint8_t path_idx
Definition: mission_common.h:88
_mission_path::path
union _mission_path::@298 path
EnuCoor_i
vector in East North Up coordinates
Definition: pprz_geodetic_int.h:77
_mission_segment::from
union _mission_segment::@296 from
_mission_wp::wp
union _mission_wp::@294 wp
_mission::element_time
float element_time
time in second spend in the current element
Definition: mission_common.h:145
MissionType
MissionType
Definition: mission_common.h:37