DJIGimbalState

@interface DJIGimbalState : NSObject

This class provides the current state of the gimbal.

  • The current gimbal attitude in degrees. Roll, pitch and yaw are 0 if the gimbal is level with the aircraft and points in the forward direction of the aircraft.

    Declaration

    Objective-C

    @property (readonly, nonatomic) DJIGimbalAttitude attitudeInDegrees;

  • Returns the gimbal’s roll fine-tune value. The range for the fine-tune value is [-10, 10] degrees. If the fine-tune value is negative, the gimbal will be fine tuned the specified number of degrees in the counterclockwise direction.

    Declaration

    Objective-C

    @property (readonly, nonatomic) float rollFineTuneInDegrees;

  • Returns the gimbal’s current work mode.

    Declaration

    Objective-C

    @property (readonly, nonatomic) DJIGimbalWorkMode workMode;

  • Returns whether the attitude has been reset. If the gimbal is not in the original position, this value will return NO.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isAttitudeReset;

  • YES if the gimbal calibration succeeded.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isCalibrationSuccessful;

  • YES if the gimbal is calibrating.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isCalibrating;

  • Calibration progress in percent. Supported by Phantom 4, Phantom 4 Pro, Inspire 2 and Osmo series.

    Declaration

    Objective-C

    @property (readonly, nonatomic) NSInteger calibrationProgress;

  • Returns whether the gimbal’s pitch value is at its limit.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isPitchAtStop;

  • Returns whether the gimbal’s roll value is at its limit.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isRollAtStop;

  • Returns whether the gimbal’s yaw value is at its limit.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isYawAtStop;

  • YES if the gimbal is currently testing payload balance. Only used by Ronin-MX.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isTestingBalance;

  • Returns the pitch axis balance test result. Only used by Ronin-MX.

    Declaration

    Objective-C

    @property (readonly, nonatomic) DJIGimbalBalanceTestResult pitchTestResult;

  • Returns the roll axis balance test result. Only used by Ronin-MX.

    Declaration

    Objective-C

    @property (readonly, nonatomic) DJIGimbalBalanceTestResult rollTestResult;

  • YES if the mobile device is mounted on the gimbal. Only used by Osmo Mobile.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isMobileDeviceMounted;

  • YES if one of the gimbal motors is overloaded. Only used by Osmo Mobile.

    Declaration

    Objective-C

    @property (readonly, nonatomic) BOOL isMotorOverloaded;

  • Returns the balance status of the gimbal. Only used by Osmo Mobile.

    Declaration

    Objective-C

    @property (readonly, nonatomic) DJIGimbalLoadingBalanceStatus balanceState;