itbrainpower.net
THE ALPHABET PROJECT - professional Arduino, BeagleBone & Raspberry PI shields



Read our last post: Modems and RaspberryPI 5. RaspberryPI OS [Debian 12 bookworm] notes.. Order u-GSM modems.

THERMAL SUPERVISOR WITH SMS ALARM SYSTEM using ARDUINO, 3G / GSM SHIELD AND 1WIRE TEMPERATURE SENSOR

 

About the project

Build yourself your own temperature monitoring system with MAXIMUM and MINIMUM temperature thresholds, keep alive massages and (oldies but goldies as) SMS paging and remote ARM/DISARM system. You can supervise one or more 1WIRE temperature sensor(s) and page via SMS the "heating and chilling events" and keep alive messages, including last temperature. You can ENABLE/DISABLE the alarm system from remote via single SMS. This project uses for SMS integration the pin 2 pin compatible dual SIM GSM shield (c-uGSM), nano GSM shield (h-nanoGSM), or 3G shield (d-u3G).

 

Needed parts

 

CREDITS

Inside this project we used for 1WIRE temperature the "Dallas Temperature Control Library" developed by Miles Burton & Tim Newsome >> Arduino Library for Dallas Temperature ICs reference here. Thank you guys! Nice job!

 

About c-uGSM, d-u3G and h-nanoGSM shields

There are pin 2 pin compatible shields, first one it is quad band GSM only(world wide compatible) and has support for 2SIMs and the second one it is SINGLE SIM 3G only (North American version) / 3G+GSM (European and rest of the world version).

Those shields are compact as 1.25"x1.57"(31.75x39.88mm) / 1.35"x1.57"(34.29x39.88mm), weight around 10g, have USB support (communication and powering), auto level 2.8V-5V digital interfaces and Lithium Polimer charger integrated.

d-u3G 3G/UMTS shield   d-u3G 3G/UMTS shield

h-nanoGSM - worldwide GSM + BTH 3.0 nano shield  

The third one - h-nanoGSM - became commercially available in 2016, August. It is a quad band GSM only(world wide compatible) + Bluetooth 3.0 nano shield, packed in an compact format 1.25"x1.16"(31.75x29.46mm) and with weight around 8g. Same as his bigger brothers (c-uGSM and d-u3G), it is not only a break-board, but a full shield having powerful features embedded, as: USB support (communication and powering), auto level 2.8V-5V digital interfaces and Lithium Polimer charger integrated.

 

DALLAS/MAXIM 18B20 temperature sensor

Solder the 2.2kb resistor between 18B20 Vdd pin(3)and 18B20 DQ pin(2). 18B20 Vdd pin(3) must be wired to Arduino 5V, 18B20 DQ pin(2) to Arduino D4 and 18B20 GND pin(1) to Arduino GND....see details bellow. DALLAS/MAXIM 18B20 reference here.

wiring DALLAS/MAXIM 1WIRE 18B20 / 18S20 1WIRE temperature sensor with Arduino

 

Hardware connections

In the picture bellow (d-u3G - 3G shield wiring example) you can observe all logical connections.

SMS THERMAL ALARM SUPERVISOR WITH ARDUINO, 3G/GSM SHIELD AND 1WIRE TEMPERATURE SENSOR WIRING

 

For c-uGSM/h-nanoGSM shields (GSM only versions) usage: just connect the wires to the very same pins of the GSM shield.

Brief 3G / GSM shield powering wiring:

  • "WITHOUT Lithium Polymer configuration" configuration >> connect +4V power supply (g-SPS 4V [DDRV] recomended) to the 3G/GSM shield "Vcc 4V" pin.
  • "WITH Lithium Polymer" configuration >> connect +5V power supply (g-SPS 5V [LiPOL] recomended) to the 3G/GSM shield "Vin 5V" pin.
  • Read the reference: c-uGSM, h-nanoGSM and d-u3G how to start.


The temperature sensor it is connected as following: 18B20 Vdd pin(3) must be wired to Arduino 5V, 18B20 DQ pin(2) to Arduino D4 and 18B20 GND pin(1) to Arduino GND. Do not forget to solder a 2.2kb resistor between 18B20 Vdd pin(3)and 18B20 DQ pin(2).
HINT: if you would like to have multiple 1WIRE temperature sensors, just connect them in paralel mode (single pull up resistor requiered... check for proper value...) and hack the software (use 1,2.. sensorIndex in "sensors.getTempCByIndex(sensorIndex)").

 

