现在的位置: 首页 > 自动控制 > 工业·编程 > 正文

C++ boost::asio::serial_port 串口通信类的使用 封装 笔记

2014-03-05 06:50 工业·编程 ⁄ 共 6834字 ⁄ 字号 暂无评论

串口一旦存在后,C++ boost::asio就当串口为一种流(文件流 )来使用。
C++的BOOST库中,通信库都在asio下,串口类结构为boost::asio::serial_port。串口通信由asio组件的serial_port类完成。BOOST库下的串口通信serial_port类的使用跟网络通信相似[网络通信 ],只是在进行串口通信前需要初始化串口。下面记录使用步骤:
1 serial_port类头文件和命名空间声明
#include  <boost/asio.hpp>
using namespace  boost::asio;
 
2 serial_port类实现串口通信步骤
(1) 定义io_service对象
io_service对象是使用boost::asio库的必有对象。
io_service io_s;
 
(2) 创建串口对象,传入io_service对象,打开串口
serial_port sp(  io_s , "COM1" );
io_s是步骤(1)中定义的io_service对象,COM1为串口名(计算机-->属性-->设备管理器-->端口)。一旦串口被打开,则此串口就会被当成流来被使用。
(1)如果串口端口不存在,则try-catch能够获取“系统找不到指定的文件”文件异常。
(2)如果串口端口没有和实际的串口连接,则try-catch能够获取“设备没有连接”的异常。
(3)如果在电脑之上连接一个串口线,则用此函数打开对应的端口(如COM4 )就不会出现以上两个异常。如果不在此串口下挂一个设备,则对端口进行读写操作的时候会出现异常,如读串口数据时会在read函数这里卡住。但如果在串口下挂一个设备如51单片机学习板则此函数会返回并读出一定的数据回来(虽不一定正确)。如果将挂在串口下的设备开启,try-catch会捕获“连接到系统上的设备没有发挥作用”或者是read函数又开始不能返回。
 
(3) 初始化
利用串口类对象初始化串口。串口类对象就是(2)中定义的sp,串口就是以上的参数COM1。
sp.set_option(  serial_port::baud_rate( 9600 ) );                         //比特率
sp.set_option(  serial_port::flow_control( serial_port::flow_control::none ) ); //流量控制
sp.set_option(  serial_port::parity( serial_port::parity::none ) );            //奇偶校验
sp.set_option( serial_port::stop_bits(  serial_port::stop_bits::one ) );        //停止位
sp.set_option(  serial_port::character_size( 8 ) );                       //数据位
 
(4) 调用serial_prot类的成员函数进行串口通信
如先前所述,serial_port类成功打开串口后,串口对于serial_port类来说就成了一种文件流。咱们就可以使用serial_port类中的成员函数往“流”写和读数据了。
向串口发送数据时是采用boost::asio::serial_port下含write字符串的函数将程序中的数据写入到串口流,接收串口数据时是用含read字符串的函数从串口读出数据,再放到程序变量中。比如用串口对象调用的write_some(),read_some()一类属于serial_port的成员函数,还有在函数内部指明串口对象的write(),read()等非serial_port类的成员函数,但它们是boost::asio下的函数。看名就知道“只写/读一些”的函数(比如读到空格或者其它特殊字符就会停止读下去)不如“写/读”函数功能完好。所以,咱都还是用write(),read()一类的函数从串口写、读完整的数据串吧。
 
[1]向串口写数据
write有4个重载( overload)函数,有2种都有接收异常的参数。[ VS中选中write函数-->右键-->Go To Definition F12 ]
size_t  data_len;
boost::system::error_code ec;
data_len        = write( *pSerialPort, buffer(data),  ec);
write()的第一个参数表示serial_port对象,第二个参数是写向(传输)串口的数据,第三个参数是boost库下的异常参数,如果write函数传输数据发生什么异常就会自动抛出此异常给catch。向串口成功传进数据则返回写入数据data的长度,buffer是boost库的函数,一般的参数都需要buffer一下。
 
[2]读/接收串口数据
如果直接用read函数来读取串口流中的数据,则read函数在读满变量内存后才会返回( char a[6],则会读满6个后才会返回 )。而且返回输出字符串的时候还是乱码。如此使用read函数就会阻塞后面代码的执行。
如此,可以使用异步读取/接收串口的方式:就算未完全读/接收到串口数据,异步读取函数依旧会马上返回执行后续代码,等串口数据读取完毕或者发生异常时io_service::run()函数会等待异步读取串口的数据操作,然后调用异步函数指定的回调函数。
提到异步操作,它包含三部分:
异步操作函数。
异步操作函数以形参方式指定的回调函数。
io_service::run()函数的调用。
这三个部分对应的执行流程为:
程序执行到异步操作函数处,异步操作函数立即返回,程序继续执行后续代码。
异步操作函数的功能完成[如读取到与设定缓冲区长度大小一致的数据时]或者出现异常时,io_service::run()函数机制会自动调用异步操作函数指定的回调函数。如果不io_service::run()函数,异步操作函数依然可以实现异步操作流程,只是回调函数不会被执行。
void handle_read(  boost::system::error_code ec,std::size_t bytes_transferred );  //如果不使用bind,则async_read函数的回调函数必须为如此形式
async_read( *pPort, buffer(v),  handle_read );

