SerialHelper

一個(gè)基于usb-serial-for-android封裝的Android串口通訊幫助庫(kù), 搭配ConvertExt實(shí)現(xiàn)ByteArray與基本數(shù)據(jù)類型的快速高效解析轉(zhuǎn)換。該庫(kù)配置簡(jiǎn)單，已用于某工業(yè)產(chǎn)品，波特率高達(dá)921600

功能簡(jiǎn)介

• 框架處理權(quán)限請(qǐng)求問(wèn)題
• 波特率設(shè)置
• 數(shù)據(jù)位設(shè)置
• 停止位設(shè)置
• 校驗(yàn)位設(shè)置
• 支持DTS和RTS
• 超時(shí)時(shí)長(zhǎng)設(shè)置
• 串口連接狀態(tài)監(jiān)聽(tīng)
• 串口數(shù)據(jù)發(fā)送及數(shù)據(jù)監(jiān)聽(tīng)
• 數(shù)據(jù)雙緩沖，解決高波特率，大數(shù)據(jù)量下的混亂問(wèn)題
• 波特率高達(dá)921600, 有少數(shù)情況丟幀; 波特率115200穩(wěn)定運(yùn)行

快速開(kāi)始

基本配置

• 在項(xiàng)目的build.gradle中添加

maven {
    url  "https://dl.bintray.com/swallowsonny/ext"
}

• 在app的build.gradle中添加

implementation 'com.swallowsonny:serialhelper:2.0.3'

• 在res/xml目錄中添加device_filter.xml

• 配置AndroidManifest.xml文件

<activity
    android:name="..."
    ...>
    <intent-filter>
        <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
    </intent-filter>
    <meta-data
        android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
        android:resource="@xml/device_filter" />
</activity>

快速使用

• 在onCreate() 方法中初始化SerialHelper

// 串口配置
val serialConfig = SerialConfig()
serialConfig.autoConnect = true // 默認(rèn)連接第一個(gè)
serialConfig.baudRate = 9600 // 串口波特率
serialConfig.readInterval = 10 // ms，子線程讀取，休眠間隔，雙緩沖讀取與寫(xiě)速率調(diào)整，默認(rèn)10ms
serialConfig.doubleBufferSize = 20 // 雙緩沖容量大小，循環(huán)覆蓋緩存
serialConfig.dataMaxSize = 30000  // 當(dāng)拼接數(shù)據(jù)未找到完整幀，長(zhǎng)度大于30000清空，可根據(jù)實(shí)際情況適當(dāng)調(diào)整
serialHelper =object : SerialHelper(serialConfig){
    override fun isFullFrame(data: ByteArray): IntArray {
        // 子線程 根據(jù)自己的完整幀判斷方式 返回?cái)?shù)據(jù)的起始索引和結(jié)束索引
        // 示例中有ByteUtils工具類，查找?guī)^幀尾的索引號(hào) 
        // ByteUtils.getIndexRange(data, startBytes, endBytes)
        return intArrayOf(0, data.size)
    }
}
serialHelper.onCreate(this)

• 在onDestory()中銷毀SerialHelper

serialHelper.onDestory()

• 狀態(tài)與數(shù)據(jù)監(jiān)聽(tīng)

// 狀態(tài)監(jiān)聽(tīng)
serialHelper.addOnUsbStatusChangeListener(object : OnUsbStatusChangeListener {
    override fun onUsbDeviceAttached() {
        Log.i("StatusChange", "onUsbDeviceAttached")
    }

    override fun onUsbDeviceDetached() {
        Log.i("StatusChange", "onUsbDeviceDetached")
    }

    override fun onPermissionGranted() {
        Log.i("StatusChange", "onPermissionGranted")
    }

    override fun onPermissionDenied() {
        Log.i("StatusChange", "onPermissionDenied")
    }

    override fun onDeviceNotSupport() {
        Log.i("StatusChange", "onDeviceNotSupport")
    }

    override fun onUsbConnect(usbDevice: UsbDevice) {
        Log.i("StatusChange", "onUsbConnect")
    }

    override fun onUsbConnectError(e: Exception) {
        Log.i("StatusChange", "onUsbConnectError")
    }

    override fun onUsbDisconnect() {
        Log.i("StatusChange", "onUsbDisconnect")
    }
})

// 數(shù)據(jù)監(jiān)聽(tīng)
serialHelper.addOnUsbDataListener(object : OnUsbDataListener {
    override fun onDataError(e: Exception?) {
        // 數(shù)據(jù)異常
    }

    override fun onDataReceived(bytes: ByteArray) {
        // 處理返回的數(shù)據(jù), 當(dāng)前線程為子線程
        runOnUiThread {
            
        }
    }
})

• 數(shù)據(jù)發(fā)送

serialHelper.write(sendBytes)