用C#实现串口编程
向云
在C#中实现串口编程主要有两种方式:1、.NET2.0以后可以使用SerialPort类。2、使用Windows API来实现。下面分别用例子加以说明:
1、 使用Windows API
使用C#调用传统32位API实现串口操作,首先需要用DllImport声明API函数,例:
using System;
using System.Runtime.InteropServices;
/// <summary>
/// 文件说明:
/// 封装动态链接库IbmsSerialPort.dll的功能,提供在.NET环境中
/// 串口异步接收和发送数据的功能。
/// </summary>
using System.Runtime.InteropServices;
/// <summary>
/// 文件说明:
/// 封装动态链接库IbmsSerialPort.dll的功能,提供在.NET环境中
/// 串口异步接收和发送数据的功能。
/// </summary>
namespace Ibms.Tool.IO
{
/// <summary>
/// 当串口接收到数据时,会产生一个事件。
/// SPRecvDataArgs就是该事件的参数,参数中的RecvData包含接收到的数据。
/// 使用方法:
/// </summary>
public class SPRecvDataArgs:EventArgs
{
/// <summary>
/// 接收到的数据组成的字节数组
/// </summary>
private byte[] recvData;
{
/// <summary>
/// 当串口接收到数据时,会产生一个事件。
/// SPRecvDataArgs就是该事件的参数,参数中的RecvData包含接收到的数据。
/// 使用方法:
/// </summary>
public class SPRecvDataArgs:EventArgs
{
/// <summary>
/// 接收到的数据组成的字节数组
/// </summary>
private byte[] recvData;
/// <summary>
/// 构造函数,需要一个包含数据的byte[]作为初始化参数来实例化 SPRecvDataArgs
/// </summary>
/// <param name="recvData">接收到的数据</param>
public SPRecvDataArgs(byte[] recvData)
{
if( recvData == null)
{
throw(new ArgumentNullException());
}
vData = recvData;
}
/// <summary>
/// 构造函数,需要一个包含数据的byte[]作为初始化参数来实例化 SPRecvDataArgs
/// </summary>
/// <param name="recvData">接收到的数据</param>
public SPRecvDataArgs(byte[] recvData)
{
if( recvData == null)
{
throw(new ArgumentNullException());
}
vData = recvData;
}
/// <summary>
/// 返回接收到的数据内容
/// </summary>
public byte[] RecvData
{
get
{
return recvData;
}
}
}
/// <summary>
/// 封装动态链接库IbmsSerialPort.dll的功能,提供在.NET环境中异步
/// 串口接收和发送功能。特别实现的是异步通过信号自动接收数据的模式。
/// </summary>
/// </summary>
public byte[] RecvData
{
get
{
return recvData;
}
}
}
/// <summary>
/// 封装动态链接库IbmsSerialPort.dll的功能,提供在.NET环境中异步
/// 串口接收和发送功能。特别实现的是异步通过信号自动接收数据的模式。
/// </summary>
public class IbmsSerialPort:IDisposable
{
#region 平台调用声明代码
/// <summary>
/// 声明IbmsSerialPort.dll的Ibms_OpenPort函数
/// </summary>
/// <param name="nPort">串口号</param>
/// <param name="nRate">波特率</param>
/// <returns></returns>
[DllImport("IbmsSerialPort.dll")]
public static extern IntPtr Ibms_OpenPort(int nPort, int nRate);
/// <summary>
{
#region 平台调用声明代码
/// <summary>
/// 声明IbmsSerialPort.dll的Ibms_OpenPort函数
/// </summary>
/// <param name="nPort">串口号</param>
/// <param name="nRate">波特率</param>
/// <returns></returns>
[DllImport("IbmsSerialPort.dll")]
public static extern IntPtr Ibms_OpenPort(int nPort, int nRate);
/// <summary>
/// 声明IbmsSerialPort.dll的Ibms_Close函数
/// </summary>
[DllImport("IbmsSerialPort.dll")]
public static extern void Ibms_Close( IntPtr port);
/// <summary>
/// 声明IbmsSerialPort.dll的Ibms_SendData函数
/// </summary>
/// <param name="data"></param>
/// <param name="nDataSize"></param>
/// <returns></returns>
[DllImport("IbmsSerialPort.dll")]
public static extern bool Ibms_SendData( IntPtr port, byte[] data,int nDataSize);
/// <summary>
/// </summary>
[DllImport("IbmsSerialPort.dll")]
public static extern void Ibms_Close( IntPtr port);
/// <summary>
/// 声明IbmsSerialPort.dll的Ibms_SendData函数
/// </summary>
/// <param name="data"></param>
/// <param name="nDataSize"></param>
/// <returns></returns>
[DllImport("IbmsSerialPort.dll")]
public static extern bool Ibms_SendData( IntPtr port, byte[] data,int nDataSize);
/// <summary>
/// 声明IbmsSerialPort.dll的Ibms_SetFuncHandle函数
/// </summary>
/// <param name="handDataFunc"></param>
[DllImport("IbmsSerialPort.dll")]
public static extern void Ibms_SetFuncHandle( IntPtr port, HandleFunc handDataFunc);
#endregion
#region 定义字段
/// <summary>
/// 定义数据处理委托,作为API的函数指针传入动态链接库
/// </summary>
public delegate void HandleFunc(IntPtr pData, int nDataSize);
/// </summary>
/// <param name="handDataFunc"></param>
[DllImport("IbmsSerialPort.dll")]
public static extern void Ibms_SetFuncHandle( IntPtr port, HandleFunc handDataFunc);
#endregion
#region 定义字段
/// <summary>
/// 定义数据处理委托,作为API的函数指针传入动态链接库
/// </summary>
public delegate void HandleFunc(IntPtr pData, int nDataSize);
/// <summary>
/// 定义数据接收事件的原型
/// </summary>
public delegate void RecvData(object sender,SPRecvDataArgs e);
/// <summary>
/// 定义数据接收事件
/// </summary>
public event RecvData OnRecvData;
/// <summary>
/// 串口处理接收数据的委托
/// </summary>
private HandleFunc _handleDataFunc;
/// 定义数据接收事件的原型
/// </summary>
public delegate void RecvData(object sender,SPRecvDataArgs e);
/// <summary>
/// 定义数据接收事件
/// </summary>
public event RecvData OnRecvData;
/// <summary>
/// 串口处理接收数据的委托
/// </summary>
private HandleFunc _handleDataFunc;
/// <summary>
/// 串口的编号,从1开始的整数,最大255
/// </summary>
private int port;
/// <summary>
/// 串口所支持的波特率,必须是标准波特率之一
/// </summary>
private StanderdRate rate;
/// <summary>
/// 串口当前的打开状态
/// </summary>
private bool openStatus=false;
/// 串口的编号,从1开始的整数,最大255
/// </summary>
private int port;
/// <summary>
/// 串口所支持的波特率,必须是标准波特率之一
/// </summary>
private StanderdRate rate;
/// <summary>
/// 串口当前的打开状态
/// </summary>
private bool openStatus=false;
/// <summary>
/// 串口句柄
/// </summary>
private IntPtr portHandle;
#region 定义标准的串口波特率
/// <summary>
/// 标准的波特率
/// </summary>
public enum StanderdRate
{
R50=50,
R75=75,
R110=110,
/// 串口句柄
/// </summary>
private IntPtr portHandle;
#region 定义标准的串口波特率
/// <summary>
/// 标准的波特率
/// </summary>
public enum StanderdRate
{
R50=50,
R75=75,
R110=110,
R150=150,
R300=300,
R600=600,
R1200=1200,
R2400=2400,
R4800=4800,
R9600=9600,
R19200=19200,
R38400=38400,
R57600=57600,
R76800=76800,
R115200=115200
};
#endregion
R300=300,
R600=600,
R1200=1200,
R2400=2400,
R4800=4800,
R9600=9600,
R19200=19200,
R38400=38400,
R57600=57600,
R76800=76800,
R115200=115200
};
#endregion
#endregion
#region 定义方法
/// <summary>
/// 构造函数
/// </summary>
public IbmsSerialPort()
{
portHandle = (IntPtr)0;
_handleDataFunc = new HandleFunc(OnDllRecvData);
}
/// <summary>
/// 打开串口
/// </summary>
/// <param name="nPort">串口号</param>
/// <param name="nRate">波特率</param>
/// /// <exception cref="ApplicationException">抛出应用程序异常,包换错误描述</exception>
public void Open(int nPort, StanderdRate nRate)
{
if(nPort > 255 || nPort < 0)
{
throw(new ArgumentOutOfRangeException());
}
/// 打开串口
/// </summary>
/// <param name="nPort">串口号</param>
/// <param name="nRate">波特率</param>
/// /// <exception cref="ApplicationException">抛出应用程序异常,包换错误描述</exception>
public void Open(int nPort, StanderdRate nRate)
{
if(nPort > 255 || nPort < 0)
{
throw(new ArgumentOutOfRangeException());
}
port = nPort;
rate = nRate;
portHandle = Ibms_OpenPort( port, (int)rate );
if( (IntPtr)0 == portHandle )
{
throw( new ApplicationException("打开串口失败"));
}
//注册函数指针
Ibms_SetFuncHandle( portHandle, _handleDataFunc );
openStatus = true;
rate = nRate;
portHandle = Ibms_OpenPort( port, (int)rate );
if( (IntPtr)0 == portHandle )
{
throw( new ApplicationException("打开串口失败"));
}
//注册函数指针
Ibms_SetFuncHandle( portHandle, _handleDataFunc );
openStatus = true;
}
/// <summary>
/// 关闭串口
/// </summary>
public void Close()
{
if( openStatus )
{
Ibms_Close( portHandle);
}
openStatus = false;
/// <summary>
/// 关闭串口
/// </summary>
public void Close()
{
if( openStatus )
{
Ibms_Close( portHandle);
}
openStatus = false;
}
/// <summary>
/// 发送数据
/// </summary>
/// <param name="sendData">数据内容</param>
/// <exception cref="ApplicationException">抛出应用程序异常,包换错误描述</exception>
public void SendData( byte[] data )
{
if( !openStatus )
{
throw( new ApplicationException("串口没有打开,发送数据失败recv函数") );
}
if( !Ibms_SendData( portHandle, data, data.Length ) )
/// <summary>
/// 发送数据
/// </summary>
/// <param name="sendData">数据内容</param>
/// <exception cref="ApplicationException">抛出应用程序异常,包换错误描述</exception>
public void SendData( byte[] data )
{
if( !openStatus )
{
throw( new ApplicationException("串口没有打开,发送数据失败recv函数") );
}
if( !Ibms_SendData( portHandle, data, data.Length ) )
{
throw( new ApplicationException("串口发送数据失败") );
}
}
/// <summary>
/// 处理接收到的串口数据
/// </summary>
/// <param name="pData">串口数据接收缓冲区首地址</param>
/// <param name="nDataSize">数据大小,一般数据大小不超过2K</param>
unsafe protected void OnDllRecvData(IntPtr pUnhandleData, int nDataSize)
{
int dataSize= nDataSize ;
byte * pData =(byte *) pUnhandleData;
throw( new ApplicationException("串口发送数据失败") );
}
}
/// <summary>
/// 处理接收到的串口数据
/// </summary>
/// <param name="pData">串口数据接收缓冲区首地址</param>
/// <param name="nDataSize">数据大小,一般数据大小不超过2K</param>
unsafe protected void OnDllRecvData(IntPtr pUnhandleData, int nDataSize)
{
int dataSize= nDataSize ;
byte * pData =(byte *) pUnhandleData;
byte[] data = new byte[dataSize];
//复制数据到byte数组
for(int i=0; i<dataSize; i++)
{
data[i]= pData[i];
}
//激发事件
OnRecvData( this, new SPRecvDataArgs(data) );
}
#endregion
#region 定义属性
/// <summary>
/// 返回当前的串口号
/// </summary>
public int Port
{
get
{
return port;
}
}
/// <summary>
/// 返回当前串口的波特率
/// </summary>
public StanderdRate Rate
{
get
{
return
/// </summary>
public StanderdRate Rate
{
get
{
return
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论