Ardrone3.GPS*

command messageolympe.messages.ardrone3.GPSSettings.HomeType(type, _timeout=20, _no_expect=False, _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettings.HomeType

Set the preferred home type. Please note that this is only a preference. The actual type chosen is given by the event HomeTypeChosenChanged(). You can get the currently available types with the event HomeTypeAvailabilityChanged().

Parameters
  • type (olympe.enums.ardrone3.GPSSettings.HomeType_Type) –

  • _timeout (int) – command message timeout (defaults to 20)

  • _no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Result: The user choice is known by the drone. Then, event HomeTypeChanged() is triggered.

Expectations: HomeTypeChanged(type=self.type, _policy='wait')

command messageolympe.messages.ardrone3.GPSSettings.ResetHome(_timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettings.ResetHome

Reset home position.

Parameters
  • _timeout (int) – command message timeout (defaults to 10)

  • _no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Unsupported message

Todo

Remove unsupported message ardrone3.GPSSettings.ResetHome

Deprecated message

Warning

This message is deprecated and should no longer be used

Result: The home position is reset. Then, event ResetHomeChanged() is triggered.

command messageolympe.messages.ardrone3.GPSSettings.ReturnHomeDelay(delay, _timeout=20, _no_expect=False, _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettings.ReturnHomeDelay

Set the delay after which the drone will automatically try to return home after a disconnection.

Parameters
  • delay (u16) – Delay in second

  • _timeout (int) – command message timeout (defaults to 20)

  • _no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Result: The delay of the return home is set. Then, event ReturnHomeDelayChanged() is triggered.

Expectations: ReturnHomeDelayChanged(delay=self.delay, _policy='wait')

command messageolympe.messages.ardrone3.GPSSettings.ReturnHomeMinAltitude(value, _timeout=20, _no_expect=False, _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettings.ReturnHomeMinAltitude

Set the return home minimum altitude. If the drone is below this altitude when starting its return home, it will first reach the minimum altitude. If it is higher than this minimum altitude, it will operate its return home at its actual altitude.

Parameters
  • value (float) – Altitude in meters, relative to the take off point. Bounds are given by the event ReturnHomeMinAltitudeChanged().

  • _timeout (int) – command message timeout (defaults to 20)

  • _no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Result: The minimum altitude for the return home is set. Then, event ReturnHomeMinAltitudeChanged() is triggered.

Expectations: ReturnHomeMinAltitudeChanged(value=self.value, _policy='wait')

command messageolympe.messages.ardrone3.GPSSettings.SendControllerGPS(latitude, longitude, altitude, horizontalAccuracy=1.0, verticalAccuracy=1.0, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettings.SendControllerGPS

Set controller gps location. The user location might be used in case of return home, according to the home type and the accuracy of the given position. You can get the current home type with the event HomeTypeChanged().

Parameters
  • latitude (double) – GPS latitude in decimal degrees

  • longitude (double) – GPS longitude in decimal degrees

  • altitude (double) – GPS altitude in meters

  • horizontalAccuracy (double) – Horizontal Accuracy in meter ; equal -1 if no horizontal Accuracy

  • verticalAccuracy (double) – Vertical Accuracy in meter ; equal -1 if no vertical Accuracy

  • _timeout (int) – command message timeout (defaults to 10)

  • _no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Unsupported message

Todo

Remove unsupported message ardrone3.GPSSettings.SendControllerGPS

Result: The controller position is known by the drone. Then, event GPSFixStateChanged() is triggered.

Expectations: GPSFixStateChanged(_policy='wait')

command messageolympe.messages.ardrone3.GPSSettings.SetHome(latitude, longitude, altitude, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettings.SetHome

Set home position.

Parameters
  • latitude (double) – Home latitude in decimal degrees

  • longitude (double) – Home longitude in decimal degrees

  • altitude (double) – Home altitude in meters

  • _timeout (int) – command message timeout (defaults to 10)

  • _no_expect (bool) – if True for,do not expect the usual command expectation (defaults to False)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Unsupported message

Todo

Remove unsupported message ardrone3.GPSSettings.SetHome

Deprecated message

Warning

This message is deprecated and should no longer be used

enumolympe.enums.ardrone3.GPSSettings.HomeType_Type

The type of the home position

Enum aliases:

  • olympe.enums.ardrone3.HomeType_Type

  • olympe.enums.ardrone3.HomeTypeChanged_Type

TAKEOFF

The drone will try to return to the take off position (0)

PILOT

The drone will try to return to the pilot position (1)

FOLLOWEE

The drone will try to return to the target of the current (or last) follow me (2)

event messageolympe.messages.ardrone3.GPSSettingsState.GPSFixStateChanged(fixed=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.GPSFixStateChanged

Gps fix info.

Parameters
  • fixed (u8) – 1 if gps on drone is fixed, 0 otherwise

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Triggered on change.

event messageolympe.messages.ardrone3.GPSSettingsState.GPSUpdateStateChanged(state=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.GPSUpdateStateChanged

Gps update state.

Parameters
  • state (olympe.enums.ardrone3.GPSSettingsState.GPSUpdateStateChanged_State) –

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Unsupported message

Todo

Remove unsupported message ardrone3.GPSSettingsState.GPSUpdateStateChanged

Deprecated message

Warning

This message is deprecated and should no longer be used

Triggered on change.

event messageolympe.messages.ardrone3.GPSSettingsState.GeofenceCenterChanged(latitude=None, longitude=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.GeofenceCenterChanged

Geofence center location. This location represents the center of the geofence zone. This is updated at a maximum frequency of 1 Hz.

Parameters
  • latitude (double) – GPS latitude in decimal degrees

  • longitude (double) – GPS longitude in decimal degrees

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Unsupported message

Todo

Remove unsupported message ardrone3.GPSSettingsState.GeofenceCenterChanged

Triggered when HomeChanged() and when GpsLocationChanged() before takeoff.

event messageolympe.messages.ardrone3.GPSSettingsState.HomeChanged(latitude=None, longitude=None, altitude=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.HomeChanged

Home location.

Parameters
  • latitude (double) – Home latitude in decimal degrees

  • longitude (double) – Home longitude in decimal degrees

  • altitude (double) – Home altitude in meters

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Triggered when HomeTypeChosenChanged() changes. Or by SendControllerGPS() when HomeTypeChosenChanged() is Pilot. Or regularly after gps() when HomeTypeChosenChanged() is FollowMeTarget. Or at take off HomeTypeChosenChanged() is Takeoff. Or when the first fix occurs and the HomeTypeChosenChanged() is FirstFix.

event messageolympe.messages.ardrone3.GPSSettingsState.HomeTypeChanged(type=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.HomeTypeChanged

User preference for the home type. See HomeTypeChosenChanged() to get the drone actual home type.

Parameters
  • type (olympe.enums.ardrone3.GPSSettingsState.HomeTypeChanged_Type) –

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Triggered by HomeType().

event messageolympe.messages.ardrone3.GPSSettingsState.ResetHomeChanged(latitude=None, longitude=None, altitude=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.ResetHomeChanged

Home location has been reset.

Parameters
  • latitude (double) – Home latitude in decimal degrees

  • longitude (double) – Home longitude in decimal degrees

  • altitude (double) – Home altitude in meters

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Unsupported message

Todo

Remove unsupported message ardrone3.GPSSettingsState.ResetHomeChanged

Deprecated message

Warning

This message is deprecated and should no longer be used

Triggered by ResetHome().

event messageolympe.messages.ardrone3.GPSSettingsState.ReturnHomeDelayChanged(delay=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.ReturnHomeDelayChanged

Return home trigger delay. This delay represents the time after which the return home is automatically triggered after a disconnection.

Parameters
  • delay (u16) – Delay in second

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Triggered by ReturnHomeDelay().

event messageolympe.messages.ardrone3.GPSSettingsState.ReturnHomeMinAltitudeChanged(value=None, min=None, max=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSSettingsState.ReturnHomeMinAltitudeChanged

Minumum altitude for return home changed.

Parameters
  • value (float) – Current value in meters, relative to take off altitude.

  • min (float) – Lower bound in meters, relative to take off altitude.

  • max (float) – Upper bound in meters, relative to take off altitude.

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Triggered by ReturnHomeMinAltitude().

enumolympe.enums.ardrone3.GPSSettingsState.GPSUpdateStateChanged_State

The state of the gps update

updated

Drone GPS update succeed (0)

inProgress

Drone GPS update In progress (1)

failed

Drone GPS update failed (2)

enumolympe.enums.ardrone3.GPSSettingsState.HomeTypeChanged_Type

The type of the home position

Enum aliases:

  • olympe.enums.ardrone3.HomeType_Type

  • olympe.enums.ardrone3.HomeTypeChanged_Type

TAKEOFF

The drone will try to return to the take off position (0)

PILOT

The drone will try to return to the pilot position (1)

FOLLOWEE

The drone will try to return to the target of the current (or last) follow me (2)

event messageolympe.messages.ardrone3.GPSState.HomeTypeAvailabilityChanged(type=None, available=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSState.HomeTypeAvailabilityChanged

Home type availability.

Parameters
  • type (olympe.enums.ardrone3.GPSState.HomeTypeAvailabilityChanged_Type) –

  • available (u8) – 1 if this type is available, 0 otherwise

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Triggered when the availability of, at least, one type changes. This might be due to controller position availability, gps fix before take off or other reason.

event messageolympe.messages.ardrone3.GPSState.HomeTypeChosenChanged(type=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSState.HomeTypeChosenChanged

Home type. This choice is made by the drone, according to the HomeTypeChanged() and the HomeTypeAvailabilityChanged(). The drone will choose the type matching with the user preference only if this type is available. If not, it will chose a type in this order: FOLLOWEE ; TAKEOFF ; PILOT ; FIRST_FIX

Parameters
  • type (olympe.enums.ardrone3.GPSState.HomeTypeChosenChanged_Type) –

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Deprecated message

Warning

This message is deprecated and should no longer be used

Triggered when the return home type chosen by the drone changes. This might be produced by a user preference triggered by HomeType() or by a change in the HomeTypeAvailabilityChanged().

event messageolympe.messages.ardrone3.GPSState.NumberOfSatelliteChanged(numberOfSatellite=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))

Ardrone3.GPSState.NumberOfSatelliteChanged

Number of GPS satellites.

Parameters
  • numberOfSatellite (u8) – The number of satellite

  • _policy (olympe.arsdkng.expectations.ExpectPolicy) – specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

  • _float_tol (tuple) – specify the float comparison tolerance, a 2-tuple containing a relative tolerance float value and an absolute tolerate float value (default to (1e-07, 1e-09)). See python 3 stdlib math.isclose documentation for more information

Supported by:

Anafi/AnafiFPV

with an up to date firmware

AnafiThermal

with an up to date firmware

Triggered on change.

enumolympe.enums.ardrone3.GPSState.HomeTypeAvailabilityChanged_Type

The type of the return home

Enum aliases:

  • olympe.enums.ardrone3.HomeTypeAvailabilityChanged_Type

  • olympe.enums.ardrone3.HomeTypeChosenChanged_Type

TAKEOFF

The drone has enough information to return to the take off position (0)

PILOT

The drone has enough information to return to the pilot position (1)

FIRST_FIX

The drone has not enough information, it will return to the first GPS fix (2)

FOLLOWEE

The drone has enough information to return to the target of the current (or last) follow me (3)

enumolympe.enums.ardrone3.GPSState.HomeTypeChosenChanged_Type

The type of the return home chosen

Enum aliases:

  • olympe.enums.ardrone3.HomeTypeAvailabilityChanged_Type

  • olympe.enums.ardrone3.HomeTypeChosenChanged_Type

TAKEOFF

The drone will return to the take off position (0)

PILOT

The drone will return to the pilot position In this case, the drone will use the position given by ARDrone3-SendControllerGPS (1)

FIRST_FIX

The drone has not enough information, it will return to the first GPS fix (2)

FOLLOWEE

The drone will return to the target of the current (or last) follow me In this case, the drone will use the position of the target of the followMe (given by ControllerInfo-GPS) (3)