android串口程序

提到串口编程,就不得不提到JNI,不得不提到JavaAPI中的文件描述符类:FileDescriptor。下面我分别对JNI、FileDescriptor以及串口的一些知识点和实现的源码进行分析说明。这里主要是参考了开源项目android-serialport-api

    串口编程需要了解的基本知识点:对于串口编程,我们只需对串口进行一系列的设置,然后打开串口,这些操作我们可以参考串口调试助手的源码进行学习。在Java中如果要实现串口的读写功能只需操作文件设备类:FileDescriptor即可,其他的事都由驱动来完成不用多管!当然,你想了解,那就得看驱动代码了。这里并不打算对驱动进行说明,只初略阐述应用层的实现方式。

 

(一)JNI:

    关于JNI的文章网上有很多,不再多做解释,想详细了解的朋友可以查看云中漫步的技术文章,写得很好,分析也很全面,那么在这篇拙文中我强调3点:

    1、如何将编译好的SO文件打包到APK中?(方法很简单,直接在工程目录下新建文件夹 libs/armeabi,将SO文件Copy到此目录即可)

    2、命名要注意的地方?(在编译好的SO文件中,将文件重命名为:libfilename.so即可。其中filename.so是编译好后生成的文件)

    3、MakeFile文件的编写(不用多说,可以直接参考package/apps目录下用到JNI的相关项目写法)

    这是关键的代码:

  1. <span style="font-size:18px;">        int fd;  
  2.         speed_t speed;  
  3.         jobject mFileDescriptor;  
  4.   
  5.         /* Check arguments */  
  6.         {  
  7.                 speed = getBaudrate(baudrate);  
  8.                 if (speed == -1) {  
  9.                         /* TODO: throw an exception */  
  10.                         LOGE("Invalid baudrate");  
  11.                         return NULL;  
  12.                 }  
  13.         }  
  14.   
  15.         /* Opening device */  
  16.         {  
  17.                 jboolean iscopy;  
  18.                 const char *path_utf = (*env)->GetStringUTFChars(env, path, &iscopy);  
  19.                 LOGD("Opening serial port %s with flags 0x%x", path_utf, O_RDWR | flags);  
  20.                 fd = open(path_utf, O_RDWR | flags);  
  21.                 LOGD("open() fd = %d", fd);  
  22.                 (*env)->ReleaseStringUTFChars(env, path, path_utf);  
  23.                 if (fd == -1)  
  24.                 {  
  25.                         /* Throw an exception */  
  26.                         LOGE("Cannot open port");  
  27.                         /* TODO: throw an exception */  
  28.                         return NULL;  
  29.                 }  
  30.         }  
  31.   
  32.         /* Configure device */  
  33.         {  
  34.                 struct termios cfg;  
  35.                 LOGD("Configuring serial port");  
  36.                 if (tcgetattr(fd, &cfg))  
  37.                 {  
  38.                         LOGE("tcgetattr() failed");  
  39.                         close(fd);  
  40.                         /* TODO: throw an exception */  
  41.                         return NULL;  
  42.                 }  
  43.   
  44.                 cfmakeraw(&cfg);  
  45.                 cfsetispeed(&cfg, speed);  
  46.                 cfsetospeed(&cfg, speed);  
  47.   
  48.                 if (tcsetattr(fd, TCSANOW, &cfg))  
  49.                 {  
  50.                         LOGE("tcsetattr() failed");  
  51.                         close(fd);  
  52.                         /* TODO: throw an exception */  
  53.                         return NULL;  
  54.                 }  
  55.         }  
  56. </span>  

(二)FileDescritor:

    文件描述符类的实例用作与基础机器有关的某种结构的不透明句柄,该结构表示开放文件、开放套接字或者字节的另一个源或接收者。文件描述符的主要实际用途是创建一个包含该结构的FileInputStreamFileOutputStream。这是API的描述,不太好理解,其实可简单的理解为:FileDescritor就是对一个文件进行读写。

(三)实现串口通信细节

