GSM模块短信息驱动

SimplePCConnect是SimpleTeam提供的一款免费的GSM模块短信息驱动程序。该驱动程序可以通过红外线或数据线方式驱动多种使用 AT Command的设备,例如:Nokia、NEC、Siemens、WaveCOM等等。通过该驱动程序,用户可以发送中文(普通或免提)和英文短信息。第二代驱动主要增加了对二进制数据、WAP Push ( Service Indication / Service Loading ) 、WAP Bookmark、GPRS Setting、MMS Indication和小灵通短信的支持。提供的驱动程序为DLL文件,适合调用的程序有:Visual Basic、C++ Builder、Visual C&C++、Delphi、Java等等。另外附件中还提供了相关的Visual Basic开发源代码以及函数详细说明。最新版本的驱动完全免费,使用和开发上没有任何限制,也不需要软件授权。

点击这里可以下载该程序:SimplePCConnect2.zip

一、简单介绍

Simple PC Connect是采用Visual C&C++ 6.0所编写的动态连接调用库。该模块中包含了Windows下的串口调用、AT指令驱动以及短信息PDU格式的编码和解码器等功能。调用该模块中的标准过程,可以驱动多种兼容AT指令的GSM设备。这些GSM设备包括绝大多数Nokia手机(例如:5110、6210等等)、NEC、WaveCOM模块、Falcom模块等等设备,实现短信息的收发。

二、功能介绍

  • (1)使用Visual C&C++ 6.0编写成DLL模块,可以通过Visual C&C++或Visual Basic等其他程序实现调用。
  • (2)内部函数简单易用,可以十分容易地实现短信息的收发。
  • (3)内部支持Unicode 8Bit和7Bit编码/解码,可以实现中文/英文短信息的收发。
  • (4)内部支持二进制数据、WAP Push(Service Indication / Service Loading)、WAP Bookmark、GPRS Setting和MMS Indication等特殊短信息。
  • (5)支持以红外线或数据线的方式驱动兼容AT指令的GSM设备。
  • (6)支持与硬件设备的相互绑定,防止软件被非法拷贝并应用。

三、函数以及说明

Simple PC Connect模块的函数一共可以分为三类函数:模块初始化函数、连接管理函数和发送接收函数。

3.1模块初始化函数

3.1.1取得模块相关信息
//Get the information string of the dll moudle.
LPCTSTR _stdcall GetModuleInformation();
【过程描述】获得一个DLL模块描述的字符串(以’\0’结尾)。
【注意问题】
(1)该函数可以随时调用。
3.1.2初始化模块
//Initialize the module.
BOOL _stdcall InitializePCConnect(UINT nInitializeStatus);
【过程描述】
在Debug版本中,该函数中将初始化一个日志函数。如果能够成功地打开日志文件,那么该函数将返回TRUE,否则返回FALSE。在Release版本中没有如上的处理过程,整个函数直接返回TRUE。
【注意问题】
(1)在开始使用模块的相关函数之前,请先调用该函数。
(2)在Visual Basic中的Boolean和BOOL型可能有一定的差异。因此,采用Native Code编译后的代码在运行的时候可能会出现无法正常使用的问题。此时采用P-Code编译即可。
3.1.3卸载模块
//Uninitialize the module.
void _stdcall UninitializePCConnect();
【过程描述】
关闭所有设备,并释放已分配的内存。
【注意问题】
(1)在卸载模块之前必须调用该函数。这样可以关闭忘记关闭的设备和释放已分配的内存。否则可能导致串口被长时间占用。

3.2设备连接管理

