Implement UART module

profile_uart/src/main/AndroidManifest.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="no.nordicsemi.android.uart">
+
+    <application>
+        <service android:name=".repository.UARTService" />
+    </application>
+
+</manifest>

profile_uart/src/main/java/no/nordicsemi/android/uart/data/UARTData.kt

@@ -0,0 +1,8 @@
+package no.nordicsemi.android.uart.data
+
+import no.nordicsemi.android.utils.EMPTY
+
+internal data class UARTData(
+    val text: String = String.EMPTY,
+    val batteryLevel: Int = 0
+)

profile_uart/src/main/java/no/nordicsemi/android/uart/data/UARTDataHolder.kt

@@ -0,0 +1,21 @@
+package no.nordicsemi.android.uart.data
+
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import javax.inject.Inject
+import javax.inject.Singleton
+
+@Singleton
+internal class UARTDataHolder @Inject constructor() {
+
+    private val _data = MutableStateFlow(UARTData())
+    val data = _data.asStateFlow()
+
+    fun emitNewMessage(message: String) {
+        _data.tryEmit(_data.value.copy(text = message))
+    }
+
+    fun emitNewBatteryLevel(batteryLevel: Int) {
+        _data.tryEmit(_data.value.copy(batteryLevel = batteryLevel))
+    }
+}

profile_uart/src/main/java/no/nordicsemi/android/uart/repository/UARTManager.kt

@@ -0,0 +1,141 @@
+/*
+ * Copyright (c) 2015, Nordic Semiconductor
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this
+ * software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
+ * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package no.nordicsemi.android.uart.repository
+
+import android.bluetooth.BluetoothGatt
+import android.bluetooth.BluetoothGattCharacteristic
+import android.bluetooth.BluetoothGattService
+import android.content.Context
+import android.text.TextUtils
+import no.nordicsemi.android.ble.WriteRequest
+import no.nordicsemi.android.log.LogContract
+import no.nordicsemi.android.service.BatteryManager
+import no.nordicsemi.android.uart.data.UARTDataHolder
+import no.nordicsemi.android.utils.EMPTY
+import java.util.*
+
+/** Nordic UART Service UUID  */
+val UART_SERVICE_UUID = UUID.fromString("6E400001-B5A3-F393-E0A9-E50E24DCCA9E")
+
+/** RX characteristic UUID  */
+private val UART_RX_CHARACTERISTIC_UUID = UUID.fromString("6E400002-B5A3-F393-E0A9-E50E24DCCA9E")
+
+/** TX characteristic UUID  */
+private val UART_TX_CHARACTERISTIC_UUID = UUID.fromString("6E400003-B5A3-F393-E0A9-E50E24DCCA9E")
+
+internal class UARTManager(context: Context, private val dataHolder: UARTDataHolder) : BatteryManager(context) {
+
+    private var rxCharacteristic: BluetoothGattCharacteristic? = null
+    private var txCharacteristic: BluetoothGattCharacteristic? = null
+
+    /**
+     * A flag indicating whether Long Write can be used. It's set to false if the UART RX
+     * characteristic has only PROPERTY_WRITE_NO_RESPONSE property and no PROPERTY_WRITE.
+     * If you set it to false here, it will never use Long Write.
+     *
+     * TODO change this flag if you don't want to use Long Write even with Write Request.
+     */
+    private var useLongWrite = true
+
+    /**
+     * BluetoothGatt callbacks for connection/disconnection, service discovery,
+     * receiving indication, etc.
+     */
+    private inner class UARTManagerGattCallback : BatteryManagerGattCallback() {
+
+        override fun initialize() {
+            setNotificationCallback(txCharacteristic)
+                .with { device, data ->
+                    val text: String = data.getStringValue(0) ?: String.EMPTY
+                    log(LogContract.Log.Level.APPLICATION, "\"$text\" received")
+                    dataHolder.emitNewMessage(text)
+                }
+            requestMtu(260).enqueue()
+            enableNotifications(txCharacteristic).enqueue()
+        }
+
+        override fun isRequiredServiceSupported(gatt: BluetoothGatt): Boolean {
+            val service: BluetoothGattService = gatt.getService(UART_SERVICE_UUID)
+            if (service != null) {
+                rxCharacteristic = service.getCharacteristic(UART_RX_CHARACTERISTIC_UUID)
+                txCharacteristic = service.getCharacteristic(UART_TX_CHARACTERISTIC_UUID)
+            }
+            var writeRequest = false
+            var writeCommand = false
+
+            rxCharacteristic?.let {
+                val rxProperties: Int = it.properties
+                writeRequest = rxProperties and BluetoothGattCharacteristic.PROPERTY_WRITE > 0
+                writeCommand =
+                    rxProperties and BluetoothGattCharacteristic.PROPERTY_WRITE_NO_RESPONSE > 0
+
+                // Set the WRITE REQUEST type when the characteristic supports it.
+                // This will allow to send long write (also if the characteristic support it).
+                // In case there is no WRITE REQUEST property, this manager will divide texts
+                // longer then MTU-3 bytes into up to MTU-3 bytes chunks.
+                if (writeRequest) {
+                    it.writeType = BluetoothGattCharacteristic.WRITE_TYPE_DEFAULT
+                } else {
+                    useLongWrite = false
+                }
+            }
+            return rxCharacteristic != null && txCharacteristic != null && (writeRequest || writeCommand)
+        }
+
+        override fun onDeviceDisconnected() {
+            rxCharacteristic = null
+            txCharacteristic = null
+            useLongWrite = true
+        }
+
+        override fun onServicesInvalidated() {
+
+        }
+    }
+
+    fun send(text: String) {
+        // Are we connected?
+        if (rxCharacteristic == null) return
+        if (!TextUtils.isEmpty(text)) {
+            val request: WriteRequest = writeCharacteristic(rxCharacteristic, text.toByteArray())
+                .with { device, data ->
+                    log(
+                        LogContract.Log.Level.APPLICATION,
+                        "\"" + data.getStringValue(0).toString() + "\" sent"
+                    )
+                }
+            if (!useLongWrite) {
+                // This will automatically split the long data into MTU-3-byte long packets.
+                request.split()
+            }
+            request.enqueue()
+        }
+    }
+
+    override fun onBatteryLevelChanged(batteryLevel: Int) {
+        dataHolder.emitNewBatteryLevel(batteryLevel)
+    }
+
+    override fun getGattCallback(): BatteryManagerGattCallback {
+        return UARTManagerGattCallback()
+    }
+}