1)  建工程:SerialDemo包名:org.winplus.serial,并在工程目录下新建jni和libs两个文件夹和一个org.winplus.serial.utils,如下图:


2) 新建一个类:SerialPortFinder,添加如下代码:

  1. <span style="font-size:18px;">package org.winplus.serial.utils;  
  2.   
  3. import java.io.File;  
  4. import java.io.FileReader;  
  5. import java.io.IOException;  
  6. import java.io.LineNumberReader;  
  7. import java.util.Iterator;  
  8. import java.util.Vector;  
  9.   
  10. import android.util.Log;  
  11.   
  12. public class SerialPortFinder {  
  13.   
  14.     private static final String TAG = "SerialPort";  
  15.   
  16.     private Vector<Driver> mDrivers = null;  
  17.   
  18.     public class Driver {  
  19.         public Driver(String name, String root) {  
  20.             mDriverName = name;  
  21.             mDeviceRoot = root;  
  22.         }  
  23.   
  24.         private String mDriverName;  
  25.         private String mDeviceRoot;  
  26.         Vector<File> mDevices = null;  
  27.   
  28.         public Vector<File> getDevices() {  
  29.             if (mDevices == null) {  
  30.                 mDevices = new Vector<File>();  
  31.                 File dev = new File("/dev");  
  32.                 File[] files = dev.listFiles();  
  33.                 int i;  
  34.                 for (i = 0; i < files.length; i++) {  
  35.                     if (files[i].getAbsolutePath().startsWith(mDeviceRoot)) {  
  36.                         Log.d(TAG, "Found new device: " + files[i]);  
  37.                         mDevices.add(files[i]);  
  38.                     }  
  39.                 }  
  40.             }  
  41.             return mDevices;  
  42.         }  
  43.   
  44.         public String getName() {  
  45.             return mDriverName;  
  46.         }  
  47.     }  
  48.   
  49.     Vector<Driver> getDrivers() throws IOException {  
  50.         if (mDrivers == null) {  
  51.             mDrivers = new Vector<Driver>();  
  52.             LineNumberReader r = new LineNumberReader(new FileReader(  
  53.                     "/proc/tty/drivers"));  
  54.             String l;  
  55.             while ((l = r.readLine()) != null) {  
  56.                 // Issue 3:  
  57.                 // Since driver name may contain spaces, we do not extract  
  58.                 // driver name with split()  
  59.                 String drivername = l.substring(00x15).trim();  
  60.                 String[] w = l.split(" +");  
  61.                 if ((w.length >= 5) && (w[w.length - 1].equals("serial"))) {  
  62.                     Log.d(TAG, "Found new driver " + drivername + " on "  
  63.                             + w[w.length - 4]);  
  64.                     mDrivers.add(new Driver(drivername, w[w.length - 4]));  
  65.                 }  
  66.             }  
  67.             r.close();  
  68.         }  
  69.         return mDrivers;  
  70.     }  
  71.   
  72.     public String[] getAllDevices() {  
  73.         Vector<String> devices = new Vector<String>();  
  74.         // Parse each driver  
  75.         Iterator<Driver> itdriv;  
  76.         try {  
  77.             itdriv = getDrivers().iterator();  
  78.             while (itdriv.hasNext()) {  
  79.                 Driver driver = itdriv.next();  
  80.                 Iterator<File> itdev = driver.getDevices().iterator();  
  81.                 while (itdev.hasNext()) {  
  82.                     String device = itdev.next().getName();  
  83.                     String value = String.format("%s (%s)", device,  
  84.                             driver.getName());  
  85.                     devices.add(value);  
  86.                 }  
  87.             }  
  88.         } catch (IOException e) {  
  89.             e.printStackTrace();  
  90.         }  
  91.         return devices.toArray(new String[devices.size()]);  
  92.     }  
  93.   
  94.     public String[] getAllDevicesPath() {  
  95.         Vector<String> devices = new Vector<String>();  
  96.         // Parse each driver  
  97.         Iterator<Driver> itdriv;  
  98.         try {  
  99.             itdriv = getDrivers().iterator();  
  100.             while (itdriv.hasNext()) {  
  101.                 Driver driver = itdriv.next();  
  102.                 Iterator<File> itdev = driver.getDevices().iterator();  
  103.                 while (itdev.hasNext()) {  
  104.                     String device = itdev.next().getAbsolutePath();  
  105.                     devices.add(device);  
  106.                 }  
  107.             }  
  108.         } catch (IOException e) {  
  109.             e.printStackTrace();  
  110.         }  
  111.         return devices.toArray(new String[devices.size()]);  
  112.     }  
  113. }  
  114. </span>  

