UserStorage feature

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

user_storage.capabilities

Describes user storage supported capabilities.

Parameters:

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

Supported features.

_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:

with an up to date firmware

Triggered: only during the connection

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

user_storage.decryption

Result of the transmitted password

Parameters:

resultolympe.enums.user_storage.password_result

Result of the last transmitted password

_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:

with an up to date firmware

ANAFI Thermal:

with an up to date firmware

Triggered: By an encryption password command encryption_password()

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

user_storage.encryption_password

Transmit password when needed for unlocking encrypted file system

Parameters:

passwordstring

Password used for SD encryption

typeolympe.enums.user_storage.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:

with an up to date firmware

ANAFI Thermal:

with an up to date firmware

Result: Access to encrypted user storage is now possible

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

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

user_storage.format

Start format operation on the removable 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:

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:

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', _policy='wait')

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

user_storage.format_progress

Progress of the formatting command

Parameters:

stepolympe.enums.user_storage.formatting_step

The formatting step the format process is in.

percentageu8

The progress of the current step expressed in percent.

_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:

for firmware release versions 1.3.0

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.format_result(result=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage.format_result

Result of the formatting command

Parameters:

resultolympe.enums.user_storage.formatting_result

Result of the last formatting command

_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:

for firmware release versions 1.1.0

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.format_with_encryption(label, password, type, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage.format_with_encryption

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

Parameters:

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.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:

with an up to date firmware

ANAFI Thermal:

with an up to date firmware

Result: Encryption is configured and the media formatting is complete

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

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

user_storage.format_with_type

Start format operation on the removable 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:

labelstring

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

typeolympe.enums.user_storage.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:

for firmware release versions 1.3.0

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', _policy='wait') & format_result(result='success', _policy='wait') & format_progress(_policy='wait')

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

user_storage.info

Information on user-storage

Parameters:

namestring

The name of the media.

capacityu64

The capacity of the media in Bytes.

_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:

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.monitor(available_bytes=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage.monitor

Monitoring event advertising available space

Parameters:

available_bytesu64

The free space in Bytes on the media.

_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:

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.

event message olympe.messages.user_storage.sdcard_uuid(uuid=None, _policy='check_wait', _float_tol=(1e-07, 1e-09), _int_tol=0)

user_storage.sdcard_uuid

SDCard encryption UUID

Parameters:

uuidstring

SDCard UUID

_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:

with an up to date firmware

ANAFI Thermal:

with an up to date firmware

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

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

user_storage.start_monitoring

Start monitoring operation of the removable media.

Parameters:

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:

with an up to date firmware

Result: Monitor Events monitor() are triggered.

Expectations: monitor(_policy='wait')

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

user_storage.state

State of user-storage

Parameters:

physical_stateolympe.enums.user_storage.phy_state

The state of the physical media.

file_system_stateolympe.enums.user_storage.fs_state

The state of the data stored on media.

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

Details about removable 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.

_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:

with an up to date firmware

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

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

user_storage.stop_monitoring

Stop monitoring operation of the removable media.

Parameters:

_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:

with an up to date firmware

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

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

user_storage.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:

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

Supported formatting types.

_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:

for firmware release versions 1.3.0

Triggered: only during the connection

enum olympe.enums.user_storage.attribute

low_perf:

The removable media has low performance. (0)

encrypted:

The removable media is encrypted. (1)

enum olympe.enums.user_storage.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.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.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.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.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.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.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.password_usage

record:

Send password for record requirement (0)

usb:

Send password for usb mass storage requirement (1)

enum olympe.enums.user_storage.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)