add mechanical stuff

Hohm_Phone.ino

@@ -1,249 +1,211 @@
-#include "avr/sleep.h"
+#include "avr/sleep.h"
-#include "Adafruit_FONA.h"
+#include "Adafruit_FONA.h"
-#include "Keypad.h"
+#include "Keypad.h"
-
+
-////////////////////////////////
+////////////////////////////////
-////////// PARAMETERS //////////
+////////// PARAMETERS //////////
-////////////////////////////////
+////////////////////////////////
-
+
-// Arduino will wake from sleep when WAKE_PIN is pulled low. Connect any waking buttons to WAKE_PIN
+#define LED_BAT_LOW 3
-#define WAKE_PIN 2
+#define LED_NO_SERVICE 2
-
+
-#define BUT_ANS A3
+#define BUT_ANS A3
-#define BUT_END A4
+#define BUT_END A4
-
+
-// RX/TX are in reference to the Arduino, not SIM800
+#define GSM_RST A2
-#define GSM_RX 3
+#define GSM_RING A5
-#define GSM_TX 11
+#define GSM_BAUDRATE 115200
-#define GSM_RST A2
+
-#define GSM_RING A5
+// Low battery light threshold
-
+#define CHG_VLO 3800
-// TIMEOUT_SLEEP is the time to stay awake from last activity until sleep (milliseconds)
+
-#define TIMEOUT_SLEEP 6000
+// Time in miliseconds to stop listening for keypad input
-
+#define SLEEP_TIMEOUT 120000
-// Charging voltage thresholds. Will turn on charging at CHG_VLO and turn off charging at CHG_VHI (millivolts)
+
-#define CHG_VLO 3900
+// RSSI value below which No Service LED will light
-#define CHG_VHI 4100
+#define RSSI_THRESHOLD 1
-#define CHG_PIN A0
+
-
+// Keypad pinout
-// Comment the following line to use HW serial for Fona and disable debugging information
+byte rowPins[4] = {5, 10, 9, 7};
-#define USB_DEBUG
+byte colPins[3] = {6, 4, 8};
-
+
-// Comment the following line to disable sleeping the Arduino
+////////////////////////////////////
-//#define SLEEP
+////////// END PARAMETERS //////////
-
+////////////////////////////////////
-// Keypad pinout
+
-byte rowPins[4] = {9, 4, 5, 7};
+char phoneNumber[15] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
-byte colPins[3] = {8, 10, 6};
+int phoneNumberLength = 0;
-
+
-////////////////////////////////////
+char keys[4][3] = {
-////////// END PARAMETERS //////////
+  {'1', '2', '3'},
-////////////////////////////////////
+  {'4', '5', '6'},
-
+  {'7', '8', '9'},
-char phoneNumber[15] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
+  {'*', '0', '#'}
-int phoneNumberLength = 0;
+};
-
+
-char keys[4][3] = {
+unsigned long lastActiveTime;
-  {'1', '2', '3'},
+bool dialtoneActive = false;
-  {'4', '5', '6'},
+bool startDialtone = false;
-  {'7', '8', '9'},
+bool awake = true;
-  {'*', '0', '#'}
+
-};
+HardwareSerial *fonaSerial = &Serial;
-
+Adafruit_FONA fona = Adafruit_FONA(GSM_RST);
-unsigned long lastActiveTime;
+Keypad keypad = Keypad( makeKeymap(keys), rowPins, colPins, 4, 3 );
-bool dialtoneActive = false;
+
-bool startDialtone = false;
+///////////////////////////////
-
+////////// FUNCTIONS //////////
-#ifdef USB_DEBUG
+///////////////////////////////
-#include "SoftwareSerial.h"
+
-SoftwareSerial fonaSS = SoftwareSerial(GSM_RX, GSM_TX);
+void inCall() {
-SoftwareSerial *fonaSerial = &fonaSS;
+  while (1) {
-#else
+    if ( !digitalRead(BUT_END) || fona.getCallStatus() < 3 ) { // End button pressed
-HardwareSerial *fonaSerial = &Serial;
+      fona.hangUp();
-#endif
+      break;
-
+    }
-Adafruit_FONA fona = Adafruit_FONA(GSM_RST);
+
-Keypad keypad = Keypad( makeKeymap(keys), rowPins, colPins, 4, 3 );
+    // numpad stuff
-
+  }
-
+  clearPhoneNumber();
-///////////////////////////////
+  startDialtone = true;
-////////// FUNCTIONS //////////
+  lastActiveTime = millis();
-///////////////////////////////
+  delay(100);
-
+}
-void wakeFromSleep() {
+
-  sleep_disable();
+void beginCall() {
-  detachInterrupt(WAKE_PIN);
+  fona.sendCheckReply( F("AT+STTONE=0"), F("OK") ); // End dialtone
-#ifdef USB_DEBUG
+  dialtoneActive = false;
-  Serial.println("Woke up");
+  if ( fona.callPhone( phoneNumber ) ) {
-#endif
+    inCall();
-  startDialtone = true;
+  }
-}
+}
-
+
-void goToSleep() {
+void resumeDialtone() {
-#ifdef USB_DEBUG
+  fona.sendCheckReply( ("AT+STTONE=1,20," + String(SLEEP_TIMEOUT)).c_str(), "OK" ); // Start dialtone
-  Serial.println("Going to sleep");
+  dialtoneActive = true;
-#endif
+}
-  sleep_enable();
+
-  attachInterrupt(WAKE_PIN, wakeFromSleep, LOW);
+void clearPhoneNumber() {
-  set_sleep_mode(SLEEP_MODE_PWR_DOWN);
+  for ( int j = 0; j < phoneNumberLength; j++) {
-  cli();
+    phoneNumber[j] = 0;
-  sleep_bod_disable();
+  }
-  sei();
+  phoneNumberLength = 0;
-  sleep_cpu();
+}
-}
+
-
+void goToSleep() {
-void inCall() {
+  digitalWrite( LED_NO_SERVICE, LOW );
-  while (1) {
+  digitalWrite( LED_BAT_LOW, LOW );
-    if ( !digitalRead(BUT_END) || fona.getCallStatus() < 3 ) { // End button pressed
+  awake = false;
-      fona.hangUp();
+}
-#ifdef USB_DEBUG
+
-      Serial.println("Hanging up");
+//////////////////////////////////
-#endif
+///// ARDUINO CORE FUNCTIONS /////
-      break;
+//////////////////////////////////
-    }
+
-
+void setup() {
-    // numpad stuff
+  pinMode( BUT_ANS, INPUT_PULLUP );
-  }
+  pinMode( BUT_END, INPUT_PULLUP );
-  for ( int j = 0; j < phoneNumberLength; j++) {
+  pinMode( GSM_RST, OUTPUT );
-    phoneNumber[j] = 0;
+  pinMode( GSM_RING, INPUT_PULLUP );
-  }
+  pinMode( LED_BAT_LOW, OUTPUT);
-  phoneNumberLength = 0;
+  pinMode( LED_NO_SERVICE, OUTPUT);
-  startDialtone = true;
+
-}
+  digitalWrite( LED_BAT_LOW, HIGH );
-
+  digitalWrite( LED_NO_SERVICE, HIGH );
-void beginCall() {
+
-#ifdef USB_DEBUG
+  digitalWrite( GSM_RST, HIGH );
-  Serial.println("Starting Call");
+  fonaSerial->begin(GSM_BAUDRATE);
-#endif
+  if (! fona.begin(*fonaSerial)) {
-  fona.sendCheckReply( F("AT+STTONE=0"), F("OK") ); // End dialtone
+    while (1); //fona didn't start
-  dialtoneActive = false;
+    digitalWrite( LED_BAT_LOW, HIGH );
-  if ( fona.callPhone( phoneNumber ) ) {
+  }
-#ifdef USB_DEBUG
+
-    Serial.println("Call Started");
+  startDialtone = true;
-#endif
+  lastActiveTime = millis();
-    inCall();
+
-  }
+  fona.sendCheckReply( F("AT+CLVL=100"), F("OK") ); // set volume
-#ifdef USB_DEBUG
+
-  Serial.println("Call ended");
+  digitalWrite( LED_BAT_LOW, LOW );
-#endif
+  digitalWrite( LED_NO_SERVICE, LOW );
-}
+}
-
+
-void resumeDialtone() {
+void loop() {
-  fona.sendCheckReply( F("AT+STTONE=1,20,30000" ), F("OK") ); // Start dialtone
+  if ( awake ) {
-  dialtoneActive = true;
+
-}
+    // Handle Incoming Call
-
+    if ( !digitalRead(GSM_RING) ) {
-//////////////////////////////////
+      while ( digitalRead(BUT_ANS) & digitalRead(BUT_END) & !digitalRead(GSM_RING) ) delay(10); // Wait for answer button or end ring/call
-///// ARDUINO CORE FUNCTIONS /////
+      if ( !digitalRead(BUT_ANS) ) {
-//////////////////////////////////
+        fona.pickUp();
-
+        delay(100);
-void setup() {
+        inCall();
-#ifdef USB_DEBUG
+      } else if( !digitalRead(BUT_END) ) {
-  Serial.begin(9600);
+        fona.hangUp();
-  Serial.println("Booted. Setting up");
+        clearPhoneNumber();
-#endif
+        startDialtone = true;
-  pinMode( WAKE_PIN, INPUT_PULLUP );
+        delay(100);
-  pinMode( BUT_ANS, INPUT_PULLUP );
+        resumeDialtone();
-  pinMode( BUT_END, INPUT_PULLUP );
+        lastActiveTime = millis();
-  pinMode( GSM_RST, OUTPUT );
+      }
-  pinMode( GSM_RING, INPUT_PULLUP );
+    }
-  pinMode( CHG_PIN, OUTPUT );
+
-
+    // Begin dialtone if necessary
-  digitalWrite( GSM_RST, HIGH );
+    if ( startDialtone ) {
-  digitalWrite( CHG_PIN, HIGH );
+      resumeDialtone();
-
+      startDialtone = false;
-  fonaSerial->begin(4800);
+    }
-  if (! fona.begin(*fonaSerial)) {
+
-#ifdef USB_DEBUG
+    // Read keypad input
-    Serial.println("Fona failed to respond");
+    char key = keypad.getKey();
-#endif
+    if ( key != NO_KEY ) {
-    while (1); //fona didn't start
+      phoneNumber[ phoneNumberLength ] = key;
-  }
+      phoneNumberLength = phoneNumberLength + 1;
-  while ( !fona.setAudio(FONA_EXTAUDIO) ) {}
+
-
+      if ( dialtoneActive ) {
-#ifdef USB_DEBUG
+        fona.sendCheckReply( F("AT+STTONE=0"), F("OK") ); // End dialtone
-  Serial.println("Setup Complete");
+        dialtoneActive = false;
-#endif
+        delay(100);
-  startDialtone = true;
+      }
-  lastActiveTime = millis();
+      fona.playDTMF( key );  // Play DTMF tone
-
+
-  fona.sendCheckReply( F("AT+CLVL=20"), F("OK") ); // set dialtone volume
+      lastActiveTime = millis();
-}
+      // Check for complete phone number (including +1 country code)
-
+      if ( ( phoneNumberLength == 10 & phoneNumber[0] != '1' ) || phoneNumberLength > 10 ) {
-void loop() {
+        beginCall();
-  if ( !digitalRead(GSM_RING) ) {
+      }
-    while ( digitalRead(BUT_ANS) & !digitalRead(GSM_RING) ) delay(10); // Wait for answer button or end ring/call
+    }
-    if ( !digitalRead(BUT_ANS) ) {
+
-      fona.pickUp();
+    // Clear stored phone number on press of end button
-      delay(100);
+    if ( !digitalRead(BUT_END) ) {
-      inCall();
+      clearPhoneNumber();
-    }
+      resumeDialtone();
-  }
+    }
-
+
-  if ( startDialtone ) {
+    // Indicator LEDs
-    resumeDialtone();
+    uint16_t vbat;
-    startDialtone = false;
+    fona.getBattVoltage(&vbat);
-  }
+    if ( vbat < CHG_VLO ) {
-
+      digitalWrite( LED_BAT_LOW, HIGH );
-  // Read from keypad
+    } else {
-  char key = keypad.getKey();
+      digitalWrite( LED_BAT_LOW, LOW );
-  if ( key != NO_KEY ) {
+    }
-    phoneNumber[ phoneNumberLength ] = key;
+
-    phoneNumberLength = phoneNumberLength + 1;
+    uint8_t rssi;
-
+    rssi = fona.getRSSI();
-    if ( dialtoneActive ) {
+    if ( rssi < RSSI_THRESHOLD || rssi == 99 ) {
-      fona.sendCheckReply( F("AT+STTONE=0"), F("OK") ); // End dialtone
+      digitalWrite( LED_NO_SERVICE, HIGH );
-      dialtoneActive = false;
+    } else {
-      delay(50);
+      digitalWrite( LED_NO_SERVICE, LOW );
-    }
+    }
-    fona.playDTMF( key );  // Play DTMF tone
+
-
+    // If inactive, sleep
-    lastActiveTime = millis();
+    if ( (long)(millis() - lastActiveTime) > SLEEP_TIMEOUT ) {
-#ifdef USB_DEBUG
+      goToSleep();
-    int i;
+    }
-    for (i = 0; i < 15; i = i + 1) {
+  } else {
-      Serial.print(phoneNumber[i]);
+    // sleeping
-      Serial.print(", ");
+    if ( !digitalRead( BUT_ANS ) || !digitalRead( BUT_END ) || !digitalRead( GSM_RING )  ) {
-    }
+      lastActiveTime = millis();
-    Serial.println(phoneNumberLength);
+      awake = true;
-#endif
+    }
-    // Check for complete phone number (including +1 country code)
+  }
-    if ( ( phoneNumberLength == 10 & phoneNumber[0] != '1' ) || phoneNumberLength > 10 ) {
+}
-      beginCall();
-    }
-  }
-
-
-  // Clear stored phone number on press of end button
-  if ( !digitalRead(BUT_END) ) {
-    for ( int j = 0; j < phoneNumberLength; j++) {
-      phoneNumber[j] = 0;
-    }
-    phoneNumberLength = 0;
-#ifdef USB_DEBUG
-    Serial.println( phoneNumberLength );
-#endif
-    resumeDialtone();
-  }
-
-  uint16_t vbat;
-  fona.getBattVoltage(&vbat);
-  if ( vbat < CHG_VLO ) {
-    digitalWrite( CHG_PIN, HIGH );
-  } else if ( vbat > CHG_VHI ) {
-    digitalWrite( CHG_PIN, LOW );
-  }
-
-#ifdef SLEEP
-  // Autoshutdown if inactive for extended period
-  // Typecast to long avoids "rollover" issues
-  if ( (long)(millis() - lastActiveTime) > TIMEOUT_SLEEP ) {
-    goToSleep();
-  }
-#endif
-}
-
-
-
-
-