上面这个类在“android-serialport-api串口工具测试随笔”中有详细的说明,我就不多说了。

3)新建SerialPort类,这个类主要用来加载SO文件,通过JNI的方式打开关闭串口

  1. <span style="font-size:18px;">package org.winplus.serial.utils;  
  2.   
  3. import java.io.File;  
  4. import java.io.FileDescriptor;  
  5. import java.io.FileInputStream;  
  6. import java.io.FileOutputStream;  
  7. import java.io.IOException;  
  8. import java.io.InputStream;  
  9. import java.io.OutputStream;  
  10.   
  11. import android.util.Log;  
  12.   
  13. public class SerialPort {  
  14.     private static final String TAG = "SerialPort";  
  15.   
  16.     /* 
  17.      * Do not remove or rename the field mFd: it is used by native method 
  18.      * close(); 
  19.      */  
  20.     private FileDescriptor mFd;  
  21.     private FileInputStream mFileInputStream;  
  22.     private FileOutputStream mFileOutputStream;  
  23.   
  24.     public SerialPort(File device, int baudrate, int flags)  
  25.             throws SecurityException, IOException {  
  26.   
  27.         /* Check access permission */  
  28.         if (!device.canRead() || !device.canWrite()) {  
  29.             try {  
  30.                 /* Missing read/write permission, trying to chmod the file */  
  31.                 Process su;  
  32.                 su = Runtime.getRuntime().exec("/system/bin/su");  
  33.                 String cmd = "chmod 666 " + device.getAbsolutePath() + "\n"  
  34.                         + "exit\n";  
  35.                 su.getOutputStream().write(cmd.getBytes());  
  36.                 if ((su.waitFor() != 0) || !device.canRead()  
  37.                         || !device.canWrite()) {  
  38.                     throw new SecurityException();  
  39.                 }  
  40.             } catch (Exception e) {  
  41.                 e.printStackTrace();  
  42.                 throw new SecurityException();  
  43.             }  
  44.         }  
  45.   
  46.         mFd = open(device.getAbsolutePath(), baudrate, flags);  
  47.         if (mFd == null) {  
  48.             Log.e(TAG, "native open returns null");  
  49.             throw new IOException();  
  50.         }  
  51.         mFileInputStream = new FileInputStream(mFd);  
  52.         mFileOutputStream = new FileOutputStream(mFd);  
  53.     }  
  54.   
  55.     // Getters and setters  
  56.     public InputStream getInputStream() {  
  57.         return mFileInputStream;  
  58.     }  
  59.   
  60.     public OutputStream getOutputStream() {  
  61.         return mFileOutputStream;  
  62.     }  
  63.   
  64.     // JNI  
  65.     private native static FileDescriptor open(String path, int baudrate,  
  66.             int flags);  
  67.   
  68.     public native void close();  
  69.   
  70.     static {  
  71.         System.loadLibrary("serial_port");  
  72.     }  
  73. }  
  74. </span>  

