From 6540b2f2f044d889f20bb7b84f2c6552af713ad4 Mon Sep 17 00:00:00 2001 From: starcalc Date: Thu, 26 Apr 2018 18:10:33 +0200 Subject: [PATCH] Initial commit --- README.markdown | 42 +++++++++++ RotaryDialer.cpp | 100 +++++++++++++++++++++++++ RotaryDialer.h | 71 ++++++++++++++++++ examples/dialtoserial/dialtoserial.pde | 22 ++++++ 4 files changed, 235 insertions(+) create mode 100644 README.markdown create mode 100644 RotaryDialer.cpp create mode 100644 RotaryDialer.h create mode 100644 examples/dialtoserial/dialtoserial.pde diff --git a/README.markdown b/README.markdown new file mode 100644 index 0000000..1e88cdb --- /dev/null +++ b/README.markdown @@ -0,0 +1,42 @@ +Rotary Dial +=========== + +Arduino library to read numbers from a rotary dial (or otherwise using pulse dialing; see [Wikipedia: Rotary dial](http://en.wikipedia.org/wiki/Rotary_dial)). + +![front of a rotary telephone dial](http://www.markfickett.com/umbrella/images/111105rotarydialfront-sm.jpg "Rotary Dial") + +This implementation is for the North American system, where [1, 9] pulses correspond to the numbers [1, 9], and 0 is represented by 10 pulses. This library was written for use with the dial [demonstrated here](http://commons.wikimedia.org/wiki/File:Rotary_Dial,_Dialing_Back_with_LEDs.ogv) and pictured above. + +Connection & Circuit +-------------------- + +On the back of the dial are two connections relevant for this implementation. One (the 'ready' switch) is normally open (NO), and is closed whenever the rotor is not at rest (specifically, as soon as the user draws back the rotor, and until it finishes returning). The other (the 'pulse' switch) is normally closed (NC), and is opened briefly for each pulse (roughly 10 - 20 Hz). + +The expected circuit is: + + Rotary Dial Arduino + /---------------------- readyPin + /- ready switch (NO) -- pull-up resistor -- VCC + /-- pulse switch (NC) -- pull-up resistor -/ + \ \---------------------- pulsePin + \------------------------------------------ GND + +The expected sequence is: + + readyPin pulsePin state + HIGH n/a default (waiting) + LOW LOW ready to dial / for first pulse + LOW HIGH pulse received (number = 1) + LOW LOW ready for next pulse + LOW HIGH pulse received (number = 2) + LOW ... (repeat) + HIGH n/a rotation complete, count recorded + +There is 15ms allowed for debounce, which is the implementation's only +constraint on pulse speed. + +See Also +-------- + +See also: [USB output from the Arduino](http://www.arduino.cc/playground/Main/InterfacingWithHardware#USB), including [presenting the Arduino as a keyboard by installing new firmware](http://hunt.net.nz/users/darran/?tag=keyboard). + diff --git a/RotaryDialer.cpp b/RotaryDialer.cpp new file mode 100644 index 0000000..902b30e --- /dev/null +++ b/RotaryDialer.cpp @@ -0,0 +1,100 @@ +#include "RotaryDialer.h" + +#if defined(ARDUINO) && ARDUINO >= 100 +#include "Arduino.h" +#else +#include "WProgram.h" +#endif + +#define NO_NUMBER -1 + +// Require DEBOUNCE_DELAY milliseconds between state changes. This value is +// noted in the class documentation. +#define DEBOUNCE_DELAY 15 + +RotaryDialer::RotaryDialer(int readyPin, int pulsePin) : + pinReady(readyPin), pinPulse(pulsePin), hasCompletedNumber(false), + state(WAITING) +{ } + +void RotaryDialer::setup() { + pinMode(pinReady, INPUT); + pinMode(pinPulse, INPUT); + digitalWrite(pinReady, HIGH); + digitalWrite(pinPulse, HIGH); + lastStateChangeMillis = millis(); +} + +bool RotaryDialer::changeStateIfDebounced(enum State newState) { + unsigned long currentMillis = millis(); + if (currentMillis < lastStateChangeMillis) { + // clock wrapped; ignore (but could figure it out in this case) + lastStateChangeMillis = currentMillis; + return false; + } else if (currentMillis - lastStateChangeMillis > DEBOUNCE_DELAY) { + state = newState; + lastStateChangeMillis = currentMillis; + return true; + } else { + return false; + } +} + +void RotaryDialer::completeDial() { + if (!changeStateIfDebounced(WAITING)) { + return; + } + if (number > 0 && number <= 10) { + if (number == 10) { + number = 0; + } + hasCompletedNumber = true; + } +} + +bool RotaryDialer::update() { + int readyStatus = digitalRead(pinReady); + int pulseStatus = digitalRead(pinPulse); + + switch(state) { + case WAITING: + if (readyStatus == LOW + && changeStateIfDebounced(LISTENING_NOPULSE)) + { + hasCompletedNumber = false; + number = 0; + } + break; + case LISTENING_NOPULSE: + if (readyStatus == HIGH) { + completeDial(); + } else if (pulseStatus == HIGH) { + changeStateIfDebounced(LISTENING_PULSE); + } + break; + case LISTENING_PULSE: + if (readyStatus == HIGH) { + completeDial(); + } else if (pulseStatus == LOW + && changeStateIfDebounced(LISTENING_NOPULSE)) + { + number++; + } + break; + } + return hasCompletedNumber; +} + +bool RotaryDialer::hasNextNumber() { + return hasCompletedNumber; +} + +int RotaryDialer::getNextNumber() { + if (hasCompletedNumber) { + hasCompletedNumber = false; + return number; + } else { + return NO_NUMBER; + } +} + diff --git a/RotaryDialer.h b/RotaryDialer.h new file mode 100644 index 0000000..ff1b7c2 --- /dev/null +++ b/RotaryDialer.h @@ -0,0 +1,71 @@ +#pragma once + +/** + * Read numbers from a rotary dial (or otherwise using pulse dialing; see + * http://en.wikipedia.org/wiki/Rotary_dial ). + * + * See the README for further documentation. + */ +class RotaryDialer { + private: + int pinReady; + int pinPulse; + bool hasCompletedNumber; + int number; + + enum State { + WAITING, + LISTENING_NOPULSE, + LISTENING_PULSE + }; + enum State state; + unsigned long lastStateChangeMillis; + + /** + * Change state, but only if enough time has elapsed since + * the last state change (to protect from noise). + */ + bool changeStateIfDebounced(enum State newState); + + /** + * To be called when ready returns HIGH (when the rotor returns + * to its rest position); save the number, if valid. + */ + void completeDial(); + public: + /** + * Create a new RotaryDialer listening on the given pins. + * @param readyPin connected to a NO (HIGH) switch on the rotor + * which is closed (LOW) during dialing + * @param pulsePin connected to a NC (LOW) switch on the rotor + * which is opened (HIGH) during each pulse + */ + RotaryDialer(int readyPin, int pulsePin); + + /** + * Initialize the pins; digital read pins, held HIGH. + */ + void setup(); + + /** + * Check the pins and update state (in or out of a pulse, + * dialing complete, etc). This must be called at least as + * pulses; assuming 10 pulses per second, every 50ms. + */ + bool update(); + + /** + * @return whether a new number has been dialed since the last + * getNextNumber call + */ + bool hasNextNumber(); + + /** + * Get the most recently dialed number. After this is called, + * hasNextNumber will return false until a new number is dialed. + * @return the most recently dialed number, and clear + * hasNextNumber + */ + int getNextNumber(); +}; + diff --git a/examples/dialtoserial/dialtoserial.pde b/examples/dialtoserial/dialtoserial.pde new file mode 100644 index 0000000..bcdea9c --- /dev/null +++ b/examples/dialtoserial/dialtoserial.pde @@ -0,0 +1,22 @@ +/** + * Print each digit over Serial as it is dialed. + * See the README for detailed documentation. + */ + +#include + +#define PIN_READY 8 +#define PIN_PULSE 9 + +RotaryDialer dialer = RotaryDialer(PIN_READY, PIN_PULSE); + +void setup() { + Serial.begin(28800); + dialer.setup(); +} + +void loop() { + if (dialer.update()) { + Serial.println(dialer.getNextNumber()); + } +}