The airframe file is the most important configuration file and contains all the hardware and software settings for your airframe. It describes what hardware you have and which firmware, sensors, algorithms, etc. you want to use and also holds your configuration parameters. All gains, trims, and behavior settings are defined with standard XML elements.
The XML airframe configuration file is located in conf/airframes/<yourairframe>.xml and always begins with a <!DOCTYPE airframe SYSTEM "airframe.dtd"> line.
Creating a new Aircraft
While the airframe file is where you configure most aspects of your aircraft, a fully specified aircraft needs several XML configuration files:
- Airframe (what this page is about)
- Flight Plan
- Radio (if you use a PPM based R/C system)
Each aircraft is assigned a name, unique ID and the associated configuration files in conf/conf.xml. To create a new Aircraft, click new in the menu A/C in the Paparazzi Center and select your new airframe file, etc. (or specify it by hand in conf/conf.xml).
Firmware and Hardware definitions
<firmware name="fixedwing or rotorcraft"> ... </firmware>
Select your Board
To specify autopilot hardware you are using and it's low-level settings you have to add a target "ap" (autopilot) with board attribute.
Select the appropriate hardware autopilot board you are going to use in your airframe: "booz_1.0", "classix", "hb_1.1", "lisa_l_1.0", "lisa_l_1.1", "lisa_m_1.0", "lisa_m_2.0", "logom_2.6", "navgo_1.0", "pc", "sdlog_1.0", "tiny_0.99", "tiny_1.1", "tiny_2.1", "tiny_2.11", "twog_1.0", "yapa_2.0", "umarim_1.0", "umarim_lite_2.0"
<firmware name="fixedwing or rotorcraft"> <target name="sim" board="pc"/> <target name="ap" board="lisa_m_1.0"/> ... </firmware>
Note that the "pc" is a special kind of "board", and is mostly used only for simulation flights of an autopilot via your computer.
Optionally you can also add a raw Makefile section. This is only needed in very advanced setups. For example when testing newly developed hardware.
You can configure the LEDs on the autopilot to be used for different status indicators:
- blinks with 1Hz
- blinks until the AHRS is aligned (gyro bias initilalized) and then stays on
- blinking if trying to get a fix, on if 3D fix
- on if RC signal is ok
- only on booz and navgo boards: blinks until baro offset is initialized and then stays on
Depending on your board some of the LEDs on it are already assigned to some indicators by default, check the appropriate autopilot board page for the defaults. Use a configure node in the firmware section to assign an indicator to a LED number or disable that with none:
<firmware name="fixedwing or rotorcraft"> ... <configure name="SYS_TIME_LED" value="1"/> <configure name="RADIO_CONTROL_LED" value="2"/> <configure name="GPS_LED" value="none"/> </firmware>
Beware that you can only assign one indicator to a LED number. So if the LED you want to use is already in use because another indicator is set to that number by default you have to disable that other indicator by setting it to none.
Add the imu subsystem with the type you are using.
<firmware name="fixedwing or rotorcraft"> ... <subsystem name="imu" type="aspirin_v1.5"/> </firmware>
The AHRS subsystem specifies which attitude estimation filter you are using, e.g. for the complementary filter:
<firmware name="fixedwing or rotorcraft"> ... <subsystem name="ahrs" type="int_cmpl_euler"/> </firmware>
All AHRS algorithms depend on an imu subsystem, except for the ahrs_infrared which depends on the infrared module. See the AHRS subsystem page for more details.
Supported types are:
Just specify the appropriate radio control subsystem in your firmware section, e.g.:
<firmware name="fixedwing or rotorcraft"> ... <subsystem name="radio_control" type="ppm"/> </firmware>
The modem protocol and baud rate must be set in both the airframe file and ground station. Any standard baud rate can be used, with 9600 being adequate and 57600 recommended for most users to allow high speed telemetry for more detailed flight data analysis. The actual data rate is determined by the number of messages being sent and the period of each message as defined in your telemetry file, e.g. conf/telemetry/default.xml. Those wishing to experiment with "alternative" modems can reduce the number and period of each telemetry message to fit within most any bandwidth constraint.
Paparazzi supports the following modem protocols:
- Standard transparent serial (pprz) - this is compatible with all modems and can be used to connect the autopilot directly to a PC for testing without a modem.
- Maxstream API protocol (xbee) - compatible with all Maxstream modems including the 9XTend and Zigbee. This protocol enables hardware addressing, allowing multiple aircraft to be managed from a single ground modem.
Just specify the appropriate subsystem in your firmware section. You can currently choose between the types transparent, transparent_usb and xbee_api.
The default baudrate is 57600 baud!
<firmware name="fixedwing or rotorcraft"> ... <subsystem name="telemetry" type="transparent"/> </firmware>
See the telemetry subsystem page for more details.
The serial port settings must match that of the GPS and are configured here along with the necessary files to interpret the u-blox UBX binary protocol:
Just specify the appropriate gps subsystem in your firmware section. You can currently choose between the types ublox and ublox_utm for the older series 4 modules which still provide a UTM message.
<firmware name="fixedwing or rotorcraft"> ... <subsystem name="gps" type="ublox"/> </firmware>
The correct UART is already defined by default according to your board. The default GPS baudrate is 38400baud.
If you need to set different baud rates or UART see the Subsystem/gps page for the options.
- u-blox GPS modules are factory configured for 9600 baud, 38,400 baud is recommended along with the other required changes. The GPS can be accessed directly thrugh the UART Tunnel and Configured with u-center
When defining parameters you can use automatic unit conversion to conveniently set it in e.g. degrees.
This section gives characteristics for monitoring the main power battery.
MILLIAMP_AT_FULL_THROTTLE represents the actual current (in mA) when full THROTTLE is applied. Note that when flying the current typically is significantly lower than in static tests at home on your workbench. MILLIAMP_AT_FULL_THROTTLE is used to compute the energy value of the BAT message when no Current sensor is mounted in the airframe. This value can also be used in flight plans. For example, if at full throttle your motor consumes 10 Amps, use a value of 10000. You can "tweak" this number after a few flights to match the capacity of your battery. If upon landing your bat.energy messages says that you used 2500 mAh while the energy recharged into the battery is only 2000 mAh, you could reduce the MILLIAMP_AT_FULL_THROTTLE value by 20% to match your in-flight current consumption. This tweaking is most precise if you fly full throttle only (respectively no throttle to glide down again).
The CURRENT_ESTIMATION_NONLINEARITY can be added to tweak the energy estimation for non full throttle cruise. As the current consumption is nonlinear, at 50% throttle it is likely to be substantially less than 50%. A superellipse is used to approximate this nonlinearity. The default setting is 1.2 and is used if the CURRENT_ESTIMATION_NONLINEARITY is not defined in your airframe file. A value 1 corresponds to linear behaviour, 1.5 corresponds to strong nonlinearity. The tweaking is done same as decribed above for MILLIAMP_AT_FULL_THROTTLE, but only partial throttle (cruise throttle) should be applied in flight.
If both MILLIAMP_AT_FULL_THROTTLE and CURRENT_ESTIMATION_NONLINEARITY are tweaked well, you get precise energy estimations with less than 5% error independant of your flight pattern without even requiring a current sensor.
The CATASTROPHIC_BAT_LEVEL (was previously LOW_BATTERY) value defines the voltage at which the autopilot will lock the throttle at 0% in autonomous mode (kill_throttle mode). This value is also used by the ground server to issue a CATASTROPHIC alarm message on the bus (this message will be displayed in the console of the GCS). CRITIC and LOW values will also used as threshold for CRITIC and WARNING alarms. They are optional and the respective defaults are 10.0 and 10.5V.
The MAX_BAT_LEVEL may be specified to improve the display of the battery gauge in the strip or in "papgets". Note that this definition is optional, with a default value of 12.5V.
<section name="BAT"> <define name="MILLIAMP_AT_FULL_THROTTLE" value="12000" unit="mA" /> <define name="CATASTROPHIC_BAT_LEVEL" value="6.0" unit="V"/> <define name="CRITIC_BAT_LEVEL" value="6.5" unit="V"/> <define name="LOW_BAT_LEVEL" value="7.0" unit="V"/> <define name="MAX_BAT_LEVEL" value="8.4" unit="V"/> </section>
The conversion of ADC measurements to Voltage is already defined for the different autopilot boards, if you need to override these defaults you can use the VoltageOfAdc(adc) define.
<section name="BAT"> ... <define name="VOLTAGE_ADC_A" value="0.0177531"/> <define name="VOLTAGE_ADC_B" value="0.173626"/> <define name="VoltageOfAdc(adc)" value ="(VOLTAGE_ADC_A * adc + VOLTAGE_ADC_B)"/> </section>
The modules allow to add new code in a flexible way with initialisation, periodic and event functions without modifying the main AP loop.
<modules main_freq="60"> <load name="demo_module.xml"/> </modules>
- The main_freq parameter (in Hz) allows to specify the frequency of the main loop. Default is 60 Hz