Software

a. We use version Dallas Temperature library 3.7.2 beta. Download from here: Miles Burton Dallas Temperature library v 3.72 beta.

b. Install this library >> how to install here.

c. Start making a folder named "SMS_THERMAL_alarm_supervisor".

d. Then download the "c-uGSM kickstart for Arduino" from c-uGSM CODE SAMPLES and UTILITIES, or "h-nanoGSM kickstart for Arduino" from h-nanoGSM CODE SAMPLES and UTILITIES, or "d-u3G kickstart for Arduino" from d-u3G CODE SAMPLES and UTILITIES if you use the d-u3G shield. Product EMEI and your email adress is requiered in order to perform the download.

c. Uncompress the archive and copy "cuGSM_basic_lbr.h", "cuGSM_basic_lbr.ino", "cuGSM_SMS_lbr.h" and "cuGSM_SMS_lbr.ino" ("du3_basic_lbr.h", "du3G_basic_lbr.ino", "du3G_SMS_lbr.h" and "du3G_SMS_lbr.ino" - 4 d-u3G users, or "hnanoGSM_basic_lbr.h", "hnanoGSM_basic_lbr.ino", "hnanoGSM_SMS_lbr.h" and "hnanoGSM_SMS_lbr.ino" 4 the h-nanoGSM users) files to the folder previously created.

d. Copy the code bellow and make a file called "SMS_THERMAL_alarm_supervisor.ino" in the very same folder as above. Alternate, you can download from here (right click & save as):
SMS_THERMAL_alarm_supervisor.ino : ARDUINO THERMAL SMS ALARM & GSM/3G SHIELD - main code

SMS_THERMAL_alarm_supervisor.ino

