├── .gitignore ├── .idea ├── .gitignore ├── compiler.xml ├── gradle.xml ├── inspectionProfiles │ └── Project_Default.xml ├── kotlinc.xml ├── misc.xml └── vcs.xml ├── app ├── .gitignore ├── build.gradle.kts ├── proguard-rules.pro └── src │ ├── androidTest │ └── java │ │ └── com │ │ └── tdcolvin │ │ └── bleclient │ │ └── ExampleInstrumentedTest.kt │ ├── main │ ├── AndroidManifest.xml │ ├── java │ │ └── com │ │ │ └── tdcolvin │ │ │ └── bleclient │ │ │ ├── MainActivity.kt │ │ │ ├── ble │ │ │ ├── BLEDeviceConnection.kt │ │ │ └── BLEScanner.kt │ │ │ └── ui │ │ │ ├── navigation │ │ │ └── MainNavigation.kt │ │ │ ├── screens │ │ │ ├── DeviceScreen.kt │ │ │ ├── PermissionsRequiredScreen.kt │ │ │ └── ScanningScreen.kt │ │ │ ├── theme │ │ │ ├── Color.kt │ │ │ ├── Theme.kt │ │ │ └── Type.kt │ │ │ └── viewmodel │ │ │ └── BLEClientViewModel.kt │ └── res │ │ ├── drawable │ │ ├── ic_launcher_background.xml │ │ └── ic_launcher_foreground.xml │ │ ├── mipmap-anydpi │ │ ├── ic_launcher.xml │ │ └── ic_launcher_round.xml │ │ ├── mipmap-hdpi │ │ ├── ic_launcher.webp │ │ └── ic_launcher_round.webp │ │ ├── mipmap-mdpi │ │ ├── ic_launcher.webp │ │ └── ic_launcher_round.webp │ │ ├── mipmap-xhdpi │ │ ├── ic_launcher.webp │ │ └── ic_launcher_round.webp │ │ ├── mipmap-xxhdpi │ │ ├── ic_launcher.webp │ │ └── ic_launcher_round.webp │ │ ├── mipmap-xxxhdpi │ │ ├── ic_launcher.webp │ │ └── ic_launcher_round.webp │ │ ├── values │ │ ├── colors.xml │ │ ├── strings.xml │ │ └── themes.xml │ │ └── xml │ │ ├── backup_rules.xml │ │ └── data_extraction_rules.xml │ └── test │ └── java │ └── com │ └── tdcolvin │ └── bleclient │ └── ExampleUnitTest.kt ├── build.gradle.kts ├── gradle.properties ├── gradle └── wrapper │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat └── settings.gradle.kts /.gitignore: -------------------------------------------------------------------------------- 1 | *.iml 2 | .gradle 3 | /local.properties 4 | /.idea/caches 5 | /.idea/libraries 6 | /.idea/modules.xml 7 | /.idea/workspace.xml 8 | /.idea/navEditor.xml 9 | /.idea/assetWizardSettings.xml 10 | .DS_Store 11 | /build 12 | /captures 13 | .externalNativeBuild 14 | .cxx 15 | local.properties 16 | -------------------------------------------------------------------------------- /.idea/.gitignore: -------------------------------------------------------------------------------- 1 | # Default ignored files 2 | /shelf/ 3 | /workspace.xml 4 | -------------------------------------------------------------------------------- /.idea/compiler.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /.idea/gradle.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 19 | 20 | -------------------------------------------------------------------------------- /.idea/inspectionProfiles/Project_Default.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 41 | -------------------------------------------------------------------------------- /.idea/kotlinc.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 6 | -------------------------------------------------------------------------------- /.idea/misc.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 9 | -------------------------------------------------------------------------------- /.idea/vcs.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /app/.gitignore: -------------------------------------------------------------------------------- 1 | /build -------------------------------------------------------------------------------- /app/build.gradle.kts: -------------------------------------------------------------------------------- 1 | plugins { 2 | id("com.android.application") 3 | id("org.jetbrains.kotlin.android") 4 | } 5 | 6 | android { 7 | namespace = "com.tdcolvin.bleclient" 8 | compileSdk = 34 9 | 10 | defaultConfig { 11 | applicationId = "com.tdcolvin.bleclient" 12 | minSdk = 28 13 | targetSdk = 34 14 | versionCode = 1 15 | versionName = "1.0" 16 | 17 | testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner" 18 | vectorDrawables { 19 | useSupportLibrary = true 20 | } 21 | } 22 | 23 | buildTypes { 24 | release { 25 | isMinifyEnabled = false 26 | proguardFiles( 27 | getDefaultProguardFile("proguard-android-optimize.txt"), 28 | "proguard-rules.pro" 29 | ) 30 | } 31 | } 32 | compileOptions { 33 | sourceCompatibility = JavaVersion.VERSION_1_8 34 | targetCompatibility = JavaVersion.VERSION_1_8 35 | } 36 | kotlinOptions { 37 | jvmTarget = "1.8" 38 | } 39 | buildFeatures { 40 | compose = true 41 | } 42 | composeOptions { 43 | kotlinCompilerExtensionVersion = "1.4.3" 44 | } 45 | packaging { 46 | resources { 47 | excludes += "/META-INF/{AL2.0,LGPL2.1}" 48 | } 49 | } 50 | } 51 | 52 | dependencies { 53 | 54 | implementation("androidx.core:core-ktx:1.9.0") 55 | implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2") 56 | implementation("androidx.activity:activity-compose:1.8.0") 57 | implementation(platform("androidx.compose:compose-bom:2023.03.00")) 58 | implementation("androidx.compose.ui:ui") 59 | implementation("androidx.compose.ui:ui-graphics") 60 | implementation("androidx.compose.ui:ui-tooling-preview") 61 | implementation("androidx.compose.material3:material3") 62 | implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.6.2") 63 | implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4") 64 | implementation("androidx.lifecycle:lifecycle-runtime-compose:2.6.2") 65 | testImplementation("junit:junit:4.13.2") 66 | androidTestImplementation("androidx.test.ext:junit:1.1.5") 67 | androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1") 68 | androidTestImplementation(platform("androidx.compose:compose-bom:2023.03.00")) 69 | androidTestImplementation("androidx.compose.ui:ui-test-junit4") 70 | debugImplementation("androidx.compose.ui:ui-tooling") 71 | debugImplementation("androidx.compose.ui:ui-test-manifest") 72 | } -------------------------------------------------------------------------------- /app/proguard-rules.pro: -------------------------------------------------------------------------------- 1 | # Add project specific ProGuard rules here. 2 | # You can control the set of applied configuration files using the 3 | # proguardFiles setting in build.gradle. 4 | # 5 | # For more details, see 6 | # http://developer.android.com/guide/developing/tools/proguard.html 7 | 8 | # If your project uses WebView with JS, uncomment the following 9 | # and specify the fully qualified class name to the JavaScript interface 10 | # class: 11 | #-keepclassmembers class fqcn.of.javascript.interface.for.webview { 12 | # public *; 13 | #} 14 | 15 | # Uncomment this to preserve the line number information for 16 | # debugging stack traces. 17 | #-keepattributes SourceFile,LineNumberTable 18 | 19 | # If you keep the line number information, uncomment this to 20 | # hide the original source file name. 21 | #-renamesourcefileattribute SourceFile -------------------------------------------------------------------------------- /app/src/androidTest/java/com/tdcolvin/bleclient/ExampleInstrumentedTest.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient 2 | 3 | import androidx.test.platform.app.InstrumentationRegistry 4 | import androidx.test.ext.junit.runners.AndroidJUnit4 5 | 6 | import org.junit.Test 7 | import org.junit.runner.RunWith 8 | 9 | import org.junit.Assert.* 10 | 11 | /** 12 | * Instrumented test, which will execute on an Android device. 13 | * 14 | * See [testing documentation](http://d.android.com/tools/testing). 15 | */ 16 | @RunWith(AndroidJUnit4::class) 17 | class ExampleInstrumentedTest { 18 | @Test 19 | fun useAppContext() { 20 | // Context of the app under test. 21 | val appContext = InstrumentationRegistry.getInstrumentation().targetContext 22 | assertEquals("com.tdcolvin.bleclient", appContext.packageName) 23 | } 24 | } -------------------------------------------------------------------------------- /app/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 2 | 4 | 5 | 7 | 9 | 11 | 13 | 14 | 15 | 18 | 19 | 29 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/MainActivity.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient 2 | 3 | import android.os.Bundle 4 | import androidx.activity.ComponentActivity 5 | import androidx.activity.compose.setContent 6 | import androidx.compose.foundation.layout.fillMaxSize 7 | import androidx.compose.material3.MaterialTheme 8 | import androidx.compose.material3.Surface 9 | import androidx.compose.ui.Modifier 10 | import com.tdcolvin.bleclient.ui.navigation.MainNavigation 11 | import com.tdcolvin.bleclient.ui.theme.BLEClientTheme 12 | 13 | class MainActivity : ComponentActivity() { 14 | override fun onCreate(savedInstanceState: Bundle?) { 15 | super.onCreate(savedInstanceState) 16 | setContent { 17 | BLEClientTheme { 18 | // A surface container using the 'background' color from the theme 19 | Surface( 20 | modifier = Modifier.fillMaxSize(), 21 | color = MaterialTheme.colorScheme.background 22 | ) { 23 | MainNavigation() 24 | } 25 | } 26 | } 27 | } 28 | } -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ble/BLEDeviceConnection.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ble 2 | 3 | import android.bluetooth.BluetoothDevice 4 | import android.bluetooth.BluetoothGatt 5 | import android.bluetooth.BluetoothGattCallback 6 | import android.bluetooth.BluetoothGattCharacteristic 7 | import android.bluetooth.BluetoothGattService 8 | import android.content.Context 9 | import android.util.Log 10 | import androidx.annotation.RequiresPermission 11 | import kotlinx.coroutines.flow.MutableStateFlow 12 | import kotlinx.coroutines.flow.update 13 | import java.util.UUID 14 | 15 | val CTF_SERVICE_UUID: UUID = UUID.fromString("8c380000-10bd-4fdb-ba21-1922d6cf860d") 16 | val PASSWORD_CHARACTERISTIC_UUID: UUID = UUID.fromString("8c380001-10bd-4fdb-ba21-1922d6cf860d") 17 | val NAME_CHARACTERISTIC_UUID: UUID = UUID.fromString("8c380002-10bd-4fdb-ba21-1922d6cf860d") 18 | 19 | @Suppress("DEPRECATION") 20 | class BLEDeviceConnection @RequiresPermission("PERMISSION_BLUETOOTH_CONNECT") constructor( 21 | private val context: Context, 22 | private val bluetoothDevice: BluetoothDevice 23 | ) { 24 | val isConnected = MutableStateFlow(false) 25 | val passwordRead = MutableStateFlow(null) 26 | val successfulNameWrites = MutableStateFlow(0) 27 | val services = MutableStateFlow>(emptyList()) 28 | 29 | private val callback = object: BluetoothGattCallback() { 30 | override fun onConnectionStateChange(gatt: BluetoothGatt, status: Int, newState: Int) { 31 | super.onConnectionStateChange(gatt, status, newState) 32 | val connected = newState == BluetoothGatt.STATE_CONNECTED 33 | if (connected) { 34 | //read the list of services 35 | services.value = gatt.services 36 | } 37 | isConnected.value = connected 38 | } 39 | 40 | override fun onServicesDiscovered(gatt: BluetoothGatt, status: Int) { 41 | super.onServicesDiscovered(gatt, status) 42 | services.value = gatt.services 43 | } 44 | 45 | @Deprecated("Deprecated in Java") 46 | override fun onCharacteristicRead( 47 | gatt: BluetoothGatt, 48 | characteristic: BluetoothGattCharacteristic, 49 | status: Int 50 | ) { 51 | super.onCharacteristicRead(gatt, characteristic, status) 52 | if (characteristic.uuid == PASSWORD_CHARACTERISTIC_UUID) { 53 | passwordRead.value = String(characteristic.value) 54 | } 55 | } 56 | 57 | override fun onCharacteristicWrite( 58 | gatt: BluetoothGatt, 59 | characteristic: BluetoothGattCharacteristic, 60 | status: Int 61 | ) { 62 | super.onCharacteristicWrite(gatt, characteristic, status) 63 | if (characteristic.uuid == NAME_CHARACTERISTIC_UUID) { 64 | successfulNameWrites.update { it + 1 } 65 | } 66 | } 67 | } 68 | 69 | private var gatt: BluetoothGatt? = null 70 | 71 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 72 | fun disconnect() { 73 | gatt?.disconnect() 74 | gatt?.close() 75 | gatt = null 76 | } 77 | 78 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 79 | fun connect() { 80 | gatt = bluetoothDevice.connectGatt(context, false, callback) 81 | } 82 | 83 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 84 | fun discoverServices() { 85 | gatt?.discoverServices() 86 | } 87 | 88 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 89 | fun readPassword() { 90 | val service = gatt?.getService(CTF_SERVICE_UUID) 91 | val characteristic = service?.getCharacteristic(PASSWORD_CHARACTERISTIC_UUID) 92 | if (characteristic != null) { 93 | val success = gatt?.readCharacteristic(characteristic) 94 | Log.v("bluetooth", "Read status: $success") 95 | } 96 | } 97 | 98 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 99 | fun writeName() { 100 | val service = gatt?.getService(CTF_SERVICE_UUID) 101 | val characteristic = service?.getCharacteristic(NAME_CHARACTERISTIC_UUID) 102 | if (characteristic != null) { 103 | characteristic.value = "Tom".toByteArray() 104 | val success = gatt?.writeCharacteristic(characteristic) 105 | Log.v("bluetooth", "Write status: $success") 106 | } 107 | } 108 | } -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ble/BLEScanner.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ble 2 | 3 | import android.bluetooth.BluetoothDevice 4 | import android.bluetooth.BluetoothManager 5 | import android.bluetooth.le.BluetoothLeScanner 6 | import android.bluetooth.le.ScanCallback 7 | import android.bluetooth.le.ScanResult 8 | import android.content.Context 9 | import androidx.annotation.RequiresPermission 10 | import kotlinx.coroutines.flow.MutableStateFlow 11 | import kotlinx.coroutines.flow.update 12 | 13 | //These fields are marked as API >= 31 in the Manifest class, so we can't use those without warning. 14 | //So we create our own, which prevents over-suppression of the Linter 15 | const val PERMISSION_BLUETOOTH_SCAN = "android.permission.BLUETOOTH_SCAN" 16 | const val PERMISSION_BLUETOOTH_CONNECT = "android.permission.BLUETOOTH_CONNECT" 17 | 18 | class BLEScanner(context: Context) { 19 | 20 | private val bluetooth = context.getSystemService(Context.BLUETOOTH_SERVICE) 21 | as? BluetoothManager 22 | ?: throw Exception("Bluetooth is not supported by this device") 23 | 24 | val isScanning = MutableStateFlow(false) 25 | 26 | val foundDevices = MutableStateFlow>(emptyList()) 27 | 28 | private val scanner: BluetoothLeScanner 29 | get() = bluetooth.adapter.bluetoothLeScanner 30 | 31 | private val scanCallback = object : ScanCallback() { 32 | override fun onScanResult(callbackType: Int, result: ScanResult?) { 33 | super.onScanResult(callbackType, result) 34 | result ?: return 35 | 36 | if (!foundDevices.value.contains(result.device)) { 37 | foundDevices.update { it + result.device } 38 | } 39 | } 40 | 41 | override fun onBatchScanResults(results: MutableList?) { 42 | super.onBatchScanResults(results) 43 | } 44 | 45 | override fun onScanFailed(errorCode: Int) { 46 | super.onScanFailed(errorCode) 47 | isScanning.value = false 48 | } 49 | } 50 | 51 | @RequiresPermission(PERMISSION_BLUETOOTH_SCAN) 52 | fun startScanning() { 53 | scanner.startScan(scanCallback) 54 | isScanning.value = true 55 | } 56 | 57 | @RequiresPermission(PERMISSION_BLUETOOTH_SCAN) 58 | fun stopScanning() { 59 | scanner.stopScan(scanCallback) 60 | isScanning.value = false 61 | } 62 | 63 | 64 | } -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/navigation/MainNavigation.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.navigation 2 | 3 | import android.annotation.SuppressLint 4 | import androidx.compose.runtime.Composable 5 | import androidx.compose.runtime.getValue 6 | import androidx.compose.runtime.mutableStateOf 7 | import androidx.compose.runtime.remember 8 | import androidx.compose.runtime.setValue 9 | import androidx.compose.ui.platform.LocalContext 10 | import androidx.lifecycle.compose.collectAsStateWithLifecycle 11 | import androidx.lifecycle.viewmodel.compose.viewModel 12 | import com.tdcolvin.bleclient.ui.screens.DeviceScreen 13 | import com.tdcolvin.bleclient.ui.screens.PermissionsRequiredScreen 14 | import com.tdcolvin.bleclient.ui.screens.ScanningScreen 15 | import com.tdcolvin.bleclient.ui.screens.haveAllPermissions 16 | import com.tdcolvin.bleclient.ui.viewmodel.BLEClientViewModel 17 | 18 | @SuppressLint("MissingPermission") 19 | @Composable 20 | fun MainNavigation(viewModel: BLEClientViewModel = viewModel()) { 21 | val uiState by viewModel.uiState.collectAsStateWithLifecycle() 22 | 23 | val context = LocalContext.current 24 | var allPermissionsGranted by remember { 25 | mutableStateOf (haveAllPermissions(context)) 26 | } 27 | 28 | if (!allPermissionsGranted) { 29 | PermissionsRequiredScreen { allPermissionsGranted = true } 30 | } 31 | else if (uiState.activeDevice == null) { 32 | ScanningScreen( 33 | isScanning = uiState.isScanning, 34 | foundDevices = uiState.foundDevices, 35 | startScanning = viewModel::startScanning, 36 | stopScanning = viewModel::stopScanning, 37 | selectDevice = { device -> 38 | viewModel.stopScanning() 39 | viewModel.setActiveDevice(device) 40 | } 41 | ) 42 | } 43 | else { 44 | DeviceScreen( 45 | unselectDevice = { 46 | viewModel.disconnectActiveDevice() 47 | viewModel.setActiveDevice(null) 48 | }, 49 | isDeviceConnected = uiState.isDeviceConnected, 50 | discoveredCharacteristics = uiState.discoveredCharacteristics, 51 | password = uiState.password, 52 | nameWrittenTimes = uiState.nameWrittenTimes, 53 | connect = viewModel::connectActiveDevice, 54 | discoverServices = viewModel::discoverActiveDeviceServices, 55 | readPassword = viewModel::readPasswordFromActiveDevice, 56 | writeName = viewModel::writeNameToActiveDevice 57 | ) 58 | } 59 | } -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/screens/DeviceScreen.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.screens 2 | 3 | import androidx.compose.foundation.gestures.Orientation 4 | import androidx.compose.foundation.gestures.scrollable 5 | import androidx.compose.foundation.layout.Column 6 | import androidx.compose.foundation.layout.padding 7 | import androidx.compose.foundation.lazy.LazyColumn 8 | import androidx.compose.foundation.lazy.items 9 | import androidx.compose.foundation.rememberScrollState 10 | import androidx.compose.material3.Button 11 | import androidx.compose.material3.OutlinedButton 12 | import androidx.compose.material3.Text 13 | import androidx.compose.runtime.Composable 14 | import androidx.compose.ui.Modifier 15 | import androidx.compose.ui.text.font.FontWeight 16 | import androidx.compose.ui.unit.dp 17 | import com.tdcolvin.bleclient.ble.CTF_SERVICE_UUID 18 | 19 | @Composable 20 | fun DeviceScreen( 21 | unselectDevice: () -> Unit, 22 | isDeviceConnected: Boolean, 23 | discoveredCharacteristics: Map>, 24 | password: String?, 25 | nameWrittenTimes: Int, 26 | connect: () -> Unit, 27 | discoverServices: () -> Unit, 28 | readPassword: () -> Unit, 29 | writeName: () -> Unit 30 | ) { 31 | val foundTargetService = discoveredCharacteristics.contains(CTF_SERVICE_UUID.toString()) 32 | 33 | Column( 34 | Modifier.scrollable(rememberScrollState(), Orientation.Vertical) 35 | ) { 36 | Button(onClick = connect) { 37 | Text("1. Connect") 38 | } 39 | Text("Device connected: $isDeviceConnected") 40 | Button(onClick = discoverServices, enabled = isDeviceConnected) { 41 | Text("2. Discover Services") 42 | } 43 | LazyColumn { 44 | items(discoveredCharacteristics.keys.sorted()) { serviceUuid -> 45 | Text(text = serviceUuid, fontWeight = FontWeight.Black) 46 | Column(modifier = Modifier.padding(start = 10.dp)) { 47 | discoveredCharacteristics[serviceUuid]?.forEach { 48 | Text(it) 49 | } 50 | } 51 | } 52 | } 53 | Button(onClick = readPassword, enabled = isDeviceConnected && foundTargetService) { 54 | Text("3. Read Password") 55 | } 56 | if (password != null) { 57 | Text("Found password: $password") 58 | } 59 | Button(onClick = writeName, enabled = isDeviceConnected && foundTargetService) { 60 | Text("4. Write Your Name") 61 | } 62 | if (nameWrittenTimes > 0) { 63 | Text("Successful writes: $nameWrittenTimes") 64 | } 65 | 66 | OutlinedButton(modifier = Modifier.padding(top = 40.dp), onClick = unselectDevice) { 67 | Text("Disconnect") 68 | } 69 | } 70 | } 71 | -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/screens/PermissionsRequiredScreen.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.screens 2 | 3 | import android.Manifest 4 | import android.content.Context 5 | import android.content.pm.PackageManager 6 | import android.os.Build 7 | import androidx.activity.compose.rememberLauncherForActivityResult 8 | import androidx.activity.result.contract.ActivityResultContracts 9 | import androidx.compose.foundation.layout.Box 10 | import androidx.compose.foundation.layout.Column 11 | import androidx.compose.material3.Button 12 | import androidx.compose.material3.Text 13 | import androidx.compose.runtime.Composable 14 | import androidx.compose.ui.Alignment 15 | import androidx.compose.ui.Modifier 16 | 17 | val ALL_BLE_PERMISSIONS = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) { 18 | arrayOf( 19 | Manifest.permission.BLUETOOTH_CONNECT, 20 | Manifest.permission.BLUETOOTH_SCAN 21 | ) 22 | } 23 | else { 24 | arrayOf( 25 | Manifest.permission.BLUETOOTH_ADMIN, 26 | Manifest.permission.BLUETOOTH, 27 | Manifest.permission.ACCESS_FINE_LOCATION 28 | ) 29 | } 30 | fun haveAllPermissions(context: Context) = 31 | ALL_BLE_PERMISSIONS 32 | .all { context.checkSelfPermission(it) == PackageManager.PERMISSION_GRANTED } 33 | 34 | @Composable 35 | fun PermissionsRequiredScreen(onPermissionGranted: () -> Unit) { 36 | Box { 37 | Column( 38 | modifier = Modifier.align(Alignment.Center) 39 | ) { 40 | val launcher = rememberLauncherForActivityResult( 41 | contract = ActivityResultContracts.RequestMultiplePermissions() 42 | ) { granted -> 43 | if (granted.values.all { it }) { 44 | onPermissionGranted() 45 | } 46 | } 47 | Button(onClick = { launcher.launch(ALL_BLE_PERMISSIONS) }) { 48 | Text("Grant Permission") 49 | } 50 | } 51 | } 52 | } -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/screens/ScanningScreen.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.screens 2 | 3 | import android.bluetooth.BluetoothDevice 4 | import androidx.annotation.RequiresPermission 5 | import androidx.compose.foundation.layout.Arrangement 6 | import androidx.compose.foundation.layout.Column 7 | import androidx.compose.foundation.layout.fillMaxWidth 8 | import androidx.compose.foundation.layout.padding 9 | import androidx.compose.foundation.lazy.LazyColumn 10 | import androidx.compose.foundation.lazy.items 11 | import androidx.compose.material3.Button 12 | import androidx.compose.material3.Card 13 | import androidx.compose.material3.CardDefaults 14 | import androidx.compose.material3.MaterialTheme 15 | import androidx.compose.material3.Text 16 | import androidx.compose.runtime.Composable 17 | import androidx.compose.ui.Modifier 18 | import androidx.compose.ui.text.style.TextAlign 19 | import androidx.compose.ui.tooling.preview.Preview 20 | import androidx.compose.ui.unit.dp 21 | import com.tdcolvin.bleclient.ble.PERMISSION_BLUETOOTH_CONNECT 22 | import com.tdcolvin.bleclient.ble.PERMISSION_BLUETOOTH_SCAN 23 | 24 | @Composable 25 | @RequiresPermission(allOf = [PERMISSION_BLUETOOTH_SCAN, PERMISSION_BLUETOOTH_CONNECT]) 26 | fun ScanningScreen( 27 | isScanning: Boolean, 28 | foundDevices: List, 29 | startScanning: () -> Unit, 30 | stopScanning: () -> Unit, 31 | selectDevice: (BluetoothDevice) -> Unit 32 | ) { 33 | Column ( 34 | Modifier.padding(horizontal = 10.dp) 35 | ){ 36 | if (isScanning) { 37 | Text("Scanning...") 38 | 39 | Button(onClick = stopScanning) { 40 | Text("Stop Scanning") 41 | } 42 | } 43 | else { 44 | Button(onClick = startScanning) { 45 | Text("Start Scanning") 46 | } 47 | } 48 | 49 | LazyColumn( 50 | verticalArrangement = Arrangement.spacedBy(10.dp) 51 | ) { 52 | items(foundDevices) { device -> 53 | DeviceItem( 54 | deviceName = device.name, 55 | selectDevice = { selectDevice(device) } 56 | ) 57 | } 58 | } 59 | } 60 | } 61 | 62 | @Composable 63 | fun DeviceItem(deviceName: String?, selectDevice: () -> Unit) { 64 | Card( 65 | modifier = Modifier 66 | .fillMaxWidth(), 67 | colors = CardDefaults.cardColors( 68 | containerColor = MaterialTheme.colorScheme.surfaceVariant, 69 | ) 70 | ) { 71 | Column(modifier = Modifier.padding(10.dp)) { 72 | Text( 73 | text = deviceName ?: "[Unnamed]", 74 | textAlign = TextAlign.Center, 75 | ) 76 | Button(onClick = selectDevice) { 77 | Text("Connect") 78 | } 79 | } 80 | } 81 | } 82 | 83 | @Preview 84 | @Composable 85 | fun PreviewDeviceItem() { 86 | DeviceItem(deviceName = "A test BLE device", selectDevice = { }) 87 | } -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/theme/Color.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.theme 2 | 3 | import androidx.compose.ui.graphics.Color 4 | 5 | val Purple80 = Color(0xFFD0BCFF) 6 | val PurpleGrey80 = Color(0xFFCCC2DC) 7 | val Pink80 = Color(0xFFEFB8C8) 8 | 9 | val Purple40 = Color(0xFF6650a4) 10 | val PurpleGrey40 = Color(0xFF625b71) 11 | val Pink40 = Color(0xFF7D5260) -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/theme/Theme.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.theme 2 | 3 | import android.app.Activity 4 | import android.os.Build 5 | import androidx.compose.foundation.isSystemInDarkTheme 6 | import androidx.compose.material3.MaterialTheme 7 | import androidx.compose.material3.darkColorScheme 8 | import androidx.compose.material3.dynamicDarkColorScheme 9 | import androidx.compose.material3.dynamicLightColorScheme 10 | import androidx.compose.material3.lightColorScheme 11 | import androidx.compose.runtime.Composable 12 | import androidx.compose.runtime.SideEffect 13 | import androidx.compose.ui.graphics.toArgb 14 | import androidx.compose.ui.platform.LocalContext 15 | import androidx.compose.ui.platform.LocalView 16 | import androidx.core.view.WindowCompat 17 | 18 | private val DarkColorScheme = darkColorScheme( 19 | primary = Purple80, 20 | secondary = PurpleGrey80, 21 | tertiary = Pink80 22 | ) 23 | 24 | private val LightColorScheme = lightColorScheme( 25 | primary = Purple40, 26 | secondary = PurpleGrey40, 27 | tertiary = Pink40 28 | 29 | /* Other default colors to override 30 | background = Color(0xFFFFFBFE), 31 | surface = Color(0xFFFFFBFE), 32 | onPrimary = Color.White, 33 | onSecondary = Color.White, 34 | onTertiary = Color.White, 35 | onBackground = Color(0xFF1C1B1F), 36 | onSurface = Color(0xFF1C1B1F), 37 | */ 38 | ) 39 | 40 | @Composable 41 | fun BLEClientTheme( 42 | darkTheme: Boolean = isSystemInDarkTheme(), 43 | // Dynamic color is available on Android 12+ 44 | dynamicColor: Boolean = true, 45 | content: @Composable () -> Unit 46 | ) { 47 | val colorScheme = when { 48 | dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> { 49 | val context = LocalContext.current 50 | if (darkTheme) dynamicDarkColorScheme(context) else dynamicLightColorScheme(context) 51 | } 52 | 53 | darkTheme -> DarkColorScheme 54 | else -> LightColorScheme 55 | } 56 | val view = LocalView.current 57 | if (!view.isInEditMode) { 58 | SideEffect { 59 | val window = (view.context as Activity).window 60 | window.statusBarColor = colorScheme.primary.toArgb() 61 | WindowCompat.getInsetsController(window, view).isAppearanceLightStatusBars = darkTheme 62 | } 63 | } 64 | 65 | MaterialTheme( 66 | colorScheme = colorScheme, 67 | typography = Typography, 68 | content = content 69 | ) 70 | } -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/theme/Type.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.theme 2 | 3 | import androidx.compose.material3.Typography 4 | import androidx.compose.ui.text.TextStyle 5 | import androidx.compose.ui.text.font.FontFamily 6 | import androidx.compose.ui.text.font.FontWeight 7 | import androidx.compose.ui.unit.sp 8 | 9 | // Set of Material typography styles to start with 10 | val Typography = Typography( 11 | bodyLarge = TextStyle( 12 | fontFamily = FontFamily.Default, 13 | fontWeight = FontWeight.Normal, 14 | fontSize = 16.sp, 15 | lineHeight = 24.sp, 16 | letterSpacing = 0.5.sp 17 | ) 18 | /* Other default text styles to override 19 | titleLarge = TextStyle( 20 | fontFamily = FontFamily.Default, 21 | fontWeight = FontWeight.Normal, 22 | fontSize = 22.sp, 23 | lineHeight = 28.sp, 24 | letterSpacing = 0.sp 25 | ), 26 | labelSmall = TextStyle( 27 | fontFamily = FontFamily.Default, 28 | fontWeight = FontWeight.Medium, 29 | fontSize = 11.sp, 30 | lineHeight = 16.sp, 31 | letterSpacing = 0.5.sp 32 | ) 33 | */ 34 | ) -------------------------------------------------------------------------------- /app/src/main/java/com/tdcolvin/bleclient/ui/viewmodel/BLEClientViewModel.kt: -------------------------------------------------------------------------------- 1 | package com.tdcolvin.bleclient.ui.viewmodel 2 | 3 | import android.Manifest 4 | import android.annotation.SuppressLint 5 | import android.app.Application 6 | import android.bluetooth.BluetoothDevice 7 | import android.content.pm.PackageManager 8 | import androidx.annotation.RequiresPermission 9 | import androidx.core.app.ActivityCompat 10 | import androidx.lifecycle.AndroidViewModel 11 | import androidx.lifecycle.viewModelScope 12 | import com.tdcolvin.bleclient.ble.BLEScanner 13 | import com.tdcolvin.bleclient.ble.BLEDeviceConnection 14 | import com.tdcolvin.bleclient.ble.PERMISSION_BLUETOOTH_CONNECT 15 | import com.tdcolvin.bleclient.ble.PERMISSION_BLUETOOTH_SCAN 16 | import kotlinx.coroutines.ExperimentalCoroutinesApi 17 | import kotlinx.coroutines.flow.MutableStateFlow 18 | import kotlinx.coroutines.flow.SharingStarted 19 | import kotlinx.coroutines.flow.combine 20 | import kotlinx.coroutines.flow.flatMapLatest 21 | import kotlinx.coroutines.flow.flowOf 22 | import kotlinx.coroutines.flow.stateIn 23 | import kotlinx.coroutines.flow.update 24 | import kotlinx.coroutines.launch 25 | 26 | @OptIn(ExperimentalCoroutinesApi::class) 27 | class BLEClientViewModel(private val application: Application): AndroidViewModel(application) { 28 | private val bleScanner = BLEScanner(application) 29 | private var activeConnection = MutableStateFlow(null) 30 | 31 | private val isDeviceConnected = activeConnection.flatMapLatest { it?.isConnected ?: flowOf(false) } 32 | private val activeDeviceServices = activeConnection.flatMapLatest { 33 | it?.services ?: flowOf(emptyList()) 34 | } 35 | private val activeDevicePassword = activeConnection.flatMapLatest { 36 | it?.passwordRead ?: flowOf(null) 37 | } 38 | private val activeDeviceNameWrittenTimes = activeConnection.flatMapLatest { 39 | it?.successfulNameWrites ?: flowOf(0) 40 | } 41 | 42 | private val _uiState = MutableStateFlow(BLEClientUIState()) 43 | val uiState = combine( 44 | _uiState, 45 | isDeviceConnected, 46 | activeDeviceServices, 47 | activeDevicePassword, 48 | activeDeviceNameWrittenTimes 49 | ) { state, isDeviceConnected, services, password, nameWrittenTimes -> 50 | state.copy( 51 | isDeviceConnected = isDeviceConnected, 52 | discoveredCharacteristics = services.associate { service -> Pair(service.uuid.toString(), service.characteristics.map { it.uuid.toString() }) }, 53 | password = password, 54 | nameWrittenTimes = nameWrittenTimes 55 | ) 56 | }.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), BLEClientUIState()) 57 | 58 | init { 59 | viewModelScope.launch { 60 | bleScanner.foundDevices.collect { devices -> 61 | _uiState.update { it.copy(foundDevices = devices) } 62 | } 63 | } 64 | viewModelScope.launch { 65 | bleScanner.isScanning.collect { isScanning -> 66 | _uiState.update { it.copy(isScanning = isScanning) } 67 | } 68 | } 69 | } 70 | 71 | @RequiresPermission(PERMISSION_BLUETOOTH_SCAN) 72 | fun startScanning() { 73 | bleScanner.startScanning() 74 | } 75 | 76 | @RequiresPermission(PERMISSION_BLUETOOTH_SCAN) 77 | fun stopScanning() { 78 | bleScanner.stopScanning() 79 | } 80 | 81 | @SuppressLint("MissingPermission") 82 | @RequiresPermission(allOf = [PERMISSION_BLUETOOTH_CONNECT, PERMISSION_BLUETOOTH_SCAN]) 83 | fun setActiveDevice(device: BluetoothDevice?) { 84 | activeConnection.value = device?.run { BLEDeviceConnection(application, device) } 85 | _uiState.update { it.copy(activeDevice = device) } 86 | } 87 | 88 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 89 | fun connectActiveDevice() { 90 | activeConnection.value?.connect() 91 | } 92 | 93 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 94 | fun disconnectActiveDevice() { 95 | activeConnection.value?.disconnect() 96 | } 97 | 98 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 99 | fun discoverActiveDeviceServices() { 100 | activeConnection.value?.discoverServices() 101 | } 102 | 103 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 104 | fun readPasswordFromActiveDevice() { 105 | activeConnection.value?.readPassword() 106 | } 107 | 108 | @RequiresPermission(PERMISSION_BLUETOOTH_CONNECT) 109 | fun writeNameToActiveDevice() { 110 | activeConnection.value?.writeName() 111 | } 112 | 113 | override fun onCleared() { 114 | super.onCleared() 115 | 116 | //when the ViewModel dies, shut down the BLE client with it 117 | if (bleScanner.isScanning.value) { 118 | if (ActivityCompat.checkSelfPermission( 119 | getApplication(), 120 | Manifest.permission.BLUETOOTH_SCAN 121 | ) == PackageManager.PERMISSION_GRANTED 122 | ) { 123 | bleScanner.stopScanning() 124 | } 125 | } 126 | } 127 | } 128 | 129 | data class BLEClientUIState( 130 | val isScanning: Boolean = false, 131 | val foundDevices: List = emptyList(), 132 | val activeDevice: BluetoothDevice? = null, 133 | val isDeviceConnected: Boolean = false, 134 | val discoveredCharacteristics: Map> = emptyMap(), 135 | val password: String? = null, 136 | val nameWrittenTimes: Int = 0 137 | ) -------------------------------------------------------------------------------- /app/src/main/res/drawable/ic_launcher_background.xml: -------------------------------------------------------------------------------- 1 | 2 | 7 | 10 | 15 | 20 | 25 | 30 | 35 | 40 | 45 | 50 | 55 | 60 | 65 | 70 | 75 | 80 | 85 | 90 | 95 | 100 | 105 | 110 | 115 | 120 | 125 | 130 | 135 | 140 | 145 | 150 | 155 | 160 | 165 | 170 | 171 | -------------------------------------------------------------------------------- /app/src/main/res/drawable/ic_launcher_foreground.xml: -------------------------------------------------------------------------------- 1 | 7 | 8 | 9 | 15 | 18 | 21 | 22 | 23 | 24 | 30 | -------------------------------------------------------------------------------- /app/src/main/res/mipmap-anydpi/ic_launcher.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /app/src/main/res/mipmap-anydpi/ic_launcher_round.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | -------------------------------------------------------------------------------- /app/src/main/res/mipmap-hdpi/ic_launcher.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-hdpi/ic_launcher.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-hdpi/ic_launcher_round.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-hdpi/ic_launcher_round.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-mdpi/ic_launcher.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-mdpi/ic_launcher.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-mdpi/ic_launcher_round.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-mdpi/ic_launcher_round.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xhdpi/ic_launcher.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-xhdpi/ic_launcher.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-xhdpi/ic_launcher_round.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxhdpi/ic_launcher.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-xxhdpi/ic_launcher.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-xxhdpi/ic_launcher_round.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp -------------------------------------------------------------------------------- /app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/tdcolvin/BLEClient/7276ed5c499d3d56dad62a4762c8f718b3022f3f/app/src/main/res/mipmap-xxxhdpi/ic_launcher_round.webp -------------------------------------------------------------------------------- /app/src/main/res/values/colors.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | #FFBB86FC 4 | #FF6200EE 5 | #FF3700B3 6 | #FF03DAC5 7 | #FF018786 8 | #FF000000 9 | #FFFFFFFF 10 | -------------------------------------------------------------------------------- /app/src/main/res/values/strings.xml: -------------------------------------------------------------------------------- 1 | 2 | BLEClient 3 | -------------------------------------------------------------------------------- /app/src/main/res/values/themes.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 |