ios.run();
不过,输出cout<< “\n” << v;为乱码[在我挂一个单片机设备在串口的情形下 ]。
在此种情形下,虽然可以使异步操作函数后续代码被执行。但在没有发生异常或者没有读满设定缓冲区大小时,回调函数不会被调用。所以可以使用boost库下的deadline_timer为异步操作定时,如果超过定时的时间就结束异步函数的异步操作去执行回调函数。
eadline_timer timer(ios);
timer.expires_from_now(boost::posix_time::millisec(100));
//超时后调用pSerialPort的cancel()方法放弃读取更多字符
timer.async_wait(boost::bind(&serial_port::cancel,  boost::ref(*pSerialPort)));
以面向过程的方式实现这些步骤可以实现以上功能,但是将其封装称为类的时候会出点错误。
 
3 将boost串口通信封装成类
将其封装为类时,boost的用法就要遵循按照包装成员函数的套路出发,bind用法。
 
(1)类头文件
[cpp] view plaincopyprint?
#include <iostream> 
#include <boost/asio.hpp> 
#include <boost/bind.hpp> 
 
using namespace std; 
using namespace boost::asio; 
 
typedef string any_type; 
 
 
class MySerialPort 

private: 
    //Initialize port 
    bool init_port( const any_type port, const unsigned int char_size ); 
public: 
    //Constructor 
    //Destructor 
        MySerialPort( const any_type &port_name ); 
    ~MySerialPort(); 
     
    //Write some data to port 
    void write_to_serial( const any_type data ); 
 
    //Read data from port which write data just now 
    void read_from_serial(); 
 
    //The asyanc callback function of asyanc_read 
    void handle_read( char buf[], boost::system::error_code ec, 
        std::size_t bytes_transferred ); 
 
    //To Call io_service::run function to call asyanc callback funciton 
    void call_handle(); 
     
private: 
    //io_service Object 
    io_service m_ios; 
 
    //Serial port Object 
    serial_port *pSerialPort; 
 
    //For save com name 
    any_type m_port; 
 
    //Serial_port function exception 
    boost::system::error_code ec; 
}; 

(2)成员函数实现
[cpp] view plaincopyprint?
#include "stdafx.h" 
#include <string> 
#include <vector> 
#include "SerialCom.h" 
 
 
//Define Constructor function 
MySerialPort::MySerialPort( const any_type &port_name ):pSerialPort( NULL ) 

        pSerialPort = new serial_port( m_ios ); 
    if ( pSerialPort ){ 
        init_port( port_name, 8 ); 
    } 
}  
 
//Define destructor function 
MySerialPort::~MySerialPort() 

       if( pSerialPort ) 
       { 
               delete pSerialPort; 
       }      

 
 
//Initialize port 
bool MySerialPort::init_port( const any_type port, const unsigned int char_size ) 

    //New not success 
    if ( !pSerialPort ){ 
        return false; 
    } 
 
        //Open Serial port object 
        pSerialPort->open( port, ec ); 
     
 
    //Set port argument 
    pSerialPort->set_option( serial_port::baud_rate( 9600 ), ec ); 
    pSerialPort->set_option( serial_port::flow_control( serial_port::flow_control::none ), ec ); 
    pSerialPort->set_option( serial_port::parity( serial_port::parity::none ), ec ); 
    pSerialPort->set_option( serial_port::stop_bits( serial_port::stop_bits::one ), ec); 
    pSerialPort->set_option( serial_port::character_size( char_size ), ec); 
 
    return true; 

 
 
//Define wirte_to_serial to write data to serial 
void MySerialPort::write_to_serial( const any_type data ) 

        size_t len = write( *pSerialPort, buffer( data ), ec ); 
        cout << len << "\t" << data << "\n"; 

 
void MySerialPort::handle_read( char buf[], boost::system::error_code ec, 
    std::size_t bytes_transferred ) 

    cout << "\nhandle_read: "; 
    cout.write(buf, bytes_transferred); 

 
 
 
//Read data from the serial 
void MySerialPort::read_from_serial() 

       char v[10]; 
       async_read( *pSerialPort, buffer(v), boost::bind( &MySerialPort::handle_read, this, v, _1, _2) ); 

 
 
//Call handle_read function when async function read complete or come out exception 
void MySerialPort::call_handle() 

        //There can use deadline_timer to cancle serial_port read data 
 
    //Wait for call callback function 
    m_ios.run(); 

(3) 使用类
VS下的控制台程序就可以,当然首先得配置VS2010与boost库环境:见VS2010 BOOST库配置。
[cpp] view plaincopyprint?
// BoostSerialCommunication.cpp : Defines the entry point for the console application. 
// 
#ifdef _MSC_VER 
#define _WIN32_WINNT        0X0501     
#endif 
 
#define BOOST_REGEX_NO_LIB 
#define BOOST_DATE_TIME_SOURCE 
#define BOOST_SYSTEM_NO_LIB 
 
#include "stdafx.h" 
#include "SerialCom.h" 
 
 
int _tmain(int argc, _TCHAR* argv[]) 
try 

     { 
    MySerialPort my_Sp( "COM3"); 
    my_Sp.write_to_serial( "SerialPort" ); 
    my_Sp.read_from_serial(); 
    my_Sp.call_handle(); 
    getchar(); 
     } 
    getchar(); 
    return 0; 

catch(  std::exception &e ) 

       cout << e.what(); 
       getchar(); 

 
如果async_read读取的数据段长度大于写入串口的数据,则可以正确执行read_from_serial()后续代码,而回调函数handle_read不会被执行指导异常发生或者读满v的长度为止。但整个程序不会为止而阻塞。可以用boost库下的deadline_timer为serial_port读取数据定时,当时间到达时不再继续读取数据即可,立马就会调用回调函数handle_read。不过从串口读出来的数据输出到屏幕之上时为乱码,还没找到原因。
 
此次笔记记录完毕。

【上篇】
【下篇】

给我留言

留言无头像?