前面数次连载我们以较长的篇幅讲解了串口通信的硬件原理、DOS平台控制以及基于WIN32 API、控件和第三方类的串口编程。作为本系列文章的最后一次连载,本章将给出一个典型的应用实例:西门子短信服务模块TC35的串口控制。
1.短信控制终端
作为短信 (Short Message Service,SMS)一族,想必你有这样的体会:用手机编辑短信息十分不便、容易出错,而且修改费时,若能用计算机来收发短信则方便许多。注意,本文所说的用计算机收发短信并不是说通过"网易短信王"等方式在Internet上收发短信,而是直接用计算机控制运行了GSM通信系统的短信终端进行收发,因而其收发短信的原理与手机是本质相同的。
实际上,一大堆的垃圾短信也是采用这种短信终端发出来的!
我们来介绍一款GSM模块,它就是西门子公司的TC35,它由GSM基带处理器、电源专用集成电路、射频电路和闪速存储器等部分组成,负责处理GSM蜂窝设备中的音频、数据和信号,内嵌的软件部分执行应用接口和所有GSM协议栈的功能。TC35支持中文短信息,工作在EGSM900和GSM1800双频段,电源范围为3.3~5.5V,可传输语音和数据信号,消耗功率在EGSM900(4类)和GSM1800(1类)分别为2W和1W,通过接口连接器和天线连接器分别连接SIM卡读卡器和天线。TC35的数据接口(CMOS电平)通过AT命令可双向传输指令和数据,可选波特率为300bit/s~115kbit/s,自动波特率为1.2k~115kbit/s。它支持文本和PDU格式的,可通过AT命令或关断信号实现重启和故障恢复。
我们需要利用以TC35模块为主的硬件组成一个TC35终端设备,并与电脑通过RS-232C串口相连,并自行编制在PC上运行的短信息收发软件,就可以组成一个短信收发系统。TC35终端电路如下图所示:
|
TC35的控制主要包含如下几类指令:
(1)初始化指令
设置短消息发送格式AT+CMGF=1<CR>,设置1代表PDU模式,<CR>是回车符号,也就是0x0d,指令正确则模块返回<CRLF>OK<CRLF>,<CRLF>是回车换行符号。
(2)设置/读取短消息中心
短消息中心号码由移动运营商提供。
设置短消息中心的指令格式为:
AT+CSCA=″+8613800531500″(短消息中心)<CR>
设置正确则模块返回<CRLF>OK<CRLF>。
读取短消息服务中心则使用命令:
AT+CSCA=?<CR>
TC35模块应该返回:
<CRLF>+CSCA:″8613800531500″<CRLF>。
(3)设置短消息到达自动提示
设置短消息到达自动提示的指令格式为:
AT+CNMI=1,1,0,0,1<CR>
设置正确则TC35模块返回:
<CRLF>OK<CRLF>。
设置此命令可使模块在短消息到达后向串口发送指令:
<CRLF>+CMTI:″SM″,INDEX(信息存储位置)<CRLF>。
通过TC35发送短消息的方法为:
PC上的控制软件按照PDU的格式发送和接收数据,短消息的内容可以是中文或者其他字符。在PDU模式,如果发送短消息,则首先发送短消息数据的长度:
AT+CMGS=<length><CR>
等待TC35模块返回ASCII字符">",则可以将PDU数据输入,PDU数据以<Z>(也就是0x1a)作为结束符。短消息发送成功,模块返回:
<CRLF>OK<CRLF>
通过TC35接收短消息的方法为:
短消息到来后,串口上会接收到指令
<CRLF>+CMTI:″SM″,INDEX(信息存储位置)<CRLF>
PC上的控制软件通过读取PDU数据的AT命令
AT+CMGR=INDEX<CRLF>
将TC35模块中PDU格式的短消息内容读出。如果用+CMGL代替+CMGR,则可一次性读出全部短消息。
通过TC35删除短消息的方法为:
PC上的控制软件收到一条短消息并处理后,需要将其在SIM卡上删除,以防止SIM卡饱和。删除短消息的指令为:
AT+CMGD=INDEX<CR>
删除后模块返回
<CRLF>OK<CRLF>
2.程序实例
由于本文的宗旨在于讲解串口通信,因此,我们屏蔽图形用户界面的细节,制作一个简单的短信收发软件,它包含了控制短信终端的所有串口通信内容。实际上,一个理想的短信收发软件的界面应类似于Outlook或Foxmail,包含收件箱、发件箱、已发送短信箱等内容,但是这些东西都与我们要介绍的串口通信无关,因此,下面的软件界面虽"败絮其外",但仍可称得上"金玉其中":
关于界面上控件的描述如下:
BEGIN EDITTEXT IDC_SMSCONTENT_EDIT,39,61,242,38,ES_AUTOHSCROLL PUSHBUTTON "发送",IDC_SEND_BUTTON,316,80,45,18 GROUPBOX "接收短消息",IDC_STATIC,28,124,361,167 LTEXT "对方手机号",IDC_STATIC,41,35,42,11 EDITTEXT IDC_PHONENUM_EDIT,88,30,192,17,ES_AUTOHSCROLL PUSHBUTTON "清除",IDC_CLEAR_BUTTON,316,30,45,18 GROUPBOX "发送短消息",IDC_STATIC,29,19,361,95 LISTBOX IDC_RECVSMS_LIST,43,137,331,127,LBS_SORT | LBS_NOINTEGRALHEIGHT | WS_VSCROLL | WS_TABSTOP PUSHBUTTON "接收",IDC_RECV_BUTTON,77,269,55,16 PUSHBUTTON "清空",IDC_DELETEALL_BUTTON,273,268,45,14 END |
对话框类的消息映射为:
BEGIN_MESSAGE_MAP(CSMSControlDlg, CDialog) //{{AFX_MSG_MAP(CSMSControlDlg) ON_WM_SYSCOMMAND() ON_WM_PAINT() ON_WM_QUERYDRAGICON() ON_BN_CLICKED(IDC_CLEAR_BUTTON, OnClearButton) ON_BN_CLICKED(IDC_SEND_BUTTON, OnSendButton) ON_BN_CLICKED(IDC_RECV_BUTTON, OnRecvButton) ON_BN_CLICKED(IDC_DELETEALL_BUTTON, OnDeleteallButton) //}}AFX_MSG_MAP END_MESSAGE_MAP() |
感谢《通过串口收发短消息》一文的作者bhw98,他为我们编写了数个独立于操作系统平台的C函数,使得我们可以在应用程序中直接对这些函数进行调用。在本控制软件中,也对这些函数进行了充分利用。
下面是对本例程软件的主要数据结构和核心函数的介绍:
数据结构
// 用户信息编码方式 #define GSM_7BIT 0 #define GSM_8BIT 4 #define GSM_UCS2 8 // 短消息参数结构,编码/解码共用 // 其中,字符串以0结尾 typedef struct { char SCA[16]; // 短消息服务中心号码(SMSC地址) char TPA[16]; // 目标号码或回复号码(TP-DA或TP-RA) char TP_PID; // 用户信息协议标识(TP-PID) char TP_DCS; // 用户信息编码方式(TP-DCS) char TP_SCTS[16]; // 服务时间戳字符串(TP_SCTS), 接收时用到 char TP_UD[161]; // 原始用户信息(编码前或解码后的TP-UD) char index; // 短消息序号,在读取时用到 } SM_PARAM; |
发送短消息
发送按钮对应的函数为CSMSControlDlg::OnSendButton,它读取用户输出并根据目标电话号码和短信息内容形成SM_PARAM(源PDU参数)的内容,接着进行发送:
void CSMSControlDlg::OnSendButton() { // TODO: Add your control notification handler code here //获得用户输入 CString desPhoneNum; CString smsContent; GetDlgItemText(IDC_PHONENUM_EDIT,desPhoneNum); GetDlgItemText(IDC_SMSCONTENT_EDIT,smsContent); //填充SM_PARAM结构体内容 SM_PARAM smParam; smParam = CreateSMPARAMStruct(desPhoneNum,smsContent); //发送短信息 gsmSendMessage(smParam); } |
其中调用的gsmSendMessage函数体现了串口通信的核心内容,它按照第1节阐述的GSM模块发送短消息的串口控制流程进行短信的发送:
BOOL gsmSendMessage(const SM_PARAM *pSrc // pSrc: 源PDU参数指针) { int nPduLength; // PDU串长度 unsigned char nSmscLength; // SMSC串长度 int nLength; // 串口收到的数据长度 char cmd[16]; // 命令串 char pdu[512]; // PDU串 char ans[128]; // 应答串 nPduLength = gsmEncodePdu(pSrc, pdu); // 根据PDU参数,编码PDU串 strcat(pdu, "/x01a"); // 以Ctrl-Z结束 gsmString2Bytes(pdu, &nSmscLength, 2); // 取PDU串中的SMSC信息长度 nSmscLength++; // 加上长度字节本身 // 命令中的长度,不包括SMSC信息长度,以数据字节计 sprintf(cmd, "AT+CMGS=%d/r", nPduLength / 2-nSmscLength); // 生成命令 WriteComm(cmd, strlen(cmd)); // 先输出命令串 nLength = ReadComm(ans, 128); // 读应答数据 // 根据能否找到"/r/n> "决定成功与否 if (nLength == 4 && strncmp(ans, "/r/n> ", 4) == 0) { WriteComm(pdu, strlen(pdu)); // 得到肯定回答,继续输出PDU串 nLength = ReadComm(ans, 128); // 读应答数据 // 根据能否找到"+CMS ERROR"决定成功与否 if (nLength > 0 && strncmp(ans, "+CMS ERROR", 10) != 0) { return TRUE; } } return FALSE; } |
读取短消息
点击"接收"按钮会通过gsmReadMessage函数的调用获得所有短消息,最后在列表控件中显示所有短信:
void CSMSControlDlg::OnRecvButton() { // TODO: Add your control notification handler code here SM_PARAM smParam[100];//短信缓冲区 int smsNum;//短信条数 smsNum = gsmReadMessage(smParam);//读取短信 //显示短信 for(int i=0;i<smsNum;i++) { m_recvlist.AddString(CString(smsNum[i].TPA)+smsNum[i].TP_UD); } } |
其中调用的gsmReadMessage函数完成最核心的短信接收功能,它按照第1节阐述的GSM模块接收短消息的串口控制流程进行短信的接收:
// 参数:pMsg 短消息缓冲区,必须足够大 // 返回:短消息条数 int gsmReadMessage(SM_PARAM* pMsg) { int nLength; // 串口收到的数据长度 int nMsg; // 短消息计数值 char* ptr; // 内部用的数据指针 char cmd[16]; // 命令串 char ans[1024]; // 应答串 nMsg = 0; ptr = ans; sprintf(cmd, "AT+CMGL/r"); // 生成命令,用+CMGL可一次性读出全部短消息 WriteComm(cmd, strlen(cmd)); // 输出命令串 nLength = ReadComm(ans, 1024); // 读应答数据 // 根据能否找到"+CMS ERROR"决定成功与否 if(nLength > 0 && strncmp(ans, "+CMS ERROR", 10) != 0) { // 循环读取每一条短消息, 以"+CMGL:"开头 while((ptr = strstr(ptr, "+CMGL:")) != NULL) { ptr += 6; // 跳过"+CMGL:" sscanf(ptr, "%d", &pMsg->index); // 读取序号 ptr = strstr(ptr, "/r/n"); // 找下一行 ptr += 2; // 跳过"/r/n" gsmDecodePdu(ptr, pMsg); // PDU串解码 pMsg++; // 准备读下一条短消息 nMsg++; // 短消息计数加1 } } return nMsg; } |
我们可以在读取完所有短信息后调用gsmDeleteMessage函数在GSM模块上删除那些已经被接收到PC上的短信息,它按照第1节阐述的GSM模块删除短消息的串口控制流程进行短信的删除:
// index: 短消息序号,从1开始 BOOL gsmDeleteMessage(const int index) { int nLength; // 串口收到的数据长度 char cmd[16]; // 命令串 char ans[128]; // 应答串 sprintf(cmd, "AT+CMGD=%d/r", index); // 生成命令 // 输出命令串 WriteComm(cmd, strlen(cmd)); // 读应答数据 nLength = ReadComm(ans, 128); // 根据能否找到"+CMS ERROR"决定成功与否 if (nLength > 0 && strncmp(ans, "+CMS ERROR", 10) != 0) { return TRUE; } return FALSE; } |
在PC控制软件的短信列表框中删除所有短消息的"清空"按钮函数为:
void CSMSControlDlg::OnDeleteallButton() { // TODO: Add your control notification handler code here m_recvlist.ResetContent(); } |
设置/读/写串口
在应用程序启动与退出及gsmSendMessage、gsmReadMessage和gsmDeleteMessage函数中广泛使用的串口相关函数用WIN32 API实现:
// 串口设备句柄 HANDLE hComm; // 打开串口 // pPort: 串口名称或设备路径,可用"COM1"或"//./COM1"两种方式,建议用后者 // nBaudRate: 波特率 // nParity: 奇偶校验 // nByteSize: 数据字节宽度 // nStopBits: 停止位 BOOL OpenComm(const char *pPort, int nBaudRate, int nParity, int nByteSize, int nStopBits) { DCB dcb; // 串口控制块 COMMTIMEOUTS timeouts = { // 串口超时控制参数 100, // 读字符间隔超时时间: 100 ms 1, // 读操作时每字符的时间: 1 ms (n个字符总共为n ms) 500, // 基本的(额外的)读超时时间: 500 ms 1, // 写操作时每字符的时间: 1 ms (n个字符总共为n ms) 100 }; // 基本的(额外的)写超时时间: 100 ms hComm = CreateFile(pPort, // 串口名称或设备路径 GENERIC_READ | GENERIC_WRITE, // 读写方式 0, // 共享方式:独占 NULL, // 默认的安全描述符 OPEN_EXISTING, // 创建方式 0, // 不需设置文件属性 NULL); // 不需参照模板文件 if (hComm == INVALID_HANDLE_VALUE) return FALSE; // 打开串口失败 GetCommState(hComm, &dcb); // 取DCB dcb.BaudRate = nBaudRate; dcb.ByteSize = nByteSize; dcb.Parity = nParity; dcb.StopBits = nStopBits; SetCommState(hComm, &dcb); // 设置DCB SetupComm(hComm, 4096, 1024); // 设置输入输出缓冲区大小 SetCommTimeouts(hComm, &timeouts); // 设置超时 return TRUE; } // 关闭串口 BOOL CloseComm() { return CloseHandle(hComm); } // 写串口 // pData: 待写的数据缓冲区指针 // nLength: 待写的数据长度 void WriteComm(void *pData, int nLength) { DWORD dwNumWrite; // 串口发出的数据长度 WriteFile(hComm, pData, (DWORD)nLength, &dwNumWrite, NULL); } // 读串口 // pData: 待读的数据缓冲区指针 // nLength: 待读的最大数据长度 // 返回: 实际读入的数据长度 int ReadComm(void *pData, int nLength) { DWORD dwNumRead; // 串口收到的数据长度 ReadFile(hComm, pData, (DWORD)nLength, &dwNumRead, NULL); return (int)dwNumRead; } |
编/解码GSM短消息
陷于本文的篇幅,这里只给出编解码函数的原型,具体请参看GSM标准及《通过串口收发短消息》一文。
// UCS2编码 返回: 目标编码串长度 int gsmEncodeUcs2(const char *pSrc, // 源字符串指针 unsigned char *pDst, // pDst: 目标编码串指针 int nSrcLength // nSrcLength: 源字符串长度 ); // UCS2解码 返回: 目标字符串长度 int gsmDecodeUcs2(const unsigned char *pSrc, //源编码串指针 char *pDst, // pDst: 目标字符串指针 int nSrcLength // nSrcLength: 源编码串长度 ); //可打印字符串转换为字节数据 返回: 目标数据长度 //如:"C8329BFD0E01" --> {0xC8, 0x32, 0x9B, 0xFD, 0x0E, 0x01} int gsmString2Bytes(const char *pSrc, // pSrc: 源字符串指针 unsigned char *pDst, // pDst: 目标数据指针 int nSrcLength // nSrcLength: 源字符串长度 ); // 字节数据转换为可打印字符串 返回: 目标字符串长度 // 如:{0xC8, 0x32, 0x9B, 0xFD, 0x0E, 0x01} --> "C8329BFD0E01" int gsmBytes2String(const unsigned char *pSrc, // pSrc: 源数据指针 char *pDst, // pDst: 目标字符串指针 int nSrcLength // nSrcLength: 源数据长度 ); |
3.总结
串口编程的核心在于串口通信方式(发送、接收和握手)的控制,而具体的应用领域反而是次要的。掌握了根本的原理,就可以灵活地将其应用于任意领域,综合实例中的例子"短信控制终端"只是冰山一角。