1/*
2SMS_THERMAL_alarm_supervisor.ino v 0.3/20160114 - c-uGSM shield v 1.13 /d-u3G shield 1.13 SOFTAWARE EXAMPLE
3COPYRIGHT (c) 2015-2016 Dragos Iosub / R&D Software Solutions srl
4
5You are legaly entitled to use this SOFTWARE ONLY IN CONJUNCTION WITH c-uGSM or d-u3G DEVICES USAGE. Modifications, derivates and redistribution 
6of this software must include unmodified this COPYRIGHT NOTICE. You can redistribute this SOFTWARE and/or modify it under the terms 
7of this COPYRIGHT NOTICE. Any other usage may be permited only after written notice of Dragos Iosub / R&D Software Solutions srl.
8
9This SOFTWARE is distributed is provide "AS IS" in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied 
10warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
11
12Dragos Iosub, Bucharest 2016.
13http://itbrainpower.net
14*/
15
16
17#define du3GShieldUsage      //comment this if you use the c-uGSM shield
18
19static char phoneNumber[15] = "0712345678";   //destination number
20
21static char nunderstand[40] = "? enable cmd: #1, disable cmd:  #0.";
22static char armed[10] = "ARMED";
23static char unarmed[10] = "NOTARMED";
24static char boot[13] = "BOOT EVENT ";
25
26int keepAlivePeriod = 3600;       //send SMS at every keepAlivePeriod seconds
27int samplingPeriod = 15;       //interval in seconds between scans... keep it > 15 sec
28int lowTempLevel = 18;        //low temperature warning in C grades 
29int highTempLevel = 26;        //high temperature warning in C grades
30
31#define ONE_WIRE_BUS    4     //Arduino Digital pin used for 1Wire temperature sensor reading
32
33#ifdefined(du3GShieldUsage)       //for d-u3G hardware only!
34 //#define HARDWARERELEASE 1     //un-comment this only if module SN bw. 031000 032999 and comment the next one 
35 #define HARDWARERELEASE  2     //default mode! SN > 033000
36#endif
37/*#####NO PARAMS TO CHANGE BELLOW#####*/
38int warningStatus = 0;        //do not change it!
39
40#include <OneWire.h>
41#include <DallasTemperature.h>
42  
43// Setup a oneWire instance to communicate with any OneWire devices 
44// (not just Maxim/Dallas temperature ICs)
45OneWire oneWire(ONE_WIRE_BUS);
46 
47// Pass our oneWire reference to Dallas Temperature.
48DallasTemperature sensors(&oneWire);
49
50#define powerPIN         7  //Arduino Digital pin used to power up / power down the modem
51#define resetPIN         6  //Arduino Digital pin used to reset the modem 
52#define statusPIN        5  //Arduino Digital pin used to monitor if modem is powered 
53
54int supervisorMask = 1;   //mask temperature monitoring 1 - monitor enabled, 0 - monitor disabled
55
56#if defined (du3GShieldUsage)
57 #include "du3G_basic_lbr.h"
58 #include "du3G_SMS_lbr.h"
59#else
60 #include "cuGSM_basic_lbr.h"
61 #include "cuGSM_SMS_lbr.h"
62#endif
63
64#if (ARDUINO >= 100)
65 #include "Arduino.h"
66 #include <SoftwareSerial.h>
67#else
68 #include "WProgram.h"
69 #include <NewSoftSerial.h>
70#endif
71
72#define UNO_MODE                   //used by modem library
73#define BUFFDSIZE 162              //used by modem library
74
75SoftwareSerial agsmSerial(2, 3);   //RX==>2 ,TX soft==>3
76
77char ch;
78char buffd[BUFFDSIZE];
79char readBuffer[162];
80//static char mBuffer[162];
81int state=0, i=0, powerState = 0; 
82
83unsigned long startTime = 0;
84unsigned long lastSMSTime = 0;
85float temp = 0;
86
87void procRespose(char* msg){
88 int tempint = (int) temp;
89 float afterdot = temp - (float)tempint;
90 sprintf(readBuffer, "%s - Temperature is: %i.%i", msg, tempint, (int)(afterdot*100));
91 Serial.println(readBuffer);Serial.flush();delay(150);
92 sendSMS(phoneNumber, readBuffer);      //confirm command executed
93 delay(100);
94}
95
96void setup(){
97 Serial.begin(19200);     //start serial connection
98
99 pinMode(13, OUTPUT);     //configure the UNO D13 as output - UNO embedded LED used as ARMED/DISARMED status indicator  
100
101 agsmSerial.begin(9600);     //next, modem setup
102 clearagsmSerial();
103 clearSerial();
104 delay(10);
105
106 modemHWSetup();       //configure UNO IN and OUT to be used with modem
107
108 Serial.flush();
109 agsmSerial.flush();
110 delay(500);
111
112 Serial.println(F("wait until c-uGSM/d-u3G is ready"));
113 Serial.flush();
114
115 powerOnModem();
116
117 clearBUFFD();
118 while(strlen(buffd)<1){
119  getIMEI();
120  delay(500);
121 }
122
123 //Serial.println(F("modem is up. prepare it for SMS processing")); 
124 //Serial.flush();
125
126 ready4SMS = 0; 
127 ready4Voice = 0;
128
129 //Serial.print(F("modem IMEI: ")); Serial.flush();
130
131 setupMODEMforSMSusage();
132
133 Serial.println(F("modem ready.. let's proceed"));
134 Serial.flush();
135 delay(100);
136
137 supervisorMask = 1;  
138
139 sensors.begin();   //1Wire temperature sensor init
140
141 startTime  = 0;
142 lastSMSTime  = 0;
143 warningStatus = -100;  //force BOOT message
144}
145
146
147void loop(){
148 if (millis() - startTime < (unsigned long)samplingPeriod*1000){//waiting period
149  //process SMS commands - start
150  listSMS();            //find the last used SMS location
151  clearagsmSerial();
152  int cnt;
153  cnt = noSMS;
154  while (cnt>0){
155   readSMS(cnt);              //the SMS content will be returned in buffd 
156   //here process SMS the content - start
157
158   Serial.print(F("SMS content: "));Serial.flush();delay(50);
159   Serial.println(buffd);Serial.flush();delay(50);
160
161   delay(50);
162   clearagsmSerial();
163   delay(50);
164
165   if(strlen(buffd) > 0){            //non empty SMS
166    if(buffd[0] == '#' && buffd[1]== '1'){       //enable send SMS on  event detection
167     procRespose((char*)armed);
168     supervisorMask = 1;
169    }
170    else {
171     if(buffd[0]== '#' && buffd[1]== '0'){       //disable send SMS on event detection
172      procRespose((char*)unarmed);
173      supervisorMask = 0;
174     }else{               //unknown command
175      procRespose((char*)nunderstand);
176     }
177    }
178
179    deleteSMS(cnt);             //free the SMS location
180   }
181   //here process SMS the content - end
182   clearBUFFD();
183   clearagsmSerial();
184   cnt--;
185  }
186  //process SMS commands - stop
187  digitalWrite(13, supervisorMask);          //show ENABLED/DISABLED on Arduino LED
188  delay(250);
189 }
190 else{
191  startTime = millis();
192  
193  sensors.requestTemperatures();
194
195  temp = sensors.getTempCByIndex(0);
196
197  memset(readBuffer, 0x00, sizeof(readBuffer));
198  int tempint = (int) temp;
199  float afterdot = temp - (float)tempint;
200  
201  int sendSMScondition = 0;
202  if (temp < lowTempLevel){
203   if ((warningStatus != -1) || (millis() - lastSMSTime > (unsigned long)keepAlivePeriod/10*1000)){////ALERTS came 10 time faster than keep alive
204    sendSMScondition = 1;
205    lastSMSTime = millis();
206    if (warningStatus < -1) 
207     sprintf(readBuffer, boot);
208    warningStatus = -1;
209   }
210   sprintf(readBuffer, "%sLow temperature warning: ", readBuffer);
211  }
212  else if (temp > highTempLevel){
213   if ((warningStatus != 1) || (millis() - lastSMSTime > (unsigned long)keepAlivePeriod/10*1000)){//ALERTS came 10 time faster than keep alive
214    sendSMScondition = 1;
215    lastSMSTime = millis();
216    if (warningStatus < -1) 
217     sprintf(readBuffer, boot);
218    warningStatus = 1;
219   }
220   sprintf(readBuffer, "%sHigh temperature warning: ", readBuffer);
221  }
222  else{
223   if ((warningStatus != 0) || (millis() - lastSMSTime > (unsigned long)keepAlivePeriod*1000)){
224    sendSMScondition = 1;
225    lastSMSTime = millis();
226    if (warningStatus < -1) 
227     sprintf(readBuffer, boot);
228   }
229   sprintf(readBuffer, "%sNormal temperature: ", readBuffer);
230   warningStatus = 0;
231  }
232  sprintf(readBuffer, "%s %i.%i", readBuffer, tempint, (int)(afterdot*100));
233  Serial.println(readBuffer);
234  Serial.flush();
235
236  delay(150);
237  if(sendSMScondition > 0){
238   if(supervisorMask != 0) 
239    sendSMS(phoneNumber, readBuffer);      //send information
240   sendSMScondition = 0;
241  }
242
243 }
244}
245

