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

使用C#调用传统32位API实现串口操作,整个结构特别的简单。接收数据只需要定义数据接收事件即可。

上传源代码我不会,需要源代码的请与我([email protected])联系。你也可以教我怎么上传源代码。


using System;
using System.Runtime.InteropServices;

///


/// (C)2003-2005 C2217 Studio  保留所有权利
///
/// 文件名称:     IbmsSerialPort.cs
/// 文件ID:
/// 文件说明:
///         封装动态链接库IbmsSerialPort.dll的功能,提供在.NET环境中
///         串口异步接收和发送数据的功能。
///     
/// 当前版本:   1.0
///
/// 作者:    邓杨均
/// 创建日期:   2005-2-2
/// 最后修改日期: 2005-2-2
///
/// 历史修改记录:
///
///


namespace Ibms.Tool.IO
{
 
 ///


 /// 当串口接收到数据时,会产生一个事件。
 /// SPRecvDataArgs就是该事件的参数,参数中的RecvData包含接收到的数据。
 /// 使用方法:
 ///

 public class SPRecvDataArgs:EventArgs
 {
  ///
  /// 接收到的数据组成的字节数组
  ///

  private byte[] recvData;

  ///


  /// 构造函数,需要一个包含数据的byte[]作为初始化参数来实例化 SPRecvDataArgs
  ///

  /// 接收到的数据
  public SPRecvDataArgs(byte[] recvData)
  {
   if( recvData == null)
   {
    throw(new ArgumentNullException());
   }

   this.recvData = recvData;
  }

  ///


  /// 返回接收到的数据内容
  ///

  public byte[] RecvData
  {
   get
   {
    return recvData;
   }
  }
 }


 ///


 /// 封装动态链接库IbmsSerialPort.dll的功能,提供在.NET环境中异步
 /// 串口接收和发送功能。特别实现的是异步通过信号自动接收数据的模式。
 ///

 public class IbmsSerialPort:IDisposable
 {

#region 平台调用声明代码

  ///


  /// 声明IbmsSerialPort.dll的Ibms_OpenPort函数
  ///

  /// 串口号
  /// 波特率
  ///
  [DllImport("IbmsSerialPort.dll")]
  public static extern IntPtr Ibms_OpenPort(int nPort, int nRate);

  ///


  /// 声明IbmsSerialPort.dll的Ibms_Close函数
  ///

  [DllImport("IbmsSerialPort.dll")]
  public static extern void Ibms_Close( IntPtr port);

  ///


  /// 声明IbmsSerialPort.dll的Ibms_SendData函数
  ///

  ///
  ///
  ///
  [DllImport("IbmsSerialPort.dll")]
  public static extern bool Ibms_SendData( IntPtr port, byte[] data,int nDataSize);
 
  ///
  /// 声明IbmsSerialPort.dll的Ibms_SetFuncHandle函数
  ///

  ///
  [DllImport("IbmsSerialPort.dll")]
  public static extern void Ibms_SetFuncHandle( IntPtr port, HandleFunc handDataFunc);

#endregion
   
#region 定义字段

  ///


  /// 定义数据处理委托,作为API的函数指针传入动态链接库
  ///

  public delegate void HandleFunc(IntPtr pData, int nDataSize);

  ///


  /// 定义数据接收事件的原型
  ///

  public delegate void RecvData(object sender,SPRecvDataArgs e);

  ///


  /// 定义数据接收事件
  ///

  public event RecvData OnRecvData;

  ///


  /// 串口处理接收数据的委托
  ///

  private HandleFunc _handleDataFunc;

  ///


  /// 串口的编号,从1开始的整数,最大255
  ///

  private int port;

  ///


  /// 串口所支持的波特率,必须是标准波特率之一
  ///

  private StanderdRate rate;

  ///


  /// 串口当前的打开状态
  ///

  private bool openStatus=false;

  ///


  /// 串口句柄
  ///

  private IntPtr portHandle;

  #region 定义标准的串口波特率

  ///


  /// 标准的波特率
  ///

  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 定义方法

  ///


  /// 构造函数
  ///

  public IbmsSerialPort()
  {
   portHandle = (IntPtr)0;

   _handleDataFunc = new HandleFunc(OnDllRecvData);
  }

  ///


  /// 打开串口
  ///

  /// 串口号
  /// 波特率
  /// /// 抛出应用程序异常,包换错误描述
  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;

  }


  ///


  /// 关闭串口
  ///

  public void Close()
  {
   if( openStatus )
   {
    Ibms_Close( portHandle);

   }

   openStatus = false;

  }
 

  ///


  /// 发送数据
  ///

  /// 数据内容
  /// 抛出应用程序异常,包换错误描述
  public void SendData( byte[] data )
  {
   if( !openStatus )
   {
    throw( new ApplicationException("串口没有打开,发送数据失败") );
   }

   if( !Ibms_SendData( portHandle, data, data.Length ) )
   {
    throw( new ApplicationException("串口发送数据失败") );
   }
  }
 
  ///


  /// 处理接收到的串口数据
  ///

  /// 串口数据接收缓冲区首地址
  /// 数据大小,一般数据大小不超过2K
  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   {
    data[i]= pData[i];
   }

   //激发事件
   OnRecvData( this, new SPRecvDataArgs(data) );

  }


#endregion

#region 定义属性

  ///


  /// 返回当前的串口号
  ///

  public int Port
  {
   get
   {
    return port;
   }
  }

  ///


  /// 返回当前串口的波特率
  ///

  public StanderdRate Rate
  {
   get
   {
    return rate;
   }
  }

  ///


  /// 返回当前串口的状态
  ///

  public bool OpenStatus
  {
   get
   {
    return openStatus;
   }
  }


#endregion
  

#region 非托管资源的及时释放
  
  ///


  /// 因为包含了非托管的资源(占用系统串口),必须实现IDisposable接口
  /// 在使用完该类的时候,必须记得调用Dispose(),回收系统资源
  ///
  ///
  /// 方法1
  /// {
  ///  SerialPort port =new SerialPort();
  ///  ...
  ///  //在try-catch-finaly的finaly中释放资源
  ///  
  ///  port.Dispose();
  /// }
  ///
  /// 方法2
  /// using( SerialPort port = new SerialPort())
  /// {
  ///  ...
  /// }
  /// 变量超出作用域时会自动调用其Dispose()方法
  ///
  ///

  ///

  ~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

 }
 
}

你可能感兴趣的:(C#技术,c#,byte,exception,class,.net,api)