2 * This file is part of Cleanflight and Betaflight.
4 * Cleanflight and Betaflight are free software. You can redistribute
5 * this software and/or modify this software under the terms of the
6 * GNU General Public License as published by the Free Software
7 * Foundation, either version 3 of the License, or (at your option)
10 * Cleanflight and Betaflight are distributed in the hope that they
11 * will be useful, but WITHOUT ANY WARRANTY; without even the implied
12 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 * See the GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this software.
18 * If not, see <http://www.gnu.org/licenses/>.
31 #include "blackbox/blackbox.h"
32 #include "blackbox/blackbox_io.h"
34 #include "build/build_config.h"
35 #include "build/debug.h"
36 #include "build/version.h"
40 #include "common/axis.h"
41 #include "common/bitarray.h"
42 #include "common/color.h"
43 #include "common/huffman.h"
44 #include "common/maths.h"
45 #include "common/streambuf.h"
46 #include "common/utils.h"
48 #include "config/config.h"
49 #include "config/config_eeprom.h"
50 #include "config/feature.h"
51 #include "config/simplified_tuning.h"
53 #include "drivers/accgyro/accgyro.h"
54 #include "drivers/bus_i2c.h"
55 #include "drivers/bus_spi.h"
56 #include "drivers/camera_control.h"
57 #include "drivers/compass/compass.h"
58 #include "drivers/display.h"
59 #include "drivers/dshot.h"
60 #include "drivers/dshot_command.h"
61 #include "drivers/flash.h"
62 #include "drivers/io.h"
63 #include "drivers/motor.h"
64 #include "drivers/osd.h"
65 #include "drivers/pwm_output.h"
66 #include "drivers/sdcard.h"
67 #include "drivers/serial.h"
68 #include "drivers/serial_escserial.h"
69 #include "drivers/system.h"
70 #include "drivers/transponder_ir.h"
71 #include "drivers/usb_msc.h"
72 #include "drivers/vtx_common.h"
73 #include "drivers/vtx_table.h"
75 #include "fc/board_info.h"
76 #include "fc/controlrate_profile.h"
78 #include "fc/dispatch.h"
80 #include "fc/rc_adjustments.h"
81 #include "fc/rc_controls.h"
82 #include "fc/rc_modes.h"
83 #include "fc/runtime_config.h"
85 #include "flight/failsafe.h"
86 #include "flight/gps_rescue.h"
87 #include "flight/imu.h"
88 #include "flight/mixer.h"
89 #include "flight/pid.h"
90 #include "flight/pid_init.h"
91 #include "flight/position.h"
92 #include "flight/rpm_filter.h"
93 #include "flight/servos.h"
95 #include "io/asyncfatfs/asyncfatfs.h"
96 #include "io/beeper.h"
97 #include "io/flashfs.h"
98 #include "io/gimbal.h"
100 #include "io/ledstrip.h"
101 #include "io/serial.h"
102 #include "io/serial_4way.h"
103 #include "io/servos.h"
104 #include "io/transponder_ir.h"
105 #include "io/usb_msc.h"
106 #include "io/vtx_control.h"
109 #include "msp/msp_box.h"
110 #include "msp/msp_protocol.h"
111 #include "msp/msp_protocol_v2_betaflight.h"
112 #include "msp/msp_protocol_v2_common.h"
113 #include "msp/msp_serial.h"
116 #include "osd/osd_elements.h"
117 #include "osd/osd_warnings.h"
119 #include "pg/beeper.h"
120 #include "pg/board.h"
121 #include "pg/dyn_notch.h"
122 #include "pg/gyrodev.h"
123 #include "pg/motor.h"
125 #include "pg/rx_spi.h"
128 #include "pg/vtx_table.h"
131 #include "rx/rx_bind.h"
134 #include "scheduler/scheduler.h"
136 #include "sensors/acceleration.h"
137 #include "sensors/barometer.h"
138 #include "sensors/battery.h"
139 #include "sensors/boardalignment.h"
140 #include "sensors/compass.h"
141 #include "sensors/esc_sensor.h"
142 #include "sensors/gyro.h"
143 #include "sensors/gyro_init.h"
144 #include "sensors/rangefinder.h"
146 #include "telemetry/msp_shared.h"
147 #include "telemetry/telemetry.h"
149 #ifdef USE_HARDWARE_REVISION_DETECTION
150 #include "hardware_revision.h"
156 static const char * const flightControllerIdentifier
= FC_FIRMWARE_IDENTIFIER
; // 4 UPPER CASE alpha numeric characters that identify the flight controller.
159 MSP_REBOOT_FIRMWARE
= 0,
160 MSP_REBOOT_BOOTLOADER_ROM
,
163 MSP_REBOOT_BOOTLOADER_FLASH
,
167 static uint8_t rebootMode
;
170 MSP_SDCARD_STATE_NOT_PRESENT
= 0,
171 MSP_SDCARD_STATE_FATAL
= 1,
172 MSP_SDCARD_STATE_CARD_INIT
= 2,
173 MSP_SDCARD_STATE_FS_INIT
= 3,
174 MSP_SDCARD_STATE_READY
= 4
178 MSP_SDCARD_FLAG_SUPPORTED
= 1
182 MSP_FLASHFS_FLAG_READY
= 1,
183 MSP_FLASHFS_FLAG_SUPPORTED
= 2
187 MSP_PASSTHROUGH_ESC_SIMONK
= PROTOCOL_SIMONK
,
188 MSP_PASSTHROUGH_ESC_BLHELI
= PROTOCOL_BLHELI
,
189 MSP_PASSTHROUGH_ESC_KISS
= PROTOCOL_KISS
,
190 MSP_PASSTHROUGH_ESC_KISSALL
= PROTOCOL_KISSALL
,
191 MSP_PASSTHROUGH_ESC_CASTLE
= PROTOCOL_CASTLE
,
193 MSP_PASSTHROUGH_SERIAL_ID
= 0xFD,
194 MSP_PASSTHROUGH_SERIAL_FUNCTION_ID
= 0xFE,
196 MSP_PASSTHROUGH_ESC_4WAY
= 0xFF,
197 } mspPassthroughType_e
;
199 #define RATEPROFILE_MASK (1 << 7)
201 #define RTC_NOT_SUPPORTED 0xff
204 DEFAULTS_TYPE_BASE
= 0,
205 DEFAULTS_TYPE_CUSTOM
,
209 static bool vtxTableNeedsInit
= false;
212 static int mspDescriptor
= 0;
214 mspDescriptor_t
mspDescriptorAlloc(void)
216 return (mspDescriptor_t
)mspDescriptor
++;
219 static uint32_t mspArmingDisableFlags
= 0;
221 static void mspArmingDisableByDescriptor(mspDescriptor_t desc
)
223 mspArmingDisableFlags
|= (1 << desc
);
226 static void mspArmingEnableByDescriptor(mspDescriptor_t desc
)
228 mspArmingDisableFlags
&= ~(1 << desc
);
231 static bool mspIsMspArmingEnabled(void)
233 return mspArmingDisableFlags
== 0;
236 #define MSP_PASSTHROUGH_ESC_4WAY 0xff
238 static uint8_t mspPassthroughMode
;
239 static uint8_t mspPassthroughArgument
;
242 static void mspEscPassthroughFn(serialPort_t
*serialPort
)
244 escEnablePassthrough(serialPort
, &motorConfig()->dev
, mspPassthroughArgument
, mspPassthroughMode
);
248 static serialPort_t
*mspFindPassthroughSerialPort(void)
250 serialPortUsage_t
*portUsage
= NULL
;
252 switch (mspPassthroughMode
) {
253 case MSP_PASSTHROUGH_SERIAL_ID
:
255 portUsage
= findSerialPortUsageByIdentifier(mspPassthroughArgument
);
258 case MSP_PASSTHROUGH_SERIAL_FUNCTION_ID
:
260 const serialPortConfig_t
*portConfig
= findSerialPortConfig(1 << mspPassthroughArgument
);
262 portUsage
= findSerialPortUsageByIdentifier(portConfig
->identifier
);
267 return portUsage
? portUsage
->serialPort
: NULL
;
270 static void mspSerialPassthroughFn(serialPort_t
*serialPort
)
272 serialPort_t
*passthroughPort
= mspFindPassthroughSerialPort();
273 if (passthroughPort
&& serialPort
) {
274 serialPassthrough(passthroughPort
, serialPort
, NULL
, NULL
);
278 static void mspFcSetPassthroughCommand(sbuf_t
*dst
, sbuf_t
*src
, mspPostProcessFnPtr
*mspPostProcessFn
)
280 const unsigned int dataSize
= sbufBytesRemaining(src
);
283 mspPassthroughMode
= MSP_PASSTHROUGH_ESC_4WAY
;
285 mspPassthroughMode
= sbufReadU8(src
);
286 mspPassthroughArgument
= sbufReadU8(src
);
289 switch (mspPassthroughMode
) {
290 case MSP_PASSTHROUGH_SERIAL_ID
:
291 case MSP_PASSTHROUGH_SERIAL_FUNCTION_ID
:
292 if (mspFindPassthroughSerialPort()) {
293 if (mspPostProcessFn
) {
294 *mspPostProcessFn
= mspSerialPassthroughFn
;
301 #ifdef USE_SERIAL_4WAY_BLHELI_INTERFACE
302 case MSP_PASSTHROUGH_ESC_4WAY
:
303 // get channel number
304 // switch all motor lines HI
305 // reply with the count of ESC found
306 sbufWriteU8(dst
, esc4wayInit());
308 if (mspPostProcessFn
) {
309 *mspPostProcessFn
= esc4wayProcess
;
314 case MSP_PASSTHROUGH_ESC_SIMONK
:
315 case MSP_PASSTHROUGH_ESC_BLHELI
:
316 case MSP_PASSTHROUGH_ESC_KISS
:
317 case MSP_PASSTHROUGH_ESC_KISSALL
:
318 case MSP_PASSTHROUGH_ESC_CASTLE
:
319 if (mspPassthroughArgument
< getMotorCount() || (mspPassthroughMode
== MSP_PASSTHROUGH_ESC_KISS
&& mspPassthroughArgument
== ALL_MOTORS
)) {
322 if (mspPostProcessFn
) {
323 *mspPostProcessFn
= mspEscPassthroughFn
;
329 #endif // USE_ESCSERIAL
330 #endif //USE_SERIAL_4WAY_BLHELI_INTERFACE
336 // TODO: Remove the pragma once this is called from unconditional code
337 #pragma GCC diagnostic ignored "-Wunused-function"
338 static void configRebootUpdateCheckU8(uint8_t *parm
, uint8_t value
)
340 if (*parm
!= value
) {
345 #pragma GCC diagnostic pop
347 static void mspRebootFn(serialPort_t
*serialPort
)
353 switch (rebootMode
) {
354 case MSP_REBOOT_FIRMWARE
:
358 case MSP_REBOOT_BOOTLOADER_ROM
:
359 systemResetToBootloader(BOOTLOADER_REQUEST_ROM
);
362 #if defined(USE_USB_MSC)
364 case MSP_REBOOT_MSC_UTC
: {
366 const int16_t timezoneOffsetMinutes
= (rebootMode
== MSP_REBOOT_MSC
) ? timeConfig()->tz_offsetMinutes
: 0;
367 systemResetToMsc(timezoneOffsetMinutes
);
374 #if defined(USE_FLASH_BOOT_LOADER)
375 case MSP_REBOOT_BOOTLOADER_FLASH
:
376 systemResetToBootloader(BOOTLOADER_REQUEST_FLASH
);
385 // control should never return here.
389 #define MSP_DISPATCH_DELAY_US 1000000
391 void mspReboot(dispatchEntry_t
* self
)
395 if (ARMING_FLAG(ARMED
)) {
402 dispatchEntry_t mspRebootEntry
=
404 mspReboot
, 0, NULL
, false
407 void writeReadEeprom(dispatchEntry_t
* self
)
411 if (ARMING_FLAG(ARMED
)) {
419 if (vtxTableNeedsInit
) {
420 vtxTableNeedsInit
= false;
421 vtxTableInit(); // Reinitialize and refresh the in-memory copies
426 dispatchEntry_t writeReadEepromEntry
=
428 writeReadEeprom
, 0, NULL
, false
431 static void serializeSDCardSummaryReply(sbuf_t
*dst
)
435 uint8_t lastError
= 0;
436 uint32_t freeSpace
= 0;
437 uint32_t totalSpace
= 0;
439 #if defined(USE_SDCARD)
440 if (sdcardConfig()->mode
!= SDCARD_MODE_NONE
) {
441 flags
= MSP_SDCARD_FLAG_SUPPORTED
;
443 // Merge the card and filesystem states together
444 if (!sdcard_isInserted()) {
445 state
= MSP_SDCARD_STATE_NOT_PRESENT
;
446 } else if (!sdcard_isFunctional()) {
447 state
= MSP_SDCARD_STATE_FATAL
;
449 switch (afatfs_getFilesystemState()) {
450 case AFATFS_FILESYSTEM_STATE_READY
:
451 state
= MSP_SDCARD_STATE_READY
;
454 case AFATFS_FILESYSTEM_STATE_INITIALIZATION
:
455 if (sdcard_isInitialized()) {
456 state
= MSP_SDCARD_STATE_FS_INIT
;
458 state
= MSP_SDCARD_STATE_CARD_INIT
;
462 case AFATFS_FILESYSTEM_STATE_FATAL
:
463 case AFATFS_FILESYSTEM_STATE_UNKNOWN
:
465 state
= MSP_SDCARD_STATE_FATAL
;
470 lastError
= afatfs_getLastError();
471 // Write free space and total space in kilobytes
472 if (state
== MSP_SDCARD_STATE_READY
) {
473 freeSpace
= afatfs_getContiguousFreeSpace() / 1024;
474 totalSpace
= sdcard_getMetadata()->numBlocks
/ 2;
479 sbufWriteU8(dst
, flags
);
480 sbufWriteU8(dst
, state
);
481 sbufWriteU8(dst
, lastError
);
482 sbufWriteU32(dst
, freeSpace
);
483 sbufWriteU32(dst
, totalSpace
);
486 static void serializeDataflashSummaryReply(sbuf_t
*dst
)
489 if (flashfsIsSupported()) {
490 uint8_t flags
= MSP_FLASHFS_FLAG_SUPPORTED
;
491 flags
|= (flashfsIsReady() ? MSP_FLASHFS_FLAG_READY
: 0);
493 const flashPartition_t
*flashPartition
= flashPartitionFindByType(FLASH_PARTITION_TYPE_FLASHFS
);
495 sbufWriteU8(dst
, flags
);
496 sbufWriteU32(dst
, FLASH_PARTITION_SECTOR_COUNT(flashPartition
));
497 sbufWriteU32(dst
, flashfsGetSize());
498 sbufWriteU32(dst
, flashfsGetOffset()); // Effectively the current number of bytes stored on the volume
502 // FlashFS is not configured or valid device is not detected
505 sbufWriteU32(dst
, 0);
506 sbufWriteU32(dst
, 0);
507 sbufWriteU32(dst
, 0);
512 enum compressionType_e
{
517 static void serializeDataflashReadReply(sbuf_t
*dst
, uint32_t address
, const uint16_t size
, bool useLegacyFormat
, bool allowCompression
)
519 STATIC_ASSERT(MSP_PORT_DATAFLASH_INFO_SIZE
>= 16, MSP_PORT_DATAFLASH_INFO_SIZE_invalid
);
521 uint16_t readLen
= size
;
522 const int bytesRemainingInBuf
= sbufBytesRemaining(dst
) - MSP_PORT_DATAFLASH_INFO_SIZE
;
523 if (readLen
> bytesRemainingInBuf
) {
524 readLen
= bytesRemainingInBuf
;
526 // size will be lower than that requested if we reach end of volume
527 const uint32_t flashfsSize
= flashfsGetSize();
528 if (readLen
> flashfsSize
- address
) {
529 // truncate the request
530 readLen
= flashfsSize
- address
;
532 sbufWriteU32(dst
, address
);
534 // legacy format does not support compression
536 const uint8_t compressionMethod
= (!allowCompression
|| useLegacyFormat
) ? NO_COMPRESSION
: HUFFMAN
;
538 const uint8_t compressionMethod
= NO_COMPRESSION
;
539 UNUSED(allowCompression
);
542 if (compressionMethod
== NO_COMPRESSION
) {
544 uint16_t *readLenPtr
= (uint16_t *)sbufPtr(dst
);
545 if (!useLegacyFormat
) {
546 // new format supports variable read lengths
547 sbufWriteU16(dst
, readLen
);
548 sbufWriteU8(dst
, 0); // placeholder for compression format
551 const int bytesRead
= flashfsReadAbs(address
, sbufPtr(dst
), readLen
);
553 if (!useLegacyFormat
) {
554 // update the 'read length' with the actual amount read from flash.
555 *readLenPtr
= bytesRead
;
558 sbufAdvance(dst
, bytesRead
);
560 if (useLegacyFormat
) {
561 // pad the buffer with zeros
562 for (int i
= bytesRead
; i
< size
; i
++) {
568 // compress in 256-byte chunks
569 const uint16_t READ_BUFFER_SIZE
= 256;
570 // This may be DMAable, so make it cache aligned
571 __attribute__ ((aligned(32))) uint8_t readBuffer
[READ_BUFFER_SIZE
];
573 huffmanState_t state
= {
575 .outByte
= sbufPtr(dst
) + sizeof(uint16_t) + sizeof(uint8_t) + HUFFMAN_INFO_SIZE
,
576 .outBufLen
= readLen
,
581 uint16_t bytesReadTotal
= 0;
582 // read until output buffer overflows or flash is exhausted
583 while (state
.bytesWritten
< state
.outBufLen
&& address
+ bytesReadTotal
< flashfsSize
) {
584 const int bytesRead
= flashfsReadAbs(address
+ bytesReadTotal
, readBuffer
,
585 MIN(sizeof(readBuffer
), flashfsSize
- address
- bytesReadTotal
));
587 const int status
= huffmanEncodeBufStreaming(&state
, readBuffer
, bytesRead
, huffmanTable
);
593 bytesReadTotal
+= bytesRead
;
596 if (state
.outBit
!= 0x80) {
597 ++state
.bytesWritten
;
601 sbufWriteU16(dst
, HUFFMAN_INFO_SIZE
+ state
.bytesWritten
);
602 sbufWriteU8(dst
, compressionMethod
);
604 sbufWriteU16(dst
, bytesReadTotal
);
605 sbufAdvance(dst
, state
.bytesWritten
);
609 #endif // USE_FLASHFS
612 * Returns true if the command was processd, false otherwise.
613 * May set mspPostProcessFunc to a function to be called once the command has been processed
615 static bool mspCommonProcessOutCommand(int16_t cmdMSP
, sbuf_t
*dst
, mspPostProcessFnPtr
*mspPostProcessFn
)
617 UNUSED(mspPostProcessFn
);
620 case MSP_API_VERSION
:
621 sbufWriteU8(dst
, MSP_PROTOCOL_VERSION
);
622 sbufWriteU8(dst
, API_VERSION_MAJOR
);
623 sbufWriteU8(dst
, API_VERSION_MINOR
);
627 sbufWriteData(dst
, flightControllerIdentifier
, FLIGHT_CONTROLLER_IDENTIFIER_LENGTH
);
631 sbufWriteU8(dst
, FC_VERSION_MAJOR
);
632 sbufWriteU8(dst
, FC_VERSION_MINOR
);
633 sbufWriteU8(dst
, FC_VERSION_PATCH_LEVEL
);
638 sbufWriteData(dst
, systemConfig()->boardIdentifier
, BOARD_IDENTIFIER_LENGTH
);
639 #ifdef USE_HARDWARE_REVISION_DETECTION
640 sbufWriteU16(dst
, hardwareRevision
);
642 sbufWriteU16(dst
, 0); // No other build targets currently have hardware revision detection.
644 #if defined(USE_MAX7456)
645 sbufWriteU8(dst
, 2); // 2 == FC with MAX7456
647 sbufWriteU8(dst
, 0); // 0 == FC
650 // Target capabilities (uint8)
651 #define TARGET_HAS_VCP 0
652 #define TARGET_HAS_SOFTSERIAL 1
653 #define TARGET_IS_UNIFIED 2
654 #define TARGET_HAS_FLASH_BOOTLOADER 3
655 #define TARGET_SUPPORTS_CUSTOM_DEFAULTS 4
656 #define TARGET_HAS_CUSTOM_DEFAULTS 5
657 #define TARGET_SUPPORTS_RX_BIND 6
659 uint8_t targetCapabilities
= 0;
661 targetCapabilities
|= BIT(TARGET_HAS_VCP
);
663 #if defined(USE_SOFTSERIAL1) || defined(USE_SOFTSERIAL2)
664 targetCapabilities
|= BIT(TARGET_HAS_SOFTSERIAL
);
666 #if defined(USE_UNIFIED_TARGET)
667 targetCapabilities
|= BIT(TARGET_IS_UNIFIED
);
669 #if defined(USE_FLASH_BOOT_LOADER)
670 targetCapabilities
|= BIT(TARGET_HAS_FLASH_BOOTLOADER
);
672 #if defined(USE_CUSTOM_DEFAULTS)
673 targetCapabilities
|= BIT(TARGET_SUPPORTS_CUSTOM_DEFAULTS
);
674 if (hasCustomDefaults()) {
675 targetCapabilities
|= BIT(TARGET_HAS_CUSTOM_DEFAULTS
);
678 #if defined(USE_RX_BIND)
679 if (getRxBindSupported()) {
680 targetCapabilities
|= BIT(TARGET_SUPPORTS_RX_BIND
);
684 sbufWriteU8(dst
, targetCapabilities
);
686 // Target name with explicit length
687 sbufWriteU8(dst
, strlen(targetName
));
688 sbufWriteData(dst
, targetName
, strlen(targetName
));
690 #if defined(USE_BOARD_INFO)
691 // Board name with explicit length
692 char *value
= getBoardName();
693 sbufWriteU8(dst
, strlen(value
));
694 sbufWriteString(dst
, value
);
696 // Manufacturer id with explicit length
697 value
= getManufacturerId();
698 sbufWriteU8(dst
, strlen(value
));
699 sbufWriteString(dst
, value
);
705 #if defined(USE_SIGNATURE)
707 sbufWriteData(dst
, getSignature(), SIGNATURE_LENGTH
);
709 uint8_t emptySignature
[SIGNATURE_LENGTH
];
710 memset(emptySignature
, 0, sizeof(emptySignature
));
711 sbufWriteData(dst
, &emptySignature
, sizeof(emptySignature
));
714 sbufWriteU8(dst
, getMcuTypeId());
716 // Added in API version 1.42
717 sbufWriteU8(dst
, systemConfig()->configurationState
);
719 // Added in API version 1.43
720 sbufWriteU16(dst
, gyro
.sampleRateHz
); // informational so the configurator can display the correct gyro/pid frequencies in the drop-down
722 // Configuration warnings / problems (uint32_t)
723 #define PROBLEM_ACC_NEEDS_CALIBRATION 0
724 #define PROBLEM_MOTOR_PROTOCOL_DISABLED 1
726 uint32_t configurationProblems
= 0;
729 if (!accHasBeenCalibrated()) {
730 configurationProblems
|= BIT(PROBLEM_ACC_NEEDS_CALIBRATION
);
734 if (!checkMotorProtocolEnabled(&motorConfig()->dev
, NULL
)) {
735 configurationProblems
|= BIT(PROBLEM_MOTOR_PROTOCOL_DISABLED
);
738 sbufWriteU32(dst
, configurationProblems
);
740 // Added in MSP API 1.44
742 sbufWriteU8(dst
, spiGetRegisteredDeviceCount());
747 sbufWriteU8(dst
, i2cGetRegisteredDeviceCount());
756 sbufWriteData(dst
, buildDate
, BUILD_DATE_LENGTH
);
757 sbufWriteData(dst
, buildTime
, BUILD_TIME_LENGTH
);
758 sbufWriteData(dst
, shortGitRevision
, GIT_SHORT_REVISION_LENGTH
);
762 sbufWriteU8(dst
, (uint8_t)constrain(getLegacyBatteryVoltage(), 0, 255));
763 sbufWriteU16(dst
, (uint16_t)constrain(getMAhDrawn(), 0, 0xFFFF)); // milliamp hours drawn from battery
764 sbufWriteU16(dst
, getRssi());
765 sbufWriteU16(dst
, (int16_t)constrain(getAmperage(), -0x8000, 0x7FFF)); // send current in 0.01 A steps, range is -320A to 320A
766 sbufWriteU16(dst
, getBatteryVoltage());
770 for (int i
= 0; i
< DEBUG16_VALUE_COUNT
; i
++) {
771 sbufWriteU16(dst
, debug
[i
]); // 4 variables are here for general monitoring purpose
776 sbufWriteU32(dst
, U_ID_0
);
777 sbufWriteU32(dst
, U_ID_1
);
778 sbufWriteU32(dst
, U_ID_2
);
781 case MSP_FEATURE_CONFIG
:
782 sbufWriteU32(dst
, featureConfig()->enabledFeatures
);
786 case MSP_BEEPER_CONFIG
:
787 sbufWriteU32(dst
, beeperConfig()->beeper_off_flags
);
788 sbufWriteU8(dst
, beeperConfig()->dshotBeaconTone
);
789 sbufWriteU32(dst
, beeperConfig()->dshotBeaconOffFlags
);
793 case MSP_BATTERY_STATE
: {
794 // battery characteristics
795 sbufWriteU8(dst
, (uint8_t)constrain(getBatteryCellCount(), 0, 255)); // 0 indicates battery not detected.
796 sbufWriteU16(dst
, batteryConfig()->batteryCapacity
); // in mAh
799 sbufWriteU8(dst
, (uint8_t)constrain(getLegacyBatteryVoltage(), 0, 255)); // in 0.1V steps
800 sbufWriteU16(dst
, (uint16_t)constrain(getMAhDrawn(), 0, 0xFFFF)); // milliamp hours drawn from battery
801 sbufWriteU16(dst
, (int16_t)constrain(getAmperage(), -0x8000, 0x7FFF)); // send current in 0.01 A steps, range is -320A to 320A
804 sbufWriteU8(dst
, (uint8_t)getBatteryState());
806 sbufWriteU16(dst
, getBatteryVoltage()); // in 0.01V steps
810 case MSP_VOLTAGE_METERS
: {
811 // write out id and voltage meter values, once for each meter we support
812 uint8_t count
= supportedVoltageMeterCount
;
813 #ifdef USE_ESC_SENSOR
814 count
-= VOLTAGE_METER_ID_ESC_COUNT
- getMotorCount();
817 for (int i
= 0; i
< count
; i
++) {
819 voltageMeter_t meter
;
820 uint8_t id
= (uint8_t)voltageMeterIds
[i
];
821 voltageMeterRead(id
, &meter
);
823 sbufWriteU8(dst
, id
);
824 sbufWriteU8(dst
, (uint8_t)constrain((meter
.displayFiltered
+ 5) / 10, 0, 255));
829 case MSP_CURRENT_METERS
: {
830 // write out id and current meter values, once for each meter we support
831 uint8_t count
= supportedCurrentMeterCount
;
832 #ifdef USE_ESC_SENSOR
833 count
-= VOLTAGE_METER_ID_ESC_COUNT
- getMotorCount();
835 for (int i
= 0; i
< count
; i
++) {
837 currentMeter_t meter
;
838 uint8_t id
= (uint8_t)currentMeterIds
[i
];
839 currentMeterRead(id
, &meter
);
841 sbufWriteU8(dst
, id
);
842 sbufWriteU16(dst
, (uint16_t)constrain(meter
.mAhDrawn
, 0, 0xFFFF)); // milliamp hours drawn from battery
843 sbufWriteU16(dst
, (uint16_t)constrain(meter
.amperage
* 10, 0, 0xFFFF)); // send amperage in 0.001 A steps (mA). Negative range is truncated to zero
848 case MSP_VOLTAGE_METER_CONFIG
:
850 // by using a sensor type and a sub-frame length it's possible to configure any type of voltage meter,
851 // e.g. an i2c/spi/can sensor or any sensor not built directly into the FC such as ESC/RX/SPort/SBus that has
852 // different configuration requirements.
853 STATIC_ASSERT(VOLTAGE_SENSOR_ADC_VBAT
== 0, VOLTAGE_SENSOR_ADC_VBAT_incorrect
); // VOLTAGE_SENSOR_ADC_VBAT should be the first index
854 sbufWriteU8(dst
, MAX_VOLTAGE_SENSOR_ADC
); // voltage meters in payload
855 for (int i
= VOLTAGE_SENSOR_ADC_VBAT
; i
< MAX_VOLTAGE_SENSOR_ADC
; i
++) {
856 const uint8_t adcSensorSubframeLength
= 1 + 1 + 1 + 1 + 1; // length of id, type, vbatscale, vbatresdivval, vbatresdivmultipler, in bytes
857 sbufWriteU8(dst
, adcSensorSubframeLength
); // ADC sensor sub-frame length
859 sbufWriteU8(dst
, voltageMeterADCtoIDMap
[i
]); // id of the sensor
860 sbufWriteU8(dst
, VOLTAGE_SENSOR_TYPE_ADC_RESISTOR_DIVIDER
); // indicate the type of sensor that the next part of the payload is for
862 sbufWriteU8(dst
, voltageSensorADCConfig(i
)->vbatscale
);
863 sbufWriteU8(dst
, voltageSensorADCConfig(i
)->vbatresdivval
);
864 sbufWriteU8(dst
, voltageSensorADCConfig(i
)->vbatresdivmultiplier
);
866 // if we had any other voltage sensors, this is where we would output any needed configuration
870 case MSP_CURRENT_METER_CONFIG
: {
871 // the ADC and VIRTUAL sensors have the same configuration requirements, however this API reflects
872 // that this situation may change and allows us to support configuration of any current sensor with
873 // specialist configuration requirements.
875 int currentMeterCount
= 1;
877 #ifdef USE_VIRTUAL_CURRENT_METER
880 sbufWriteU8(dst
, currentMeterCount
);
882 const uint8_t adcSensorSubframeLength
= 1 + 1 + 2 + 2; // length of id, type, scale, offset, in bytes
883 sbufWriteU8(dst
, adcSensorSubframeLength
);
884 sbufWriteU8(dst
, CURRENT_METER_ID_BATTERY_1
); // the id of the meter
885 sbufWriteU8(dst
, CURRENT_SENSOR_ADC
); // indicate the type of sensor that the next part of the payload is for
886 sbufWriteU16(dst
, currentSensorADCConfig()->scale
);
887 sbufWriteU16(dst
, currentSensorADCConfig()->offset
);
889 #ifdef USE_VIRTUAL_CURRENT_METER
890 const int8_t virtualSensorSubframeLength
= 1 + 1 + 2 + 2; // length of id, type, scale, offset, in bytes
891 sbufWriteU8(dst
, virtualSensorSubframeLength
);
892 sbufWriteU8(dst
, CURRENT_METER_ID_VIRTUAL_1
); // the id of the meter
893 sbufWriteU8(dst
, CURRENT_SENSOR_VIRTUAL
); // indicate the type of sensor that the next part of the payload is for
894 sbufWriteU16(dst
, currentSensorVirtualConfig()->scale
);
895 sbufWriteU16(dst
, currentSensorVirtualConfig()->offset
);
898 // if we had any other current sensors, this is where we would output any needed configuration
902 case MSP_BATTERY_CONFIG
:
903 sbufWriteU8(dst
, (batteryConfig()->vbatmincellvoltage
+ 5) / 10);
904 sbufWriteU8(dst
, (batteryConfig()->vbatmaxcellvoltage
+ 5) / 10);
905 sbufWriteU8(dst
, (batteryConfig()->vbatwarningcellvoltage
+ 5) / 10);
906 sbufWriteU16(dst
, batteryConfig()->batteryCapacity
);
907 sbufWriteU8(dst
, batteryConfig()->voltageMeterSource
);
908 sbufWriteU8(dst
, batteryConfig()->currentMeterSource
);
909 sbufWriteU16(dst
, batteryConfig()->vbatmincellvoltage
);
910 sbufWriteU16(dst
, batteryConfig()->vbatmaxcellvoltage
);
911 sbufWriteU16(dst
, batteryConfig()->vbatwarningcellvoltage
);
914 case MSP_TRANSPONDER_CONFIG
: {
915 #ifdef USE_TRANSPONDER
916 // Backward compatibility to BFC 3.1.1 is lost for this message type
917 sbufWriteU8(dst
, TRANSPONDER_PROVIDER_COUNT
);
918 for (unsigned int i
= 0; i
< TRANSPONDER_PROVIDER_COUNT
; i
++) {
919 sbufWriteU8(dst
, transponderRequirements
[i
].provider
);
920 sbufWriteU8(dst
, transponderRequirements
[i
].dataLength
);
923 uint8_t provider
= transponderConfig()->provider
;
924 sbufWriteU8(dst
, provider
);
927 uint8_t requirementIndex
= provider
- 1;
928 uint8_t providerDataLength
= transponderRequirements
[requirementIndex
].dataLength
;
930 for (unsigned int i
= 0; i
< providerDataLength
; i
++) {
931 sbufWriteU8(dst
, transponderConfig()->data
[i
]);
935 sbufWriteU8(dst
, 0); // no providers
940 case MSP_OSD_CONFIG
: {
941 #define OSD_FLAGS_OSD_FEATURE (1 << 0)
942 //#define OSD_FLAGS_OSD_SLAVE (1 << 1)
943 #define OSD_FLAGS_RESERVED_1 (1 << 2)
944 #define OSD_FLAGS_OSD_HARDWARE_FRSKYOSD (1 << 3)
945 #define OSD_FLAGS_OSD_HARDWARE_MAX_7456 (1 << 4)
946 #define OSD_FLAGS_OSD_DEVICE_DETECTED (1 << 5)
948 uint8_t osdFlags
= 0;
950 osdFlags
|= OSD_FLAGS_OSD_FEATURE
;
952 osdDisplayPortDevice_e deviceType
;
953 displayPort_t
*osdDisplayPort
= osdGetDisplayPort(&deviceType
);
954 bool displayIsReady
= osdDisplayPort
&& displayCheckReady(osdDisplayPort
, true);
955 switch (deviceType
) {
956 case OSD_DISPLAYPORT_DEVICE_MAX7456
:
957 osdFlags
|= OSD_FLAGS_OSD_HARDWARE_MAX_7456
;
958 if (displayIsReady
) {
959 osdFlags
|= OSD_FLAGS_OSD_DEVICE_DETECTED
;
963 case OSD_DISPLAYPORT_DEVICE_FRSKYOSD
:
964 osdFlags
|= OSD_FLAGS_OSD_HARDWARE_FRSKYOSD
;
965 if (displayIsReady
) {
966 osdFlags
|= OSD_FLAGS_OSD_DEVICE_DETECTED
;
974 sbufWriteU8(dst
, osdFlags
);
977 // send video system (AUTO/PAL/NTSC)
978 sbufWriteU8(dst
, vcdProfile()->video_system
);
984 // OSD specific, not applicable to OSD slaves.
987 sbufWriteU8(dst
, osdConfig()->units
);
990 sbufWriteU8(dst
, osdConfig()->rssi_alarm
);
991 sbufWriteU16(dst
, osdConfig()->cap_alarm
);
993 // Reuse old timer alarm (U16) as OSD_ITEM_COUNT
995 sbufWriteU8(dst
, OSD_ITEM_COUNT
);
997 sbufWriteU16(dst
, osdConfig()->alt_alarm
);
999 // Element position and visibility
1000 for (int i
= 0; i
< OSD_ITEM_COUNT
; i
++) {
1001 sbufWriteU16(dst
, osdElementConfig()->item_pos
[i
]);
1004 // Post flight statistics
1005 sbufWriteU8(dst
, OSD_STAT_COUNT
);
1006 for (int i
= 0; i
< OSD_STAT_COUNT
; i
++ ) {
1007 sbufWriteU8(dst
, osdStatGetState(i
));
1011 sbufWriteU8(dst
, OSD_TIMER_COUNT
);
1012 for (int i
= 0; i
< OSD_TIMER_COUNT
; i
++) {
1013 sbufWriteU16(dst
, osdConfig()->timers
[i
]);
1017 // Send low word first for backwards compatibility (API < 1.41)
1018 sbufWriteU16(dst
, (uint16_t)(osdConfig()->enabledWarnings
& 0xFFFF));
1020 // Send the warnings count and 32bit enabled warnings flags.
1021 // Add currently active OSD profile (0 indicates OSD profiles not available).
1022 // Add OSD stick overlay mode (0 indicates OSD stick overlay not available).
1023 sbufWriteU8(dst
, OSD_WARNING_COUNT
);
1024 sbufWriteU32(dst
, osdConfig()->enabledWarnings
);
1026 #ifdef USE_OSD_PROFILES
1027 sbufWriteU8(dst
, OSD_PROFILE_COUNT
); // available profiles
1028 sbufWriteU8(dst
, osdConfig()->osdProfileIndex
); // selected profile
1030 // If the feature is not available there is only 1 profile and it's always selected
1031 sbufWriteU8(dst
, 1);
1032 sbufWriteU8(dst
, 1);
1033 #endif // USE_OSD_PROFILES
1035 #ifdef USE_OSD_STICK_OVERLAY
1036 sbufWriteU8(dst
, osdConfig()->overlay_radio_mode
);
1038 sbufWriteU8(dst
, 0);
1039 #endif // USE_OSD_STICK_OVERLAY
1042 // Add the camera frame element width/height
1043 sbufWriteU8(dst
, osdConfig()->camera_frame_width
);
1044 sbufWriteU8(dst
, osdConfig()->camera_frame_height
);
1056 static bool mspProcessOutCommand(int16_t cmdMSP
, sbuf_t
*dst
)
1058 bool unsupportedCommand
= false;
1064 boxBitmask_t flightModeFlags
;
1065 const int flagBits
= packFlightModeFlags(&flightModeFlags
);
1067 sbufWriteU16(dst
, getTaskDeltaTimeUs(TASK_PID
));
1069 sbufWriteU16(dst
, i2cGetErrorCounter());
1071 sbufWriteU16(dst
, 0);
1073 sbufWriteU16(dst
, sensors(SENSOR_ACC
) | sensors(SENSOR_BARO
) << 1 | sensors(SENSOR_MAG
) << 2 | sensors(SENSOR_GPS
) << 3 | sensors(SENSOR_RANGEFINDER
) << 4 | sensors(SENSOR_GYRO
) << 5);
1074 sbufWriteData(dst
, &flightModeFlags
, 4); // unconditional part of flags, first 32 bits
1075 sbufWriteU8(dst
, getCurrentPidProfileIndex());
1076 sbufWriteU16(dst
, constrain(getAverageSystemLoadPercent(), 0, LOAD_PERCENTAGE_ONE
));
1077 if (cmdMSP
== MSP_STATUS_EX
) {
1078 sbufWriteU8(dst
, PID_PROFILE_COUNT
);
1079 sbufWriteU8(dst
, getCurrentControlRateProfileIndex());
1080 } else { // MSP_STATUS
1081 sbufWriteU16(dst
, 0); // gyro cycle time
1084 // write flightModeFlags header. Lowest 4 bits contain number of bytes that follow
1085 // header is emited even when all bits fit into 32 bits to allow future extension
1086 int byteCount
= (flagBits
- 32 + 7) / 8; // 32 already stored, round up
1087 byteCount
= constrain(byteCount
, 0, 15); // limit to 16 bytes (128 bits)
1088 sbufWriteU8(dst
, byteCount
);
1089 sbufWriteData(dst
, ((uint8_t*)&flightModeFlags
) + 4, byteCount
);
1091 // Write arming disable flags
1092 // 1 byte, flag count
1093 sbufWriteU8(dst
, ARMING_DISABLE_FLAGS_COUNT
);
1095 const uint32_t armingDisableFlags
= getArmingDisableFlags();
1096 sbufWriteU32(dst
, armingDisableFlags
);
1098 // config state flags - bits to indicate the state of the configuration, reboot required, etc.
1099 // other flags can be added as needed
1100 sbufWriteU8(dst
, (getRebootRequired() << 0));
1106 #if defined(USE_ACC)
1107 // Hack scale due to choice of units for sensor data in multiwii
1110 if (acc
.dev
.acc_1G
> 512 * 4) {
1112 } else if (acc
.dev
.acc_1G
> 512 * 2) {
1114 } else if (acc
.dev
.acc_1G
>= 512) {
1121 for (int i
= 0; i
< 3; i
++) {
1122 #if defined(USE_ACC)
1123 sbufWriteU16(dst
, lrintf(acc
.accADC
[i
] / scale
));
1125 sbufWriteU16(dst
, 0);
1128 for (int i
= 0; i
< 3; i
++) {
1129 sbufWriteU16(dst
, gyroRateDps(i
));
1131 for (int i
= 0; i
< 3; i
++) {
1132 #if defined(USE_MAG)
1133 sbufWriteU16(dst
, lrintf(mag
.magADC
[i
]));
1135 sbufWriteU16(dst
, 0);
1143 const int nameLen
= strlen(pilotConfig()->name
);
1144 for (int i
= 0; i
< nameLen
; i
++) {
1145 sbufWriteU8(dst
, pilotConfig()->name
[i
]);
1152 sbufWriteData(dst
, &servo
, MAX_SUPPORTED_SERVOS
* 2);
1154 case MSP_SERVO_CONFIGURATIONS
:
1155 for (int i
= 0; i
< MAX_SUPPORTED_SERVOS
; i
++) {
1156 sbufWriteU16(dst
, servoParams(i
)->min
);
1157 sbufWriteU16(dst
, servoParams(i
)->max
);
1158 sbufWriteU16(dst
, servoParams(i
)->middle
);
1159 sbufWriteU8(dst
, servoParams(i
)->rate
);
1160 sbufWriteU8(dst
, servoParams(i
)->forwardFromChannel
);
1161 sbufWriteU32(dst
, servoParams(i
)->reversedSources
);
1165 case MSP_SERVO_MIX_RULES
:
1166 for (int i
= 0; i
< MAX_SERVO_RULES
; i
++) {
1167 sbufWriteU8(dst
, customServoMixers(i
)->targetChannel
);
1168 sbufWriteU8(dst
, customServoMixers(i
)->inputSource
);
1169 sbufWriteU8(dst
, customServoMixers(i
)->rate
);
1170 sbufWriteU8(dst
, customServoMixers(i
)->speed
);
1171 sbufWriteU8(dst
, customServoMixers(i
)->min
);
1172 sbufWriteU8(dst
, customServoMixers(i
)->max
);
1173 sbufWriteU8(dst
, customServoMixers(i
)->box
);
1179 for (unsigned i
= 0; i
< 8; i
++) {
1181 if (!motorIsEnabled() || i
>= MAX_SUPPORTED_MOTORS
|| !motorIsMotorEnabled(i
)) {
1182 sbufWriteU16(dst
, 0);
1186 sbufWriteU16(dst
, motorConvertToExternal(motor
[i
]));
1188 sbufWriteU16(dst
, 0);
1194 // Added in API version 1.42
1195 case MSP_MOTOR_TELEMETRY
:
1196 sbufWriteU8(dst
, getMotorCount());
1197 for (unsigned i
= 0; i
< getMotorCount(); i
++) {
1199 uint16_t invalidPct
= 0;
1200 uint8_t escTemperature
= 0; // degrees celcius
1201 uint16_t escVoltage
= 0; // 0.01V per unit
1202 uint16_t escCurrent
= 0; // 0.01A per unit
1203 uint16_t escConsumption
= 0; // mAh
1205 bool rpmDataAvailable
= false;
1207 #ifdef USE_DSHOT_TELEMETRY
1208 if (motorConfig()->dev
.useDshotTelemetry
) {
1209 rpm
= (int)getDshotTelemetry(i
) * 100 * 2 / motorConfig()->motorPoleCount
;
1210 rpmDataAvailable
= true;
1211 invalidPct
= 10000; // 100.00%
1212 #ifdef USE_DSHOT_TELEMETRY_STATS
1213 if (isDshotMotorTelemetryActive(i
)) {
1214 invalidPct
= getDshotTelemetryMotorInvalidPercent(i
);
1220 #ifdef USE_ESC_SENSOR
1221 if (featureIsEnabled(FEATURE_ESC_SENSOR
)) {
1222 escSensorData_t
*escData
= getEscSensorData(i
);
1223 if (!rpmDataAvailable
) { // We want DSHOT telemetry RPM data (if available) to have precedence
1224 rpm
= calcEscRpm(escData
->rpm
);
1225 rpmDataAvailable
= true;
1227 escTemperature
= escData
->temperature
;
1228 escVoltage
= escData
->voltage
;
1229 escCurrent
= escData
->current
;
1230 escConsumption
= escData
->consumption
;
1234 sbufWriteU32(dst
, (rpmDataAvailable
? rpm
: 0));
1235 sbufWriteU16(dst
, invalidPct
);
1236 sbufWriteU8(dst
, escTemperature
);
1237 sbufWriteU16(dst
, escVoltage
);
1238 sbufWriteU16(dst
, escCurrent
);
1239 sbufWriteU16(dst
, escConsumption
);
1243 case MSP2_MOTOR_OUTPUT_REORDERING
:
1245 sbufWriteU8(dst
, MAX_SUPPORTED_MOTORS
);
1247 for (unsigned i
= 0; i
< MAX_SUPPORTED_MOTORS
; i
++) {
1248 sbufWriteU8(dst
, motorConfig()->dev
.motorOutputReordering
[i
]);
1253 #ifdef USE_VTX_COMMON
1254 case MSP2_GET_VTX_DEVICE_STATUS
:
1256 const vtxDevice_t
*vtxDevice
= vtxCommonDevice();
1257 vtxCommonSerializeDeviceStatus(vtxDevice
, dst
);
1263 case MSP2_GET_OSD_WARNINGS
:
1266 uint8_t displayAttr
;
1267 char warningsBuffer
[OSD_FORMAT_MESSAGE_BUFFER_SIZE
];
1269 renderOsdWarning(warningsBuffer
, &isBlinking
, &displayAttr
);
1270 const uint8_t warningsLen
= strlen(warningsBuffer
);
1273 displayAttr
|= DISPLAYPORT_ATTR_BLINK
;
1275 sbufWriteU8(dst
, displayAttr
); // see displayPortAttr_e
1276 sbufWriteU8(dst
, warningsLen
); // length byte followed by the actual characters
1277 for (unsigned i
= 0; i
< warningsLen
; i
++) {
1278 sbufWriteU8(dst
, warningsBuffer
[i
]);
1285 for (int i
= 0; i
< rxRuntimeState
.channelCount
; i
++) {
1286 sbufWriteU16(dst
, rcData
[i
]);
1291 sbufWriteU16(dst
, attitude
.values
.roll
);
1292 sbufWriteU16(dst
, attitude
.values
.pitch
);
1293 sbufWriteU16(dst
, DECIDEGREES_TO_DEGREES(attitude
.values
.yaw
));
1297 sbufWriteU32(dst
, getEstimatedAltitudeCm());
1299 sbufWriteU16(dst
, getEstimatedVario());
1301 sbufWriteU16(dst
, 0);
1305 case MSP_SONAR_ALTITUDE
:
1306 #if defined(USE_RANGEFINDER)
1307 sbufWriteU32(dst
, rangefinderGetLatestAltitude());
1309 sbufWriteU32(dst
, 0);
1313 case MSP_BOARD_ALIGNMENT_CONFIG
:
1314 sbufWriteU16(dst
, boardAlignment()->rollDegrees
);
1315 sbufWriteU16(dst
, boardAlignment()->pitchDegrees
);
1316 sbufWriteU16(dst
, boardAlignment()->yawDegrees
);
1319 case MSP_ARMING_CONFIG
:
1320 sbufWriteU8(dst
, armingConfig()->auto_disarm_delay
);
1321 sbufWriteU8(dst
, 0);
1322 sbufWriteU8(dst
, imuConfig()->small_angle
);
1326 sbufWriteU8(dst
, currentControlRateProfile
->rcRates
[FD_ROLL
]);
1327 sbufWriteU8(dst
, currentControlRateProfile
->rcExpo
[FD_ROLL
]);
1328 for (int i
= 0 ; i
< 3; i
++) {
1329 sbufWriteU8(dst
, currentControlRateProfile
->rates
[i
]); // R,P,Y see flight_dynamics_index_t
1331 sbufWriteU8(dst
, currentControlRateProfile
->tpa_rate
);
1332 sbufWriteU8(dst
, currentControlRateProfile
->thrMid8
);
1333 sbufWriteU8(dst
, currentControlRateProfile
->thrExpo8
);
1334 sbufWriteU16(dst
, currentControlRateProfile
->tpa_breakpoint
);
1335 sbufWriteU8(dst
, currentControlRateProfile
->rcExpo
[FD_YAW
]);
1336 sbufWriteU8(dst
, currentControlRateProfile
->rcRates
[FD_YAW
]);
1337 sbufWriteU8(dst
, currentControlRateProfile
->rcRates
[FD_PITCH
]);
1338 sbufWriteU8(dst
, currentControlRateProfile
->rcExpo
[FD_PITCH
]);
1341 sbufWriteU8(dst
, currentControlRateProfile
->throttle_limit_type
);
1342 sbufWriteU8(dst
, currentControlRateProfile
->throttle_limit_percent
);
1345 sbufWriteU16(dst
, currentControlRateProfile
->rate_limit
[FD_ROLL
]);
1346 sbufWriteU16(dst
, currentControlRateProfile
->rate_limit
[FD_PITCH
]);
1347 sbufWriteU16(dst
, currentControlRateProfile
->rate_limit
[FD_YAW
]);
1350 sbufWriteU8(dst
, currentControlRateProfile
->rates_type
);
1355 for (int i
= 0; i
< PID_ITEM_COUNT
; i
++) {
1356 sbufWriteU8(dst
, currentPidProfile
->pid
[i
].P
);
1357 sbufWriteU8(dst
, currentPidProfile
->pid
[i
].I
);
1358 sbufWriteU8(dst
, currentPidProfile
->pid
[i
].D
);
1363 for (const char *c
= pidNames
; *c
; c
++) {
1364 sbufWriteU8(dst
, *c
);
1368 case MSP_PID_CONTROLLER
:
1369 sbufWriteU8(dst
, PID_CONTROLLER_BETAFLIGHT
);
1372 case MSP_MODE_RANGES
:
1373 for (int i
= 0; i
< MAX_MODE_ACTIVATION_CONDITION_COUNT
; i
++) {
1374 const modeActivationCondition_t
*mac
= modeActivationConditions(i
);
1375 const box_t
*box
= findBoxByBoxId(mac
->modeId
);
1376 sbufWriteU8(dst
, box
->permanentId
);
1377 sbufWriteU8(dst
, mac
->auxChannelIndex
);
1378 sbufWriteU8(dst
, mac
->range
.startStep
);
1379 sbufWriteU8(dst
, mac
->range
.endStep
);
1383 case MSP_MODE_RANGES_EXTRA
:
1384 sbufWriteU8(dst
, MAX_MODE_ACTIVATION_CONDITION_COUNT
); // prepend number of EXTRAs array elements
1386 for (int i
= 0; i
< MAX_MODE_ACTIVATION_CONDITION_COUNT
; i
++) {
1387 const modeActivationCondition_t
*mac
= modeActivationConditions(i
);
1388 const box_t
*box
= findBoxByBoxId(mac
->modeId
);
1389 const box_t
*linkedBox
= findBoxByBoxId(mac
->linkedTo
);
1390 sbufWriteU8(dst
, box
->permanentId
); // each element is aligned with MODE_RANGES by the permanentId
1391 sbufWriteU8(dst
, mac
->modeLogic
);
1392 sbufWriteU8(dst
, linkedBox
->permanentId
);
1396 case MSP_ADJUSTMENT_RANGES
:
1397 for (int i
= 0; i
< MAX_ADJUSTMENT_RANGE_COUNT
; i
++) {
1398 const adjustmentRange_t
*adjRange
= adjustmentRanges(i
);
1399 sbufWriteU8(dst
, 0); // was adjRange->adjustmentIndex
1400 sbufWriteU8(dst
, adjRange
->auxChannelIndex
);
1401 sbufWriteU8(dst
, adjRange
->range
.startStep
);
1402 sbufWriteU8(dst
, adjRange
->range
.endStep
);
1403 sbufWriteU8(dst
, adjRange
->adjustmentConfig
);
1404 sbufWriteU8(dst
, adjRange
->auxSwitchChannelIndex
);
1408 case MSP_MOTOR_CONFIG
:
1409 sbufWriteU16(dst
, motorConfig()->minthrottle
);
1410 sbufWriteU16(dst
, motorConfig()->maxthrottle
);
1411 sbufWriteU16(dst
, motorConfig()->mincommand
);
1414 sbufWriteU8(dst
, getMotorCount());
1415 sbufWriteU8(dst
, motorConfig()->motorPoleCount
);
1416 #ifdef USE_DSHOT_TELEMETRY
1417 sbufWriteU8(dst
, motorConfig()->dev
.useDshotTelemetry
);
1419 sbufWriteU8(dst
, 0);
1422 #ifdef USE_ESC_SENSOR
1423 sbufWriteU8(dst
, featureIsEnabled(FEATURE_ESC_SENSOR
)); // ESC sensor available
1425 sbufWriteU8(dst
, 0);
1429 #if defined(USE_ESC_SENSOR)
1430 // Deprecated in favor of MSP_MOTOR_TELEMETY as of API version 1.42
1431 case MSP_ESC_SENSOR_DATA
:
1432 if (featureIsEnabled(FEATURE_ESC_SENSOR
)) {
1433 sbufWriteU8(dst
, getMotorCount());
1434 for (int i
= 0; i
< getMotorCount(); i
++) {
1435 const escSensorData_t
*escData
= getEscSensorData(i
);
1436 sbufWriteU8(dst
, escData
->temperature
);
1437 sbufWriteU16(dst
, escData
->rpm
);
1440 unsupportedCommand
= true;
1447 case MSP_GPS_CONFIG
:
1448 sbufWriteU8(dst
, gpsConfig()->provider
);
1449 sbufWriteU8(dst
, gpsConfig()->sbasMode
);
1450 sbufWriteU8(dst
, gpsConfig()->autoConfig
);
1451 sbufWriteU8(dst
, gpsConfig()->autoBaud
);
1452 // Added in API version 1.43
1453 sbufWriteU8(dst
, gpsConfig()->gps_set_home_point_once
);
1454 sbufWriteU8(dst
, gpsConfig()->gps_ublox_use_galileo
);
1455 // Added in API version 1.45
1456 sbufWriteU8(dst
, gpsConfig()->gpsRequiredSats
);
1457 sbufWriteU8(dst
, gpsConfig()->gpsMinimumSats
);
1461 sbufWriteU8(dst
, STATE(GPS_FIX
));
1462 sbufWriteU8(dst
, gpsSol
.numSat
);
1463 sbufWriteU32(dst
, gpsSol
.llh
.lat
);
1464 sbufWriteU32(dst
, gpsSol
.llh
.lon
);
1465 sbufWriteU16(dst
, (uint16_t)constrain(gpsSol
.llh
.altCm
/ 100, 0, UINT16_MAX
)); // alt changed from 1m to 0.01m per lsb since MSP API 1.39 by RTH. To maintain backwards compatibility compensate to 1m per lsb in MSP again.
1466 sbufWriteU16(dst
, gpsSol
.groundSpeed
);
1467 sbufWriteU16(dst
, gpsSol
.groundCourse
);
1468 // Added in API version 1.44
1469 sbufWriteU16(dst
, gpsSol
.hdop
);
1473 sbufWriteU16(dst
, GPS_distanceToHome
);
1474 sbufWriteU16(dst
, GPS_directionToHome
/ 10); // resolution increased in Betaflight 4.4 by factor of 10, this maintains backwards compatibility for DJI OSD
1475 sbufWriteU8(dst
, GPS_update
& 1);
1479 sbufWriteU8(dst
, GPS_numCh
);
1480 for (int i
= 0; i
< GPS_numCh
; i
++) {
1481 sbufWriteU8(dst
, GPS_svinfo_chn
[i
]);
1482 sbufWriteU8(dst
, GPS_svinfo_svid
[i
]);
1483 sbufWriteU8(dst
, GPS_svinfo_quality
[i
]);
1484 sbufWriteU8(dst
, GPS_svinfo_cno
[i
]);
1488 #ifdef USE_GPS_RESCUE
1489 case MSP_GPS_RESCUE
:
1490 sbufWriteU16(dst
, gpsRescueConfig()->angle
);
1491 sbufWriteU16(dst
, gpsRescueConfig()->initialAltitudeM
);
1492 sbufWriteU16(dst
, gpsRescueConfig()->descentDistanceM
);
1493 sbufWriteU16(dst
, gpsRescueConfig()->rescueGroundspeed
);
1494 sbufWriteU16(dst
, gpsRescueConfig()->throttleMin
);
1495 sbufWriteU16(dst
, gpsRescueConfig()->throttleMax
);
1496 sbufWriteU16(dst
, gpsRescueConfig()->throttleHover
);
1497 sbufWriteU8(dst
, gpsRescueConfig()->sanityChecks
);
1498 sbufWriteU8(dst
, 0); // not required in API 1.44, gpsRescueConfig()->minSats
1500 // Added in API version 1.43
1501 sbufWriteU16(dst
, gpsRescueConfig()->ascendRate
);
1502 sbufWriteU16(dst
, gpsRescueConfig()->descendRate
);
1503 sbufWriteU8(dst
, gpsRescueConfig()->allowArmingWithoutFix
);
1504 sbufWriteU8(dst
, gpsRescueConfig()->altitudeMode
);
1505 // Added in API version 1.44
1506 sbufWriteU16(dst
, gpsRescueConfig()->minRescueDth
);
1509 case MSP_GPS_RESCUE_PIDS
:
1510 sbufWriteU16(dst
, gpsRescueConfig()->throttleP
);
1511 sbufWriteU16(dst
, gpsRescueConfig()->throttleI
);
1512 sbufWriteU16(dst
, gpsRescueConfig()->throttleD
);
1513 sbufWriteU16(dst
, gpsRescueConfig()->velP
);
1514 sbufWriteU16(dst
, gpsRescueConfig()->velI
);
1515 sbufWriteU16(dst
, gpsRescueConfig()->velD
);
1516 sbufWriteU16(dst
, gpsRescueConfig()->yawP
);
1521 #if defined(USE_ACC)
1523 sbufWriteU16(dst
, accelerometerConfig()->accelerometerTrims
.values
.pitch
);
1524 sbufWriteU16(dst
, accelerometerConfig()->accelerometerTrims
.values
.roll
);
1528 case MSP_MIXER_CONFIG
:
1529 sbufWriteU8(dst
, mixerConfig()->mixerMode
);
1530 sbufWriteU8(dst
, mixerConfig()->yaw_motors_reversed
);
1534 sbufWriteU8(dst
, rxConfig()->serialrx_provider
);
1535 sbufWriteU16(dst
, rxConfig()->maxcheck
);
1536 sbufWriteU16(dst
, rxConfig()->midrc
);
1537 sbufWriteU16(dst
, rxConfig()->mincheck
);
1538 sbufWriteU8(dst
, rxConfig()->spektrum_sat_bind
);
1539 sbufWriteU16(dst
, rxConfig()->rx_min_usec
);
1540 sbufWriteU16(dst
, rxConfig()->rx_max_usec
);
1541 sbufWriteU8(dst
, 0); // not required in API 1.44, was rxConfig()->rcInterpolation
1542 sbufWriteU8(dst
, 0); // not required in API 1.44, was rxConfig()->rcInterpolationInterval
1543 sbufWriteU16(dst
, rxConfig()->airModeActivateThreshold
* 10 + 1000);
1545 sbufWriteU8(dst
, rxSpiConfig()->rx_spi_protocol
);
1546 sbufWriteU32(dst
, rxSpiConfig()->rx_spi_id
);
1547 sbufWriteU8(dst
, rxSpiConfig()->rx_spi_rf_channel_count
);
1549 sbufWriteU8(dst
, 0);
1550 sbufWriteU32(dst
, 0);
1551 sbufWriteU8(dst
, 0);
1553 sbufWriteU8(dst
, rxConfig()->fpvCamAngleDegrees
);
1554 sbufWriteU8(dst
, 0); // not required in API 1.44, was rxConfig()->rcSmoothingChannels
1555 #if defined(USE_RC_SMOOTHING_FILTER)
1556 sbufWriteU8(dst
, 0); // not required in API 1.44, was rxConfig()->rc_smoothing_type
1557 sbufWriteU8(dst
, rxConfig()->rc_smoothing_setpoint_cutoff
);
1558 sbufWriteU8(dst
, rxConfig()->rc_smoothing_feedforward_cutoff
);
1559 sbufWriteU8(dst
, 0); // not required in API 1.44, was rxConfig()->rc_smoothing_input_type
1560 sbufWriteU8(dst
, 0); // not required in API 1.44, was rxConfig()->rc_smoothing_derivative_type
1562 sbufWriteU8(dst
, 0);
1563 sbufWriteU8(dst
, 0);
1564 sbufWriteU8(dst
, 0);
1565 sbufWriteU8(dst
, 0);
1566 sbufWriteU8(dst
, 0);
1568 #if defined(USE_USB_CDC_HID)
1569 sbufWriteU8(dst
, usbDevConfig()->type
);
1571 sbufWriteU8(dst
, 0);
1573 // Added in MSP API 1.42
1574 #if defined(USE_RC_SMOOTHING_FILTER)
1575 sbufWriteU8(dst
, rxConfig()->rc_smoothing_auto_factor_rpy
);
1577 sbufWriteU8(dst
, 0);
1579 // Added in MSP API 1.44
1580 #if defined(USE_RC_SMOOTHING_FILTER)
1581 sbufWriteU8(dst
, rxConfig()->rc_smoothing_mode
);
1583 sbufWriteU8(dst
, 0);
1586 case MSP_FAILSAFE_CONFIG
:
1587 sbufWriteU8(dst
, failsafeConfig()->failsafe_delay
);
1588 sbufWriteU8(dst
, failsafeConfig()->failsafe_off_delay
);
1589 sbufWriteU16(dst
, failsafeConfig()->failsafe_throttle
);
1590 sbufWriteU8(dst
, failsafeConfig()->failsafe_switch_mode
);
1591 sbufWriteU16(dst
, failsafeConfig()->failsafe_throttle_low_delay
);
1592 sbufWriteU8(dst
, failsafeConfig()->failsafe_procedure
);
1595 case MSP_RXFAIL_CONFIG
:
1596 for (int i
= 0; i
< rxRuntimeState
.channelCount
; i
++) {
1597 sbufWriteU8(dst
, rxFailsafeChannelConfigs(i
)->mode
);
1598 sbufWriteU16(dst
, RXFAIL_STEP_TO_CHANNEL_VALUE(rxFailsafeChannelConfigs(i
)->step
));
1602 case MSP_RSSI_CONFIG
:
1603 sbufWriteU8(dst
, rxConfig()->rssi_channel
);
1607 sbufWriteData(dst
, rxConfig()->rcmap
, RX_MAPPABLE_CHANNEL_COUNT
);
1610 case MSP_CF_SERIAL_CONFIG
:
1611 for (int i
= 0; i
< SERIAL_PORT_COUNT
; i
++) {
1612 if (!serialIsPortAvailable(serialConfig()->portConfigs
[i
].identifier
)) {
1615 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].identifier
);
1616 sbufWriteU16(dst
, serialConfig()->portConfigs
[i
].functionMask
);
1617 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].msp_baudrateIndex
);
1618 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].gps_baudrateIndex
);
1619 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].telemetry_baudrateIndex
);
1620 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].blackbox_baudrateIndex
);
1623 case MSP2_COMMON_SERIAL_CONFIG
: {
1625 for (int i
= 0; i
< SERIAL_PORT_COUNT
; i
++) {
1626 if (serialIsPortAvailable(serialConfig()->portConfigs
[i
].identifier
)) {
1630 sbufWriteU8(dst
, count
);
1631 for (int i
= 0; i
< SERIAL_PORT_COUNT
; i
++) {
1632 if (!serialIsPortAvailable(serialConfig()->portConfigs
[i
].identifier
)) {
1635 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].identifier
);
1636 sbufWriteU32(dst
, serialConfig()->portConfigs
[i
].functionMask
);
1637 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].msp_baudrateIndex
);
1638 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].gps_baudrateIndex
);
1639 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].telemetry_baudrateIndex
);
1640 sbufWriteU8(dst
, serialConfig()->portConfigs
[i
].blackbox_baudrateIndex
);
1645 #ifdef USE_LED_STRIP_STATUS_MODE
1646 case MSP_LED_COLORS
:
1647 for (int i
= 0; i
< LED_CONFIGURABLE_COLOR_COUNT
; i
++) {
1648 const hsvColor_t
*color
= &ledStripStatusModeConfig()->colors
[i
];
1649 sbufWriteU16(dst
, color
->h
);
1650 sbufWriteU8(dst
, color
->s
);
1651 sbufWriteU8(dst
, color
->v
);
1656 #ifdef USE_LED_STRIP
1657 case MSP_LED_STRIP_CONFIG
:
1658 for (int i
= 0; i
< LED_MAX_STRIP_LENGTH
; i
++) {
1659 #ifdef USE_LED_STRIP_STATUS_MODE
1660 const ledConfig_t
*ledConfig
= &ledStripStatusModeConfig()->ledConfigs
[i
];
1661 sbufWriteU32(dst
, *ledConfig
);
1663 sbufWriteU32(dst
, 0);
1667 // API 1.41 - add indicator for advanced profile support and the current profile selection
1668 // 0 = basic ledstrip available
1669 // 1 = advanced ledstrip available
1670 #ifdef USE_LED_STRIP_STATUS_MODE
1671 sbufWriteU8(dst
, 1); // advanced ledstrip available
1673 sbufWriteU8(dst
, 0); // only simple ledstrip available
1675 sbufWriteU8(dst
, ledStripConfig()->ledstrip_profile
);
1679 #ifdef USE_LED_STRIP_STATUS_MODE
1680 case MSP_LED_STRIP_MODECOLOR
:
1681 for (int i
= 0; i
< LED_MODE_COUNT
; i
++) {
1682 for (int j
= 0; j
< LED_DIRECTION_COUNT
; j
++) {
1683 sbufWriteU8(dst
, i
);
1684 sbufWriteU8(dst
, j
);
1685 sbufWriteU8(dst
, ledStripStatusModeConfig()->modeColors
[i
].color
[j
]);
1689 for (int j
= 0; j
< LED_SPECIAL_COLOR_COUNT
; j
++) {
1690 sbufWriteU8(dst
, LED_MODE_COUNT
);
1691 sbufWriteU8(dst
, j
);
1692 sbufWriteU8(dst
, ledStripStatusModeConfig()->specialColors
.color
[j
]);
1695 sbufWriteU8(dst
, LED_AUX_CHANNEL
);
1696 sbufWriteU8(dst
, 0);
1697 sbufWriteU8(dst
, ledStripStatusModeConfig()->ledstrip_aux_channel
);
1701 case MSP_DATAFLASH_SUMMARY
:
1702 serializeDataflashSummaryReply(dst
);
1705 case MSP_BLACKBOX_CONFIG
:
1707 sbufWriteU8(dst
, 1); //Blackbox supported
1708 sbufWriteU8(dst
, blackboxConfig()->device
);
1709 sbufWriteU8(dst
, 1); // Rate numerator, not used anymore
1710 sbufWriteU8(dst
, blackboxGetRateDenom());
1711 sbufWriteU16(dst
, blackboxGetPRatio());
1712 sbufWriteU8(dst
, blackboxConfig()->sample_rate
);
1713 // Added in MSP API 1.45
1714 sbufWriteU32(dst
, blackboxConfig()->fields_disabled_mask
);
1716 sbufWriteU8(dst
, 0); // Blackbox not supported
1717 sbufWriteU8(dst
, 0);
1718 sbufWriteU8(dst
, 0);
1719 sbufWriteU8(dst
, 0);
1720 sbufWriteU16(dst
, 0);
1721 sbufWriteU8(dst
, 0);
1722 // Added in MSP API 1.45
1723 sbufWriteU32(dst
, 0);
1727 case MSP_SDCARD_SUMMARY
:
1728 serializeSDCardSummaryReply(dst
);
1731 case MSP_MOTOR_3D_CONFIG
:
1732 sbufWriteU16(dst
, flight3DConfig()->deadband3d_low
);
1733 sbufWriteU16(dst
, flight3DConfig()->deadband3d_high
);
1734 sbufWriteU16(dst
, flight3DConfig()->neutral3d
);
1737 case MSP_RC_DEADBAND
:
1738 sbufWriteU8(dst
, rcControlsConfig()->deadband
);
1739 sbufWriteU8(dst
, rcControlsConfig()->yaw_deadband
);
1740 sbufWriteU8(dst
, rcControlsConfig()->alt_hold_deadband
);
1741 sbufWriteU16(dst
, flight3DConfig()->deadband3d_throttle
);
1745 case MSP_SENSOR_ALIGNMENT
: {
1746 uint8_t gyroAlignment
;
1747 #ifdef USE_MULTI_GYRO
1748 switch (gyroConfig()->gyro_to_use
) {
1749 case GYRO_CONFIG_USE_GYRO_2
:
1750 gyroAlignment
= gyroDeviceConfig(1)->alignment
;
1752 case GYRO_CONFIG_USE_GYRO_BOTH
:
1753 // for dual-gyro in "BOTH" mode we only read/write gyro 0
1755 gyroAlignment
= gyroDeviceConfig(0)->alignment
;
1759 gyroAlignment
= gyroDeviceConfig(0)->alignment
;
1761 sbufWriteU8(dst
, gyroAlignment
);
1762 sbufWriteU8(dst
, gyroAlignment
); // Starting with 4.0 gyro and acc alignment are the same
1763 #if defined(USE_MAG)
1764 sbufWriteU8(dst
, compassConfig()->mag_alignment
);
1766 sbufWriteU8(dst
, 0);
1769 // API 1.41 - Add multi-gyro indicator, selected gyro, and support for separate gyro 1 & 2 alignment
1770 sbufWriteU8(dst
, getGyroDetectionFlags());
1771 #ifdef USE_MULTI_GYRO
1772 sbufWriteU8(dst
, gyroConfig()->gyro_to_use
);
1773 sbufWriteU8(dst
, gyroDeviceConfig(0)->alignment
);
1774 sbufWriteU8(dst
, gyroDeviceConfig(1)->alignment
);
1776 sbufWriteU8(dst
, GYRO_CONFIG_USE_GYRO_1
);
1777 sbufWriteU8(dst
, gyroDeviceConfig(0)->alignment
);
1778 sbufWriteU8(dst
, ALIGN_DEFAULT
);
1783 case MSP_ADVANCED_CONFIG
:
1784 sbufWriteU8(dst
, 1); // was gyroConfig()->gyro_sync_denom - removed in API 1.43
1785 sbufWriteU8(dst
, pidConfig()->pid_process_denom
);
1786 sbufWriteU8(dst
, motorConfig()->dev
.useUnsyncedPwm
);
1787 sbufWriteU8(dst
, motorConfig()->dev
.motorPwmProtocol
);
1788 sbufWriteU16(dst
, motorConfig()->dev
.motorPwmRate
);
1789 sbufWriteU16(dst
, motorConfig()->digitalIdleOffsetValue
);
1790 sbufWriteU8(dst
, 0); // DEPRECATED: gyro_use_32kHz
1791 sbufWriteU8(dst
, motorConfig()->dev
.motorPwmInversion
);
1792 sbufWriteU8(dst
, gyroConfig()->gyro_to_use
);
1793 sbufWriteU8(dst
, gyroConfig()->gyro_high_fsr
);
1794 sbufWriteU8(dst
, gyroConfig()->gyroMovementCalibrationThreshold
);
1795 sbufWriteU16(dst
, gyroConfig()->gyroCalibrationDuration
);
1796 sbufWriteU16(dst
, gyroConfig()->gyro_offset_yaw
);
1797 sbufWriteU8(dst
, gyroConfig()->checkOverflow
);
1798 //Added in MSP API 1.42
1799 sbufWriteU8(dst
, systemConfig()->debug_mode
);
1800 sbufWriteU8(dst
, DEBUG_COUNT
);
1803 case MSP_FILTER_CONFIG
:
1804 sbufWriteU8(dst
, gyroConfig()->gyro_lpf1_static_hz
);
1805 sbufWriteU16(dst
, currentPidProfile
->dterm_lpf1_static_hz
);
1806 sbufWriteU16(dst
, currentPidProfile
->yaw_lowpass_hz
);
1807 sbufWriteU16(dst
, gyroConfig()->gyro_soft_notch_hz_1
);
1808 sbufWriteU16(dst
, gyroConfig()->gyro_soft_notch_cutoff_1
);
1809 sbufWriteU16(dst
, currentPidProfile
->dterm_notch_hz
);
1810 sbufWriteU16(dst
, currentPidProfile
->dterm_notch_cutoff
);
1811 sbufWriteU16(dst
, gyroConfig()->gyro_soft_notch_hz_2
);
1812 sbufWriteU16(dst
, gyroConfig()->gyro_soft_notch_cutoff_2
);
1813 sbufWriteU8(dst
, currentPidProfile
->dterm_lpf1_type
);
1814 sbufWriteU8(dst
, gyroConfig()->gyro_hardware_lpf
);
1815 sbufWriteU8(dst
, 0); // DEPRECATED: gyro_32khz_hardware_lpf
1816 sbufWriteU16(dst
, gyroConfig()->gyro_lpf1_static_hz
);
1817 sbufWriteU16(dst
, gyroConfig()->gyro_lpf2_static_hz
);
1818 sbufWriteU8(dst
, gyroConfig()->gyro_lpf1_type
);
1819 sbufWriteU8(dst
, gyroConfig()->gyro_lpf2_type
);
1820 sbufWriteU16(dst
, currentPidProfile
->dterm_lpf2_static_hz
);
1821 // Added in MSP API 1.41
1822 sbufWriteU8(dst
, currentPidProfile
->dterm_lpf2_type
);
1823 #if defined(USE_DYN_LPF)
1824 sbufWriteU16(dst
, gyroConfig()->gyro_lpf1_dyn_min_hz
);
1825 sbufWriteU16(dst
, gyroConfig()->gyro_lpf1_dyn_max_hz
);
1826 sbufWriteU16(dst
, currentPidProfile
->dterm_lpf1_dyn_min_hz
);
1827 sbufWriteU16(dst
, currentPidProfile
->dterm_lpf1_dyn_max_hz
);
1829 sbufWriteU16(dst
, 0);
1830 sbufWriteU16(dst
, 0);
1831 sbufWriteU16(dst
, 0);
1832 sbufWriteU16(dst
, 0);
1834 // Added in MSP API 1.42
1835 #if defined(USE_DYN_NOTCH_FILTER)
1836 sbufWriteU8(dst
, 0); // DEPRECATED 1.43: dyn_notch_range
1837 sbufWriteU8(dst
, 0); // DEPRECATED 1.44: dyn_notch_width_percent
1838 sbufWriteU16(dst
, dynNotchConfig()->dyn_notch_q
);
1839 sbufWriteU16(dst
, dynNotchConfig()->dyn_notch_min_hz
);
1841 sbufWriteU8(dst
, 0);
1842 sbufWriteU8(dst
, 0);
1843 sbufWriteU16(dst
, 0);
1844 sbufWriteU16(dst
, 0);
1846 #if defined(USE_RPM_FILTER)
1847 sbufWriteU8(dst
, rpmFilterConfig()->rpm_filter_harmonics
);
1848 sbufWriteU8(dst
, rpmFilterConfig()->rpm_filter_min_hz
);
1850 sbufWriteU8(dst
, 0);
1851 sbufWriteU8(dst
, 0);
1853 #if defined(USE_DYN_NOTCH_FILTER)
1854 // Added in MSP API 1.43
1855 sbufWriteU16(dst
, dynNotchConfig()->dyn_notch_max_hz
);
1857 sbufWriteU16(dst
, 0);
1859 #if defined(USE_DYN_LPF)
1860 // Added in MSP API 1.44
1861 sbufWriteU8(dst
, currentPidProfile
->dterm_lpf1_dyn_expo
);
1863 sbufWriteU8(dst
, 0);
1865 #if defined(USE_DYN_NOTCH_FILTER)
1866 sbufWriteU8(dst
, dynNotchConfig()->dyn_notch_count
);
1868 sbufWriteU8(dst
, 0);
1872 case MSP_PID_ADVANCED
:
1873 sbufWriteU16(dst
, 0);
1874 sbufWriteU16(dst
, 0);
1875 sbufWriteU16(dst
, 0); // was pidProfile.yaw_p_limit
1876 sbufWriteU8(dst
, 0); // reserved
1877 sbufWriteU8(dst
, 0); // was vbatPidCompensation
1878 #if defined(USE_FEEDFORWARD)
1879 sbufWriteU8(dst
, currentPidProfile
->feedforward_transition
);
1881 sbufWriteU8(dst
, 0);
1883 sbufWriteU8(dst
, 0); // was low byte of currentPidProfile->dtermSetpointWeight
1884 sbufWriteU8(dst
, 0); // reserved
1885 sbufWriteU8(dst
, 0); // reserved
1886 sbufWriteU8(dst
, 0); // reserved
1887 sbufWriteU16(dst
, currentPidProfile
->rateAccelLimit
);
1888 sbufWriteU16(dst
, currentPidProfile
->yawRateAccelLimit
);
1889 sbufWriteU8(dst
, currentPidProfile
->levelAngleLimit
);
1890 sbufWriteU8(dst
, 0); // was pidProfile.levelSensitivity
1891 sbufWriteU16(dst
, 0); // was currentPidProfile->itermThrottleThreshold
1892 sbufWriteU16(dst
, currentPidProfile
->anti_gravity_gain
);
1893 sbufWriteU16(dst
, 0); // was currentPidProfile->dtermSetpointWeight
1894 sbufWriteU8(dst
, currentPidProfile
->iterm_rotation
);
1895 sbufWriteU8(dst
, 0); // was currentPidProfile->smart_feedforward
1896 #if defined(USE_ITERM_RELAX)
1897 sbufWriteU8(dst
, currentPidProfile
->iterm_relax
);
1898 sbufWriteU8(dst
, currentPidProfile
->iterm_relax_type
);
1900 sbufWriteU8(dst
, 0);
1901 sbufWriteU8(dst
, 0);
1903 #if defined(USE_ABSOLUTE_CONTROL)
1904 sbufWriteU8(dst
, currentPidProfile
->abs_control_gain
);
1906 sbufWriteU8(dst
, 0);
1908 #if defined(USE_THROTTLE_BOOST)
1909 sbufWriteU8(dst
, currentPidProfile
->throttle_boost
);
1911 sbufWriteU8(dst
, 0);
1913 #if defined(USE_ACRO_TRAINER)
1914 sbufWriteU8(dst
, currentPidProfile
->acro_trainer_angle_limit
);
1916 sbufWriteU8(dst
, 0);
1918 sbufWriteU16(dst
, currentPidProfile
->pid
[PID_ROLL
].F
);
1919 sbufWriteU16(dst
, currentPidProfile
->pid
[PID_PITCH
].F
);
1920 sbufWriteU16(dst
, currentPidProfile
->pid
[PID_YAW
].F
);
1921 sbufWriteU8(dst
, 0); // was currentPidProfile->antiGravityMode
1922 #if defined(USE_D_MIN)
1923 sbufWriteU8(dst
, currentPidProfile
->d_min
[PID_ROLL
]);
1924 sbufWriteU8(dst
, currentPidProfile
->d_min
[PID_PITCH
]);
1925 sbufWriteU8(dst
, currentPidProfile
->d_min
[PID_YAW
]);
1926 sbufWriteU8(dst
, currentPidProfile
->d_min_gain
);
1927 sbufWriteU8(dst
, currentPidProfile
->d_min_advance
);
1929 sbufWriteU8(dst
, 0);
1930 sbufWriteU8(dst
, 0);
1931 sbufWriteU8(dst
, 0);
1932 sbufWriteU8(dst
, 0);
1933 sbufWriteU8(dst
, 0);
1935 #if defined(USE_INTEGRATED_YAW_CONTROL)
1936 sbufWriteU8(dst
, currentPidProfile
->use_integrated_yaw
);
1937 sbufWriteU8(dst
, currentPidProfile
->integrated_yaw_relax
);
1939 sbufWriteU8(dst
, 0);
1940 sbufWriteU8(dst
, 0);
1942 #if defined(USE_ITERM_RELAX)
1943 // Added in MSP API 1.42
1944 sbufWriteU8(dst
, currentPidProfile
->iterm_relax_cutoff
);
1946 sbufWriteU8(dst
, 0);
1948 // Added in MSP API 1.43
1949 sbufWriteU8(dst
, currentPidProfile
->motor_output_limit
);
1950 sbufWriteU8(dst
, currentPidProfile
->auto_profile_cell_count
);
1951 #if defined(USE_DYN_IDLE)
1952 sbufWriteU8(dst
, currentPidProfile
->dyn_idle_min_rpm
);
1954 sbufWriteU8(dst
, 0);
1956 // Added in MSP API 1.44
1957 #if defined(USE_FEEDFORWARD)
1958 sbufWriteU8(dst
, currentPidProfile
->feedforward_averaging
);
1959 sbufWriteU8(dst
, currentPidProfile
->feedforward_smooth_factor
);
1960 sbufWriteU8(dst
, currentPidProfile
->feedforward_boost
);
1961 sbufWriteU8(dst
, currentPidProfile
->feedforward_max_rate_limit
);
1962 sbufWriteU8(dst
, currentPidProfile
->feedforward_jitter_factor
);
1964 sbufWriteU8(dst
, 0);
1965 sbufWriteU8(dst
, 0);
1966 sbufWriteU8(dst
, 0);
1967 sbufWriteU8(dst
, 0);
1968 sbufWriteU8(dst
, 0);
1970 #if defined(USE_BATTERY_VOLTAGE_SAG_COMPENSATION)
1971 sbufWriteU8(dst
, currentPidProfile
->vbat_sag_compensation
);
1973 sbufWriteU8(dst
, 0);
1975 #if defined(USE_THRUST_LINEARIZATION)
1976 sbufWriteU8(dst
, currentPidProfile
->thrustLinearization
);
1978 sbufWriteU8(dst
, 0);
1981 case MSP_SENSOR_CONFIG
:
1982 #if defined(USE_ACC)
1983 sbufWriteU8(dst
, accelerometerConfig()->acc_hardware
);
1985 sbufWriteU8(dst
, 0);
1988 sbufWriteU8(dst
, barometerConfig()->baro_hardware
);
1990 sbufWriteU8(dst
, BARO_NONE
);
1993 sbufWriteU8(dst
, compassConfig()->mag_hardware
);
1995 sbufWriteU8(dst
, MAG_NONE
);
1999 #if defined(USE_VTX_COMMON)
2000 case MSP_VTX_CONFIG
:
2002 const vtxDevice_t
*vtxDevice
= vtxCommonDevice();
2003 unsigned vtxStatus
= 0;
2004 vtxDevType_e vtxType
= VTXDEV_UNKNOWN
;
2005 uint8_t deviceIsReady
= 0;
2007 vtxCommonGetStatus(vtxDevice
, &vtxStatus
);
2008 vtxType
= vtxCommonGetDeviceType(vtxDevice
);
2009 deviceIsReady
= vtxCommonDeviceIsReady(vtxDevice
) ? 1 : 0;
2011 sbufWriteU8(dst
, vtxType
);
2012 sbufWriteU8(dst
, vtxSettingsConfig()->band
);
2013 sbufWriteU8(dst
, vtxSettingsConfig()->channel
);
2014 sbufWriteU8(dst
, vtxSettingsConfig()->power
);
2015 sbufWriteU8(dst
, (vtxStatus
& VTX_STATUS_PIT_MODE
) ? 1 : 0);
2016 sbufWriteU16(dst
, vtxSettingsConfig()->freq
);
2017 sbufWriteU8(dst
, deviceIsReady
);
2018 sbufWriteU8(dst
, vtxSettingsConfig()->lowPowerDisarm
);
2021 sbufWriteU16(dst
, vtxSettingsConfig()->pitModeFreq
);
2022 #ifdef USE_VTX_TABLE
2023 sbufWriteU8(dst
, 1); // vtxtable is available
2024 sbufWriteU8(dst
, vtxTableConfig()->bands
);
2025 sbufWriteU8(dst
, vtxTableConfig()->channels
);
2026 sbufWriteU8(dst
, vtxTableConfig()->powerLevels
);
2028 sbufWriteU8(dst
, 0);
2029 sbufWriteU8(dst
, 0);
2030 sbufWriteU8(dst
, 0);
2031 sbufWriteU8(dst
, 0);
2039 sbufWriteU8(dst
, rssiSource
);
2040 uint8_t rtcDateTimeIsSet
= 0;
2043 if (rtcGetDateTime(&dt
)) {
2044 rtcDateTimeIsSet
= 1;
2047 rtcDateTimeIsSet
= RTC_NOT_SUPPORTED
;
2049 sbufWriteU8(dst
, rtcDateTimeIsSet
);
2056 if (rtcGetDateTime(&dt
)) {
2057 sbufWriteU16(dst
, dt
.year
);
2058 sbufWriteU8(dst
, dt
.month
);
2059 sbufWriteU8(dst
, dt
.day
);
2060 sbufWriteU8(dst
, dt
.hours
);
2061 sbufWriteU8(dst
, dt
.minutes
);
2062 sbufWriteU8(dst
, dt
.seconds
);
2063 sbufWriteU16(dst
, dt
.millis
);
2070 unsupportedCommand
= true;
2072 return !unsupportedCommand
;
2076 #ifdef USE_SIMPLIFIED_TUNING
2077 // Reads simplified PID tuning values from MSP buffer
2078 static void readSimplifiedPids(pidProfile_t
* pidProfile
, sbuf_t
*src
)
2080 pidProfile
->simplified_pids_mode
= sbufReadU8(src
);
2081 pidProfile
->simplified_master_multiplier
= sbufReadU8(src
);
2082 pidProfile
->simplified_roll_pitch_ratio
= sbufReadU8(src
);
2083 pidProfile
->simplified_i_gain
= sbufReadU8(src
);
2084 pidProfile
->simplified_d_gain
= sbufReadU8(src
);
2085 pidProfile
->simplified_pi_gain
= sbufReadU8(src
);
2087 pidProfile
->simplified_dmin_ratio
= sbufReadU8(src
);
2091 pidProfile
->simplified_feedforward_gain
= sbufReadU8(src
);
2092 pidProfile
->simplified_pitch_pi_gain
= sbufReadU8(src
);
2093 sbufReadU32(src
); // reserved for future use
2094 sbufReadU32(src
); // reserved for future use
2097 // Writes simplified PID tuning values to MSP buffer
2098 static void writeSimplifiedPids(const pidProfile_t
*pidProfile
, sbuf_t
*dst
)
2100 sbufWriteU8(dst
, pidProfile
->simplified_pids_mode
);
2101 sbufWriteU8(dst
, pidProfile
->simplified_master_multiplier
);
2102 sbufWriteU8(dst
, pidProfile
->simplified_roll_pitch_ratio
);
2103 sbufWriteU8(dst
, pidProfile
->simplified_i_gain
);
2104 sbufWriteU8(dst
, pidProfile
->simplified_d_gain
);
2105 sbufWriteU8(dst
, pidProfile
->simplified_pi_gain
);
2107 sbufWriteU8(dst
, pidProfile
->simplified_dmin_ratio
);
2109 sbufWriteU8(dst
, 0);
2111 sbufWriteU8(dst
, pidProfile
->simplified_feedforward_gain
);
2112 sbufWriteU8(dst
, pidProfile
->simplified_pitch_pi_gain
);
2113 sbufWriteU32(dst
, 0); // reserved for future use
2114 sbufWriteU32(dst
, 0); // reserved for future use
2117 // Reads simplified Dterm Filter values from MSP buffer
2118 static void readSimplifiedDtermFilters(pidProfile_t
* pidProfile
, sbuf_t
*src
)
2120 pidProfile
->simplified_dterm_filter
= sbufReadU8(src
);
2121 pidProfile
->simplified_dterm_filter_multiplier
= sbufReadU8(src
);
2122 pidProfile
->dterm_lpf1_static_hz
= sbufReadU16(src
);
2123 pidProfile
->dterm_lpf2_static_hz
= sbufReadU16(src
);
2124 #if defined(USE_DYN_LPF)
2125 pidProfile
->dterm_lpf1_dyn_min_hz
= sbufReadU16(src
);
2126 pidProfile
->dterm_lpf1_dyn_max_hz
= sbufReadU16(src
);
2131 sbufReadU32(src
); // reserved for future use
2132 sbufReadU32(src
); // reserved for future use
2135 // Writes simplified Dterm Filter values into MSP buffer
2136 static void writeSimplifiedDtermFilters(const pidProfile_t
* pidProfile
, sbuf_t
*dst
)
2138 sbufWriteU8(dst
, pidProfile
->simplified_dterm_filter
);
2139 sbufWriteU8(dst
, pidProfile
->simplified_dterm_filter_multiplier
);
2140 sbufWriteU16(dst
, pidProfile
->dterm_lpf1_static_hz
);
2141 sbufWriteU16(dst
, pidProfile
->dterm_lpf2_static_hz
);
2142 #if defined(USE_DYN_LPF)
2143 sbufWriteU16(dst
, pidProfile
->dterm_lpf1_dyn_min_hz
);
2144 sbufWriteU16(dst
, pidProfile
->dterm_lpf1_dyn_max_hz
);
2146 sbufWriteU16(dst
, 0);
2147 sbufWriteU16(dst
, 0);
2149 sbufWriteU32(dst
, 0); // reserved for future use
2150 sbufWriteU32(dst
, 0); // reserved for future use
2153 // Writes simplified Gyro Filter values from MSP buffer
2154 static void readSimplifiedGyroFilters(gyroConfig_t
*gyroConfig
, sbuf_t
*src
)
2156 gyroConfig
->simplified_gyro_filter
= sbufReadU8(src
);
2157 gyroConfig
->simplified_gyro_filter_multiplier
= sbufReadU8(src
);
2158 gyroConfig
->gyro_lpf1_static_hz
= sbufReadU16(src
);
2159 gyroConfig
->gyro_lpf2_static_hz
= sbufReadU16(src
);
2160 #if defined(USE_DYN_LPF)
2161 gyroConfig
->gyro_lpf1_dyn_min_hz
= sbufReadU16(src
);
2162 gyroConfig
->gyro_lpf1_dyn_max_hz
= sbufReadU16(src
);
2167 sbufReadU32(src
); // reserved for future use
2168 sbufReadU32(src
); // reserved for future use
2171 // Writes simplified Gyro Filter values into MSP buffer
2172 static void writeSimplifiedGyroFilters(const gyroConfig_t
*gyroConfig
, sbuf_t
*dst
)
2174 sbufWriteU8(dst
, gyroConfig
->simplified_gyro_filter
);
2175 sbufWriteU8(dst
, gyroConfig
->simplified_gyro_filter_multiplier
);
2176 sbufWriteU16(dst
, gyroConfig
->gyro_lpf1_static_hz
);
2177 sbufWriteU16(dst
, gyroConfig
->gyro_lpf2_static_hz
);
2178 #if defined(USE_DYN_LPF)
2179 sbufWriteU16(dst
, gyroConfig
->gyro_lpf1_dyn_min_hz
);
2180 sbufWriteU16(dst
, gyroConfig
->gyro_lpf1_dyn_max_hz
);
2182 sbufWriteU16(dst
, 0);
2183 sbufWriteU16(dst
, 0);
2185 sbufWriteU32(dst
, 0); // reserved for future use
2186 sbufWriteU32(dst
, 0); // reserved for future use
2189 // writes results of simplified PID tuning values to MSP buffer
2190 static void writePidfs(pidProfile_t
* pidProfile
, sbuf_t
*dst
)
2192 for (int i
= 0; i
< XYZ_AXIS_COUNT
; i
++) {
2193 sbufWriteU8(dst
, pidProfile
->pid
[i
].P
);
2194 sbufWriteU8(dst
, pidProfile
->pid
[i
].I
);
2195 sbufWriteU8(dst
, pidProfile
->pid
[i
].D
);
2196 sbufWriteU8(dst
, pidProfile
->d_min
[i
]);
2197 sbufWriteU16(dst
, pidProfile
->pid
[i
].F
);
2200 #endif // USE_SIMPLIFIED_TUNING
2202 static mspResult_e
mspFcProcessOutCommandWithArg(mspDescriptor_t srcDesc
, int16_t cmdMSP
, sbuf_t
*src
, sbuf_t
*dst
, mspPostProcessFnPtr
*mspPostProcessFn
)
2208 const int page
= sbufBytesRemaining(src
) ? sbufReadU8(src
) : 0;
2209 serializeBoxReply(dst
, page
, &serializeBoxNameFn
);
2214 const int page
= sbufBytesRemaining(src
) ? sbufReadU8(src
) : 0;
2215 serializeBoxReply(dst
, page
, &serializeBoxPermanentIdFn
);
2219 if (sbufBytesRemaining(src
)) {
2220 rebootMode
= sbufReadU8(src
);
2222 if (rebootMode
>= MSP_REBOOT_COUNT
2223 #if !defined(USE_USB_MSC)
2224 || rebootMode
== MSP_REBOOT_MSC
|| rebootMode
== MSP_REBOOT_MSC_UTC
2227 return MSP_RESULT_ERROR
;
2230 rebootMode
= MSP_REBOOT_FIRMWARE
;
2233 sbufWriteU8(dst
, rebootMode
);
2235 #if defined(USE_USB_MSC)
2236 if (rebootMode
== MSP_REBOOT_MSC
) {
2237 if (mscCheckFilesystemReady()) {
2238 sbufWriteU8(dst
, 1);
2240 sbufWriteU8(dst
, 0);
2242 return MSP_RESULT_ACK
;
2247 #if defined(USE_MSP_OVER_TELEMETRY)
2248 if (featureIsEnabled(FEATURE_RX_SPI
) && srcDesc
== getMspTelemetryDescriptor()) {
2249 dispatchAdd(&mspRebootEntry
, MSP_DISPATCH_DELAY_US
);
2252 if (mspPostProcessFn
) {
2253 *mspPostProcessFn
= mspRebootFn
;
2257 case MSP_MULTIPLE_MSP
:
2259 uint8_t maxMSPs
= 0;
2260 if (sbufBytesRemaining(src
) == 0) {
2261 return MSP_RESULT_ERROR
;
2263 int bytesRemaining
= sbufBytesRemaining(dst
) - 1; // need to keep one byte for checksum
2264 mspPacket_t packetIn
, packetOut
;
2265 sbufInit(&packetIn
.buf
, src
->end
, src
->end
);
2266 uint8_t* resetInputPtr
= src
->ptr
;
2267 while (sbufBytesRemaining(src
) && bytesRemaining
> 0) {
2268 uint8_t newMSP
= sbufReadU8(src
);
2269 sbufInit(&packetOut
.buf
, dst
->ptr
, dst
->end
);
2270 packetIn
.cmd
= newMSP
;
2271 mspFcProcessCommand(srcDesc
, &packetIn
, &packetOut
, NULL
);
2272 uint8_t mspSize
= sbufPtr(&packetOut
.buf
) - dst
->ptr
;
2273 mspSize
++; // need to add length information for each MSP
2274 bytesRemaining
-= mspSize
;
2275 if (bytesRemaining
>= 0) {
2279 src
->ptr
= resetInputPtr
;
2280 sbufInit(&packetOut
.buf
, dst
->ptr
, dst
->end
);
2281 for (int i
= 0; i
< maxMSPs
; i
++) {
2282 uint8_t* sizePtr
= sbufPtr(&packetOut
.buf
);
2283 sbufWriteU8(&packetOut
.buf
, 0); // dummy
2284 packetIn
.cmd
= sbufReadU8(src
);
2285 mspFcProcessCommand(srcDesc
, &packetIn
, &packetOut
, NULL
);
2286 (*sizePtr
) = sbufPtr(&packetOut
.buf
) - (sizePtr
+ 1);
2288 dst
->ptr
= packetOut
.buf
.ptr
;
2292 #ifdef USE_VTX_TABLE
2293 case MSP_VTXTABLE_BAND
:
2295 const uint8_t band
= sbufBytesRemaining(src
) ? sbufReadU8(src
) : 0;
2296 if (band
> 0 && band
<= VTX_TABLE_MAX_BANDS
) {
2297 sbufWriteU8(dst
, band
); // band number (same as request)
2298 sbufWriteU8(dst
, VTX_TABLE_BAND_NAME_LENGTH
); // band name length
2299 for (int i
= 0; i
< VTX_TABLE_BAND_NAME_LENGTH
; i
++) { // band name bytes
2300 sbufWriteU8(dst
, vtxTableConfig()->bandNames
[band
- 1][i
]);
2302 sbufWriteU8(dst
, vtxTableConfig()->bandLetters
[band
- 1]); // band letter
2303 sbufWriteU8(dst
, vtxTableConfig()->isFactoryBand
[band
- 1]); // CUSTOM = 0; FACTORY = 1
2304 sbufWriteU8(dst
, vtxTableConfig()->channels
); // number of channel frequencies to follow
2305 for (int i
= 0; i
< vtxTableConfig()->channels
; i
++) { // the frequency for each channel
2306 sbufWriteU16(dst
, vtxTableConfig()->frequency
[band
- 1][i
]);
2309 return MSP_RESULT_ERROR
;
2314 case MSP_VTXTABLE_POWERLEVEL
:
2316 const uint8_t powerLevel
= sbufBytesRemaining(src
) ? sbufReadU8(src
) : 0;
2317 if (powerLevel
> 0 && powerLevel
<= VTX_TABLE_MAX_POWER_LEVELS
) {
2318 sbufWriteU8(dst
, powerLevel
); // powerLevel number (same as request)
2319 sbufWriteU16(dst
, vtxTableConfig()->powerValues
[powerLevel
- 1]);
2320 sbufWriteU8(dst
, VTX_TABLE_POWER_LABEL_LENGTH
); // powerLevel label length
2321 for (int i
= 0; i
< VTX_TABLE_POWER_LABEL_LENGTH
; i
++) { // powerlevel label bytes
2322 sbufWriteU8(dst
, vtxTableConfig()->powerLabels
[powerLevel
- 1][i
]);
2325 return MSP_RESULT_ERROR
;
2329 #endif // USE_VTX_TABLE
2331 #ifdef USE_SIMPLIFIED_TUNING
2332 // Added in MSP API 1.44
2333 case MSP_SIMPLIFIED_TUNING
:
2335 writeSimplifiedPids(currentPidProfile
, dst
);
2336 writeSimplifiedDtermFilters(currentPidProfile
, dst
);
2337 writeSimplifiedGyroFilters(gyroConfig(), dst
);
2341 case MSP_CALCULATE_SIMPLIFIED_PID
:
2343 pidProfile_t tempPidProfile
= *currentPidProfile
;
2344 readSimplifiedPids(&tempPidProfile
, src
);
2345 applySimplifiedTuningPids(&tempPidProfile
);
2346 writePidfs(&tempPidProfile
, dst
);
2350 case MSP_CALCULATE_SIMPLIFIED_DTERM
:
2352 pidProfile_t tempPidProfile
= *currentPidProfile
;
2353 readSimplifiedDtermFilters(&tempPidProfile
, src
);
2354 applySimplifiedTuningDtermFilters(&tempPidProfile
);
2355 writeSimplifiedDtermFilters(&tempPidProfile
, dst
);
2359 case MSP_CALCULATE_SIMPLIFIED_GYRO
:
2361 gyroConfig_t tempGyroConfig
= *gyroConfig();
2362 readSimplifiedGyroFilters(&tempGyroConfig
, src
);
2363 applySimplifiedTuningGyroFilters(&tempGyroConfig
);
2364 writeSimplifiedGyroFilters(&tempGyroConfig
, dst
);
2368 case MSP_VALIDATE_SIMPLIFIED_TUNING
:
2370 pidProfile_t tempPidProfile
= *currentPidProfile
;
2371 applySimplifiedTuningPids(&tempPidProfile
);
2374 for (int i
= 0; i
< XYZ_AXIS_COUNT
; i
++) {
2376 tempPidProfile
.pid
[i
].P
== currentPidProfile
->pid
[i
].P
&&
2377 tempPidProfile
.pid
[i
].I
== currentPidProfile
->pid
[i
].I
&&
2378 tempPidProfile
.pid
[i
].D
== currentPidProfile
->pid
[i
].D
&&
2379 tempPidProfile
.d_min
[i
] == currentPidProfile
->d_min
[i
] &&
2380 tempPidProfile
.pid
[i
].F
== currentPidProfile
->pid
[i
].F
;
2383 sbufWriteU8(dst
, result
);
2385 gyroConfig_t tempGyroConfig
= *gyroConfig();
2386 applySimplifiedTuningGyroFilters(&tempGyroConfig
);
2388 tempGyroConfig
.gyro_lpf1_static_hz
== gyroConfig()->gyro_lpf1_static_hz
&&
2389 tempGyroConfig
.gyro_lpf2_static_hz
== gyroConfig()->gyro_lpf2_static_hz
;
2391 #if defined(USE_DYN_LPF)
2393 tempGyroConfig
.gyro_lpf1_dyn_min_hz
== gyroConfig()->gyro_lpf1_dyn_min_hz
&&
2394 tempGyroConfig
.gyro_lpf1_dyn_max_hz
== gyroConfig()->gyro_lpf1_dyn_max_hz
;
2397 sbufWriteU8(dst
, result
);
2399 applySimplifiedTuningDtermFilters(&tempPidProfile
);
2401 tempPidProfile
.dterm_lpf1_static_hz
== currentPidProfile
->dterm_lpf1_static_hz
&&
2402 tempPidProfile
.dterm_lpf2_static_hz
== currentPidProfile
->dterm_lpf2_static_hz
;
2404 #if defined(USE_DYN_LPF)
2406 tempPidProfile
.dterm_lpf1_dyn_min_hz
== currentPidProfile
->dterm_lpf1_dyn_min_hz
&&
2407 tempPidProfile
.dterm_lpf1_dyn_max_hz
== currentPidProfile
->dterm_lpf1_dyn_max_hz
;
2410 sbufWriteU8(dst
, result
);
2415 case MSP_RESET_CONF
:
2417 #if defined(USE_CUSTOM_DEFAULTS)
2418 defaultsType_e defaultsType
= DEFAULTS_TYPE_CUSTOM
;
2420 if (sbufBytesRemaining(src
) >= 1) {
2421 // Added in MSP API 1.42
2422 #if defined(USE_CUSTOM_DEFAULTS)
2423 defaultsType
= sbufReadU8(src
);
2429 bool success
= false;
2430 if (!ARMING_FLAG(ARMED
)) {
2431 #if defined(USE_CUSTOM_DEFAULTS)
2432 success
= resetEEPROM(defaultsType
== DEFAULTS_TYPE_CUSTOM
);
2434 success
= resetEEPROM(false);
2437 if (success
&& mspPostProcessFn
) {
2438 rebootMode
= MSP_REBOOT_FIRMWARE
;
2439 *mspPostProcessFn
= mspRebootFn
;
2443 // Added in API version 1.42
2444 sbufWriteU8(dst
, success
);
2449 return MSP_RESULT_CMD_UNKNOWN
;
2451 return MSP_RESULT_ACK
;
2455 static void mspFcDataFlashReadCommand(sbuf_t
*dst
, sbuf_t
*src
)
2457 const unsigned int dataSize
= sbufBytesRemaining(src
);
2458 const uint32_t readAddress
= sbufReadU32(src
);
2459 uint16_t readLength
;
2460 bool allowCompression
= false;
2461 bool useLegacyFormat
;
2462 if (dataSize
>= sizeof(uint32_t) + sizeof(uint16_t)) {
2463 readLength
= sbufReadU16(src
);
2464 if (sbufBytesRemaining(src
)) {
2465 allowCompression
= sbufReadU8(src
);
2467 useLegacyFormat
= false;
2470 useLegacyFormat
= true;
2473 serializeDataflashReadReply(dst
, readAddress
, readLength
, useLegacyFormat
, allowCompression
);
2477 static mspResult_e
mspProcessInCommand(mspDescriptor_t srcDesc
, int16_t cmdMSP
, sbuf_t
*src
)
2481 const unsigned int dataSize
= sbufBytesRemaining(src
);
2483 case MSP_SELECT_SETTING
:
2484 value
= sbufReadU8(src
);
2485 if ((value
& RATEPROFILE_MASK
) == 0) {
2486 if (!ARMING_FLAG(ARMED
)) {
2487 if (value
>= PID_PROFILE_COUNT
) {
2490 changePidProfile(value
);
2493 value
= value
& ~RATEPROFILE_MASK
;
2495 if (value
>= CONTROL_RATE_PROFILE_COUNT
) {
2498 changeControlRateProfile(value
);
2502 case MSP_COPY_PROFILE
:
2503 value
= sbufReadU8(src
); // 0 = pid profile, 1 = control rate profile
2504 uint8_t dstProfileIndex
= sbufReadU8(src
);
2505 uint8_t srcProfileIndex
= sbufReadU8(src
);
2507 pidCopyProfile(dstProfileIndex
, srcProfileIndex
);
2509 else if (value
== 1) {
2510 copyControlRateProfile(dstProfileIndex
, srcProfileIndex
);
2514 #if defined(USE_GPS) || defined(USE_MAG)
2515 case MSP_SET_HEADING
:
2516 magHold
= sbufReadU16(src
);
2520 case MSP_SET_RAW_RC
:
2523 uint8_t channelCount
= dataSize
/ sizeof(uint16_t);
2524 if (channelCount
> MAX_SUPPORTED_RC_CHANNEL_COUNT
) {
2525 return MSP_RESULT_ERROR
;
2527 uint16_t frame
[MAX_SUPPORTED_RC_CHANNEL_COUNT
];
2528 for (int i
= 0; i
< channelCount
; i
++) {
2529 frame
[i
] = sbufReadU16(src
);
2531 rxMspFrameReceive(frame
, channelCount
);
2536 #if defined(USE_ACC)
2537 case MSP_SET_ACC_TRIM
:
2538 accelerometerConfigMutable()->accelerometerTrims
.values
.pitch
= sbufReadU16(src
);
2539 accelerometerConfigMutable()->accelerometerTrims
.values
.roll
= sbufReadU16(src
);
2543 case MSP_SET_ARMING_CONFIG
:
2544 armingConfigMutable()->auto_disarm_delay
= sbufReadU8(src
);
2545 sbufReadU8(src
); // reserved
2546 if (sbufBytesRemaining(src
)) {
2547 imuConfigMutable()->small_angle
= sbufReadU8(src
);
2551 case MSP_SET_PID_CONTROLLER
:
2555 for (int i
= 0; i
< PID_ITEM_COUNT
; i
++) {
2556 currentPidProfile
->pid
[i
].P
= sbufReadU8(src
);
2557 currentPidProfile
->pid
[i
].I
= sbufReadU8(src
);
2558 currentPidProfile
->pid
[i
].D
= sbufReadU8(src
);
2560 pidInitConfig(currentPidProfile
);
2563 case MSP_SET_MODE_RANGE
:
2564 i
= sbufReadU8(src
);
2565 if (i
< MAX_MODE_ACTIVATION_CONDITION_COUNT
) {
2566 modeActivationCondition_t
*mac
= modeActivationConditionsMutable(i
);
2567 i
= sbufReadU8(src
);
2568 const box_t
*box
= findBoxByPermanentId(i
);
2570 mac
->modeId
= box
->boxId
;
2571 mac
->auxChannelIndex
= sbufReadU8(src
);
2572 mac
->range
.startStep
= sbufReadU8(src
);
2573 mac
->range
.endStep
= sbufReadU8(src
);
2574 if (sbufBytesRemaining(src
) != 0) {
2575 mac
->modeLogic
= sbufReadU8(src
);
2577 i
= sbufReadU8(src
);
2578 mac
->linkedTo
= findBoxByPermanentId(i
)->boxId
;
2582 return MSP_RESULT_ERROR
;
2585 return MSP_RESULT_ERROR
;
2589 case MSP_SET_ADJUSTMENT_RANGE
:
2590 i
= sbufReadU8(src
);
2591 if (i
< MAX_ADJUSTMENT_RANGE_COUNT
) {
2592 adjustmentRange_t
*adjRange
= adjustmentRangesMutable(i
);
2593 sbufReadU8(src
); // was adjRange->adjustmentIndex
2594 adjRange
->auxChannelIndex
= sbufReadU8(src
);
2595 adjRange
->range
.startStep
= sbufReadU8(src
);
2596 adjRange
->range
.endStep
= sbufReadU8(src
);
2597 adjRange
->adjustmentConfig
= sbufReadU8(src
);
2598 adjRange
->auxSwitchChannelIndex
= sbufReadU8(src
);
2600 activeAdjustmentRangeReset();
2602 return MSP_RESULT_ERROR
;
2606 case MSP_SET_RC_TUNING
:
2607 if (sbufBytesRemaining(src
) >= 10) {
2608 value
= sbufReadU8(src
);
2609 if (currentControlRateProfile
->rcRates
[FD_PITCH
] == currentControlRateProfile
->rcRates
[FD_ROLL
]) {
2610 currentControlRateProfile
->rcRates
[FD_PITCH
] = value
;
2612 currentControlRateProfile
->rcRates
[FD_ROLL
] = value
;
2614 value
= sbufReadU8(src
);
2615 if (currentControlRateProfile
->rcExpo
[FD_PITCH
] == currentControlRateProfile
->rcExpo
[FD_ROLL
]) {
2616 currentControlRateProfile
->rcExpo
[FD_PITCH
] = value
;
2618 currentControlRateProfile
->rcExpo
[FD_ROLL
] = value
;
2620 for (int i
= 0; i
< 3; i
++) {
2621 currentControlRateProfile
->rates
[i
] = sbufReadU8(src
);
2624 value
= sbufReadU8(src
);
2625 currentControlRateProfile
->tpa_rate
= MIN(value
, CONTROL_RATE_CONFIG_TPA_MAX
);
2626 currentControlRateProfile
->thrMid8
= sbufReadU8(src
);
2627 currentControlRateProfile
->thrExpo8
= sbufReadU8(src
);
2628 currentControlRateProfile
->tpa_breakpoint
= sbufReadU16(src
);
2630 if (sbufBytesRemaining(src
) >= 1) {
2631 currentControlRateProfile
->rcExpo
[FD_YAW
] = sbufReadU8(src
);
2634 if (sbufBytesRemaining(src
) >= 1) {
2635 currentControlRateProfile
->rcRates
[FD_YAW
] = sbufReadU8(src
);
2638 if (sbufBytesRemaining(src
) >= 1) {
2639 currentControlRateProfile
->rcRates
[FD_PITCH
] = sbufReadU8(src
);
2642 if (sbufBytesRemaining(src
) >= 1) {
2643 currentControlRateProfile
->rcExpo
[FD_PITCH
] = sbufReadU8(src
);
2647 if (sbufBytesRemaining(src
) >= 2) {
2648 currentControlRateProfile
->throttle_limit_type
= sbufReadU8(src
);
2649 currentControlRateProfile
->throttle_limit_percent
= sbufReadU8(src
);
2653 if (sbufBytesRemaining(src
) >= 6) {
2654 currentControlRateProfile
->rate_limit
[FD_ROLL
] = sbufReadU16(src
);
2655 currentControlRateProfile
->rate_limit
[FD_PITCH
] = sbufReadU16(src
);
2656 currentControlRateProfile
->rate_limit
[FD_YAW
] = sbufReadU16(src
);
2660 if (sbufBytesRemaining(src
) >= 1) {
2661 currentControlRateProfile
->rates_type
= sbufReadU8(src
);
2666 return MSP_RESULT_ERROR
;
2670 case MSP_SET_MOTOR_CONFIG
:
2671 motorConfigMutable()->minthrottle
= sbufReadU16(src
);
2672 motorConfigMutable()->maxthrottle
= sbufReadU16(src
);
2673 motorConfigMutable()->mincommand
= sbufReadU16(src
);
2676 if (sbufBytesRemaining(src
) >= 2) {
2677 motorConfigMutable()->motorPoleCount
= sbufReadU8(src
);
2678 #if defined(USE_DSHOT_TELEMETRY)
2679 motorConfigMutable()->dev
.useDshotTelemetry
= sbufReadU8(src
);
2687 case MSP_SET_GPS_CONFIG
:
2688 gpsConfigMutable()->provider
= sbufReadU8(src
);
2689 gpsConfigMutable()->sbasMode
= sbufReadU8(src
);
2690 gpsConfigMutable()->autoConfig
= sbufReadU8(src
);
2691 gpsConfigMutable()->autoBaud
= sbufReadU8(src
);
2692 if (sbufBytesRemaining(src
) >= 2) {
2693 // Added in API version 1.43
2694 gpsConfigMutable()->gps_set_home_point_once
= sbufReadU8(src
);
2695 gpsConfigMutable()->gps_ublox_use_galileo
= sbufReadU8(src
);
2697 if (sbufBytesRemaining(src
) >= 2) {
2698 // Added in API version 1.45
2699 gpsConfigMutable()->gpsRequiredSats
= sbufReadU8(src
);
2700 gpsConfigMutable()->gpsMinimumSats
= sbufReadU8(src
);
2705 #ifdef USE_GPS_RESCUE
2706 case MSP_SET_GPS_RESCUE
:
2707 gpsRescueConfigMutable()->angle
= sbufReadU16(src
);
2708 gpsRescueConfigMutable()->initialAltitudeM
= sbufReadU16(src
);
2709 gpsRescueConfigMutable()->descentDistanceM
= sbufReadU16(src
);
2710 gpsRescueConfigMutable()->rescueGroundspeed
= sbufReadU16(src
);
2711 gpsRescueConfigMutable()->throttleMin
= sbufReadU16(src
);
2712 gpsRescueConfigMutable()->throttleMax
= sbufReadU16(src
);
2713 gpsRescueConfigMutable()->throttleHover
= sbufReadU16(src
);
2714 gpsRescueConfigMutable()->sanityChecks
= sbufReadU8(src
);
2715 sbufReadU8(src
); // not used since 1.43, was gps rescue minSats
2716 if (sbufBytesRemaining(src
) >= 6) {
2717 // Added in API version 1.43
2718 gpsRescueConfigMutable()->ascendRate
= sbufReadU16(src
);
2719 gpsRescueConfigMutable()->descendRate
= sbufReadU16(src
);
2720 gpsRescueConfigMutable()->allowArmingWithoutFix
= sbufReadU8(src
);
2721 gpsRescueConfigMutable()->altitudeMode
= sbufReadU8(src
);
2723 if (sbufBytesRemaining(src
) >= 2) {
2724 // Added in API version 1.44
2725 gpsRescueConfigMutable()->minRescueDth
= sbufReadU16(src
);
2729 case MSP_SET_GPS_RESCUE_PIDS
:
2730 gpsRescueConfigMutable()->throttleP
= sbufReadU16(src
);
2731 gpsRescueConfigMutable()->throttleI
= sbufReadU16(src
);
2732 gpsRescueConfigMutable()->throttleD
= sbufReadU16(src
);
2733 gpsRescueConfigMutable()->velP
= sbufReadU16(src
);
2734 gpsRescueConfigMutable()->velI
= sbufReadU16(src
);
2735 gpsRescueConfigMutable()->velD
= sbufReadU16(src
);
2736 gpsRescueConfigMutable()->yawP
= sbufReadU16(src
);
2742 for (int i
= 0; i
< getMotorCount(); i
++) {
2743 motor_disarmed
[i
] = motorConvertFromExternal(sbufReadU16(src
));
2747 case MSP_SET_SERVO_CONFIGURATION
:
2749 if (dataSize
!= 1 + 12) {
2750 return MSP_RESULT_ERROR
;
2752 i
= sbufReadU8(src
);
2753 if (i
>= MAX_SUPPORTED_SERVOS
) {
2754 return MSP_RESULT_ERROR
;
2756 servoParamsMutable(i
)->min
= sbufReadU16(src
);
2757 servoParamsMutable(i
)->max
= sbufReadU16(src
);
2758 servoParamsMutable(i
)->middle
= sbufReadU16(src
);
2759 servoParamsMutable(i
)->rate
= sbufReadU8(src
);
2760 servoParamsMutable(i
)->forwardFromChannel
= sbufReadU8(src
);
2761 servoParamsMutable(i
)->reversedSources
= sbufReadU32(src
);
2766 case MSP_SET_SERVO_MIX_RULE
:
2768 i
= sbufReadU8(src
);
2769 if (i
>= MAX_SERVO_RULES
) {
2770 return MSP_RESULT_ERROR
;
2772 customServoMixersMutable(i
)->targetChannel
= sbufReadU8(src
);
2773 customServoMixersMutable(i
)->inputSource
= sbufReadU8(src
);
2774 customServoMixersMutable(i
)->rate
= sbufReadU8(src
);
2775 customServoMixersMutable(i
)->speed
= sbufReadU8(src
);
2776 customServoMixersMutable(i
)->min
= sbufReadU8(src
);
2777 customServoMixersMutable(i
)->max
= sbufReadU8(src
);
2778 customServoMixersMutable(i
)->box
= sbufReadU8(src
);
2779 loadCustomServoMixer();
2784 case MSP_SET_MOTOR_3D_CONFIG
:
2785 flight3DConfigMutable()->deadband3d_low
= sbufReadU16(src
);
2786 flight3DConfigMutable()->deadband3d_high
= sbufReadU16(src
);
2787 flight3DConfigMutable()->neutral3d
= sbufReadU16(src
);
2790 case MSP_SET_RC_DEADBAND
:
2791 rcControlsConfigMutable()->deadband
= sbufReadU8(src
);
2792 rcControlsConfigMutable()->yaw_deadband
= sbufReadU8(src
);
2793 rcControlsConfigMutable()->alt_hold_deadband
= sbufReadU8(src
);
2794 flight3DConfigMutable()->deadband3d_throttle
= sbufReadU16(src
);
2797 case MSP_SET_RESET_CURR_PID
:
2798 resetPidProfile(currentPidProfile
);
2801 case MSP_SET_SENSOR_ALIGNMENT
: {
2802 // maintain backwards compatibility for API < 1.41
2803 const uint8_t gyroAlignment
= sbufReadU8(src
);
2804 sbufReadU8(src
); // discard deprecated acc_align
2805 #if defined(USE_MAG)
2806 compassConfigMutable()->mag_alignment
= sbufReadU8(src
);
2811 if (sbufBytesRemaining(src
) >= 3) {
2812 // API >= 1.41 - support the gyro_to_use and alignment for gyros 1 & 2
2813 #ifdef USE_MULTI_GYRO
2814 gyroConfigMutable()->gyro_to_use
= sbufReadU8(src
);
2815 gyroDeviceConfigMutable(0)->alignment
= sbufReadU8(src
);
2816 gyroDeviceConfigMutable(1)->alignment
= sbufReadU8(src
);
2818 sbufReadU8(src
); // unused gyro_to_use
2819 gyroDeviceConfigMutable(0)->alignment
= sbufReadU8(src
);
2820 sbufReadU8(src
); // unused gyro_2_sensor_align
2823 // maintain backwards compatibility for API < 1.41
2824 #ifdef USE_MULTI_GYRO
2825 switch (gyroConfig()->gyro_to_use
) {
2826 case GYRO_CONFIG_USE_GYRO_2
:
2827 gyroDeviceConfigMutable(1)->alignment
= gyroAlignment
;
2829 case GYRO_CONFIG_USE_GYRO_BOTH
:
2830 // For dual-gyro in "BOTH" mode we'll only update gyro 0
2832 gyroDeviceConfigMutable(0)->alignment
= gyroAlignment
;
2836 gyroDeviceConfigMutable(0)->alignment
= gyroAlignment
;
2843 case MSP_SET_ADVANCED_CONFIG
:
2844 sbufReadU8(src
); // was gyroConfigMutable()->gyro_sync_denom - removed in API 1.43
2845 pidConfigMutable()->pid_process_denom
= sbufReadU8(src
);
2846 motorConfigMutable()->dev
.useUnsyncedPwm
= sbufReadU8(src
);
2847 motorConfigMutable()->dev
.motorPwmProtocol
= sbufReadU8(src
);
2848 motorConfigMutable()->dev
.motorPwmRate
= sbufReadU16(src
);
2849 if (sbufBytesRemaining(src
) >= 2) {
2850 motorConfigMutable()->digitalIdleOffsetValue
= sbufReadU16(src
);
2852 if (sbufBytesRemaining(src
)) {
2853 sbufReadU8(src
); // DEPRECATED: gyro_use_32khz
2855 if (sbufBytesRemaining(src
)) {
2856 motorConfigMutable()->dev
.motorPwmInversion
= sbufReadU8(src
);
2858 if (sbufBytesRemaining(src
) >= 8) {
2859 gyroConfigMutable()->gyro_to_use
= sbufReadU8(src
);
2860 gyroConfigMutable()->gyro_high_fsr
= sbufReadU8(src
);
2861 gyroConfigMutable()->gyroMovementCalibrationThreshold
= sbufReadU8(src
);
2862 gyroConfigMutable()->gyroCalibrationDuration
= sbufReadU16(src
);
2863 gyroConfigMutable()->gyro_offset_yaw
= sbufReadU16(src
);
2864 gyroConfigMutable()->checkOverflow
= sbufReadU8(src
);
2866 if (sbufBytesRemaining(src
) >= 1) {
2867 //Added in MSP API 1.42
2868 systemConfigMutable()->debug_mode
= sbufReadU8(src
);
2871 validateAndFixGyroConfig();
2874 case MSP_SET_FILTER_CONFIG
:
2875 gyroConfigMutable()->gyro_lpf1_static_hz
= sbufReadU8(src
);
2876 currentPidProfile
->dterm_lpf1_static_hz
= sbufReadU16(src
);
2877 currentPidProfile
->yaw_lowpass_hz
= sbufReadU16(src
);
2878 if (sbufBytesRemaining(src
) >= 8) {
2879 gyroConfigMutable()->gyro_soft_notch_hz_1
= sbufReadU16(src
);
2880 gyroConfigMutable()->gyro_soft_notch_cutoff_1
= sbufReadU16(src
);
2881 currentPidProfile
->dterm_notch_hz
= sbufReadU16(src
);
2882 currentPidProfile
->dterm_notch_cutoff
= sbufReadU16(src
);
2884 if (sbufBytesRemaining(src
) >= 4) {
2885 gyroConfigMutable()->gyro_soft_notch_hz_2
= sbufReadU16(src
);
2886 gyroConfigMutable()->gyro_soft_notch_cutoff_2
= sbufReadU16(src
);
2888 if (sbufBytesRemaining(src
) >= 1) {
2889 currentPidProfile
->dterm_lpf1_type
= sbufReadU8(src
);
2891 if (sbufBytesRemaining(src
) >= 10) {
2892 gyroConfigMutable()->gyro_hardware_lpf
= sbufReadU8(src
);
2893 sbufReadU8(src
); // DEPRECATED: gyro_32khz_hardware_lpf
2894 gyroConfigMutable()->gyro_lpf1_static_hz
= sbufReadU16(src
);
2895 gyroConfigMutable()->gyro_lpf2_static_hz
= sbufReadU16(src
);
2896 gyroConfigMutable()->gyro_lpf1_type
= sbufReadU8(src
);
2897 gyroConfigMutable()->gyro_lpf2_type
= sbufReadU8(src
);
2898 currentPidProfile
->dterm_lpf2_static_hz
= sbufReadU16(src
);
2900 if (sbufBytesRemaining(src
) >= 9) {
2901 // Added in MSP API 1.41
2902 currentPidProfile
->dterm_lpf2_type
= sbufReadU8(src
);
2903 #if defined(USE_DYN_LPF)
2904 gyroConfigMutable()->gyro_lpf1_dyn_min_hz
= sbufReadU16(src
);
2905 gyroConfigMutable()->gyro_lpf1_dyn_max_hz
= sbufReadU16(src
);
2906 currentPidProfile
->dterm_lpf1_dyn_min_hz
= sbufReadU16(src
);
2907 currentPidProfile
->dterm_lpf1_dyn_max_hz
= sbufReadU16(src
);
2915 if (sbufBytesRemaining(src
) >= 8) {
2916 // Added in MSP API 1.42
2917 #if defined(USE_DYN_NOTCH_FILTER)
2918 sbufReadU8(src
); // DEPRECATED 1.43: dyn_notch_range
2919 sbufReadU8(src
); // DEPRECATED 1.44: dyn_notch_width_percent
2920 dynNotchConfigMutable()->dyn_notch_q
= sbufReadU16(src
);
2921 dynNotchConfigMutable()->dyn_notch_min_hz
= sbufReadU16(src
);
2928 #if defined(USE_RPM_FILTER)
2929 rpmFilterConfigMutable()->rpm_filter_harmonics
= sbufReadU8(src
);
2930 rpmFilterConfigMutable()->rpm_filter_min_hz
= sbufReadU8(src
);
2936 if (sbufBytesRemaining(src
) >= 2) {
2937 #if defined(USE_DYN_NOTCH_FILTER)
2938 // Added in MSP API 1.43
2939 dynNotchConfigMutable()->dyn_notch_max_hz
= sbufReadU16(src
);
2944 if (sbufBytesRemaining(src
) >= 2) {
2945 // Added in MSP API 1.44
2946 #if defined(USE_DYN_LPF)
2947 currentPidProfile
->dterm_lpf1_dyn_expo
= sbufReadU8(src
);
2951 #if defined(USE_DYN_NOTCH_FILTER)
2952 dynNotchConfigMutable()->dyn_notch_count
= sbufReadU8(src
);
2958 // reinitialize the gyro filters with the new values
2959 validateAndFixGyroConfig();
2961 // reinitialize the PID filters with the new values
2962 pidInitFilters(currentPidProfile
);
2965 case MSP_SET_PID_ADVANCED
:
2968 sbufReadU16(src
); // was pidProfile.yaw_p_limit
2969 sbufReadU8(src
); // reserved
2970 sbufReadU8(src
); // was vbatPidCompensation
2971 #if defined(USE_FEEDFORWARD)
2972 currentPidProfile
->feedforward_transition
= sbufReadU8(src
);
2976 sbufReadU8(src
); // was low byte of currentPidProfile->dtermSetpointWeight
2977 sbufReadU8(src
); // reserved
2978 sbufReadU8(src
); // reserved
2979 sbufReadU8(src
); // reserved
2980 currentPidProfile
->rateAccelLimit
= sbufReadU16(src
);
2981 currentPidProfile
->yawRateAccelLimit
= sbufReadU16(src
);
2982 if (sbufBytesRemaining(src
) >= 2) {
2983 currentPidProfile
->levelAngleLimit
= sbufReadU8(src
);
2984 sbufReadU8(src
); // was pidProfile.levelSensitivity
2986 if (sbufBytesRemaining(src
) >= 4) {
2987 sbufReadU16(src
); // was currentPidProfile->itermAcceleratorGain
2988 currentPidProfile
->anti_gravity_gain
= sbufReadU16(src
);
2990 if (sbufBytesRemaining(src
) >= 2) {
2991 sbufReadU16(src
); // was currentPidProfile->dtermSetpointWeight
2993 if (sbufBytesRemaining(src
) >= 14) {
2994 // Added in MSP API 1.40
2995 currentPidProfile
->iterm_rotation
= sbufReadU8(src
);
2996 sbufReadU8(src
); // was currentPidProfile->smart_feedforward
2997 #if defined(USE_ITERM_RELAX)
2998 currentPidProfile
->iterm_relax
= sbufReadU8(src
);
2999 currentPidProfile
->iterm_relax_type
= sbufReadU8(src
);
3004 #if defined(USE_ABSOLUTE_CONTROL)
3005 currentPidProfile
->abs_control_gain
= sbufReadU8(src
);
3009 #if defined(USE_THROTTLE_BOOST)
3010 currentPidProfile
->throttle_boost
= sbufReadU8(src
);
3014 #if defined(USE_ACRO_TRAINER)
3015 currentPidProfile
->acro_trainer_angle_limit
= sbufReadU8(src
);
3019 // PID controller feedforward terms
3020 currentPidProfile
->pid
[PID_ROLL
].F
= sbufReadU16(src
);
3021 currentPidProfile
->pid
[PID_PITCH
].F
= sbufReadU16(src
);
3022 currentPidProfile
->pid
[PID_YAW
].F
= sbufReadU16(src
);
3023 sbufReadU8(src
); // was currentPidProfile->antiGravityMode
3025 if (sbufBytesRemaining(src
) >= 7) {
3026 // Added in MSP API 1.41
3027 #if defined(USE_D_MIN)
3028 currentPidProfile
->d_min
[PID_ROLL
] = sbufReadU8(src
);
3029 currentPidProfile
->d_min
[PID_PITCH
] = sbufReadU8(src
);
3030 currentPidProfile
->d_min
[PID_YAW
] = sbufReadU8(src
);
3031 currentPidProfile
->d_min_gain
= sbufReadU8(src
);
3032 currentPidProfile
->d_min_advance
= sbufReadU8(src
);
3040 #if defined(USE_INTEGRATED_YAW_CONTROL)
3041 currentPidProfile
->use_integrated_yaw
= sbufReadU8(src
);
3042 currentPidProfile
->integrated_yaw_relax
= sbufReadU8(src
);
3048 if(sbufBytesRemaining(src
) >= 1) {
3049 // Added in MSP API 1.42
3050 #if defined(USE_ITERM_RELAX)
3051 currentPidProfile
->iterm_relax_cutoff
= sbufReadU8(src
);
3056 if (sbufBytesRemaining(src
) >= 3) {
3057 // Added in MSP API 1.43
3058 currentPidProfile
->motor_output_limit
= sbufReadU8(src
);
3059 currentPidProfile
->auto_profile_cell_count
= sbufReadU8(src
);
3060 #if defined(USE_DYN_IDLE)
3061 currentPidProfile
->dyn_idle_min_rpm
= sbufReadU8(src
);
3066 if (sbufBytesRemaining(src
) >= 7) {
3067 // Added in MSP API 1.44
3068 #if defined(USE_FEEDFORWARD)
3069 currentPidProfile
->feedforward_averaging
= sbufReadU8(src
);
3070 currentPidProfile
->feedforward_smooth_factor
= sbufReadU8(src
);
3071 currentPidProfile
->feedforward_boost
= sbufReadU8(src
);
3072 currentPidProfile
->feedforward_max_rate_limit
= sbufReadU8(src
);
3073 currentPidProfile
->feedforward_jitter_factor
= sbufReadU8(src
);
3082 #if defined(USE_BATTERY_VOLTAGE_SAG_COMPENSATION)
3083 currentPidProfile
->vbat_sag_compensation
= sbufReadU8(src
);
3087 #if defined(USE_THRUST_LINEARIZATION)
3088 currentPidProfile
->thrustLinearization
= sbufReadU8(src
);
3093 pidInitConfig(currentPidProfile
);
3098 case MSP_SET_SENSOR_CONFIG
:
3099 #if defined(USE_ACC)
3100 accelerometerConfigMutable()->acc_hardware
= sbufReadU8(src
);
3104 #if defined(USE_BARO)
3105 barometerConfigMutable()->baro_hardware
= sbufReadU8(src
);
3109 #if defined(USE_MAG)
3110 compassConfigMutable()->mag_hardware
= sbufReadU8(src
);
3117 case MSP_ACC_CALIBRATION
:
3118 if (!ARMING_FLAG(ARMED
))
3119 accStartCalibration();
3123 #if defined(USE_MAG)
3124 case MSP_MAG_CALIBRATION
:
3125 if (!ARMING_FLAG(ARMED
)) {
3126 compassStartCalibration();
3131 case MSP_EEPROM_WRITE
:
3132 if (ARMING_FLAG(ARMED
)) {
3133 return MSP_RESULT_ERROR
;
3136 // This is going to take some time and won't be done where real-time performance is needed so
3137 // ignore how long it takes to avoid confusing the scheduler
3138 schedulerIgnoreTaskStateTime();
3140 #if defined(USE_MSP_OVER_TELEMETRY)
3141 if (featureIsEnabled(FEATURE_RX_SPI
) && srcDesc
== getMspTelemetryDescriptor()) {
3142 dispatchAdd(&writeReadEepromEntry
, MSP_DISPATCH_DELAY_US
);
3146 writeReadEeprom(NULL
);
3152 case MSP_SET_BLACKBOX_CONFIG
:
3153 // Don't allow config to be updated while Blackbox is logging
3154 if (blackboxMayEditConfig()) {
3155 blackboxConfigMutable()->device
= sbufReadU8(src
);
3156 const int rateNum
= sbufReadU8(src
); // was rate_num
3157 const int rateDenom
= sbufReadU8(src
); // was rate_denom
3158 uint16_t pRatio
= 0;
3159 if (sbufBytesRemaining(src
) >= 2) {
3160 // p_ratio specified, so use it directly
3161 pRatio
= sbufReadU16(src
);
3163 // p_ratio not specified in MSP, so calculate it from old rateNum and rateDenom
3164 pRatio
= blackboxCalculatePDenom(rateNum
, rateDenom
);
3167 if (sbufBytesRemaining(src
) >= 1) {
3168 // sample_rate specified, so use it directly
3169 blackboxConfigMutable()->sample_rate
= sbufReadU8(src
);
3171 // sample_rate not specified in MSP, so calculate it from old p_ratio
3172 blackboxConfigMutable()->sample_rate
= blackboxCalculateSampleRate(pRatio
);
3175 // Added in MSP API 1.45
3176 if (sbufBytesRemaining(src
) >= 4) {
3177 blackboxConfigMutable()->fields_disabled_mask
= sbufReadU32(src
);
3183 #ifdef USE_VTX_COMMON
3184 case MSP_SET_VTX_CONFIG
:
3186 vtxDevice_t
*vtxDevice
= vtxCommonDevice();
3187 vtxDevType_e vtxType
= VTXDEV_UNKNOWN
;
3189 vtxType
= vtxCommonGetDeviceType(vtxDevice
);
3191 uint16_t newFrequency
= sbufReadU16(src
);
3192 if (newFrequency
<= VTXCOMMON_MSP_BANDCHAN_CHKVAL
) { // Value is band and channel
3193 const uint8_t newBand
= (newFrequency
/ 8) + 1;
3194 const uint8_t newChannel
= (newFrequency
% 8) + 1;
3195 vtxSettingsConfigMutable()->band
= newBand
;
3196 vtxSettingsConfigMutable()->channel
= newChannel
;
3197 vtxSettingsConfigMutable()->freq
= vtxCommonLookupFrequency(vtxDevice
, newBand
, newChannel
);
3198 } else if (newFrequency
<= VTX_SETTINGS_MAX_FREQUENCY_MHZ
) { // Value is frequency in MHz
3199 vtxSettingsConfigMutable()->band
= 0;
3200 vtxSettingsConfigMutable()->freq
= newFrequency
;
3203 if (sbufBytesRemaining(src
) >= 2) {
3204 vtxSettingsConfigMutable()->power
= sbufReadU8(src
);
3205 const uint8_t newPitmode
= sbufReadU8(src
);
3206 if (vtxType
!= VTXDEV_UNKNOWN
) {
3207 // Delegate pitmode to vtx directly
3208 unsigned vtxCurrentStatus
;
3209 vtxCommonGetStatus(vtxDevice
, &vtxCurrentStatus
);
3210 if ((bool)(vtxCurrentStatus
& VTX_STATUS_PIT_MODE
) != (bool)newPitmode
) {
3211 vtxCommonSetPitMode(vtxDevice
, newPitmode
);
3216 if (sbufBytesRemaining(src
)) {
3217 vtxSettingsConfigMutable()->lowPowerDisarm
= sbufReadU8(src
);
3220 // API version 1.42 - this parameter kept separate since clients may already be supplying
3221 if (sbufBytesRemaining(src
) >= 2) {
3222 vtxSettingsConfigMutable()->pitModeFreq
= sbufReadU16(src
);
3225 // API version 1.42 - extensions for non-encoded versions of the band, channel or frequency
3226 if (sbufBytesRemaining(src
) >= 4) {
3227 // Added standalone values for band, channel and frequency to move
3228 // away from the flawed encoded combined method originally implemented.
3229 uint8_t newBand
= sbufReadU8(src
);
3230 const uint8_t newChannel
= sbufReadU8(src
);
3231 uint16_t newFreq
= sbufReadU16(src
);
3233 newFreq
= vtxCommonLookupFrequency(vtxDevice
, newBand
, newChannel
);
3235 vtxSettingsConfigMutable()->band
= newBand
;
3236 vtxSettingsConfigMutable()->channel
= newChannel
;
3237 vtxSettingsConfigMutable()->freq
= newFreq
;
3240 // API version 1.42 - extensions for vtxtable support
3241 if (sbufBytesRemaining(src
) >= 4) {
3242 #ifdef USE_VTX_TABLE
3243 const uint8_t newBandCount
= sbufReadU8(src
);
3244 const uint8_t newChannelCount
= sbufReadU8(src
);
3245 const uint8_t newPowerCount
= sbufReadU8(src
);
3247 if ((newBandCount
> VTX_TABLE_MAX_BANDS
) ||
3248 (newChannelCount
> VTX_TABLE_MAX_CHANNELS
) ||
3249 (newPowerCount
> VTX_TABLE_MAX_POWER_LEVELS
)) {
3250 return MSP_RESULT_ERROR
;
3252 vtxTableConfigMutable()->bands
= newBandCount
;
3253 vtxTableConfigMutable()->channels
= newChannelCount
;
3254 vtxTableConfigMutable()->powerLevels
= newPowerCount
;
3256 // boolean to determine whether the vtxtable should be cleared in
3257 // expectation that the detailed band/channel and power level messages
3258 // will follow to repopulate the tables
3259 if (sbufReadU8(src
)) {
3260 for (int i
= 0; i
< VTX_TABLE_MAX_BANDS
; i
++) {
3261 vtxTableConfigClearBand(vtxTableConfigMutable(), i
);
3262 vtxTableConfigClearChannels(vtxTableConfigMutable(), i
, 0);
3264 vtxTableConfigClearPowerLabels(vtxTableConfigMutable(), 0);
3265 vtxTableConfigClearPowerValues(vtxTableConfigMutable(), 0);
3278 #ifdef USE_VTX_TABLE
3279 case MSP_SET_VTXTABLE_BAND
:
3281 char bandName
[VTX_TABLE_BAND_NAME_LENGTH
+ 1];
3282 memset(bandName
, 0, VTX_TABLE_BAND_NAME_LENGTH
+ 1);
3283 uint16_t frequencies
[VTX_TABLE_MAX_CHANNELS
];
3284 const uint8_t band
= sbufReadU8(src
);
3285 const uint8_t bandNameLength
= sbufReadU8(src
);
3286 for (int i
= 0; i
< bandNameLength
; i
++) {
3287 const char nameChar
= sbufReadU8(src
);
3288 if (i
< VTX_TABLE_BAND_NAME_LENGTH
) {
3289 bandName
[i
] = toupper(nameChar
);
3292 const char bandLetter
= toupper(sbufReadU8(src
));
3293 const bool isFactoryBand
= (bool)sbufReadU8(src
);
3294 const uint8_t channelCount
= sbufReadU8(src
);
3295 for (int i
= 0; i
< channelCount
; i
++) {
3296 const uint16_t frequency
= sbufReadU16(src
);
3297 if (i
< vtxTableConfig()->channels
) {
3298 frequencies
[i
] = frequency
;
3302 if (band
> 0 && band
<= vtxTableConfig()->bands
) {
3303 vtxTableStrncpyWithPad(vtxTableConfigMutable()->bandNames
[band
- 1], bandName
, VTX_TABLE_BAND_NAME_LENGTH
);
3304 vtxTableConfigMutable()->bandLetters
[band
- 1] = bandLetter
;
3305 vtxTableConfigMutable()->isFactoryBand
[band
- 1] = isFactoryBand
;
3306 for (int i
= 0; i
< vtxTableConfig()->channels
; i
++) {
3307 vtxTableConfigMutable()->frequency
[band
- 1][i
] = frequencies
[i
];
3309 // If this is the currently selected band then reset the frequency
3310 if (band
== vtxSettingsConfig()->band
) {
3311 uint16_t newFreq
= 0;
3312 if (vtxSettingsConfig()->channel
> 0 && vtxSettingsConfig()->channel
<= vtxTableConfig()->channels
) {
3313 newFreq
= frequencies
[vtxSettingsConfig()->channel
- 1];
3315 vtxSettingsConfigMutable()->freq
= newFreq
;
3317 vtxTableNeedsInit
= true; // reinintialize vtxtable after eeprom write
3319 return MSP_RESULT_ERROR
;
3324 case MSP_SET_VTXTABLE_POWERLEVEL
:
3326 char powerLevelLabel
[VTX_TABLE_POWER_LABEL_LENGTH
+ 1];
3327 memset(powerLevelLabel
, 0, VTX_TABLE_POWER_LABEL_LENGTH
+ 1);
3328 const uint8_t powerLevel
= sbufReadU8(src
);
3329 const uint16_t powerValue
= sbufReadU16(src
);
3330 const uint8_t powerLevelLabelLength
= sbufReadU8(src
);
3331 for (int i
= 0; i
< powerLevelLabelLength
; i
++) {
3332 const char labelChar
= sbufReadU8(src
);
3333 if (i
< VTX_TABLE_POWER_LABEL_LENGTH
) {
3334 powerLevelLabel
[i
] = toupper(labelChar
);
3338 if (powerLevel
> 0 && powerLevel
<= vtxTableConfig()->powerLevels
) {
3339 vtxTableConfigMutable()->powerValues
[powerLevel
- 1] = powerValue
;
3340 vtxTableStrncpyWithPad(vtxTableConfigMutable()->powerLabels
[powerLevel
- 1], powerLevelLabel
, VTX_TABLE_POWER_LABEL_LENGTH
);
3341 vtxTableNeedsInit
= true; // reinintialize vtxtable after eeprom write
3343 return MSP_RESULT_ERROR
;
3349 case MSP2_SET_MOTOR_OUTPUT_REORDERING
:
3351 const uint8_t arraySize
= sbufReadU8(src
);
3353 for (unsigned i
= 0; i
< MAX_SUPPORTED_MOTORS
; i
++) {
3356 if (i
< arraySize
) {
3357 value
= sbufReadU8(src
);
3360 motorConfigMutable()->dev
.motorOutputReordering
[i
] = value
;
3366 case MSP2_SEND_DSHOT_COMMAND
:
3368 const bool armed
= ARMING_FLAG(ARMED
);
3371 const uint8_t commandType
= sbufReadU8(src
);
3372 const uint8_t motorIndex
= sbufReadU8(src
);
3373 const uint8_t commandCount
= sbufReadU8(src
);
3375 if (DSHOT_CMD_TYPE_BLOCKING
== commandType
) {
3379 for (uint8_t i
= 0; i
< commandCount
; i
++) {
3380 const uint8_t commandIndex
= sbufReadU8(src
);
3381 dshotCommandWrite(motorIndex
, getMotorCount(), commandIndex
, commandType
);
3384 if (DSHOT_CMD_TYPE_BLOCKING
== commandType
) {
3392 #ifdef USE_SIMPLIFIED_TUNING
3393 // Added in MSP API 1.44
3394 case MSP_SET_SIMPLIFIED_TUNING
:
3396 readSimplifiedPids(currentPidProfile
, src
);
3397 readSimplifiedDtermFilters(currentPidProfile
, src
);
3398 readSimplifiedGyroFilters(gyroConfigMutable(), src
);
3399 applySimplifiedTuning(currentPidProfile
, gyroConfigMutable());
3404 #ifdef USE_CAMERA_CONTROL
3405 case MSP_CAMERA_CONTROL
:
3407 if (ARMING_FLAG(ARMED
)) {
3408 return MSP_RESULT_ERROR
;
3411 const uint8_t key
= sbufReadU8(src
);
3412 cameraControlKeyPress(key
, 0);
3417 case MSP_SET_ARMING_DISABLED
:
3419 const uint8_t command
= sbufReadU8(src
);
3420 uint8_t disableRunawayTakeoff
= 0;
3421 #ifndef USE_RUNAWAY_TAKEOFF
3422 UNUSED(disableRunawayTakeoff
);
3424 if (sbufBytesRemaining(src
)) {
3425 disableRunawayTakeoff
= sbufReadU8(src
);
3428 mspArmingDisableByDescriptor(srcDesc
);
3429 setArmingDisabled(ARMING_DISABLED_MSP
);
3430 if (ARMING_FLAG(ARMED
)) {
3431 disarm(DISARM_REASON_ARMING_DISABLED
);
3433 #ifdef USE_RUNAWAY_TAKEOFF
3434 runawayTakeoffTemporaryDisable(false);
3437 mspArmingEnableByDescriptor(srcDesc
);
3438 if (mspIsMspArmingEnabled()) {
3439 unsetArmingDisabled(ARMING_DISABLED_MSP
);
3440 #ifdef USE_RUNAWAY_TAKEOFF
3441 runawayTakeoffTemporaryDisable(disableRunawayTakeoff
);
3449 case MSP_DATAFLASH_ERASE
:
3456 case MSP_SET_RAW_GPS
:
3457 gpsSetFixState(sbufReadU8(src
));
3458 gpsSol
.numSat
= sbufReadU8(src
);
3459 gpsSol
.llh
.lat
= sbufReadU32(src
);
3460 gpsSol
.llh
.lon
= sbufReadU32(src
);
3461 gpsSol
.llh
.altCm
= sbufReadU16(src
) * 100; // alt changed from 1m to 0.01m per lsb since MSP API 1.39 by RTH. Received MSP altitudes in 1m per lsb have to upscaled.
3462 gpsSol
.groundSpeed
= sbufReadU16(src
);
3463 GPS_update
|= GPS_MSP_UPDATE
; // MSP data signalisation to GPS functions
3466 case MSP_SET_FEATURE_CONFIG
:
3467 featureConfigReplace(sbufReadU32(src
));
3471 case MSP_SET_BEEPER_CONFIG
:
3472 beeperConfigMutable()->beeper_off_flags
= sbufReadU32(src
);
3473 if (sbufBytesRemaining(src
) >= 1) {
3474 beeperConfigMutable()->dshotBeaconTone
= sbufReadU8(src
);
3476 if (sbufBytesRemaining(src
) >= 4) {
3477 beeperConfigMutable()->dshotBeaconOffFlags
= sbufReadU32(src
);
3482 case MSP_SET_BOARD_ALIGNMENT_CONFIG
:
3483 boardAlignmentMutable()->rollDegrees
= sbufReadU16(src
);
3484 boardAlignmentMutable()->pitchDegrees
= sbufReadU16(src
);
3485 boardAlignmentMutable()->yawDegrees
= sbufReadU16(src
);
3488 case MSP_SET_MIXER_CONFIG
:
3489 #ifndef USE_QUAD_MIXER_ONLY
3490 mixerConfigMutable()->mixerMode
= sbufReadU8(src
);
3494 if (sbufBytesRemaining(src
) >= 1) {
3495 mixerConfigMutable()->yaw_motors_reversed
= sbufReadU8(src
);
3499 case MSP_SET_RX_CONFIG
:
3500 rxConfigMutable()->serialrx_provider
= sbufReadU8(src
);
3501 rxConfigMutable()->maxcheck
= sbufReadU16(src
);
3502 rxConfigMutable()->midrc
= sbufReadU16(src
);
3503 rxConfigMutable()->mincheck
= sbufReadU16(src
);
3504 rxConfigMutable()->spektrum_sat_bind
= sbufReadU8(src
);
3505 if (sbufBytesRemaining(src
) >= 4) {
3506 rxConfigMutable()->rx_min_usec
= sbufReadU16(src
);
3507 rxConfigMutable()->rx_max_usec
= sbufReadU16(src
);
3509 if (sbufBytesRemaining(src
) >= 4) {
3510 sbufReadU8(src
); // not required in API 1.44, was rxConfigMutable()->rcInterpolation
3511 sbufReadU8(src
); // not required in API 1.44, was rxConfigMutable()->rcInterpolationInterval
3512 rxConfigMutable()->airModeActivateThreshold
= (sbufReadU16(src
) - 1000) / 10;
3514 if (sbufBytesRemaining(src
) >= 6) {
3516 rxSpiConfigMutable()->rx_spi_protocol
= sbufReadU8(src
);
3517 rxSpiConfigMutable()->rx_spi_id
= sbufReadU32(src
);
3518 rxSpiConfigMutable()->rx_spi_rf_channel_count
= sbufReadU8(src
);
3525 if (sbufBytesRemaining(src
) >= 1) {
3526 rxConfigMutable()->fpvCamAngleDegrees
= sbufReadU8(src
);
3528 if (sbufBytesRemaining(src
) >= 6) {
3529 // Added in MSP API 1.40
3530 sbufReadU8(src
); // not required in API 1.44, was rxConfigMutable()->rcSmoothingChannels
3531 #if defined(USE_RC_SMOOTHING_FILTER)
3532 sbufReadU8(src
); // not required in API 1.44, was rc_smoothing_type
3533 configRebootUpdateCheckU8(&rxConfigMutable()->rc_smoothing_setpoint_cutoff
, sbufReadU8(src
));
3534 configRebootUpdateCheckU8(&rxConfigMutable()->rc_smoothing_feedforward_cutoff
, sbufReadU8(src
));
3535 sbufReadU8(src
); // not required in API 1.44, was rc_smoothing_input_type
3536 sbufReadU8(src
); // not required in API 1.44, was rc_smoothing_derivative_type
3545 if (sbufBytesRemaining(src
) >= 1) {
3546 // Added in MSP API 1.40
3547 // Kept separate from the section above to work around missing Configurator support in version < 10.4.2
3548 #if defined(USE_USB_CDC_HID)
3549 usbDevConfigMutable()->type
= sbufReadU8(src
);
3554 if (sbufBytesRemaining(src
) >= 1) {
3555 // Added in MSP API 1.42
3556 #if defined(USE_RC_SMOOTHING_FILTER)
3557 // Added extra validation/range constraint for rc_smoothing_auto_factor as a workaround for a bug in
3558 // the 10.6 configurator where it was possible to submit an invalid out-of-range value. We might be
3559 // able to remove the constraint at some point in the future once the affected versions are deprecated
3560 // enough that the risk is low.
3561 configRebootUpdateCheckU8(&rxConfigMutable()->rc_smoothing_auto_factor_rpy
, constrain(sbufReadU8(src
), RC_SMOOTHING_AUTO_FACTOR_MIN
, RC_SMOOTHING_AUTO_FACTOR_MAX
));
3566 if (sbufBytesRemaining(src
) >= 1) {
3567 // Added in MSP API 1.44
3568 #if defined(USE_RC_SMOOTHING_FILTER)
3569 configRebootUpdateCheckU8(&rxConfigMutable()->rc_smoothing_mode
, sbufReadU8(src
));
3575 case MSP_SET_FAILSAFE_CONFIG
:
3576 failsafeConfigMutable()->failsafe_delay
= sbufReadU8(src
);
3577 failsafeConfigMutable()->failsafe_off_delay
= sbufReadU8(src
);
3578 failsafeConfigMutable()->failsafe_throttle
= sbufReadU16(src
);
3579 failsafeConfigMutable()->failsafe_switch_mode
= sbufReadU8(src
);
3580 failsafeConfigMutable()->failsafe_throttle_low_delay
= sbufReadU16(src
);
3581 failsafeConfigMutable()->failsafe_procedure
= sbufReadU8(src
);
3584 case MSP_SET_RXFAIL_CONFIG
:
3585 i
= sbufReadU8(src
);
3586 if (i
< MAX_SUPPORTED_RC_CHANNEL_COUNT
) {
3587 rxFailsafeChannelConfigsMutable(i
)->mode
= sbufReadU8(src
);
3588 rxFailsafeChannelConfigsMutable(i
)->step
= CHANNEL_VALUE_TO_RXFAIL_STEP(sbufReadU16(src
));
3590 return MSP_RESULT_ERROR
;
3594 case MSP_SET_RSSI_CONFIG
:
3595 rxConfigMutable()->rssi_channel
= sbufReadU8(src
);
3598 case MSP_SET_RX_MAP
:
3599 for (int i
= 0; i
< RX_MAPPABLE_CHANNEL_COUNT
; i
++) {
3600 rxConfigMutable()->rcmap
[i
] = sbufReadU8(src
);
3604 case MSP_SET_CF_SERIAL_CONFIG
:
3606 uint8_t portConfigSize
= sizeof(uint8_t) + sizeof(uint16_t) + (sizeof(uint8_t) * 4);
3608 if (dataSize
% portConfigSize
!= 0) {
3609 return MSP_RESULT_ERROR
;
3612 uint8_t remainingPortsInPacket
= dataSize
/ portConfigSize
;
3614 while (remainingPortsInPacket
--) {
3615 uint8_t identifier
= sbufReadU8(src
);
3617 serialPortConfig_t
*portConfig
= serialFindPortConfigurationMutable(identifier
);
3620 return MSP_RESULT_ERROR
;
3623 portConfig
->identifier
= identifier
;
3624 portConfig
->functionMask
= sbufReadU16(src
);
3625 portConfig
->msp_baudrateIndex
= sbufReadU8(src
);
3626 portConfig
->gps_baudrateIndex
= sbufReadU8(src
);
3627 portConfig
->telemetry_baudrateIndex
= sbufReadU8(src
);
3628 portConfig
->blackbox_baudrateIndex
= sbufReadU8(src
);
3632 case MSP2_COMMON_SET_SERIAL_CONFIG
: {
3634 return MSP_RESULT_ERROR
;
3636 unsigned count
= sbufReadU8(src
);
3637 unsigned portConfigSize
= (dataSize
- 1) / count
;
3638 unsigned expectedPortSize
= sizeof(uint8_t) + sizeof(uint32_t) + (sizeof(uint8_t) * 4);
3639 if (portConfigSize
< expectedPortSize
) {
3640 return MSP_RESULT_ERROR
;
3642 for (unsigned ii
= 0; ii
< count
; ii
++) {
3643 unsigned start
= sbufBytesRemaining(src
);
3644 uint8_t identifier
= sbufReadU8(src
);
3645 serialPortConfig_t
*portConfig
= serialFindPortConfigurationMutable(identifier
);
3648 return MSP_RESULT_ERROR
;
3651 portConfig
->identifier
= identifier
;
3652 portConfig
->functionMask
= sbufReadU32(src
);
3653 portConfig
->msp_baudrateIndex
= sbufReadU8(src
);
3654 portConfig
->gps_baudrateIndex
= sbufReadU8(src
);
3655 portConfig
->telemetry_baudrateIndex
= sbufReadU8(src
);
3656 portConfig
->blackbox_baudrateIndex
= sbufReadU8(src
);
3657 // Skip unknown bytes
3658 while (start
- sbufBytesRemaining(src
) < portConfigSize
&& sbufBytesRemaining(src
)) {
3665 #ifdef USE_LED_STRIP_STATUS_MODE
3666 case MSP_SET_LED_COLORS
:
3667 for (int i
= 0; i
< LED_CONFIGURABLE_COLOR_COUNT
; i
++) {
3668 hsvColor_t
*color
= &ledStripStatusModeConfigMutable()->colors
[i
];
3669 color
->h
= sbufReadU16(src
);
3670 color
->s
= sbufReadU8(src
);
3671 color
->v
= sbufReadU8(src
);
3676 #ifdef USE_LED_STRIP
3677 case MSP_SET_LED_STRIP_CONFIG
:
3679 i
= sbufReadU8(src
);
3680 if (i
>= LED_MAX_STRIP_LENGTH
|| dataSize
!= (1 + 4)) {
3681 return MSP_RESULT_ERROR
;
3683 #ifdef USE_LED_STRIP_STATUS_MODE
3684 ledConfig_t
*ledConfig
= &ledStripStatusModeConfigMutable()->ledConfigs
[i
];
3685 *ledConfig
= sbufReadU32(src
);
3686 reevaluateLedConfig();
3690 // API 1.41 - selected ledstrip_profile
3691 if (sbufBytesRemaining(src
) >= 1) {
3692 ledStripConfigMutable()->ledstrip_profile
= sbufReadU8(src
);
3698 #ifdef USE_LED_STRIP_STATUS_MODE
3699 case MSP_SET_LED_STRIP_MODECOLOR
:
3701 ledModeIndex_e modeIdx
= sbufReadU8(src
);
3702 int funIdx
= sbufReadU8(src
);
3703 int color
= sbufReadU8(src
);
3705 if (!setModeColor(modeIdx
, funIdx
, color
)) {
3706 return MSP_RESULT_ERROR
;
3713 memset(pilotConfigMutable()->name
, 0, ARRAYLEN(pilotConfig()->name
));
3714 for (unsigned int i
= 0; i
< MIN(MAX_NAME_LENGTH
, dataSize
); i
++) {
3715 pilotConfigMutable()->name
[i
] = sbufReadU8(src
);
3718 osdAnalyzeActiveElements();
3725 // Use seconds and milliseconds to make senders
3726 // easier to implement. Generating a 64 bit value
3727 // might not be trivial in some platforms.
3728 int32_t secs
= (int32_t)sbufReadU32(src
);
3729 uint16_t millis
= sbufReadU16(src
);
3730 rtcTime_t t
= rtcTimeMake(secs
, millis
);
3737 case MSP_SET_TX_INFO
:
3738 setRssiMsp(sbufReadU8(src
));
3742 #if defined(USE_BOARD_INFO)
3743 case MSP_SET_BOARD_INFO
:
3744 if (!boardInformationIsSet()) {
3745 uint8_t length
= sbufReadU8(src
);
3746 char boardName
[MAX_BOARD_NAME_LENGTH
+ 1];
3747 sbufReadData(src
, boardName
, MIN(length
, MAX_BOARD_NAME_LENGTH
));
3748 if (length
> MAX_BOARD_NAME_LENGTH
) {
3749 sbufAdvance(src
, length
- MAX_BOARD_NAME_LENGTH
);
3750 length
= MAX_BOARD_NAME_LENGTH
;
3752 boardName
[length
] = '\0';
3753 length
= sbufReadU8(src
);
3754 char manufacturerId
[MAX_MANUFACTURER_ID_LENGTH
+ 1];
3755 sbufReadData(src
, manufacturerId
, MIN(length
, MAX_MANUFACTURER_ID_LENGTH
));
3756 if (length
> MAX_MANUFACTURER_ID_LENGTH
) {
3757 sbufAdvance(src
, length
- MAX_MANUFACTURER_ID_LENGTH
);
3758 length
= MAX_MANUFACTURER_ID_LENGTH
;
3760 manufacturerId
[length
] = '\0';
3762 setBoardName(boardName
);
3763 setManufacturerId(manufacturerId
);
3764 persistBoardInformation();
3766 return MSP_RESULT_ERROR
;
3770 #if defined(USE_SIGNATURE)
3771 case MSP_SET_SIGNATURE
:
3772 if (!signatureIsSet()) {
3773 uint8_t signature
[SIGNATURE_LENGTH
];
3774 sbufReadData(src
, signature
, SIGNATURE_LENGTH
);
3775 setSignature(signature
);
3778 return MSP_RESULT_ERROR
;
3783 #endif // USE_BOARD_INFO
3784 #if defined(USE_RX_BIND)
3785 case MSP2_BETAFLIGHT_BIND
:
3786 if (!startRxBind()) {
3787 return MSP_RESULT_ERROR
;
3793 // we do not know how to handle the (valid) message, indicate error MSP $M!
3794 return MSP_RESULT_ERROR
;
3796 return MSP_RESULT_ACK
;
3799 static mspResult_e
mspCommonProcessInCommand(mspDescriptor_t srcDesc
, int16_t cmdMSP
, sbuf_t
*src
, mspPostProcessFnPtr
*mspPostProcessFn
)
3801 UNUSED(mspPostProcessFn
);
3802 const unsigned int dataSize
= sbufBytesRemaining(src
);
3803 UNUSED(dataSize
); // maybe unused due to compiler options
3806 #ifdef USE_TRANSPONDER
3807 case MSP_SET_TRANSPONDER_CONFIG
: {
3808 // Backward compatibility to BFC 3.1.1 is lost for this message type
3810 uint8_t provider
= sbufReadU8(src
);
3811 uint8_t bytesRemaining
= dataSize
- 1;
3813 if (provider
> TRANSPONDER_PROVIDER_COUNT
) {
3814 return MSP_RESULT_ERROR
;
3817 const uint8_t requirementIndex
= provider
- 1;
3818 const uint8_t transponderDataSize
= transponderRequirements
[requirementIndex
].dataLength
;
3820 transponderConfigMutable()->provider
= provider
;
3822 if (provider
== TRANSPONDER_NONE
) {
3826 if (bytesRemaining
!= transponderDataSize
) {
3827 return MSP_RESULT_ERROR
;
3830 if (provider
!= transponderConfig()->provider
) {
3831 transponderStopRepeating();
3834 memset(transponderConfigMutable()->data
, 0, sizeof(transponderConfig()->data
));
3836 for (unsigned int i
= 0; i
< transponderDataSize
; i
++) {
3837 transponderConfigMutable()->data
[i
] = sbufReadU8(src
);
3839 transponderUpdateData();
3844 case MSP_SET_VOLTAGE_METER_CONFIG
: {
3845 int8_t id
= sbufReadU8(src
);
3848 // find and configure an ADC voltage sensor
3850 int8_t voltageSensorADCIndex
;
3851 for (voltageSensorADCIndex
= 0; voltageSensorADCIndex
< MAX_VOLTAGE_SENSOR_ADC
; voltageSensorADCIndex
++) {
3852 if (id
== voltageMeterADCtoIDMap
[voltageSensorADCIndex
]) {
3857 if (voltageSensorADCIndex
< MAX_VOLTAGE_SENSOR_ADC
) {
3858 voltageSensorADCConfigMutable(voltageSensorADCIndex
)->vbatscale
= sbufReadU8(src
);
3859 voltageSensorADCConfigMutable(voltageSensorADCIndex
)->vbatresdivval
= sbufReadU8(src
);
3860 voltageSensorADCConfigMutable(voltageSensorADCIndex
)->vbatresdivmultiplier
= sbufReadU8(src
);
3862 // if we had any other types of voltage sensor to configure, this is where we'd do it.
3870 case MSP_SET_CURRENT_METER_CONFIG
: {
3871 int id
= sbufReadU8(src
);
3874 case CURRENT_METER_ID_BATTERY_1
:
3875 currentSensorADCConfigMutable()->scale
= sbufReadU16(src
);
3876 currentSensorADCConfigMutable()->offset
= sbufReadU16(src
);
3878 #ifdef USE_VIRTUAL_CURRENT_METER
3879 case CURRENT_METER_ID_VIRTUAL_1
:
3880 currentSensorVirtualConfigMutable()->scale
= sbufReadU16(src
);
3881 currentSensorVirtualConfigMutable()->offset
= sbufReadU16(src
);
3892 case MSP_SET_BATTERY_CONFIG
:
3893 batteryConfigMutable()->vbatmincellvoltage
= sbufReadU8(src
) * 10; // vbatlevel_warn1 in MWC2.3 GUI
3894 batteryConfigMutable()->vbatmaxcellvoltage
= sbufReadU8(src
) * 10; // vbatlevel_warn2 in MWC2.3 GUI
3895 batteryConfigMutable()->vbatwarningcellvoltage
= sbufReadU8(src
) * 10; // vbatlevel when buzzer starts to alert
3896 batteryConfigMutable()->batteryCapacity
= sbufReadU16(src
);
3897 batteryConfigMutable()->voltageMeterSource
= sbufReadU8(src
);
3898 batteryConfigMutable()->currentMeterSource
= sbufReadU8(src
);
3899 if (sbufBytesRemaining(src
) >= 6) {
3900 batteryConfigMutable()->vbatmincellvoltage
= sbufReadU16(src
);
3901 batteryConfigMutable()->vbatmaxcellvoltage
= sbufReadU16(src
);
3902 batteryConfigMutable()->vbatwarningcellvoltage
= sbufReadU16(src
);
3906 #if defined(USE_OSD)
3907 case MSP_SET_OSD_CONFIG
:
3909 const uint8_t addr
= sbufReadU8(src
);
3911 if ((int8_t)addr
== -1) {
3912 /* Set general OSD settings */
3914 vcdProfileMutable()->video_system
= sbufReadU8(src
);
3916 sbufReadU8(src
); // Skip video system
3918 #if defined(USE_OSD)
3919 osdConfigMutable()->units
= sbufReadU8(src
);
3922 osdConfigMutable()->rssi_alarm
= sbufReadU8(src
);
3923 osdConfigMutable()->cap_alarm
= sbufReadU16(src
);
3924 sbufReadU16(src
); // Skip unused (previously fly timer)
3925 osdConfigMutable()->alt_alarm
= sbufReadU16(src
);
3927 if (sbufBytesRemaining(src
) >= 2) {
3928 /* Enabled warnings */
3929 // API < 1.41 supports only the low 16 bits
3930 osdConfigMutable()->enabledWarnings
= sbufReadU16(src
);
3933 if (sbufBytesRemaining(src
) >= 4) {
3934 // 32bit version of enabled warnings (API >= 1.41)
3935 osdConfigMutable()->enabledWarnings
= sbufReadU32(src
);
3938 if (sbufBytesRemaining(src
) >= 1) {
3940 // selected OSD profile
3941 #ifdef USE_OSD_PROFILES
3942 changeOsdProfileIndex(sbufReadU8(src
));
3945 #endif // USE_OSD_PROFILES
3948 if (sbufBytesRemaining(src
) >= 1) {
3950 // OSD stick overlay mode
3952 #ifdef USE_OSD_STICK_OVERLAY
3953 osdConfigMutable()->overlay_radio_mode
= sbufReadU8(src
);
3956 #endif // USE_OSD_STICK_OVERLAY
3960 if (sbufBytesRemaining(src
) >= 2) {
3962 // OSD camera frame element width/height
3963 osdConfigMutable()->camera_frame_width
= sbufReadU8(src
);
3964 osdConfigMutable()->camera_frame_height
= sbufReadU8(src
);
3967 } else if ((int8_t)addr
== -2) {
3968 #if defined(USE_OSD)
3970 uint8_t index
= sbufReadU8(src
);
3971 if (index
> OSD_TIMER_COUNT
) {
3972 return MSP_RESULT_ERROR
;
3974 osdConfigMutable()->timers
[index
] = sbufReadU16(src
);
3976 return MSP_RESULT_ERROR
;
3978 #if defined(USE_OSD)
3979 const uint16_t value
= sbufReadU16(src
);
3981 /* Get screen index, 0 is post flight statistics, 1 and above are in flight OSD screens */
3982 const uint8_t screen
= (sbufBytesRemaining(src
) >= 1) ? sbufReadU8(src
) : 1;
3984 if (screen
== 0 && addr
< OSD_STAT_COUNT
) {
3985 /* Set statistic item enable */
3986 osdStatSetState(addr
, (value
!= 0));
3987 } else if (addr
< OSD_ITEM_COUNT
) {
3988 /* Set element positions */
3989 osdElementConfigMutable()->item_pos
[addr
] = value
;
3990 osdAnalyzeActiveElements();
3992 return MSP_RESULT_ERROR
;
3995 return MSP_RESULT_ERROR
;
4001 case MSP_OSD_CHAR_WRITE
:
4004 size_t osdCharacterBytes
;
4006 if (dataSize
>= OSD_CHAR_VISIBLE_BYTES
+ 2) {
4007 if (dataSize
>= OSD_CHAR_BYTES
+ 2) {
4008 // 16 bit address, full char with metadata
4009 addr
= sbufReadU16(src
);
4010 osdCharacterBytes
= OSD_CHAR_BYTES
;
4011 } else if (dataSize
>= OSD_CHAR_BYTES
+ 1) {
4012 // 8 bit address, full char with metadata
4013 addr
= sbufReadU8(src
);
4014 osdCharacterBytes
= OSD_CHAR_BYTES
;
4016 // 16 bit character address, only visible char bytes
4017 addr
= sbufReadU16(src
);
4018 osdCharacterBytes
= OSD_CHAR_VISIBLE_BYTES
;
4021 // 8 bit character address, only visible char bytes
4022 addr
= sbufReadU8(src
);
4023 osdCharacterBytes
= OSD_CHAR_VISIBLE_BYTES
;
4025 for (unsigned ii
= 0; ii
< MIN(osdCharacterBytes
, sizeof(chr
.data
)); ii
++) {
4026 chr
.data
[ii
] = sbufReadU8(src
);
4028 displayPort_t
*osdDisplayPort
= osdGetDisplayPort(NULL
);
4029 if (!osdDisplayPort
) {
4030 return MSP_RESULT_ERROR
;
4033 if (!displayWriteFontCharacter(osdDisplayPort
, addr
, &chr
)) {
4034 return MSP_RESULT_ERROR
;
4041 return mspProcessInCommand(srcDesc
, cmdMSP
, src
);
4043 return MSP_RESULT_ACK
;
4047 * Returns MSP_RESULT_ACK, MSP_RESULT_ERROR or MSP_RESULT_NO_REPLY
4049 mspResult_e
mspFcProcessCommand(mspDescriptor_t srcDesc
, mspPacket_t
*cmd
, mspPacket_t
*reply
, mspPostProcessFnPtr
*mspPostProcessFn
)
4051 int ret
= MSP_RESULT_ACK
;
4052 sbuf_t
*dst
= &reply
->buf
;
4053 sbuf_t
*src
= &cmd
->buf
;
4054 const int16_t cmdMSP
= cmd
->cmd
;
4055 // initialize reply by default
4056 reply
->cmd
= cmd
->cmd
;
4058 if (mspCommonProcessOutCommand(cmdMSP
, dst
, mspPostProcessFn
)) {
4059 ret
= MSP_RESULT_ACK
;
4060 } else if (mspProcessOutCommand(cmdMSP
, dst
)) {
4061 ret
= MSP_RESULT_ACK
;
4062 } else if ((ret
= mspFcProcessOutCommandWithArg(srcDesc
, cmdMSP
, src
, dst
, mspPostProcessFn
)) != MSP_RESULT_CMD_UNKNOWN
) {
4064 } else if (cmdMSP
== MSP_SET_PASSTHROUGH
) {
4065 mspFcSetPassthroughCommand(dst
, src
, mspPostProcessFn
);
4066 ret
= MSP_RESULT_ACK
;
4068 } else if (cmdMSP
== MSP_DATAFLASH_READ
) {
4069 mspFcDataFlashReadCommand(dst
, src
);
4070 ret
= MSP_RESULT_ACK
;
4073 ret
= mspCommonProcessInCommand(srcDesc
, cmdMSP
, src
, mspPostProcessFn
);
4075 reply
->result
= ret
;
4079 void mspFcProcessReply(mspPacket_t
*reply
)
4081 sbuf_t
*src
= &reply
->buf
;
4082 UNUSED(src
); // potentially unused depending on compile options.
4084 switch (reply
->cmd
) {
4087 uint8_t batteryVoltage
= sbufReadU8(src
);
4088 uint16_t mAhDrawn
= sbufReadU16(src
);
4089 uint16_t rssi
= sbufReadU16(src
);
4090 uint16_t amperage
= sbufReadU16(src
);
4093 UNUSED(batteryVoltage
);
4097 #ifdef USE_MSP_CURRENT_METER
4098 currentMeterMSPSet(amperage
, mAhDrawn
);