Complete Parameter List¶
This is a complete list of the parameters which can be set (e.g. via the MAVLink protocol) to control vehicle behaviour. They are stored in persistent storage on the vehicle.
This list is automatically generated from the latest ardupilot source code, and so may contain parameters which are not yet in the stable released versions of the code.
AP_Periph Parameters¶
FORMAT_VERSION: Eeprom format version number¶
This value is incremented when changes are made to the eeprom format
CAN_NODE: DroneCAN node ID used by this node on all networks¶
Value of 0 requests any ID from a DNA server, any other value sets that ID ignoring DNA
Range |
---|
0 to 127 |
CAN_BAUDRATE: Bitrate of CAN interface¶
Bit rate can be set up to from 10000 to 1000000
Range |
---|
10000 to 1000000 |
CAN_SLCAN_CPORT: SLCAN Route¶
CAN Interface ID to be routed to SLCAN, 0 means no routing
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
CAN_TERMINATE: Enable CAN software temination in this node¶
Enable CAN software temination in this node
Values |
||||||
---|---|---|---|---|---|---|
|
CAN_PROTOCOL: Enable use of specific protocol to be used on this port¶
Enabling this option starts selected protocol that will use this virtual driver. At least one CAN port must be UAVCAN or else CAN1 gets set to UAVCAN
Values |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CAN2_BAUDRATE: Bitrate of CAN2 interface¶
Bit rate can be set up to from 10000 to 1000000
Range |
---|
10000 to 1000000 |
CAN2_PROTOCOL: Enable use of specific protocol to be used on this port¶
Enabling this option starts selected protocol that will use this virtual driver. At least one CAN port must be UAVCAN or else CAN1 gets set to UAVCAN
Values |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CAN2_TERMINATE: Enable CAN software temination in this node¶
Enable CAN software temination in this node
Values |
||||||
---|---|---|---|---|---|---|
|
CAN3_BAUDRATE: Bitrate of CAN3 interface¶
Bit rate can be set up to from 10000 to 1000000
Range |
---|
10000 to 1000000 |
CAN3_PROTOCOL: Enable use of specific protocol to be used on this port¶
Enabling this option starts selected protocol that will use this virtual driver. At least one CAN port must be UAVCAN or else CAN1 gets set to UAVCAN
Values |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CAN3_TERMINATE: Enable CAN software temination in this node¶
Enable CAN software temination in this node
Values |
||||||
---|---|---|---|---|---|---|
|
CAN_FDMODE: Enable CANFD mode¶
Enabling this option sets the CAN bus to be in CANFD mode with BRS.
Values |
||||||
---|---|---|---|---|---|---|
|
CAN_FDBAUDRATE: Set up bitrate for data section on CAN1¶
This sets the bitrate for the data section of CAN1.
Values |
||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CAN2_FDBAUDRATE: Set up bitrate for data section on CAN2¶
This sets the bitrate for the data section of CAN2.
Values |
||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
FLASH_BOOTLOADER: Trigger bootloader update¶
DANGER! When enabled, the App will perform a bootloader update by copying the embedded bootloader over the existing bootloader. This may take a few seconds to perform and should only be done if you know what you're doing.
Range |
---|
0 to 1 |
DEBUG: Debug¶
Debug
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
BRD_SERIAL_NUM: Serial number of device¶
Non-zero positive values will be shown on the CAN App Name string
Range |
---|
0 to 2147483648 |
BUZZER_VOLUME: Buzzer volume¶
Control the volume of the buzzer
Increment |
Range |
Units |
---|---|---|
1 |
0 to 100 |
percent |
GPS_PORT: GPS Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to GPS.
Increment |
Range |
---|---|
1 |
0 to 10 |
MB_CAN_PORT: Moving Baseline CAN Port option¶
Autoselect dedicated CAN port on which moving baseline data will be transmitted.
Values |
||||||
---|---|---|---|---|---|---|
|
BATT_HIDE_MASK: Battery hide mask¶
Instance mask of local battery index(es) to prevent transmitting their status over CAN. This is useful for hiding a "battery" instance that is used locally in the peripheral but don't want them to be treated as a battery source(s) to the autopilot. For example, an AP_Periph battery monitor with multiple batteries that monitors each locally for diagnostic or other purposes, but only reports as a single SUM battery monitor to the autopilot.
Bitmask |
||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BARO_ENABLE: Barometer Enable¶
Barometer Enable
Values |
||||||
---|---|---|---|---|---|---|
|
LED_BRIGHTNESS: LED Brightness¶
Select the RGB LED brightness level.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 100 |
percent |
RNGFND_BAUDRATE: Rangefinder serial baudrate¶
Rangefinder serial baudrate.
Increment |
Values |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 |
|
RNGFND_PORT: Rangefinder Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to Rangefinder.
Increment |
Range |
---|---|
1 |
0 to 10 |
RNGFND2_BAUDRATE: Rangefinder serial baudrate¶
Rangefinder serial baudrate.
Increment |
Values |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 |
|
RNGFND2_PORT: Rangefinder Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to Rangefinder.
Increment |
Range |
---|---|
1 |
0 to 10 |
RNGFND_MAX_RATE: Rangefinder max rate¶
This is the maximum rate we send rangefinder data in Hz. Zero means no limit
Increment |
Range |
Units |
---|---|---|
1 |
0 to 200 |
hertz |
ADSB_BAUDRATE: ADSB serial baudrate¶
ADSB serial baudrate.
Increment |
Values |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 |
|
ADSB_PORT: ADSB Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to ADSB.
Increment |
Range |
---|---|
1 |
0 to 10 |
HARDPOINT_ID: Hardpoint ID¶
Hardpoint ID
HARDPOINT_RATE: Hardpoint PWM rate¶
Hardpoint PWM rate
Increment |
Range |
Units |
---|---|---|
1 |
10 to 100 |
hertz |
ESC_NUMBER: ESC number¶
This is the ESC number to report as in UAVCAN ESC telemetry feedback packets.
Increment |
---|
1 |
ESC_RATE: ESC Update Rate¶
Rate in Hz that ESC PWM outputs (function is MotorN) will update at
Increment |
Range |
Units |
---|---|---|
1 |
50 to 400 |
hertz |
ESC_PWM_TYPE: Output PWM type¶
This selects the output PWM type, allowing for normal PWM continuous output, OneShot, brushed or DShot motor output
Values |
||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ESC_CMD_TIMO: ESC Command Timeout¶
This is the duration (ms) with which to hold the last driven ESC command before timing out and zeroing the ESC outputs. To disable zeroing of outputs in event of CAN loss, use 0. Use values greater than the expected duration between two CAN frames to ensure Periph is not starved of ESC Raw Commands.
Range |
Units |
---|---|
0 to 10000 |
milliseconds |
ESC_TELEM_PORT: ESC Telemetry Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to ESC Telemetry
Increment |
Range |
---|---|
1 |
0 to 10 |
ESC_TELEM_RATE: ESC Telemetry update rate¶
This is the rate at which ESC Telemetry will be sent across the CAN bus
Increment |
Range |
---|---|
1 |
0 to 1000 |
MSP_PORT: MSP Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to MSP
Increment |
Range |
---|---|
1 |
0 to 10 |
LOG_BITMASK: Log bitmask¶
4 byte bitmap of log types to enable
Bitmask |
||||
---|---|---|---|---|
|
SYSID_THISMAV: MAVLink system ID of this vehicle¶
Allows setting an individual system id for this vehicle to distinguish it from others on the same network
Range |
---|
1 to 255 |
EFI_BAUDRATE: EFI serial baudrate¶
EFI serial baudrate.
Increment |
Values |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 |
|
EFI_PORT: EFI Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to EFI.
Increment |
Range |
---|---|
1 |
0 to 10 |
PRX_BAUDRATE: Proximity Sensor serial baudrate¶
Proximity Sensor serial baudrate.
Increment |
Values |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 |
|
PRX_PORT: Proximity Sensor Serial Port¶
This is the serial port number where SERIALx_PROTOCOL will be set to Proximity Sensor.
Increment |
Range |
---|---|
1 |
0 to 10 |
PRX_MAX_RATE: Proximity Sensor max rate¶
This is the maximum rate we send Proximity Sensor data in Hz. Zero means no limit
Increment |
Range |
Units |
---|---|---|
1 |
0 to 200 |
hertz |
ESC_APD_SERIAL_1: ESC APD Serial 1¶
Which serial port to use for APD ESC data
Increment |
Range |
---|---|
1 |
0 to 6 |
ESC_APD_SERIAL_2: ESC APD Serial 2¶
Which serial port to use for APD ESC data
Increment |
Range |
---|---|
1 |
0 to 6 |
CAN_MIRROR_PORTS: CAN ports to mirror traffic between¶
Any set ports will participate in blindly mirroring traffic from one port to the other. It is the users responsibility to ensure that no loops exist that cause traffic to be infinitly repeated, and both ports must be running the same baud rates.
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
TEMP_MSG_RATE: Temperature sensor message rate¶
This is the rate Temperature sensor data is sent in Hz. Zero means no send. Each sensor with source DroneCAN is sent in turn.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 200 |
hertz |
OPTIONS: AP Periph Options¶
Bitmask of AP Periph Options
Bitmask |
||||
---|---|---|---|---|
|
RPM_MSG_RATE: RPM sensor message rate¶
This is the rate RPM sensor data is sent in Hz. Zero means no send. Each sensor with a set ID is sent in turn.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 200 |
hertz |
ESC_EXT_TLM_RATE: ESC Extended telemetry message rate¶
This is the rate at which extended ESC Telemetry will be sent across the CAN bus for each ESC
Increment |
Range |
Units |
---|---|---|
1 |
0 to 50 |
hertz |
IMU_SAMPLE_RATE: IMU Sample Rate¶
IMU Sample Rate
Range |
---|
0 to 1000 |
AHRS_ Parameters¶
AHRS_GPS_GAIN: AHRS GPS gain¶
This controls how much to use the GPS to correct the attitude. This should never be set to zero for a plane as it would result in the plane losing control in turns. For a plane please use the default value of 1.0.
Increment |
Range |
---|---|
.01 |
0.0 to 1.0 |
AHRS_YAW_P: Yaw P¶
This controls the weight the compass or GPS has on the heading. A higher value means the heading will track the yaw source (GPS or compass) more rapidly.
Increment |
Range |
---|---|
.01 |
0.1 to 0.4 |
AHRS_RP_P: AHRS RP_P¶
This controls how fast the accelerometers correct the attitude
Increment |
Range |
---|---|
.01 |
0.1 to 0.4 |
AHRS_WIND_MAX: Maximum wind¶
This sets the maximum allowable difference between ground speed and airspeed. A value of zero means to use the airspeed as is. This allows the plane to cope with a failing airspeed sensor by clipping it to groundspeed plus/minus this limit. See ARSPD_OPTIONS and ARSPD_WIND_MAX to disable airspeed sensors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 127 |
meters per second |
AHRS_TRIM_X: AHRS Trim Roll¶
Compensates for the roll angle difference between the control board and the frame. Positive values make the vehicle roll right.
Increment |
Range |
Units |
---|---|---|
0.01 |
-0.1745 to +0.1745 |
radians |
AHRS_TRIM_Y: AHRS Trim Pitch¶
Compensates for the pitch angle difference between the control board and the frame. Positive values make the vehicle pitch up/back.
Increment |
Range |
Units |
---|---|---|
0.01 |
-0.1745 to +0.1745 |
radians |
AHRS_TRIM_Z: AHRS Trim Yaw¶
Not Used
Increment |
Range |
Units |
---|---|---|
0.01 |
-0.1745 to +0.1745 |
radians |
AHRS_ORIENTATION: Board Orientation¶
Overall board orientation relative to the standard orientation for the board type. This rotates the IMU and compass readings to allow the board to be oriented in your vehicle at any 90 or 45 degree angle. The label for each option is specified in the order of rotations for that orientation. This option takes affect on next boot. After changing you will need to re-level your vehicle. Firmware versions 4.2 and prior can use a CUSTOM (100) rotation to set the AHRS_CUSTOM_ROLL/PIT/YAW angles for AHRS orientation. Later versions provide two general custom rotations which can be used, Custom 1 and Custom 2, with CUST_ROT1_ROLL/PIT/YAW or CUST_ROT2_ROLL/PIT/YAW angles.
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
AHRS_COMP_BETA: AHRS Velocity Complementary Filter Beta Coefficient¶
This controls the time constant for the cross-over frequency used to fuse AHRS (airspeed and heading) and GPS data to estimate ground velocity. Time constant is 0.1/beta. A larger time constant will use GPS data less and a small time constant will use air data less.
Increment |
Range |
---|---|
.01 |
0.001 to 0.5 |
AHRS_GPS_MINSATS: AHRS GPS Minimum satellites¶
Minimum number of satellites visible to use GPS for velocity based corrections attitude correction. This defaults to 6, which is about the point at which the velocity numbers from a GPS become too unreliable for accurate correction of the accelerometers.
Increment |
Range |
---|---|
1 |
0 to 10 |
AHRS_CUSTOM_ROLL: Board orientation roll offset¶
Autopilot mounting position roll offset. Positive values = roll right, negative values = roll left. This parameter is only used when AHRS_ORIENTATION is set to CUSTOM.
Increment |
Range |
Units |
---|---|---|
1 |
-180 to 180 |
degrees |
AHRS_CUSTOM_PIT: Board orientation pitch offset¶
Autopilot mounting position pitch offset. Positive values = pitch up, negative values = pitch down. This parameter is only used when AHRS_ORIENTATION is set to CUSTOM.
Increment |
Range |
Units |
---|---|---|
1 |
-180 to 180 |
degrees |
AHRS_CUSTOM_YAW: Board orientation yaw offset¶
Autopilot mounting position yaw offset. Positive values = yaw right, negative values = yaw left. This parameter is only used when AHRS_ORIENTATION is set to CUSTOM.
Increment |
Range |
Units |
---|---|---|
1 |
-180 to 180 |
degrees |
AHRS_OPTIONS: Optional AHRS behaviour¶
This controls optional AHRS behaviour. Setting DisableDCMFallbackFW will change the AHRS behaviour for fixed wing aircraft in fly-forward flight to not fall back to DCM when the EKF stops navigating. Setting DisableDCMFallbackVTOL will change the AHRS behaviour for fixed wing aircraft in non fly-forward (VTOL) flight to not fall back to DCM when the EKF stops navigating. Setting DontDisableAirspeedUsingEKF disables the EKF based innovation check for airspeed consistency
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD Parameters¶
ARSPD_ENABLE: Airspeed Enable¶
Enable airspeed sensor support
Values |
||||||
---|---|---|---|---|---|---|
|
ARSPD_TUBE_ORDER: Control pitot tube order¶
This parameter allows you to control whether the order in which the tubes are attached to your pitot tube matters. If you set this to 0 then the first (often the top) connector on the sensor needs to be the stagnation pressure (the pressure at the tip of the pitot tube). If set to 1 then the second (often the bottom) connector needs to be the stagnation pressure. If set to 2 (the default) then the airspeed driver will accept either order. The reason you may wish to specify the order is it will allow your airspeed sensor to detect if the aircraft is receiving excessive pressure on the static port compared to the stagnation port such as during a stall, which would otherwise be seen as a positive airspeed.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD_PRIMARY: Primary airspeed sensor¶
This selects which airspeed sensor will be the primary if multiple sensors are found
Values |
||||||
---|---|---|---|---|---|---|
|
ARSPD_OPTIONS: Airspeed options bitmask¶
Bitmask of options to use with airspeed. 0:Disable use based on airspeed/groundspeed mismatch (see ARSPD_WIND_MAX), 1:Automatically reenable use based on airspeed/groundspeed mismatch recovery (see ARSPD_WIND_MAX) 2:Disable voltage correction, 3:Check that the airspeed is statistically consistent with the navigation EKF vehicle and wind velocity estimates using EKF3 (requires AHRS_EKF_TYPE = 3), 4:Report cal offset to GCS
Bitmask |
||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ARSPD_WIND_MAX: Maximum airspeed and ground speed difference¶
If the difference between airspeed and ground speed is greater than this value the sensor will be marked unhealthy. Using ARSPD_OPTION this health value can be used to disable the sensor.
Units |
---|
meters per second |
ARSPD_WIND_WARN: Airspeed and GPS speed difference that gives a warning¶
If the difference between airspeed and GPS speed is greater than this value the sensor will issue a warning. If 0 ARSPD_WIND_MAX is used.
Units |
---|
meters per second |
ARSPD_WIND_GATE: Re-enable Consistency Check Gate Size¶
Number of standard deviations applied to the re-enable EKF consistency check that is used when ARSPD_OPTIONS bit position 3 is set. Larger values will make the re-enabling of the airspeed sensor faster, but increase the likelihood of re-enabling a degraded sensor. The value can be tuned by using the ARSP.TR log message by setting ARSPD_WIND_GATE to a value that is higher than the value for ARSP.TR observed with a healthy airspeed sensor. Occasional transients in ARSP.TR above the value set by ARSPD_WIND_GATE can be tolerated provided they are less than 5 seconds in duration and less than 10% duty cycle.
Range |
---|
0.0 to 10.0 |
ARSPD_OFF_PCNT: Maximum offset cal speed error¶
The maximum percentage speed change in airspeed reports that is allowed due to offset changes between calibrations before a warning is issued. This potential speed error is in percent of ASPD_FBW_MIN. 0 disables. Helps warn of calibrations without pitot being covered.
Range |
Units |
---|---|
0.0 to 10.0 |
percent |
ARSPD2_ Parameters¶
ARSPD2_TYPE: Airspeed type¶
Type of airspeed sensor
Values |
||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ARSPD2_USE: Airspeed use¶
Enables airspeed use for automatic throttle modes and replaces control from THR_TRIM. Continues to display and log airspeed if set to 0. Uses airspeed for control if set to 1. Only uses airspeed when throttle = 0 if set to 2 (useful for gliders with airspeed sensors behind propellers).
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD2_OFFSET: Airspeed offset¶
Airspeed calibration offset
Increment |
---|
0.1 |
ARSPD2_RATIO: Airspeed ratio¶
Calibrates pitot tube pressure to velocity. Increasing this value will indicate a higher airspeed at any given dynamic pressure.
Increment |
---|
0.1 |
ARSPD2_PIN: Airspeed pin¶
The pin number that the airspeed sensor is connected to for analog sensors. Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ARSPD2_AUTOCAL: Automatic airspeed ratio calibration¶
Enables automatic adjustment of airspeed ratio during a calibration flight based on estimation of ground speed and true airspeed. New ratio saved every 2 minutes if change is > 5%. Should not be left enabled.
ARSPD2_TUBE_ORDR: Control pitot tube order¶
This parameter allows you to control whether the order in which the tubes are attached to your pitot tube matters. If you set this to 0 then the first (often the top) connector on the sensor needs to be the stagnation pressure (the pressure at the tip of the pitot tube). If set to 1 then the second (often the bottom) connector needs to be the stagnation pressure. If set to 2 (the default) then the airspeed driver will accept either order. The reason you may wish to specify the order is it will allow your airspeed sensor to detect if the aircraft is receiving excessive pressure on the static port compared to the stagnation port such as during a stall, which would otherwise be seen as a positive airspeed.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD2_SKIP_CAL: Skip airspeed offset calibration on startup¶
This parameter allows you to skip airspeed offset calibration on startup, instead using the offset from the last calibration. This may be desirable if the offset variance between flights for your sensor is low and you want to avoid having to cover the pitot tube on each boot.
Values |
||||||
---|---|---|---|---|---|---|
|
ARSPD2_PSI_RANGE: The PSI range of the device¶
This parameter allows you to set the PSI (pounds per square inch) range for your sensor. You should not change this unless you examine the datasheet for your device
ARSPD2_BUS: Airspeed I2C bus¶
Bus number of the I2C bus where the airspeed sensor is connected. May not correspond to board's I2C bus number labels. Retry another bus and reboot if airspeed sensor fails to initialize.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD2_DEVID: Airspeed ID¶
Airspeed sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
ARSPD_ Parameters¶
ARSPD_TYPE: Airspeed type¶
Type of airspeed sensor
Values |
||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ARSPD_USE: Airspeed use¶
Enables airspeed use for automatic throttle modes and replaces control from THR_TRIM. Continues to display and log airspeed if set to 0. Uses airspeed for control if set to 1. Only uses airspeed when throttle = 0 if set to 2 (useful for gliders with airspeed sensors behind propellers).
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD_OFFSET: Airspeed offset¶
Airspeed calibration offset
Increment |
---|
0.1 |
ARSPD_RATIO: Airspeed ratio¶
Calibrates pitot tube pressure to velocity. Increasing this value will indicate a higher airspeed at any given dynamic pressure.
Increment |
---|
0.1 |
ARSPD_PIN: Airspeed pin¶
The pin number that the airspeed sensor is connected to for analog sensors. Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ARSPD_AUTOCAL: Automatic airspeed ratio calibration¶
Enables automatic adjustment of airspeed ratio during a calibration flight based on estimation of ground speed and true airspeed. New ratio saved every 2 minutes if change is > 5%. Should not be left enabled.
ARSPD_TUBE_ORDR: Control pitot tube order¶
This parameter allows you to control whether the order in which the tubes are attached to your pitot tube matters. If you set this to 0 then the first (often the top) connector on the sensor needs to be the stagnation pressure (the pressure at the tip of the pitot tube). If set to 1 then the second (often the bottom) connector needs to be the stagnation pressure. If set to 2 (the default) then the airspeed driver will accept either order. The reason you may wish to specify the order is it will allow your airspeed sensor to detect if the aircraft is receiving excessive pressure on the static port compared to the stagnation port such as during a stall, which would otherwise be seen as a positive airspeed.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD_SKIP_CAL: Skip airspeed offset calibration on startup¶
This parameter allows you to skip airspeed offset calibration on startup, instead using the offset from the last calibration. This may be desirable if the offset variance between flights for your sensor is low and you want to avoid having to cover the pitot tube on each boot.
Values |
||||||
---|---|---|---|---|---|---|
|
ARSPD_PSI_RANGE: The PSI range of the device¶
This parameter allows you to set the PSI (pounds per square inch) range for your sensor. You should not change this unless you examine the datasheet for your device
ARSPD_BUS: Airspeed I2C bus¶
Bus number of the I2C bus where the airspeed sensor is connected. May not correspond to board's I2C bus number labels. Retry another bus and reboot if airspeed sensor fails to initialize.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
ARSPD_DEVID: Airspeed ID¶
Airspeed sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
BAL Parameters¶
BAL_NUM_CELLS: Number of battery cells¶
Number of battery cells to monitor
Range |
---|
0 to 64 |
BAL_ID: Battery ID¶
Battery ID to match against other batteries
Range |
---|
0 to 127 |
BAL_RATE: Send Rate¶
Rate to send cell information
Range |
---|
0 to 20 |
BAL_CELL1_PIN: First analog pin¶
Analog pin of the first cell. Later cells must be sequential
Range |
---|
0 to 127 |
BARO Parameters¶
BARO1_GND_PRESS: Ground Pressure¶
calibrated ground pressure in Pascals
Increment |
ReadOnly |
Units |
Volatile |
---|---|---|---|
1 |
True |
pascal |
True |
BARO_GND_TEMP: ground temperature¶
User provided ambient ground temperature in degrees Celsius. This is used to improve the calculation of the altitude the vehicle is at. This parameter is not persistent and will be reset to 0 every time the vehicle is rebooted. A value of 0 means use the internal measurement ambient temperature.
Increment |
Units |
Volatile |
---|---|---|
1 |
degrees Celsius |
True |
BARO_ALT_OFFSET: altitude offset¶
altitude offset in meters added to barometric altitude. This is used to allow for automatic adjustment of the base barometric altitude by a ground station equipped with a barometer. The value is added to the barometric altitude read by the aircraft. It is automatically reset to 0 when the barometer is calibrated on each reboot or when a preflight calibration is performed.
Increment |
Units |
---|---|
0.1 |
meters |
BARO_PRIMARY: Primary barometer¶
This selects which barometer will be the primary if multiple barometers are found
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
BARO_EXT_BUS: External baro bus¶
This selects the bus number for looking for an I2C barometer. When set to -1 it will probe all external i2c buses based on the BARO_PROBE_EXT parameter.
Values |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
BARO2_GND_PRESS: Ground Pressure¶
calibrated ground pressure in Pascals
Increment |
ReadOnly |
Units |
Volatile |
---|---|---|---|
1 |
True |
pascal |
True |
BARO3_GND_PRESS: Absolute Pressure¶
calibrated ground pressure in Pascals
Increment |
ReadOnly |
Units |
Volatile |
---|---|---|---|
1 |
True |
pascal |
True |
BARO_FLTR_RNG: Range in which sample is accepted¶
This sets the range around the average value that new samples must be within to be accepted. This can help reduce the impact of noise on sensors that are on long I2C cables. The value is a percentage from the average value. A value of zero disables this filter.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 100 |
percent |
BARO_PROBE_EXT: External barometers to probe¶
This sets which types of external i2c barometer to look for. It is a bitmask of barometer types. The I2C buses to probe is based on BARO_EXT_BUS. If BARO_EXT_BUS is -1 then it will probe all external buses, otherwise it will probe just the bus number given in BARO_EXT_BUS.
Bitmask |
||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BARO1_DEVID: Baro ID¶
Barometer sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
BARO2_DEVID: Baro ID2¶
Barometer2 sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
BARO3_DEVID: Baro ID3¶
Barometer3 sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
BARO_FIELD_ELV: field elevation¶
User provided field elevation in meters. This is used to improve the calculation of the altitude the vehicle is at. This parameter is not persistent and will be reset to 0 every time the vehicle is rebooted. Changes to this parameter will only be used when disarmed. A value of 0 means the EKF origin height is used for takeoff height above sea level.
Increment |
Units |
Volatile |
---|---|---|
0.1 |
meters |
True |
BARO_ALTERR_MAX: Altitude error maximum¶
This is the maximum acceptable altitude discrepancy between GPS altitude and barometric presssure altitude calculated against a standard atmosphere for arming checks to pass. If you are getting an arming error due to this parameter then you may have a faulty or substituted barometer. A common issue is vendors replacing a MS5611 in a "Pixhawk" with a MS5607. If you have that issue then please see BARO_OPTIONS parameter to force the MS5611 to be treated as a MS5607. This check is disabled if the value is zero.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 5000 |
meters |
BARO_OPTIONS: Barometer options¶
Barometer options
Bitmask |
||||
---|---|---|---|---|
|
BARO1_WCF_ Parameters¶
BARO1_WCF_ENABLE: Wind coefficient enable¶
This enables the use of wind coefficients for barometer compensation
Values |
||||||
---|---|---|---|---|---|---|
|
BARO1_WCF_FWD: Pressure error coefficient in positive X direction (forward)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the X body axis. If the baro height estimate rises during forwards flight, then this will be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO1_WCF_BCK: Pressure error coefficient in negative X direction (backwards)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the X body axis. If the baro height estimate rises during backwards flight, then this will be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO1_WCF_RGT: Pressure error coefficient in positive Y direction (right)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the Y body axis. If the baro height estimate rises during sideways flight to the right, then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO1_WCF_LFT: Pressure error coefficient in negative Y direction (left)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the Y body axis. If the baro height estimate rises during sideways flight to the left, then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO1_WCF_UP: Pressure error coefficient in positive Z direction (up)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the Z body axis. If the baro height estimate rises above truth height during climbing flight (or forward flight with a high forwards lean angle), then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO1_WCF_DN: Pressure error coefficient in negative Z direction (down)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the Z body axis. If the baro height estimate rises above truth height during descending flight (or forward flight with a high backwards lean angle, eg braking manoeuvre), then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO2_WCF_ Parameters¶
BARO2_WCF_ENABLE: Wind coefficient enable¶
This enables the use of wind coefficients for barometer compensation
Values |
||||||
---|---|---|---|---|---|---|
|
BARO2_WCF_FWD: Pressure error coefficient in positive X direction (forward)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the X body axis. If the baro height estimate rises during forwards flight, then this will be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO2_WCF_BCK: Pressure error coefficient in negative X direction (backwards)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the X body axis. If the baro height estimate rises during backwards flight, then this will be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO2_WCF_RGT: Pressure error coefficient in positive Y direction (right)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the Y body axis. If the baro height estimate rises during sideways flight to the right, then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO2_WCF_LFT: Pressure error coefficient in negative Y direction (left)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the Y body axis. If the baro height estimate rises during sideways flight to the left, then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO2_WCF_UP: Pressure error coefficient in positive Z direction (up)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the Z body axis. If the baro height estimate rises above truth height during climbing flight (or forward flight with a high forwards lean angle), then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO2_WCF_DN: Pressure error coefficient in negative Z direction (down)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the Z body axis. If the baro height estimate rises above truth height during descending flight (or forward flight with a high backwards lean angle, eg braking manoeuvre), then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO3_WCF_ Parameters¶
BARO3_WCF_ENABLE: Wind coefficient enable¶
This enables the use of wind coefficients for barometer compensation
Values |
||||||
---|---|---|---|---|---|---|
|
BARO3_WCF_FWD: Pressure error coefficient in positive X direction (forward)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the X body axis. If the baro height estimate rises during forwards flight, then this will be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO3_WCF_BCK: Pressure error coefficient in negative X direction (backwards)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the X body axis. If the baro height estimate rises during backwards flight, then this will be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO3_WCF_RGT: Pressure error coefficient in positive Y direction (right)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the Y body axis. If the baro height estimate rises during sideways flight to the right, then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO3_WCF_LFT: Pressure error coefficient in negative Y direction (left)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the Y body axis. If the baro height estimate rises during sideways flight to the left, then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO3_WCF_UP: Pressure error coefficient in positive Z direction (up)¶
This is the ratio of static pressure error to dynamic pressure generated by a positive wind relative velocity along the Z body axis. If the baro height estimate rises above truth height during climbing flight (or forward flight with a high forwards lean angle), then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BARO3_WCF_DN: Pressure error coefficient in negative Z direction (down)¶
This is the ratio of static pressure error to dynamic pressure generated by a negative wind relative velocity along the Z body axis. If the baro height estimate rises above truth height during descending flight (or forward flight with a high backwards lean angle, eg braking manoeuvre), then this should be a negative number. Multirotors can use this feature only if using EKF3 and if the EK3_DRAG_BCOEF_X and EK3_DRAG_BCOEF_Y parameters have been tuned.
Increment |
Range |
---|---|
0.05 |
-1.0 to 1.0 |
BATT2_ Parameters¶
BATT2_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT2_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT2_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT2_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT2_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT2_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT2_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT2_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT2_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT2_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT2_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT2_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT2_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT2_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT2_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT2_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT2_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT2_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT2_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT2_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT2_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT2_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT2_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT2_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT2_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT2_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT2_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT2_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT2_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT2_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT2_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT2_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT2_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT2_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT2_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT2_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT2_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT2_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT2_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT2_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT2_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT2_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT2_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT2_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT2_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT3_ Parameters¶
BATT3_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT3_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT3_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT3_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT3_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT3_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT3_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT3_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT3_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT3_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT3_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT3_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT3_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT3_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT3_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT3_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT3_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT3_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT3_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT3_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT3_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT3_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT3_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT3_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT3_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT3_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT3_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT3_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT3_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT3_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT3_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT3_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT3_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT3_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT3_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT3_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT3_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT3_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT3_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT3_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT3_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT3_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT3_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT3_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT3_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT4_ Parameters¶
BATT4_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT4_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT4_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT4_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT4_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT4_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT4_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT4_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT4_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT4_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT4_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT4_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT4_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT4_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT4_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT4_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT4_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT4_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT4_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT4_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT4_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT4_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT4_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT4_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT4_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT4_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT4_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT4_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT4_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT4_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT4_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT4_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT4_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT4_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT4_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT4_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT4_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT4_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT4_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT4_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT4_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT4_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT4_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT4_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT4_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT5_ Parameters¶
BATT5_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT5_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT5_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT5_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT5_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT5_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT5_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT5_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT5_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT5_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT5_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT5_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT5_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT5_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT5_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT5_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT5_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT5_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT5_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT5_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT5_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT5_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT5_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT5_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT5_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT5_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT5_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT5_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT5_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT5_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT5_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT5_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT5_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT5_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT5_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT5_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT5_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT5_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT5_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT5_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT5_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT5_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT5_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT5_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT5_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT6_ Parameters¶
BATT6_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT6_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT6_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT6_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT6_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT6_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT6_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT6_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT6_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT6_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT6_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT6_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT6_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT6_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT6_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT6_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT6_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT6_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT6_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT6_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT6_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT6_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT6_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT6_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT6_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT6_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT6_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT6_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT6_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT6_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT6_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT6_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT6_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT6_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT6_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT6_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT6_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT6_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT6_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT6_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT6_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT6_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT6_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT6_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT6_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT7_ Parameters¶
BATT7_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT7_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT7_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT7_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT7_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT7_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT7_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT7_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT7_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT7_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT7_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT7_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT7_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT7_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT7_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT7_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT7_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT7_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT7_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT7_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT7_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT7_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT7_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT7_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT7_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT7_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT7_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT7_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT7_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT7_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT7_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT7_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT7_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT7_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT7_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT7_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT7_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT7_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT7_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT7_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT7_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT7_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT7_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT7_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT7_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT8_ Parameters¶
BATT8_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT8_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT8_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT8_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT8_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT8_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT8_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT8_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT8_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT8_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT8_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT8_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT8_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT8_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT8_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT8_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT8_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT8_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT8_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT8_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT8_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT8_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT8_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT8_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT8_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT8_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT8_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT8_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT8_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT8_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT8_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT8_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT8_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT8_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT8_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT8_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT8_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT8_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT8_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT8_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT8_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT8_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT8_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT8_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT8_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT9_ Parameters¶
BATT9_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT9_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT9_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT9_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT9_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT9_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT9_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT9_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT9_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT9_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT9_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT9_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT9_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT9_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT9_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT9_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT9_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT9_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT9_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT9_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT9_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT9_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT9_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT9_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT9_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT9_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT9_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT9_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT9_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT9_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT9_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT9_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT9_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT9_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT9_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT9_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT9_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT9_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT9_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT9_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT9_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT9_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT9_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT9_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT9_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTA_ Parameters¶
BATTA_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTA_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTA_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATTA_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATTA_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATTA_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTA_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTA_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTA_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTA_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTA_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTA_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTA_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTA_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTA_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTA_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATTA_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATTA_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTA_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTA_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATTA_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTA_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTA_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATTA_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATTA_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATTA_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATTA_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATTA_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTA_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATTA_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTA_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATTA_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATTA_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATTA_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATTA_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTA_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATTA_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATTA_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATTA_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATTA_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATTA_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTA_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATTA_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATTA_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATTA_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTB_ Parameters¶
BATTB_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTB_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTB_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATTB_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATTB_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATTB_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTB_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTB_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTB_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTB_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTB_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTB_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTB_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTB_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTB_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTB_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATTB_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATTB_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTB_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTB_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATTB_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTB_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTB_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATTB_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATTB_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATTB_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATTB_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATTB_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTB_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATTB_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTB_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATTB_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATTB_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATTB_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATTB_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTB_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATTB_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATTB_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATTB_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATTB_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATTB_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTB_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATTB_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATTB_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATTB_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTC_ Parameters¶
BATTC_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTC_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTC_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATTC_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATTC_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATTC_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTC_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTC_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTC_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTC_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTC_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTC_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTC_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTC_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTC_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTC_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATTC_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATTC_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTC_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTC_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATTC_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTC_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTC_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATTC_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATTC_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATTC_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATTC_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATTC_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTC_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATTC_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTC_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATTC_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATTC_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATTC_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATTC_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTC_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATTC_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATTC_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATTC_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATTC_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATTC_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTC_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATTC_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATTC_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATTC_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTD_ Parameters¶
BATTD_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTD_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTD_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATTD_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATTD_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATTD_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTD_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTD_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTD_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTD_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTD_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTD_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTD_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTD_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTD_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTD_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATTD_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATTD_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTD_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTD_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATTD_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTD_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTD_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATTD_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATTD_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATTD_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATTD_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATTD_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTD_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATTD_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTD_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATTD_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATTD_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATTD_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATTD_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTD_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATTD_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATTD_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATTD_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATTD_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATTD_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTD_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATTD_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATTD_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATTD_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTE_ Parameters¶
BATTE_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTE_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTE_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATTE_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATTE_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATTE_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTE_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTE_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTE_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTE_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTE_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTE_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTE_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTE_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTE_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTE_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATTE_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATTE_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTE_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTE_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATTE_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTE_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTE_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATTE_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATTE_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATTE_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATTE_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATTE_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTE_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATTE_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTE_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATTE_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATTE_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATTE_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATTE_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTE_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATTE_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATTE_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATTE_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATTE_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATTE_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTE_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATTE_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATTE_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATTE_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTF_ Parameters¶
BATTF_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTF_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTF_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATTF_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATTF_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATTF_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTF_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTF_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTF_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTF_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTF_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTF_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTF_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTF_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTF_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTF_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATTF_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATTF_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTF_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTF_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATTF_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTF_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTF_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATTF_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATTF_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATTF_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATTF_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATTF_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTF_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATTF_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTF_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATTF_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATTF_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATTF_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATTF_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTF_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATTF_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATTF_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATTF_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATTF_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATTF_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTF_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATTF_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATTF_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATTF_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTG_ Parameters¶
BATTG_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTG_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTG_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATTG_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATTG_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATTG_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTG_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTG_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTG_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTG_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTG_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATTG_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATTG_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATTG_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATTG_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTG_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATTG_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATTG_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATTG_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTG_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATTG_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTG_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTG_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATTG_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATTG_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATTG_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATTG_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATTG_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTG_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATTG_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTG_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATTG_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATTG_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATTG_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATTG_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATTG_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATTG_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATTG_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATTG_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATTG_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATTG_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATTG_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATTG_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATTG_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATTG_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT_ Parameters¶
BATT_MONITOR: Battery monitoring¶
Controls enabling monitoring of the battery's voltage and current
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT_CAPACITY: Battery capacity¶
Capacity of the battery in mAh when full
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT_SERIAL_NUM: Battery serial number¶
Battery serial number, automatically filled in for SMBus batteries, otherwise will be -1. With DroneCan it is the battery_id.
BATT_LOW_TIMER: Low voltage timeout¶
This is the timeout in seconds before a low voltage event will be triggered. For aircraft with low C batteries it may be necessary to raise this in order to cope with low voltage on long takeoffs. A value of zero disables low voltage errors.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 120 |
seconds |
BATT_FS_VOLTSRC: Failsafe voltage source¶
Voltage type used for detection of low voltage event
Values |
||||||
---|---|---|---|---|---|---|
|
BATT_LOW_VOLT: Low battery voltage¶
Battery voltage that triggers a low battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT_LOW_MAH: Low battery capacity¶
Battery capacity at which the low battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT_FS_LOW_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT_CRT_VOLT: Critical battery voltage¶
Battery voltage that triggers a critical battery failsafe. Set to 0 to disable. If the battery voltage drops below this voltage continuously for more then the period specified by the BATT_LOW_TIMER parameter then the vehicle will perform the failsafe specified by the BATT_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
0.1 |
volt |
BATT_CRT_MAH: Battery critical capacity¶
Battery capacity at which the critical battery failsafe is triggered. Set to 0 to disable battery remaining failsafe. If the battery capacity drops below this level the vehicle will perform the failsafe specified by the BATT_FS_CRT_ACT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT_ARM_VOLT: Required arming voltage¶
Battery voltage level which is required to arm the aircraft. Set to 0 to allow arming at any voltage.
Increment |
Units |
---|---|
0.1 |
volt |
BATT_ARM_MAH: Required arming remaining capacity¶
Battery capacity remaining which is required to arm the aircraft. Set to 0 to allow arming at any capacity. Note that execept for smart batteries rebooting the vehicle will always reset the remaining capacity estimate, which can lead to this check not providing sufficent protection, it is recommended to always use this in conjunction with the BATT_ARM_VOLT parameter.
Increment |
Units |
---|---|
50 |
milliampere hour |
BATT_OPTIONS: Battery monitor options¶
This sets options to change the behaviour of the battery monitor
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT_ESC_INDEX: ESC Telemetry Index to write to¶
ESC Telemetry Index to write voltage, current, consumption and temperature data to. Use 0 to disable.
Increment |
Range |
---|---|
1 |
0 to 10 |
BATT_VOLT_PIN: Battery Voltage sensing pin¶
Sets the analog input pin that should be used for voltage monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT_CURR_PIN: Battery Current sensing pin¶
Sets the analog input pin that should be used for current monitoring.
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT_VOLT_MULT: Voltage Multiplier¶
Used to convert the voltage of the voltage sensing pin (BATT_VOLT_PIN) to the actual battery's voltage (pin_voltage * VOLT_MULT). For the 3DR Power brick with a Pixhawk, this should be set to 10.1. For the Pixhawk with the 3DR 4in1 ESC this should be 12.02. For the PX using the PX4IO power supply this should be set to 1.
BATT_AMP_PERVLT: Amps per volt¶
Number of amps that a 1V reading on the current sensor corresponds to. With a Pixhawk using the 3DR Power brick this should be set to 17. For the Pixhawk with the 3DR 4in1 ESC this should be 17. For Synthetic Current sensor monitors, this is the maximum, full throttle current draw.
Units |
---|
ampere per volt |
BATT_AMP_OFFSET: AMP offset¶
Voltage offset at zero current on current sensor for Analog Sensors. For Synthetic Current sensor, this offset is the zero throttle system current and is added to the calculated throttle base current.
Units |
---|
volt |
BATT_VLT_OFFSET: Voltage offset¶
Voltage offset on voltage pin. This allows for an offset due to a diode. This voltage is subtracted before the scaling is applied.
Units |
---|
volt |
BATT_I2C_BUS (AP_BattMonitor_SMBus): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT_I2C_ADDR (AP_BattMonitor_SMBus): Battery monitor I2C address¶
Battery monitor I2C address
Range |
---|
0 to 127 |
BATT_SUM_MASK: Battery Sum mask¶
0: sum of remaining battery monitors, If none 0 sum of specified monitors. Current will be summed and voltages averaged.
Bitmask |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT_CURR_MULT: Scales reported power monitor current¶
Multiplier applied to all current related reports to allow for adjustment if no UAVCAN param access or current splitting applications
Range |
---|
.1 to 10 |
BATT_FL_VLT_MIN: Empty fuel level voltage¶
The voltage seen on the analog pin when the fuel tank is empty. Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
Units |
---|---|
0.01 to 10 |
volt |
BATT_FL_V_MULT: Fuel level voltage multiplier¶
Voltage multiplier to determine what the full tank voltage reading is. This is calculated as 1 / (Voltage_Full - Voltage_Empty) Note: For this type of battery monitor, the voltage seen by the analog pin is displayed as battery voltage on a GCS.
Range |
---|
0.01 to 10 |
BATT_FL_FLTR: Fuel level filter frequency¶
Filter frequency in Hertz where a low pass filter is used. This is used to filter out tank slosh from the fuel level reading. A value of -1 disables the filter and unfiltered voltage is used to determine the fuel level. The suggested values at in the range of 0.2 Hz to 0.5 Hz.
Range |
Units |
---|---|
-1 to 1 |
hertz |
BATT_FL_PIN: Fuel level analog pin number¶
Analog input pin that fuel level sensor is connected to.Analog Airspeed or RSSI ports can be used for Analog input( some autopilots provide others also). Values for some autopilots are given as examples. Search wiki for "Analog pins".
Values |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
BATT_FL_FF: First order term¶
First order polynomial fit term
Range |
---|
0 to 10 |
BATT_FL_FS: Second order term¶
Second order polynomial fit term
Range |
---|
0 to 10 |
BATT_FL_FT: Third order term¶
Third order polynomial fit term
Range |
---|
0 to 10 |
BATT_FL_OFF: Offset term¶
Offset polynomial fit term
Range |
---|
0 to 10 |
BATT_MAX_VOLT: Maximum Battery Voltage¶
Maximum voltage of battery. Provides scaling of current versus voltage
Range |
---|
7 to 100 |
BATT_I2C_BUS (AP_BattMonitor_INA2xx): Battery monitor I2C bus number¶
Battery monitor I2C bus number
Range |
---|
0 to 3 |
BATT_I2C_ADDR (AP_BattMonitor_INA2xx): Battery monitor I2C address¶
Battery monitor I2C address. If this is zero then probe list of supported addresses
Range |
---|
0 to 127 |
BATT_MAX_AMPS: Battery monitor max current¶
This controls the maximum current the INS2XX sensor will work with.
Range |
Units |
---|---|
1 to 400 |
ampere |
BATT_SHUNT: Battery monitor shunt resistor¶
This sets the shunt resistor used in the device
Range |
Units |
---|---|
0.0001 to 0.01 |
Ohm |
BATT_ESC_MASK: ESC mask¶
If 0 all connected ESCs will be used. If non-zero, only those selected in will be used.
Bitmask |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
COMPASS_ Parameters¶
COMPASS_OFS_X: Compass offsets in milligauss on the X axis¶
Offset to be added to the compass x-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_OFS_Y: Compass offsets in milligauss on the Y axis¶
Offset to be added to the compass y-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_OFS_Z: Compass offsets in milligauss on the Z axis¶
Offset to be added to the compass z-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_DEC: Compass declination¶
An angle to compensate between the true north and magnetic north
Increment |
Range |
Units |
---|---|---|
0.01 |
-3.142 to 3.142 |
radians |
COMPASS_LEARN: Learn compass offsets automatically¶
Enable or disable the automatic learning of compass offsets. You can enable learning either using a compass-only method that is suitable only for fixed wing aircraft or using the offsets learnt by the active EKF state estimator. If this option is enabled then the learnt offsets are saved when you disarm the vehicle. If InFlight learning is enabled then the compass with automatically start learning once a flight starts (must be armed). While InFlight learning is running you cannot use position control modes.
Values |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
COMPASS_USE: Use compass for yaw¶
Enable or disable the use of the compass (instead of the GPS) for determining heading
Values |
||||||
---|---|---|---|---|---|---|
|
COMPASS_AUTODEC: Auto Declination¶
Enable or disable the automatic calculation of the declination based on gps location
Values |
||||||
---|---|---|---|---|---|---|
|
COMPASS_MOTCT: Motor interference compensation type¶
Set motor interference compensation type to disabled, throttle or current. Do not change manually.
Calibration |
Values |
||||||||
---|---|---|---|---|---|---|---|---|---|
1 |
|
COMPASS_MOT_X: Motor interference compensation for body frame X axis¶
Multiplied by the current throttle and added to the compass's x-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_MOT_Y: Motor interference compensation for body frame Y axis¶
Multiplied by the current throttle and added to the compass's y-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_MOT_Z: Motor interference compensation for body frame Z axis¶
Multiplied by the current throttle and added to the compass's z-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_ORIENT: Compass orientation¶
The orientation of the first external compass relative to the vehicle frame. This value will be ignored unless this compass is set as an external compass. When set correctly in the northern hemisphere, pointing the nose and right side down should increase the MagX and MagY values respectively. Rolling the vehicle upside down should decrease the MagZ value. For southern hemisphere, switch increase and decrease. NOTE: For internal compasses, AHRS_ORIENT is used. The label for each option is specified in the order of rotations for that orientation. Firmware versions 4.2 and prior can use a CUSTOM (100) rotation to set the COMPASS_CUS_ROLL/PIT/YAW angles for Compass orientation. Later versions provide two general custom rotations which can be used, Custom 1 and Custom 2, with CUST_1_ROLL/PIT/YAW or CUST_2_ROLL/PIT/YAW angles.
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
COMPASS_EXTERNAL: Compass is attached via an external cable¶
Configure compass so it is attached externally. This is auto-detected on most boards. Set to 1 if the compass is externally connected. When externally connected the COMPASS_ORIENT option operates independently of the AHRS_ORIENTATION board orientation option. If set to 0 or 1 then auto-detection by bus connection can override the value. If set to 2 then auto-detection will be disabled.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
COMPASS_OFS2_X: Compass2 offsets in milligauss on the X axis¶
Offset to be added to compass2's x-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_OFS2_Y: Compass2 offsets in milligauss on the Y axis¶
Offset to be added to compass2's y-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_OFS2_Z: Compass2 offsets in milligauss on the Z axis¶
Offset to be added to compass2's z-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_MOT2_X: Motor interference compensation to compass2 for body frame X axis¶
Multiplied by the current throttle and added to compass2's x-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_MOT2_Y: Motor interference compensation to compass2 for body frame Y axis¶
Multiplied by the current throttle and added to compass2's y-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_MOT2_Z: Motor interference compensation to compass2 for body frame Z axis¶
Multiplied by the current throttle and added to compass2's z-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_OFS3_X: Compass3 offsets in milligauss on the X axis¶
Offset to be added to compass3's x-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_OFS3_Y: Compass3 offsets in milligauss on the Y axis¶
Offset to be added to compass3's y-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_OFS3_Z: Compass3 offsets in milligauss on the Z axis¶
Offset to be added to compass3's z-axis values to compensate for metal in the frame
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-400 to 400 |
milligauss |
COMPASS_MOT3_X: Motor interference compensation to compass3 for body frame X axis¶
Multiplied by the current throttle and added to compass3's x-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_MOT3_Y: Motor interference compensation to compass3 for body frame Y axis¶
Multiplied by the current throttle and added to compass3's y-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_MOT3_Z: Motor interference compensation to compass3 for body frame Z axis¶
Multiplied by the current throttle and added to compass3's z-axis values to compensate for motor interference (Offset per Amp or at Full Throttle)
Calibration |
Increment |
Range |
Units |
---|---|---|---|
1 |
1 |
-1000 to 1000 |
milligauss per ampere |
COMPASS_DEV_ID: Compass device id¶
Compass device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_DEV_ID2: Compass2 device id¶
Second compass's device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_DEV_ID3: Compass3 device id¶
Third compass's device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_USE2: Compass2 used for yaw¶
Enable or disable the secondary compass for determining heading.
Values |
||||||
---|---|---|---|---|---|---|
|
COMPASS_ORIENT2: Compass2 orientation¶
The orientation of a second external compass relative to the vehicle frame. This value will be ignored unless this compass is set as an external compass. When set correctly in the northern hemisphere, pointing the nose and right side down should increase the MagX and MagY values respectively. Rolling the vehicle upside down should decrease the MagZ value. For southern hemisphere, switch increase and decrease. NOTE: For internal compasses, AHRS_ORIENT is used. The label for each option is specified in the order of rotations for that orientation. Firmware versions 4.2 and prior can use a CUSTOM (100) rotation to set the COMPASS_CUS_ROLL/PIT/YAW angles for Compass orientation. Later versions provide two general custom rotations which can be used, Custom 1 and Custom 2, with CUST_1_ROLL/PIT/YAW or CUST_2_ROLL/PIT/YAW angles.
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
COMPASS_EXTERN2: Compass2 is attached via an external cable¶
Configure second compass so it is attached externally. This is auto-detected on most boards. If set to 0 or 1 then auto-detection by bus connection can override the value. If set to 2 then auto-detection will be disabled.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
COMPASS_USE3: Compass3 used for yaw¶
Enable or disable the tertiary compass for determining heading.
Values |
||||||
---|---|---|---|---|---|---|
|
COMPASS_ORIENT3: Compass3 orientation¶
The orientation of a third external compass relative to the vehicle frame. This value will be ignored unless this compass is set as an external compass. When set correctly in the northern hemisphere, pointing the nose and right side down should increase the MagX and MagY values respectively. Rolling the vehicle upside down should decrease the MagZ value. For southern hemisphere, switch increase and decrease. NOTE: For internal compasses, AHRS_ORIENT is used. The label for each option is specified in the order of rotations for that orientation. Firmware versions 4.2 and prior can use a CUSTOM (100) rotation to set the COMPASS_CUS_ROLL/PIT/YAW angles for Compass orientation. Later versions provide two general custom rotations which can be used, Custom 1 and Custom 2, with CUST_1_ROLL/PIT/YAW or CUST_2_ROLL/PIT/YAW angles.
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
COMPASS_EXTERN3: Compass3 is attached via an external cable¶
Configure third compass so it is attached externally. This is auto-detected on most boards. If set to 0 or 1 then auto-detection by bus connection can override the value. If set to 2 then auto-detection will be disabled.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
COMPASS_DIA_X: Compass soft-iron diagonal X component¶
DIA_X in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA_Y: Compass soft-iron diagonal Y component¶
DIA_Y in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA_Z: Compass soft-iron diagonal Z component¶
DIA_Z in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI_X: Compass soft-iron off-diagonal X component¶
ODI_X in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI_Y: Compass soft-iron off-diagonal Y component¶
ODI_Y in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI_Z: Compass soft-iron off-diagonal Z component¶
ODI_Z in the compass soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA2_X: Compass2 soft-iron diagonal X component¶
DIA_X in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA2_Y: Compass2 soft-iron diagonal Y component¶
DIA_Y in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA2_Z: Compass2 soft-iron diagonal Z component¶
DIA_Z in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI2_X: Compass2 soft-iron off-diagonal X component¶
ODI_X in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI2_Y: Compass2 soft-iron off-diagonal Y component¶
ODI_Y in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI2_Z: Compass2 soft-iron off-diagonal Z component¶
ODI_Z in the compass2 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA3_X: Compass3 soft-iron diagonal X component¶
DIA_X in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA3_Y: Compass3 soft-iron diagonal Y component¶
DIA_Y in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_DIA3_Z: Compass3 soft-iron diagonal Z component¶
DIA_Z in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI3_X: Compass3 soft-iron off-diagonal X component¶
ODI_X in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI3_Y: Compass3 soft-iron off-diagonal Y component¶
ODI_Y in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_ODI3_Z: Compass3 soft-iron off-diagonal Z component¶
ODI_Z in the compass3 soft-iron calibration matrix: [[DIA_X, ODI_X, ODI_Y], [ODI_X, DIA_Y, ODI_Z], [ODI_Y, ODI_Z, DIA_Z]]
Calibration |
---|
1 |
COMPASS_CAL_FIT: Compass calibration fitness¶
This controls the fitness level required for a successful compass calibration. A lower value makes for a stricter fit (less likely to pass). This is the value used for the primary magnetometer. Other magnetometers get double the value.
Increment |
Range |
Values |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
0.1 |
4 to 32 |
|
COMPASS_OFFS_MAX: Compass maximum offset¶
This sets the maximum allowed compass offset in calibration and arming checks
Increment |
Range |
---|---|
1 |
500 to 3000 |
COMPASS_DISBLMSK: Compass disable driver type mask¶
This is a bitmask of driver types to disable. If a driver type is set in this mask then that driver will not try to find a sensor at startup
Bitmask |
||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
COMPASS_FLTR_RNG: Range in which sample is accepted¶
This sets the range around the average value that new samples must be within to be accepted. This can help reduce the impact of noise on sensors that are on long I2C cables. The value is a percentage from the average value. A value of zero disables this filter.
Increment |
Range |
Units |
---|---|---|
1 |
0 to 100 |
percent |
COMPASS_AUTO_ROT: Automatically check orientation¶
When enabled this will automatically check the orientation of compasses on successful completion of compass calibration. If set to 2 then external compasses will have their orientation automatically corrected.
Values |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
COMPASS_PRIO1_ID: Compass device id with 1st order priority¶
Compass device id with 1st order priority, set automatically if 0. Reboot required after change.
COMPASS_PRIO2_ID: Compass device id with 2nd order priority¶
Compass device id with 2nd order priority, set automatically if 0. Reboot required after change.
COMPASS_PRIO3_ID: Compass device id with 3rd order priority¶
Compass device id with 3rd order priority, set automatically if 0. Reboot required after change.
COMPASS_ENABLE: Enable Compass¶
Setting this to Enabled(1) will enable the compass. Setting this to Disabled(0) will disable the compass. Note that this is separate from COMPASS_USE. This will enable the low level senor, and will enable logging of magnetometer data. To use the compass for navigation you must also set COMPASS_USE to 1.
Values |
||||||
---|---|---|---|---|---|---|
|
COMPASS_SCALE: Compass1 scale factor¶
Scaling factor for first compass to compensate for sensor scaling errors. If this is 0 then no scaling is done
Range |
---|
0 to 1.3 |
COMPASS_SCALE2: Compass2 scale factor¶
Scaling factor for 2nd compass to compensate for sensor scaling errors. If this is 0 then no scaling is done
Range |
---|
0 to 1.3 |
COMPASS_SCALE3: Compass3 scale factor¶
Scaling factor for 3rd compass to compensate for sensor scaling errors. If this is 0 then no scaling is done
Range |
---|
0 to 1.3 |
COMPASS_OPTIONS: Compass options¶
This sets options to change the behaviour of the compass
Bitmask |
||||||
---|---|---|---|---|---|---|
|
COMPASS_DEV_ID4: Compass4 device id¶
Extra 4th compass's device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_DEV_ID5: Compass5 device id¶
Extra 5th compass's device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_DEV_ID6: Compass6 device id¶
Extra 6th compass's device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_DEV_ID7: Compass7 device id¶
Extra 7th compass's device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_DEV_ID8: Compass8 device id¶
Extra 8th compass's device id. Automatically detected, do not set manually
ReadOnly |
---|
True |
COMPASS_CUS_ROLL: Custom orientation roll offset¶
Compass mounting position roll offset. Positive values = roll right, negative values = roll left. This parameter is only used when COMPASS_ORIENT/2/3 is set to CUSTOM.
Increment |
Range |
Units |
---|---|---|
1 |
-180 to 180 |
degrees |
COMPASS_CUS_PIT: Custom orientation pitch offset¶
Compass mounting position pitch offset. Positive values = pitch up, negative values = pitch down. This parameter is only used when COMPASS_ORIENT/2/3 is set to CUSTOM.
Increment |
Range |
Units |
---|---|---|
1 |
-180 to 180 |
degrees |
COMPASS_CUS_YAW: Custom orientation yaw offset¶
Compass mounting position yaw offset. Positive values = yaw right, negative values = yaw left. This parameter is only used when COMPASS_ORIENT/2/3 is set to CUSTOM.
Increment |
Range |
Units |
---|---|---|
1 |
-180 to 180 |
degrees |
COMPASS_PMOT Parameters¶
COMPASS_PMOT_EN: per-motor compass correction enable¶
This enables per-motor compass corrections
Values |
||||||
---|---|---|---|---|---|---|
|
COMPASS_PMOT_EXP: per-motor exponential correction¶
This is the exponential correction for the power output of the motor for per-motor compass correction
Increment |
Range |
---|---|
0.01 |
0 to 2 |
COMPASS_PMOT1_X: Compass per-motor1 X¶
Compensation for X axis of motor1
COMPASS_PMOT1_Y: Compass per-motor1 Y¶
Compensation for Y axis of motor1
COMPASS_PMOT1_Z: Compass per-motor1 Z¶
Compensation for Z axis of motor1
COMPASS_PMOT2_X: Compass per-motor2 X¶
Compensation for X axis of motor2
COMPASS_PMOT2_Y: Compass per-motor2 Y¶
Compensation for Y axis of motor2
COMPASS_PMOT2_Z: Compass per-motor2 Z¶
Compensation for Z axis of motor2
COMPASS_PMOT3_X: Compass per-motor3 X¶
Compensation for X axis of motor3
COMPASS_PMOT3_Y: Compass per-motor3 Y¶
Compensation for Y axis of motor3
COMPASS_PMOT3_Z: Compass per-motor3 Z¶
Compensation for Z axis of motor3
COMPASS_PMOT4_X: Compass per-motor4 X¶
Compensation for X axis of motor4
COMPASS_PMOT4_Y: Compass per-motor4 Y¶
Compensation for Y axis of motor4
COMPASS_PMOT4_Z: Compass per-motor4 Z¶
Compensation for Z axis of motor4
EFI Parameters¶
EFI_TYPE: EFI communication type¶
What method of communication is used for EFI #1
Values |
||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
EFI_COEF1: EFI Calibration Coefficient 1¶
Used to calibrate fuel flow for MS protocol (Slope). This should be calculated from a log at constant fuel usage rate. Plot (ECYL[0].InjT*EFI.Rpm)/600.0 to get the duty_cycle. Measure actual fuel usage in cm^3/min, and set EFI_COEF1 = fuel_usage_cm3permin / duty_cycle
Range |
---|
0 to 1 |
EFI_COEF2: EFI Calibration Coefficient 2¶
Used to calibrate fuel flow for MS protocol (Offset). This can be used to correct for a non-zero offset in the fuel consumption calculation of EFI_COEF1
Range |
---|
0 to 10 |
EFI_FUEL_DENS: ECU Fuel Density¶
Used to calculate fuel consumption
Range |
Units |
---|---|
0 to 10000 |
kilograms per cubic meter |
EFI_THRLIN Parameters¶
EFI_THRLIN_EN: Enable throttle linearisation¶
Enable EFI throttle linearisation
Values |
||||||
---|---|---|---|---|---|---|
|
EFI_THRLIN_COEF1: Throttle linearisation - First Order¶
First Order Polynomial Coefficient. (=1, if throttle is first order polynomial trendline)
Range |
---|
-1 to 1 |
EFI_THRLIN_COEF2: Throttle linearisation - Second Order¶
Second Order Polynomial Coefficient (=0, if throttle is second order polynomial trendline)
Range |
---|
-1 to 1 |
EFI_THRLIN_COEF3: Throttle linearisation - Third Order¶
Third Order Polynomial Coefficient. (=0, if throttle is third order polynomial trendline)
Range |
---|
-1 to 1 |
EFI_THRLIN_OFS: throttle linearization offset¶
Offset for throttle linearization
Range |
---|
0 to 100 |
GPS Parameters¶
GPS_AUTO_SWITCH: Automatic Switchover Setting¶
Automatic switchover to GPS reporting best lock, 1:UseBest selects the GPS with highest status, if both are equal the GPS with highest satellite count is used 4:Use primary if 3D fix or better, will revert to 'UseBest' behaviour if 3D fix is lost on primary
Values |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
GPS_SBAS_MODE: SBAS Mode¶
This sets the SBAS (satellite based augmentation system) mode if available on this GPS. If set to 2 then the SBAS mode is not changed in the GPS. Otherwise the GPS will be reconfigured to enable/disable SBAS. Disabling SBAS may be worthwhile in some parts of the world where an SBAS signal is available but the baseline is too long to be useful.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
GPS_MIN_ELEV: Minimum elevation¶
This sets the minimum elevation of satellites above the horizon for them to be used for navigation. Setting this to -100 leaves the minimum elevation set to the GPS modules default.
Range |
Units |
---|---|
-100 to 90 |
degrees |
GPS_INJECT_TO: Destination for GPS_INJECT_DATA MAVLink packets¶
The GGS can send raw serial packets to inject data to multiple GPSes.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
GPS_SBP_LOGMASK: Swift Binary Protocol Logging Mask¶
Masked with the SBP msg_type field to determine whether SBR1/SBR2 data is logged
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
GPS_RAW_DATA: Raw data logging¶
Handles logging raw data; on uBlox chips that support raw data this will log RXM messages into logger; on Septentrio this will log on the equipment's SD card and when set to 2, the autopilot will try to stop logging after disarming and restart after arming
Values |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
GPS_SAVE_CFG: Save GPS configuration¶
Determines whether the configuration for this GPS should be written to non-volatile memory on the GPS. Currently working for UBlox 6 series and above.
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
GPS_AUTO_CONFIG: Automatic GPS configuration¶
Controls if the autopilot should automatically configure the GPS based on the parameters and default settings
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
GPS_BLEND_MASK: Multi GPS Blending Mask¶
Determines which of the accuracy measures Horizontal position, Vertical Position and Speed are used to calculate the weighting on each GPS receiver when soft switching has been selected by setting GPS_AUTO_SWITCH to 2(Blend)
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
GPS_DRV_OPTIONS: driver options¶
Additional backend specific options
Bitmask |
||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
GPS_PRIMARY: Primary GPS¶
This GPS will be used when GPS_AUTO_SWITCH is 0 and used preferentially with GPS_AUTO_SWITCH = 4.
Increment |
Values |
||||||
---|---|---|---|---|---|---|---|
1 |
|
GPS1_ Parameters¶
GPS1_TYPE: GPS type¶
GPS type
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
GPS1_GNSS_MODE: GNSS system configuration¶
Bitmask for what GNSS system to use on the first GPS (all unchecked or zero to leave GPS as configured)
Bitmask |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
GPS1_RATE_MS: GPS update rate in milliseconds¶
Controls how often the GPS should provide a position update. Lowering below 5Hz(default) is not allowed. Raising the rate above 5Hz usually provides little benefit and for some GPS (eg Ublox M9N) can severely impact performance.
Range |
Units |
Values |
||||||||
---|---|---|---|---|---|---|---|---|---|---|
50 to 200 |
milliseconds |
|
GPS1_POS_X: Antenna X position offset¶
X position of the first GPS antenna in body frame. Positive X is forward of the origin. Use antenna phase centroid location if provided by the manufacturer.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS1_POS_Y: Antenna Y position offset¶
Y position of the first GPS antenna in body frame. Positive Y is to the right of the origin. Use antenna phase centroid location if provided by the manufacturer.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS1_POS_Z: Antenna Z position offset¶
Z position of the first GPS antenna in body frame. Positive Z is down from the origin. Use antenna phase centroid location if provided by the manufacturer.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS1_DELAY_MS: GPS delay in milliseconds¶
Controls the amount of GPS measurement delay that the autopilot compensates for. Set to zero to use the default delay for the detected GPS type.
Range |
Units |
---|---|
0 to 250 |
milliseconds |
GPS1_COM_PORT: GPS physical COM port¶
The physical COM port on the connected device, currently only applies to SBF and GSOF GPS
Increment |
Range |
Values |
||||||
---|---|---|---|---|---|---|---|---|
1 |
0 to 10 |
|
GPS1_CAN_NODEID: Detected CAN Node ID for GPS¶
GPS Node id for GPS. Detected node unless CAN_OVRIDE is set
ReadOnly |
---|
True |
GPS1_CAN_OVRIDE: DroneCAN GPS NODE ID¶
GPS Node id for GPS. If 0 the gps will be automatically selected on a first-come-first-GPS basis.
GPS1_MB_ Parameters¶
GPS1_MB_TYPE: Moving base type¶
Controls the type of moving base used if using moving base.This is renamed in 4.6 and later to GPSx_MB_TYPE.
Values |
||||||
---|---|---|---|---|---|---|
|
GPS1_MB_OFS_X: Base antenna X position offset¶
X position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive X is forward of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_X.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS1_MB_OFS_Y: Base antenna Y position offset¶
Y position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Y is to the right of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Y.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS1_MB_OFS_Z: Base antenna Z position offset¶
Z position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Z is down from the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Z.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS2_ Parameters¶
GPS2_TYPE: GPS type¶
GPS type
Values |
||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
GPS2_GNSS_MODE: GNSS system configuration¶
Bitmask for what GNSS system to use on the first GPS (all unchecked or zero to leave GPS as configured)
Bitmask |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
GPS2_RATE_MS: GPS update rate in milliseconds¶
Controls how often the GPS should provide a position update. Lowering below 5Hz(default) is not allowed. Raising the rate above 5Hz usually provides little benefit and for some GPS (eg Ublox M9N) can severely impact performance.
Range |
Units |
Values |
||||||||
---|---|---|---|---|---|---|---|---|---|---|
50 to 200 |
milliseconds |
|
GPS2_POS_X: Antenna X position offset¶
X position of the first GPS antenna in body frame. Positive X is forward of the origin. Use antenna phase centroid location if provided by the manufacturer.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS2_POS_Y: Antenna Y position offset¶
Y position of the first GPS antenna in body frame. Positive Y is to the right of the origin. Use antenna phase centroid location if provided by the manufacturer.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS2_POS_Z: Antenna Z position offset¶
Z position of the first GPS antenna in body frame. Positive Z is down from the origin. Use antenna phase centroid location if provided by the manufacturer.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS2_DELAY_MS: GPS delay in milliseconds¶
Controls the amount of GPS measurement delay that the autopilot compensates for. Set to zero to use the default delay for the detected GPS type.
Range |
Units |
---|---|
0 to 250 |
milliseconds |
GPS2_COM_PORT: GPS physical COM port¶
The physical COM port on the connected device, currently only applies to SBF and GSOF GPS
Increment |
Range |
Values |
||||||
---|---|---|---|---|---|---|---|---|
1 |
0 to 10 |
|
GPS2_CAN_NODEID: Detected CAN Node ID for GPS¶
GPS Node id for GPS. Detected node unless CAN_OVRIDE is set
ReadOnly |
---|
True |
GPS2_CAN_OVRIDE: DroneCAN GPS NODE ID¶
GPS Node id for GPS. If 0 the gps will be automatically selected on a first-come-first-GPS basis.
GPS2_MB_ Parameters¶
GPS2_MB_TYPE: Moving base type¶
Controls the type of moving base used if using moving base.This is renamed in 4.6 and later to GPSx_MB_TYPE.
Values |
||||||
---|---|---|---|---|---|---|
|
GPS2_MB_OFS_X: Base antenna X position offset¶
X position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive X is forward of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_X.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS2_MB_OFS_Y: Base antenna Y position offset¶
Y position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Y is to the right of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Y.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS2_MB_OFS_Z: Base antenna Z position offset¶
Z position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Z is down from the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Z.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS_MB1_ Parameters¶
GPS_MB1_TYPE: Moving base type¶
Controls the type of moving base used if using moving base.This is renamed in 4.6 and later to GPSx_MB_TYPE.
Values |
||||||
---|---|---|---|---|---|---|
|
GPS_MB1_OFS_X: Base antenna X position offset¶
X position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive X is forward of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_X.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS_MB1_OFS_Y: Base antenna Y position offset¶
Y position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Y is to the right of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Y.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS_MB1_OFS_Z: Base antenna Z position offset¶
Z position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Z is down from the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Z.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS_MB2_ Parameters¶
GPS_MB2_TYPE: Moving base type¶
Controls the type of moving base used if using moving base.This is renamed in 4.6 and later to GPSx_MB_TYPE.
Values |
||||||
---|---|---|---|---|---|---|
|
GPS_MB2_OFS_X: Base antenna X position offset¶
X position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive X is forward of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_X.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS_MB2_OFS_Y: Base antenna Y position offset¶
Y position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Y is to the right of the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Y.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
GPS_MB2_OFS_Z: Base antenna Z position offset¶
Z position of the base (primary) GPS antenna in body frame from the position of the 2nd antenna. Positive Z is down from the 2nd antenna. Use antenna phase centroid location if provided by the manufacturer.This is renamed in 4.6 and later to GPSx_MB_OFS_Z.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS Parameters¶
INS_GYROFFS_X: Gyro offsets of X axis¶
Gyro sensor offsets of X axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYROFFS_Y: Gyro offsets of Y axis¶
Gyro sensor offsets of Y axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYROFFS_Z: Gyro offsets of Z axis¶
Gyro sensor offsets of Z axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYR2OFFS_X: Gyro2 offsets of X axis¶
Gyro2 sensor offsets of X axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYR2OFFS_Y: Gyro2 offsets of Y axis¶
Gyro2 sensor offsets of Y axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYR2OFFS_Z: Gyro2 offsets of Z axis¶
Gyro2 sensor offsets of Z axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYR3OFFS_X: Gyro3 offsets of X axis¶
Gyro3 sensor offsets of X axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYR3OFFS_Y: Gyro3 offsets of Y axis¶
Gyro3 sensor offsets of Y axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_GYR3OFFS_Z: Gyro3 offsets of Z axis¶
Gyro3 sensor offsets of Z axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS_ACCSCAL_X: Accelerometer scaling of X axis¶
Accelerometer scaling of X axis. Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACCSCAL_Y: Accelerometer scaling of Y axis¶
Accelerometer scaling of Y axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACCSCAL_Z: Accelerometer scaling of Z axis¶
Accelerometer scaling of Z axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACCOFFS_X: Accelerometer offsets of X axis¶
Accelerometer offsets of X axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACCOFFS_Y: Accelerometer offsets of Y axis¶
Accelerometer offsets of Y axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACCOFFS_Z: Accelerometer offsets of Z axis¶
Accelerometer offsets of Z axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACC2SCAL_X: Accelerometer2 scaling of X axis¶
Accelerometer2 scaling of X axis. Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACC2SCAL_Y: Accelerometer2 scaling of Y axis¶
Accelerometer2 scaling of Y axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACC2SCAL_Z: Accelerometer2 scaling of Z axis¶
Accelerometer2 scaling of Z axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACC2OFFS_X: Accelerometer2 offsets of X axis¶
Accelerometer2 offsets of X axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACC2OFFS_Y: Accelerometer2 offsets of Y axis¶
Accelerometer2 offsets of Y axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACC2OFFS_Z: Accelerometer2 offsets of Z axis¶
Accelerometer2 offsets of Z axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACC3SCAL_X: Accelerometer3 scaling of X axis¶
Accelerometer3 scaling of X axis. Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACC3SCAL_Y: Accelerometer3 scaling of Y axis¶
Accelerometer3 scaling of Y axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACC3SCAL_Z: Accelerometer3 scaling of Z axis¶
Accelerometer3 scaling of Z axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS_ACC3OFFS_X: Accelerometer3 offsets of X axis¶
Accelerometer3 offsets of X axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACC3OFFS_Y: Accelerometer3 offsets of Y axis¶
Accelerometer3 offsets of Y axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_ACC3OFFS_Z: Accelerometer3 offsets of Z axis¶
Accelerometer3 offsets of Z axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS_GYRO_FILTER: Gyro filter cutoff frequency¶
Filter cutoff frequency for gyroscopes. This can be set to a lower value to try to cope with very high vibration levels in aircraft. A value of zero means no filtering (not recommended!)
Range |
Units |
---|---|
0 to 256 |
hertz |
INS_ACCEL_FILTER: Accel filter cutoff frequency¶
Filter cutoff frequency for accelerometers. This can be set to a lower value to try to cope with very high vibration levels in aircraft. A value of zero means no filtering (not recommended!)
Range |
Units |
---|---|
0 to 256 |
hertz |
INS_USE: Use first IMU for attitude, velocity and position estimates¶
Use first IMU for attitude, velocity and position estimates
Values |
||||||
---|---|---|---|---|---|---|
|
INS_USE2: Use second IMU for attitude, velocity and position estimates¶
Use second IMU for attitude, velocity and position estimates
Values |
||||||
---|---|---|---|---|---|---|
|
INS_USE3: Use third IMU for attitude, velocity and position estimates¶
Use third IMU for attitude, velocity and position estimates
Values |
||||||
---|---|---|---|---|---|---|
|
INS_STILL_THRESH: Stillness threshold for detecting if we are moving¶
Threshold to tolerate vibration to determine if vehicle is motionless. This depends on the frame type and if there is a constant vibration due to motors before launch or after landing. Total motionless is about 0.05. Suggested values: Planes/rover use 0.1, multirotors use 1, tradHeli uses 5
Range |
---|
0.05 to 50 |
INS_GYR_CAL: Gyro Calibration scheme¶
Conrols when automatic gyro calibration is performed
Values |
||||||
---|---|---|---|---|---|---|
|
INS_TRIM_OPTION: Accel cal trim option¶
Specifies how the accel cal routine determines the trims
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_ACC_BODYFIX: Body-fixed accelerometer¶
The body-fixed accelerometer to be used for trim calculation
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_POS1_X: IMU accelerometer X position¶
X position of the first IMU Accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_POS1_Y: IMU accelerometer Y position¶
Y position of the first IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_POS1_Z: IMU accelerometer Z position¶
Z position of the first IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_POS2_X: IMU accelerometer X position¶
X position of the second IMU accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_POS2_Y: IMU accelerometer Y position¶
Y position of the second IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_POS2_Z: IMU accelerometer Z position¶
Z position of the second IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_POS3_X: IMU accelerometer X position¶
X position of the third IMU accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Range |
Units |
---|---|
-10 to 10 |
meters |
INS_POS3_Y: IMU accelerometer Y position¶
Y position of the third IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_POS3_Z: IMU accelerometer Z position¶
Z position of the third IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS_GYR_ID: Gyro ID¶
Gyro sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS_GYR2_ID: Gyro2 ID¶
Gyro2 sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS_GYR3_ID: Gyro3 ID¶
Gyro3 sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS_ACC_ID: Accelerometer ID¶
Accelerometer sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS_ACC2_ID: Accelerometer2 ID¶
Accelerometer2 sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS_ACC3_ID: Accelerometer3 ID¶
Accelerometer3 sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS_FAST_SAMPLE: Fast sampling mask¶
Mask of IMUs to enable fast sampling on, if available
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_ENABLE_MASK: IMU enable mask¶
Bitmask of IMUs to enable. It can be used to prevent startup of specific detected IMUs
Bitmask |
||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
INS_GYRO_RATE: Gyro rate for IMUs with Fast Sampling enabled¶
Gyro rate for IMUs with fast sampling enabled. The gyro rate is the sample rate at which the IMU filters operate and needs to be at least double the maximum filter frequency. If the sensor does not support the selected rate the next highest supported rate will be used. For IMUs which do not support fast sampling this setting is ignored and the default gyro rate of 1Khz is used.
Values |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
INS_ACC1_CALTEMP: Calibration temperature for 1st accelerometer¶
Temperature that the 1st accelerometer was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS_GYR1_CALTEMP: Calibration temperature for 1st gyroscope¶
Temperature that the 1st gyroscope was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS_ACC2_CALTEMP: Calibration temperature for 2nd accelerometer¶
Temperature that the 2nd accelerometer was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS_GYR2_CALTEMP: Calibration temperature for 2nd gyroscope¶
Temperature that the 2nd gyroscope was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS_ACC3_CALTEMP: Calibration temperature for 3rd accelerometer¶
Temperature that the 3rd accelerometer was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS_GYR3_CALTEMP: Calibration temperature for 3rd gyroscope¶
Temperature that the 3rd gyroscope was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS_TCAL_OPTIONS: Options for temperature calibration¶
This enables optional temperature calibration features. Setting of the Persist bits will save the temperature and/or accelerometer calibration parameters in the bootloader sector on the next update of the bootloader.
Bitmask |
||||||
---|---|---|---|---|---|---|
|
INS_RAW_LOG_OPT: Raw logging options¶
Raw logging options bitmask
Bitmask |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
INS4_ Parameters¶
INS4_USE: Use first IMU for attitude, velocity and position estimates¶
Use first IMU for attitude, velocity and position estimates
Values |
||||||
---|---|---|---|---|---|---|
|
INS4_ACC_ID: Accelerometer ID¶
Accelerometer sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS4_ACCSCAL_X: Accelerometer scaling of X axis¶
Accelerometer scaling of X axis. Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS4_ACCSCAL_Y: Accelerometer scaling of Y axis¶
Accelerometer scaling of Y axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS4_ACCSCAL_Z: Accelerometer scaling of Z axis¶
Accelerometer scaling of Z axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS4_ACCOFFS_X: Accelerometer offsets of X axis¶
Accelerometer offsets of X axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS4_ACCOFFS_Y: Accelerometer offsets of Y axis¶
Accelerometer offsets of Y axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS4_ACCOFFS_Z: Accelerometer offsets of Z axis¶
Accelerometer offsets of Z axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS4_POS_X: IMU accelerometer X position¶
X position of the first IMU Accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS4_POS_Y: IMU accelerometer Y position¶
Y position of the first IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS4_POS_Z: IMU accelerometer Z position¶
Z position of the first IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS4_ACC_CALTEMP: Calibration temperature for accelerometer¶
Temperature that the accelerometer was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS4_GYR_ID: Gyro ID¶
Gyro sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS4_GYROFFS_X: Gyro offsets of X axis¶
Gyro sensor offsets of X axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS4_GYROFFS_Y: Gyro offsets of Y axis¶
Gyro sensor offsets of Y axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS4_GYROFFS_Z: Gyro offsets of Z axis¶
Gyro sensor offsets of Z axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS4_GYR_CALTEMP: Calibration temperature for gyroscope¶
Temperature that the gyroscope was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS4_TCAL_ Parameters¶
INS4_TCAL_ENABLE: Enable temperature calibration¶
Enable the use of temperature calibration parameters for this IMU. For automatic learning set to 2 and also set the INS_TCALn_TMAX to the target temperature, then reboot
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS4_TCAL_TMIN: Temperature calibration min¶
The minimum temperature that the calibration is valid for
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS4_TCAL_TMAX: Temperature calibration max¶
The maximum temperature that the calibration is valid for. This must be at least 10 degrees above TMIN for calibration
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS4_TCAL_ACC1_X: Accelerometer 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC1_Y: Accelerometer 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC1_Z: Accelerometer 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC2_X: Accelerometer 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC2_Y: Accelerometer 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC2_Z: Accelerometer 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC3_X: Accelerometer 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC3_Y: Accelerometer 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_ACC3_Z: Accelerometer 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR1_X: Gyroscope 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR1_Y: Gyroscope 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR1_Z: Gyroscope 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR2_X: Gyroscope 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR2_Y: Gyroscope 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR2_Z: Gyroscope 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR3_X: Gyroscope 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR3_Y: Gyroscope 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS4_TCAL_GYR3_Z: Gyroscope 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_ Parameters¶
INS5_USE: Use first IMU for attitude, velocity and position estimates¶
Use first IMU for attitude, velocity and position estimates
Values |
||||||
---|---|---|---|---|---|---|
|
INS5_ACC_ID: Accelerometer ID¶
Accelerometer sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS5_ACCSCAL_X: Accelerometer scaling of X axis¶
Accelerometer scaling of X axis. Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS5_ACCSCAL_Y: Accelerometer scaling of Y axis¶
Accelerometer scaling of Y axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS5_ACCSCAL_Z: Accelerometer scaling of Z axis¶
Accelerometer scaling of Z axis Calculated during acceleration calibration routine
Calibration |
Range |
---|---|
1 |
0.8 to 1.2 |
INS5_ACCOFFS_X: Accelerometer offsets of X axis¶
Accelerometer offsets of X axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS5_ACCOFFS_Y: Accelerometer offsets of Y axis¶
Accelerometer offsets of Y axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS5_ACCOFFS_Z: Accelerometer offsets of Z axis¶
Accelerometer offsets of Z axis. This is setup using the acceleration calibration or level operations
Calibration |
Range |
Units |
---|---|---|
1 |
-3.5 to 3.5 |
meters per square second |
INS5_POS_X: IMU accelerometer X position¶
X position of the first IMU Accelerometer in body frame. Positive X is forward of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS5_POS_Y: IMU accelerometer Y position¶
Y position of the first IMU accelerometer in body frame. Positive Y is to the right of the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS5_POS_Z: IMU accelerometer Z position¶
Z position of the first IMU accelerometer in body frame. Positive Z is down from the origin. Attention: The IMU should be located as close to the vehicle c.g. as practical so that the value of this parameter is minimised. Failure to do so can result in noisy navigation velocity measurements due to vibration and IMU gyro noise. If the IMU cannot be moved and velocity noise is a problem, a location closer to the IMU can be used as the body frame origin.
Increment |
Range |
Units |
---|---|---|
0.01 |
-5 to 5 |
meters |
INS5_ACC_CALTEMP: Calibration temperature for accelerometer¶
Temperature that the accelerometer was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS5_GYR_ID: Gyro ID¶
Gyro sensor ID, taking into account its type, bus and instance
ReadOnly |
---|
True |
INS5_GYROFFS_X: Gyro offsets of X axis¶
Gyro sensor offsets of X axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS5_GYROFFS_Y: Gyro offsets of Y axis¶
Gyro sensor offsets of Y axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS5_GYROFFS_Z: Gyro offsets of Z axis¶
Gyro sensor offsets of Z axis. This is setup on each boot during gyro calibrations
Calibration |
Units |
---|---|
1 |
radians per second |
INS5_GYR_CALTEMP: Calibration temperature for gyroscope¶
Temperature that the gyroscope was calibrated at
Calibration |
Units |
---|---|
1 |
degrees Celsius |
INS5_TCAL_ Parameters¶
INS5_TCAL_ENABLE: Enable temperature calibration¶
Enable the use of temperature calibration parameters for this IMU. For automatic learning set to 2 and also set the INS_TCALn_TMAX to the target temperature, then reboot
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS5_TCAL_TMIN: Temperature calibration min¶
The minimum temperature that the calibration is valid for
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS5_TCAL_TMAX: Temperature calibration max¶
The maximum temperature that the calibration is valid for. This must be at least 10 degrees above TMIN for calibration
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS5_TCAL_ACC1_X: Accelerometer 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC1_Y: Accelerometer 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC1_Z: Accelerometer 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC2_X: Accelerometer 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC2_Y: Accelerometer 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC2_Z: Accelerometer 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC3_X: Accelerometer 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC3_Y: Accelerometer 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_ACC3_Z: Accelerometer 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR1_X: Gyroscope 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR1_Y: Gyroscope 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR1_Z: Gyroscope 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR2_X: Gyroscope 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR2_Y: Gyroscope 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR2_Z: Gyroscope 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR3_X: Gyroscope 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR3_Y: Gyroscope 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS5_TCAL_GYR3_Z: Gyroscope 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_HNTC2_ Parameters¶
INS_HNTC2_ENABLE: Harmonic Notch Filter enable¶
Harmonic Notch Filter enable
Values |
||||||
---|---|---|---|---|---|---|
|
INS_HNTC2_FREQ: Harmonic Notch Filter base frequency¶
Harmonic Notch Filter base center frequency in Hz. This is the center frequency for static notches, the center frequency for Throttle based notches at the reference thrust value, and the minimum limit of center frequency variation for all other notch types. This should always be set lower than half the backend gyro rate (which is typically 1Khz).
Range |
Units |
---|---|
10 to 495 |
hertz |
INS_HNTC2_BW: Harmonic Notch Filter bandwidth¶
Harmonic Notch Filter bandwidth in Hz. This is typically set to half the base frequency. The ratio of base frequency to bandwidth determines the notch quality factor and is fixed across harmonics.
Range |
Units |
---|---|
5 to 250 |
hertz |
INS_HNTC2_ATT: Harmonic Notch Filter attenuation¶
Harmonic Notch Filter attenuation in dB. Values greater than 40dB will typically produce a hard notch rather than a modest attenuation of motor noise.
Range |
Units |
---|---|
5 to 50 |
decibel |
INS_HNTC2_HMNCS: Harmonic Notch Filter harmonics¶
Bitmask of harmonic frequencies to apply Harmonic Notch Filter to. This option takes effect on the next reboot. A value of 0 disables this filter. The first harmonic refers to the base frequency.
Bitmask |
||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
INS_HNTC2_REF: Harmonic Notch Filter reference value¶
A reference value of zero disables dynamic updates on the Harmonic Notch Filter and a positive value enables dynamic updates on the Harmonic Notch Filter. For throttle-based scaling, this parameter is the reference value associated with the specified frequency to facilitate frequency scaling of the Harmonic Notch Filter. For RPM and ESC telemetry based tracking, this parameter is set to 1 to enable the Harmonic Notch Filter using the RPM sensor or ESC telemetry set to measure rotor speed. The sensor data is converted to Hz automatically for use in the Harmonic Notch Filter. This reference value may also be used to scale the sensor data, if required. For example, rpm sensor data is required to measure heli motor RPM. Therefore the reference value can be used to scale the RPM sensor to the rotor RPM.
Range |
---|
0.0 to 1.0 |
INS_HNTC2_MODE: Harmonic Notch Filter dynamic frequency tracking mode¶
Harmonic Notch Filter dynamic frequency tracking mode. Dynamic updates can be throttle, RPM sensor, ESC telemetry or dynamic FFT based. Throttle-based harmonic notch cannot be used on fixed wing only planes. It can for Copters, QuaadPlane(while in VTOL modes), and Rovers.
Range |
Values |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 to 5 |
|
INS_HNTC2_OPTS: Harmonic Notch Filter options¶
Harmonic Notch Filter options. Triple and double-notches can provide deeper attenuation across a wider bandwidth with reduced latency than single notches and are suitable for larger aircraft. Multi-Source attaches a harmonic notch to each detected noise frequency instead of simply being multiples of the base frequency, in the case of FFT it will attach notches to each of three detected noise peaks, in the case of ESC it will attach notches to each of four motor RPM values. Loop rate update changes the notch center frequency at the scheduler loop rate rather than at the default of 200Hz. If both double and triple notches are specified only double notches will take effect.
Bitmask |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
INS_HNTC2_FM_RAT: Throttle notch min freqency ratio¶
The minimum ratio below the configured frequency to take throttle based notch filters when flying at a throttle level below the reference throttle. Note that lower frequency notch filters will have more phase lag. If you want throttle based notch filtering to be effective at a throttle up to 30% below the configured notch frequency then set this parameter to 0.7. The default of 1.0 means the notch will not go below the frequency in the FREQ parameter.
Range |
---|
0.1 to 1.0 |
INS_HNTCH_ Parameters¶
INS_HNTCH_ENABLE: Harmonic Notch Filter enable¶
Harmonic Notch Filter enable
Values |
||||||
---|---|---|---|---|---|---|
|
INS_HNTCH_FREQ: Harmonic Notch Filter base frequency¶
Harmonic Notch Filter base center frequency in Hz. This is the center frequency for static notches, the center frequency for Throttle based notches at the reference thrust value, and the minimum limit of center frequency variation for all other notch types. This should always be set lower than half the backend gyro rate (which is typically 1Khz).
Range |
Units |
---|---|
10 to 495 |
hertz |
INS_HNTCH_BW: Harmonic Notch Filter bandwidth¶
Harmonic Notch Filter bandwidth in Hz. This is typically set to half the base frequency. The ratio of base frequency to bandwidth determines the notch quality factor and is fixed across harmonics.
Range |
Units |
---|---|
5 to 250 |
hertz |
INS_HNTCH_ATT: Harmonic Notch Filter attenuation¶
Harmonic Notch Filter attenuation in dB. Values greater than 40dB will typically produce a hard notch rather than a modest attenuation of motor noise.
Range |
Units |
---|---|
5 to 50 |
decibel |
INS_HNTCH_HMNCS: Harmonic Notch Filter harmonics¶
Bitmask of harmonic frequencies to apply Harmonic Notch Filter to. This option takes effect on the next reboot. A value of 0 disables this filter. The first harmonic refers to the base frequency.
Bitmask |
||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
INS_HNTCH_REF: Harmonic Notch Filter reference value¶
A reference value of zero disables dynamic updates on the Harmonic Notch Filter and a positive value enables dynamic updates on the Harmonic Notch Filter. For throttle-based scaling, this parameter is the reference value associated with the specified frequency to facilitate frequency scaling of the Harmonic Notch Filter. For RPM and ESC telemetry based tracking, this parameter is set to 1 to enable the Harmonic Notch Filter using the RPM sensor or ESC telemetry set to measure rotor speed. The sensor data is converted to Hz automatically for use in the Harmonic Notch Filter. This reference value may also be used to scale the sensor data, if required. For example, rpm sensor data is required to measure heli motor RPM. Therefore the reference value can be used to scale the RPM sensor to the rotor RPM.
Range |
---|
0.0 to 1.0 |
INS_HNTCH_MODE: Harmonic Notch Filter dynamic frequency tracking mode¶
Harmonic Notch Filter dynamic frequency tracking mode. Dynamic updates can be throttle, RPM sensor, ESC telemetry or dynamic FFT based. Throttle-based harmonic notch cannot be used on fixed wing only planes. It can for Copters, QuaadPlane(while in VTOL modes), and Rovers.
Range |
Values |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
0 to 5 |
|
INS_HNTCH_OPTS: Harmonic Notch Filter options¶
Harmonic Notch Filter options. Triple and double-notches can provide deeper attenuation across a wider bandwidth with reduced latency than single notches and are suitable for larger aircraft. Multi-Source attaches a harmonic notch to each detected noise frequency instead of simply being multiples of the base frequency, in the case of FFT it will attach notches to each of three detected noise peaks, in the case of ESC it will attach notches to each of four motor RPM values. Loop rate update changes the notch center frequency at the scheduler loop rate rather than at the default of 200Hz. If both double and triple notches are specified only double notches will take effect.
Bitmask |
||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
INS_HNTCH_FM_RAT: Throttle notch min freqency ratio¶
The minimum ratio below the configured frequency to take throttle based notch filters when flying at a throttle level below the reference throttle. Note that lower frequency notch filters will have more phase lag. If you want throttle based notch filtering to be effective at a throttle up to 30% below the configured notch frequency then set this parameter to 0.7. The default of 1.0 means the notch will not go below the frequency in the FREQ parameter.
Range |
---|
0.1 to 1.0 |
INS_LOG_ Parameters¶
INS_LOG_BAT_CNT: sample count per batch¶
Number of samples to take when logging streams of IMU sensor readings. Will be rounded down to a multiple of 32. This option takes effect on the next reboot.
Increment |
---|
32 |
INS_LOG_BAT_MASK: Sensor Bitmask¶
Bitmap of which IMUs to log batch data for. This option takes effect on the next reboot.
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_LOG_BAT_OPT: Batch Logging Options Mask¶
Options for the BatchSampler.
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_LOG_BAT_LGIN: logging interval¶
Interval between pushing samples to the AP_Logger log
Increment |
Units |
---|---|
10 |
milliseconds |
INS_LOG_BAT_LGCT: logging count¶
Number of samples to push to count every INS_LOG_BAT_LGIN
Increment |
---|
1 |
INS_TCAL1_ Parameters¶
INS_TCAL1_ENABLE: Enable temperature calibration¶
Enable the use of temperature calibration parameters for this IMU. For automatic learning set to 2 and also set the INS_TCALn_TMAX to the target temperature, then reboot
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_TCAL1_TMIN: Temperature calibration min¶
The minimum temperature that the calibration is valid for
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS_TCAL1_TMAX: Temperature calibration max¶
The maximum temperature that the calibration is valid for. This must be at least 10 degrees above TMIN for calibration
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS_TCAL1_ACC1_X: Accelerometer 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC1_Y: Accelerometer 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC1_Z: Accelerometer 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC2_X: Accelerometer 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC2_Y: Accelerometer 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC2_Z: Accelerometer 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC3_X: Accelerometer 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC3_Y: Accelerometer 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_ACC3_Z: Accelerometer 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR1_X: Gyroscope 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR1_Y: Gyroscope 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR1_Z: Gyroscope 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR2_X: Gyroscope 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR2_Y: Gyroscope 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR2_Z: Gyroscope 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR3_X: Gyroscope 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR3_Y: Gyroscope 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL1_GYR3_Z: Gyroscope 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ Parameters¶
INS_TCAL2_ENABLE: Enable temperature calibration¶
Enable the use of temperature calibration parameters for this IMU. For automatic learning set to 2 and also set the INS_TCALn_TMAX to the target temperature, then reboot
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_TCAL2_TMIN: Temperature calibration min¶
The minimum temperature that the calibration is valid for
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS_TCAL2_TMAX: Temperature calibration max¶
The maximum temperature that the calibration is valid for. This must be at least 10 degrees above TMIN for calibration
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS_TCAL2_ACC1_X: Accelerometer 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC1_Y: Accelerometer 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC1_Z: Accelerometer 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC2_X: Accelerometer 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC2_Y: Accelerometer 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC2_Z: Accelerometer 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC3_X: Accelerometer 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC3_Y: Accelerometer 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_ACC3_Z: Accelerometer 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR1_X: Gyroscope 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR1_Y: Gyroscope 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR1_Z: Gyroscope 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR2_X: Gyroscope 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR2_Y: Gyroscope 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR2_Z: Gyroscope 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR3_X: Gyroscope 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR3_Y: Gyroscope 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL2_GYR3_Z: Gyroscope 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ Parameters¶
INS_TCAL3_ENABLE: Enable temperature calibration¶
Enable the use of temperature calibration parameters for this IMU. For automatic learning set to 2 and also set the INS_TCALn_TMAX to the target temperature, then reboot
Values |
||||||||
---|---|---|---|---|---|---|---|---|
|
INS_TCAL3_TMIN: Temperature calibration min¶
The minimum temperature that the calibration is valid for
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS_TCAL3_TMAX: Temperature calibration max¶
The maximum temperature that the calibration is valid for. This must be at least 10 degrees above TMIN for calibration
Calibration |
Range |
Units |
---|---|---|
1 |
-70 to 80 |
degrees Celsius |
INS_TCAL3_ACC1_X: Accelerometer 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC1_Y: Accelerometer 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC1_Z: Accelerometer 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC2_X: Accelerometer 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC2_Y: Accelerometer 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC2_Z: Accelerometer 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC3_X: Accelerometer 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC3_Y: Accelerometer 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_ACC3_Z: Accelerometer 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR1_X: Gyroscope 1st order temperature coefficient X axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR1_Y: Gyroscope 1st order temperature coefficient Y axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR1_Z: Gyroscope 1st order temperature coefficient Z axis¶
This is the 1st order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR2_X: Gyroscope 2nd order temperature coefficient X axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR2_Y: Gyroscope 2nd order temperature coefficient Y axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR2_Z: Gyroscope 2nd order temperature coefficient Z axis¶
This is the 2nd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR3_X: Gyroscope 3rd order temperature coefficient X axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR3_Y: Gyroscope 3rd order temperature coefficient Y axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
INS_TCAL3_GYR3_Z: Gyroscope 3rd order temperature coefficient Z axis¶
This is the 3rd order temperature coefficient from a temperature calibration
Calibration |
---|
1 |
KDE_ Parameters¶
KDE_NPOLE: Number of motor poles¶
Sets the number of motor poles to calculate the correct RPM value
LOG Parameters¶
LOG_BACKEND_TYPE: AP_Logger Backend Storage type¶
Bitmap of what Logger backend types to enable. Block-based logging is available on SITL and boards with dataflash chips. Multiple backends can be selected.
Bitmask |
||||||||
---|---|---|---|---|---|---|---|---|
|
LOG_FILE_BUFSIZE: Maximum AP_Logger File and Block Backend buffer size (in kilobytes)¶
The File and Block backends use a buffer to store data before writing to the block device. Raising this value may reduce "gaps" in your SD card logging. This buffer size may be reduced depending on available memory. PixHawk requires at least 4 kilobytes. Maximum value available here is 64 kilobytes.
LOG_DISARMED: Enable logging while disarmed¶
If LOG_DISARMED is set to 1 then logging will be enabled at all times including when disarmed. Logging before arming can make for very large logfiles but can help a lot when tracking down startup issues and is necessary if logging of EKF replay data is selected via the LOG_REPLAY parameter. If LOG_DISARMED is set to 2, then logging will be enabled when disarmed, but not if a USB connection is detected. This can be used to prevent unwanted data logs being generated when the vehicle is connected via USB for log downloading or parameter changes. If LOG_DISARMED is set t