Refactor DFU module, add English docs, normalize localization text

Author: Developer-RU

iOS/ESP32-DFU/ESP32-DFU/App/Localization.swift

@@ -15,7 +15,7 @@ enum AppLanguage: String, CaseIterable, Identifiable {
         switch self {
         case .system: return L("language.system")
         case .english: return "English"
-        case .russian: return "Русский"
+        case .russian: return "Russian"
         case .spanish: return "Español"
         case .german: return "Deutsch"
         case .french: return "Français"
@@ -92,67 +92,67 @@ private enum LocalizationTable {
         ],
         "ru": [
             "app.title": "ESP32 DFU",
-            "header.title": "Legacy DFU для ESP32",
-            "status.scan_on": "Сканирование BLE",
-            "status.scan_off": "Сканирование остановлено",
-            "status.dfu_running": "DFU выполняется",
-            "status.idle": "Ожидание",
-            "device.not_selected": "Устройство не выбрано",
-            "firmware.not_selected": "Файл не выбран",
-            "device.subtitle": "Выберите ESP32 в режиме DFU",
-            "firmware.subtitle": "Выберите firmware.bin",
-            "button.devices": "Устройства",
-            "button.file": "Файл",
-            "button.start_dfu": "Старт DFU",
-            "button.cancel": "Отмена",
-            "timeline.title": "Стадии прошивки",
-            "picker.title": "Выбор устройства",
-            "picker.scan_timeout": "Поиск завершится через %d сек",
-            "settings.title": "Настройки",
+            "header.title": "Legacy DFU for ESP32",
+            "status.scan_on": "BLE Scan On",
+            "status.scan_off": "BLE Scan Off",
+            "status.dfu_running": "DFU Running",
+            "status.idle": "Idle",
+            "device.not_selected": "No device selected",
+            "firmware.not_selected": "No file selected",
+            "device.subtitle": "Select ESP32 in DFU mode",
+            "firmware.subtitle": "Select firmware.bin",
+            "button.devices": "Devices",
+            "button.file": "File",
+            "button.start_dfu": "Start DFU",
+            "button.cancel": "Cancel",
+            "timeline.title": "Firmware stages",
+            "picker.title": "Device selection",
+            "picker.scan_timeout": "Scan will stop in %d sec",
+            "settings.title": "Settings",
             "settings.section.dfu": "DFU",
-            "settings.section.scan": "Сканирование BLE",
-            "settings.section.behavior": "Поведение",
-            "settings.section.language": "Язык",
-            "settings.section.info": "Инфо",
+            "settings.section.scan": "BLE Scanning",
+            "settings.section.behavior": "Behavior",
+            "settings.section.language": "Language",
+            "settings.section.info": "Info",
             "settings.prn": "PRN: %d",
             "settings.mtu": "MTU: %d",
-            "settings.scan_seconds": "Длительность поиска: %d сек",
-            "settings.auto_reconnect": "Авто-переподключение",
-            "settings.keep_screen_awake": "Не блокировать экран",
-            "settings.profile": "Профиль: Nordic Legacy DFU",
-            "settings.target": "Цель: ESP32 BLE OTA",
-            "settings.language_picker": "Язык приложения",
-            "language.system": "Системный",
-            "msg.select_device_file": "Выберите устройство и файл",
-            "msg.scan_finished_found": "Поиск завершен: найдено устройств %d",
-            "msg.scan_in_progress": "Сканируем BLE-устройства (до %d сек)",
-            "msg.need_device_and_firmware": "Нужно выбрать устройство и файл firmware",
-            "msg.bluetooth_unavailable": "Bluetooth выключен или недоступен",
-            "msg.unable_open_firmware": "Не удалось открыть файл прошивки: %@",
-            "msg.cancelled": "Операция отменена пользователем",
-            "msg.ble_retry": "Обрыв BLE. Повтор %d/%d",
-            "msg.dfu_error": "DFU завершился с ошибкой: %@",
-            "stage.idle.title": "Готово к DFU",
-            "stage.idle.details": "Выберите устройство и файл прошивки",
-            "stage.scanning.title": "Поиск устройства",
-            "stage.scanning.details": "Сканируем BLE-устройства поблизости",
-            "stage.connecting.title": "Подключение",
-            "stage.connecting.details": "Устанавливаем стабильное BLE-соединение",
-            "stage.bootloader.title": "Загрузка загрузчика DFU",
-            "stage.bootloader.details": "Переход устройства в режим обновления",
-            "stage.init.title": "Инициализация пакета",
-            "stage.init.details": "Передаем служебные метаданные DFU",
-            "stage.fw.title": "Загрузка firmware",
-            "stage.fw.details": "Отправляем бинарный файл по BLE",
-            "stage.validate.title": "Проверка пакета",
-            "stage.validate.details": "Проверяем целостность и размер",
-            "stage.activate.title": "Активация и перезапуск",
-            "stage.activate.details": "Переключаем слот прошивки и перезагружаем",
-            "stage.completed.title": "Обновление завершено",
-            "stage.completed.details": "Устройство готово с новой прошивкой",
-            "stage.failed.title": "Ошибка обновления",
-            "stage.failed.details": "Проверьте подключение и повторите",
-            "device.unknown": "Неизвестный ESP32"
+            "settings.scan_seconds": "Scan duration: %d sec",
+            "settings.auto_reconnect": "Auto reconnect",
+            "settings.keep_screen_awake": "Keep screen awake",
+            "settings.profile": "Profile: Nordic Legacy DFU",
+            "settings.target": "Target: ESP32 BLE OTA",
+            "settings.language_picker": "App language",
+            "language.system": "System",
+            "msg.select_device_file": "Select a device and firmware file",
+            "msg.scan_finished_found": "Scan finished: found %d devices",
+            "msg.scan_in_progress": "Scanning BLE devices (up to %d sec)",
+            "msg.need_device_and_firmware": "You need to select a device and a firmware file",
+            "msg.bluetooth_unavailable": "Bluetooth is off or unavailable",
+            "msg.unable_open_firmware": "Unable to open firmware file: %@",
+            "msg.cancelled": "Operation cancelled by user",
+            "msg.ble_retry": "BLE disconnected. Retry %d/%d",
+            "msg.dfu_error": "DFU failed: %@",
+            "stage.idle.title": "Ready for DFU",
+            "stage.idle.details": "Select a device and firmware file",
+            "stage.scanning.title": "Scanning devices",
+            "stage.scanning.details": "Scanning nearby BLE devices",
+            "stage.connecting.title": "Connecting",
+            "stage.connecting.details": "Establishing stable BLE connection",
+            "stage.bootloader.title": "Bootloader switch",
+            "stage.bootloader.details": "Switching device to update mode",
+            "stage.init.title": "Init packet",
+            "stage.init.details": "Sending DFU metadata",
+            "stage.fw.title": "Firmware upload",
+            "stage.fw.details": "Sending firmware binary over BLE",
+            "stage.validate.title": "Validation",
+            "stage.validate.details": "Checking firmware size and integrity",
+            "stage.activate.title": "Activate and reboot",
+            "stage.activate.details": "Switching OTA slot and rebooting",
+            "stage.completed.title": "Update complete",
+            "stage.completed.details": "Device is running new firmware",
+            "stage.failed.title": "Update failed",
+            "stage.failed.details": "Check connection and retry",
+            "device.unknown": "Unknown ESP32"
         ],
         "es": [
             "app.title": "ESP32 DFU",

iOS/ESP32-DFU/ESP32-DFU/Info.plist

@@ -34,9 +34,9 @@
         <string>bluetooth-central</string>
     </array>
     <key>NSBluetoothAlwaysUsageDescription</key>
-    <string>Приложение использует Bluetooth для поиска ESP32 и передачи DFU-прошивки.</string>
+    <string>The app uses Bluetooth to discover ESP32 devices and transfer DFU firmware.</string>
     <key>NSBluetoothPeripheralUsageDescription</key>
-    <string>Bluetooth нужен для подключения к ESP32 и обновления прошивки.</string>
+    <string>Bluetooth is required to connect to ESP32 and perform firmware updates.</string>
     <key>UILaunchStoryboardName</key>
     <string>LaunchScreen</string>
     <key>UISupportedInterfaceOrientations</key>

iOS/ESP32-DFU/README.md

@@ -1,31 +1,31 @@
-# ESP32-DFU iOS App
+# ESP32-DFU iOS Client
 
-SwiftUI-приложение для iPhone под BLE DFU обновление ESP32 (Legacy DFU профиль).
+SwiftUI iPhone application for BLE DFU firmware updates of ESP32 devices using the Legacy DFU profile.
 
-## Что реализовано
+## Implemented
 
-- Выбор BLE-устройства
-- Выбор файла прошивки (`firmware.bin`)
-- Индикатор прогресса
-- Таймлайн стадий прошивки:
-  - Поиск устройства
-  - Подключение
-  - Загрузка загрузчика DFU
-  - Инициализация пакета
-  - Загрузка firmware
-  - Проверка пакета
-  - Активация и перезапуск
-- Экран настроек (кнопка сверху справа)
-- Современный UI: градиентный фон, карточки, SF Symbols
+- BLE device discovery and selection
+- Firmware file selection (binary image)
+- DFU progress tracking
+- Stage timeline for the update pipeline
+- Cancellation and retry behavior
+- Localization and settings screen
 
-## Структура
+## Main Stack
 
-- `ESP32-DFU/App` — точка входа приложения
-- `ESP32-DFU/Models` — модели устройства и этапов DFU
-- `ESP32-DFU/Services` — BLE сканер и менеджер DFU с состояниями
-- `ESP32-DFU/Views` — UI-экраны
-- `ESP32-DFU/Resources` — ассеты и `Info.plist`
+- SwiftUI (UI)
+- CoreBluetooth (BLE transport)
+- Background restoration for more resilient sessions
 
-## Важно
+## Typical Flow
 
-Текущая версия содержит полный UX-флоу и состояние DFU. Транспортный слой можно подключить в `DFUSessionManager` в месте, отмеченном комментарием, для фактической отправки пакетов в характеристики Legacy DFU ESP32.
+1. Scan and select target ESP32 DFU device.
+2. Select firmware binary file.
+3. Start DFU session.
+4. Wait for transfer, validation, and activation.
+5. Observe completion or error diagnostics.
+
+## Notes
+
+This app is intended as a companion client for the firmware project in the repository root.
+For production releases, publish mobile client and firmware as separate versioned artifacts.

iOS/ESP32-DFU/REAL_DFU_TEST_PLAN.md

@@ -1,54 +1,53 @@
-# REAL DFU Test Plan (ESP32)
+# Real DFU Test Plan (ESP32 + iOS)
 
-Этот чеклист нужен для реальной проверки прошивки вашего ESP32 через iOS-приложение ESP32-DFU.
+## Goal
 
-## 1. Подготовка
+Validate stable and repeatable BLE DFU updates from iOS app to ESP32 firmware target.
 
-1. Собрать новую прошивку устройства:
-   - `pio run`
-2. Залить по USB базовую прошивку с DFU-сервисом:
-   - `pio run -t upload`
-3. Открыть UART-лог:
-   - `pio device monitor -b 115200`
-4. Собрать и запустить iOS-приложение на iPhone (не симулятор).
-5. Выбрать подписанную Team в Xcode для target `ESP32-DFU`.
+## Preconditions
 
-## 2. Базовый успешный сценарий
+- ESP32 is flashed with BLE DFU firmware.
+- iOS app has Bluetooth permissions granted.
+- Known-good firmware binary is available.
+- Device battery and phone battery are above safe thresholds.
 
-1. В приложении нажать `Устройства` и выбрать ESP32-DFU.
-2. Выбрать файл `.pio/build/esp32dev/firmware.bin`.
-3. Нажать `Старт DFU`.
-4. Убедиться, что стадии доходят до `Активация и перезапуск` и затем `Обновление завершено`.
-5. После перезагрузки ESP32 снова появляется в списке и реклама DFU активна.
+## Test Cases
 
-## 3. Проверка CRC/size валидации
+1. Happy path update
+- Discover device
+- Select valid firmware
+- Complete update to 100%
+- Verify reboot and new firmware behavior
 
-1. Создать поврежденную копию файла прошивки (изменить 1 байт в конце).
-2. Повторить запуск DFU с поврежденным файлом.
-3. Ожидаемый результат:
-   - DFU останавливается на стадии `Проверка пакета`.
-   - Приложение получает ошибку ответа Validate.
-   - ESP32 не переключает OTA слот (остается на рабочей прошивке).
+2. Wrong file handling
+- Select invalid/non-firmware file
+- Verify graceful error handling and no crash
 
-## 4. Проверка retry при обрыве BLE
+3. Interrupted transfer
+- Move out of BLE range during transfer
+- Verify timeout/failure handling and ability to retry
 
-1. Запустить DFU.
-2. Во время `Загрузка firmware` отойти с телефоном от устройства или временно выключить BLE на iPhone.
-3. Ожидаемый результат:
-   - Приложение показывает сообщение `Обрыв BLE. Повтор X/3`.
-   - Выполняется до 3 попыток переподключения.
+4. Cancellation
+- Start update and cancel mid-transfer
+- Verify progress reset and consistent state recovery
 
-## 5. Проверка фонового восстановления
+5. Reconnect and retry
+- After failure, reconnect and rerun update
+- Verify successful completion
 
-1. Запустить DFU и свернуть приложение.
-2. Через 10-20 секунд вернуть приложение на экран.
-3. Ожидаемый результат:
-   - Центральный менеджер восстанавливает состояние.
-   - DFU продолжается, если BLE-сессия не была потеряна.
+6. Multiple sequential updates
+- Run several updates in a row
+- Verify no memory growth symptoms and stable behavior
 
-## 6. Если обновление не стартует
+## Pass Criteria
 
-1. Проверить, что ESP32 рекламирует сервис UUID `00001530-1212-EFDE-1523-785FEABCD123`.
-2. Проверить, что выбран именно `firmware.bin` от текущей сборки.
-3. Перезапустить BLE на iPhone.
-4. Перезапустить ESP32 и повторить тест.
+- No app crashes
+- Deterministic stage transitions
+- Correct success/failure reporting
+- Firmware boots after successful update
+
+## Logging Recommendations
+
+- Capture serial logs from ESP32
+- Capture iOS debug logs for BLE and DFU states
+- Keep timestamps for correlation of events