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;