UserStorage V2 feature#

event messageolympe.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))#

user_storage_v2.capabilities

Describes user storage supported capabilities.

Parameters

  • storage_id (u8) – Id of the storage.

  • supported_features (BitfieldOf(olympe.enums.user_storage_v2.feature, u16)) – Supported features.

  • storage_type (olympe.enums.user_storage_v2.storage_type) – Storage type.

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 Ai

with an up to date firmware

Triggered only during the connection

event messageolympe.messages.user_storage_v2.decryption(storage_id=None, result=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#

user_storage_v2.decryption

Result of the transmitted password

Parameters

  • storage_id (u8) – Id of the storage.

  • result (olympe.enums.user_storage_v2.password_result) – Result of the last transmitted password

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 Ai

with an up to date firmware

Triggered By an encryption password command encryption_password()

command messageolympe.messages.user_storage_v2.encryption_password(storage_id, password, type, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#

user_storage_v2.encryption_password

Transmit password when needed for unlocking encrypted file system

Parameters

  • storage_id (u8) – Id of the storage.

  • password (string) – Password used for SD encryption

  • type (olympe.enums.user_storage_v2.password_usage) – Reason of password requirement

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

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 messageolympe.messages.user_storage_v2.format(storage_id, label, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#

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_id (u8) – Id of the storage.

  • label (string) – Label to set to the file system. If empty, label is set to the product name.

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

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 messageolympe.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))#

user_storage_v2.format_progress

Progress of the formatting command

Parameters

  • storage_id (u8) – Id of the storage.

  • step (olympe.enums.user_storage_v2.formatting_step) – The formatting step the format process is in.

  • percentage (u8) – The progress of the current step expressed in percent.

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 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 messageolympe.messages.user_storage_v2.format_result(storage_id=None, result=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#

user_storage_v2.format_result

Result of the formatting command

Parameters

  • storage_id (u8) – Id of the storage.

  • result (olympe.enums.user_storage_v2.formatting_result) – Result of the last formatting command

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 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 messageolympe.messages.user_storage_v2.format_with_encryption(storage_id, label, password, type, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#

user_storage_v2.format_with_encryption

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

Parameters

  • storage_id (u8) – Id of the storage.

  • label (string) – Label to set to the file system. If empty, label is set to the product name.

  • password (string) – Password used for SD card encryption

  • type (olympe.enums.user_storage_v2.formatting_type) – Formatting type.

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

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 messageolympe.messages.user_storage_v2.format_with_type(storage_id, label, type, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#

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_id (u8) – Id of the storage.

  • label (string) – Label to set to the file system. If empty, label is set to the product name.

  • type (olympe.enums.user_storage_v2.formatting_type) – Formatting type.

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

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 messageolympe.messages.user_storage_v2.info(storage_id=None, name=None, capacity=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#

user_storage_v2.info

Information on user-storage

Parameters

  • storage_id (u8) – Id of the storage.

  • name (string) – The name of the media.

  • capacity (u64) – The capacity of the media in Bytes.

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 Ai

with an up to date firmware

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

event messageolympe.messages.user_storage_v2.monitor(storage_id=None, available_bytes=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#

user_storage_v2.monitor

Monitoring event advertising available space

Parameters

  • storage_id (u8) – Id of the storage.

  • available_bytes (u64) – The free space in Bytes on the media.

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 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 messageolympe.messages.user_storage_v2.start_monitoring(storage_id, period, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#

user_storage_v2.start_monitoring

Start monitoring operation of the media.

Parameters

  • storage_id (u8) – Id of the storage.

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

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

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 messageolympe.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))#

user_storage_v2.state

State of user-storage

Parameters

  • storage_id (u8) – Id of the storage.

  • physical_state (olympe.enums.user_storage_v2.phy_state) – The state of the physical media.

  • file_system_state (olympe.enums.user_storage_v2.fs_state) – The state of the data stored on media.

  • attribute (BitfieldOf(olympe.enums.user_storage_v2.attribute, u8)) – Details about storage.

  • monitor_enabled (u8) – Boolean. 1 if monitoring is enabled, 0 if not.

  • monitor_period (u8) – Current period of monitoring if monitoring is enabled, 0 if not enabled.

  • fstype (string) – Details about filesystem type.

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 Ai

with an up to date firmware

Triggered During connection and when user storage internal state changes.

command messageolympe.messages.user_storage_v2.stop_monitoring(storage_id, _timeout=10, _no_expect=False, _float_tol=(1e-07, 1e-09))#

user_storage_v2.stop_monitoring

Stop monitoring operation of the media.

Parameters

  • storage_id (u8) – Id of the storage.

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

Supported by:

Anafi Ai

with an up to date firmware

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

event messageolympe.messages.user_storage_v2.storage_uuid(storage_id=None, uuid=None, list_flags=None, _policy='check_wait', _float_tol=(1e-07, 1e-09))#

user_storage_v2.storage_uuid

Storage encryption UUID

Parameters

  • storage_id (u8) – Id of the storage.

  • uuid (string) – Storage UUID

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 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 messageolympe.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))#

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_id (u8) – Id of the storage.

  • supported_types (BitfieldOf(olympe.enums.user_storage_v2.formatting_type, u8)) – Supported formatting types.

  • list_flags (BitfieldOf(olympe.enums.user_storage_v2.list_flags, u8)) –

  • _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 Ai

with an up to date firmware

Triggered only during the connection

enumolympe.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)

enumolympe.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)

enumolympe.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)

enumolympe.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)

enumolympe.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)

enumolympe.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)

enumolympe.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)

enumolympe.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)

enumolympe.enums.user_storage_v2.password_usage#
record

Send password for record requirement (0)

usb

Send password for usb mass storage requirement (1)

enumolympe.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)

enumolympe.enums.user_storage_v2.storage_type#
internal_storage

The internal storage. (0)

removable_storage

The SDcard. (1)