README.md

@@ -1,10 +1,10 @@
-# Hohm-Phone
+# Hohm-Phone
-
+
-## Hardware Connections
+## Hardware Connections
--->|-- Indicates diode
+-->|-- Indicates diode
-
+
-WAKE_PIN -->|-- GSM_RING --- RI(Fona)  
+WAKE_PIN -->|-- GSM_RING --- RI(Fona)  
-WAKE_PIN -->|-- BUT_ANS ---- Button --- GND  
+WAKE_PIN -->|-- BUT_ANS ---- Button --- GND  
-WAKE_PIN -->|-- BUT_END ---- Button --- GND  
+WAKE_PIN -->|-- BUT_END ---- Button --- GND  
-
+
-BUT_ANS and BUT_END have pull up resistors
+BUT_ANS and BUT_END have pull up resistors

hardware/DTMF_Research.bib

@@ -0,0 +1,54 @@
+@misc{ wiki:DTMF,
+   author = "Wikipedia",
+   title = "Dual-tone multi-frequency signaling",
+   year = "2016",
+   url = "https://en.wikipedia.org/wiki/Dual-tone_multi-frequency_signaling",
+   note = "[Online; accessed 27-August-2016]"
+ }
+
+@misc{ wiki:Goertzel,
+   author = "Wikipedia",
+   title = "Goertzel algorithm",
+   year = "2016",
+   url = "https://en.wikipedia.org/wiki/Goertzel_algorithm",
+   note = "[Online; accessed 27-August-2016]"
+ }
+
+@misc{ wiki:FIR,
+   author = "Wikipedia",
+   title = "Finite impulse response",
+   year = "2016",
+   url = "https://en.wikipedia.org/wiki/Finite_impulse_response",
+   note = "[Online; accessed 27-August-2016]"
+ }
+
+@misc{ wiki:IIR,
+   author = "Wikipedia",
+   title = "Infinite impulse response",
+   year = "2016",
+   url = "https://en.wikipedia.org/wiki/Infinite_impulse_response",
+   note = "[Online; accessed 27-August-2016]"
+ }
+
+@misc{ wiki:Nyquist-Shannon,
+   author = "Wikipedia",
+   title = "Nyquist–Shannon sampling theorem",
+   year = "2016",
+   url = "https://en.wikipedia.org/wiki/Nyquist%E2%80%93Shannon_sampling_theorem",
+   note = "[Online; accessed 27-August-2016]"
+ }
+
+@misc{ wiki:Z-transform,
+   author = "Wikipedia",
+   title = "Z-transform",
+   year = "2016",
+   url = "https://en.wikipedia.org/wiki/Z-transform",
+   note = "[Online; accessed 27-August-2016]"
+ }
+
+@article{ DTMF_genave,
+   author = "Genave.com",
+   title = "DTMF Explained",
+   url = "http://www.genave.com/dtmf.htm",
+   note = "[Online; accessed 27-August-2016]"
+}

