read.txt

用vc写的非常简单的小程序

GsmReadWrite.dll函数调用说明：

1. 初始化函数
int  SerialINI(int port);
输入参数: port[串口口号(0,1,2,3)],整形数.
返回参数: 0 = 初始化成功, -1 = 串口初始化失败, -2 = 无线通信模块初始化失败.
功能:	对指定的串口按8 bit, 1位停止位, 无校验, 19200BPS,无握手信号设置
	同时对连接在该串口上的无线通信模块进行初始化. 

2. 取短信息数量函数
int GetMsgAmount(void);
输入参数: 无.
返回参数: 短信息数量, 整形数.
功能:	读取通信模块已接收的短信息数量.

*3. 取短信息序号函数
char* GetMsgID(int type);
输入参数: type[短信息类型(1 - 全部短信息, 2 - 没读过的短信息)],整形数.
返回参数:成功：返回ID数组("id1, ... idn > n")指针, 字符串类型指针.n = 信息数量
		没有指定类型的信息：返回“No!”；
功能:	按指定的短信息类型, 将接收的短信息的序号组成序号(ID)数组,并将
	    存放该数组的缓冲区指针返回.

4. 读短信息函数(带格式)
char* ReadMessage(int index);
输入参数: index[待读的短信息序号],整形数.
返回参数: 读入的短信息字符串指针, 字符串类型指针.
	  "FALSE!" - 读操作失败(无对应短信息;非法数据格式;数据校验错).
功能:	读入指定序号的短信息, 并将存放该短信息的缓冲区指针返回.

5. 写短信息函数（带格式）
char* WriteMessage(char* outstring);
输入参数: 要输出的短信息[ASCII码]指针,字符串类型指针.
	   outstring格式: pXX..XX@NN .. NN 
	   X - 手机号码，任意数量
	   N - 传输数据,16个ASCII码字符.
返回参数: 字符串类型指针. 
	   "FALSE!" - 发送失败(非法数据格式).
	   "OK!"    - 发送成功.
功能:	将ASCII码数据,按指定的地址发出.

6. 删除指定的短信息函数
int Tc35DelMsg(int index);
输入参数: index[待删除的短信息序号],整形数.
返回参数: 整形数. 非0 - 删除失败, 0 - 删除成功.
功能:删除指定编号的短信息。

7. 读通信模块SIM卡ID函数
char* Tc35CID(char*);
输入参数: 接收数据的数组指针,ASCII字符串类型指针.
返回参数: 字符串类型指针. 指针指向"FALSE" - 读失败,否则,就是有效信息.

8. 读短信（不作格式检查和转换）
char* ReadMSG(int id);
输入参数: 短信序号,整形数.
返回参数: 成功：返回短信内容, 字符串类型指针
		  错误：返回NULL

9. 写短信（无格式和长度要求）
int WriteMSG(char* str);
输入参数: 短信内容, 字符串类型指针.
返回参数: 成功：返回0
		  错误：-1


接收信息：
 用户发手机短信格式： 表号（8位）#返回码（8位）#购买量（3位）
			（MMMMMMMM#BBBBBBBB#YYY）
 DLL返回上位机数据格式：pNN....NN@MMMMMMMMBBBBBBBBYYY
 p和@是标志符
NN.....NN	 : 手机号码（任意长度）
MMMMMMMM	 :  表号
BBBBBBBB	 :  返回码
YYY		 :  购买量

发送信息：
上位机发给DLL的数据格式：pNN.....NN@MMMMMMMMYYYYYYYY
发给用户的短信格式：	   MMMMMMMM*YYYYYYYY
* 号为间隔符
NN.....NN	 : 手机号码（任意长度）
MMMMMMMM	 :  表号
YYYYYYYY	 : 购买代码