3.2.1初始化连接
//Open the connection with the PC.
BOOL _stdcall OpenPCConnect(UINT nDeviceNumber,LPCTSTR lpszLicence,LPCTSTR lpszSCA);
【过程描述】
该函数将打开nDeviceNumber所指定的串口,并读取设备的相关参数。如果某些参数不在范围内,那么该函数将返回初始化失败。
【注意问题】
(1)该函数会打开串口,并且初始化该串口。在使用完成后,一定要调用ClosePCConnect关闭该设备。
(2)如果lpszLicence不填写或者填写不正确,将不影响连接的打开过程。
(3)短信息中心如果不设置,那么该函数将试图从设备中读取。如果设备中也没有设置,那么设备将返回初始化失败。
(4)引起设备初始化失败的原因比较多,例如:串口尚未连接、电源没有连接、非AT兼容设备、SIM卡没插上、读取序列号失败、读取短信息中心失败等等。
3.2.2重新打开连接
//Reopen the connection with the PC.
BOOL _stdcall ReopenPCConnect(UINT nDeviceNumber);
【过程描述】
重新快速初始化已经出现严重错误的设备(该设备已经打开,在使用中发生严重错误)。
【注意问题】
(1)该函数仅在设备出现严重错误的时候才使用。
(2)其他时候使用也有效,但是没有实际意义。
(3)不要在发送和接收过程完成之前使用该函数。
3.2.3关闭连接
//Close the connection with the PC.
void _stdcall ClosePCConnect(UINT nDeviceNumber);
【过程描述】
关闭指定设备,并释放已分配的内存。
【注意问题】
(1)在使用OpenPCConnect建立连接后,都要使用ClosePCConnect实现关闭。
(2)ClosePCConnect只能关闭所指定的设备。
(3)设备关闭,连接也随即关闭。此后将不能在使用发送和接收函数操作该设备。
(4)不要在发送或接收过程完成之前使用该函数。
3.2.4获得设备授权状态
//Get the authorization.
BOOL _stdcall GetAuthorization(UINT nDeviceNumber);
【过程描述】
获得已打开设备的授权状态。
【注意问题】
(1)在打开设备的时候,请使用正确的lpszLicence将设备初始化。
3.2.5检查设备是否支持AT指令
//Detect the connection with the PC.
BOOL DetectPCConnect(UINT nDeviceNumber);
【过程描述】
获得已打开设备的授权状态。
【注意问题】
(1)请在该设备打开之前使用该检测指令。

3.3内容管理函数

3.3.1参数设置函数
//Set status receipt requested.
void _stdcall SetStatusReceiptRequested(BOOL bStatusReceiptRequested);
//Set reject duplicated.
void _stdcall SetRejectDuplicated(BOOL bRejectDuplicated);
//Set protocol identification.
void _stdcall SetProtocolIdentification(BYTE bProtocolIdentification);
【过程描述】
【注意问题】
(1)通过收条在很大程度获得用户的接收情况。
(2)一般来说不用拒绝重复的MR。
(3)应用协议类型在某些特殊短信息的时候会用到。
(4)这些参数应当在设置内容(SetXXXContent)之前设置。
3.3.2内容设置函数
//Set the content into the list.
BOOL _stdcall SetUTF8Content(LPCTSTR lpszContent,BOOL bImmediateDisplay);
BOOL _stdcall Set7BitContent(LPCTSTR lpszContent);
BOOL _stdcall SetBinaryContent(LPCTSTR lpszContent,BOOL bHeaderIndication);
【过程描述】
设定待发送的内容。
【注意问题】
(1)SetUTF8BitContent能够设置中文或者中英混合,甚至是其他语言的短信息。但是内容长度不能超过70个Unicode字符。如果超过,则该函数返回FALSE。
(2)Set7BitContent是用来发送纯ASCII码的短信息。内容长度不能超过160个ASCII码。如果超过,则该函数返回FALSE。
(3)如果对多人实行群发,内容在每次发送的时候只需要设置一次即可。这样简化发送过程。
3.3.3内容清理函数
//Clear the content.
void _stdcall ClearContent();
【过程描述】
清理设定待发送的内容。
【注意问题】
(1)该函数将清理所有的相关内容,使设定内容自动清空。
3.3.4 WAP功能函数
//Set the wap push into the list.
BOOL _stdcall SetWAPPushService(LPCTSTR lpszReference,LPCTSTR lpszDescription,BOOL bImmediately);
//Set the wap bookmark into the list.
BOOL _stdcall SetWAPPushBookmark(LPCTSTR lpszReference,LPCTSTR lpszDescription);
//Set the gprs settting into the list.
BOOL _stdcall SetWAPGPRSSetting(LPCTSTR lpszReference,LPCTSTR lpszDescription);
//Set the mms indication into the list.
BOOL _stdcall SetWAPMMSIndication(LPCTSTR lpszFrom,UINT nSize,LPCTSTR lpszReference);
【过程描述】
从上至下分别设定WAP Push服务,WAP Push书签和WAP GPRS设定。
【注意问题】
(1)URL地址一定要使用http://或者https://开头,否则可能导致异常。

