提到串口编程,就不得不提到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的相关项目写法)
这是关键的代码:
intfd;
speed_t speed;
jobject mFileDescriptor;
/* Check arguments */
{
speed = getBaudrate(baudrate);
if(speed == -1) {
/* TODO: throw an exception */
LOGE("Invalid baudrate");
returnNULL;
}
}
/* Opening device */
{
jboolean iscopy;
constchar*path_utf = (*env)->GetStringUTFChars(env, path, &iscopy);
LOGD("Opening serial port %s with flags 0x%x", path_utf, O_RDWR | flags);
fd = open(path_utf, O_RDWR | flags);
LOGD("open() fd = %d", fd);
(*env)->ReleaseStringUTFChars(env, path, path_utf);
if(fd == -1)
{
/* Throw an exception */
LOGE("Cannot open port");
/* TODO: throw an exception */
returnNULL;
}
}
/* Configure device */
{
structtermios cfg;
LOGD("Configuring serial port");
if(tcgetattr(fd, &cfg))
{
LOGE("tcgetattr() failed");
close(fd);
/* TODO: throw an exception */
returnNULL;
}
cfmakeraw(&cfg);
cfsetispeed(&cfg, speed);
cfsetospeed(&cfg, speed);
if(tcsetattr(fd, TCSANOW, &cfg))
{
LOGE("tcsetattr() failed");
close(fd);
/* TODO: throw an exception */
returnNULL;
}
}
(二)FileDescritor:
文件描述符类的实例用作与基础机器有关的某种结构的不透明句柄,该结构表示开放文件、开放套接字或者字节的另一个源或接收者。文件描述符的主要实际用途是创建一个包含该结构的FileInputStream 或FileOutputStream。这是API的描述,不太好理解,其实可简单的理解为:FileDescritor就是对一个文件进行读写。
(三)实现串口通信细节
1) 建工程:SerialDemo包名:org.winplus.serial,并在工程目录下新建jni和libs两个文件夹和一个org.winplus.serial.utils,如下图:
2) 新建一个类:SerialPortFinder,添加如下代码:
packageorg.winplus.serial.utils;
importjava.io.File;
importjava.io.FileReader;
importjava.io.IOException;
importjava.io.LineNumberReader;
importjava.util.Iterator;
importjava.util.Vector;
importandroid.util.Log;
publicclassSerialPortFinder {
privatestaticfinalString TAG ="SerialPort";
privateVector mDrivers =null;
publicclassDriver {
publicDriver(String name, String root) {
mDriverName = name;
mDeviceRoot = root;
}
privateString mDriverName;
privateString mDeviceRoot;
Vector mDevices = null;
publicVector getDevices() {
if(mDevices ==null) {
mDevices = newVector();
File dev = newFile("/dev");
File[] files = dev.listFiles();
inti;
for(i =0; i
if(files[i].getAbsolutePath().startsWith(mDeviceRoot)) {
Log.d(TAG, "Found new device: "+ files[i]);
mDevices.add(files[i]);
}
}
}
returnmDevices;
}
publicString getName() {
returnmDriverName;
}
}
Vector getDrivers() throwsIOException {
if(mDrivers ==null) {
mDrivers = newVector();
LineNumberReader r = newLineNumberReader(newFileReader(
"/proc/tty/drivers"));
String l;
while((l = r.readLine()) !=null) {
// Issue 3:
// Since driver name may contain spaces, we do not extract
// driver name with split()
String drivername = l.substring(0,0x15).trim();
String[] w = l.split(" +");
if((w.length >=5) && (w[w.length -1].equals("serial"))) {
Log.d(TAG, "Found new driver "+ drivername +" on "
+ w[w.length - 4]);
mDrivers.add(newDriver(drivername, w[w.length -4]));
}
}
r.close();
}
returnmDrivers;
}
publicString[] getAllDevices() {
Vector devices = newVector();
// Parse each driver
Iterator itdriv;
try{
itdriv = getDrivers().iterator();
while(itdriv.hasNext()) {
Driver driver = itdriv.next();
Iterator itdev = driver.getDevices().iterator();
while(itdev.hasNext()) {
String device = itdev.next().getName();
String value = String.format("%s (%s)", device,
driver.getName());
devices.add(value);
}
}
} catch(IOException e) {
e.printStackTrace();
}
returndevices.toArray(newString[devices.size()]);
}
publicString[] getAllDevicesPath() {
Vector devices = newVector();
// Parse each driver
Iterator itdriv;
try{
itdriv = getDrivers().iterator();
while(itdriv.hasNext()) {
Driver driver = itdriv.next();
Iterator itdev = driver.getDevices().iterator();
while(itdev.hasNext()) {
String device = itdev.next().getAbsolutePath();
devices.add(device);
}
}
} catch(IOException e) {
e.printStackTrace();
}
returndevices.toArray(newString[devices.size()]);
}
}
3)新建SerialPort类,这个类主要用来加载SO文件,通过JNI的方式打开关闭串口
packageorg.winplus.serial.utils;
importjava.io.File;
importjava.io.FileDescriptor;
importjava.io.FileInputStream;
importjava.io.FileOutputStream;
importjava.io.IOException;
importjava.io.InputStream;
importjava.io.OutputStream;
importandroid.util.Log;
publicclassSerialPort {
privatestaticfinalString TAG ="SerialPort";
/*
* Do not remove or rename the field mFd: it is used by native method
* close();
*/
privateFileDescriptor mFd;
privateFileInputStream mFileInputStream;
privateFileOutputStream mFileOutputStream;
publicSerialPort(File device,intbaudrate,intflags)
throwsSecurityException, IOException {
/* Check access permission */
if(!device.canRead() || !device.canWrite()) {
try{
/* Missing read/write permission, trying to chmod the file */
Process su;
su = Runtime.getRuntime().exec("/system/bin/su");
String cmd = "chmod 666 "+ device.getAbsolutePath() +"\n"
+ "exit\n";
su.getOutputStream().write(cmd.getBytes());
if((su.waitFor() !=0) || !device.canRead()
|| !device.canWrite()) {
thrownewSecurityException();
}
} catch(Exception e) {
e.printStackTrace();
thrownewSecurityException();
}
}
mFd = open(device.getAbsolutePath(), baudrate, flags);
if(mFd ==null) {
Log.e(TAG, "native open returns null");
thrownewIOException();
}
mFileInputStream = newFileInputStream(mFd);
mFileOutputStream = newFileOutputStream(mFd);
}
// Getters and setters
publicInputStream getInputStream() {
returnmFileInputStream;
}
publicOutputStream getOutputStream() {
returnmFileOutputStream;
}
// JNI
privatenativestaticFileDescriptor open(String path,intbaudrate,
intflags);
publicnativevoidclose();
static{
System.loadLibrary("serial_port");
}
}
4) 新建一个Application 继承android.app.Application,用来对串口进行初始化和关闭串口
packageorg.winplus.serial;
importjava.io.File;
importjava.io.IOException;
importjava.security.InvalidParameterException;
importorg.winplus.serial.utils.SerialPort;
importorg.winplus.serial.utils.SerialPortFinder;
importandroid.content.SharedPreferences;
publicclassApplicationextendsandroid.app.Application {
publicSerialPortFinder mSerialPortFinder =newSerialPortFinder();
privateSerialPort mSerialPort =null;
publicSerialPort getSerialPort()throwsSecurityException, IOException, InvalidParameterException {
if(mSerialPort ==null) {
/* Read serial port parameters */
SharedPreferences sp = getSharedPreferences("android_serialport_api.sample_preferences", MODE_PRIVATE);
String path = sp.getString("DEVICE","");
intbaudrate = Integer.decode(sp.getString("BAUDRATE","-1"));
/* Check parameters */
if( (path.length() ==0) || (baudrate == -1)) {
thrownewInvalidParameterException();
}
/* Open the serial port */
mSerialPort = newSerialPort(newFile(path), baudrate,0);
}
returnmSerialPort;
}
publicvoidcloseSerialPort() {
if(mSerialPort !=null) {
mSerialPort.close();
mSerialPort = null;
}
}
}
5) 新建一个继承抽象的Activity类,主要用于读取串口的信息
packageorg.winplus.serial;
importjava.io.IOException;
importjava.io.InputStream;
importjava.io.OutputStream;
importjava.security.InvalidParameterException;
importorg.winplus.serial.utils.SerialPort;
importandroid.app.Activity;
importandroid.app.AlertDialog;
importandroid.content.DialogInterface;
importandroid.content.DialogInterface.OnClickListener;
importandroid.os.Bundle;
publicabstractclassSerialPortActivityextendsActivity {
protectedApplication mApplication;
protectedSerialPort mSerialPort;
protectedOutputStream mOutputStream;
privateInputStream mInputStream;
privateReadThread mReadThread;
privateclassReadThreadextendsThread {
@Override
publicvoidrun() {
super.run();
while(!isInterrupted()) {
intsize;
try{
byte[] buffer =newbyte[64];
if(mInputStream ==null)
return;
/**
* 这里的read要尤其注意,它会一直等待数据,等到天荒地老,海枯石烂。如果要判断是否接受完成,只有设置结束标识,或作其他特殊的处理。
*/
size = mInputStream.read(buffer);
if(size >0) {
onDataReceived(buffer, size);
}
} catch(IOException e) {
e.printStackTrace();
return;
}
}
}
}
privatevoidDisplayError(intresourceId) {
AlertDialog.Builder b = newAlertDialog.Builder(this);
b.setTitle("Error");
b.setMessage(resourceId);
b.setPositiveButton("OK",newOnClickListener() {
publicvoidonClick(DialogInterface dialog,intwhich) {
SerialPortActivity.this.finish();
}
});
b.show();
}
@Override
protectedvoidonCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mApplication = (Application) getApplication();
try{
mSerialPort = mApplication.getSerialPort();
mOutputStream = mSerialPort.getOutputStream();
mInputStream = mSerialPort.getInputStream();
/* Create a receiving thread */
mReadThread = newReadThread();
mReadThread.start();
} catch(SecurityException e) {
DisplayError(R.string.error_security);
} catch(IOException e) {
DisplayError(R.string.error_unknown);
} catch(InvalidParameterException e) {
DisplayError(R.string.error_configuration);
}
}
protectedabstractvoidonDataReceived(finalbyte[] buffer,finalintsize);
@Override
protectedvoidonDestroy() {
if(mReadThread !=null)
mReadThread.interrupt();
mApplication.closeSerialPort();
mSerialPort = null;
super.onDestroy();
}
}
6)编写string.xml 以及baudrates.xml文件
在string.xml文件中添加:
Please configure your serial port first.
You do not have read/write permission to the serial port.
The serial port can not be opened for an unknown reason.
在baudrates.xml文件中添加
50
75
110
134
150
200
300
600
1200
1800
2400
4800
9600
19200
38400
57600
115200
230400
460800
500000
576000
921600
1000000
1152000
1500000
2000000
2500000
3000000
3500000
4000000
50
75
110
134
150
200
300
600
1200
1800
2400
4800
9600
19200
38400
57600
115200
230400
460800
500000
576000
921600
1000000
1152000
1500000
2000000
2500000
3000000
3500000
4000000
7)开始编写界面了:在main.xml布局文件中添加两个编辑框,一个用来发送命令,一个用来接收命令:
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:orientation="vertical">
android:id="@+id/EditTextReception"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
android:layout_weight="1"
android:gravity="top"
android:hint="Reception"
android:isScrollContainer="true"
android:scrollbarStyle="insideOverlay">
android:id="@+id/EditTextEmission"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:hint="Emission"
android:lines="1">
8) SerialDemoActivity类的实现:
packageorg.winplus.serial;
importjava.io.IOException;
importandroid.os.Bundle;
importandroid.view.KeyEvent;
importandroid.widget.EditText;
importandroid.widget.TextView;
importandroid.widget.TextView.OnEditorActionListener;
publicclassSerialDemoActivityextendsSerialPortActivity{
EditText mReception;
@Override
protectedvoidonCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// setTitle("Loopback test");
mReception = (EditText) findViewById(R.id.EditTextReception);
EditText Emission = (EditText) findViewById(R.id.EditTextEmission);
Emission.setOnEditorActionListener(newOnEditorActionListener() {
publicbooleanonEditorAction(TextView v,intactionId, KeyEvent event) {
inti;
CharSequence t = v.getText();
char[] text =newchar[t.length()];
for(i=0; i
text[i] = t.charAt(i);
}
try{
mOutputStream.write(newString(text).getBytes());
mOutputStream.write('\n');
} catch(IOException e) {
e.printStackTrace();
}
returnfalse;
}
});
}
@Override
protectedvoidonDataReceived(finalbyte[] buffer,finalintsize) {
runOnUiThread(newRunnable() {
publicvoidrun() {
if(mReception !=null) {
mReception.append(newString(buffer,0, size));
}
}
});
}
}
写到这里,代码基本上写完了。下面就是要实现JNI层的功能了,要实现JNI,必须首先生成头文件,头文件的生成方式也很简单, 我们编译工程,在终端输入 javah org.winplus.serial.utils.SerialPort 则会生成头文件:org_winplus_serial_utils_SerialPort.h,这个头文件的名字可以随意命名。我们将它命名为:SerialPort.h拷贝到新建的目录jni中,新建SerialPort.c
文件,这两个文件的代码就不贴出来了。直接到上传的代码中看吧。
(四)串口的应用,可实现扫描头,指纹识别等外围USB转串口的特色应用。
还蛮繁琐的,以上只是对开源项目android-serialport-api 进行精简想了解此项目请点击此处!就这样吧,晚了准备见周公去!
原创文章,转载请注明出处:http://www.blog.csdn.net/tangcheng_ok