smsdll.h

来自「PDU方式发送SMS的动态链接库」· C头文件 代码 · 共 165 行

#if !defined(__SMSDLL_H__)
#define __SMSDLL_H__

#define OPEN_PORT_FAIL 201 //打开串口失败 
#define GET_COM_STATA_FAIL 202 //取串口参数失败 
#define SET_COM_STATA_FAIL 203 //设置串口参数失败 
#define SET_COM_TIMEOUT_FAIL 204 //设置串口超时失败 
#define SEND_DATA_FAIL 205 //发送数据失败 
#define RECV_DATA_FAIL 206 //接收数据失败 
#define CLOSE_PORT_FAIL 207 //关闭串口失败 
#define SEND_DATA_TIMEOUT 208 //发送超时 
#define RECV_DATA_TIMEOUT 209 //接收超时 

typedef struct __COM_STR__{ 
	int serial_port; //打开端口号 
	int baud; //波特率 
	int timeout; //超时 
	HANDLE m_hComm; //端口句柄 
} COM_STR; 


// 用户信息编码方式
#define GSM_7BIT		0
#define GSM_8BIT		4
#define GSM_UCS2		8

// 应答状态
#define GSM_WAIT		0		// 等待，不确定
#define GSM_OK			1		// OK
#define GSM_ERR			-1		// ERROR

// 短消息参数结构，编码/解码共用
// 其中，字符串以'\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[160];		// 原始用户信息(编码前或解码后的TP-UD)
	short index;			// 短消息序号，在读取时用到
} SM_PARAM;

// 读取应答的缓冲区
typedef struct {
	int len;
	char data[16384];
} SM_BUFF;

// 初始化GSM状态
BOOL GSMInit();

// 发送短消息，仅发送命令，不读取应答
// 输入: pSrc - 源PDU参数指针
int GSMSendMessage(SM_PARAM* pSrc);

// 7bit编码
// 输入: pSrc - 源字符串指针
//       nSrcLength - 源字符串长度
// 输出: pDst - 目标编码串指针
// 返回: 目标编码串长度
int GSMEncode7bit(const char* pSrc, unsigned char* pDst, int nSrcLength);

// 7bit解码
// 输入: pSrc - 源编码串指针
//       nSrcLength - 源编码串长度
// 输出: pDst - 目标字符串指针
// 返回: 目标字符串长度
int GSMDecode7bit(const unsigned char* pSrc, char* pDst, int nSrcLength);

// 8bit编码
// 输入: pSrc - 源字符串指针
//       nSrcLength - 源字符串长度
// 输出: pDst - 目标编码串指针
// 返回: 目标编码串长度
int GSMEncode8bit(const char* pSrc, unsigned char* pDst, int nSrcLength);

// 8bit解码
// 输入: pSrc - 源编码串指针
//       nSrcLength -  源编码串长度
// 输出: pDst -  目标字符串指针
// 返回: 目标字符串长度
int GSMDecode8bit(const unsigned char* pSrc, char* pDst, int nSrcLength);

// PDU编码，用于编制、发送短消息
// 输入: pSrc - 源PDU参数指针
// 输出: pDst - 目标PDU串指针
// 返回: 目标PDU串长度
int GSMEncodePdu(const SM_PARAM* pSrc, char* pDst);

// PDU解码，用于接收、阅读短消息
// 输入: pSrc - 源PDU串指针
// 输出: pDst - 目标PDU参数指针
// 返回: 用户信息串长度
int GSMDecodePdu(const char* pSrc, SM_PARAM* pDst);

// UCS2编码
// 输入: pSrc - 源字符串指针
//       nSrcLength - 源字符串长度
// 输出: pDst - 目标编码串指针
// 返回: 目标编码串长度
int GSMEncodeUcs2(const char* pSrc, unsigned char* pDst, int nSrcLength);

// UCS2解码
// 输入: pSrc - 源编码串指针
//       nSrcLength -  源编码串长度
// 输出: pDst -  目标字符串指针
// 返回: 目标字符串长度
int GSMDecodeUcs2(const unsigned char* pSrc, char* pDst, int nSrcLength);

// 从列表中解析出全部短消息
// 输入: pBuff - 短消息列表缓冲区
// 输出: pMsg - 短消息缓冲区
// 返回: 短消息条数
int GSMParseMessageList(SM_PARAM* pMsg, SM_BUFF* pBuff);

// 读取短消息，仅发送命令，不读取应答
// 用+CMGL代替+CMGR，可一次性读出全部短消息
int GSMReadMessageList();

// 删除短消息，仅发送命令，不读取应答
// 输入: index - 短消息序号，1-255
int GSMDeleteMessage(int index);

// 读取GSM MODEM的应答，可能是一部分
// 输出: pBuff - 接收应答缓冲区
// 返回: GSM MODEM的应答状态, GSM_WAIT/GSM_OK/GSM_ERR
// 备注: 可能需要多次调用才能完成读取一次应答，首次调用时应将pBuff初始化
int GSMGetResponse(SM_BUFF* pBuff);

// 字节数据转换为可打印字符串
// 如：{0xC8, 0x32, 0x9B, 0xFD, 0x0E, 0x01} --> "C8329BFD0E01" 
// 输入: pSrc - 源数据指针
//       nSrcLength - 源数据长度
// 输出: pDst - 目标字符串指针
// 返回: 目标字符串长度
int GSMBytes2String(const unsigned char* pSrc, char* pDst, int nSrcLength);

// 可打印字符串转换为字节数据
// 如："C8329BFD0E01" --> {0xC8, 0x32, 0x9B, 0xFD, 0x0E, 0x01}
// 输入: pSrc - 源字符串指针
//       nSrcLength - 源字符串长度
// 输出: pDst - 目标数据指针
// 返回: 目标数据长度
int GSMString2Bytes(const char* pSrc, unsigned char* pDst, int nSrcLength);

// 正常顺序的字符串转换为两两颠倒的字符串，若长度为奇数，补'F'凑成偶数
// 如："8613851872468" --> "683158812764F8"
// 输入: pSrc - 源字符串指针
//       nSrcLength - 源字符串长度
// 输出: pDst - 目标字符串指针
// 返回: 目标字符串长度
int GSMInvertNumbers(const char* pSrc, char* pDst, int nSrcLength);

// 两两颠倒的字符串转换为正常顺序的字符串
// 如："683158812764F8" --> "8613851872468"
// 输入: pSrc - 源字符串指针
//       nSrcLength - 源字符串长度
// 输出: pDst - 目标字符串指针
// 返回: 目标字符串长度
int GSMSerializeNumbers(const char* pSrc, char* pDst, int nSrcLength);


#endif // !defined(__SMSDLL_H__)