3.4短信收发函数

3.4.1发送短信息
//Send the content.
//If not authenticated, then send the advertise at the end of the sending.
BOOL _stdcall SendContent(UINT nDeviceNumber,LPCTSTR lpszTerminalAddress);
【过程描述】
将保存的内容发送到指定的用户。
【注意问题】
(1)在发送前,请先确认设备已经打开。
(2)如果发送成功,那么可以在GetStatus函数中得到Status = 3的状态。
(3)如果发送失败,那么可以在GetStatus函数中得到其他的状态数值。
(4)如果所需要发送的内容被分为多条,那么只要有一条发送失败,那么就直接返回FALSE。
(5)发送函数与接收函数之间已经实现了函数同步处理,因此可以在不同的线程中调用。
(6)一般来说,该函数所需执行的时间相对较长。
(7)如果使用未经授权的设备发送短信息,那么每条正常短信息内容之后都会跟一条广告信息。
(8)如果需要给小灵通发送短信息,请在号码前加106。例如,北京的小灵通号码是80659031,那么目标号码应该是:【106】+『区号』+80659031,即:10601080659031。
3.4.2接收短信息
//Receive the content.
BOOL _stdcall ReceiveContent(UINT nDeviceNumber,LPSTR lpszTerminalAddress,LPSTR lpszContent);
【过程描述】
从设备中获取接收到的短信息。该函数将只接收文本短信息,屏蔽收条和无法解析的信息(包括数据格式的信息)。
【注意问题】
(1)ReceiveContent并不能每次都返回TRUE。需要有一个虚幻不断地去调用该函数。
(2)如果ReceiveContent返回FALSE,请根据GetStatus函数做相应的处理。
(3)如果从未授权的设备上获取短信息,那么也将获得搀杂着广告信息的短信息。
3.4.3设备状态函数
//Get the status of the device.
int _stdcall GetStatus(UINT nDeviceNumber);
//Get the error of the device.
int _stdcall GetError(UINT nDeviceNumber);
【过程描述】
获得设备最近一次的状态和错误代码。
【注意问题】
(1)请在每次调用发送和接收函数之后,如果函数返回FALSE,那么就要检测一下设备的状态。根据不同的状态做错误处理。
(2)其他时候使用该函数,是没有实际意义的。

四、安装与使用

Simple PC Connect有两个版本:

  • (1)Release版本:SimplePCConnect.dll(155,648字节)
  • (2)Debug版本:SimplePCConnect.dll(1,642,569字节)

使用前,请将该DLL拷贝或安装到Windows的system目录下,通过声明或装载就可以使用该模块中的各个函数。使用方法请参考上面的详细说明。

另外,该模块中可能使用到了Visual C&C++的相关动态连接库。如果你没有该库,请上网下载或者安装Visual C&C++系统。

五、基本调用过程

整个模块的详细调用过程可以参考Visual Basic例子程序的调用过程。这里再简单说明一下:

5.2发送过程

  • (1)使用InitializePCConnect初始化模块。
  • (2)使用OpenPCConnect打开一个指定设备。
  • (3)使用SetXXXContent设置待发送的内容。
  • (4)使用SendContent将内容发送到指定的用户手机上。
  • (5)检测发送结果,进行错误处理。
  • (6)如果还有用户,那么重复(4)和(5)直到所有的用户都发送完毕。
  • (7)使用ClosePCConnect关闭一个指定设备。
  • (8)使用UninitializePCConnect卸载模块。

5.3接收过程

  • (1)使用InitializePCConnect初始化模块。
  • (2)使用OpenPCConnect打开一个指定设备。
  • (3)使用ReceiveContent接收短信息内容。
  • (4)检测接收结果,进行错误处理。
  • (5)不断重复(3)过程,直到整个应用结束。
  • (6)使用ClosePCConnect关闭一个指定设备。
  • (7)使用UninitializePCConnect卸载模块。

六、注意问题

6.1在Visual Basic的接口过程中凡是使用BOOL变量的返回函数有些时候工作不正常。

【解决】在Visual Basic中的boolean变量为2个字节,而在Visual C&C++中的BOOL为4个字节。建议将函数声明为整数函数,或者使用P-Code(而不是Native Code)编译程序。

QR Code
QR Code message:simple_pc_connect (generated for current page)