hardware/DTMF_Research.tex

@@ -0,0 +1,66 @@
+\documentclass[12pt]{article}
+\usepackage[margin=1in]{geometry}
+\usepackage{parskip}
+\usepackage{cite}
+\usepackage{url}
+\usepackage{arydshln}
+\usepackage{amsmath}
+
+\begin{document}
+\title{Dual-Tone Multi-Frequency Signaling}
+\author{Brendan Haines}
+\maketitle
+
+\section{Encoding}
+Dual-Tone Multi Frequency Signaling uses audible tones as opposed to digital signals due to the nature of the mediums they are broadcast over. Since DTMF is often used with radio phones as well as traditional "landline" telephones, and these technologies are designed to carry voice well, staying within the same frequency range reduces complexity and expense of specialized equipment at both the transmitting and receiving stations. Often, the speaker output of a radio can simply be plugged into a decoder with no additional specialized hardware, resulting in lower equipment costs\cite{DTMF_genave}.
+
+\subsection{Frequencies\cite{wiki:DTMF}}
+\begin{tabular}{|c c c : c | l |}
+	\hline
+	1 & 2 & 3 & A & 687 Hz \\
+	4 & 5 & 6 & B & 770 Hz\\
+	7 & 8 & 9 & C & 852 Hz\\
+	$\ast$ & 0 & \# & D & 941 Hz\\
+	\hline
+	1209 Hz & 1336 Hz & 1477 Hz & 1633 Hz \\
+	\cline{1-4}
+\end{tabular}
+
+The A, B, C, and D keys are omitted on most handsets however are often used for automation purposes for triggering of remote functions such as controling an amateur radio repeater during an active phone call\cite{wiki:DTMF}. 
+
+\subsection{Timing}
+DTF uses a "mark" (amplitude $\neq$ 0) followed by a "space" (amplitude = 0). Timing can vary widely depending on the system being used. For example, when using a manual encoder such as an ordinary telephone each button press will create a mark and the time between presses will be spaces. Higher speeds can be achieved using automatic or "store and forward" DTMF encoders. Motorola uses a standard of 250ms mark and 250ms space, and other systems include 40ms/20ms or 20ms/20ms mark and space respectively\cite{DTMF_genave}.
+
+\section{Decoding}
+Originally decoded using tuned filter banks, however DSP now dominates decoding and the Goertzel algorthim is often used\cite{wiki:DTMF}.
+
+\subsection{Goertzel Algorithm}
+The Goertzel algorithm or Goertzel filter uses the Discrete Fourier Transform (DFT) to evaluate frequency content of a signal at specific frequencies very efficiently. Although the Fast Fourier Transform (FFT) is more efficient for analyzing a complete spectrum of frequency, in the case where only a few frequencies are relevant (such as the 8 DTMF frequencies), the Goertzel algorithm is more numerically efficient. It works well even on small processors in embedded applications\cite{wiki:Goertzel}
+
+Where $x[n]$ is the $n^{th}$ sample and $\omega _{0}$ is frequency in radians per sample, an intermediate sequence $s[n]$:
+$$s[-2]=s[-1]=0$$
+\begin{equation} \label{eqn:stage_1_goertzel}
+s[n] = x[n] + 2 cos(\omega _{0})s[n-1] - s[n-2]
+\end{equation}
+
+The second stage of the Goertzel filter applies to $s[n]$, producing output sequence $y[n]$:
+\begin{equation} \label{eqn:stage_2_goertzel}
+y[n] = s[n] - e^{-j\omega _{0}}s[n-1]
+\end{equation}
+
+A Z-transform converts a discrete-time signal to a complex frequency domain\cite{wiki:Z-transform}. It can be applied to equations \ref{eqn:stage_1_goertzel} and \ref{eqn:stage_2_goertzel} respectively:
+\begin{align} \label{eqn:z_goertzel}
+\frac{S(z)}{X(z)} &= \frac{1}{1-2cos(\omega _{0})z^{-1} + z^{-2}}\nonumber\\
+&= \frac{1}{(1-e^{+j\omega _{0}} z^{-1})(1 - e^{-j\omega _{0}}z^{-1})}\\
+\frac{Y(z)}{S(z)} &= 1 - e^{-j\omega _{0}} z^{-1}
+\end{align}
+
+The combined transfer function of the cascade of the two filters:
+\begin{align} \label{eqn:z_combined_goertzel}
+\frac{S(z)}{X(z)}\frac{Y(z)}{S(z)} = \frac{Y(z)}{X(z)} &= \frac{(1-e^{-j\omega _{0}}z^{-1})}{(1-e^{+j\omega _{0}} z^{-1})(1 - e^{-j\omega _{0}}z^{-1})}\nonumber\\
+&= \frac{1}{(1-e^{+j\omega _{0}} z^{-1})}
+\end{align}
+
+\bibliography{DTMF_Research}{}
+\bibliographystyle{IEEEtran}
+\end{document}

hardware/DTMF_Research_bib.txt

@@ -0,0 +1,3 @@
+@article{ wikipedia_DTMF
+	title="DTMF"
+}