4) 新建一个MyApplication 继承android.app.Application,用来对串口进行初始化和关闭串口
  1. <span style="font-size:18px;">package org.winplus.serial;  
  2.   
  3. import java.io.File;  
  4. import java.io.IOException;  
  5. import java.security.InvalidParameterException;  
  6.   
  7. import org.winplus.serial.utils.SerialPort;  
  8. import org.winplus.serial.utils.SerialPortFinder;  
  9.   
  10. import android.content.SharedPreferences;  
  11.   
  12. public class Application extends android.app.Application {  
  13.     public SerialPortFinder mSerialPortFinder = new SerialPortFinder();  
  14.     private SerialPort mSerialPort = null;  
  15.   
  16.     public SerialPort getSerialPort() throws SecurityException, IOException, InvalidParameterException {  
  17.             if (mSerialPort == null) {  
  18.                     /* Read serial port parameters */  
  19.                     SharedPreferences sp = getSharedPreferences("android_serialport_api.sample_preferences", MODE_PRIVATE);  
  20.                     String path = sp.getString("DEVICE""");  
  21.                     int baudrate = Integer.decode(sp.getString("BAUDRATE""-1"));  
  22.   
  23.                     /* Check parameters */  
  24.                     if ( (path.length() == 0) || (baudrate == -1)) {  
  25.                             throw new InvalidParameterException();  
  26.                     }  
  27.   
  28.                     /* Open the serial port */  
  29.                     mSerialPort = new SerialPort(new File(path), baudrate, 0);  
  30.             }  
  31.             return mSerialPort;  
  32.     }  
  33.   
  34.     public void closeSerialPort() {  
  35.             if (mSerialPort != null) {  
  36.                     mSerialPort.close();  
  37.                     mSerialPort = null;  
  38.             }  
  39.     }  
  40. }  
  41. </span>  

5) 新建一个继承抽象的Activity类,主要用于读取串口的信息
  1. <span style="font-size:18px;">package org.winplus.serial;  
  2.   
  3. import java.io.IOException;  
  4. import java.io.InputStream;  
  5. import java.io.OutputStream;  
  6. import java.security.InvalidParameterException;  
  7.   
  8. import org.winplus.serial.utils.SerialPort;  
  9.   
  10. import android.app.Activity;  
  11. import android.app.AlertDialog;  
  12. import android.content.DialogInterface;  
  13. import android.content.DialogInterface.OnClickListener;  
  14. import android.os.Bundle;  
  15.   
  16. public abstract class SerialPortActivity extends Activity {  
  17.     protected MyApplication mApplication;  
  18.     protected SerialPort mSerialPort;  
  19.     protected OutputStream mOutputStream;  
  20.     private InputStream mInputStream;  
  21.     private ReadThread mReadThread;  
  22.   
  23.     private class ReadThread extends Thread {  
  24.   
  25.         @Override  
  26.         public void run() {  
  27.             super.run();  
  28.             while (!isInterrupted()) {  
  29.                 int size;  
  30.                 try {  
  31.                     byte[] buffer = new byte[64];  
  32.                     if (mInputStream == null)  
  33.                         return;  
  34.                       
  35.                     /** 
  36.                      * 这里的read要尤其注意,它会一直等待数据,等到天荒地老,海枯石烂。如果要判断是否接受完成,只有设置结束标识,或作其他特殊的处理。 
  37.                      */  
  38.                     size = mInputStream.read(buffer);  
  39.                     if (size > 0) {  
  40.                         onDataReceived(buffer, size);  
  41.                     }  
  42.                 } catch (IOException e) {  
  43.                     e.printStackTrace();  
  44.                     return;  
  45.                 }  
  46.             }  
  47.         }  
  48.     }  
  49.   
  50.     private void DisplayError(int resourceId) {  
  51.         AlertDialog.Builder b = new AlertDialog.Builder(this);  
  52.         b.setTitle("Error");  
  53.         b.setMessage(resourceId);  
  54.         b.setPositiveButton("OK"new OnClickListener() {  
  55.             public void onClick(DialogInterface dialog, int which) {  
  56.                 SerialPortActivity.this.finish();  
  57.             }  
  58.         });  
  59.         b.show();  
  60.     }  
  61.   
  62.     @Override  
  63.     protected void onCreate(Bundle savedInstanceState) {  
  64.         super.onCreate(savedInstanceState);  
  65.         mApplication = (MyApplication) getApplication();  
  66.         try {  
  67.             mSerialPort = mApplication.getSerialPort();  
  68.             mOutputStream = mSerialPort.getOutputStream();  
  69.             mInputStream = mSerialPort.getInputStream();  
  70.   
  71.             /* Create a receiving thread */  
  72.             mReadThread = new ReadThread();  
  73.             mReadThread.start();  
  74.         } catch (SecurityException e) {  
  75.             DisplayError(R.string.error_security);  
  76.         } catch (IOException e) {  
  77.             DisplayError(R.string.error_unknown);  
  78.         } catch (InvalidParameterException e) {  
  79.             DisplayError(R.string.error_configuration);  
  80.         }  
  81.     }  
  82.   
  83.     protected abstract void onDataReceived(final byte[] buffer, final int size);  
  84.   
  85.     @Override  
  86.     protected void onDestroy() {  
  87.         if (mReadThread != null)  
  88.             mReadThread.interrupt();  
  89.         mApplication.closeSerialPort();  
  90.         mSerialPort = null;  
  91.         super.onDestroy();  
  92.     }  
  93. }  
  94. </span>  

