RemoteControlCalibration.qml

Go to the documentation of this file.

import QtQuick
import QtQuick.Controls
import QtQuick.Dialogs
import QtQuick.Layouts
 
import QGroundControl
import QGroundControl.FactControls
import QGroundControl.Controls
 
/// Base class for Remote Control Calibration (supports both RC and Joystick)
ColumnLayout {
    required property var controller
    property Component additionalSetupComponent
    property Component additionalMonitorComponent
 
    // Controllers need access to these UI elements
    property alias statusText: statusText
    property alias cancelButton: cancelButton
    property alias nextButton: nextButton
 
    id: root
    spacing: ScreenTools.defaultFontPixelHeight
 
    property bool useDeadband: false
 
    property real _channelValueDisplayWidth: ScreenTools.defaultFontPixelWidth * 30
    property bool _deadbandActive: useDeadband
 
    QGCPalette { id: qgcPal; colorGroupEnabled: root.enabled }
 
    RowLayout {
        // Left Column - Attitude Controls display
        ColumnLayout {
            Layout.alignment: Qt.AlignTop
            spacing: ScreenTools.defaultFontPixelHeight
 
            ColumnLayout {
                id: attitudeControlsLayout
                Layout.fillWidth: true
                spacing: ScreenTools.defaultFontPixelHeight
 
                QGCLabel { text: qsTr("Attitude Controls") }
 
                Repeater {
                    model: [
                        { name: qsTr("Pitch"),      mapped: controller.pitchChannelMapped,      value: controller.adjustedPitchChannelValue,      deadband: controller.pitchDeadband },
                        { name: qsTr("Roll"),       mapped: controller.rollChannelMapped,       value: controller.adjustedRollChannelValue,       deadband: controller.rollDeadband },
                        { name: qsTr("Yaw"),        mapped: controller.yawChannelMapped,        value: controller.adjustedYawChannelValue,        deadband: controller.yawDeadband },
                        { name: qsTr("Throttle"),   mapped: controller.throttleChannelMapped,   value: controller.adjustedThrottleChannelValue,   deadband: controller.throttleDeadband }
                    ]
 
                    RowLayout {
                        Layout.fillWidth: true
 
                        QGCLabel {
                            Layout.fillWidth: true
                            text: modelData.name
                        }
 
                        RemoteControlChannelValueDisplay {
                            Layout.preferredWidth: root._channelValueDisplayWidth
                            mode: RemoteControlChannelValueDisplay.MappedValue
                            channelValueMin: controller.channelValueMin
                            channelValueMax: controller.channelValueMax
                            channelMapped: modelData.mapped
                            channelValue: modelData.value
                            deadbandValue: modelData.deadband
                            deadbandEnabled: root._deadbandActive
                        }
                    }
                }
 
                QGCLabel {
                    text: qsTr("Aux Extensions")
                    visible: controller.pitchExtensionEnabled || controller.rollExtensionEnabled
                }
 
                Repeater {
                    model: [
                        { name: qsTr("Pitch"),  extensionEnabled: controller.pitchExtensionEnabled, mapped: controller.pitchExtensionChannelMapped, value: controller.adjustedPitchExtensionChannelValue,   deadband: controller.pitchExtensionDeadband },
                        { name: qsTr("Roll"),   extensionEnabled: controller.rollExtensionEnabled,  mapped: controller.rollExtensionChannelMapped,  value: controller.adjustedRollExtensionChannelValue,    deadband: controller.rollExtensionDeadband },
                    ]
 
                    RowLayout {
                        Layout.fillWidth: true
                        visible: modelData.extensionEnabled
 
                        QGCLabel {
                            Layout.fillWidth: true
                            text: modelData.name
                        }
 
                        RemoteControlChannelValueDisplay {
                            Layout.preferredWidth: root._channelValueDisplayWidth
                            mode: RemoteControlChannelValueDisplay.MappedValue
                            channelValueMin: controller.channelValueMin
                            channelValueMax: controller.channelValueMax
                            channelMapped: modelData.mapped
                            channelValue: modelData.value
                            deadbandValue: modelData.deadband
                            deadbandEnabled: root._deadbandActive
                        }
                    }
                }
 
                QGCLabel {
                    text: qsTr("Additional Axes")
                    visible: controller.additionalAxis1Enabled || controller.additionalAxis2Enabled || controller.additionalAxis3Enabled ||
                             controller.additionalAxis4Enabled || controller.additionalAxis5Enabled || controller.additionalAxis6Enabled
                }
 
                Repeater {
                    model: [
                        { name: qsTr("Aux 1"),  extensionEnabled: controller.additionalAxis1Enabled,  mapped: controller.additionalAxis1ChannelMapped,  value: controller.adjustedAdditionalAxis1ChannelValue,    deadband: controller.additionalAxis1Deadband },
                        { name: qsTr("Aux 2"),  extensionEnabled: controller.additionalAxis2Enabled,  mapped: controller.additionalAxis2ChannelMapped,  value: controller.adjustedAdditionalAxis2ChannelValue,    deadband: controller.additionalAxis2Deadband },
                        { name: qsTr("Aux 3"),  extensionEnabled: controller.additionalAxis3Enabled,  mapped: controller.additionalAxis3ChannelMapped,  value: controller.adjustedAdditionalAxis3ChannelValue,    deadband: controller.additionalAxis3Deadband },
                        { name: qsTr("Aux 4"),  extensionEnabled: controller.additionalAxis4Enabled,  mapped: controller.additionalAxis4ChannelMapped,  value: controller.adjustedAdditionalAxis4ChannelValue,    deadband: controller.additionalAxis4Deadband },
                        { name: qsTr("Aux 5"),  extensionEnabled: controller.additionalAxis5Enabled,  mapped: controller.additionalAxis5ChannelMapped,  value: controller.adjustedAdditionalAxis5ChannelValue,    deadband: controller.additionalAxis5Deadband },
                        { name: qsTr("Aux 6"),  extensionEnabled: controller.additionalAxis6Enabled,  mapped: controller.additionalAxis6ChannelMapped,  value: controller.adjustedAdditionalAxis6ChannelValue,    deadband: controller.additionalAxis6Deadband }
                    ]
 
                    RowLayout {
                        Layout.fillWidth: true
                        visible: modelData.extensionEnabled
 
                        QGCLabel {
                            Layout.fillWidth: true
                            text: modelData.name
                        }
 
                        RemoteControlChannelValueDisplay {
                            Layout.preferredWidth: root._channelValueDisplayWidth
                            mode: RemoteControlChannelValueDisplay.MappedValue
                            channelValueMin: controller.channelValueMin
                            channelValueMax: controller.channelValueMax
                            channelMapped: modelData.mapped
                            channelValue: modelData.value
                            deadbandValue: modelData.deadband
                            deadbandEnabled: root._deadbandActive
                        }
                    }
                }
            }
        }
 
        // Right Column - Stick Display
        ColumnLayout {
            Layout.alignment: Qt.AlignTop
            spacing: ScreenTools.defaultFontPixelHeight / 2
 
            Rectangle {
                id: stickDisplayContainer
                implicitWidth: stickDisplayLayout.width + _margins * 2
                implicitHeight: stickDisplayLayout.height + _margins * 2
                border.color: qgcPal.text
                border.width: 1
                color: qgcPal.window
                radius: ScreenTools.defaultBorderRadius
 
                property real _margins: ScreenTools.defaultFontPixelHeight / 2
                property real _stickAdjust: leftStickDisplay.width / 2 - _margins * 1.25
 
                ColumnLayout {
                    id: stickDisplayLayout
                    anchors.leftMargin: stickDisplayContainer._margins
                    anchors.topMargin: stickDisplayContainer._margins
                    anchors.left: parent.left
                    anchors.top: parent.top
                    spacing: stickDisplayContainer._margins
 
                    RowLayout {
                        spacing: ScreenTools.defaultFontPixelWidth * 2
 
                        QGCComboBox {
                            id: transmitterModeComboBox
                            model: [ qsTr("Mode 1"), qsTr("Mode 2"), qsTr("Mode 3"), qsTr("Mode 4") ]
                            enabled: !controller.calibrating
 
                            onActivated: (index) => controller.transmitterMode = index + 1
 
                            Component.onCompleted: currentIndex = controller.transmitterMode - 1
                        }
 
                        QGCCheckBox {
                            id: centeredThrottleCheckBox
                            text: qsTr("Centered Throttle")
                            checked: controller.centeredThrottle
                            enabled: !controller.calibrating
                            visible: !controller.joystickMode
 
                            onClicked: controller.centeredThrottle = checked
                        }
                    }
 
                    RowLayout {
                        Layout.fillWidth: true
                        spacing: stickDisplayContainer._margins * 2
 
                        Rectangle {
                            id: leftStickDisplay
                            Layout.alignment: Qt.AlignLeft
                            implicitWidth: ScreenTools.defaultFontPixelHeight * 5
                            implicitHeight: implicitWidth
                            radius: implicitWidth / 2
                            border.color: qgcPal.buttonHighlight
                            border.width: 1
                            color: qgcPal.window
 
                            Rectangle {
                                x: parent.width / 2 + stickDisplayContainer._stickAdjust * controller.stickDisplayPositions[0] - width / 2
                                y: parent.height / 2 + stickDisplayContainer._stickAdjust * -controller.stickDisplayPositions[1] - height / 2
                                width: ScreenTools.defaultFontPixelHeight
                                height: width
                                radius: width / 2
                                color: qgcPal.buttonHighlight
                            }
                        }
 
                        Rectangle {
                            Layout.alignment: Qt.AlignRight
                            implicitWidth: leftStickDisplay.implicitWidth
                            implicitHeight: implicitWidth
                            radius: implicitWidth / 2
                            border.color: qgcPal.buttonHighlight
                            border.width: 1
                            color: qgcPal.window
                            visible: !controller.singleStickDisplay
 
                            Rectangle {
                                x: parent.width / 2 + stickDisplayContainer._stickAdjust * controller.stickDisplayPositions[2] - width / 2
                                y: parent.height / 2 + stickDisplayContainer._stickAdjust * -controller.stickDisplayPositions[3] - height / 2
                                width: ScreenTools.defaultFontPixelHeight
                                height: width
                                radius: width / 2
                                color: qgcPal.buttonHighlight
                            }
                        }
                    }
                }
            }
        }
    }
 
    // Command Buttons and Status Text
    RowLayout {
        Layout.preferredWidth: parent.width
        spacing: ScreenTools.defaultFontPixelWidth
 
        QGCButton {
            id: cancelButton
            text: qsTr("Cancel")
            onClicked: controller.cancelButtonClicked()
        }
 
        QGCButton {
            text: qsTr("One-Sided")
            visible: controller.oneSidedButtonVisible
            onClicked: controller.oneSidedButtonClicked()
        }
 
        QGCButton {
            id: nextButton
            primary: true
            text: qsTr("Calibrate")
 
            onClicked: {
                if (text === qsTr("Calibrate")) {
                    if (controller.channelCount < controller.minChannelCount) {
                        let errorMessage = ""
                        let title = ""
                        if (controller.joystickMode) {
                            title = qsTr("Joystick Not Ready")
                            errorMessage = qsTr("%1 axes or more are needed to fly. Joystick is reporting %2 axes.").arg(controller.minChannelCount).arg(controller.channelCount)
                        } else {
                            title = qsTr("Not Ready")
                            errorMessage = controller.channelCount === 0 ? qsTr("Please turn on RC transmitter.") : qsTr("%1 channels or more are needed to fly.").arg(controller.minChannelCount)
                        }
                        QGroundControl.showMessageDialog(root, title, errorMessage)
                        return
                    } else if (!controller.joystickMode) {
                        QGroundControl.showMessageDialog(root, qsTr("Zero Trims"),
                                                        qsTr("Before calibrating you should zero all your trims and subtrims. Click Ok to start Calibration.\n\n%1").arg(
                                                            (QGroundControl.multiVehicleManager.activeVehicle.px4Firmware ? "" : qsTr("Please ensure all motor power is disconnected AND all props are removed from the vehicle."))),
                                                        Dialog.Ok,
                                                        function() { controller.nextButtonClicked() })
                        return
                    }
                }
                controller.nextButtonClicked()
            }
        }
 
        QGCLabel {
            id: statusText
            Layout.fillWidth: true
            wrapMode: Text.WordWrap
        }
    }
 
    Rectangle {
        id: separator
        Layout.fillWidth: true
        implicitHeight: 1
        color: qgcPal.text
    }
 
    // Additional Setup + Channel Monitor
    RowLayout {
        Layout.fillWidth: true
        spacing: ScreenTools.defaultFontPixelHeight
 
 
        Item {
            Layout.fillWidth: true
            implicitHeight: 1
            visible: additionalSetupComponent === undefined
        }
 
        Loader {
            id: additionalSetupLoader
            Layout.alignment: Qt.AlignTop
            sourceComponent: additionalSetupComponent
        }
 
        ColumnLayout {
            Layout.alignment: Qt.AlignTop
            Layout.fillWidth: true
            spacing: ScreenTools.defaultFontPixelHeight
 
            RemoteControlChannelMonitor {
                id: channelMonitor
                Layout.fillWidth: true
                twoColumn: false
                channelCount: controller.channelCount
                channelValueMin: controller.channelValueMin
                channelValueMax: controller.channelValueMax
 
                Connections {
                    target: controller
                    onRawChannelValueChanged: (channel, channelValue) => channelMonitor.rawChannelValueChanged(channel, channelValue)
                }
            }
 
            Loader {
                id: additionalMonitorLoader
                Layout.preferredWidth: parent.width
                sourceComponent: additionalMonitorComponent
            }
        }
    }
}