本文介绍了一个简单的通过串口实现全双工通讯的Java类库,该类库大大的简化了对串口进行操作的过程
一个嵌入式系统通常需要通过串口与其主控系统进行全双工通讯,譬如一个流水线控制系统需要不断的接受从主控系统发送来的查询和控制信息,并将执行结果或查询结果发送回主控系统。本文介绍了一个简单的通过串口实现全双工通讯的Java类库,该类库大大的简化了对串口进行操作的过程。
本类库主要包括:SerialBean.java(与其他应用程序的接口),SerialBuffer.java(用来保存从串口所接收数据的缓冲区),ReadSerial.java(从串口读取数据的程序)。另外本类库还提供了一个例程SerialExample.java作为示范。在下面的内容中将逐一对这几个部分进行详细介绍。
1.SerialBean
SerialBean是本类库与其他应用程序的接口。该类库中定义了SerialBean的构造方法以及初始化串口,从串口读取数据,往串口写入数据以及关闭串口的函数。具体介绍如下:
publicSerialBean(intPortID)
本函数构造一个指向特定串口的SerialBean,该串口由参数PortID所指定。PortID=1表示COM1,PortID=2表示COM2,由此类推。
publicintInitialize()
本函数初始化所指定的串口并返回初始化结果。如果初始化成功返回1,否则返回-1。初始化的结果是该串口被SerialBean独占性使用,其参数被设置为9600,N,8,1。如果串口被成功初始化,则打开一个进程读取从串口传入的数据并将其保存在缓冲区中。
publicStringReadPort(intLength)
本函数从串口(缓冲区)中读取指定长度的一个字符串。参数Length指定所返回字符串的长度。
publicvoidWritePort(StringMsg)
本函数向串口发送一个字符串。参数Msg是需要发送的字符串。
publicvoidClosePort()
本函数停止串口检测进程并关闭串口。
SerialBean的源代码如下:
packageserial;
importjava.io.*;
importjava.util.*;
importjavax.comm.*;
/**
*
*Thisbeanprovidessomebasicfunctionstoimplementfulldulplex
*informationexchangethroughthesrialport.
*
*/
publicclassSerialBean
{
staticStringPortName;
CommPortIdentifierportId;
SerialPortserialPort;
staticOutputStreamout;
staticInputStreamin;
SerialBufferSB;
ReadSerialRT;
/**
*
*Constructor
*
*@paramPortIDtheIDoftheserialtobeused.1forCOM1,
*2forCOM2,etc.
*
*/
publicSerialBean(intPortID)
{
PortName="COM"+PortID;
}
/**
*
*Thisfunctioninitializetheserialportforcommunication.Itstartsa
*threadwhichconsistentlymonitorstheserialport.Anysignalcaptured
*fromtheserialportisstoredintoabufferarea.
*
*/
publicintInitialize()
{
intInitSuccess=1;
intInitFail=-1;
try
{
portId=CommPortIdentifier.getPortIdentifier(PortName);
try
{
serialPort=(SerialPort)
portId.open("Serial_Communication",2000);
}catch(PortInUseExceptione)
{
returnInitFail;
}
//UseInputStreamintoreadfromtheserialport,andOutputStream
//outtowritetotheserialport.
try
{
in=serialPort.getInputStream();
out=serialPort.getOutputStream();
}catch(IOExceptione)
{
returnInitFail;
}
//Initializethecommunicationparametersto9600,8,1,none.
try
{
serialPort.setSerialPortParams(9600,
SerialPort.DATABITS_8,
SerialPort.STOPBITS_1,
SerialPort.PARITY_NONE);
}catch(UnsupportedCommOperationExceptione)
{
returnInitFail;
}
}catch(NoSuchPortExceptione)
{
returnInitFail;
}
//whensuccessfullyopentheserialport,createanewserialbuffer,
//thencreateathreadthatconsistentlyacceptsincomingsignalsfrom
//theserialport.Incomingsignalsarestoredintheserialbuffer.
SB=newSerialBuffer();
RT=newReadSerial(SB,in);
RT.start();
//returnsuccessinformation
returnInitSuccess;
}
/**
*
*Thisfunctionreturnsastringwithacertainlengthfromtheincoming
*messages.
*
*@paramLengthThelengthofthestringtobereturned.
*
*/
publicStringReadPort(intLength)
{
StringMsg;
Msg=SB.GetMsg(Length);
returnMsg;
}
/**
*
*Thisfunctionsendsamessagethroughtheserialport.
*
*@paramMsgThestringtobesent.
*
*/
publicvoidWritePort(StringMsg)
{
intc;
try
{
for(inti=0;i<Msg.length();i++)
out.write(Msg.charAt(i));
}catch(IOExceptione){}
}
/**
*
*Thisfunctionclosestheserialportinuse.
*
*/
publicvoidClosePort()
{
RT.stop();
serialPort.close();
}
}
2.SerialBuffer
SerialBuffer是本类库中所定义的串口缓冲区,它定义了往该缓冲区中写入数据和从该缓冲区中读取数据所需要的函数。
publicsynchronizedStringGetMsg(intLength)
本函数从串口(缓冲区)中读取指定长度的一个字符串。参数Length指定所返回字符串的长度。
publicsynchronizedvoidPutChar(intc)
本函数望串口缓冲区中写入一个字符,参数c是需要写入的字符。
在往缓冲区写入数据或者是从缓冲区读取数据的时候,必须保证数据的同步,因此GetMsg和PutChar函数均被声明为synchronized并在具体实现中采措施实现的数据的同步。
SerialBuffer的源代码如下:
packageserial;
/**
*
*Thisclassimplementsthebufferareatostoreincomingdatafromtheserial
*port.
*
*/
publicclassSerialBuffer
{
privateStringContent="";
privateStringCurrentMsg,TempContent;
privatebooleanavailable=false;
privateintLengthNeeded=1;
/**
*
*Thisfunctionreturnsastringwithacertainlengthfromtheincoming
*messages.
*
*@paramLengthThelengthofthestringtobereturned.
*
*/
publicsynchronizedStringGetMsg(intLength)
{
LengthNeeded=Length;
notifyAll();
if(LengthNeeded>Content.length())
{
available=false;
while(available==false)
{
try
{
wait();
}catch(InterruptedExceptione){}
}
}
CurrentMsg=Content.substring(0,LengthNeeded);
TempContent=Content.substring(LengthNeeded);
Content=TempContent;
LengthNeeded=1;
notifyAll();
returnCurrentMsg;
}
/**
*
*Thisfunctionstoresacharactercapturedfromtheserialporttothe
*bufferarea.
*
*@paramtThecharvalueofthecharactertobestored.
*
*/
publicsynchronizedvoidPutChar(intc)
{
Characterd=newCharacter((char)c);
Content=Content.concat(d.toString());
if(LengthNeeded<Content.length())
{
available=true;
}
notifyAll();
}
}
3.ReadSerial
ReadSerial是一个进程,它不断的从指定的串口读取数据并将其存放到缓冲区中。
publicReadSerial(SerialBufferSB,InputStreamPort)
本函数构造一个ReadSerial进程,参数SB指定存放传入数据的缓冲区,参数Port指定从串口所接收的数据流。
publicvoidrun()
ReadSerial进程的主函数,它不断的从指定的串口读取数据并将其存放到缓冲区中。
ReadSerial的源代码如下:
packageserial;
importjava.io.*;
/**
*
*Thisclassreadsmessagefromthespecificserialportandsave
*themessagetotheserialbuffer.
*
*/
publicclassReadSerialextendsThread
{
privateSerialBufferComBuffer;
privateInputStreamComPort;
/**
*
*Constructor
*
*@paramSBThebuffertosavetheincomingmessages.
*@paramPortTheInputStreamfromthespecificserialport.
*
*/
publicReadSerial(SerialBufferSB,InputStreamPort)
{
ComBuffer=SB;
ComPort=Port;
}
publicvoidrun()
{
intc;
try
{
while(true)
{
c=ComPort.read();
ComBuffer.PutChar(c);
}
}catch(IOExceptione){}
}
}
4.SerialExample
SerialExample是本类库所提供的一个例程。它所实现的功能是打开串口COM1,对其进行初始化,从串口读取信息对其进行处理后将处理结果发送到串口。
importserial.*;
importjava.io.*;
/**
*
*ThisisanexampleofhowtousetheSerialBean.ItopensCOM1andreads
*sixmessageswithdifferentlengthformtheserialport.
*
*/
classSerialExample
{
publicstaticvoidmain(String[]args)
{
//TODO:AddyourJAVAcodeshere
SerialBeanSB=newSerialBean(1);
StringMsg;
SB.Initialize();
for(inti=5;i<=10;i++)
{
Msg=SB.ReadPort(i);
SB.WritePort("Reply:"+Msg);
}
SB.ClosePort();
}
}
5.编译与调试
本类库中使用了JavaCommunicationAPI(javax.comm)。这是一个Java扩展类库,并不包括在标准的JavaSDK当中。如果你尚未安装这个扩展类库的话,你应该从 Sun 公司的Java站点下载这个类库并将其安装在你的系统上。在所下载的包里面包括一个安装说明,如果你没有正确安装这个类库及其运行环境的话,运行这个程序的时候你会找不到串口。
正确安装JavaCommunicationAPI并将上述程序编译通过以后,你可以按如下方法测试这个程序。如果你只有一台机器,你可以利用一条RS-232电缆将COM1和COM2连接起来,在COM1上运行SerialExample,在COM2上运行Windows提供的超级终端程序。如果你有两台机器的话,你可以利用一条RS-232电缆将两台机器的COM1(或者是COM2)连接起来,在一端运行例程,另外一端运行Windows提供的超级终端程序。如果有必要的
话,可以对SerialExample中所声明的串口进行相应改动。
本程序在Windows2000+JavaSDK1.3环境下编译通过并成功运行。