From d655b13416c0235997fa4ac2ba83fb82013e3aae Mon Sep 17 00:00:00 2001 From: km2023 Date: Mon, 13 Apr 2026 12:09:22 +0800 Subject: [PATCH] feat: implement Android BLE SDK with demo app Complete Android port of duooomi-ios-sdk with 1:1 API parity. Includes SDK library module and Jetpack Compose demo app. Co-Authored-By: Claude Opus 4.6 --- .gitignore | 7 + README.md | 213 +++++++ build.gradle.kts | 5 + demo/build.gradle.kts | 49 ++ demo/src/main/AndroidManifest.xml | 33 ++ .../kotlin/com/duooomi/ble/demo/DemoScreen.kt | 453 +++++++++++++++ .../com/duooomi/ble/demo/MainActivity.kt | 61 ++ gradle.properties | 3 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 43462 bytes gradle/wrapper/gradle-wrapper.properties | 7 + gradlew | 124 ++++ gradlew.bat | 92 +++ sdk/build.gradle.kts | 27 + sdk/src/main/AndroidManifest.xml | 16 + .../com/duooomi/ble/DuooomiBleConfig.kt | 12 + .../kotlin/com/duooomi/ble/DuooomiBleSDK.kt | 530 ++++++++++++++++++ .../kotlin/com/duooomi/ble/core/BleClient.kt | 329 +++++++++++ .../kotlin/com/duooomi/ble/core/BleTypes.kt | 29 + .../com/duooomi/ble/models/BindingResponse.kt | 28 + .../duooomi/ble/models/DeleteFileResponse.kt | 18 + .../com/duooomi/ble/models/DeviceInfo.kt | 25 + .../com/duooomi/ble/models/FirmwareInfo.kt | 27 + .../ble/models/PrepareTransferResponse.kt | 20 + .../com/duooomi/ble/models/UnbindResponse.kt | 15 + .../com/duooomi/ble/models/VersionInfo.kt | 22 + .../duooomi/ble/protocol/ProtocolConstants.kt | 44 ++ .../com/duooomi/ble/protocol/ProtocolFrame.kt | 35 ++ .../duooomi/ble/protocol/ProtocolManager.kt | 159 ++++++ .../com/duooomi/ble/services/AniConverter.kt | 79 +++ .../ble/services/BleProtocolService.kt | 127 +++++ .../duooomi/ble/services/DeviceInfoService.kt | 58 ++ .../ble/services/FileTransferService.kt | 54 ++ .../duooomi/ble/services/FirmwareService.kt | 59 ++ .../kotlin/com/duooomi/ble/utils/BleLogger.kt | 23 + settings.gradle.kts | 19 + 35 files changed, 2802 insertions(+) create mode 100644 .gitignore create mode 100644 README.md create mode 100644 build.gradle.kts create mode 100644 demo/build.gradle.kts create mode 100644 demo/src/main/AndroidManifest.xml create mode 100644 demo/src/main/kotlin/com/duooomi/ble/demo/DemoScreen.kt create mode 100644 demo/src/main/kotlin/com/duooomi/ble/demo/MainActivity.kt create mode 100644 gradle.properties create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100755 gradlew create mode 100644 gradlew.bat create mode 100644 sdk/build.gradle.kts create mode 100644 sdk/src/main/AndroidManifest.xml create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleConfig.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleSDK.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/core/BleClient.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/core/BleTypes.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/models/BindingResponse.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/models/DeleteFileResponse.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/models/DeviceInfo.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/models/FirmwareInfo.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/models/PrepareTransferResponse.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/models/UnbindResponse.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/models/VersionInfo.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolConstants.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolFrame.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolManager.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/services/AniConverter.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/services/BleProtocolService.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/services/DeviceInfoService.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/services/FileTransferService.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/services/FirmwareService.kt create mode 100644 sdk/src/main/kotlin/com/duooomi/ble/utils/BleLogger.kt create mode 100644 settings.gradle.kts diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..48e67a5 --- /dev/null +++ b/.gitignore @@ -0,0 +1,7 @@ +.gradle/ +build/ +local.properties +*.iml +.idea/ +.DS_Store +sdk/build/ diff --git a/README.md b/README.md new file mode 100644 index 0000000..322912b --- /dev/null +++ b/README.md @@ -0,0 +1,213 @@ +# Duooomi Android BLE SDK + +Duooomi 蓝牙 BLE SDK 的 Android 版本。 + +## 环境要求 + +| 项目 | 要求 | +|------|------| +| Android Studio | Hedgehog (2023.1.1) 或更高 | +| Kotlin | 1.9.22+ | +| AGP | 8.2.2+ | +| Gradle | 8.x | +| JDK | 17 | +| minSdk | 26 (Android 8.0) | +| compileSdk / targetSdk | 34 | + +## 项目结构 + +``` +duooomi-android-sdk/ +├── sdk/ # SDK 库模块 (com.android.library) +│ └── src/main/kotlin/com/duooomi/ble/ +│ ├── DuooomiBleSDK.kt # 公开 API 入口 +│ ├── DuooomiBleConfig.kt # SDK 配置 +│ ├── core/ # BLE 核心层 (BleClient, 类型定义, 错误类型) +│ ├── protocol/ # BLE 协议层 (帧格式, UUID, 协议管理) +│ ├── services/ # 服务层 (设备信息, 文件传输, ANI转换, 固件) +│ ├── models/ # 数据模型 +│ └── utils/ # 日志工具 +├── demo/ # 演示 App (Jetpack Compose) +└── build.gradle.kts +``` + +## 依赖 + +SDK 仅依赖一个外部库： + +``` +org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3 +``` + +其余全部使用 Android 内置 API（BLE、JSON、HttpURLConnection）。 + +## 快速开始 + +### 1. 引入 SDK + +在 `settings.gradle.kts` 中： + +```kotlin +include(":sdk") +``` + +在 app 模块的 `build.gradle.kts` 中： + +```kotlin +dependencies { + implementation(project(":sdk")) +} +``` + +### 2. 添加权限 + +在 `AndroidManifest.xml` 中添加： + +```xml + + + + + + + + + + + +``` + +> **注意：** 运行时仍需动态申请 `BLUETOOTH_SCAN`、`BLUETOOTH_CONNECT`（Android 12+）和 `ACCESS_FINE_LOCATION` 权限。 + +### 3. 初始化 SDK + +```kotlin +val sdk = DuooomiBleSDK( + context = this, + config = DuooomiBleConfig( + apiKey = "YOUR_API_KEY" + ) +) +``` + +### 4. API Key 说明 + +| 参数 | 说明 | +|------|------| +| `apiKey` | **必填**。用于 ANI 转换和固件查询等后端 API 鉴权。| +| `apiHost` | 默认 `https://api.mixvideo.bowong.cc`，一般无需修改 | +| `cdnHost` | 默认 `https://cdn.bowong.cc/`，一般无需修改 | +| `firmwareIdentifier` | 默认 `duomi`，设备固件标识符 | +| `firmwareStatus` | 默认 `DRAFT`，可选 `PUBLISHED` | + +## API 参考 + +### 可观察状态 (StateFlow) + +```kotlin +sdk.btState // ConnectionState: IDLE, SCANNING, CONNECTING, CONNECTED, ... +sdk.discoveredDevices // List +sdk.connectedDevice // DiscoveredDevice? +sdk.deviceInfo // DeviceInfo? +sdk.version // String +sdk.isActivated // Boolean +sdk.transferProgress // Int (0-100) +sdk.error // String? +``` + +### 扫描与连接 + +```kotlin +// 开始扫描 (自动过滤 Duooomi 设备) +sdk.scan() + +// 停止扫描 +sdk.stopScan() + +// 连接设备 (suspend) +val device = sdk.connect(deviceId) + +// 断开连接 (suspend) +sdk.disconnect() +``` + +### 设备操作 (均需先连接) + +```kotlin +// 获取设备信息 +val info = sdk.getDeviceInfo() +// info.brand, info.name, info.size, info.powerlevel, info.freespace, info.allspace + +// 获取固件版本 +val versionInfo = sdk.getVersion() +// versionInfo.version, versionInfo.type + +// 绑定设备 +val bindResult = sdk.bind(userId) +// bindResult.sn, bindResult.contents (设备文件列表) + +// 解绑设备 +sdk.unbind(userId) + +// 删除设备文件 +sdk.deleteFile(fileKey) +``` + +### 文件传输 + +```kotlin +// 传输媒体文件 (自动转换为 ANI 格式) +// 支持: mp4, jpg, png, ani +sdk.transferMedia(fileUrl) + +// 监听进度 +sdk.transferProgress.collect { percent -> /* 0-100 */ } +``` + +### 固件升级 + +```kotlin +// 查询最新固件 +val firmware = sdk.fetchLatestFirmware(identifier, status) +// firmware?.version, firmware?.fileUrl, firmware?.fileSize + +// 执行 OTA 升级 +sdk.upgradeFirmware(firmware.fileUrl) +``` + +### 错误处理 + +所有 suspend 方法在失败时抛出 `DuooomiBleError`： + +```kotlin +try { + sdk.connect(deviceId) +} catch (e: DuooomiBleError.BluetoothNotPoweredOn) { /* 蓝牙未开启 */ } + catch (e: DuooomiBleError.ConnectionFailed) { /* 连接失败 */ } + catch (e: DuooomiBleError.NotConnected) { /* 未连接 */ } + catch (e: DuooomiBleError.Timeout) { /* 超时 */ } + catch (e: DuooomiBleError.PermissionDenied) { /* 权限不足 */ } +``` + +## 运行 Demo + +```bash +# 构建 +./gradlew :demo:assembleDebug + +# 安装到设备 +adb install demo/build/outputs/apk/debug/demo-debug.apk +``` + +## BLE 协议简述 + +- **Service UUID:** `000002c4-0000-1000-8000-00805f9b34fb` +- **Write Characteristic:** `000002c5-...` +- **Read Characteristic (Notify):** `000002c6-...` +- **帧格式:** `[head:1][type:1][subpageTotal:2][curPage:2][dataLen:2][data:N][checksum:1]` +- **校验和:** 二进制补码 `(~sum + 1) & 0xFF` +- **大数据分片:** 自动拆分，帧间延迟 35ms + +## License + +Proprietary - Duooomi diff --git a/build.gradle.kts b/build.gradle.kts new file mode 100644 index 0000000..38f981e --- /dev/null +++ b/build.gradle.kts @@ -0,0 +1,5 @@ +plugins { + id("com.android.library") version "8.2.2" apply false + id("com.android.application") version "8.2.2" apply false + id("org.jetbrains.kotlin.android") version "1.9.22" apply false +} diff --git a/demo/build.gradle.kts b/demo/build.gradle.kts new file mode 100644 index 0000000..1df29fb --- /dev/null +++ b/demo/build.gradle.kts @@ -0,0 +1,49 @@ +plugins { + id("com.android.application") + id("org.jetbrains.kotlin.android") +} + +android { + namespace = "com.duooomi.ble.demo" + compileSdk = 34 + + defaultConfig { + applicationId = "com.duooomi.ble.demo" + minSdk = 26 + targetSdk = 34 + versionCode = 1 + versionName = "1.0" + } + + buildFeatures { + compose = true + } + + composeOptions { + kotlinCompilerExtensionVersion = "1.5.8" + } + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 + } + + kotlinOptions { + jvmTarget = "17" + } +} + +dependencies { + implementation(project(":sdk")) + + // Compose + val composeBom = platform("androidx.compose:compose-bom:2024.06.00") + implementation(composeBom) + implementation("androidx.compose.ui:ui") + implementation("androidx.compose.material3:material3") + implementation("androidx.compose.ui:ui-tooling-preview") + implementation("androidx.activity:activity-compose:1.8.2") + implementation("androidx.lifecycle:lifecycle-runtime-compose:2.7.0") + + debugImplementation("androidx.compose.ui:ui-tooling") +} diff --git a/demo/src/main/AndroidManifest.xml b/demo/src/main/AndroidManifest.xml new file mode 100644 index 0000000..3fcd9dd --- /dev/null +++ b/demo/src/main/AndroidManifest.xml @@ -0,0 +1,33 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/demo/src/main/kotlin/com/duooomi/ble/demo/DemoScreen.kt b/demo/src/main/kotlin/com/duooomi/ble/demo/DemoScreen.kt new file mode 100644 index 0000000..3cd6abb --- /dev/null +++ b/demo/src/main/kotlin/com/duooomi/ble/demo/DemoScreen.kt @@ -0,0 +1,453 @@ +package com.duooomi.ble.demo + +import androidx.compose.foundation.layout.* +import androidx.compose.foundation.lazy.LazyColumn +import androidx.compose.foundation.lazy.items +import androidx.compose.material3.* +import androidx.compose.runtime.* +import androidx.compose.ui.Alignment +import androidx.compose.ui.Modifier +import androidx.compose.ui.graphics.Color +import androidx.compose.ui.text.font.FontWeight +import androidx.compose.ui.unit.dp +import androidx.compose.ui.unit.sp +import com.duooomi.ble.DuooomiBleSDK +import com.duooomi.ble.core.ConnectionState +import com.duooomi.ble.models.FirmwareInfo +import com.duooomi.ble.protocol.CommandType +import kotlinx.coroutines.launch + +// MARK: - CDN Helper + +private object CDNHelper { + var cdnHost = "https://cdn.bowong.cc/" + + fun ensureFullUrl(keyOrUrl: String): String { + if (keyOrUrl.startsWith("http://") || keyOrUrl.startsWith("https://")) return keyOrUrl + val key = keyOrUrl.removePrefix("/") + return cdnHost + key + } +} + +// MARK: - Log + +private data class LogLine( + val id: Long, + val level: LogLevel, + val message: String +) + +private enum class LogLevel { INFO, SUCCESS, ERROR } + +// MARK: - Screen + +@OptIn(ExperimentalMaterial3Api::class) +@Composable +fun DemoScreen(sdk: DuooomiBleSDK) { + val scope = rememberCoroutineScope() + + // SDK state + val btState by sdk.btState.collectAsState() + val discoveredDevices by sdk.discoveredDevices.collectAsState() + val connectedDevice by sdk.connectedDevice.collectAsState() + val deviceInfo by sdk.deviceInfo.collectAsState() + val version by sdk.version.collectAsState() + val transferProgress by sdk.transferProgress.collectAsState() + val sdkError by sdk.error.collectAsState() + + // Local state + var userId by remember { mutableStateOf("test-user-001") } + var fileUrl by remember { mutableStateOf("https://cdn.bowong.cc/material/569f48a8e29f47859b3a9808be37f94c.mp4") } + var firmwareBrand by remember { mutableStateOf(sdk.config.firmwareIdentifier) } + var firmwareStatus by remember { mutableStateOf(sdk.config.firmwareStatus) } + var firmwareInfo by remember { mutableStateOf(null) } + var firmwareLoading by remember { mutableStateOf(false) } + var isBusy by remember { mutableStateOf(false) } + var connectingDeviceId by remember { mutableStateOf(null) } + var deviceFiles by remember { mutableStateOf>(emptyList()) } + var logs by remember { mutableStateOf>(emptyList()) } + var logCounter by remember { mutableLongStateOf(0L) } + + fun log(message: String, level: LogLevel = LogLevel.INFO) { + logCounter++ + logs = listOf(LogLine(logCounter, level, message)) + logs.take(199) + } + + LaunchedEffect(Unit) { + CDNHelper.cdnHost = sdk.config.normalizedCdnHost + } + + Scaffold( + topBar = { + TopAppBar(title = { Text("SDK Demo") }) + } + ) { padding -> + LazyColumn( + modifier = Modifier + .fillMaxSize() + .padding(padding) + .padding(horizontal = 16.dp), + verticalArrangement = Arrangement.spacedBy(8.dp) + ) { + // === Status Section === + item { + SectionHeader("Status") + StatusRow("BLE", btState.name) + StatusRow("Device", connectedDevice?.name ?: "--") + StatusRow("Version", version.ifEmpty { "--" }) + if (transferProgress > 0) { + @Suppress("DEPRECATION") + LinearProgressIndicator( + progress = transferProgress / 100f, + modifier = Modifier.fillMaxWidth().padding(vertical = 4.dp) + ) + Text("$transferProgress%", fontSize = 12.sp) + } + sdkError?.let { + Text(it, color = Color.Red, fontSize = 12.sp) + } + } + + // === Scan & Connect Section === + item { + SectionHeader("Scan & Connect") + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + Button(onClick = { + sdk.scan() + log("-> scan()") + }) { Text("Scan") } + + OutlinedButton(onClick = { + sdk.stopScan() + log("-> stopScan()") + }) { Text("Stop") } + } + } + + items(discoveredDevices, key = { it.id }) { device -> + Card(modifier = Modifier.fillMaxWidth()) { + Row( + modifier = Modifier.padding(12.dp).fillMaxWidth(), + verticalAlignment = Alignment.CenterVertically + ) { + Column(modifier = Modifier.weight(1f)) { + Text(device.name ?: "Unknown", fontWeight = FontWeight.Medium) + Text(device.id, fontSize = 10.sp, color = Color.Gray) + } + Text("${device.rssi} dBm", fontSize = 12.sp, color = Color.Gray) + Spacer(Modifier.width(8.dp)) + + if (connectedDevice?.id == device.id) { + OutlinedButton( + onClick = { + scope.launch { + log("-> disconnect") + try { + sdk.disconnect() + deviceFiles = emptyList() + log("disconnect OK", LogLevel.SUCCESS) + } catch (e: Exception) { + log("disconnect FAIL: ${e.message}", LogLevel.ERROR) + } + } + }, + colors = ButtonDefaults.outlinedButtonColors(contentColor = Color.Red) + ) { Text("Disconnect") } + } else if (connectingDeviceId == device.id) { + CircularProgressIndicator(modifier = Modifier.size(24.dp), strokeWidth = 2.dp) + } else { + OutlinedButton( + onClick = { + scope.launch { + connectingDeviceId = device.id + log("-> connect(${device.id})") + try { + val d = sdk.connect(device.id) + log("connect OK: ${d.name ?: d.id}", LogLevel.SUCCESS) + } catch (e: Exception) { + log("connect FAIL: ${e.message}", LogLevel.ERROR) + } finally { + connectingDeviceId = null + } + } + }, + enabled = connectingDeviceId == null + ) { Text("Connect") } + } + } + } + } + + // === Device Section === + item { + SectionHeader("Device") + StatusRow("Brand", deviceInfo?.brand ?: "--") + StatusRow("Size", deviceInfo?.size ?: "--") + StatusRow("Power", deviceInfo?.let { "${it.powerlevel}%" } ?: "--") + StatusRow("Storage", deviceInfo?.let { "${it.freespace}/${it.allspace}" } ?: "--") + + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedButton(onClick = { + scope.launch { + isBusy = true + log("-> getDeviceInfo") + try { + val info = sdk.getDeviceInfo() + log("getDeviceInfo OK: brand=${info.brand} power=${info.powerlevel}%", LogLevel.SUCCESS) + } catch (e: Exception) { + log("getDeviceInfo FAIL: ${e.message}", LogLevel.ERROR) + } finally { isBusy = false } + } + }) { Text("getDeviceInfo") } + + OutlinedButton(onClick = { + scope.launch { + isBusy = true + log("-> getVersion") + try { + val info = sdk.getVersion() + log("getVersion OK: ${info.version}", LogLevel.SUCCESS) + } catch (e: Exception) { + log("getVersion FAIL: ${e.message}", LogLevel.ERROR) + } finally { isBusy = false } + } + }) { Text("getVersion") } + } + + Spacer(Modifier.height(4.dp)) + + OutlinedTextField( + value = userId, + onValueChange = { userId = it }, + label = { Text("userId") }, + modifier = Modifier.fillMaxWidth(), + singleLine = true + ) + + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedButton(onClick = { + scope.launch { + isBusy = true + log("-> bind($userId)") + try { + val result = sdk.bind(userId) + log("bind OK: sn=${result.sn} contents=${result.contents.size}", LogLevel.SUCCESS) + deviceFiles = result.contents + } catch (e: Exception) { + log("bind FAIL: ${e.message}", LogLevel.ERROR) + } finally { isBusy = false } + } + }) { Text("bind") } + + OutlinedButton(onClick = { + scope.launch { + isBusy = true + log("-> unbind($userId)") + try { + sdk.unbind(userId) + deviceFiles = emptyList() + log("unbind OK", LogLevel.SUCCESS) + } catch (e: Exception) { + log("unbind FAIL: ${e.message}", LogLevel.ERROR) + } finally { isBusy = false } + } + }) { Text("unbind") } + } + } + + // === Transfer Section === + item { + SectionHeader("Transfer") + OutlinedTextField( + value = fileUrl, + onValueChange = { fileUrl = it }, + label = { Text("File URL (mp4/jpg/png/ani)") }, + modifier = Modifier.fillMaxWidth(), + singleLine = true + ) + Button( + onClick = { + scope.launch { + isBusy = true + log("-> transferMedia($fileUrl)") + try { + sdk.transferMedia(fileUrl) + log("transfer OK", LogLevel.SUCCESS) + } catch (e: Exception) { + log("transfer FAIL: ${e.message}", LogLevel.ERROR) + } finally { isBusy = false } + } + }, + enabled = fileUrl.isNotEmpty() && connectedDevice != null && !isBusy + ) { Text("Transfer") } + } + + // === Firmware Section === + item { + SectionHeader("Firmware Update") + StatusRow("Current Version", version.ifEmpty { "--" }) + + OutlinedTextField( + value = firmwareBrand, + onValueChange = { firmwareBrand = it }, + label = { Text("Identifier") }, + modifier = Modifier.fillMaxWidth(), + singleLine = true + ) + + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + listOf("DRAFT", "PUBLISHED").forEach { status -> + FilterChip( + selected = firmwareStatus == status, + onClick = { firmwareStatus = status }, + label = { Text(status) } + ) + } + } + + firmwareInfo?.let { info -> + Card(modifier = Modifier.fillMaxWidth()) { + Column(modifier = Modifier.padding(12.dp)) { + StatusRow("Latest", info.version) + info.fileSize?.let { StatusRow("Size", "$it bytes") } + info.fileMd5?.takeIf { it.isNotEmpty() }?.let { + Text("MD5: $it", fontSize = 10.sp, color = Color.Gray) + } + info.description?.takeIf { it.isNotEmpty() }?.let { + Text(it, fontSize = 12.sp, color = Color.Gray) + } + Text(info.fileUrl, fontSize = 10.sp, color = Color.Gray, maxLines = 2) + } + } + } + + if (firmwareLoading) { + Row(verticalAlignment = Alignment.CenterVertically) { + CircularProgressIndicator(modifier = Modifier.size(16.dp), strokeWidth = 2.dp) + Spacer(Modifier.width(8.dp)) + Text("Fetching...", fontSize = 12.sp, color = Color.Gray) + } + } + + Row(horizontalArrangement = Arrangement.spacedBy(8.dp)) { + OutlinedButton( + onClick = { + scope.launch { + firmwareLoading = true + log("-> fetchLatestFirmware($firmwareBrand, $firmwareStatus)") + try { + val info = sdk.fetchLatestFirmware(firmwareBrand, firmwareStatus) + firmwareInfo = info + if (info != null) { + log("firmware latest: ${info.version}", LogLevel.SUCCESS) + } else { + log("no firmware available") + } + } catch (e: Exception) { + log("firmware info FAIL: ${e.message}", LogLevel.ERROR) + } finally { firmwareLoading = false } + } + }, + enabled = !firmwareLoading && firmwareBrand.isNotEmpty() + ) { Text("Get Update Info") } + + Button( + onClick = { + scope.launch { + val info = firmwareInfo ?: return@launch + isBusy = true + log("-> upgradeFirmware ${info.version}") + try { + sdk.upgradeFirmware(info.fileUrl) + log("OTA OK", LogLevel.SUCCESS) + } catch (e: Exception) { + log("OTA FAIL: ${e.message}", LogLevel.ERROR) + } finally { isBusy = false } + } + }, + enabled = firmwareInfo?.fileUrl?.isNotEmpty() == true && connectedDevice != null && !isBusy + ) { Text("Upgrade") } + } + } + + // === Device Files Section === + item { + SectionHeader("Device Files (${deviceFiles.size})") + if (deviceFiles.isEmpty()) { + Text("Bind to see device files", fontSize = 12.sp, color = Color.Gray) + } + } + + items(deviceFiles) { rawKey -> + Card(modifier = Modifier.fillMaxWidth()) { + Row( + modifier = Modifier.padding(12.dp).fillMaxWidth(), + verticalAlignment = Alignment.CenterVertically + ) { + Text(rawKey, fontSize = 11.sp, modifier = Modifier.weight(1f), maxLines = 2) + TextButton( + onClick = { + scope.launch { + isBusy = true + log("-> deleteFile($rawKey)") + try { + sdk.deleteFile(rawKey) + log("deleteFile OK", LogLevel.SUCCESS) + deviceFiles = deviceFiles.filter { it != rawKey } + } catch (e: Exception) { + log("deleteFile FAIL: ${e.message}", LogLevel.ERROR) + } finally { isBusy = false } + } + }, + enabled = !isBusy, + colors = ButtonDefaults.textButtonColors(contentColor = Color.Red) + ) { Text("Delete") } + } + } + } + + // === Log Section === + item { + SectionHeader("Log (${logs.size})") + } + + items(logs.take(80), key = { it.id }) { line -> + Text( + text = line.message, + fontSize = 11.sp, + color = when (line.level) { + LogLevel.ERROR -> Color.Red + LogLevel.SUCCESS -> Color(0xFF2E7D32) + LogLevel.INFO -> Color.Unspecified + } + ) + } + + item { Spacer(Modifier.height(32.dp)) } + } + } +} + +// MARK: - Components + +@Composable +private fun SectionHeader(title: String) { + Text( + text = title, + fontWeight = FontWeight.Bold, + fontSize = 16.sp, + modifier = Modifier.padding(top = 16.dp, bottom = 4.dp) + ) + Divider() +} + +@Composable +private fun StatusRow(label: String, value: String) { + Row( + modifier = Modifier.fillMaxWidth().padding(vertical = 2.dp), + horizontalArrangement = Arrangement.SpaceBetween + ) { + Text(label, fontSize = 13.sp, color = Color.Gray) + Text(value, fontSize = 13.sp) + } +} diff --git a/demo/src/main/kotlin/com/duooomi/ble/demo/MainActivity.kt b/demo/src/main/kotlin/com/duooomi/ble/demo/MainActivity.kt new file mode 100644 index 0000000..5cd514c --- /dev/null +++ b/demo/src/main/kotlin/com/duooomi/ble/demo/MainActivity.kt @@ -0,0 +1,61 @@ +package com.duooomi.ble.demo + +import android.Manifest +import android.content.pm.PackageManager +import android.os.Build +import android.os.Bundle +import androidx.activity.ComponentActivity +import androidx.activity.compose.setContent +import androidx.activity.result.contract.ActivityResultContracts +import androidx.compose.foundation.layout.fillMaxSize +import androidx.compose.material3.MaterialTheme +import androidx.compose.material3.Surface +import androidx.compose.ui.Modifier +import androidx.core.content.ContextCompat +import com.duooomi.ble.DuooomiBleConfig +import com.duooomi.ble.DuooomiBleSDK + +class MainActivity : ComponentActivity() { + + private lateinit var sdk: DuooomiBleSDK + + private val permissionLauncher = registerForActivityResult( + ActivityResultContracts.RequestMultiplePermissions() + ) { /* permissions granted or denied — SDK handles errors */ } + + override fun onCreate(savedInstanceState: Bundle?) { + super.onCreate(savedInstanceState) + + sdk = DuooomiBleSDK( + context = this, + config = DuooomiBleConfig(apiKey = "") + ) + + requestBlePermissions() + + setContent { + MaterialTheme { + Surface(modifier = Modifier.fillMaxSize()) { + DemoScreen(sdk = sdk) + } + } + } + } + + private fun requestBlePermissions() { + val permissions = mutableListOf() + if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) { + permissions.add(Manifest.permission.BLUETOOTH_SCAN) + permissions.add(Manifest.permission.BLUETOOTH_CONNECT) + } + permissions.add(Manifest.permission.ACCESS_FINE_LOCATION) + permissions.add(Manifest.permission.ACCESS_COARSE_LOCATION) + + val needed = permissions.filter { + ContextCompat.checkSelfPermission(this, it) != PackageManager.PERMISSION_GRANTED + } + if (needed.isNotEmpty()) { + permissionLauncher.launch(needed.toTypedArray()) + } + } +} diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..32a0c14 --- /dev/null +++ b/gradle.properties @@ -0,0 +1,3 @@ +android.useAndroidX=true +kotlin.code.style=official +org.gradle.jvmargs=-Xmx2048m diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..d64cd4917707c1f8861d8cb53dd15194d4248596 GIT binary patch literal 43462 zcma&NWl&^owk(X(xVyW%ySuwf;qI=D6|RlDJ2cR^yEKh!@I- zp9QeisK*rlxC>+~7Dk4IxIRsKBHqdR9b3+fyL=ynHmIDe&|>O*VlvO+%z5;9Z$|DJ zb4dO}-R=MKr^6EKJiOrJdLnCJn>np?~vU-1sSFgPu;pthGwf}bG z(1db%xwr#x)r+`4AGu$j7~u2MpVs3VpLp|mx&;>`0p0vH6kF+D2CY0fVdQOZ@h;A` z{infNyvmFUiu*XG}RNMNwXrbec_*a3N=2zJ|Wh5z* z5rAX$JJR{#zP>KY**>xHTuw?|-Rg|o24V)74HcfVT;WtQHXlE+_4iPE8QE#DUm%x0 zEKr75ur~W%w#-My3Tj`hH6EuEW+8K-^5P62$7Sc5OK+22qj&Pd1;)1#4tKihi=~8C zHiQSst0cpri6%OeaR`PY>HH_;CPaRNty%WTm4{wDK8V6gCZlG@U3$~JQZ;HPvDJcT1V{ z?>H@13MJcCNe#5z+MecYNi@VT5|&UiN1D4ATT+%M+h4c$t;C#UAs3O_q=GxK0}8%8 z8J(_M9bayxN}69ex4dzM_P3oh@ZGREjVvn%%r7=xjkqxJP4kj}5tlf;QosR=%4L5y zWhgejO=vao5oX%mOHbhJ8V+SG&K5dABn6!WiKl{|oPkq(9z8l&Mm%(=qGcFzI=eLu zWc_oCLyf;hVlB@dnwY98?75B20=n$>u3b|NB28H0u-6Rpl((%KWEBOfElVWJx+5yg z#SGqwza7f}$z;n~g%4HDU{;V{gXIhft*q2=4zSezGK~nBgu9-Q*rZ#2f=Q}i2|qOp z!!y4p)4o=LVUNhlkp#JL{tfkhXNbB=Ox>M=n6soptJw-IDI|_$is2w}(XY>a=H52d z3zE$tjPUhWWS+5h=KVH&uqQS=$v3nRs&p$%11b%5qtF}S2#Pc`IiyBIF4%A!;AVoI zXU8-Rpv!DQNcF~(qQnyyMy=-AN~U>#&X1j5BLDP{?K!%h!;hfJI>$mdLSvktEr*89 zdJHvby^$xEX0^l9g$xW-d?J;L0#(`UT~zpL&*cEh$L|HPAu=P8`OQZV!-}l`noSp_ zQ-1$q$R-gDL)?6YaM!=8H=QGW$NT2SeZlb8PKJdc=F-cT@j7Xags+Pr*jPtlHFnf- zh?q<6;)27IdPc^Wdy-mX%2s84C1xZq9Xms+==F4);O`VUASmu3(RlgE#0+#giLh-& zcxm3_e}n4{%|X zJp{G_j+%`j_q5}k{eW&TlP}J2wtZ2^<^E(O)4OQX8FDp6RJq!F{(6eHWSD3=f~(h} zJXCf7=r<16X{pHkm%yzYI_=VDP&9bmI1*)YXZeB}F? z(%QsB5fo*FUZxK$oX~X^69;x~j7ms8xlzpt-T15e9}$4T-pC z6PFg@;B-j|Ywajpe4~bk#S6(fO^|mm1hKOPfA%8-_iGCfICE|=P_~e;Wz6my&)h_~ zkv&_xSAw7AZ%ThYF(4jADW4vg=oEdJGVOs>FqamoL3Np8>?!W#!R-0%2Bg4h?kz5I zKV-rKN2n(vUL%D<4oj@|`eJ>0i#TmYBtYmfla;c!ATW%;xGQ0*TW@PTlGG><@dxUI zg>+3SiGdZ%?5N=8uoLA|$4isK$aJ%i{hECP$bK{J#0W2gQ3YEa zZQ50Stn6hqdfxJ*9#NuSLwKFCUGk@c=(igyVL;;2^wi4o30YXSIb2g_ud$ zgpCr@H0qWtk2hK8Q|&wx)}4+hTYlf;$a4#oUM=V@Cw#!$(nOFFpZ;0lc!qd=c$S}Z zGGI-0jg~S~cgVT=4Vo)b)|4phjStD49*EqC)IPwyeKBLcN;Wu@Aeph;emROAwJ-0< z_#>wVm$)ygH|qyxZaet&(Vf%pVdnvKWJn9`%DAxj3ot;v>S$I}jJ$FLBF*~iZ!ZXE zkvui&p}fI0Y=IDX)mm0@tAd|fEHl~J&K}ZX(Mm3cm1UAuwJ42+AO5@HwYfDH7ipIc zmI;1J;J@+aCNG1M`Btf>YT>~c&3j~Qi@Py5JT6;zjx$cvOQW@3oQ>|}GH?TW-E z1R;q^QFjm5W~7f}c3Ww|awg1BAJ^slEV~Pk`Kd`PS$7;SqJZNj->it4DW2l15}xP6 zoCl$kyEF%yJni0(L!Z&14m!1urXh6Btj_5JYt1{#+H8w?5QI%% zo-$KYWNMJVH?Hh@1n7OSu~QhSswL8x0=$<8QG_zepi_`y_79=nK=_ZP_`Em2UI*tyQoB+r{1QYZCpb?2OrgUw#oRH$?^Tj!Req>XiE#~B|~ z+%HB;=ic+R@px4Ld8mwpY;W^A%8%l8$@B@1m5n`TlKI6bz2mp*^^^1mK$COW$HOfp zUGTz-cN9?BGEp}5A!mDFjaiWa2_J2Iq8qj0mXzk; z66JBKRP{p%wN7XobR0YjhAuW9T1Gw3FDvR5dWJ8ElNYF94eF3ebu+QwKjtvVu4L zI9ip#mQ@4uqVdkl-TUQMb^XBJVLW(-$s;Nq;@5gr4`UfLgF$adIhd?rHOa%D);whv z=;krPp~@I+-Z|r#s3yCH+c1US?dnm+C*)r{m+86sTJusLdNu^sqLrfWed^ndHXH`m zd3#cOe3>w-ga(Dus_^ppG9AC>Iq{y%%CK+Cro_sqLCs{VLuK=dev>OL1dis4(PQ5R zcz)>DjEkfV+MO;~>VUlYF00SgfUo~@(&9$Iy2|G0T9BSP?&T22>K46D zL*~j#yJ?)^*%J3!16f)@Y2Z^kS*BzwfAQ7K96rFRIh>#$*$_Io;z>ux@}G98!fWR@ zGTFxv4r~v)Gsd|pF91*-eaZ3Qw1MH$K^7JhWIdX%o$2kCbvGDXy)a?@8T&1dY4`;L z4Kn+f%SSFWE_rpEpL9bnlmYq`D!6F%di<&Hh=+!VI~j)2mfil03T#jJ_s?}VV0_hp z7T9bWxc>Jm2Z0WMU?`Z$xE74Gu~%s{mW!d4uvKCx@WD+gPUQ zV0vQS(Ig++z=EHN)BR44*EDSWIyT~R4$FcF*VEY*8@l=218Q05D2$|fXKFhRgBIEE zdDFB}1dKkoO^7}{5crKX!p?dZWNz$m>1icsXG2N+((x0OIST9Zo^DW_tytvlwXGpn zs8?pJXjEG;T@qrZi%#h93?FP$!&P4JA(&H61tqQi=opRzNpm zkrG}$^t9&XduK*Qa1?355wd8G2CI6QEh@Ua>AsD;7oRUNLPb76m4HG3K?)wF~IyS3`fXuNM>${?wmB zpVz;?6_(Fiadfd{vUCBM*_kt$+F3J+IojI;9L(gc9n3{sEZyzR9o!_mOwFC#tQ{Q~ zP3-`#uK#tP3Q7~Q;4H|wjZHO8h7e4IuBxl&vz2w~D8)w=Wtg31zpZhz%+kzSzL*dV zwp@{WU4i;hJ7c2f1O;7Mz6qRKeASoIv0_bV=i@NMG*l<#+;INk-^`5w@}Dj~;k=|}qM1vq_P z|GpBGe_IKq|LNy9SJhKOQ$c=5L{Dv|Q_lZl=-ky*BFBJLW9&y_C|!vyM~rQx=!vun z?rZJQB5t}Dctmui5i31C_;_}CEn}_W%>oSXtt>@kE1=JW*4*v4tPp;O6 zmAk{)m!)}34pTWg8{i>($%NQ(Tl;QC@J@FfBoc%Gr&m560^kgSfodAFrIjF}aIw)X zoXZ`@IsMkc8_=w%-7`D6Y4e*CG8k%Ud=GXhsTR50jUnm+R*0A(O3UKFg0`K;qp1bl z7``HN=?39ic_kR|^R^~w-*pa?Vj#7|e9F1iRx{GN2?wK!xR1GW!qa=~pjJb-#u1K8 zeR?Y2i-pt}yJq;SCiVHODIvQJX|ZJaT8nO+(?HXbLefulKKgM^B(UIO1r+S=7;kLJ zcH}1J=Px2jsh3Tec&v8Jcbng8;V-`#*UHt?hB(pmOipKwf3Lz8rG$heEB30Sg*2rx zV<|KN86$soN(I!BwO`1n^^uF2*x&vJ$2d$>+`(romzHP|)K_KkO6Hc>_dwMW-M(#S zK(~SiXT1@fvc#U+?|?PniDRm01)f^#55;nhM|wi?oG>yBsa?~?^xTU|fX-R(sTA+5 zaq}-8Tx7zrOy#3*JLIIVsBmHYLdD}!0NP!+ITW+Thn0)8SS!$@)HXwB3tY!fMxc#1 zMp3H?q3eD?u&Njx4;KQ5G>32+GRp1Ee5qMO0lZjaRRu&{W<&~DoJNGkcYF<5(Ab+J zgO>VhBl{okDPn78<%&e2mR{jwVCz5Og;*Z;;3%VvoGo_;HaGLWYF7q#jDX=Z#Ml`H z858YVV$%J|e<1n`%6Vsvq7GmnAV0wW4$5qQ3uR@1i>tW{xrl|ExywIc?fNgYlA?C5 zh$ezAFb5{rQu6i7BSS5*J-|9DQ{6^BVQ{b*lq`xS@RyrsJN?-t=MTMPY;WYeKBCNg z^2|pN!Q^WPJuuO4!|P@jzt&tY1Y8d%FNK5xK(!@`jO2aEA*4 zkO6b|UVBipci?){-Ke=+1;mGlND8)6+P;8sq}UXw2hn;fc7nM>g}GSMWu&v&fqh

