usbserialport

2021年5月更新: 因为很久没有参与硬件串口方面的工作，在加上手头并没有实际的硬件设备，所以对于大家提出的现实问题我能给与的帮助比较有限，因此本项目不在维护。

本库使用kotlin语言开发，提供android系统下usb转串口及串口(UART,RS232)通信方式

依赖本库的工程需要提供kotlin支持，若无法提供可参考本库底层实现 参考串口通信源码 参考usb转串口源码

基于本库开发的简单调试工具

调试工具apk下载

android studio 添加

dependencies {
      implementation 'com.hd:usbserialport:last-version'
  }

注意：usbserialport只实现底层读写功能，实际使用建议再封装一层，这里提供一个简单的封装库 usb-serial-port-measure

用法：

1.在application 初始化：

public class AIOApp extends Application {
        @Override
        public void onCreate() {
            super.onCreate();
            DeviceMeasureController.INSTANCE.init(this,BuildConfig.DEBUG);
        }
  }

2.扫描设备

  DeviceMeasureController.INSTANCE.scanSerialPort();//扫描串口
  
  DeviceMeasureController.INSTANCE.scanUsbPort();//扫描usb转串口

3.开始测量

3.1 usb转串口测量

//测量所有设备
  @Override
     protected void onResume() {
         super.onResume();
         DeviceMeasureController.INSTANCE.measure(DeviceMeasureController.INSTANCE.scanUsbPort(),new UsbMeasureParameter(), new UsbMeasureListener() {
             @Override
             public void measuring(@Nullable Object tag,UsbSerialPort usbSerialPort, byte[] data) {
                 //处理返回数据
             }
 
             @Override
             public void write(@Nullable Object tag,UsbSerialPort usbSerialPort) {
                 //允许持续性写入数据
                 try {
                     usbSerialPort.write(new byte[]{(byte) 0xff, (byte) 0xff},1000);
                 } catch (IOException e) {
                     e.printStackTrace();
                 }
             }
 
             @Override
             public void measureError(@Nullable Object tag,String message) {
                
             }
         });
     }

   //测量单个目标设备 
    @Override
    protected void onResume() {
        super.onResume();
        //根据实际选择情况
        UsbSerialPort port=DeviceMeasureController.INSTANCE.scanUsbPort().get(0).getPorts().get(0);
        DeviceMeasureController.INSTANCE.measure(port, new UsbMeasureParameter(115200,8,1,0), new UsbMeasureListener() {
            @Override
            public void measuring(@Nullable Object tag,UsbSerialPort usbSerialPort, byte[] data) {
                //处理返回数据
            }

            @Override
            public void write(@Nullable Object tag,UsbSerialPort usbSerialPort) {
                //允许持续性写入数据
                try {
                    usbSerialPort.write(new byte[]{(byte) 0xff, (byte) 0xff},1000);
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }

            @Override
            public void measureError(@Nullable Object tag,String message) {
                
            }
        });
    } 

3.2 串口测量

//测量所有设备
   @Override
    protected void onResume() {
        super.onResume();
        DeviceMeasureController.INSTANCE.measure(null, new SerialPortMeasureParameter(), new SerialPortMeasureListener() {
            @Override
            public void measuring(@Nullable Object tag,String path, byte[] data) {
                //处理返回数据
            }

            @Override
            public void write(@Nullable Object tag,OutputStream outputStream) {
                //允许持续性写入数据
                try {
                    outputStream.write(new byte[]{(byte) 0xff, (byte) 0xff});
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
                
            @Override
            public void measureError(@Nullable Object tag,String message) {

            }
        });
    }

   //测量单个目标设备 
     @Override
        protected void onResume() {
            super.onResume();
            String targetDevicePath="/dev/ttyS3";
            DeviceMeasureController.INSTANCE.measure(new SerialPortMeasureParameter(targetDevicePath,115200,0), new SerialPortMeasureListener() {
                @Override
                public void measuring(@Nullable Object tag,String path, byte[] data) {
                    //处理返回数据
                }

                @Override
                public void write(@Nullable Object tag,OutputStream outputStream) {
                    //允许持续性写入数据
                    try {
                        outputStream.write(new byte[]{(byte) 0xff, (byte) 0xff});
                    } catch (IOException e) {
                        e.printStackTrace();
                    }
                }
                
                @Override
                public void measureError(@Nullable Object tag,String message) {
    
                }
            });
        }

3.测量阶段发送指令

DeviceMeasureController.INSTANCE.write()

4.停止测量

DeviceMeasureController.INSTANCE.stop()

5.usb驱动程序扩展

//最新版本提供usb 驱动程序扩展功能，允许外部扩展或替换库自带驱动程序，实现自定义操作
//本着开源精神，若有其他驱动或者发现本库驱动存在的问题，请向我提commit，方便后面的朋友使用
List<Pair<String, Class<? extends UsbSerialDriver>>> list = Arrays.asList(
                new Pair<String, Class<? extends UsbSerialDriver>>("custom", TestUsbDriver.class))
new UsbExtendDriver.Extender().setDrivers().extend()

License

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

   http://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.