在去年年初,就已經推出V1.0.0的GPRS庫,不過在這個版本上只是實現了西文短信收發和字符串方式的GPRS數據通訊,功能還相對不完善(參見我之前的博文《GPRS通訊實現》)。最近升級的版本,對以上功能進行了大幅度的升級改進,好比支持PDU方式收發短信(支持中文)、彩信發送、二進制方式 GPRS數據收發、短信按類型提取、短信刪除和短信事件通知等等功能。函數
考慮到功能比較多,咱們分三篇文章來介紹最新的GPRS庫的功能,這一篇咱們先介紹和短信收發相關的內容。spa
庫函數中和短信收發相關的方法以下:.net
(1)設置短消息中心地址orm
聲明:int SetCenterNum (sring CenterNum)htm
參數:CenterNum– 短消息中心地址blog
返回:操做返回值接口
0 – 發送成功事件
-1 - 設置失敗字符串
說明:短消息中心地址。聯通和移動不一樣地區,號碼都不一樣,通常狀況下,不須要專門設置get
(2)發送短信(PDU方式)
聲明:int SendMessage (sring phone,string msg)
參數:phone – 電話號碼
msg – 要發送的字符串
返回:操做返回值
0 –發送成功
-1 –字符長度爲0或大於70個字節
-2 –設置短消息格式失敗
- 3 –發送短信失敗
說明:發送短信。支持中文字符發送。
(3)讀取短信
聲明:int ReceiveMessage(out GsmMessage[] msgs,MessageType msgType)
參數:msgs – 信息集合,每一項都包括,短信發送的電話,發送時間和內容
msgType – 消息類型:未讀消息,已讀消息,未發消息,已發消息,所有消息
返回:返回指定類型的短信字符串集合。
說明:接收短信。目前支持中英文短信接收。
(4)刪除短信
聲明:int DeleteMessage ()
參數:無
返回:操做返回值
0 – 刪除0個消息
-1 – 設置PDU模式失敗
>0 – 刪除的短消息個數
說明:刪除所有的短消息。
除了方法外,還有一個短信收到事件,具體聲明以下:
(1)短信收到通知
聲明:SMSMessageReceivedEventHandler MessageReceived
參數:object sender – GPRS類的實例
說明:短信接收通知
爲了便於說明庫的使用,咱們設定一個場景,來進行相關代碼的功能演示。
場景是這樣設定的:
(1)、程序不斷採集溫溼度數據,一旦超出預先設置好的範圍,就會短信通知報警。
(2)、手機發送短信,控制繼電器,能夠遠程打開和關閉加溼器。
具體代碼以下(其中溫溼度採集部分,詳情請參見:經過AD採集獲取溫溼度):
(1)、GPRS模塊初始化相關代碼
int ret = 0;
gprs = new GPRS("COM3", 115200, GPRS.GprsType.SIM300_V6_x);
//打開GPRS模塊
if ((ret = gprs.Open()) != 0)
{
Debug.Print("Open Failed:" + ret.ToString());
gprs.Close();
screen.DrawText("打開GPRS模塊失敗", font, Colors.Red, 20, 60);
screen.Flush();
return;
}
Debug.Print("Open OK");
screen.DrawText("打開GPRS模塊成功", font, Colors.Green, 20, 60);
screen.Flush();
//判斷是否在線,超時時間10s
if ((ret = gprs.IsOnline(10000)) != 0)
{
Debug.Print("AT Failed:" + ret.ToString());
gprs.Close();
screen.DrawText("GPRS模塊不在線", font, Colors.Red, 20, 100);
screen.Flush();
return;
}
Debug.Print("AT OK");
screen.DrawText("GPRS模塊在線", font, Colors.Green, 20, 100);
screen.Flush();
//GPRS模塊初始化
if ((ret = gprs.Initialize()) != 0)
{
Debug.Print("Initialize Failed:" + ret.ToString());
gprs.Close();
return;
}
Debug.Print("Initialize OK");
screen.DrawText("GPRS初始化成功", font, Colors.Green, 20, 140);
screen.Flush();
//顯示信號強度
//Debug.Print("Signal:" + gprs.Signal.ToString());
gprs.MessageReceived += new SMSMessageReceivedEventHandler(gprs_MessageReceived);
(2)、GPRS模塊短信接收並控制部分
static void gprs_MessageReceived(object sender)
{
int ret = 0;
GsmMessage[] msgs = null;
//讀未讀的短消息
if ((ret = gprs.ReceiveMessage(out msgs, GPRS.MessageType.REC_UnRead)) < 0)
{
Debug.Print("ReceiveMessage Failed:" + ret.ToString());
}
else
{
if (ret > 0)
{
foreach (GsmMessage msg in msgs)
{
Debug.Print(msg.ToString());
}
//gprs.SendMessage(msgs[0].phone, msgs[0].ToString());
switch (msgs[0].message)
{
case "開":
opSwitch.Write(true);
State = true;
break;
case "關":
opSwitch.Write(false);
State = false;
break;
}
}
}
//刪除短消息
//gprs.DeleteMessage();
}
(3)溼度報警相關代碼
//溼度報警
if (H > 60 && !AlarmFlag)
{
//發送報警短信(實際應用時,請填入實際的電話號)
gprs.SendMessage("158XXXXXXX", "當前溼度:" + H.ToString("F2"));
AlarmFlag = true;
}
if (AlarmFlag && H < 50)
{
AlarmFlag = false;
}
實際運行效果圖:
說明:硬件平臺採用最新的紫藤207系統;GPRS模塊採用Sim300 V6.02版本的模塊;繼電器模塊採用5V驅動,可控制220V 10A的電器,通常家用小功率電器能夠直接使用;溫溼度模塊採用了相對低價的AD接口的模塊。
下一篇博文,將介紹GPRS模塊是如何發送彩信的,敬請期待。
本文源碼:http://www.sky-walker.com.cn/MFRelease/Sample/YF_GPSR01.rar
類庫下載:http://www.sky-walker.com.cn/MFRelease/library/v42/YFSoft.Hardware.GPRS.rar