@spec factory_reset(options()) :: :ok | {:error, reason :: any()}

Reset the application data partition to its original state

This clears out the application data partition at a low level so that it will be reformatted on the next boot. If all application settings are stored on the partition, then this will be like a factory reset. Be aware that many settings are stored on the application data partition including network settings like WiFi SSIDs and passwords. Factory reset devices may not connect to the network afterwards.

@spec prevent_revert() :: :ok | {:error, reason :: any()}

Make it impossible to revert to the other partition

This wipes the opposite firmware partition and clears out metadata for it. Attempts to revert will fail. This is useful if loading a special firmware temporarily that shouldn't be used again even accidentally.

@spec revert(options()) :: :ok | {:error, reason :: any()} | no_return()

Revert to the previous firmware

This invokes the "revert" task in the ops.fw and then reboots (unless told otherwise). The revert task switches the active firmware partition to the opposite one so that future reboots use the previous firmware.

@spec validate() :: :ok | {:error, reason :: any()}

Validate the current partition

For Nerves systems that support automatic rollback of firmware versions, this marks the partition as good so that it will continue to be used on future boots.

Call Nerves.Runtime.validate_firmware/0 instead.