iViYT=fZ(|3Ox^$aWPp4a8h24tD<|8-!aK0lHgL$N7Efw}J zVIB!7=T$U`ao1?upi5V4Et*-lTG0XvExbf!ya{cua==$WJyVG(CmA6Of*8E@DSE%L z`V^$qz&RU$7G5mg;8;=#`@rRG`-uS18$0WPN@!v2d{H2sOqP|!(cQ@ zUHo!d>>yFArLPf1q`uBvY32miqShLT1B@gDL4XoVTK&@owOoD)OIHXrYK-a1d$B{v zF^}8D3Y^g%^cnvScOSJR5QNH+BI%d|;J;wWM3~l>${fb8DNPg)wrf|GBP8p%LNGN# z3EaIiItgwtGgT&iYCFy9-LG}bMI|4LdmmJt@V@% zb6B)1kc=T)(|L@0;wr<>=?r04N;E&ef+7C^`wPWtyQe(*pD1pI_&XHy|0gIGHMekd zF_*M4yi6J&Z4LQj65)S zXwdM{SwUo%3SbPwFsHgqF@V|6afT|R6?&S;lw=8% z3}@9B=#JI3@B*#4s!O))~z zc>2_4Q_#&+5V`GFd?88^;c1i7;Vv_I*qt!_Yx*n=;rj!82rrR2rQ8u5(Ejlo{15P% zs~!{%XJ>FmJ})H^I9bn^Re&38H{xA!0l3^89k(oU;bZWXM@kn$#aoS&Y4l^-WEn-fH39Jb9lA%s*WsKJQl?n9B7_~P z-XM&WL7Z!PcoF6_D>V@$CvUIEy=+Z&0kt{szMk=f1|M+r*a43^$$B^MidrT0J;RI` z(?f!O<8UZkm$_Ny$Hth1J#^4ni+im8M9mr&k|3cIgwvjAgjH z8`N&h25xV#v*d$qBX5jkI|xOhQn!>IYZK7l5#^P4M&twe9&Ey@@GxYMxBZq2e7?`q z$~Szs0!g{2fGcp9PZEt|rdQ6bhAgpcLHPz?f-vB?$dc*!9OL?Q8mn7->bFD2Si60* z!O%y)fCdMSV|lkF9w%x~J*A&srMyYY3{=&$}H zGQ4VG_?$2X(0|vT0{=;W$~icCI{b6W{B!Q8xdGhF|D{25G_5_+%s(46lhvNLkik~R z>nr(&C#5wwOzJZQo9m|U<;&Wk!_#q|V>fsmj1g<6%hB{jGoNUPjgJslld>xmODzGjYc?7JSuA?A_QzjDw5AsRgi@Y|Z0{F{!1=!NES-#*f^s4l0Hu zz468))2IY5dmD9pa*(yT5{EyP^G>@ZWumealS-*WeRcZ}B%gxq{MiJ|RyX-^C1V=0 z@iKdrGi1jTe8Ya^x7yyH$kBNvM4R~`fbPq$BzHum-3Zo8C6=KW@||>zsA8-Y9uV5V z#oq-f5L5}V<&wF4@X@<3^C%ptp6+Ce)~hGl`kwj)bsAjmo_GU^r940Z-|`<)oGnh7 zFF0Tde3>ui?8Yj{sF-Z@)yQd~CGZ*w-6p2U<8}JO-sRsVI5dBji`01W8A&3$?}lxBaC&vn0E$c5tW* zX>5(zzZ=qn&!J~KdsPl;P@bmA-Pr8T*)eh_+Dv5=Ma|XSle6t(k8qcgNyar{*ReQ8 zTXwi=8vr>!3Ywr+BhggHDw8ke==NTQVMCK`$69fhzEFB*4+H9LIvdt-#IbhZvpS}} zO3lz;P?zr0*0$%-Rq_y^k(?I{Mk}h@w}cZpMUp|ucs55bcloL2)($u%mXQw({Wzc~ z;6nu5MkjP)0C(@%6Q_I_vsWrfhl7Zpoxw#WoE~r&GOSCz;_ro6i(^hM>I$8y>`!wW z*U^@?B!MMmb89I}2(hcE4zN2G^kwyWCZp5JG>$Ez7zP~D=J^LMjSM)27_0B_X^C(M z`fFT+%DcKlu?^)FCK>QzSnV%IsXVcUFhFdBP!6~se&xxrIxsvySAWu++IrH;FbcY$ z2DWTvSBRfLwdhr0nMx+URA$j3i7_*6BWv#DXfym?ZRDcX9C?cY9sD3q)uBDR3uWg= z(lUIzB)G$Hr!){>E{s4Dew+tb9kvToZp-1&c?y2wn@Z~(VBhqz`cB;{E4(P3N2*nJ z_>~g@;UF2iG{Kt(<1PyePTKahF8<)pozZ*xH~U-kfoAayCwJViIrnqwqO}7{0pHw$ zs2Kx?s#vQr7XZ264>5RNKSL8|Ty^=PsIx^}QqOOcfpGUU4tRkUc|kc7-!Ae6!+B{o~7nFpm3|G5^=0#Bnm6`V}oSQlrX(u%OWnC zoLPy&Q;1Jui&7ST0~#+}I^&?vcE*t47~Xq#YwvA^6^} z`WkC)$AkNub|t@S!$8CBlwbV~?yp&@9h{D|3z-vJXgzRC5^nYm+PyPcgRzAnEi6Q^gslXYRv4nycsy-SJu?lMps-? zV`U*#WnFsdPLL)Q$AmD|0`UaC4ND07+&UmOu!eHruzV|OUox<+Jl|Mr@6~C`T@P%s zW7sgXLF2SSe9Fl^O(I*{9wsFSYb2l%-;&Pi^dpv!{)C3d0AlNY6!4fgmSgj_wQ*7Am7&$z;Jg&wgR-Ih;lUvWS|KTSg!&s_E9_bXBkZvGiC6bFKDWZxsD$*NZ#_8bl zG1P-#@?OQzED7@jlMJTH@V!6k;W>auvft)}g zhoV{7$q=*;=l{O>Q4a@ ziMjf_u*o^PsO)#BjC%0^h>Xp@;5$p{JSYDt)zbb}s{Kbt!T*I@Pk@X0zds6wsefuU zW$XY%yyRGC94=6mf?x+bbA5CDQ2AgW1T-jVAJbm7K(gp+;v6E0WI#kuACgV$r}6L? zd|Tj?^%^*N&b>Dd{Wr$FS2qI#Ucs1yd4N+RBUQiSZGujH`#I)mG&VKoDh=KKFl4=G z&MagXl6*<)$6P}*Tiebpz5L=oMaPrN+caUXRJ`D?=K9!e0f{@D&cZLKN?iNP@X0aF zE(^pl+;*T5qt?1jRC=5PMgV!XNITRLS_=9{CJExaQj;lt!&pdzpK?8p>%Mb+D z?yO*uSung=-`QQ@yX@Hyd4@CI^r{2oiu`%^bNkz+Nkk!IunjwNC|WcqvX~k=><-I3 zDQdbdb|!v+Iz01$w@aMl!R)koD77Xp;eZwzSl-AT zr@Vu{=xvgfq9akRrrM)}=!=xcs+U1JO}{t(avgz`6RqiiX<|hGG1pmop8k6Q+G_mv zJv|RfDheUp2L3=^C=4aCBMBn0aRCU(DQwX-W(RkRwmLeuJYF<0urcaf(=7)JPg<3P zQs!~G)9CT18o!J4{zX{_e}4eS)U-E)0FAt}wEI(c0%HkxgggW;(1E=>J17_hsH^sP z%lT0LGgbUXHx-K*CI-MCrP66UP0PvGqM$MkeLyqHdbgP|_Cm!7te~b8p+e6sQ_3k| zVcwTh6d83ltdnR>D^)BYQpDKlLk3g0Hdcgz2}%qUs9~~Rie)A-BV1mS&naYai#xcZ z(d{8=-LVpTp}2*y)|gR~;qc7fp26}lPcLZ#=JpYcn3AT9(UIdOyg+d(P5T7D&*P}# zQCYplZO5|7+r19%9e`v^vfSS1sbX1c%=w1;oyruXB%Kl$ACgKQ6=qNWLsc=28xJjg zwvsI5-%SGU|3p>&zXVl^vVtQT3o-#$UT9LI@Npz~6=4!>mc431VRNN8od&Ul^+G_kHC`G=6WVWM z%9eWNyy(FTO|A+@x}Ou3CH)oi;t#7rAxdIXfNFwOj_@Y&TGz6P_sqiB`Q6Lxy|Q{`|fgmRG(k+!#b*M+Z9zFce)f-7;?Km5O=LHV9f9_87; zF7%R2B+$?@sH&&-$@tzaPYkw0;=i|;vWdI|Wl3q_Zu>l;XdIw2FjV=;Mq5t1Q0|f< zs08j54Bp`3RzqE=2enlkZxmX6OF+@|2<)A^RNQpBd6o@OXl+i)zO%D4iGiQNuXd+zIR{_lb96{lc~bxsBveIw6umhShTX+3@ZJ=YHh@ zWY3(d0azg;7oHn>H<>?4@*RQbi>SmM=JrHvIG(~BrvI)#W(EAeO6fS+}mxxcc+X~W6&YVl86W9WFSS}Vz-f9vS?XUDBk)3TcF z8V?$4Q)`uKFq>xT=)Y9mMFVTUk*NIA!0$?RP6Ig0TBmUFrq*Q-Agq~DzxjStQyJ({ zBeZ;o5qUUKg=4Hypm|}>>L=XKsZ!F$yNTDO)jt4H0gdQ5$f|d&bnVCMMXhNh)~mN z@_UV6D7MVlsWz+zM+inZZp&P4fj=tm6fX)SG5H>OsQf_I8c~uGCig$GzuwViK54bcgL;VN|FnyQl>Ed7(@>=8$a_UKIz|V6CeVSd2(P z0Uu>A8A+muM%HLFJQ9UZ5c)BSAv_zH#1f02x?h9C}@pN@6{>UiAp>({Fn(T9Q8B z^`zB;kJ5b`>%dLm+Ol}ty!3;8f1XDSVX0AUe5P#@I+FQ-`$(a;zNgz)4x5hz$Hfbg z!Q(z26wHLXko(1`;(BAOg_wShpX0ixfWq3ponndY+u%1gyX)_h=v1zR#V}#q{au6; z!3K=7fQwnRfg6FXtNQmP>`<;!N137paFS%y?;lb1@BEdbvQHYC{976l`cLqn;b8lp zIDY>~m{gDj(wfnK!lpW6pli)HyLEiUrNc%eXTil|F2s(AY+LW5hkKb>TQ3|Q4S9rr zpDs4uK_co6XPsn_z$LeS{K4jFF`2>U`tbgKdyDne`xmR<@6AA+_hPNKCOR-Zqv;xk zu5!HsBUb^!4uJ7v0RuH-7?l?}b=w5lzzXJ~gZcxRKOovSk@|#V+MuX%Y+=;14i*%{)_gSW9(#4%)AV#3__kac1|qUy!uyP{>?U#5wYNq}y$S9pCc zFc~4mgSC*G~j0u#qqp9 z${>3HV~@->GqEhr_Xwoxq?Hjn#=s2;i~g^&Hn|aDKpA>Oc%HlW(KA1?BXqpxB;Ydx)w;2z^MpjJ(Qi(X!$5RC z*P{~%JGDQqojV>2JbEeCE*OEu!$XJ>bWA9Oa_Hd;y)F%MhBRi*LPcdqR8X`NQ&1L# z5#9L*@qxrx8n}LfeB^J{%-?SU{FCwiWyHp682F+|pa+CQa3ZLzBqN1{)h4d6+vBbV zC#NEbQLC;}me3eeYnOG*nXOJZEU$xLZ1<1Y=7r0(-U0P6-AqwMAM`a(Ed#7vJkn6plb4eI4?2y3yOTGmmDQ!z9`wzbf z_OY#0@5=bnep;MV0X_;;SJJWEf^E6Bd^tVJ9znWx&Ks8t*B>AM@?;D4oWUGc z!H*`6d7Cxo6VuyS4Eye&L1ZRhrRmN6Lr`{NL(wDbif|y&z)JN>Fl5#Wi&mMIr5i;x zBx}3YfF>>8EC(fYnmpu~)CYHuHCyr5*`ECap%t@y=jD>!_%3iiE|LN$mK9>- zHdtpy8fGZtkZF?%TW~29JIAfi2jZT8>OA7=h;8T{{k?c2`nCEx9$r zS+*&vt~2o^^J+}RDG@+9&M^K*z4p{5#IEVbz`1%`m5c2};aGt=V?~vIM}ZdPECDI)47|CWBCfDWUbxBCnmYivQ*0Nu_xb*C>~C9(VjHM zxe<*D<#dQ8TlpMX2c@M<9$w!RP$hpG4cs%AI){jp*Sj|*`m)5(Bw*A0$*i-(CA5#%>a)$+jI2C9r6|(>J8InryENI z$NohnxDUB;wAYDwrb*!N3noBTKPpPN}~09SEL18tkG zxgz(RYU_;DPT{l?Q$+eaZaxnsWCA^ds^0PVRkIM%bOd|G2IEBBiz{&^JtNsODs;5z zICt_Zj8wo^KT$7Bg4H+y!Df#3mbl%%?|EXe!&(Vmac1DJ*y~3+kRKAD=Ovde4^^%~ zw<9av18HLyrf*_>Slp;^i`Uy~`mvBjZ|?Ad63yQa#YK`4+c6;pW4?XIY9G1(Xh9WO8{F-Aju+nS9Vmv=$Ac0ienZ+p9*O%NG zMZKy5?%Z6TAJTE?o5vEr0r>f>hb#2w2U3DL64*au_@P!J!TL`oH2r*{>ffu6|A7tv zL4juf$DZ1MW5ZPsG!5)`k8d8c$J$o;%EIL0va9&GzWvkS%ZsGb#S(?{!UFOZ9<$a| zY|a+5kmD5N&{vRqkgY>aHsBT&`rg|&kezoD)gP0fsNYHsO#TRc_$n6Lf1Z{?+DLziXlHrq4sf(!>O{?Tj;Eh@%)+nRE_2VxbN&&%%caU#JDU%vL3}Cb zsb4AazPI{>8H&d=jUaZDS$-0^AxE@utGs;-Ez_F(qC9T=UZX=>ok2k2 ziTn{K?y~a5reD2A)P${NoI^>JXn>`IeArow(41c-Wm~)wiryEP(OS{YXWi7;%dG9v zI?mwu1MxD{yp_rrk!j^cKM)dc4@p4Ezyo%lRN|XyD}}>v=Xoib0gOcdXrQ^*61HNj z=NP|pd>@yfvr-=m{8$3A8TQGMTE7g=z!%yt`8`Bk-0MMwW~h^++;qyUP!J~ykh1GO z(FZ59xuFR$(WE;F@UUyE@Sp>`aVNjyj=Ty>_Vo}xf`e7`F;j-IgL5`1~-#70$9_=uBMq!2&1l zomRgpD58@)YYfvLtPW}{C5B35R;ZVvB<<#)x%srmc_S=A7F@DW8>QOEGwD6suhwCg z>Pa+YyULhmw%BA*4yjDp|2{!T98~<6Yfd(wo1mQ!KWwq0eg+6)o1>W~f~kL<-S+P@$wx*zeI|1t7z#Sxr5 zt6w+;YblPQNplq4Z#T$GLX#j6yldXAqj>4gAnnWtBICUnA&-dtnlh=t0Ho_vEKwV` z)DlJi#!@nkYV#$!)@>udAU*hF?V`2$Hf=V&6PP_|r#Iv*J$9)pF@X3`k;5})9^o4y z&)~?EjX5yX12O(BsFy-l6}nYeuKkiq`u9145&3Ssg^y{5G3Pse z9w(YVa0)N-fLaBq1`P!_#>SS(8fh_5!f{UrgZ~uEdeMJIz7DzI5!NHHqQtm~#CPij z?=N|J>nPR6_sL7!f4hD_|KH`vf8(Wpnj-(gPWH+ZvID}%?~68SwhPTC3u1_cB`otq z)U?6qo!ZLi5b>*KnYHWW=3F!p%h1;h{L&(Q&{qY6)_qxNfbP6E3yYpW!EO+IW3?@J z);4>g4gnl^8klu7uA>eGF6rIGSynacogr)KUwE_R4E5Xzi*Qir@b-jy55-JPC8c~( zo!W8y9OGZ&`xmc8;=4-U9=h{vCqfCNzYirONmGbRQlR`WWlgnY+1wCXbMz&NT~9*| z6@FrzP!LX&{no2!Ln_3|I==_4`@}V?4a;YZKTdw;vT<+K+z=uWbW(&bXEaWJ^W8Td z-3&1bY^Z*oM<=M}LVt>_j+p=2Iu7pZmbXrhQ_k)ysE9yXKygFNw$5hwDn(M>H+e1&9BM5!|81vd%r%vEm zqxY3?F@fb6O#5UunwgAHR9jp_W2zZ}NGp2%mTW@(hz7$^+a`A?mb8|_G*GNMJ) zjqegXQio=i@AINre&%ofexAr95aop5C+0MZ0m-l=MeO8m3epm7U%vZB8+I+C*iNFM z#T3l`gknX;D$-`2XT^Cg*vrv=RH+P;_dfF++cP?B_msQI4j+lt&rX2)3GaJx%W*Nn zkML%D{z5tpHH=dksQ*gzc|}gzW;lwAbxoR07VNgS*-c3d&8J|;@3t^ zVUz*J*&r7DFRuFVDCJDK8V9NN5hvpgGjwx+5n)qa;YCKe8TKtdnh{I7NU9BCN!0dq zczrBk8pE{{@vJa9ywR@mq*J=v+PG;?fwqlJVhijG!3VmIKs>9T6r7MJpC)m!Tc#>g zMtVsU>wbwFJEfwZ{vB|ZlttNe83)$iz`~#8UJ^r)lJ@HA&G#}W&ZH*;k{=TavpjWE z7hdyLZPf*X%Gm}i`Y{OGeeu^~nB8=`{r#TUrM-`;1cBvEd#d!kPqIgYySYhN-*1;L z^byj%Yi}Gx)Wnkosi337BKs}+5H5dth1JA{Ir-JKN$7zC)*}hqeoD(WfaUDPT>0`- z(6sa0AoIqASwF`>hP}^|)a_j2s^PQn*qVC{Q}htR z5-)duBFXT_V56-+UohKXlq~^6uf!6sA#ttk1o~*QEy_Y-S$gAvq47J9Vtk$5oA$Ct zYhYJ@8{hsC^98${!#Ho?4y5MCa7iGnfz}b9jE~h%EAAv~Qxu)_rAV;^cygV~5r_~?l=B`zObj7S=H=~$W zPtI_m%g$`kL_fVUk9J@>EiBH zOO&jtn~&`hIFMS5S`g8w94R4H40mdNUH4W@@XQk1sr17b{@y|JB*G9z1|CrQjd+GX z6+KyURG3;!*BQrentw{B2R&@2&`2}n(z-2&X7#r!{yg@Soy}cRD~j zj9@UBW+N|4HW4AWapy4wfUI- zZ`gSL6DUlgj*f1hSOGXG0IVH8HxK?o2|3HZ;KW{K+yPAlxtb)NV_2AwJm|E)FRs&& z=c^e7bvUsztY|+f^k7NXs$o1EUq>cR7C0$UKi6IooHWlK_#?IWDkvywnzg&ThWo^? z2O_N{5X39#?eV9l)xI(>@!vSB{DLt*oY!K1R8}_?%+0^C{d9a%N4 zoxHVT1&Lm|uDX%$QrBun5e-F`HJ^T$ zmzv)p@4ZHd_w9!%Hf9UYNvGCw2TTTbrj9pl+T9%-_-}L(tES>Or-}Z4F*{##n3~L~TuxjirGuIY#H7{%$E${?p{Q01 zi6T`n;rbK1yIB9jmQNycD~yZq&mbIsFWHo|ZAChSFPQa<(%d8mGw*V3fh|yFoxOOiWJd(qvVb!Z$b88cg->N=qO*4k~6;R==|9ihg&riu#P~s4Oap9O7f%crSr^rljeIfXDEg>wi)&v*a%7zpz<9w z*r!3q9J|390x`Zk;g$&OeN&ctp)VKRpDSV@kU2Q>jtok($Y-*x8_$2piTxun81@vt z!Vj?COa0fg2RPXMSIo26T=~0d`{oGP*eV+$!0I<(4azk&Vj3SiG=Q!6mX0p$z7I}; z9BJUFgT-K9MQQ-0@Z=^7R<{bn2Fm48endsSs`V7_@%8?Bxkqv>BDoVcj?K#dV#uUP zL1ND~?D-|VGKe3Rw_7-Idpht>H6XRLh*U7epS6byiGvJpr%d}XwfusjH9g;Z98H`x zyde%%5mhGOiL4wljCaWCk-&uE4_OOccb9c!ZaWt4B(wYl!?vyzl%7n~QepN&eFUrw zFIOl9c({``6~QD+43*_tzP{f2x41h(?b43^y6=iwyB)2os5hBE!@YUS5?N_tXd=h( z)WE286Fbd>R4M^P{!G)f;h<3Q>Fipuy+d2q-)!RyTgt;wr$(?9ox3;q+{E*ZQHhOn;lM`cjnu9 zXa48ks-v(~b*;MAI<>YZH(^NV8vjb34beE<_cwKlJoR;k6lJNSP6v}uiyRD?|0w+X@o1ONrH8a$fCxXpf? z?$DL0)7|X}Oc%h^zrMKWc-NS9I0Utu@>*j}b@tJ=ixQSJ={4@854wzW@E>VSL+Y{i z#0b=WpbCZS>kUCO_iQz)LoE>P5LIG-hv9E+oG}DtlIDF>$tJ1aw9^LuhLEHt?BCj& z(O4I8v1s#HUi5A>nIS-JK{v!7dJx)^Yg%XjNmlkWAq2*cv#tHgz`Y(bETc6CuO1VkN^L-L3j_x<4NqYb5rzrLC-7uOv z!5e`GZt%B782C5-fGnn*GhDF$%(qP<74Z}3xx+{$4cYKy2ikxI7B2N+2r07DN;|-T->nU&!=Cm#rZt%O_5c&1Z%nlWq3TKAW0w zQqemZw_ue--2uKQsx+niCUou?HjD`xhEjjQd3%rrBi82crq*~#uA4+>vR<_S{~5ce z-2EIl?~s z1=GVL{NxP1N3%=AOaC}j_Fv=ur&THz zyO!d9kHq|c73kpq`$+t+8Bw7MgeR5~`d7ChYyGCBWSteTB>8WAU(NPYt2Dk`@#+}= zI4SvLlyk#pBgVigEe`?NG*vl7V6m+<}%FwPV=~PvvA)=#ths==DRTDEYh4V5}Cf$z@#;< zyWfLY_5sP$gc3LLl2x+Ii)#b2nhNXJ{R~vk`s5U7Nyu^3yFg&D%Txwj6QezMX`V(x z=C`{76*mNb!qHHs)#GgGZ_7|vkt9izl_&PBrsu@}L`X{95-2jf99K)0=*N)VxBX2q z((vkpP2RneSIiIUEnGb?VqbMb=Zia+rF~+iqslydE34cSLJ&BJW^3knX@M;t*b=EA zNvGzv41Ld_T+WT#XjDB840vovUU^FtN_)G}7v)1lPetgpEK9YS^OWFkPoE{ovj^=@ zO9N$S=G$1ecndT_=5ehth2Lmd1II-PuT~C9`XVePw$y8J#dpZ?Tss<6wtVglm(Ok7 z3?^oi@pPio6l&!z8JY(pJvG=*pI?GIOu}e^EB6QYk$#FJQ%^AIK$I4epJ+9t?KjqA+bkj&PQ*|vLttme+`9G=L% ziadyMw_7-M)hS(3E$QGNCu|o23|%O+VN7;Qggp?PB3K-iSeBa2b}V4_wY`G1Jsfz4 z9|SdB^;|I8E8gWqHKx!vj_@SMY^hLEIbSMCuE?WKq=c2mJK z8LoG-pnY!uhqFv&L?yEuxo{dpMTsmCn)95xanqBrNPTgXP((H$9N${Ow~Is-FBg%h z53;|Y5$MUN)9W2HBe2TD`ct^LHI<(xWrw}$qSoei?}s)&w$;&!14w6B6>Yr6Y8b)S z0r71`WmAvJJ`1h&poLftLUS6Ir zC$bG9!Im_4Zjse)#K=oJM9mHW1{%l8sz$1o?ltdKlLTxWWPB>Vk22czVt|1%^wnN@*!l)}?EgtvhC>vlHm^t+ogpgHI1_$1ox9e;>0!+b(tBrmXRB`PY1vp-R**8N7 zGP|QqI$m(Rdu#=(?!(N}G9QhQ%o!aXE=aN{&wtGP8|_qh+7a_j_sU5|J^)vxq;# zjvzLn%_QPHZZIWu1&mRAj;Sa_97p_lLq_{~j!M9N^1yp3U_SxRqK&JnR%6VI#^E12 z>CdOVI^_9aPK2eZ4h&^{pQs}xsijXgFYRIxJ~N7&BB9jUR1fm!(xl)mvy|3e6-B3j zJn#ajL;bFTYJ2+Q)tDjx=3IklO@Q+FFM}6UJr6km7hj7th9n_&JR7fnqC!hTZoM~T zBeaVFp%)0cbPhejX<8pf5HyRUj2>aXnXBqDJe73~J%P(2C?-RT{c3NjE`)om! zl$uewSgWkE66$Kb34+QZZvRn`fob~Cl9=cRk@Es}KQm=?E~CE%spXaMO6YmrMl%9Q zlA3Q$3|L1QJ4?->UjT&CBd!~ru{Ih^in&JXO=|<6J!&qp zRe*OZ*cj5bHYlz!!~iEKcuE|;U4vN1rk$xq6>bUWD*u(V@8sG^7>kVuo(QL@Ki;yL zWC!FT(q{E8#on>%1iAS0HMZDJg{Z{^!De(vSIq&;1$+b)oRMwA3nc3mdTSG#3uYO_ z>+x;7p4I;uHz?ZB>dA-BKl+t-3IB!jBRgdvAbW!aJ(Q{aT>+iz?91`C-xbe)IBoND z9_Xth{6?(y3rddwY$GD65IT#f3<(0o#`di{sh2gm{dw*#-Vnc3r=4==&PU^hCv$qd zjw;>i&?L*Wq#TxG$mFIUf>eK+170KG;~+o&1;Tom9}}mKo23KwdEM6UonXgc z!6N(@k8q@HPw{O8O!lAyi{rZv|DpgfU{py+j(X_cwpKqcalcqKIr0kM^%Br3SdeD> zHSKV94Yxw;pjzDHo!Q?8^0bb%L|wC;4U^9I#pd5O&eexX+Im{ z?jKnCcsE|H?{uGMqVie_C~w7GX)kYGWAg%-?8|N_1#W-|4F)3YTDC+QSq1s!DnOML3@d`mG%o2YbYd#jww|jD$gotpa)kntakp#K;+yo-_ZF9qrNZw<%#C zuPE@#3RocLgPyiBZ+R_-FJ_$xP!RzWm|aN)S+{$LY9vvN+IW~Kf3TsEIvP+B9Mtm! zpfNNxObWQpLoaO&cJh5>%slZnHl_Q~(-Tfh!DMz(dTWld@LG1VRF`9`DYKhyNv z2pU|UZ$#_yUx_B_|MxUq^glT}O5Xt(Vm4Mr02><%C)@v;vPb@pT$*yzJ4aPc_FZ3z z3}PLoMBIM>q_9U2rl^sGhk1VUJ89=*?7|v`{!Z{6bqFMq(mYiA?%KbsI~JwuqVA9$H5vDE+VocjX+G^%bieqx->s;XWlKcuv(s%y%D5Xbc9+ zc(_2nYS1&^yL*ey664&4`IoOeDIig}y-E~_GS?m;D!xv5-xwz+G`5l6V+}CpeJDi^ z%4ed$qowm88=iYG+(`ld5Uh&>Dgs4uPHSJ^TngXP_V6fPyl~>2bhi20QB%lSd#yYn zO05?KT1z@?^-bqO8Cg`;ft>ilejsw@2%RR7;`$Vs;FmO(Yr3Fp`pHGr@P2hC%QcA|X&N2Dn zYf`MqXdHi%cGR@%y7Rg7?d3?an){s$zA{!H;Ie5exE#c~@NhQUFG8V=SQh%UxUeiV zd7#UcYqD=lk-}sEwlpu&H^T_V0{#G?lZMxL7ih_&{(g)MWBnCZxtXg znr#}>U^6!jA%e}@Gj49LWG@*&t0V>Cxc3?oO7LSG%~)Y5}f7vqUUnQ;STjdDU}P9IF9d9<$;=QaXc zL1^X7>fa^jHBu_}9}J~#-oz3Oq^JmGR#?GO7b9a(=R@fw@}Q{{@`Wy1vIQ#Bw?>@X z-_RGG@wt|%u`XUc%W{J z>iSeiz8C3H7@St3mOr_mU+&bL#Uif;+Xw-aZdNYUpdf>Rvu0i0t6k*}vwU`XNO2he z%miH|1tQ8~ZK!zmL&wa3E;l?!!XzgV#%PMVU!0xrDsNNZUWKlbiOjzH-1Uoxm8E#r`#2Sz;-o&qcqB zC-O_R{QGuynW14@)7&@yw1U}uP(1cov)twxeLus0s|7ayrtT8c#`&2~Fiu2=R;1_4bCaD=*E@cYI>7YSnt)nQc zohw5CsK%m?8Ack)qNx`W0_v$5S}nO|(V|RZKBD+btO?JXe|~^Qqur%@eO~<8-L^9d z=GA3-V14ng9L29~XJ>a5k~xT2152zLhM*@zlp2P5Eu}bywkcqR;ISbas&#T#;HZSf z2m69qTV(V@EkY(1Dk3`}j)JMo%ZVJ*5eB zYOjIisi+igK0#yW*gBGj?@I{~mUOvRFQR^pJbEbzFxTubnrw(Muk%}jI+vXmJ;{Q6 zrSobKD>T%}jV4Ub?L1+MGOD~0Ir%-`iTnWZN^~YPrcP5y3VMAzQ+&en^VzKEb$K!Q z<7Dbg&DNXuow*eD5yMr+#08nF!;%4vGrJI++5HdCFcGLfMW!KS*Oi@=7hFwDG!h2< zPunUEAF+HncQkbfFj&pbzp|MU*~60Z(|Ik%Tn{BXMN!hZOosNIseT?R;A`W?=d?5X zK(FB=9mZusYahp|K-wyb={rOpdn=@;4YI2W0EcbMKyo~-#^?h`BA9~o285%oY zfifCh5Lk$SY@|2A@a!T2V+{^!psQkx4?x0HSV`(w9{l75QxMk!)U52Lbhn{8ol?S) zCKo*7R(z!uk<6*qO=wh!Pul{(qq6g6xW;X68GI_CXp`XwO zxuSgPRAtM8K7}5E#-GM!*ydOOG_{A{)hkCII<|2=ma*71ci_-}VPARm3crFQjLYV! z9zbz82$|l01mv`$WahE2$=fAGWkd^X2kY(J7iz}WGS z@%MyBEO=A?HB9=^?nX`@nh;7;laAjs+fbo!|K^mE!tOB>$2a_O0y-*uaIn8k^6Y zSbuv;5~##*4Y~+y7Z5O*3w4qgI5V^17u*ZeupVGH^nM&$qmAk|anf*>r zWc5CV;-JY-Z@Uq1Irpb^O`L_7AGiqd*YpGUShb==os$uN3yYvb`wm6d=?T*it&pDk zo`vhw)RZX|91^^Wa_ti2zBFyWy4cJu#g)_S6~jT}CC{DJ_kKpT`$oAL%b^!2M;JgT zM3ZNbUB?}kP(*YYvXDIH8^7LUxz5oE%kMhF!rnPqv!GiY0o}NR$OD=ITDo9r%4E>E0Y^R(rS^~XjWyVI6 zMOR5rPXhTp*G*M&X#NTL`Hu*R+u*QNoiOKg4CtNPrjgH>c?Hi4MUG#I917fx**+pJfOo!zFM&*da&G_x)L(`k&TPI*t3e^{crd zX<4I$5nBQ8Ax_lmNRa~E*zS-R0sxkz`|>7q_?*e%7bxqNm3_eRG#1ae3gtV9!fQpY z+!^a38o4ZGy9!J5sylDxZTx$JmG!wg7;>&5H1)>f4dXj;B+@6tMlL=)cLl={jLMxY zbbf1ax3S4>bwB9-$;SN2?+GULu;UA-35;VY*^9Blx)Jwyb$=U!D>HhB&=jSsd^6yw zL)?a|>GxU!W}ocTC(?-%z3!IUhw^uzc`Vz_g>-tv)(XA#JK^)ZnC|l1`@CdX1@|!| z_9gQ)7uOf?cR@KDp97*>6X|;t@Y`k_N@)aH7gY27)COv^P3ya9I{4z~vUjLR9~z1Z z5=G{mVtKH*&$*t0@}-i_v|3B$AHHYale7>E+jP`ClqG%L{u;*ff_h@)al?RuL7tOO z->;I}>%WI{;vbLP3VIQ^iA$4wl6@0sDj|~112Y4OFjMs`13!$JGkp%b&E8QzJw_L5 zOnw9joc0^;O%OpF$Qp)W1HI!$4BaXX84`%@#^dk^hFp^pQ@rx4g(8Xjy#!X%+X5Jd@fs3amGT`}mhq#L97R>OwT5-m|h#yT_-v@(k$q7P*9X~T*3)LTdzP!*B} z+SldbVWrrwQo9wX*%FyK+sRXTa@O?WM^FGWOE?S`R(0P{<6p#f?0NJvnBia?k^fX2 zNQs7K-?EijgHJY}&zsr;qJ<*PCZUd*x|dD=IQPUK_nn)@X4KWtqoJNHkT?ZWL_hF? zS8lp2(q>;RXR|F;1O}EE#}gCrY~#n^O`_I&?&z5~7N;zL0)3Tup`%)oHMK-^r$NT% zbFg|o?b9w(q@)6w5V%si<$!U<#}s#x@0aX-hP>zwS#9*75VXA4K*%gUc>+yzupTDBOKH8WR4V0pM(HrfbQ&eJ79>HdCvE=F z|J>s;;iDLB^3(9}?biKbxf1$lI!*Z%*0&8UUq}wMyPs_hclyQQi4;NUY+x2qy|0J; zhn8;5)4ED1oHwg+VZF|80<4MrL97tGGXc5Sw$wAI#|2*cvQ=jB5+{AjMiDHmhUC*a zlmiZ`LAuAn_}hftXh;`Kq0zblDk8?O-`tnilIh|;3lZp@F_osJUV9`*R29M?7H{Fy z`nfVEIDIWXmU&YW;NjU8)EJpXhxe5t+scf|VXM!^bBlwNh)~7|3?fWwo_~ZFk(22% zTMesYw+LNx3J-_|DM~`v93yXe=jPD{q;li;5PD?Dyk+b? zo21|XpT@)$BM$%F=P9J19Vi&1#{jM3!^Y&fr&_`toi`XB1!n>sbL%U9I5<7!@?t)~ z;&H%z>bAaQ4f$wIzkjH70;<8tpUoxzKrPhn#IQfS%9l5=Iu))^XC<58D!-O z{B+o5R^Z21H0T9JQ5gNJnqh#qH^na|z92=hONIM~@_iuOi|F>jBh-?aA20}Qx~EpDGElELNn~|7WRXRFnw+Wdo`|# zBpU=Cz3z%cUJ0mx_1($X<40XEIYz(`noWeO+x#yb_pwj6)R(__%@_Cf>txOQ74wSJ z0#F3(zWWaR-jMEY$7C*3HJrohc79>MCUu26mfYN)f4M~4gD`}EX4e}A!U}QV8!S47 z6y-U-%+h`1n`*pQuKE%Av0@)+wBZr9mH}@vH@i{v(m-6QK7Ncf17x_D=)32`FOjjo zg|^VPf5c6-!FxN{25dvVh#fog=NNpXz zfB$o+0jbRkHH{!TKhE709f+jI^$3#v1Nmf80w`@7-5$1Iv_`)W^px8P-({xwb;D0y z7LKDAHgX<84?l!I*Dvi2#D@oAE^J|g$3!)x1Ua;_;<@#l1fD}lqU2_tS^6Ht$1Wl} zBESo7o^)9-Tjuz$8YQSGhfs{BQV6zW7dA?0b(Dbt=UnQs&4zHfe_sj{RJ4uS-vQpC zX;Bbsuju4%!o8?&m4UZU@~ZZjeFF6ex2ss5_60_JS_|iNc+R0GIjH1@Z z=rLT9%B|WWgOrR7IiIwr2=T;Ne?30M!@{%Qf8o`!>=s<2CBpCK_TWc(DX51>e^xh8 z&@$^b6CgOd7KXQV&Y4%}_#uN*mbanXq(2=Nj`L7H7*k(6F8s6{FOw@(DzU`4-*77{ zF+dxpv}%mFpYK?>N_2*#Y?oB*qEKB}VoQ@bzm>ptmVS_EC(#}Lxxx730trt0G)#$b zE=wVvtqOct1%*9}U{q<)2?{+0TzZzP0jgf9*)arV)*e!f`|jgT{7_9iS@e)recI#z zbzolURQ+TOzE!ymqvBY7+5NnAbWxvMLsLTwEbFqW=CPyCsmJ}P1^V30|D5E|p3BC5 z)3|qgw@ra7aXb-wsa|l^in~1_fm{7bS9jhVRkYVO#U{qMp z)Wce+|DJ}4<2gp8r0_xfZpMo#{Hl2MfjLcZdRB9(B(A(f;+4s*FxV{1F|4d`*sRNd zp4#@sEY|?^FIJ;tmH{@keZ$P(sLh5IdOk@k^0uB^BWr@pk6mHy$qf&~rI>P*a;h0C{%oA*i!VjWn&D~O#MxN&f@1Po# zKN+ zrGrkSjcr?^R#nGl<#Q722^wbYcgW@{+6CBS<1@%dPA8HC!~a`jTz<`g_l5N1M@9wn9GOAZ>nqNgq!yOCbZ@1z`U_N`Z>}+1HIZxk*5RDc&rd5{3qjRh8QmT$VyS;jK z;AF+r6XnnCp=wQYoG|rT2@8&IvKq*IB_WvS%nt%e{MCFm`&W*#LXc|HrD?nVBo=(8*=Aq?u$sDA_sC_RPDUiQ+wnIJET8vx$&fxkW~kP9qXKt zozR)@xGC!P)CTkjeWvXW5&@2?)qt)jiYWWBU?AUtzAN}{JE1I)dfz~7$;}~BmQF`k zpn11qmObXwRB8&rnEG*#4Xax3XBkKlw(;tb?Np^i+H8m(Wyz9k{~ogba@laiEk;2! zV*QV^6g6(QG%vX5Um#^sT&_e`B1pBW5yVth~xUs#0}nv?~C#l?W+9Lsb_5)!71rirGvY zTIJ$OPOY516Y|_014sNv+Z8cc5t_V=i>lWV=vNu#!58y9Zl&GsMEW#pPYPYGHQ|;vFvd*9eM==$_=vc7xnyz0~ zY}r??$<`wAO?JQk@?RGvkWVJlq2dk9vB(yV^vm{=NVI8dhsX<)O(#nr9YD?I?(VmQ z^r7VfUBn<~p3()8yOBjm$#KWx!5hRW)5Jl7wY@ky9lNM^jaT##8QGVsYeaVywmpv>X|Xj7gWE1Ezai&wVLt3p)k4w~yrskT-!PR!kiyQlaxl(( zXhF%Q9x}1TMt3~u@|#wWm-Vq?ZerK={8@~&@9r5JW}r#45#rWii};t`{5#&3$W)|@ zbAf2yDNe0q}NEUvq_Quq3cTjcw z@H_;$hu&xllCI9CFDLuScEMg|x{S7GdV8<&Mq=ezDnRZAyX-8gv97YTm0bg=d)(>N z+B2FcqvI9>jGtnK%eO%y zoBPkJTk%y`8TLf4)IXPBn`U|9>O~WL2C~C$z~9|0m*YH<-vg2CD^SX#&)B4ngOSG$ zV^wmy_iQk>dfN@Pv(ckfy&#ak@MLC7&Q6Ro#!ezM*VEh`+b3Jt%m(^T&p&WJ2Oqvj zs-4nq0TW6cv~(YI$n0UkfwN}kg3_fp?(ijSV#tR9L0}l2qjc7W?i*q01=St0eZ=4h zyGQbEw`9OEH>NMuIe)hVwYHsGERWOD;JxEiO7cQv%pFCeR+IyhwQ|y@&^24k+|8fD zLiOWFNJ2&vu2&`Jv96_z-Cd5RLgmeY3*4rDOQo?Jm`;I_(+ejsPM03!ly!*Cu}Cco zrQSrEDHNyzT(D5s1rZq!8#?f6@v6dB7a-aWs(Qk>N?UGAo{gytlh$%_IhyL7h?DLXDGx zgxGEBQoCAWo-$LRvM=F5MTle`M})t3vVv;2j0HZY&G z22^iGhV@uaJh(XyyY%} zd4iH_UfdV#T=3n}(Lj^|n;O4|$;xhu*8T3hR1mc_A}fK}jfZ7LX~*n5+`8N2q#rI$ z@<_2VANlYF$vIH$ zl<)+*tIWW78IIINA7Rr7i{<;#^yzxoLNkXL)eSs=%|P>$YQIh+ea_3k z_s7r4%j7%&*NHSl?R4k%1>Z=M9o#zxY!n8sL5>BO-ZP;T3Gut>iLS@U%IBrX6BA3k z)&@q}V8a{X<5B}K5s(c(LQ=%v1ocr`t$EqqY0EqVjr65usa=0bkf|O#ky{j3)WBR(((L^wmyHRzoWuL2~WTC=`yZ zn%VX`L=|Ok0v7?s>IHg?yArBcync5rG#^+u)>a%qjES%dRZoIyA8gQ;StH z1Ao7{<&}6U=5}4v<)1T7t!J_CL%U}CKNs-0xWoTTeqj{5{?Be$L0_tk>M9o8 zo371}S#30rKZFM{`H_(L`EM9DGp+Mifk&IP|C2Zu_)Ghr4Qtpmkm1osCf@%Z$%t+7 zYH$Cr)Ro@3-QDeQJ8m+x6%;?YYT;k6Z0E-?kr>x33`H%*ueBD7Zx~3&HtWn0?2Wt} zTG}*|v?{$ajzt}xPzV%lL1t-URi8*Zn)YljXNGDb>;!905Td|mpa@mHjIH%VIiGx- zd@MqhpYFu4_?y5N4xiHn3vX&|e6r~Xt> zZG`aGq|yTNjv;9E+Txuoa@A(9V7g?1_T5FzRI;!=NP1Kqou1z5?%X~Wwb{trRfd>i z8&y^H)8YnKyA_Fyx>}RNmQIczT?w2J4SNvI{5J&}Wto|8FR(W;Qw#b1G<1%#tmYzQ zQ2mZA-PAdi%RQOhkHy9Ea#TPSw?WxwL@H@cbkZwIq0B!@ns}niALidmn&W?!Vd4Gj zO7FiuV4*6Mr^2xlFSvM;Cp_#r8UaqIzHJQg_z^rEJw&OMm_8NGAY2)rKvki|o1bH~ z$2IbfVeY2L(^*rMRU1lM5Y_sgrDS`Z??nR2lX;zyR=c%UyGb*%TC-Dil?SihkjrQy~TMv6;BMs7P8il`H7DmpVm@rJ;b)hW)BL)GjS154b*xq-NXq2cwE z^;VP7ua2pxvCmxrnqUYQMH%a%nHmwmI33nJM(>4LznvY*k&C0{8f*%?zggpDgkuz&JBx{9mfb@wegEl2v!=}Sq2Gaty0<)UrOT0{MZtZ~j5y&w zXlYa_jY)I_+VA-^#mEox#+G>UgvM!Ac8zI<%JRXM_73Q!#i3O|)lOP*qBeJG#BST0 zqohi)O!|$|2SeJQo(w6w7%*92S})XfnhrH_Z8qe!G5>CglP=nI7JAOW?(Z29;pXJ9 zR9`KzQ=WEhy*)WH>$;7Cdz|>*i>=##0bB)oU0OR>>N<21e4rMCHDemNi2LD>Nc$;& zQRFthpWniC1J6@Zh~iJCoLOxN`oCKD5Q4r%ynwgUKPlIEd#?QViIqovY|czyK8>6B zSP%{2-<;%;1`#0mG^B(8KbtXF;Nf>K#Di72UWE4gQ%(_26Koiad)q$xRL~?pN71ZZ zujaaCx~jXjygw;rI!WB=xrOJO6HJ!!w}7eiivtCg5K|F6$EXa)=xUC za^JXSX98W`7g-tm@uo|BKj39Dl;sg5ta;4qjo^pCh~{-HdLl6qI9Ix6f$+qiZ$}s= zNguKrU;u+T@ko(Vr1>)Q%h$?UKXCY>3se%&;h2osl2D zE4A9bd7_|^njDd)6cI*FupHpE3){4NQ*$k*cOWZ_?CZ>Z4_fl@n(mMnYK62Q1d@+I zr&O))G4hMihgBqRIAJkLdk(p(D~X{-oBUA+If@B}j& zsHbeJ3RzTq96lB7d($h$xTeZ^gP0c{t!Y0c)aQE;$FY2!mACg!GDEMKXFOPI^)nHZ z`aSPJpvV0|bbrzhWWkuPURlDeN%VT8tndV8?d)eN*i4I@u zVKl^6{?}A?P)Fsy?3oi#clf}L18t;TjNI2>eI&(ezDK7RyqFxcv%>?oxUlonv(px) z$vnPzRH`y5A(x!yOIfL0bmgeMQB$H5wenx~!ujQK*nUBW;@Em&6Xv2%s(~H5WcU2R z;%Nw<$tI)a`Ve!>x+qegJnQsN2N7HaKzrFqM>`6R*gvh%O*-%THt zrB$Nk;lE;z{s{r^PPm5qz(&lM{sO*g+W{sK+m3M_z=4=&CC>T`{X}1Vg2PEfSj2x_ zmT*(x;ov%3F?qoEeeM>dUn$a*?SIGyO8m806J1W1o+4HRhc2`9$s6hM#qAm zChQ87b~GEw{ADfs+5}FJ8+|bIlIv(jT$Ap#hSHoXdd9#w<#cA<1Rkq^*EEkknUd4& zoIWIY)sAswy6fSERVm&!SO~#iN$OgOX*{9@_BWFyJTvC%S++ilSfCrO(?u=Dc?CXZ zzCG&0yVR{Z`|ZF0eEApWEo#s9osV>F{uK{QA@BES#&;#KsScf>y zvs?vIbI>VrT<*!;XmQS=bhq%46-aambZ(8KU-wOO2=en~D}MCToB_u;Yz{)1ySrPZ z@=$}EvjTdzTWU7c0ZI6L8=yP+YRD_eMMos}b5vY^S*~VZysrkq<`cK3>>v%uy7jgq z0ilW9KjVDHLv0b<1K_`1IkbTOINs0=m-22c%M~l=^S}%hbli-3?BnNq?b`hx^HX2J zIe6ECljRL0uBWb`%{EA=%!i^4sMcj+U_TaTZRb+~GOk z^ZW!nky0n*Wb*r+Q|9H@ml@Z5gU&W`(z4-j!OzC1wOke`TRAYGZVl$PmQ16{3196( zO*?`--I}Qf(2HIwb2&1FB^!faPA2=sLg(@6P4mN)>Dc3i(B0;@O-y2;lM4akD>@^v z=u>*|!s&9zem70g7zfw9FXl1bpJW(C#5w#uy5!V?Q(U35A~$dR%LDVnq@}kQm13{} zd53q3N(s$Eu{R}k2esbftfjfOITCL;jWa$}(mmm}d(&7JZ6d3%IABCapFFYjdEjdK z&4Edqf$G^MNAtL=uCDRs&Fu@FXRgX{*0<(@c3|PNHa>L%zvxWS={L8%qw`STm+=Rd zA}FLspESSIpE_^41~#5yI2bJ=9`oc;GIL!JuW&7YetZ?0H}$$%8rW@*J37L-~Rsx!)8($nI4 zZhcZ2^=Y+p4YPl%j!nFJA|*M^gc(0o$i3nlphe+~-_m}jVkRN{spFs(o0ajW@f3K{ zDV!#BwL322CET$}Y}^0ixYj2w>&Xh12|R8&yEw|wLDvF!lZ#dOTHM9pK6@Nm-@9Lnng4ZHBgBSrr7KI8YCC9DX5Kg|`HsiwJHg2(7#nS;A{b3tVO?Z% za{m5b3rFV6EpX;=;n#wltDv1LE*|g5pQ+OY&*6qCJZc5oDS6Z6JD#6F)bWxZSF@q% z+1WV;m!lRB!n^PC>RgQCI#D1br_o^#iPk>;K2hB~0^<~)?p}LG%kigm@moD#q3PE+ zA^Qca)(xnqw6x>XFhV6ku9r$E>bWNrVH9fum0?4s?Rn2LG{Vm_+QJHse6xa%nzQ?k zKug4PW~#Gtb;#5+9!QBgyB@q=sk9=$S{4T>wjFICStOM?__fr+Kei1 z3j~xPqW;W@YkiUM;HngG!;>@AITg}vAE`M2Pj9Irl4w1fo4w<|Bu!%rh%a(Ai^Zhi zs92>v5;@Y(Zi#RI*ua*h`d_7;byQSa*v9E{2x$<-_=5Z<7{%)}4XExANcz@rK69T0x3%H<@frW>RA8^swA+^a(FxK| zFl3LD*ImHN=XDUkrRhp6RY5$rQ{bRgSO*(vEHYV)3Mo6Jy3puiLmU&g82p{qr0F?ohmbz)f2r{X2|T2 z$4fdQ=>0BeKbiVM!e-lIIs8wVTuC_m7}y4A_%ikI;Wm5$9j(^Y z(cD%U%k)X>_>9~t8;pGzL6L-fmQO@K; zo&vQzMlgY95;1BSkngY)e{`n0!NfVgf}2mB3t}D9@*N;FQ{HZ3Pb%BK6;5#-O|WI( zb6h@qTLU~AbVW#_6?c!?Dj65Now7*pU{h!1+eCV^KCuPAGs28~3k@ueL5+u|Z-7}t z9|lskE`4B7W8wMs@xJa{#bsCGDFoRSNSnmNYB&U7 zVGKWe%+kFB6kb)e;TyHfqtU6~fRg)f|>=5(N36)0+C z`hv65J<$B}WUc!wFAb^QtY31yNleq4dzmG`1wHTj=c*=hay9iD071Hc?oYoUk|M*_ zU1GihAMBsM@5rUJ(qS?9ZYJ6@{bNqJ`2Mr+5#hKf?doa?F|+^IR!8lq9)wS3tF_9n zW_?hm)G(M+MYb?V9YoX^_mu5h-LP^TL^!Q9Z7|@sO(rg_4+@=PdI)WL(B7`!K^ND- z-uIuVDCVEdH_C@c71YGYT^_Scf_dhB8Z2Xy6vGtBSlYud9vggOqv^L~F{BraSE_t} zIkP+Hp2&nH^-MNEs}^`oMLy11`PQW$T|K(`Bu*(f@)mv1-qY(_YG&J2M2<7k;;RK~ zL{Fqj9yCz8(S{}@c)S!65aF<=&eLI{hAMErCx&>i7OeDN>okvegO87OaG{Jmi<|}D zaT@b|0X{d@OIJ7zvT>r+eTzgLq~|Dpu)Z&db-P4z*`M$UL51lf>FLlq6rfG)%doyp z)3kk_YIM!03eQ8Vu_2fg{+osaEJPtJ-s36R+5_AEG12`NG)IQ#TF9c@$99%0iye+ zUzZ57=m2)$D(5Nx!n)=5Au&O0BBgwxIBaeI(mro$#&UGCr<;C{UjJVAbVi%|+WP(a zL$U@TYCxJ=1{Z~}rnW;7UVb7+ZnzgmrogDxhjLGo>c~MiJAWs&&;AGg@%U?Y^0JhL ze(x6Z74JG6FlOFK(T}SXQfhr}RIFl@QXKnIcXYF)5|V~e-}suHILKT-k|<*~Ij|VF zC;t@=uj=hot~*!C68G8hTA%8SzOfETOXQ|3FSaIEjvBJp(A)7SWUi5!Eu#yWgY+;n zlm<$+UDou*V+246_o#V4kMdto8hF%%Lki#zPh}KYXmMf?hrN0;>Mv%`@{0Qn`Ujp) z=lZe+13>^Q!9zT);H<(#bIeRWz%#*}sgUX9P|9($kexOyKIOc`dLux}c$7It4u|Rl z6SSkY*V~g_B-hMPo_ak>>z@AVQ(_N)VY2kB3IZ0G(iDUYw+2d7W^~(Jq}KY=JnWS( z#rzEa&0uNhJ>QE8iiyz;n2H|SV#Og+wEZv=f2%1ELX!SX-(d3tEj$5$1}70Mp<&eI zCkfbByL7af=qQE@5vDVxx1}FSGt_a1DoE3SDI+G)mBAna)KBG4p8Epxl9QZ4BfdAN zFnF|Y(umr;gRgG6NLQ$?ZWgllEeeq~z^ZS7L?<(~O&$5|y)Al^iMKy}&W+eMm1W z7EMU)u^ke(A1#XCV>CZ71}P}0x)4wtHO8#JRG3MA-6g=`ZM!FcICCZ{IEw8Dm2&LQ z1|r)BUG^0GzI6f946RrBlfB1Vs)~8toZf~7)+G;pv&XiUO(%5bm)pl=p>nV^o*;&T z;}@oZSibzto$arQgfkp|z4Z($P>dTXE{4O=vY0!)kDO* zGF8a4wq#VaFpLfK!iELy@?-SeRrdz%F*}hjKcA*y@mj~VD3!it9lhRhX}5YOaR9$} z3mS%$2Be7{l(+MVx3 z(4?h;P!jnRmX9J9sYN#7i=iyj_5q7n#X(!cdqI2lnr8T$IfOW<_v`eB!d9xY1P=2q&WtOXY=D9QYteP)De?S4}FK6#6Ma z=E*V+#s8>L;8aVroK^6iKo=MH{4yEZ_>N-N z`(|;aOATba1^asjxlILk<4}f~`39dBFlxj>Dw(hMYKPO3EEt1@S`1lxFNM+J@uB7T zZ8WKjz7HF1-5&2=l=fqF-*@>n5J}jIxdDwpT?oKM3s8Nr`x8JnN-kCE?~aM1H!hAE z%%w(3kHfGwMnMmNj(SU(w42OrC-euI>Dsjk&jz3ts}WHqmMpzQ3vZrsXrZ|}+MHA7 z068obeXZTsO*6RS@o3x80E4ok``rV^Y3hr&C1;|ZZ0|*EKO`$lECUYG2gVFtUTw)R z4Um<0ZzlON`zTdvVdL#KFoMFQX*a5wM0Czp%wTtfK4Sjs)P**RW&?lP$(<}q%r68Z zS53Y!d@&~ne9O)A^tNrXHhXBkj~$8j%pT1%%mypa9AW5E&s9)rjF4@O3ytH{0z6riz|@< zB~UPh*wRFg2^7EbQrHf0y?E~dHlkOxof_a?M{LqQ^C!i2dawHTPYUE=X@2(3<=OOxs8qn_(y>pU>u^}3y&df{JarR0@VJn0f+U%UiF=$Wyq zQvnVHESil@d|8&R<%}uidGh7@u^(%?$#|&J$pvFC-n8&A>utA=n3#)yMkz+qnG3wd zP7xCnF|$9Dif@N~L)Vde3hW8W!UY0BgT2v(wzp;tlLmyk2%N|0jfG$%<;A&IVrOI< z!L)o>j>;dFaqA3pL}b-Je(bB@VJ4%!JeX@3x!i{yIeIso^=n?fDX`3bU=eG7sTc%g%ye8$v8P@yKE^XD=NYxTb zbf!Mk=h|otpqjFaA-vs5YOF-*GwWPc7VbaOW&stlANnCN8iftFMMrUdYNJ_Bnn5Vt zxfz@Ah|+4&P;reZxp;MmEI7C|FOv8NKUm8njF7Wb6Gi7DeODLl&G~}G4be&*Hi0Qw z5}77vL0P+7-B%UL@3n1&JPxW^d@vVwp?u#gVcJqY9#@-3X{ok#UfW3<1fb%FT`|)V~ggq z(3AUoUS-;7)^hCjdT0Kf{i}h)mBg4qhtHHBti=~h^n^OTH5U*XMgDLIR@sre`AaB$ zg)IGBET_4??m@cx&c~bA80O7B8CHR7(LX7%HThkeC*@vi{-pL%e)yXp!B2InafbDF zjPXf1mko3h59{lT6EEbxKO1Z5GF71)WwowO6kY|6tjSVSWdQ}NsK2x{>i|MKZK8%Q zfu&_0D;CO-Jg0#YmyfctyJ!mRJp)e#@O0mYdp|8x;G1%OZQ3Q847YWTyy|%^cpA;m zze0(5p{tMu^lDkpe?HynyO?a1$_LJl2L&mpeKu%8YvgRNr=%2z${%WThHG=vrWY@4 zsA`OP#O&)TetZ>s%h!=+CE15lOOls&nvC~$Qz0Ph7tHiP;O$i|eDwpT{cp>+)0-|; zY$|bB+Gbel>5aRN3>c0x)4U=|X+z+{ zn*_p*EQoquRL+=+p;=lm`d71&1NqBz&_ph)MXu(Nv6&XE7(RsS)^MGj5Q?Fwude-(sq zjJ>aOq!7!EN>@(fK7EE#;i_BGvli`5U;r!YA{JRodLBc6-`n8K+Fjgwb%sX;j=qHQ z7&Tr!)!{HXoO<2BQrV9Sw?JRaLXV8HrsNevvnf>Y-6|{T!pYLl7jp$-nEE z#X!4G4L#K0qG_4Z;Cj6=;b|Be$hi4JvMH!-voxqx^@8cXp`B??eFBz2lLD8RRaRGh zn7kUfy!YV~p(R|p7iC1Rdgt$_24i0cd-S8HpG|`@my70g^y`gu%#Tf_L21-k?sRRZHK&at(*ED0P8iw{7?R$9~OF$Ko;Iu5)ur5<->x!m93Eb zFYpIx60s=Wxxw=`$aS-O&dCO_9?b1yKiPCQmSQb>T)963`*U+Ydj5kI(B(B?HNP8r z*bfSBpSu)w(Z3j7HQoRjUG(+d=IaE~tv}y14zHHs|0UcN52fT8V_<@2ep_ee{QgZG zmgp8iv4V{k;~8@I%M3<#B;2R>Ef(Gg_cQM7%}0s*^)SK6!Ym+~P^58*wnwV1BW@eG z4sZLqsUvBbFsr#8u7S1r4teQ;t)Y@jnn_m5jS$CsW1um!p&PqAcc8!zyiXHVta9QC zY~wCwCF0U%xiQPD_INKtTb;A|Zf29(mu9NI;E zc-e>*1%(LSXB`g}kd`#}O;veb<(sk~RWL|f3ljxCnEZDdNSTDV6#Td({6l&y4IjKF z^}lIUq*ZUqgTPumD)RrCN{M^jhY>E~1pn|KOZ5((%F)G|*ZQ|r4zIbrEiV%42hJV8 z3xS)=!X1+=olbdGJ=yZil?oXLct8FM{(6ikLL3E%=q#O6(H$p~gQu6T8N!plf!96| z&Q3=`L~>U0zZh;z(pGR2^S^{#PrPxTRHD1RQOON&f)Siaf`GLj#UOk&(|@0?zm;Sx ztsGt8=29-MZs5CSf1l1jNFtNt5rFNZxJPvkNu~2}7*9468TWm>nN9TP&^!;J{-h)_ z7WsHH9|F%I`Pb!>KAS3jQWKfGivTVkMJLO-HUGM_a4UQ_%RgL6WZvrW+Z4ujZn;y@ zz9$=oO!7qVTaQAA^BhX&ZxS*|5dj803M=k&2%QrXda`-Q#IoZL6E(g+tN!6CA!CP* zCpWtCujIea)ENl0liwVfj)Nc<9mV%+e@=d`haoZ*`B7+PNjEbXBkv=B+Pi^~L#EO$D$ZqTiD8f<5$eyb54-(=3 zh)6i8i|jp(@OnRrY5B8t|LFXFQVQ895n*P16cEKTrT*~yLH6Z4e*bZ5otpRDri&+A zfNbK1D5@O=sm`fN=WzWyse!za5n%^+6dHPGX#8DyIK>?9qyX}2XvBWVqbP%%D)7$= z=#$WulZlZR<{m#gU7lwqK4WS1Ne$#_P{b17qe$~UOXCl>5b|6WVh;5vVnR<%d+Lnp z$uEmML38}U4vaW8>shm6CzB(Wei3s#NAWE3)a2)z@i{4jTn;;aQS)O@l{rUM`J@K& l00vQ5JBs~;vo!vr%%-k{2_Fq1Mn4QF81S)AQ99zk{{c4yR+0b! literal 0 HcmV?d00001 diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties new file mode 100644 index 0000000..d4081da --- /dev/null +++ b/gradle/wrapper/gradle-wrapper.properties @@ -0,0 +1,7 @@ +distributionBase=GRADLE_USER_HOME +distributionPath=wrapper/dists +distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip +networkTimeout=10000 +validateDistributionUrl=true +zipStoreBase=GRADLE_USER_HOME +zipStorePath=wrapper/dists diff --git a/gradlew b/gradlew new file mode 100755 index 0000000..05e3f09 --- /dev/null +++ b/gradlew @@ -0,0 +1,124 @@ +#!/bin/sh + +# +# Copyright © 2015-2021 the original authors. +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. +# + +############################################################################## +# Gradle start up script for POSIX generated by "Gradle 8.5" +############################################################################## + +# Attempt to set APP_HOME + +# Resolve links: $0 may be a link +app_path=$0 + +# Need this for daisy-chained symlinks. +while + APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path + [ -h "$app_path" ] +do + ls=$( ls -ld "$app_path" ) + link=${ls#*' -> '} + case $link in #( + /*) app_path=$link ;; #( absolute + *) app_path=$APP_HOME$link ;; #( relative + esac +done + +# This is reliable as long as the user does not change working directory during the script's execution. +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +APP_NAME="Gradle" +APP_BASE_NAME=${0##*/} + +# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"' + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + ;; + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked. + # shellcheck disable=SC2039,SC3045 + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, following the shell quoting and substitution rules +eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$@" + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..2b49b8c --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,92 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%"=="" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%"=="" set DIRNAME=. +@rem This is normally unused +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if %ERRORLEVEL% equ 0 goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if %ERRORLEVEL% equ 0 goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /C_ return code! +set EXIT_CODE=%ERRORLEVEL% +if %EXIT_CODE% equ 0 set EXIT_CODE=1 +if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE% +exit /b %EXIT_CODE% + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/sdk/build.gradle.kts b/sdk/build.gradle.kts new file mode 100644 index 0000000..827ead2 --- /dev/null +++ b/sdk/build.gradle.kts @@ -0,0 +1,27 @@ +plugins { + id("com.android.library") + id("org.jetbrains.kotlin.android") +} + +android { + namespace = "com.duooomi.ble" + compileSdk = 34 + + defaultConfig { + minSdk = 26 + consumerProguardFiles("consumer-rules.pro") + } + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 + } + + kotlinOptions { + jvmTarget = "17" + } +} + +dependencies { + implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3") +} diff --git a/sdk/src/main/AndroidManifest.xml b/sdk/src/main/AndroidManifest.xml new file mode 100644 index 0000000..fc0a1f5 --- /dev/null +++ b/sdk/src/main/AndroidManifest.xml @@ -0,0 +1,16 @@ + + + + + + + + + + + + + + diff --git a/sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleConfig.kt b/sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleConfig.kt new file mode 100644 index 0000000..5fd43e7 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleConfig.kt @@ -0,0 +1,12 @@ +package com.duooomi.ble + +data class DuooomiBleConfig( + val apiHost: String = "https://api.mixvideo.bowong.cc", + val apiKey: String, + val cdnHost: String = "https://cdn.bowong.cc/", + val firmwareIdentifier: String = "duomi", + val firmwareStatus: String = "DRAFT" +) { + val normalizedCdnHost: String + get() = if (cdnHost.endsWith("/")) cdnHost else "$cdnHost/" +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleSDK.kt b/sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleSDK.kt new file mode 100644 index 0000000..9e05919 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/DuooomiBleSDK.kt @@ -0,0 +1,530 @@ +package com.duooomi.ble + +import android.content.Context +import com.duooomi.ble.core.* +import com.duooomi.ble.models.* +import com.duooomi.ble.protocol.CommandType +import com.duooomi.ble.services.* +import com.duooomi.ble.utils.BleLog +import kotlinx.coroutines.* +import kotlinx.coroutines.flow.* +import org.json.JSONObject +import java.net.HttpURLConnection +import java.net.URL + +class DuooomiBleSDK(context: Context, val config: DuooomiBleConfig) { + + // MARK: - Observable State + + private val _btState = MutableStateFlow(ConnectionState.IDLE) + val btState: StateFlow = _btState.asStateFlow() + + private val _discoveredDevices = MutableStateFlow>(emptyList()) + val discoveredDevices: StateFlow> = _discoveredDevices.asStateFlow() + + private val _connectedDevice = MutableStateFlow(null) + val connectedDevice: StateFlow = _connectedDevice.asStateFlow() + + private val _deviceInfo = MutableStateFlow(null) + val deviceInfo: StateFlow = _deviceInfo.asStateFlow() + + private val _version = MutableStateFlow("") + val version: StateFlow = _version.asStateFlow() + + private val _isActivated = MutableStateFlow(false) + val isActivated: StateFlow = _isActivated.asStateFlow() + + private val _transferProgress = MutableStateFlow(0) + val transferProgress: StateFlow = _transferProgress.asStateFlow() + + private val _error = MutableStateFlow(null) + val error: StateFlow = _error.asStateFlow() + + // MARK: - Internal Services + + private val bleClient = BleClient(context) + private val protocolService = BleProtocolService(bleClient) + private val deviceInfoService = DeviceInfoService(protocolService) + private val fileTransferService = FileTransferService(protocolService) + private val aniConverter = AniConverter(config) + private val firmwareService = FirmwareService(config) + + // MARK: - Request-Response + + private val pendingContinuations = mutableMapOf>() + private var messageListenerJob: Job? = null + + // MARK: - Scan State + + private val exceptionHandler = CoroutineExceptionHandler { _, throwable -> + BleLog.e("Coroutine exception: ${throwable.message}", "SDK") + _error.value = throwable.message + } + private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Main + exceptionHandler) + private var scanJob: Job? = null + private val allDiscoveredDevices = mutableListOf() + private var flushJob: Job? = null + + init { + BleLog.i("SDK initialized (apiHost=${config.apiHost}, firmware=${config.firmwareIdentifier}/${config.firmwareStatus})", "SDK") + setupDisconnectHandler() + } + + private fun setupDisconnectHandler() { + bleClient.onDisconnected = { + scope.launch { + BleLog.w("Peripheral disconnected; resetting state", "SDK") + _connectedDevice.value = null + _deviceInfo.value = null + _version.value = "" + _isActivated.value = false + _btState.value = ConnectionState.DISCONNECTED + protocolService.stopListening() + cancelAllPending(DuooomiBleError.NotConnected) + } + } + } + + // MARK: - Scanning + + fun scan() { + stopScan() + _btState.value = ConnectionState.SCANNING + _discoveredDevices.value = emptyList() + allDiscoveredDevices.clear() + + BleLog.i("Start scanning...", "Scan") + scanJob = scope.launch { + try { + bleClient.scan().collect { device -> + BleLog.d("Discovered: id=${device.id}, name=${device.name ?: "-"}, rssi=${device.rssi}", "Scan") + queueDevice(device) + } + } catch (e: Exception) { + BleLog.e("Scan error: ${e.message}", "Scan") + _error.value = e.message + _btState.value = ConnectionState.IDLE + } + } + } + + fun stopScan() { + scanJob?.cancel() + scanJob = null + bleClient.stopScan() + flushDevices() + + if (_connectedDevice.value != null) { + _btState.value = ConnectionState.CONNECTED + } else if (_btState.value == ConnectionState.SCANNING) { + _btState.value = ConnectionState.IDLE + } + BleLog.i("Stop scanning (state=${_btState.value})", "Scan") + } + + // MARK: - Connection + + suspend fun connect(deviceId: String): DiscoveredDevice { + stopScan() + _btState.value = ConnectionState.CONNECTING + BleLog.i("Connecting to $deviceId...", "Connect") + + try { + val gatt = bleClient.connect(deviceId) + + // Start protocol listener + protocolService.startListening(scope) + startMessageListener() + + val device = DiscoveredDevice( + id = gatt.device.address, + name = gatt.device.name, + rssi = 0 + ) + _connectedDevice.value = device + _btState.value = ConnectionState.CONNECTED + BleLog.i("Connected: ${device.id}", "Connect") + return device + } catch (e: Exception) { + _btState.value = ConnectionState.IDLE + _error.value = e.message + BleLog.e("Connect failed: ${e.message}", "Connect") + throw e + } + } + + suspend fun disconnect() { + _btState.value = ConnectionState.DISCONNECTING + BleLog.i("Disconnect requested", "Connect") + protocolService.stopListening() + messageListenerJob?.cancel() + messageListenerJob = null + cancelAllPending(DuooomiBleError.NotConnected) + + var disconnectError: Exception? = null + try { + bleClient.disconnect() + } catch (e: Exception) { + disconnectError = e + _error.value = e.message + BleLog.e("Disconnect error: ${e.message}", "Connect") + } + + _connectedDevice.value = null + _deviceInfo.value = null + _version.value = "" + _isActivated.value = false + _btState.value = ConnectionState.DISCONNECTED + BleLog.i("Disconnected", "Connect") + + disconnectError?.let { throw it } + } + + fun getConnectedDevices(): List { + val list = bleClient.retrieveConnectedDevices() + BleLog.d("System-connected devices: ${list.size}", "Connect") + return list + } + + // MARK: - Device Commands + + suspend fun getDeviceInfo(): DeviceInfo { + ensureConnected() + BleLog.d("Sending getDeviceInfo", "Command") + val data = sendAndWait(CommandType.GET_DEVICE_INFO) { + deviceInfoService.getDeviceInfo() + } + val info = DeviceInfo.fromJson(parseJsonResponse(data)) + BleLog.i("DeviceInfo received: name=${info.name}, brand=${info.brand}", "Command") + _deviceInfo.value = info + return info + } + + suspend fun getVersion(): VersionInfo { + ensureConnected() + BleLog.d("Sending getDeviceVersion", "Command") + val data = sendAndWait(CommandType.GET_DEVICE_VERSION) { + deviceInfoService.getDeviceVersion() + } + val info = VersionInfo.fromJson(parseJsonResponse(data)) + _version.value = info.version + BleLog.i("Version received: ${info.version} (type=${info.type})", "Command") + return info + } + + suspend fun bind(userId: String): BindingResponse { + ensureConnected() + BleLog.d("Sending bind (userId=$userId)", "Command") + val data = sendAndWait(CommandType.BIND_DEVICE) { + deviceInfoService.bindDevice(userId) + } + val resp = BindingResponse.fromJson(parseJsonResponse(data)) + _isActivated.value = resp.success == 1 + if (resp.success != 1) { + BleLog.w("Bind failed: device already bound", "Command") + throw DuooomiBleError.BindingFailed("Device already bound to another user") + } + BleLog.i("Bind success: sn=${resp.sn}", "Command") + return resp + } + + suspend fun unbind(userId: String): UnbindResponse { + ensureConnected() + BleLog.d("Sending unbind (userId=$userId)", "Command") + val data = sendAndWait(CommandType.UNBIND_DEVICE) { + deviceInfoService.unbindDevice(userId) + } + val resp = UnbindResponse.fromJson(parseJsonResponse(data)) + if (resp.success == 1) { + _isActivated.value = false + BleLog.i("Unbind success", "Command") + } else { + BleLog.w("Unbind failed", "Command") + throw DuooomiBleError.UnbindFailed + } + return resp + } + + suspend fun deleteFile(key: String): DeleteFileResponse { + ensureConnected() + BleLog.d("Sending deleteFile (key=$key)", "Command") + val data = sendAndWait(CommandType.DELETE_FILE) { + deviceInfoService.deleteFile(key) + } + val resp = DeleteFileResponse.fromJson(parseJsonResponse(data)) + if (resp.success != 0) { + BleLog.w("Delete failed with status=${resp.success}", "Command") + throw DuooomiBleError.DeleteFileFailed(resp.success) + } + BleLog.i("Delete success (key=$key)", "Command") + return resp + } + + suspend fun prepareTransfer(key: String, size: Int): PrepareTransferResponse { + ensureConnected() + val opId = "${CommandType.PREPARE_TRANSFER.value}_$key" + BleLog.d("Sending prepareTransfer (key=$key, size=$size)", "Transfer") + val data = sendAndWait(opId = opId, command = CommandType.PREPARE_TRANSFER) { + deviceInfoService.prepareTransfer(key, size) + } + val resp = PrepareTransferResponse.fromJson(parseJsonResponse(data)) + if (resp.status != "ready") { + BleLog.w("PrepareTransfer not ready: status=${resp.status}", "Transfer") + throw DuooomiBleError.PrepareTransferFailed(resp.status) + } + BleLog.i("PrepareTransfer ready (key=$key)", "Transfer") + return resp + } + + // MARK: - File Transfer + + suspend fun transferFile( + fileUri: String, + commandType: CommandType = CommandType.TRANSFER_ANI_VIDEO + ) { + ensureConnected() + _transferProgress.value = 0 + BleLog.i("Transfer start: uri=$fileUri, cmd=$commandType", "Transfer") + + fileTransferService.transferFile( + fileUri = fileUri, + commandType = commandType + ) { progress -> + val percent = (progress * 100).toInt() + _transferProgress.value = percent + if (percent % 10 == 0) { + BleLog.d("Progress: $percent%", "Transfer") + } + } + + _transferProgress.value = 100 + BleLog.i("Transfer completed", "Transfer") + } + + // MARK: - High-Level APIs + + suspend fun transferMedia(fileUrl: String) { + ensureConnected() + val url = fileUrl.trim() + if (url.isEmpty()) throw DuooomiBleError.TransferFailed("Empty file URL") + + val isAni = url.lowercase().endsWith(".ani") + val aniUrl: String + + if (isAni) { + aniUrl = url + BleLog.i("Direct ANI transfer: $url", "Transfer") + } else { + BleLog.i("Converting to ANI: $url", "Transfer") + try { + aniUrl = aniConverter.convert(url) + } catch (e: Exception) { + throw DuooomiBleError.TransferFailed("ANI conversion failed: ${e.message}") + } + BleLog.i("ANI ready: $aniUrl", "Transfer") + } + + val aniSize = getRemoteFileSize(aniUrl) + BleLog.d("ANI size: $aniSize bytes", "Transfer") + + val key = url + prepareTransfer(key = key, size = aniSize) + + transferFile(fileUri = aniUrl, commandType = CommandType.TRANSFER_ANI_VIDEO) + } + + suspend fun fetchLatestFirmware( + identifier: String? = null, + status: String? = null + ): FirmwareInfo? { + return firmwareService.fetchLatest(identifier, status) + } + + suspend fun upgradeFirmware(fileUrl: String) { + ensureConnected() + BleLog.i("OTA upgrade start: $fileUrl", "Firmware") + transferFile(fileUri = fileUrl, commandType = CommandType.OTA_PACKAGE) + BleLog.i("OTA upgrade completed", "Firmware") + } + + // MARK: - Internal Helpers + + private suspend fun getRemoteFileSize(url: String): Int = withContext(Dispatchers.IO) { + val fileUrl = URL(url) + + // Try HEAD request first + val headConn = fileUrl.openConnection() as HttpURLConnection + try { + headConn.requestMethod = "HEAD" + headConn.connectTimeout = 15_000 + headConn.connect() + val length = headConn.contentLength + if (length > 0) return@withContext length + } finally { + headConn.disconnect() + } + + // Fallback: Range request + val rangeConn = fileUrl.openConnection() as HttpURLConnection + try { + rangeConn.requestMethod = "GET" + rangeConn.setRequestProperty("Range", "bytes=0-0") + rangeConn.connectTimeout = 15_000 + rangeConn.connect() + val rangeHeader = rangeConn.getHeaderField("Content-Range") + if (rangeHeader != null) { + val totalStr = rangeHeader.split("/").lastOrNull() + val total = totalStr?.toIntOrNull() + if (total != null && total > 0) return@withContext total + } + } finally { + rangeConn.disconnect() + } + + throw DuooomiBleError.TransferFailed("Cannot determine file size: $url") + } + + // MARK: - Request-Response Pattern + + private suspend fun sendAndWait( + commandType: CommandType, + timeoutMs: Long = 10_000, + send: suspend () -> Unit + ): ByteArray { + return sendAndWait( + opId = "${commandType.value}", + command = commandType, + timeoutMs = timeoutMs, + send = send + ) + } + + private suspend fun sendAndWait( + opId: String, + command: CommandType, + timeoutMs: Long = 10_000, + send: suspend () -> Unit + ): ByteArray { + BleLog.d("Register opId=$opId, cmd=$command", "RPC") + try { + return withTimeout(timeoutMs) { + coroutineScope { + val resultDeferred = async { + suspendCancellableCoroutine { continuation -> + pendingContinuations[opId] = continuation + continuation.invokeOnCancellation { + pendingContinuations.remove(opId) + } + BleLog.d("Continuation stored for opId=$opId", "RPC") + } + } + + // Send command + send() + BleLog.d("Command sent for opId=$opId", "RPC") + + // Wait for response + val result = resultDeferred.await() + BleLog.d("Result received for opId=$opId", "RPC") + result + } + } + } catch (e: Exception) { + pendingContinuations.remove(opId)?.let { stale -> + stale.cancel() + } + if (e is TimeoutCancellationException) { + BleLog.e("RPC timeout for opId=$opId", "RPC") + throw DuooomiBleError.Timeout(command) + } + BleLog.e("RPC failed for opId=$opId: ${e.message}", "RPC") + throw e + } + } + + // MARK: - Message Listener + + private fun startMessageListener() { + messageListenerJob?.cancel() + messageListenerJob = scope.launch { + BleLog.i("Message listener started", "RPC") + protocolService.incomingMessages.collect { (commandType, data) -> + BleLog.d("Incoming message: type=$commandType, size=${data.size}", "RPC") + handleIncomingMessage(commandType, data) + } + } + } + + private fun handleIncomingMessage(commandType: Byte, data: ByteArray) { + val typeValue = commandType.toInt() and 0xFF + val opId = "$typeValue" + + // Check for prepareTransfer with key-based opId + if (typeValue == CommandType.PREPARE_TRANSFER.value) { + try { + val json = parseJsonResponse(data) + val resp = PrepareTransferResponse.fromJson(json) + val keyedOpId = "${typeValue}_${resp.key}" + pendingContinuations.remove(keyedOpId)?.let { continuation -> + BleLog.d("Resuming keyed opId=$keyedOpId", "RPC") + continuation.resume(data, null) + return + } + } catch (_: Exception) { } + } + + pendingContinuations.remove(opId)?.let { continuation -> + BleLog.d("Resuming opId=$opId", "RPC") + continuation.resume(data, null) + } ?: BleLog.w("No pending continuation for opId=$opId", "RPC") + } + + // MARK: - Helpers + + private fun ensureConnected() { + if (_connectedDevice.value == null) { + BleLog.w("Operation requires connection", "SDK") + throw DuooomiBleError.NotConnected + } + } + + private fun parseJsonResponse(data: ByteArray): JSONObject { + // Device responses may contain null bytes + val cleaned = data.filter { it != 0.toByte() }.toByteArray() + val jsonStr = String(cleaned, Charsets.UTF_8) + return try { + JSONObject(jsonStr) + } catch (e: Exception) { + BleLog.e("JSON parse failed: ${e.message}\nRaw: $jsonStr", "Decode") + throw e + } + } + + private fun cancelAllPending(error: Exception) { + val continuations = pendingContinuations.toMap() + pendingContinuations.clear() + for ((_, continuation) in continuations) { + continuation.cancel(CancellationException(error.message)) + } + } + + // MARK: - Scan Batching (500ms throttle) + + private fun queueDevice(device: DiscoveredDevice) { + if (allDiscoveredDevices.any { it.id == device.id }) return + + allDiscoveredDevices.add(device) + + flushJob?.cancel() + flushJob = scope.launch { + delay(500) + flushDevices() + } + } + + private fun flushDevices() { + if (allDiscoveredDevices.isEmpty()) return + _discoveredDevices.value = allDiscoveredDevices.toList() + BleLog.d("Discovered devices flushed: total=${_discoveredDevices.value.size}", "Scan") + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/core/BleClient.kt b/sdk/src/main/kotlin/com/duooomi/ble/core/BleClient.kt new file mode 100644 index 0000000..ae637a2 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/core/BleClient.kt @@ -0,0 +1,329 @@ +package com.duooomi.ble.core + +import android.annotation.SuppressLint +import android.bluetooth.* +import android.bluetooth.le.ScanCallback +import android.bluetooth.le.ScanFilter +import android.bluetooth.le.ScanResult +import android.bluetooth.le.ScanSettings +import android.content.Context +import android.os.ParcelUuid +import com.duooomi.ble.protocol.BleUUIDs +import com.duooomi.ble.utils.BleLog +import kotlinx.coroutines.* +import kotlinx.coroutines.channels.awaitClose +import kotlinx.coroutines.flow.* +import kotlinx.coroutines.sync.Mutex +import kotlinx.coroutines.sync.withLock +import kotlin.coroutines.resume +import kotlin.coroutines.resumeWithException + +/** + * Android BLE wrapper using coroutines. + * Mirrors iOS BleClient 1:1. + */ +@SuppressLint("MissingPermission") +internal class BleClient(context: Context) { + + private val appContext = context.applicationContext + private val bluetoothManager = appContext.getSystemService(Context.BLUETOOTH_SERVICE) as BluetoothManager + private val bluetoothAdapter: BluetoothAdapter? = bluetoothManager.adapter + + var connectedGatt: BluetoothGatt? = null + private set + var connectedDeviceId: String? = null + private set + private var writeCharacteristic: BluetoothGattCharacteristic? = null + private var readCharacteristic: BluetoothGattCharacteristic? = null + + private val writeMutex = Mutex() + + // Continuations for connect/disconnect + private var connectContinuation: CancellableContinuation? = null + private var disconnectContinuation: CancellableContinuation? = null + + // Notification flow + private val _notifications = MutableSharedFlow(extraBufferCapacity = 64) + val notifications: SharedFlow = _notifications + + // Callbacks + var onDisconnected: (() -> Unit)? = null + + // Scan state + private var scanCallback: ScanCallback? = null + + val bluetoothState: Int + get() = bluetoothAdapter?.state ?: BluetoothAdapter.STATE_OFF + + val isBluetoothEnabled: Boolean + get() = bluetoothAdapter?.isEnabled == true + + // MARK: - Scan + + fun scan(): Flow = callbackFlow { + val scanner = bluetoothAdapter?.bluetoothLeScanner + ?: throw DuooomiBleError.BluetoothNotPoweredOn("Adapter unavailable") + + if (!isBluetoothEnabled) { + throw DuooomiBleError.BluetoothNotPoweredOn("Bluetooth is off") + } + + val callback = object : ScanCallback() { + override fun onScanResult(callbackType: Int, result: ScanResult) { + val device = DiscoveredDevice( + id = result.device.address, + name = result.device.name ?: result.scanRecord?.deviceName, + rssi = result.rssi + ) + BleLog.d("Did discover: id=${device.id}, rssi=${device.rssi}", "BLE") + trySend(device) + } + + override fun onScanFailed(errorCode: Int) { + BleLog.e("Scan failed: errorCode=$errorCode", "BLE") + close(DuooomiBleError.BluetoothNotPoweredOn("Scan failed: $errorCode")) + } + } + scanCallback = callback + + val filters = listOf( + ScanFilter.Builder() + .setServiceUuid(ParcelUuid(BleUUIDs.SERVICE)) + .build() + ) + val settings = ScanSettings.Builder() + .setScanMode(ScanSettings.SCAN_MODE_LOW_LATENCY) + .build() + + BleLog.i("CBCentral startScan", "BLE") + try { + scanner.startScan(filters, settings, callback) + } catch (e: SecurityException) { + BleLog.e("Scan permission denied: ${e.message}", "BLE") + close(DuooomiBleError.PermissionDenied) + return@callbackFlow + } + + awaitClose { + BleLog.i("CBCentral stopScan", "BLE") + scanner.stopScan(callback) + scanCallback = null + } + } + + fun stopScan() { + try { + val scanner = bluetoothAdapter?.bluetoothLeScanner ?: return + scanCallback?.let { + scanner.stopScan(it) + scanCallback = null + BleLog.i("CBCentral stopScan", "BLE") + } + } catch (e: SecurityException) { + BleLog.w("stopScan permission error: ${e.message}", "BLE") + scanCallback = null + } catch (_: Exception) { + scanCallback = null + } + } + + // MARK: - Connect + + suspend fun connect(deviceId: String, timeoutMs: Long = 30_000): BluetoothGatt { + if (!isBluetoothEnabled) { + throw DuooomiBleError.BluetoothNotPoweredOn("Bluetooth is off") + } + + val device = bluetoothAdapter?.getRemoteDevice(deviceId) + ?: throw DuooomiBleError.ConnectionFailed("Device not found: $deviceId") + + return withTimeout(timeoutMs) { + suspendCancellableCoroutine { continuation -> + connectContinuation = continuation + continuation.invokeOnCancellation { + connectContinuation = null + connectedGatt?.disconnect() + BleLog.w("Connection cancelled: $deviceId", "BLE") + } + + BleLog.i("Connecting to peripheral: $deviceId", "BLE") + device.connectGatt(appContext, false, gattCallback, BluetoothDevice.TRANSPORT_LE) + } + } + } + + // MARK: - Disconnect + + suspend fun disconnect() { + val gatt = connectedGatt ?: return + + try { + withTimeout(5_000) { + suspendCancellableCoroutine { continuation -> + disconnectContinuation = continuation + continuation.invokeOnCancellation { + disconnectContinuation = null + cleanup() + } + + BleLog.i("Cancel connection: ${gatt.device.address}", "BLE") + gatt.disconnect() + } + } + } catch (_: TimeoutCancellationException) { + BleLog.w("Force-finish disconnect after timeout", "BLE") + cleanup() + } + } + + // MARK: - Write + + suspend fun writeWithoutResponse(data: ByteArray) { + val gatt = connectedGatt ?: throw DuooomiBleError.NotConnected + val characteristic = writeCharacteristic ?: throw DuooomiBleError.NotConnected + + writeMutex.withLock { + characteristic.writeType = BluetoothGattCharacteristic.WRITE_TYPE_NO_RESPONSE + characteristic.value = data + val success = gatt.writeCharacteristic(characteristic) + if (!success) { + BleLog.w("Write failed, len=${data.size}", "BLE") + } else { + BleLog.d("Write w/o response, len=${data.size}", "BLE") + } + } + } + + // MARK: - Connected Devices + + fun retrieveConnectedDevices(): List { + val peripherals = bluetoothManager.getConnectedDevices(BluetoothProfile.GATT) + return peripherals.map { device -> + DiscoveredDevice( + id = device.address, + name = device.name, + rssi = 0 + ) + } + } + + // MARK: - Private + + private fun cleanup() { + connectedGatt?.close() + connectedGatt = null + connectedDeviceId = null + writeCharacteristic = null + readCharacteristic = null + BleLog.i("Client state cleaned up", "BLE") + } + + // MARK: - GATT Callback + + private val gattCallback = object : BluetoothGattCallback() { + + override fun onConnectionStateChange(gatt: BluetoothGatt, status: Int, newState: Int) { + when (newState) { + BluetoothProfile.STATE_CONNECTED -> { + BleLog.i("Did connect: ${gatt.device.address}", "BLE") + // Request MTU 512 for throughput + gatt.requestMtu(512) + } + + BluetoothProfile.STATE_DISCONNECTED -> { + // If disconnect happens mid-setup, resolve connect continuation + connectContinuation?.let { cont -> + connectContinuation = null + cont.resumeWithException( + DuooomiBleError.ConnectionFailed("Disconnected during setup") + ) + } + + val wasConnected = connectedGatt != null + cleanup() + + disconnectContinuation?.let { cont -> + disconnectContinuation = null + cont.resume(Unit) + } + + BleLog.w("Did disconnect: ${gatt.device.address}, status=$status", "BLE") + if (wasConnected) { + onDisconnected?.invoke() + } + } + } + } + + override fun onMtuChanged(gatt: BluetoothGatt, mtu: Int, status: Int) { + BleLog.d("MTU changed: $mtu, status=$status", "BLE") + // After MTU negotiation, discover services + gatt.discoverServices() + } + + override fun onServicesDiscovered(gatt: BluetoothGatt, status: Int) { + if (status != BluetoothGatt.GATT_SUCCESS) { + val cont = connectContinuation + connectContinuation = null + BleLog.e("Discover services failed: status=$status", "BLE") + cont?.resumeWithException( + DuooomiBleError.ConnectionFailed("Service discovery failed: $status") + ) + return + } + + val service = gatt.getService(BleUUIDs.SERVICE) + if (service == null) { + val cont = connectContinuation + connectContinuation = null + BleLog.e("Service not found", "BLE") + cont?.resumeWithException(DuooomiBleError.ServiceNotFound) + return + } + + BleLog.d("Service found: ${service.uuid}", "BLE") + + writeCharacteristic = service.getCharacteristic(BleUUIDs.WRITE_CHARACTERISTIC) + readCharacteristic = service.getCharacteristic(BleUUIDs.READ_CHARACTERISTIC) + + if (writeCharacteristic == null || readCharacteristic == null) { + val cont = connectContinuation + connectContinuation = null + BleLog.e("Required characteristics missing", "BLE") + cont?.resumeWithException(DuooomiBleError.CharacteristicNotFound) + return + } + + // Enable notifications on read characteristic + val readChar = readCharacteristic!! + gatt.setCharacteristicNotification(readChar, true) + val descriptor = readChar.getDescriptor( + java.util.UUID.fromString("00002902-0000-1000-8000-00805f9b34fb") + ) + if (descriptor != null) { + descriptor.value = BluetoothGattDescriptor.ENABLE_NOTIFICATION_VALUE + gatt.writeDescriptor(descriptor) + } + + // Connection fully ready + connectedGatt = gatt + connectedDeviceId = gatt.device.address + val cont = connectContinuation + connectContinuation = null + BleLog.i("Characteristics ready; connection established", "BLE") + cont?.resume(gatt) + } + + @Suppress("DEPRECATION") + override fun onCharacteristicChanged( + gatt: BluetoothGatt, + characteristic: BluetoothGattCharacteristic + ) { + if (characteristic.uuid == BleUUIDs.READ_CHARACTERISTIC) { + val value = characteristic.value ?: return + BleLog.d("Notification received, len=${value.size}", "BLE") + _notifications.tryEmit(value.copyOf()) + } + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/core/BleTypes.kt b/sdk/src/main/kotlin/com/duooomi/ble/core/BleTypes.kt new file mode 100644 index 0000000..8eecfd1 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/core/BleTypes.kt @@ -0,0 +1,29 @@ +package com.duooomi.ble.core + +import com.duooomi.ble.protocol.CommandType + +enum class ConnectionState { + IDLE, SCANNING, CONNECTING, CONNECTED, DISCONNECTING, DISCONNECTED +} + +data class DiscoveredDevice( + val id: String, + val name: String?, + val rssi: Int +) + +sealed class DuooomiBleError(message: String) : Exception(message) { + class BluetoothNotPoweredOn(state: String) : DuooomiBleError("Bluetooth not powered on: $state") + object NotConnected : DuooomiBleError("No device connected") + class Timeout(val command: CommandType) : DuooomiBleError("Timeout: $command") + class ConnectionFailed(reason: String) : DuooomiBleError("Connection failed: $reason") + object ServiceNotFound : DuooomiBleError("BLE service not found") + object CharacteristicNotFound : DuooomiBleError("Characteristic not found") + class BindingFailed(reason: String) : DuooomiBleError("Binding failed: $reason") + object UnbindFailed : DuooomiBleError("Unbind failed") + class DeleteFileFailed(val status: Int) : DuooomiBleError("Delete failed: status=$status") + class PrepareTransferFailed(val status: String) : DuooomiBleError("Prepare failed: $status") + class TransferFailed(reason: String) : DuooomiBleError("Transfer failed: $reason") + object InvalidFrame : DuooomiBleError("Invalid protocol frame") + object PermissionDenied : DuooomiBleError("Bluetooth permission denied") +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/models/BindingResponse.kt b/sdk/src/main/kotlin/com/duooomi/ble/models/BindingResponse.kt new file mode 100644 index 0000000..8137676 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/models/BindingResponse.kt @@ -0,0 +1,28 @@ +package com.duooomi.ble.models + +import org.json.JSONObject + +data class BindingResponse( + val type: Int, + val sn: String, + val success: Int, + val contents: List +) { + companion object { + fun fromJson(json: JSONObject): BindingResponse { + val contentsArray = json.optJSONArray("contents") + val contents = mutableListOf() + if (contentsArray != null) { + for (i in 0 until contentsArray.length()) { + contents.add(contentsArray.getString(i)) + } + } + return BindingResponse( + type = json.optInt("type", 0), + sn = json.optString("sn", ""), + success = json.optInt("success", 0), + contents = contents + ) + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/models/DeleteFileResponse.kt b/sdk/src/main/kotlin/com/duooomi/ble/models/DeleteFileResponse.kt new file mode 100644 index 0000000..5ee5e75 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/models/DeleteFileResponse.kt @@ -0,0 +1,18 @@ +package com.duooomi.ble.models + +import org.json.JSONObject + +data class DeleteFileResponse( + val type: Int, + /** 0 = success, 1 = failed, 2 = file not found */ + val success: Int +) { + companion object { + fun fromJson(json: JSONObject): DeleteFileResponse { + return DeleteFileResponse( + type = json.optInt("type", 0), + success = json.optInt("success", 0) + ) + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/models/DeviceInfo.kt b/sdk/src/main/kotlin/com/duooomi/ble/models/DeviceInfo.kt new file mode 100644 index 0000000..e54ebc2 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/models/DeviceInfo.kt @@ -0,0 +1,25 @@ +package com.duooomi.ble.models + +import org.json.JSONObject + +data class DeviceInfo( + val allspace: Long, + val freespace: Long, + val name: String, + val size: String, + val brand: String, + val powerlevel: Int +) { + companion object { + fun fromJson(json: JSONObject): DeviceInfo { + return DeviceInfo( + allspace = json.optLong("allspace", 0L), + freespace = json.optLong("freespace", 0L), + name = json.optString("name", ""), + size = json.optString("size", ""), + brand = json.optString("brand", ""), + powerlevel = json.optInt("powerlevel", 0) + ) + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/models/FirmwareInfo.kt b/sdk/src/main/kotlin/com/duooomi/ble/models/FirmwareInfo.kt new file mode 100644 index 0000000..7b4ccfb --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/models/FirmwareInfo.kt @@ -0,0 +1,27 @@ +package com.duooomi.ble.models + +import org.json.JSONObject + +data class FirmwareInfo( + val version: String, + val fileUrl: String, + val description: String?, + val fileSize: String?, + val fileMd5: String?, + val identifier: String?, + val status: String? +) { + companion object { + fun fromJson(json: JSONObject): FirmwareInfo { + return FirmwareInfo( + version = json.optString("version", ""), + fileUrl = json.optString("fileUrl", ""), + description = json.optString("description").ifEmpty { null }, + fileSize = json.optString("fileSize").ifEmpty { null }, + fileMd5 = json.optString("fileMd5").ifEmpty { null }, + identifier = json.optString("identifier").ifEmpty { null }, + status = json.optString("status").ifEmpty { null } + ) + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/models/PrepareTransferResponse.kt b/sdk/src/main/kotlin/com/duooomi/ble/models/PrepareTransferResponse.kt new file mode 100644 index 0000000..28096f3 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/models/PrepareTransferResponse.kt @@ -0,0 +1,20 @@ +package com.duooomi.ble.models + +import org.json.JSONObject + +data class PrepareTransferResponse( + val type: Int, + val key: String, + /** "ready" | "no_space" | "duplicated" */ + val status: String +) { + companion object { + fun fromJson(json: JSONObject): PrepareTransferResponse { + return PrepareTransferResponse( + type = json.optInt("type", 0), + key = json.optString("key", ""), + status = json.optString("status", "") + ) + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/models/UnbindResponse.kt b/sdk/src/main/kotlin/com/duooomi/ble/models/UnbindResponse.kt new file mode 100644 index 0000000..d5b3b81 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/models/UnbindResponse.kt @@ -0,0 +1,15 @@ +package com.duooomi.ble.models + +import org.json.JSONObject + +data class UnbindResponse( + val success: Int +) { + companion object { + fun fromJson(json: JSONObject): UnbindResponse { + return UnbindResponse( + success = json.optInt("success", 0) + ) + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/models/VersionInfo.kt b/sdk/src/main/kotlin/com/duooomi/ble/models/VersionInfo.kt new file mode 100644 index 0000000..5288812 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/models/VersionInfo.kt @@ -0,0 +1,22 @@ +package com.duooomi.ble.models + +import org.json.JSONObject + +data class VersionInfo( + val version: String, + val type: String +) { + companion object { + fun fromJson(json: JSONObject): VersionInfo { + val typeValue = when { + json.has("type") && json.get("type") is String -> json.getString("type") + json.has("type") -> json.getInt("type").toString() + else -> "" + } + return VersionInfo( + version = json.optString("version", ""), + type = typeValue + ) + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolConstants.kt b/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolConstants.kt new file mode 100644 index 0000000..3fe0cab --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolConstants.kt @@ -0,0 +1,44 @@ +package com.duooomi.ble.protocol + +import java.util.UUID + +object BleUUIDs { + val SERVICE: UUID = UUID.fromString("000002c4-0000-1000-8000-00805f9b34fb") + val WRITE_CHARACTERISTIC: UUID = UUID.fromString("000002c5-0000-1000-8000-00805f9b34fb") + val READ_CHARACTERISTIC: UUID = UUID.fromString("000002c6-0000-1000-8000-00805f9b34fb") + val BROADCAST_CHARACTERISTIC: UUID = UUID.fromString("000002c1-0000-1000-8000-00805f9b34fb") +} + +enum class FrameHead(val value: Int) { + APP_TO_DEVICE(0xC7), + DEVICE_TO_APP(0xB0); + + val byte: Byte get() = value.toByte() +} + +object FrameConstants { + const val MAX_DATA_SIZE = 496 + const val HEADER_SIZE = 8 + const val FOOTER_SIZE = 1 + const val FRAME_INTERVAL_MS = 35L + const val SCREEN_SIZE = 360 +} + +enum class CommandType(val value: Int) { + OTA_PACKAGE(0x02), + TRANSFER_BOOT_ANIMATION(0x03), + TRANSFER_ANI_VIDEO(0x05), + TRANSFER_JPEG_IMAGE(0x06), + GET_DEVICE_VERSION(0x07), + GET_DEVICE_INFO(0x0D), + BIND_DEVICE(0x0F), + UNBIND_DEVICE(0x12), + DELETE_FILE(0x13), + PREPARE_TRANSFER(0x14); + + val byte: Byte get() = value.toByte() + + companion object { + fun fromValue(value: Int): CommandType? = entries.find { it.value == value } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolFrame.kt b/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolFrame.kt new file mode 100644 index 0000000..f89f8eb --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolFrame.kt @@ -0,0 +1,35 @@ +package com.duooomi.ble.protocol + +/** + * BLE protocol frame structure. + * Format: [head:1][type:1][subpageTotal:2][curPage:2][dataLen:2][data:N][checksum:1] + */ +data class ProtocolFrame( + val head: Byte, + val type: Byte, + val subpageTotal: Int, + val curPage: Int, + val dataLen: Int, + val data: ByteArray, + val checksum: Byte +) { + override fun equals(other: Any?): Boolean { + if (this === other) return true + if (other !is ProtocolFrame) return false + return head == other.head && type == other.type && + subpageTotal == other.subpageTotal && curPage == other.curPage && + dataLen == other.dataLen && data.contentEquals(other.data) && + checksum == other.checksum + } + + override fun hashCode(): Int { + var result = head.hashCode() + result = 31 * result + type.hashCode() + result = 31 * result + subpageTotal + result = 31 * result + curPage + result = 31 * result + dataLen + result = 31 * result + data.contentHashCode() + result = 31 * result + checksum.hashCode() + return result + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolManager.kt b/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolManager.kt new file mode 100644 index 0000000..c954f2c --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/protocol/ProtocolManager.kt @@ -0,0 +1,159 @@ +package com.duooomi.ble.protocol + +object ProtocolManager { + + // MARK: - Checksum + + /** + * Checksum = (~sum + 1) & 0xFF (two's complement, low 8 bits) + */ + fun calculateChecksum(data: ByteArray, offset: Int = 0, length: Int = data.size): Byte { + var sum = 0 + for (i in offset until offset + length) { + sum += data[i].toInt() and 0xFF + } + return ((sum.inv() + 1) and 0xFF).toByte() + } + + fun verifyChecksum(data: ByteArray, offset: Int = 0, length: Int, expected: Byte): Boolean { + return calculateChecksum(data, offset, length) == expected + } + + // MARK: - Frame Creation + + /** + * Auto-split data into single or fragmented frames. + * Returns empty list if payload exceeds 65535-page limit. + */ + fun createFrames( + type: Byte, + data: ByteArray, + head: FrameHead = FrameHead.APP_TO_DEVICE, + maxDataSize: Int = FrameConstants.MAX_DATA_SIZE + ): List { + val maxChunk = maxOf(1, maxDataSize) + val totalPages = (data.size + maxChunk - 1) / maxChunk + if (totalPages > 65535) return emptyList() + + return if (data.size <= maxDataSize) { + listOf(createSingleFrame(type, data, head)) + } else { + createFragmentedFrames(type, data, head, maxChunk) + } + } + + private fun createSingleFrame(type: Byte, data: ByteArray, head: FrameHead): ByteArray { + val totalSize = FrameConstants.HEADER_SIZE + data.size + FrameConstants.FOOTER_SIZE + val buffer = ByteArray(totalSize) + var pos = 0 + + // Header + buffer[pos++] = head.byte + buffer[pos++] = type + buffer[pos++] = 0 // subpageTotal high + buffer[pos++] = 0 // subpageTotal low + buffer[pos++] = 0 // curPage high + buffer[pos++] = 0 // curPage low + buffer[pos++] = ((data.size shr 8) and 0xFF).toByte() // dataLen high + buffer[pos++] = (data.size and 0xFF).toByte() // dataLen low + + // Data + data.copyInto(buffer, pos) + pos += data.size + + // Checksum (on everything before checksum) + buffer[pos] = calculateChecksum(buffer, 0, pos) + + return buffer + } + + private fun createFragmentedFrames( + type: Byte, + data: ByteArray, + head: FrameHead, + maxDataSize: Int + ): List { + val totalPages = (data.size + maxDataSize - 1) / maxDataSize + val frames = mutableListOf() + + for (i in 0 until totalPages) { + val start = i * maxDataSize + val end = minOf(start + maxDataSize, data.size) + val chunkSize = end - start + + val frameSize = FrameConstants.HEADER_SIZE + chunkSize + FrameConstants.FOOTER_SIZE + val buffer = ByteArray(frameSize) + var pos = 0 + + buffer[pos++] = head.byte + buffer[pos++] = type + + // subpageTotal (big-endian UInt16) + buffer[pos++] = ((totalPages shr 8) and 0xFF).toByte() + buffer[pos++] = (totalPages and 0xFF).toByte() + + // curPage: from (total-1) counting down to 0 + val curPageVal = totalPages - 1 - i + buffer[pos++] = ((curPageVal shr 8) and 0xFF).toByte() + buffer[pos++] = (curPageVal and 0xFF).toByte() + + // dataLen + buffer[pos++] = ((chunkSize shr 8) and 0xFF).toByte() + buffer[pos++] = (chunkSize and 0xFF).toByte() + + // data + data.copyInto(buffer, pos, start, end) + pos += chunkSize + + // checksum + buffer[pos] = calculateChecksum(buffer, 0, pos) + + frames.add(buffer) + } + + return frames + } + + // MARK: - Frame Parsing + + /** + * Parse raw bytes into a ProtocolFrame. Returns null if invalid. + */ + fun parseFrame(data: ByteArray): ProtocolFrame? { + val minSize = FrameConstants.HEADER_SIZE + FrameConstants.FOOTER_SIZE + if (data.size < minSize) return null + + val head = data[0] + if (head != FrameHead.DEVICE_TO_APP.byte && head != FrameHead.APP_TO_DEVICE.byte) { + return null + } + + val type = data[1] + val subpageTotal = ((data[2].toInt() and 0xFF) shl 8) or (data[3].toInt() and 0xFF) + val curPage = ((data[4].toInt() and 0xFF) shl 8) or (data[5].toInt() and 0xFF) + val dataLen = ((data[6].toInt() and 0xFF) shl 8) or (data[7].toInt() and 0xFF) + + val expectedSize = FrameConstants.HEADER_SIZE + dataLen + FrameConstants.FOOTER_SIZE + if (data.size < expectedSize) return null + + val dataStart = FrameConstants.HEADER_SIZE + val dataEnd = dataStart + dataLen + val frameData = data.copyOfRange(dataStart, dataEnd) + val checksum = data[dataEnd] + + // Verify checksum on everything before checksum byte + if (!verifyChecksum(data, 0, dataEnd, checksum)) { + return null + } + + return ProtocolFrame( + head = head, + type = type, + subpageTotal = subpageTotal, + curPage = curPage, + dataLen = dataLen, + data = frameData, + checksum = checksum + ) + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/services/AniConverter.kt b/sdk/src/main/kotlin/com/duooomi/ble/services/AniConverter.kt new file mode 100644 index 0000000..dfd9f9e --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/services/AniConverter.kt @@ -0,0 +1,79 @@ +package com.duooomi.ble.services + +import com.duooomi.ble.DuooomiBleConfig +import com.duooomi.ble.utils.BleLog +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext +import org.json.JSONObject +import java.net.HttpURLConnection +import java.net.URL + +internal class AniConverter(private val config: DuooomiBleConfig) { + + private val endpoint: String + get() = "${config.apiHost}/api/auth/loomart/file/convert-to-ani" + + suspend fun convert(fileUrl: String): String { + return try { + performConvert(fileUrl) + } catch (e: java.net.SocketException) { + // Retry once on connection lost + BleLog.w("Connection lost, retrying ANI conversion", "ANI") + performConvert(fileUrl) + } + } + + private suspend fun performConvert(fileUrl: String): String = withContext(Dispatchers.IO) { + val connection = URL(endpoint).openConnection() as HttpURLConnection + try { + connection.requestMethod = "POST" + connection.setRequestProperty("content-type", "application/json") + connection.setRequestProperty("x-api-key", config.apiKey) + connection.connectTimeout = 120_000 + connection.readTimeout = 120_000 + connection.doOutput = true + + val body = JSONObject().apply { + put("videoUrl", fileUrl) + put("width", 360) + put("height", 360) + put("fps", "24") + } + + connection.outputStream.use { os -> + os.write(body.toString().toByteArray(Charsets.UTF_8)) + } + + val code = connection.responseCode + if (code !in 200..299) { + throw AniConverterException("HTTP $code") + } + + val responseText = connection.inputStream.bufferedReader().readText() + val json = JSONObject(responseText) + + if (json.optBoolean("success") != true) { + throw AniConverterException("ANI API reported failure") + } + + val outer = json.optJSONObject("data") + ?: throw AniConverterException("ANI API reported failure") + + if (outer.optBoolean("status") != true) { + val msg = outer.optString("msg", "ANI conversion failed") + throw AniConverterException(msg) + } + + val aniUrl = outer.optString("data", "") + if (aniUrl.isEmpty()) { + throw AniConverterException("Missing ani url in response") + } + + aniUrl + } finally { + connection.disconnect() + } + } +} + +internal class AniConverterException(message: String) : Exception(message) diff --git a/sdk/src/main/kotlin/com/duooomi/ble/services/BleProtocolService.kt b/sdk/src/main/kotlin/com/duooomi/ble/services/BleProtocolService.kt new file mode 100644 index 0000000..84aebbe --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/services/BleProtocolService.kt @@ -0,0 +1,127 @@ +package com.duooomi.ble.services + +import com.duooomi.ble.core.BleClient +import com.duooomi.ble.core.DuooomiBleError +import com.duooomi.ble.protocol.* +import com.duooomi.ble.utils.BleLog +import kotlinx.coroutines.* +import kotlinx.coroutines.flow.* +import org.json.JSONObject + +internal class BleProtocolService(private val client: BleClient) { + + private data class FragmentSession( + val total: Int, + val frames: MutableMap = mutableMapOf() + ) + + private val fragments = mutableMapOf() + private var listenerJob: Job? = null + + private val _incomingMessages = MutableSharedFlow>(extraBufferCapacity = 16) + val incomingMessages: SharedFlow> = _incomingMessages + + // MARK: - Start/Stop Listening + + fun startListening(scope: CoroutineScope) { + fragments.clear() + + listenerJob = scope.launch(Dispatchers.Default) { + BleLog.i("Start listening for notifications", "Protocol") + client.notifications.collect { data -> + handleRawData(data) + } + } + } + + fun stopListening() { + listenerJob?.cancel() + listenerJob = null + fragments.clear() + BleLog.i("Stop listening; fragments cleared", "Protocol") + } + + // MARK: - Send + + suspend fun send( + type: Byte, + data: ByteArray, + onProgress: ((Double) -> Unit)? = null + ) { + val maxDataSize = FrameConstants.MAX_DATA_SIZE + val safeMaxDataSize = maxOf(1, maxDataSize) + + val frames = ProtocolManager.createFrames( + type = type, + data = data, + head = FrameHead.APP_TO_DEVICE, + maxDataSize = safeMaxDataSize + ) + + if (frames.isEmpty()) { + BleLog.e("Payload too large; frames empty", "Protocol") + throw DuooomiBleError.TransferFailed("Payload too large: exceeds 65535-page limit") + } + + val total = frames.size + BleLog.d("Sending frames: total=$total, maxChunk=$safeMaxDataSize", "Protocol") + for ((index, frame) in frames.withIndex()) { + client.writeWithoutResponse(frame) + delay(FrameConstants.FRAME_INTERVAL_MS) + onProgress?.invoke((index + 1).toDouble() / total.toDouble()) + } + BleLog.i("Frames sent: total=$total", "Protocol") + } + + suspend fun sendJSON(type: CommandType, payload: JSONObject) { + val jsonBytes = payload.toString().toByteArray(Charsets.UTF_8) + send(type = type.byte, data = jsonBytes) + } + + // MARK: - Receive & Reassemble + + private fun handleRawData(data: ByteArray) { + val frame = ProtocolManager.parseFrame(data) + if (frame == null) { + BleLog.w("Drop invalid frame (len=${data.size})", "Protocol") + return + } + + if (frame.subpageTotal > 0) { + handleFragment(frame) + } else { + BleLog.d("Single frame received: type=${frame.type}, len=${frame.data.size}", "Protocol") + _incomingMessages.tryEmit(Pair(frame.type, frame.data)) + } + } + + private fun handleFragment(frame: ProtocolFrame) { + val deviceKey = client.connectedDeviceId ?: "unknown" + val key = "${deviceKey}_${frame.type}" + + if (fragments[key] == null) { + fragments[key] = FragmentSession(total = frame.subpageTotal) + BleLog.d("New fragment session: key=$key, total=${frame.subpageTotal}", "Protocol") + } + + val session = fragments[key] ?: return + if (frame.curPage >= session.total) return + + session.frames[frame.curPage] = frame.data + + // Check if all pages received + if (session.frames.size != session.total) return + + // Reassemble: from high page to low page + var combined = ByteArray(0) + for (i in session.total - 1 downTo 0) { + session.frames[i]?.let { part -> + combined += part + } + } + + fragments.remove(key) + BleLog.i("Fragment reassembled: key=$key, size=${combined.size}", "Protocol") + _incomingMessages.tryEmit(Pair(frame.type, combined)) + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/services/DeviceInfoService.kt b/sdk/src/main/kotlin/com/duooomi/ble/services/DeviceInfoService.kt new file mode 100644 index 0000000..58f0987 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/services/DeviceInfoService.kt @@ -0,0 +1,58 @@ +package com.duooomi.ble.services + +import com.duooomi.ble.protocol.CommandType +import org.json.JSONObject + +internal class DeviceInfoService(private val protocolService: BleProtocolService) { + + suspend fun getDeviceInfo() { + protocolService.sendJSON( + type = CommandType.GET_DEVICE_INFO, + payload = JSONObject().put("type", CommandType.GET_DEVICE_INFO.value) + ) + } + + suspend fun getDeviceVersion() { + protocolService.sendJSON( + type = CommandType.GET_DEVICE_VERSION, + payload = JSONObject().put("type", CommandType.GET_DEVICE_VERSION.value) + ) + } + + suspend fun bindDevice(userId: String) { + protocolService.sendJSON( + type = CommandType.BIND_DEVICE, + payload = JSONObject() + .put("type", CommandType.BIND_DEVICE.value) + .put("userId", userId) + ) + } + + suspend fun unbindDevice(userId: String) { + protocolService.sendJSON( + type = CommandType.UNBIND_DEVICE, + payload = JSONObject() + .put("type", CommandType.UNBIND_DEVICE.value) + .put("userId", userId) + ) + } + + suspend fun deleteFile(key: String) { + protocolService.sendJSON( + type = CommandType.DELETE_FILE, + payload = JSONObject() + .put("type", CommandType.DELETE_FILE.value) + .put("key", key) + ) + } + + suspend fun prepareTransfer(key: String, size: Int) { + protocolService.sendJSON( + type = CommandType.PREPARE_TRANSFER, + payload = JSONObject() + .put("type", CommandType.PREPARE_TRANSFER.value) + .put("key", key) + .put("size", size) + ) + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/services/FileTransferService.kt b/sdk/src/main/kotlin/com/duooomi/ble/services/FileTransferService.kt new file mode 100644 index 0000000..34198b5 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/services/FileTransferService.kt @@ -0,0 +1,54 @@ +package com.duooomi.ble.services + +import com.duooomi.ble.core.DuooomiBleError +import com.duooomi.ble.protocol.CommandType +import com.duooomi.ble.utils.BleLog +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext +import java.io.File +import java.net.HttpURLConnection +import java.net.URL + +internal class FileTransferService(private val protocolService: BleProtocolService) { + + suspend fun transferFile( + fileUri: String, + commandType: CommandType, + onProgress: ((Double) -> Unit)? = null + ) { + BleLog.i("Load file: $fileUri", "Transfer") + val data = loadFileData(fileUri) + BleLog.d("File loaded: size=${data.size} bytes", "Transfer") + + protocolService.send( + type = commandType.byte, + data = data, + onProgress = onProgress + ) + } + + private suspend fun loadFileData(uri: String): ByteArray = withContext(Dispatchers.IO) { + if (uri.startsWith("file://")) { + val path = uri.removePrefix("file://") + File(path).readBytes() + } else if (uri.startsWith("http://") || uri.startsWith("https://")) { + val connection = URL(uri).openConnection() as HttpURLConnection + try { + connection.requestMethod = "GET" + connection.connectTimeout = 30_000 + connection.readTimeout = 60_000 + connection.connect() + + val code = connection.responseCode + if (code !in 200..299) { + throw DuooomiBleError.TransferFailed("Failed to download file: HTTP $code") + } + connection.inputStream.readBytes() + } finally { + connection.disconnect() + } + } else { + throw DuooomiBleError.TransferFailed("Invalid URL: $uri") + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/services/FirmwareService.kt b/sdk/src/main/kotlin/com/duooomi/ble/services/FirmwareService.kt new file mode 100644 index 0000000..a6c539e --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/services/FirmwareService.kt @@ -0,0 +1,59 @@ +package com.duooomi.ble.services + +import com.duooomi.ble.DuooomiBleConfig +import com.duooomi.ble.core.DuooomiBleError +import com.duooomi.ble.models.FirmwareInfo +import com.duooomi.ble.utils.BleLog +import kotlinx.coroutines.Dispatchers +import kotlinx.coroutines.withContext +import org.json.JSONObject +import java.net.HttpURLConnection +import java.net.URL +import java.net.URLEncoder + +internal class FirmwareService(private val config: DuooomiBleConfig) { + + private val latestPath = "api/auth/loomart/firmware/latest-published" + + suspend fun fetchLatest( + identifier: String? = null, + status: String? = null + ): FirmwareInfo? = withContext(Dispatchers.IO) { + val id = (identifier ?: config.firmwareIdentifier).trim() + val st = status ?: config.firmwareStatus + + if (id.isEmpty()) { + throw DuooomiBleError.TransferFailed("Invalid firmware identifier") + } + + val encodedId = URLEncoder.encode(id, "UTF-8") + val encodedStatus = URLEncoder.encode(st, "UTF-8") + val urlStr = "${config.apiHost}/$latestPath?identifier=$encodedId&status=$encodedStatus" + + val connection = URL(urlStr).openConnection() as HttpURLConnection + try { + connection.requestMethod = "GET" + connection.setRequestProperty("x-api-key", config.apiKey) + connection.setRequestProperty("accept", "application/json") + connection.connectTimeout = 30_000 + connection.readTimeout = 30_000 + + val code = connection.responseCode + if (code !in 200..299) { + throw DuooomiBleError.TransferFailed("HTTP $code") + } + + val responseText = connection.inputStream.bufferedReader().readText() + val json = JSONObject(responseText) + + if (json.optBoolean("success") != true) { + return@withContext null + } + + val dataObj = json.optJSONObject("data") ?: return@withContext null + FirmwareInfo.fromJson(dataObj) + } finally { + connection.disconnect() + } + } +} diff --git a/sdk/src/main/kotlin/com/duooomi/ble/utils/BleLogger.kt b/sdk/src/main/kotlin/com/duooomi/ble/utils/BleLogger.kt new file mode 100644 index 0000000..63ea336 --- /dev/null +++ b/sdk/src/main/kotlin/com/duooomi/ble/utils/BleLogger.kt @@ -0,0 +1,23 @@ +package com.duooomi.ble.utils + +import android.util.Log + +internal object BleLog { + private const val TAG = "DuooomiBleSDK" + + fun d(message: String, category: String = "General") { + Log.d(TAG, "[$category] $message") + } + + fun i(message: String, category: String = "General") { + Log.i(TAG, "[$category] $message") + } + + fun w(message: String, category: String = "General") { + Log.w(TAG, "[$category] $message") + } + + fun e(message: String, category: String = "General") { + Log.e(TAG, "[$category] $message") + } +} diff --git a/settings.gradle.kts b/settings.gradle.kts new file mode 100644 index 0000000..4ce3755 --- /dev/null +++ b/settings.gradle.kts @@ -0,0 +1,19 @@ +pluginManagement { + repositories { + google() + mavenCentral() + gradlePluginPortal() + } +} + +dependencyResolutionManagement { + repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) + repositories { + google() + mavenCentral() + } +} + +rootProject.name = "duooomi-android-sdk" +include(":sdk") +include(":demo")