Fota recovery

README.md

@@ -116,3 +116,6 @@ To get started with the OpenEarable Flutter package, follow these steps:
 
 ## Add custom Wearable Support
 Learn more about how to add support for your own wearable devices in the [Adding Custom Wearable Support](https://github.com/OpenEarable/open_earable_flutter/blob/main/doc/ADD_CUSTOM_WEARABLE.md) documentation.
+
+## Firmware Updates
+Learn more about firmware-over-the-air updates in the [FOTA documentation](https://github.com/OpenEarable/open_earable_flutter/blob/main/doc/FOTA.md).

doc/CAPABILITIES.md

@@ -178,6 +178,31 @@ if (deviceIdentifierService != null) {
 }
 ```
 
+#### FotaCapability
+
+Provides the device-level abstraction for firmware update operations.
+
+```dart
+final fota = wearable.getCapability<FotaCapability>();
+if (fota != null) {
+  final request = fota.createFirmwareUpdateRequest(selectedFirmware);
+}
+```
+
+Use `createFirmwareUpdateRequest(...)` to build a wearable-specific update
+request without depending on the underlying FOTA backend.
+
+#### FotaSlotInfoCapability
+
+Provides firmware slot or image-table state for FOTA backends that expose it.
+
+```dart
+final slotInfo = wearable.getCapability<FotaSlotInfoCapability>();
+if (slotInfo != null) {
+  final slots = await slotInfo.readFirmwareSlots();
+}
+```
+
 ---
 
 ## Summary