最近由于项目需要,花了两天时间在Android平台下编写了一个串口助手软件。硬件平台是友善之臂的tiny210开发板。起初的想法是首先基于Linux驱动做一些修改,然后自行编写HAL层代码,最后编写Android应用程序调用HAL Stub来实现和串口通信。后来在网上看到友善之臂为Android系统操作硬件资源专门开发了一个库文件:libfriendlyarm-hardware.so,通过它我们可以很方便的操作串口。于是对这个文件深入了解了一下。

网上可以搜出很多关于这个文件用法的博客,但是全部都是同样的内容,也不知谁是原创。并且博客中的代码个人觉得有些地方略显多余,亲测了一下,串口程序会有明显的卡顿(也许是本人开发板硬件条件问题),于是自己按照官方的接口说明编写了一个程序。测试通过之后总算搞定,现在把我的过程和源代码分享给大家,希望能帮到大家。(工程源码GitHub地址见文章结尾处)

1、硬件连接

首先我们要用串口线连接PC和开发板,注意需要用交叉线相连。可以用友善自带Android系统中的串口助手测试一下,保证串口的线路通畅

2、部署库文件

这里按照配套光盘里的开发板用户手册4.2.1节介绍的方法部署(点击可下载)。

  1. 首先进入工程目录,在libs文件下新建armeabi文件夹,然后把libfriendlyrm-hardware.so文件放入此文件夹下。
  2. 然后在eclipse中src目录下新建一个包,包名为com.friendlyarm.AndroidSDK,并新建名为HardwareControler.java的文件,写入以下内容:
package com.friendlyarm.AndroidSDK;
import android.util.Log
public class HardwareControler
{ 
//Serial Port
 static public native int openSerialPort( String devName, long baud, int dataBits, int stopBits );      static public native int write(int fd, byte[] data);
 static public native int read(int fd, byte[] buf, int len);
 static public native int select(int fd, int sec, int usec);
 static public native void close(int fd);
 static {
          try {
                 System.loadLibrary("friendlyarm-hardware");
                } catch (UnsatisfiedLinkError e) {
                        Log.d("HardwareControler", "libfriendlyarm-hardware library not found!");
    }
}
}

部署完后,右键工程→fresh,可以看到如下图所示选中的四个文件:



部署完毕

  1. 接下来就可以新建我们的应用代码了。在代码开头导入 com.friendlyarm.AndroidSDK.HardwareControler就可以。

3、布局文件

工程比较简单,这里只需要一个布局文件即可。我只用了一个接收显示区,一个发送显示区和关闭、打开、发送、清空四个按钮。布局文件代码如下:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:baselineAligned="false"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="horizontal"
    android:paddingBottom="@dimen/activity_vertical_margin"
    android:paddingLeft="@dimen/activity_horizontal_margin"
    android:paddingRight="@dimen/activity_horizontal_margin"
    android:paddingTop="@dimen/activity_vertical_margin"
    tools:context=".HardwareControler" 
    android:background="@android:color/holo_green_dark">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_weight="1"
        android:orientation="vertical" >

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/receive_textview" />

        <TextView
            android:id="@+id/rev_tv"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:background="@android:color/darker_gray" />
    </LinearLayout>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_marginLeft="10dp"
        android:layout_weight="1"
        android:orientation="vertical" >

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/send_edittext" />

        <EditText
            android:hint="@string/data_to_send"
            android:id="@+id/send_et"
            android:layout_width="match_parent"
            android:layout_height="60dp"
            android:background="@android:color/darker_gray" />

        <RelativeLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:gravity="center"
            android:orientation="horizontal" >

            <Button
                android:id="@+id/openSerial_bt"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_margin="20dp"
                android:text="@string/open_serial" />

            <Button
                android:id="@+id/closeSerial_bt"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_toRightOf="@id/openSerial_bt"
                android:layout_alignTop="@id/openSerial_bt"
                android:text="@string/close_serial"
                android:enabled="false" />

            <Button
                android:id="@+id/sendSerial_bt"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_alignLeft="@id/openSerial_bt"
                android:layout_below="@id/openSerial_bt"
                android:text="@string/send_data" />

            <Button
                android:id="@+id/clear_bt"
                android:layout_marginLeft="20dp"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:layout_alignTop="@id/sendSerial_bt"
                android:layout_toRightOf="@id/sendSerial_bt"
                android:text="@string/clear_data" />
        </RelativeLayout>
    </LinearLayout>

