/
settings.yaml
3037 lines (2984 loc) · 130 KB
/
settings.yaml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
tables:
- name: alignment
values: ["DEFAULT", "CW0", "CW90", "CW180", "CW270", "CW0FLIP", "CW90FLIP", "CW180FLIP", "CW270FLIP"]
- name: gyro_lpf
values: ["256HZ", "188HZ", "98HZ", "42HZ", "20HZ", "10HZ"]
- name: acc_hardware
values: ["NONE", "AUTO", "ADXL345", "MPU6050", "MMA845x", "BMA280", "LSM303DLHC", "MPU6000", "MPU6500", "MPU9250", "BMI160", "ICM20689", "FAKE"]
enum: accelerationSensor_e
- name: rangefinder_hardware
values: ["NONE", "HCSR04", "SRF10", "INAV_I2C", "VL53L0X", "MSP", "UIB", "BENEWAKE"]
enum: rangefinderType_e
- name: mag_hardware
values: ["NONE", "AUTO", "HMC5883", "AK8975", "GPSMAG", "MAG3110", "AK8963", "IST8310", "QMC5883", "MPU9250", "IST8308", "LIS3MDL", "FAKE"]
enum: magSensor_e
- name: opflow_hardware
values: ["NONE", "PMW3901", "CXOF", "MSP", "FAKE"]
enum: opticalFlowSensor_e
- name: baro_hardware
values: ["NONE", "AUTO", "BMP085", "MS5611", "BMP280", "MS5607", "LPS25H", "SPL06", "BMP388", "DPS310", "FAKE"]
enum: baroSensor_e
- name: pitot_hardware
values: ["NONE", "AUTO", "MS4525", "ADC", "VIRTUAL", "FAKE"]
enum: pitotSensor_e
- name: receiver_type
values: ["NONE", "PPM", "SERIAL", "MSP", "SPI", "UIB"]
enum: rxReceiverType_e
- name: serial_rx
values: ["SPEK1024", "SPEK2048", "SBUS", "SUMD", "SUMH", "XB-B", "XB-B-RJ01", "IBUS", "JETIEXBUS", "CRSF", "FPORT", "FPORT2", "SBUS_FAST"]
- name: rx_spi_protocol
values: ["V202_250K", "V202_1M", "SYMA_X", "SYMA_X5C", "CX10", "CX10A", "H8_3D", "INAV", "ELERES"]
enum: rx_spi_protocol_e
- name: blackbox_device
values: ["SERIAL", "SPIFLASH", "SDCARD"]
- name: motor_pwm_protocol
values: ["STANDARD", "ONESHOT125", "ONESHOT42", "MULTISHOT", "BRUSHED", "DSHOT150", "DSHOT300", "DSHOT600", "DSHOT1200", "SERIALSHOT"]
- name: servo_protocol
values: ["PWM", "SERVO_DRIVER", "SBUS"]
- name: failsafe_procedure
values: ["SET-THR", "DROP", "RTH", "NONE"]
- name: current_sensor
values: ["NONE", "ADC", "VIRTUAL", "ESC"]
enum: currentSensor_e
- name: voltage_sensor
values: ["NONE", "ADC", "ESC"]
enum: voltageSensor_e
- name: gps_provider
values: ["NMEA", "UBLOX", "UNUSED", "NAZA", "UBLOX7", "MTK"]
enum: gpsProvider_e
- name: gps_sbas_mode
values: ["AUTO", "EGNOS", "WAAS", "MSAS", "GAGAN", "NONE"]
enum: sbasMode_e
- name: gps_dyn_model
values: ["PEDESTRIAN", "AIR_1G", "AIR_4G"]
enum: gpsDynModel_e
- name: reset_type
values: ["NEVER", "FIRST_ARM", "EACH_ARM"]
- name: direction
values: ["RIGHT", "LEFT", "YAW"]
- name: nav_user_control_mode
values: ["ATTI", "CRUISE"]
- name: nav_rth_alt_mode
values: ["CURRENT", "EXTRA", "FIXED", "MAX", "AT_LEAST", "AT_LEAST_LINEAR_DESCENT"]
- name: osd_unit
values: ["IMPERIAL", "METRIC", "UK"]
enum: osd_unit_e
- name: osd_stats_energy_unit
values: ["MAH", "WH"]
enum: osd_stats_energy_unit_e
- name: osd_video_system
values: ["AUTO", "PAL", "NTSC"]
enum: videoSystem_e
- name: osd_alignment
values: ["LEFT", "RIGHT"]
enum: osd_alignment_e
- name: frsky_unit
values: ["METRIC", "IMPERIAL"]
enum: frskyUnit_e
- name: ltm_rates
values: ["NORMAL", "MEDIUM", "SLOW"]
- name: i2c_speed
values: ["400KHZ", "800KHZ", "100KHZ", "200KHZ"]
- name: debug_modes
values: ["NONE", "GYRO", "AGL", "FLOW_RAW",
"FLOW", "SBUS", "FPORT", "ALWAYS", "SAG_COMP_VOLTAGE",
"VIBE", "CRUISE", "REM_FLIGHT_TIME", "SMARTAUDIO", "ACC", "ITERM_RELAX",
"ERPM", "RPM_FILTER", "RPM_FREQ", "NAV_YAW", "DYNAMIC_FILTER", "DYNAMIC_FILTER_FREQUENCY",
"IRLOCK", "CD", "KALMAN", "SPM_CELLS", "SPM_VS600", "SPM_VARIO", "PCF8574"]
- name: async_mode
values: ["NONE", "GYRO", "ALL"]
- name: aux_operator
values: ["OR", "AND"]
enum: modeActivationOperator_e
- name: osd_crosshairs_style
values: ["DEFAULT", "AIRCRAFT", "TYPE3", "TYPE4", "TYPE5", "TYPE6", "TYPE7"]
enum: osd_crosshairs_style_e
- name: osd_sidebar_scroll
values: ["NONE", "ALTITUDE", "GROUND_SPEED", "HOME_DISTANCE"]
enum: osd_sidebar_scroll_e
- name: nav_rth_allow_landing
values: ["NEVER", "ALWAYS", "FS_ONLY"]
enum: navRTHAllowLanding_e
- name: bat_capacity_unit
values: ["MAH", "MWH"]
enum: batCapacityUnit_e
- name: bat_voltage_source
values: ["RAW", "SAG_COMP"]
enum: batVoltageSource_e
- name: smartport_fuel_unit
values: ["PERCENT", "MAH", "MWH"]
enum: smartportFuelUnit_e
- name: platform_type
values: ["MULTIROTOR", "AIRPLANE", "HELICOPTER", "TRICOPTER", "ROVER", "BOAT"]
enum: flyingPlatformType_e
- name: tz_automatic_dst
values: ["OFF", "EU", "USA"]
enum: tz_automatic_dst_e
- name: vtx_low_power_disarm
values: ["OFF", "ON", "UNTIL_FIRST_ARM"]
enum: vtxLowerPowerDisarm_e
- name: filter_type
values: ["PT1", "BIQUAD"]
- name: log_level
values: ["ERROR", "WARNING", "INFO", "VERBOSE", "DEBUG"]
- name: iterm_relax
values: ["OFF", "RP", "RPY"]
enum: itermRelax_e
- name: iterm_relax_type
values: ["GYRO", "SETPOINT"]
enum: itermRelaxType_e
- name: airmodeHandlingType
values: ["STICK_CENTER", "THROTTLE_THRESHOLD"]
- name: nav_extra_arming_safety
values: ["OFF", "ON", "ALLOW_BYPASS"]
enum: navExtraArmingSafety_e
- name: rssi_source
values: ["NONE", "AUTO", "ADC", "CHANNEL", "PROTOCOL", "MSP"]
enum: rssiSource_e
- name: dynamicFilterRangeTable
values: ["HIGH", "MEDIUM", "LOW"]
enum: dynamicFilterRange_e
- name: pidTypeTable
values: ["NONE", "PID", "PIFF", "AUTO"]
enum: pidType_e
- name: osd_ahi_style
values: ["DEFAULT", "LINE"]
enum: osd_ahi_style_e
groups:
- name: PG_GYRO_CONFIG
type: gyroConfig_t
headers: ["sensors/gyro.h"]
members:
- name: looptime
description: "This is the main loop time (in us). Changing this affects PID effect with some PID controllers (see PID section for details). A very conservative value of 3500us/285Hz should work for everyone. Setting it to zero does not limit loop time, so it will go as fast as possible."
default_value: "1000"
max: 9000
- name: gyro_sync
description: "This option enables gyro_sync feature. In this case the loop will be synced to gyro refresh rate. Loop will always wait for the newest gyro measurement. Maximum gyro refresh rate is determined by gyro_hardware_lpf"
default_value: "OFF"
field: gyroSync
type: bool
- name: align_gyro
description: "When running on non-default hardware or adding support for new sensors/sensor boards, these values are used for sensor orientation. When carefully understood, these values can also be used to rotate (in 90deg steps) or flip the board. Possible values are: DEFAULT, CW0_DEG, CW90_DEG, CW180_DEG, CW270_DEG, CW0_DEG_FLIP, CW90_DEG_FLIP, CW180_DEG_FLIP, CW270_DEG_FLIP."
default_value: "DEFAULT"
field: gyro_align
type: uint8_t
table: alignment
- name: gyro_hardware_lpf
description: "Hardware lowpass filter for gyro. Allowed values depend on the driver - For example MPU6050 allows 10HZ,20HZ,42HZ,98HZ,188HZ,256Hz (8khz mode). If you have to set gyro lpf below 42Hz generally means the frame is vibrating too much, and that should be fixed first."
default_value: "42HZ"
field: gyro_lpf
table: gyro_lpf
- name: gyro_lpf_hz
description: "Software-based filter to remove mechanical vibrations from the gyro signal. Value is cutoff frequency (Hz). For larger frames with bigger props set to lower value."
default_value: "60"
field: gyro_soft_lpf_hz
max: 200
- name: gyro_lpf_type
description: "Specifies the type of the software LPF of the gyro signals. BIQUAD gives better filtering and more delay, PT1 less filtering and less delay, so use only on clean builds."
default_value: "BIQUAD"
field: gyro_soft_lpf_type
table: filter_type
- name: moron_threshold
description: "When powering up, gyro bias is calculated. If the model is shaking/moving during this initial calibration, offsets are calculated incorrectly, and could lead to poor flying performance. This threshold means how much average gyro reading could differ before re-calibration is triggered."
default_value: "32"
field: gyroMovementCalibrationThreshold
max: 128
- name: gyro_notch_hz
field: gyro_notch_hz
max: 500
- name: gyro_notch_cutoff
field: gyro_notch_cutoff
min: 1
max: 500
- name: gyro_stage2_lowpass_hz
description: "Software based second stage lowpass filter for gyro. Value is cutoff frequency (Hz)"
default_value: "0"
field: gyro_stage2_lowpass_hz
min: 0
max: 500
- name: gyro_stage2_lowpass_type
description: "Defines the type of stage 2 gyro LPF filter. Possible values: `PT1`, `BIQUAD`. `PT1` offers faster filter response while `BIQUAD` better attenuation."
default_value: "`BIQUAD`"
field: gyro_stage2_lowpass_type
table: filter_type
- name: dynamic_gyro_notch_enabled
description: "Enable/disable dynamic gyro notch also known as Matrix Filter"
default_value: "`OFF`"
field: dynamicGyroNotchEnabled
condition: USE_DYNAMIC_FILTERS
type: bool
- name: dynamic_gyro_notch_range
description: "Range for dynamic gyro notches. `MEDIUM` for 5\", `HIGH` for 3\" and `MEDIUM`/`LOW` for 7\" and bigger propellers"
default_value: "`MEDIUM`"
field: dynamicGyroNotchRange
condition: USE_DYNAMIC_FILTERS
table: dynamicFilterRangeTable
- name: dynamic_gyro_notch_q
description: "Q factor for dynamic notches"
default_value: "120"
field: dynamicGyroNotchQ
condition: USE_DYNAMIC_FILTERS
min: 1
max: 1000
- name: dynamic_gyro_notch_min_hz
description: "Minimum frequency for dynamic notches. Default value of `150` works best with 5\" multirors. Should be lowered with increased size of propellers. Values around `100` work fine on 7\" drones. 10\" can go down to `60` - `70`"
default_value: "150"
field: dynamicGyroNotchMinHz
condition: USE_DYNAMIC_FILTERS
min: 30
max: 1000
- name: gyro_kalman_enabled
condition: USE_GYRO_KALMAN
field: kalmanEnabled
type: bool
- name: gyro_kalman_q
field: kalman_q
condition: USE_GYRO_KALMAN
min: 1
max: 16000
- name: gyro_kalman_w
field: kalman_w
condition: USE_GYRO_KALMAN
min: 1
max: 40
- name: gyro_kalman_sharpness
field: kalman_sharpness
condition: USE_GYRO_KALMAN
min: 1
max: 16000
- name: gyro_to_use
condition: USE_DUAL_GYRO
min: 0
max: 1
- name: PG_ADC_CHANNEL_CONFIG
type: adcChannelConfig_t
headers: ["fc/config.h"]
condition: USE_ADC
members:
- name: vbat_adc_channel
description: "ADC channel to use for battery voltage sensor. Defaults to board VBAT input (if available). 0 = disabled"
default_value: "-"
field: adcFunctionChannel[ADC_BATTERY]
min: ADC_CHN_NONE
max: ADC_CHN_MAX
- name: rssi_adc_channel
description: "ADC channel to use for analog RSSI input. Defaults to board RSSI input (if available). 0 = disabled"
default_value: "-"
field: adcFunctionChannel[ADC_RSSI]
min: ADC_CHN_NONE
max: ADC_CHN_MAX
- name: current_adc_channel
description: "ADC channel to use for analog current sensor input. Defaults to board CURRENT sensor input (if available). 0 = disabled"
default_value: "-"
field: adcFunctionChannel[ADC_CURRENT]
min: ADC_CHN_NONE
max: ADC_CHN_MAX
- name: airspeed_adc_channel
description: "ADC channel to use for analog pitot tube (airspeed) sensor. If board doesn't have a dedicated connector for analog airspeed sensor will default to 0"
default_value: "0"
field: adcFunctionChannel[ADC_AIRSPEED]
min: ADC_CHN_NONE
max: ADC_CHN_MAX
- name: PG_ACCELEROMETER_CONFIG
type: accelerometerConfig_t
headers: ["sensors/acceleration.h"]
members:
- name: acc_notch_hz
min: 0
max: 255
- name: acc_notch_cutoff
min: 1
max: 255
- name: align_acc
description: "When running on non-default hardware or adding support for new sensors/sensor boards, these values are used for sensor orientation. When carefully understood, these values can also be used to rotate (in 90deg steps) or flip the board. Possible values are: DEFAULT, CW0_DEG, CW90_DEG, CW180_DEG, CW270_DEG, CW0_DEG_FLIP, CW90_DEG_FLIP, CW180_DEG_FLIP, CW270_DEG_FLIP."
default_value: "DEFAULT"
field: acc_align
type: uint8_t
table: alignment
- name: acc_hardware
description: "Selection of acc hardware. See Wiki Sensor auto detect and hardware failure detection for more info"
default_value: "AUTO"
table: acc_hardware
- name: acc_lpf_hz
description: "Software-based filter to remove mechanical vibrations from the accelerometer measurements. Value is cutoff frequency (Hz). For larger frames with bigger props set to lower value."
default_value: "15"
min: 0
max: 200
- name: acc_lpf_type
description: "Specifies the type of the software LPF of the acc signals. BIQUAD gives better filtering and more delay, PT1 less filtering and less delay, so use only on clean builds."
default_value: "BIQUAD"
field: acc_soft_lpf_type
table: filter_type
- name: acczero_x
description: "Calculated value after '6 position avanced calibration'. See Wiki page."
default_value: "0"
field: accZero.raw[X]
min: INT16_MIN
max: INT16_MAX
- name: acczero_y
description: "Calculated value after '6 position avanced calibration'. See Wiki page."
default_value: "0"
field: accZero.raw[Y]
min: INT16_MIN
max: INT16_MAX
- name: acczero_z
description: "Calculated value after '6 position avanced calibration'. See Wiki page."
default_value: "0"
field: accZero.raw[Z]
min: INT16_MIN
max: INT16_MAX
- name: accgain_x
description: "Calculated value after '6 position avanced calibration'. Uncalibrated value is 4096. See Wiki page."
default_value: "4096"
field: accGain.raw[X]
min: 1
max: 8192
- name: accgain_y
description: "Calculated value after '6 position avanced calibration'. Uncalibrated value is 4096. See Wiki page."
default_value: "4096"
field: accGain.raw[Y]
min: 1
max: 8192
- name: accgain_z
description: "Calculated value after '6 position avanced calibration'. Uncalibrated value is 4096. See Wiki page."
default_value: "4096"
field: accGain.raw[Z]
min: 1
max: 8192
- name: PG_RANGEFINDER_CONFIG
type: rangefinderConfig_t
headers: ["sensors/rangefinder.h"]
condition: USE_RANGEFINDER
members:
- name: rangefinder_hardware
table: rangefinder_hardware
description: "Selection of rangefinder hardware."
default_value: "NONE"
- name: rangefinder_median_filter
description: "3-point median filtering for rangefinder readouts"
default_value: "OFF"
field: use_median_filtering
type: bool
- name: PG_OPFLOW_CONFIG
type: opticalFlowConfig_t
headers: ["sensors/opflow.h"]
condition: USE_OPFLOW
members:
- name: opflow_hardware
description: "Selection of OPFLOW hardware."
default: "NONE"
table: opflow_hardware
- name: opflow_scale
min: 0
max: 10000
- name: align_opflow
description: "Optical flow module alignment (default CW0_DEG_FLIP)"
default_value: "5"
field: opflow_align
type: uint8_t
table: alignment
- name: PG_COMPASS_CONFIG
type: compassConfig_t
headers: ["sensors/compass.h"]
condition: USE_MAG
members:
- name: align_mag
description: "When running on non-default hardware or adding support for new sensors/sensor boards, these values are used for sensor orientation. When carefully understood, these values can also be used to rotate (in 90deg steps) or flip the board. Possible values are: DEFAULT, CW0_DEG, CW90_DEG, CW180_DEG, CW270_DEG, CW0_DEG_FLIP, CW90_DEG_FLIP, CW180_DEG_FLIP, CW270_DEG_FLIP."
default_value: "DEFAULT"
field: mag_align
type: uint8_t
table: alignment
- name: mag_hardware
description: "Selection of mag hardware. See Wiki Sensor auto detect and hardware failure detection for more info"
default_value: "AUTO"
table: mag_hardware
- name: mag_declination
description: "Current location magnetic declination in format. For example, -6deg 37min = -637 for Japan. Leading zero in ddd not required. Get your local magnetic declination here: http://magnetic-declination.com/ . Not in use if inav_auto_mag_decl is turned on and you acquire valid GPS fix."
default_value: "0"
min: -18000
max: 18000
- name: magzero_x
description: "Magnetometer calibration X offset. If its 0 none offset has been applied and calibration is failed."
default_value: "0"
field: magZero.raw[X]
min: INT16_MIN
max: INT16_MAX
- name: magzero_y
description: "Magnetometer calibration Y offset. If its 0 none offset has been applied and calibration is failed."
default_value: "0"
field: magZero.raw[Y]
min: INT16_MIN
max: INT16_MAX
- name: magzero_z
description: "Magnetometer calibration Z offset. If its 0 none offset has been applied and calibration is failed."
default_value: "0"
field: magZero.raw[Z]
min: INT16_MIN
max: INT16_MAX
- name: mag_calibration_time
description: "Adjust how long time the Calibration of mag will last."
default_value: "30"
field: magCalibrationTimeLimit
min: 30
max: 120
- name: mag_to_use
description: "Allow to chose between built-in and external compass sensor if they are connected to separate buses. Currently only for REVO target"
condition: USE_DUAL_MAG
min: 0
max: 1
- name: align_mag_roll
description: "Set the external mag alignment on the roll axis (in 0.1 degree steps). If this value is non-zero, the compass is assumed to be externally mounted and both the board and on-board compass alignent (align_mag) are ignored. See also align_mag_pitch and align_mag_yaw."
default_value: "0"
field: rollDeciDegrees
min: -1800
max: 3600
- name: align_mag_pitch
description: "Same as align_mag_roll, but for the pitch axis."
default_value: "0"
field: pitchDeciDegrees
min: -1800
max: 3600
- name: align_mag_yaw
description: "Same as align_mag_roll, but for the yaw axis."
default_value: "0"
field: yawDeciDegrees
min: -1800
max: 3600
- name: PG_BAROMETER_CONFIG
type: barometerConfig_t
headers: ["sensors/barometer.h"]
condition: USE_BARO
members:
- name: baro_hardware
description: "Selection of baro hardware. See Wiki Sensor auto detect and hardware failure detection for more info"
default_value: "AUTO"
table: baro_hardware
- name: baro_median_filter
description: "3-point median filtering for barometer readouts. No reason to change this setting"
default_value: "ON"
field: use_median_filtering
type: bool
- name: baro_cal_tolerance
description: "Baro calibration tolerance in cm. The default should allow the noisiest baro to complete calibration [cm]."
default_value: "150"
field: baro_calibration_tolerance
min: 0
max: 1000
- name: PG_PITOTMETER_CONFIG
type: pitotmeterConfig_t
headers: ["sensors/pitotmeter.h"]
condition: USE_PITOT
members:
- name: pitot_hardware
description: "Selection of pitot hardware."
default_value: "NONE"
table: pitot_hardware
- name: pitot_lpf_milli_hz
min: 0
max: 10000
- name: pitot_scale
min: 0
max: 100
- name: PG_RX_CONFIG
type: rxConfig_t
headers: ["rx/rx.h", "rx/spektrum.h"]
members:
- name: receiver_type
description: "Selection of receiver (RX) type. Additional configuration of a `serialrx_provider` and a UART will be needed for `SERIAL`"
default_value: "`TARGET dependent`"
field: receiverType
table: receiver_type
- name: min_check
description: "These are min/max values (in us) which, when a channel is smaller (min) or larger (max) than the value will activate various RC commands, such as arming, or stick configuration. Normally, every RC channel should be set so that min = 1000us, max = 2000us. On most transmitters this usually means 125% endpoints. Default check values are 100us above/below this value."
default_value: "1100"
field: mincheck
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: max_check
description: "These are min/max values (in us) which, when a channel is smaller (min) or larger (max) than the value will activate various RC commands, such as arming, or stick configuration. Normally, every RC channel should be set so that min = 1000us, max = 2000us. On most transmitters this usually means 125% endpoints. Default check values are 100us above/below this value."
default_value: "1900"
field: maxcheck
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: rssi_source
description: "Source of RSSI input. Possible values: `NONE`, `AUTO`, `ADC`, `CHANNEL`, `PROTOCOL`, `MSP`"
default_value: "`AUTO`"
field: rssi_source
table: rssi_source
- name: rssi_channel
description: "RX channel containing the RSSI signal"
default_value: "0"
min: 0
max: MAX_SUPPORTED_RC_CHANNEL_COUNT
- name: rssi_min
description: "The minimum RSSI value sent by the receiver, in %. For example, if your receiver's minimum RSSI value shows as 42% in the configurator/OSD set this parameter to 42. See also rssi_max. Note that rssi_min can be set to a value bigger than rssi_max to invert the RSSI calculation (i.e. bigger values mean lower RSSI)."
default_value: "0"
field: rssiMin
min: RSSI_VISIBLE_VALUE_MIN
max: RSSI_VISIBLE_VALUE_MAX
- name: rssi_max
description: "The maximum RSSI value sent by the receiver, in %. For example, if your receiver's maximum RSSI value shows as 83% in the configurator/OSD set this parameter to 83. See also rssi_min."
default_value: "100"
field: rssiMax
min: RSSI_VISIBLE_VALUE_MIN
max: RSSI_VISIBLE_VALUE_MAX
- name: sbus_sync_interval
field: sbusSyncInterval
min: 500
max: 10000
- name: rc_filter_frequency
description: "RC data biquad filter cutoff frequency. Lower cutoff frequencies result in smoother response at expense of command control delay. Practical values are 20-50. Set to zero to disable entirely and use unsmoothed RC stick values"
default_value: "50"
field: rcFilterFrequency
min: 0
max: 100
- name: serialrx_provider
description: "When feature SERIALRX is enabled, this allows connection to several receivers which output data via digital interface resembling serial. See RX section."
default_value: "SPEK1024"
condition: USE_SERIAL_RX
table: serial_rx
- name: serialrx_inverted
description: "Reverse the serial inversion of the serial RX protocol. When this value is OFF, each protocol will use its default signal (e.g. SBUS will use an inverted signal). Some OpenLRS receivers produce a non-inverted SBUS signal. This setting supports this type of receivers (including modified FrSKY)."
default_value: "OFF"
condition: USE_SERIAL_RX
type: bool
- name: rx_spi_protocol
condition: USE_RX_SPI
table: rx_spi_protocol
- name: rx_spi_id
condition: USE_RX_SPI
min: 0
max: 0
- name: rx_spi_rf_channel_count
min: 0
max: 8
- name: spektrum_sat_bind
description: "0 = disabled. Used to bind the spektrum satellite to RX"
default_value: "0"
condition: USE_SPEKTRUM_BIND
min: SPEKTRUM_SAT_BIND_DISABLED
max: SPEKTRUM_SAT_BIND_MAX
- name: rx_min_usec
description: "Defines the shortest pulse width value used when ensuring the channel value is valid. If the receiver gives a pulse value lower than this value then the channel will be marked as bad and will default to the value of mid_rc."
default_value: "885"
min: PWM_PULSE_MIN
max: PWM_PULSE_MAX
- name: rx_max_usec
description: "Defines the longest pulse width value used when ensuring the channel value is valid. If the receiver gives a pulse value higher than this value then the channel will be marked as bad and will default to the value of mid_rc."
default_value: "2115"
min: PWM_PULSE_MIN
max: PWM_PULSE_MAX
- name: serialrx_halfduplex
description: "Allow serial receiver to operate on UART TX pin. With some receivers will allow control and telemetry over a single wire"
default_value: "OFF"
field: halfDuplex
type: bool
- name: msp_override_channels
description: "Mask of RX channels that may be overridden by MSP `SET_RAW_RC`. Note that this requires custom firmware with `USE_RX_MSP` and `USE_MSP_RC_OVERRIDE` compile options and the `MSP RC Override` flight mode."
default_value: "0"
field: mspOverrideChannels
condition: USE_MSP_RC_OVERRIDE
min: 0
max: 65535
- name: PG_BLACKBOX_CONFIG
type: blackboxConfig_t
headers: ["blackbox/blackbox.h"]
condition: USE_BLACKBOX
members:
- name: blackbox_rate_num
description: "Blackbox logging rate numerator. Use num/denom settings to decide if a frame should be logged, allowing control of the portion of logged loop iterations"
default_value: "1"
field: rate_num
min: 1
max: 65535
- name: blackbox_rate_denom
description: "Blackbox logging rate denominator. See blackbox_rate_num."
default_value: "1"
field: rate_denom
min: 1
max: 65535
- name: blackbox_device
description: "Selection of where to write blackbox data"
default_value: "SPIFLASH"
field: device
table: blackbox_device
- name: sdcard_detect_inverted
description: "This setting drives the way SD card is detected in card slot. On some targets (AnyFC F7 clone) different card slot was used and depending of hardware revision ON or OFF setting might be required. If card is not detected, change this value."
default_value: "`TARGET dependent`"
field: invertedCardDetection
condition: USE_SDCARD
type: bool
- name: PG_MOTOR_CONFIG
type: motorConfig_t
headers: ["flight/mixer.h"]
members:
- name: max_throttle
description: "This is the maximum value (in us) sent to esc when armed. Default of 1850 are OK for everyone (legacy). For modern ESCs, higher values (c. 2000) may be more appropriate. If you have brushed motors, the value should be set to 2000."
default_value: "1850"
field: maxthrottle
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: min_command
description: "This is the PWM value sent to ESCs when they are not armed. If ESCs beep slowly when powered up, try decreasing this value. It can also be used for calibrating all ESCs at once."
default_value: "1000"
field: mincommand
min: 0
max: PWM_RANGE_MAX
- name: motor_pwm_rate
description: "Output frequency (in Hz) for motor pins. Default is 400Hz for motor with motor_pwm_protocol set to STANDARD. For *SHOT (e.g. ONESHOT125) values of 1000 and 2000 have been tested by the development team and are supported. It may be possible to use higher values. For BRUSHED values of 8000 and above should be used. Setting to 8000 will use brushed mode at 8kHz switching frequency. Up to 32kHz is supported for brushed. Default is 16000 for boards with brushed motors. Note, that in brushed mode, minthrottle is offset to zero. For brushed mode, set max_throttle to 2000."
default_value: "400"
field: motorPwmRate
min: 50
max: 32000
- name: motor_accel_time
description: "Minimum time for the motor(s) to accelerate from 0 to 100% throttle (ms) [0-1000]"
default_value: "0"
field: motorAccelTimeMs
min: 0
max: 1000
- name: motor_decel_time
description: "Minimum time for the motor(s) to deccelerate from 100 to 0% throttle (ms) [0-1000]"
default_value: "0"
field: motorDecelTimeMs
min: 0
max: 1000
- name: motor_pwm_protocol
description: "Protocol that is used to send motor updates to ESCs. Possible values - STANDARD, ONESHOT125, ONESHOT42, MULTISHOT, DSHOT150, DSHOT300, DSHOT600, DSHOT1200, BRUSHED"
default_value: "STANDARD"
field: motorPwmProtocol
table: motor_pwm_protocol
- name: throttle_scale
description: "Throttle scaling factor. `1` means no throttle scaling. `0.5` means throttle scaled down by 50%"
default_value: "1.000"
field: throttleScale
min: 0
max: 1
- name: throttle_idle
description: "The percentage of the throttle range (`max_throttle` - `min_command`) above `min_command` used for minimum / idle throttle."
default_value: "15"
field: throttleIdle
min: 4
max: 30
- name: motor_poles
field: motorPoleCount
min: 4
max: 255
- name: PG_FAILSAFE_CONFIG
type: failsafeConfig_t
headers: ["flight/failsafe.h"]
members:
- name: failsafe_delay
description: "Time in deciseconds to wait before activating failsafe when signal is lost. See [Failsafe documentation](Failsafe.md#failsafe_delay)."
default_value: "5"
min: 0
max: 200
- name: failsafe_recovery_delay
description: "Time in deciseconds to wait before aborting failsafe when signal is recovered. See [Failsafe documentation](Failsafe.md#failsafe_recovery_delay)."
default_value: "5"
min: 0
max: 200
- name: failsafe_off_delay
description: "Time in deciseconds to wait before turning off motors when failsafe is activated. 0 = No timeout. See [Failsafe documentation](Failsafe.md#failsafe_off_delay)."
default_value: "200"
min: 0
max: 200
- name: failsafe_throttle
description: "Throttle level used for landing when failsafe is enabled. See [Failsafe documentation](Failsafe.md#failsafe_throttle)."
default_value: "1000"
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: failsafe_throttle_low_delay
description: "If failsafe activated when throttle is low for this much time - bypass failsafe and disarm, in 10th of seconds. 0 = No timeout"
default_value: "100"
min: 0
max: 300
- name: failsafe_procedure
description: "What failsafe procedure to initiate in Stage 2. See [Failsafe documentation](Failsafe.md#failsafe_throttle)."
default_value: "SET-THR"
table: failsafe_procedure
- name: failsafe_stick_threshold
description: "Threshold for stick motion to consider failsafe condition resolved. If non-zero failsafe won't clear even if RC link is restored - you have to move sticks to exit failsafe."
default_value: "50"
field: failsafe_stick_motion_threshold
min: 0
max: 500
- name: failsafe_fw_roll_angle
description: "Amount of banking when `SET-THR` failsafe is active on a fixed-wing machine. In 1/10 deg (deci-degrees). Negative values = left roll"
default_value: "-200"
min: -800
max: 800
- name: failsafe_fw_pitch_angle
description: "Amount of dive/climb when `SET-THR` failsafe is active on a fixed-wing machine. In 1/10 deg (deci-degrees). Negative values = climb"
default_value: "100"
min: -800
max: 800
- name: failsafe_fw_yaw_rate
description: "Requested yaw rate to execute when `SET-THR` failsafe is active on a fixed-wing machine. In deg/s. Negative values = left turn"
default_value: "-45"
min: -1000
max: 1000
- name: failsafe_min_distance
description: "If failsafe happens when craft is closer than this distance in centimeters from home, failsafe will not execute regular failsafe_procedure, but will execute procedure specified in failsafe_min_distance_procedure instead. 0 = Normal failsafe_procedure always taken."
default_value: "0"
min: 0
max: 65000
- name: failsafe_min_distance_procedure
description: "What failsafe procedure to initiate in Stage 2 when craft is closer to home than failsafe_min_distance. See [Failsafe documentation](Failsafe.md#failsafe_throttle)."
default_value: "DROP"
table: failsafe_procedure
- name: failsafe_mission
description: "If set to `OFF` the failsafe procedure won't be triggered and the mission will continue if the FC is in WP (automatic mission) mode"
default_value: "ON"
type: bool
- name: PG_LIGHTS_CONFIG
type: lightsConfig_t
headers: ["io/lights.h"]
condition: USE_LIGHTS
members:
- name: failsafe_lights
description: "Enable or disable the lights when the `FAILSAFE` flight mode is enabled. The target needs to be compiled with `USE_LIGHTS` [ON/OFF]."
default_value: "ON"
field: failsafe.enabled
type: bool
- name: failsafe_lights_flash_period
description: "Time in milliseconds between two flashes when `failsafe_lights` is ON and `FAILSAFE` flight mode is enabled [40-65535]."
default_value: "1000"
field: failsafe.flash_period
min: 40
max: 65535
- name: failsafe_lights_flash_on_time
description: "Flash lights ON time in milliseconds when `failsafe_lights` is ON and `FAILSAFE` flight mode is enabled. [20-65535]."
default_value: "100"
field: failsafe.flash_on_time
min: 20
max: 65535
- name: PG_BOARD_ALIGNMENT
type: boardAlignment_t
headers: ["sensors/boardalignment.h"]
members:
- name: align_board_roll
description: "Arbitrary board rotation in deci-degrees (0.1 degree), to allow mounting it sideways / upside down / rotated etc"
default_value: "0"
field: rollDeciDegrees
min: -1800
max: 3600
- name: align_board_pitch
description: "Arbitrary board rotation in deci-degrees (0.1 degree), to allow mounting it sideways / upside down / rotated etc"
default_value: "0"
field: pitchDeciDegrees
min: -1800
max: 3600
- name: align_board_yaw
description: "Arbitrary board rotation in deci-degrees (0.1 degree), to allow mounting it sideways / upside down / rotated etc"
default_value: "0"
field: yawDeciDegrees
min: -1800
max: 3600
- name: PG_BATTERY_METERS_CONFIG
type: batteryMetersConfig_t
headers: ["sensors/battery.h"]
members:
- name: vbat_meter_type
description: "Vbat voltage source. Possible values: `NONE`, `ADC`, `ESC`. `ESC` required ESC telemetry enebled and running"
default_value: "`ADC`"
field: voltage.type
table: voltage_sensor
type: uint8_t
- name: vbat_scale
description: "Battery voltage calibration value. 1100 = 11:1 voltage divider (10k:1k) x 100. Adjust this slightly if reported pack voltage is different from multimeter reading. You can get current voltage by typing \"status\" in cli."
default_value: "1100"
field: voltage.scale
condition: USE_ADC
min: VBAT_SCALE_MIN
max: VBAT_SCALE_MAX
- name: current_meter_scale
description: "This sets the output voltage to current scaling for the current sensor in 0.1 mV/A steps. 400 is 40mV/A such as the ACS756 sensor outputs. 183 is the setting for the uberdistro with a 0.25mOhm shunt."
default_value: "400"
field: current.scale
min: -10000
max: 10000
- name: current_meter_offset
description: "This sets the output offset voltage of the current sensor in millivolts."
default_value: "0"
field: current.offset
min: -32768
max: 32767
- name: current_meter_type
description: "ADC , VIRTUAL, NONE. The virtual current sensor, once calibrated, estimates the current value from throttle position."
default_value: "ADC"
field: current.type
table: current_sensor
type: uint8_t
- name: bat_voltage_src
description: "Chose between raw and sag compensated battery voltage to use for battery alarms and telemetry. Possible values are `RAW` and `SAG_COMP`"
default_value: "RAW"
field: voltageSource
table: bat_voltage_source
type: uint8_t
- name: cruise_power
description: "Power draw at cruise throttle used for remaining flight time/distance estimation in 0.01W unit"
default_value: "0"
field: cruise_power
min: 0
max: 4294967295
- name: idle_power
description: "Power draw at zero throttle used for remaining flight time/distance estimation in 0.01W unit"
default_value: "0"
field: idle_power
min: 0
max: 65535
- name: rth_energy_margin
description: "Energy margin wanted after getting home (percent of battery energy capacity). Use for the remaining flight time/distance calculation"
default_value: "5"
min: 0
max: 100
- name: thr_comp_weight
description: "Weight used for the throttle compensation based on battery voltage. See the [battery documentation](Battery.md#automatic-throttle-compensation-based-on-battery-voltage)"
default_value: "0.692"
field: throttle_compensation_weight
min: 0
max: 2
- name: PG_BATTERY_PROFILES
type: batteryProfile_t
headers: ["sensors/battery.h"]
value_type: BATTERY_CONFIG_VALUE
members:
- name: bat_cells
description: "Number of cells of the battery (0 = autodetect), see battery documentation"
default_value: "0"
field: cells
condition: USE_ADC
min: 0
max: 8
- name: vbat_cell_detect_voltage
description: "Maximum voltage per cell, used for auto-detecting the number of cells of the battery in 0.01V units, default is 4.30V"
default_value: "430"
field: voltage.cellDetect
condition: USE_ADC
min: 100
max: 500
- name: vbat_max_cell_voltage
description: "Maximum voltage per cell in 0.01V units, default is 4.20V"
default_value: "420"
field: voltage.cellMax
condition: USE_ADC
min: 100
max: 500
- name: vbat_min_cell_voltage
description: "Minimum voltage per cell, this triggers battery out alarms, in 0.01V units, default is 330 (3.3V)"
default_value: "330"
field: voltage.cellMin
condition: USE_ADC
min: 100
max: 500
- name: vbat_warning_cell_voltage
description: "Warning voltage per cell, this triggers battery-warning alarms, in 0.01V units, default is 350 (3.5V)"
default_value: "350"
field: voltage.cellWarning
condition: USE_ADC
min: 100
max: 500
- name: battery_capacity
description: "Set the battery capacity in mAh or mWh (see `battery_capacity_unit`). Used to calculate the remaining battery capacity."
default_value: "0"
field: capacity.value
min: 0
max: 4294967295
- name: battery_capacity_warning
description: "If the remaining battery capacity goes below this threshold the beeper will emit short beeps and the relevant OSD items will blink."
default_value: "0"
field: capacity.warning
min: 0
max: 4294967295
- name: battery_capacity_critical
description: "If the remaining battery capacity goes below this threshold the battery is considered empty and the beeper will emit long beeps."
default_value: "0"
field: capacity.critical
min: 0
max: 4294967295
- name: battery_capacity_unit
description: "Unit used for `battery_capacity`, `battery_capacity_warning` and `battery_capacity_critical` [MAH/MWH] (milliAmpere hour / milliWatt hour)."
default_value: "MAH"
field: capacity.unit
table: bat_capacity_unit
type: uint8_t
- name: PG_MIXER_CONFIG
type: mixerConfig_t
members:
- name: motor_direction_inverted
description: "Use if you need to inverse yaw motor direction."
default_value: "OFF"
field: motorDirectionInverted
type: bool
- name: platform_type
description: "Defines UAV platform type. Allowed values: \"MULTIROTOR\", \"AIRPLANE\", \"HELICOPTER\", \"TRICOPTER\", \"ROVER\", \"BOAT\". Currently only MULTIROTOR, AIRPLANE and TRICOPTER types are implemented"
default_value: "\"MULTIROTOR\""
field: platformType
type: uint8_t
table: platform_type
- name: has_flaps
description: "Defines is UAV is capable of having flaps. If ON and AIRPLANE `platform_type` is used, **FLAPERON** flight mode will be available for the pilot"
default_value: "OFF"
field: hasFlaps
type: bool
- name: model_preview_type
description: "ID of mixer preset applied in a Configurator. **Do not modify manually**. Used only for backup/restore reasons."
default_value: "-1"
field: appliedMixerPreset
min: -1
max: INT16_MAX
- name: fw_min_throttle_down_pitch
description: "Automatic pitch down angle when throttle is at 0 in angle mode. Progressively applied between cruise throttle and zero throttle (decidegrees)"
default_value: "0"
field: fwMinThrottleDownPitchAngle
min: 0
max: 450
- name: PG_REVERSIBLE_MOTORS_CONFIG
type: reversibleMotorsConfig_t
members:
- name: 3d_deadband_low
description: "Low value of throttle deadband for 3D mode (when stick is in the 3d_deadband_throttle range, the fixed values of 3d_deadband_low / _high are used instead)"
default_value: "1406"
field: deadband_low
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: 3d_deadband_high
description: "High value of throttle deadband for 3D mode (when stick is in the deadband range, the value in 3d_neutral is used instead)"
default_value: "1514"
field: deadband_high
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: 3d_neutral
description: "Neutral (stop) throttle value for 3D mode"
default_value: "1460"
field: neutral
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: PG_SERVO_CONFIG
type: servoConfig_t
headers: ["flight/servos.h"]
members:
- name: servo_protocol
description: "An option to chose the protocol/option that would be used to output servo data. Possible options `PWM` (FC servo outputs), `SERVO_DRIVER` (I2C PCA9685 peripheral), `SBUS` (S.Bus protocol output via a configured serial port)"
default_value: "PWM"
field: servo_protocol
table: servo_protocol
- name: servo_center_pulse
description: "Servo midpoint"
default_value: "1500"
field: servoCenterPulse
min: PWM_RANGE_MIN
max: PWM_RANGE_MAX
- name: servo_pwm_rate
description: "Output frequency (in Hz) servo pins. When using tricopters or gimbal with digital servo, this rate can be increased. Max of 498Hz (for 500Hz pwm period), and min of 50Hz. Most digital servos will support for example 330Hz."
default_value: "50"
field: servoPwmRate
min: 50
max: 498
- name: servo_lpf_hz
description: "Selects the servo PWM output cutoff frequency. Value is in [Hz]"
default_value: "20"