6)编写string.xml 以及baudrates.xml文件

    在string.xml文件中添加:
  1. <span style="font-size:18px;">    <string name="error_configuration">Please configure your serial port first.</string>  
  2.     <string name="error_security">You do not have read/write permission to the serial  port.</string>  
  3.     <string name="error_unknown">The serial port can not be opened for an unknown  reason.</string>  
  4. </span>  

在baudrates.xml文件中添加
  1. <span style="font-size:18px;"><?xml version="1.0" encoding="utf-8"?>  
  2. <resources>  
  3.   
  4.     <string-array name="baudrates_name">  
  5.         <item>50</item>  
  6.         <item>75</item>  
  7.         <item>110</item>  
  8.         <item>134</item>  
  9.         <item>150</item>  
  10.         <item>200</item>  
  11.         <item>300</item>  
  12.         <item>600</item>  
  13.         <item>1200</item>  
  14.         <item>1800</item>  
  15.         <item>2400</item>  
  16.         <item>4800</item>  
  17.         <item>9600</item>  
  18.         <item>19200</item>  
  19.         <item>38400</item>  
  20.         <item>57600</item>  
  21.         <item>115200</item>  
  22.         <item>230400</item>  
  23.         <item>460800</item>  
  24.         <item>500000</item>  
  25.         <item>576000</item>  
  26.         <item>921600</item>  
  27.         <item>1000000</item>  
  28.         <item>1152000</item>  
  29.         <item>1500000</item>  
  30.         <item>2000000</item>  
  31.         <item>2500000</item>  
  32.         <item>3000000</item>  
  33.         <item>3500000</item>  
  34.         <item>4000000</item>  
  35.     </string-array>  
  36.     <string-array name="baudrates_value">  
  37.         <item>50</item>  
  38.         <item>75</item>  
  39.         <item>110</item>  
  40.         <item>134</item>  
  41.         <item>150</item>  
  42.         <item>200</item>  
  43.         <item>300</item>  
  44.         <item>600</item>  
  45.         <item>1200</item>  
  46.         <item>1800</item>  
  47.         <item>2400</item>  
  48.         <item>4800</item>  
  49.         <item>9600</item>  
  50.         <item>19200</item>  
  51.         <item>38400</item>  
  52.         <item>57600</item>  
  53.         <item>115200</item>  
  54.         <item>230400</item>  
  55.         <item>460800</item>  
  56.         <item>500000</item>  
  57.         <item>576000</item>  
  58.         <item>921600</item>  
  59.         <item>1000000</item>  
  60.         <item>1152000</item>  
  61.         <item>1500000</item>  
  62.         <item>2000000</item>  
  63.         <item>2500000</item>  
  64.         <item>3000000</item>  
  65.         <item>3500000</item>  
  66.         <item>4000000</item>  
  67.     </string-array>  
  68.   
  69. </resources>  
  70. </span>  