profile_uart/src/main/java/no/nordicsemi/android/uart/repository/UARTService.kt

@@ -0,0 +1,15 @@
+package no.nordicsemi.android.uart.repository
+
+import dagger.hilt.android.AndroidEntryPoint
+import no.nordicsemi.android.service.ForegroundBleService
+import no.nordicsemi.android.uart.data.UARTDataHolder
+import javax.inject.Inject
+
+@AndroidEntryPoint
+internal class UARTService : ForegroundBleService() {
+
+    @Inject
+    lateinit var dataHolder: UARTDataHolder
+
+    override val manager: UARTManager by lazy { UARTManager(this, dataHolder) }
+}

profile_uart/src/main/java/no/nordicsemi/android/uart/view/UARTContentView.kt

@@ -0,0 +1,4 @@
+package no.nordicsemi.android.uart.view
+
+class UARTContentView {
+}

profile_uart/src/main/java/no/nordicsemi/android/uart/view/UARTScreen.kt

@@ -0,0 +1,7 @@
+package no.nordicsemi.android.uart.view
+
+import androidx.compose.runtime.Composable
+
+@Composable
+fun UARTScreen(finishAction: () -> Unit) {
+}

profile_uart/src/main/java/no/nordicsemi/android/uart/viewmodel/UARTViewModel.kt

@@ -0,0 +1,6 @@
+package no.nordicsemi.android.uart.viewmodel
+
+import no.nordicsemi.android.theme.viewmodel.CloseableViewModel
+
+class UARTViewModel : CloseableViewModel() {
+}