e. Edit the "SMS_THERMAL_alarm_supervisor.ino" (double click on the file; this one will be open by the ARDUINO environment).
Write in your desired destination mobile number on line 19. (Before this you may check the supported SMS number format by your NMO, using our kickstart software.)
Input the desired values for the temperature thresholds, sampling and keepalive time. You may edit the SMS commands and the SMS messages assigned to the alarm events.
If you use one of the c-uGSM or h-nanoGSM shields: comment line 17.

 

Behaviour. How to use it.

#0 DISARM the ALARM, #1 ARM the ALARM. Any other received SMS, makes the ALARM to reply with a sort of "help message".
KEEP ALIVE SMS >> the thermal supervisor send an SMS (with STATUS and last temperature) at each "keepAlivePeriod" seconds, if the temperature it is placed inside the "lowTempLevel" and "highTempLevel" threshold interval, or at at each "keepAlivePeriod/10" seconds, if the temperature it is outside the interval (ALARM STATUS).

Arduino LED (D13) copy the ARM/DISARM status.

 

Usage areas

...some (crazy) sugestions:

  • newborn baby temperature monitoring.... JUST KIDDING GUYS!
  • home-brewed beer fermentation barel ;)
  • cellar temperature monitoring
  • aquariums monitoring
  • freezers
  • heaters
  • ...others. Anyway, always adapt the temperature sensor(s) to the environment (Eg.: liquids,..) or use proper encapsulated sensors.



TUTORIAL and SOFTWARE ARE PROVIDED WITHOUT ANY WARRANTY!!! USE IT AT YOUR OWN RISK!!!!

 

Possible improvements

  • Restrict SMS processing only from "phoneNumber" (master number)... Just look in the function readSMS (SMS library), after seacond readline(), the buffd variable contains the SMS header (sender number, date+time).. Just processe there in order to extract the SMS sender number...
  • Add additional temperature threshold levels, in order control and compensate the temperature drift using one or more PELTIER CELLS via a Arduino digital output plus a TIP122 in open collector configuration or a relay??

 

 

 

 

Dragos Iosub & itbrainpower.net team original how to.

 

 

 

 

document version 1.02 / 2016-08-22 © R&D Software Solutions srl