UserStorage V2 feature

event message olympe.messages.user_storage_v2.capabilities(storage_id=None, supported_features=None, storage_type=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.capabilities

Describes user storage supported capabilities.

Parameters:

storage_idu8

Id of the storage.

supported_featuresBitfieldOf(olympe.enums.user_storage_v2.feature, u16)

Supported features.

storage_typeolympe.enums.user_storage_v2.storage_type

Storage type.

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: only during the connection

event message olympe.messages.user_storage_v2.decryption(storage_id=None, result=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.decryption

Result of the transmitted password

Parameters:

storage_idu8

Id of the storage.

resultolympe.enums.user_storage_v2.password_result

Result of the last transmitted password

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: By an encryption password command encryption_password()

command message olympe.messages.user_storage_v2.encryption_password(storage_id, password, type, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.encryption_password

Transmit password when needed for unlocking encrypted file system

Parameters:

storage_idu8

Id of the storage.

passwordstring

Password used for SD encryption

typeolympe.enums.user_storage_v2.password_usage

Reason of password requirement

_timeoutint

command message timeout (defaults to 10)

_no_expectbool

if True, do not expect the usual command expectation (defaults to False)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Result: Access to encrypted user storage is now possible

Expectations: decryption(result='success', storage_id=self.storage_id, _policy='wait')

command message olympe.messages.user_storage_v2.format(storage_id, label, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.format

Start format operation on the media. This could imply its repartitioning if needed. Can be done in state format_needed or, if capabilities() contains format_when_ready_allowed also in state ready.

Parameters:

storage_idu8

Id of the storage.

labelstring

Label to set to the file system. If empty, label is set to the product name.

_timeoutint

command message timeout (defaults to 10)

_no_expectbool

if True, do not expect the usual command expectation (defaults to False)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Result: Event state is triggered once operation is performed. Event progress is triggered once the operation has been started if capabilities() contains format_progress_evt_supported

Expectations: state(file_system_state='ready', storage_id=self.storage_id, _policy='wait')

event message olympe.messages.user_storage_v2.format_progress(storage_id=None, step=None, percentage=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.format_progress

Progress of the formatting command

Parameters:

storage_idu8

Id of the storage.

stepolympe.enums.user_storage_v2.formatting_step

The formatting step the format process is in.

percentageu8

The progress of the current step expressed in percent.

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: By a formatting command format() or a formatting with type command format_with_type() only if this event is supported by the drone. To know if supported, see if capabilities() contains format_progress_evt_supported.

event message olympe.messages.user_storage_v2.format_result(storage_id=None, result=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.format_result

Result of the formatting command

Parameters:

storage_idu8

Id of the storage.

resultolympe.enums.user_storage_v2.formatting_result

Result of the last formatting command

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: By a formatting command format() or a formatting with type command format_with_type() only if this event is supported by the drone. To know if supported, see if capabilities() contains format_result_evt_supported.

command message olympe.messages.user_storage_v2.format_with_encryption(storage_id, label, password, type, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.format_with_encryption

Start format operation for encryption of the media with the given password

Parameters:

storage_idu8

Id of the storage.

labelstring

Label to set to the file system. If empty, label is set to the product name.

passwordstring

Password used for SD card encryption

typeolympe.enums.user_storage_v2.formatting_type

Formatting type.

_timeoutint

command message timeout (defaults to 10)

_no_expectbool

if True, do not expect the usual command expectation (defaults to False)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Result: Encryption is configured and the media formatting is complete

Expectations: state(file_system_state='ready', storage_id=self.storage_id, _policy='wait') & format_result(result='success', storage_id=self.storage_id, _policy='wait') & format_progress(storage_id=self.storage_id, _policy='wait')

command message olympe.messages.user_storage_v2.format_with_type(storage_id, label, type, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.format_with_type

Start format operation on the media given a formatting type. This could imply its repartitioning if needed. Can be done in state format_needed or, if capabilities() contains format_when_ready_allowed also in state ready.

Parameters:

storage_idu8

Id of the storage.

labelstring

Label to set to the file system. If empty, label is set to the product name.

typeolympe.enums.user_storage_v2.formatting_type

Formatting type.

_timeoutint

command message timeout (defaults to 10)

_no_expectbool

if True, do not expect the usual command expectation (defaults to False)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Result: Event state is triggered once operation is performed. Event progress is triggered once the operation has been started if capabilities() contains format_progress_evt_supported

Expectations: state(file_system_state='ready', storage_id=self.storage_id, _policy='wait') & format_result(result='success', storage_id=self.storage_id, _policy='wait') & format_progress(storage_id=self.storage_id, _policy='wait')

event message olympe.messages.user_storage_v2.info(storage_id=None, name=None, capacity=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.info

Information on user-storage

Parameters:

storage_idu8

Id of the storage.

namestring

The name of the media.

capacityu64

The capacity of the media in Bytes.

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: During formatting, on ready state, or if user storage is not available.

event message olympe.messages.user_storage_v2.monitor(storage_id=None, available_bytes=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.monitor

Monitoring event advertising available space

Parameters:

storage_idu8

Id of the storage.

available_bytesu64

The free space in Bytes on the media.

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: By a start monitoring command start_monitoring(). This event is sent every monitor_period (see state() until the stop monitoring command stop_monitoring() is received.

command message olympe.messages.user_storage_v2.start_monitoring(storage_id, period, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.start_monitoring

Start monitoring operation of the media.

Parameters:

storage_idu8

Id of the storage.

periodu8

Period in seconds to send monitor events. If set to 0, period is set to default value (one second).

_timeoutint

command message timeout (defaults to 10)

_no_expectbool

if True, do not expect the usual command expectation (defaults to False)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Result: Monitor Events monitor() are triggered.

Expectations: monitor(storage_id=self.storage_id, _policy='wait')

event message olympe.messages.user_storage_v2.state(storage_id=None, physical_state=None, file_system_state=None, attribute=None, monitor_enabled=None, monitor_period=None, fstype=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.state

State of user-storage

Parameters:

storage_idu8

Id of the storage.

physical_stateolympe.enums.user_storage_v2.phy_state

The state of the physical media.

file_system_stateolympe.enums.user_storage_v2.fs_state

The state of the data stored on media.

attributeBitfieldOf(olympe.enums.user_storage_v2.attribute, u8)

Details about storage.

monitor_enabledu8

Boolean. 1 if monitoring is enabled, 0 if not.

monitor_periodu8

Current period of monitoring if monitoring is enabled, 0 if not enabled.

fstypestring

Details about filesystem type.

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: During connection and when user storage internal state changes.

command message olympe.messages.user_storage_v2.stop_monitoring(storage_id, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.stop_monitoring

Stop monitoring operation of the media.

Parameters:

storage_idu8

Id of the storage.

_timeoutint

command message timeout (defaults to 10)

_no_expectbool

if True, do not expect the usual command expectation (defaults to False)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Result: Monitor Events monitor() are stopped from being triggered.

event message olympe.messages.user_storage_v2.storage_uuid(storage_id=None, uuid=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.storage_uuid

Storage encryption UUID

Parameters:

storage_idu8

Id of the storage.

uuidstring

Storage UUID

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: On connection if storage is encrypted, after format_with_encryption() or when the file_system field of state() switches to password_needed

event message olympe.messages.user_storage_v2.supported_formatting_types(storage_id=None, supported_types=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage_v2.supported_formatting_types

Describes user storage supported formatting types. When sent, it indicates that the format_with_type command is supported. If not sent, the format_with_type command is not supported.

Parameters:

storage_idu8

Id of the storage.

supported_typesBitfieldOf(olympe.enums.user_storage_v2.formatting_type, u8)

Supported formatting types.

list_flags : BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)

_policyolympe.messaging.arsdk_expectations.ExpectPolicy

specify how to check the expectation. Possible values are ‘check’, ‘wait’ and ‘check_wait’ (defaults to ‘check_wait’)

_float_toltuple

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

_matching_modeolympe.MatchingMode

specify the expectation matching mode (default to olympe.MatchingMode.pattern)

_int_tolint

specify the int comparison tolerance, an int containing an absolute tolerate int value (default to 0)

Supported by:

ANAFI Ai:

with an up to date firmware

Triggered: only during the connection

enum olympe.enums.user_storage_v2.attribute

low_perf:

The media has low performance. (0)

encrypted:

The media is encrypted. (1)

check_error:

There were errors during file system checking. (2)

enum olympe.enums.user_storage_v2.feature

format_when_ready_allowed:

Format is available when state is ready (and also, as usual when state is format_needed). (0)

format_result_evt_supported:

The format result event is supported and will be sent after a format has been asked. (1)

format_progress_evt_supported:

The format progress event is supported and will be sent during format operation. (2)

encryption_supported:

SD card encryption is supported. (3)

enum olympe.enums.user_storage_v2.formatting_result

error:

The last formatting command failed (0)

denied:

The last formatting command was denied (1)

success:

The last formatting command succeeded (2)

enum olympe.enums.user_storage_v2.formatting_step

partitioning:

The drone is currently partitioning the media. (0)

clearing_data:

The drone is currently wiping data on the media in order to optimize performance. (1)

creating_fs:

The drone is creating a file system on the media. (2)

enum olympe.enums.user_storage_v2.formatting_type

full:

Formatting which includes deep format operation that is time consuming but optimizes performance. (0)

quick:

Formatting which removes content of the media. (1)

enum olympe.enums.user_storage_v2.fs_state

unknown:

The media file system state is not known (yet) (0)

format_needed:

The media file system is not supported, unformatted or capacity is too low. (1)

formatting:

The media file system is getting formatted. (2)

ready:

The media file system is ready to be used. (3)

error:

The media file system is not available. (4)

password_needed:

The media file system needs a password for decryption. (5)

checking:

The media file system is being checked (6)

external_access_ok:

The media file system is not managed by the drone itself but accessible by external means. (7)

enum olympe.enums.user_storage_v2.list_flags

Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages

First:

Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (0)

Last:

Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (1)

Empty:

Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (2)

Remove:

Arsdk built-in “list_flags” enum that is used to in “LIST_ITEM” event messages (3)

enum olympe.enums.user_storage_v2.password_result

wrong_password:

The transmitted password is wrong (0)

success:

The transmitted password is correct (1)

wrong_usage:

The usage specified with the password does not match with the current drone context (RECORD or MASS STORAGE) (2)

enum olympe.enums.user_storage_v2.password_usage

record:

Send password for record requirement (0)

usb:

Send password for usb mass storage requirement (1)

enum olympe.enums.user_storage_v2.phy_state

undetected:

The removable media is not detected. (0)

too_small:

The removable media is too small for operation. (1)

too_slow:

The removable media is too slow for operation. (2)

available:

The removable media is detected. (3)

usb_mass_storage:

The removable media is used by mass-storage gadget. (4)

enum olympe.enums.user_storage_v2.storage_type

internal_storage:

The internal storage. (0)

removable_storage:

The SDcard. (1)