C#异步数据接收串口操作类

最新推荐文章于 2023-11-22 12:22:19 发布
zggxyx2004
最新推荐文章于 2023-11-22 12:22:19 发布
阅读量6.7k
点赞数
分类专栏： C#/VC++ 文章标签： c# byte .net api null 平台
C#/VC++ 专栏收录该内容
28 篇文章 0 订阅
订阅专栏
 
 使用C#调用传统32位API实现串口操作，整个结构特别的简单。接收数据只需要定义数据接收事件即可。
上传源代码我不会，需要源代码的请与我(dyj057@gmail.com)联系。你也可以教我怎么上传源代码。
using System;
using System.Runtime.InteropServices;
/// <summary> 
/// (C)2003-2005 C2217 Studio  保留所有权利 
///  
/// 文件名称:     IbmsSerialPort.cs 
/// 文件ID: 
/// 文件说明: 
///         封装动态链接库IbmsSerialPort.dll的功能，提供在.NET环境中 
///         串口异步接收和发送数据的功能。 
///       
/// 当前版本:   1.0 
///  
/// 作者:    邓杨均 
/// 创建日期:   2005-2-2  
/// 最后修改日期: 2005-2-2 
///  
/// 历史修改记录: 
///  
/// </summary> 
namespace Ibms.Tool.IO
{
 /// <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());
   }
   this.recvData = recvData;
  }
  /// <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> 
  /// 声明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> 
  /// 声明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> 
  /// 定义数据接收事件的原型 
  /// </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;
  /// <summary> 
  /// 串口句柄 
  /// </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 
#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());
   }
   port = nPort;
   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> 
  /// <param name="sendData">数据内容</param> 
  /// <exception cref="ApplicationException">抛出应用程序异常,包换错误描述</exception> 
  public void SendData( byte[] data )
  {
   if( !openStatus )
   {
    throw( new ApplicationException("串口没有打开,发送数据失败") );
   }
   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;
   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 rate;
   }
  }
  /// <summary> 
  /// 返回当前串口的状态 
  /// </summary> 
  public bool OpenStatus
  {
   get
   {
    return openStatus;
   }
  } 
#endregion 
  
#region 非托管资源的及时释放 
  
  /// <summary> 
  /// 因为包含了非托管的资源(占用系统串口),必须实现IDisposable接口 
  /// 在使用完该类的时候,必须记得调用Dispose(),回收系统资源 
  /// <example> 
  ///  
  /// 方法1 
  /// { 
  ///  SerialPort port =new SerialPort(); 
  ///  ... 
  ///  //在try-catch-finaly的finaly中释放资源 
  ///   
  ///  port.Dispose(); 
  /// } 
  ///  
  /// 方法2 
  /// using( SerialPort port = new SerialPort()) 
  /// { 
  ///  ... 
  /// } 
  /// 变量超出作用域时会自动调用其Dispose()方法 
  ///  
  /// </example> 
  /// </summary> 
  ~IbmsSerialPort()
  {
   Dispose( false );
  }
  protected virtual void Dispose( bool disposing )
  {
   if( disposing )
   {
    //清理托管的对象 
   }
   //清理非托管的资源 
   Close();
  } 
  #region IDisposable 成员 
  public void Dispose()
  {
   // TODO:  添加 SerialPort.Dispose 实现 
   Dispose( true );
   GC.SuppressFinalize(this);
  } 
  #endregion 
#endregion 
 }
}
 