7)开始编写界面了:在main.xml布局文件中添加两个编辑框,一个用来发送命令,一个用来接收命令:
  1. <span style="font-size:18px;"><?xml version="1.0" encoding="utf-8"?>  
  2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"  
  3.     android:layout_width="fill_parent"  
  4.     android:layout_height="fill_parent"  
  5.     android:orientation="vertical" >  
  6.   
  7.     <EditText  
  8.         android:id="@+id/EditTextReception"  
  9.         android:layout_width="fill_parent"  
  10.         android:layout_height="fill_parent"  
  11.         android:layout_weight="1"  
  12.         android:gravity="top"  
  13.         android:hint="Reception"  
  14.         android:isScrollContainer="true"  
  15.         android:scrollbarStyle="insideOverlay" >  
  16.     </EditText>  
  17.   
  18.     <EditText  
  19.         android:id="@+id/EditTextEmission"  
  20.         android:layout_width="fill_parent"  
  21.         android:layout_height="wrap_content"  
  22.         android:hint="Emission"  
  23.         android:lines="1" >  
  24.     </EditText>  
  25.   
  26. </LinearLayout>  
  27. </span>  

8) SerialDemoActivity类的实现:

  1. <span style="font-size:18px;">package org.winplus.serial;  
  2.   
  3. import java.io.IOException;  
  4.   
  5. import android.os.Bundle;  
  6. import android.view.KeyEvent;  
  7. import android.widget.EditText;  
  8. import android.widget.TextView;  
  9. import android.widget.TextView.OnEditorActionListener;  
  10.   
  11. public class SerialDemoActivity extends SerialPortActivity{  
  12.     EditText mReception;  
  13.   
  14.     @Override  
  15.     protected void onCreate(Bundle savedInstanceState) {  
  16.             super.onCreate(savedInstanceState);  
  17.             setContentView(R.layout.main);  
  18.   
  19. //          setTitle("Loopback test");  
  20.             mReception = (EditText) findViewById(R.id.EditTextReception);  
  21.   
  22.             EditText Emission = (EditText) findViewById(R.id.EditTextEmission);  
  23.             Emission.setOnEditorActionListener(new OnEditorActionListener() {  
  24.                     public boolean onEditorAction(TextView v, int actionId, KeyEvent event) {  
  25.                             int i;  
  26.                             CharSequence t = v.getText();  
  27.                             char[] text = new char[t.length()];  
  28.                             for (i=0; i<t.length(); i++) {  
  29.                                     text[i] = t.charAt(i);  
  30.                             }  
  31.                             try {  
  32.                                     mOutputStream.write(new String(text).getBytes());  
  33.                                     mOutputStream.write('\n');  
  34.                             } catch (IOException e) {  
  35.                                     e.printStackTrace();  
  36.                             }  
  37.                             return false;  
  38.                     }  
  39.             });  
  40.     }  
  41.   
  42.     @Override  
  43.     protected void onDataReceived(final byte[] buffer, final int size) {  
  44.             runOnUiThread(new Runnable() {  
  45.                     public void run() {  
  46.                             if (mReception != null) {  
  47.                                     mReception.append(new String(buffer, 0, size));  
  48.                             }  
  49.                     }  
  50.             });  
  51.     }  
  52. }  
  53. </span>  

    写到这里,代码基本上写完了。下面就是要实现JNI层的功能了,要实现JNI,必须首先生成头文件,头文件的生成方式也很简单, 我们编译工程,在终端输入 javah org.winplus.serial.utils.SerialPort 则会生成头文件:org_winplus_serial_utils_SerialPort.h,这个头文件的名字可以随意命名。我们将它命名为:SerialPort.h拷贝到新建的目录jni中,新建SerialPort.c 文件,这两个文件的代码就不贴出来了。直接到上传的代码中看吧。


(四)串口的应用,可实现扫描头,指纹识别等外围USB转串口的特色应用。

 

还蛮繁琐的,以上只是对开源项目android-serialport-api 进行精简想了解此项目请点击此处就这样吧,晚了准备见周公去!

 源码下载地址==》

精心准备的串口编程资料,欢迎下载==》

原创文章,转载请注明出处:http://blog.csdn.net/tangcheng_ok/article/details/7021470


评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值