Android/JAVA下基于java-simple-serial-connector串口开发完整教程

列个纲：

1.根据.cpp文件和.h文件制作so库；

2.基础API认识；

3.代码示例；

以下正文：

1. 笔者android studio版本为：2.1.1

   1.1将项目栏指向project，在main目录下(java包同级目录)创建jni文件（参考我的csdnNDK开发入门： http://blog.csdn.net/ssy_neo/article/details/51758687）；

   1.2将解压出来的java-simple-serial-connector-2.8.0\src\cpp\_nix_based\jssc.cpp文件和\java-simple-serial-connector-2.8.0\src\cpp\jssc_SerialNativeInterface.h文件放进jni文件夹;

   1.3进app目录的build.gradle，声明我们的ndk名（AS会自动提示是否添加android.useDeprecatedNdk=true，点确定。若没有下载过NDK环境，请自行下载，方法百度）；

   1.4拍黑板：“啪啪啪”，同学们注意，第一个要点来了。

              1.4.1：新建一个包，我这里命名为：jssc;

              1.4.2 : 将java-simple-serial-connector-2.8.0\src\java\jssc\目录下所有java文件导入jssc包；  

              1.4.3：进jssc_SerialNativeInterface.h,将所有 Java_jssc_SerialNativeInterface改成 Java_你的主包名_jssc_SerialNativeInterface;

              1.4.4：进jssc.cpp，将所有 Java_jssc_SerialNativeInterface改成 Java_你的主包名_jssc_SerialNativeInterface;(不懂原理请看上面的博客)，且将#include "../jssc_SerialNativeInterface.h"改成"#include "jssc_SerialNativeInterface.h"";

              1.4.5：serialNativeInterface.java改成我提供的文件里面的内容;

              好了，基本OK了，代码里面调用一次

                 serialPortFW = new SerialPort("你的串口号");

                    try {

                    serialPortFW.openPort();

                          } catch (SerialPortException e) {

                          e.printStackTrace();

                           }

              run一下试试。

              如果没报错，恭喜你，串口代码可以开始正常使用。如果报错，恭喜你，主要问题我都已经碰到了:

                   1.找不到native方法。仔细阅读1.4；

                   2. cannot locatesymbol " tcgetattr " referenced by "xxx"，这是因为ndk在android发展过程中出现了一次很大的改变， tcgetattr 被删掉了。不要怕，这个库文件我已经有提供，将其丢进jni文件夹下即可(这个问题我翻墙找了很久，此处一次性给出解决方案，大坑)。

                  

  2.我翻墙在googlecode上找过java-simple-serial-connector的API DOC，可能因年久失修(2014年提交的代码)，doc已失效。不过没关系，我们要用的接口其实并不多,以下列出几个重要端口:

      2.1：openPort:打开一个端口，需要指定端口名;

              closePort:关闭指定端口;

              setParams:要指定的参数为:波特率,校验位(如无填0，一般填0),数据位(一般填8)，停止位(一般为1)；

               writeBytes:向端口写入字节型命令;

              wirteString:向端口写入字符型命令; 

              addEventListener:监听串口返回(回调方法内serialPortEvent中可获取端口名，返回字符/字节等数据);

               黑板:"啪啪啪"，这里有个坑：请注意，调用openPort之后请立即调用writeBytes/wirteString，否则会造成端口一直劫持，无法获得正确的返回参数;

 

3.上干货:

  

           SerialPort serialPortLed;
    private void checkLed() throws SerialPortException {
        if (serialPortLed == null) {
            serialPortLed = new SerialPort("/dev/ttyG3"); //输入你的串口号
        }
            if (!serialPortLed.isOpened()) {
                serialPortLed.openPort();
                serialPortLed.addEventListener(listenr);
            }
            serialPortLed.setParams("你的波特率", 0, 8, 1);
    }

    private void openLed() {
        try {
             checkLed();
            sendPortData(serialPortLed, "这里是我的命令", true);
        } catch (SerialPortException e) {
            e.printStackTrace();
        }
    }


    /**
    *发送串口命令
    */
      private void sendPortData(SerialPort ComPort, String data, boolean isHex) throws SerialPortException {
        if (ComPort != null && ComPort.isOpened()) {
        //是否16进制的命令，如果是，走上面，如果是字符型的命令，直接走下面
            if (isHex) {
                ComPort.writeBytes(MyFunc.HexToByteArr(data));
            } else {
                ComPort.writeString(data);
            }
        }
    }

    SerialPortEventListener listenr = new SerialPortEventListener() {
        @Override
        public void serialEvent(SerialPortEvent serialPortEvent) {
            if (serialPortEvent.isRXCHAR()) {
                try {
                    if (serialPortEvent.getEventValue() > 0) {
                        System.out.println("come into return");
//                        System.out.println("serialPortEvent.getEventType():" + serialPortEvent.getEventType());
//                        System.out.println("serialPortEvent.getPortName():" + serialPortEvent.getPortName());
//                        System.out.println("serialPortEvent.getEventValue():" + serialPortEvent.getEventValue());
                         //以16进制的方式读取串口返回数据
                        System.out.println("read form serial:" + serialPortEvent.getPortName() + "" + serialPortLed.readHexString(serialPortEvent.getEventValue()));
                    }

                    //我的机器比较烂，如果不停读取串口会导致GCLOG不停打印，所以每次休眠个250ms
                    Thread.sleep(250);
                } catch (Exception e) {
                    e.printStackTrace();
                }

            }
        }
    };