</LinearLayout>

我使用的是7寸的横屏,大家可以按照自己的屏幕来适配不同的代码。

4、Java代码编写

首先需要了解库文件为我们提供的接口函数,文档里有详细的解释:

  • int openSerialPort( String devName, long baud, int dataBits, int stopBits )
    打开指定的串口设备,并返回文件描述符。
  • int write( int fd, byte[] data)
    向打开的设备或文件中写数据。
  • int read( int fd, byte[] buf, int len)
    从打开的设备或文件中读取数据。buf是接收缓存,len是需要接收的字节数,函数返回实际接收的字节数。
  • int select( int fd, int sec, int usec)
    查询打开的设备或文件是否有数据可读。
  • void close(int fd)
    关闭指定的文件描述符。

代码说明:
首先用户点击打开按键,此时会开启监听进程通过select函数不断监听是否有数据进来,如果有,则通过handler发送消息通知主线程显示。如下:

openSerial.setOnClickListener(new Button.OnClickListener()
        {
            @Override
            public void onClick(View v)
            {
                fd = HardwareControler.openSerialPort("/dev/s3c2410_serial3",
                        115200, 8, 1);
                openFlag = true;
                Toast.makeText(getApplicationContext(),
                        getString(R.string.open_sucssess), Toast.LENGTH_SHORT)
                        .show();
                openSerial.setEnabled(false);
                closeSerial.setEnabled(true);

                /**
                 * 启动线程监听数据
                 */
                listen = new Thread(new Runnable()
                {
                    @Override
                    public void run()
                    {
                        while (openFlag)
                        {
                            int m = HardwareControler.select(fd, 2, 20);
                            int n;
                            String text = "";
                            if (m == 1)
                            {
                                while ((n = HardwareControler.read(fd, buf,
                                        buf.length)) > 0)
                                {
                                    try
                                    {
                                        Thread.sleep(90);                // 睡眠等待数据完全接收
                                    } catch (InterruptedException e)
                                    {
                                        e.printStackTrace();
                                    }
                                    for (int i = 0; i < n; i++)
                                    {
                                        text += (char) buf[i];
                                    }
                                };
                                Log.d("MC", "n:" + n);
                                Message message = Message.obtain();
                                message.obj = text;
                                revHandler.sendMessage(message);
                                System.out.println(Arrays.toString(buf));
                            }
                            try
                            {
                                Thread.sleep(1000);
                            } catch (InterruptedException e)
                            {
                                e.printStackTrace();
                            }
                        }
                    }
                });
                listen.start();
            }
        });

这里需要注意的是:在while反复判断read返回值时,需要有一个短暂的睡眠以等待数据全部进入串口驱动程序,否则会出现数据间断的情况。此时,用户可以随时通过发送按键讲发送框里的数据发送出去,代码如下:

public void SendSerial()
    {
        HardwareControler.write(fd, send_et.getText().toString().getBytes());
    }
/**
 * 发送数据
 */
    sendSerial.setOnClickListener(new Button.OnClickListener()
    {
        public void onClick(View v)
        {
            SendSerial();
        }
    });

最后关闭串口:

/**
* 关闭串口
 */
    closeSerial.setOnClickListener(new Button.OnClickListener()
    {
        @Override
        public void onClick(View v)
        {
            HardwareControler.close(fd);
            openFlag = false;
            openSerial.setEnabled(true);
            closeSerial.setEnabled(false);
            Toast.makeText(getApplicationContext(),
                    getString(R.string.close_sucssess), Toast.LENGTH_SHORT)
                    .show();
        }
    });

到这里,基本的功能已经全部实现,亲测之后对于功能上还算过关,界面比较粗糙。欢迎各位朋友对代码进行修正补缺,有什么问题也可以给我留言,一起探讨。


最后,需要完整源码和demo安装包的朋友,可以给我留言。

谢谢

tiny210开发板用户手册下载:
http://yun.baidu.com/share/link?shareid=2019636114&uk=67973003