Revision 0:5c6eb2d20a5a, committed 2011-02-19

Comitter:

p07gbar

Date:

Sat Feb 19 14:27:21 2011 +0000

Child:

1:e94a73b015cc

Commit message:

V1.0

Changed in this revision

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Flasher.cpp	Sat Feb 19 14:27:21 2011 +0000
@@ -0,0 +1,139 @@
+/*Small library to debug and alert with a single LED
+* Copyright (c) 2011 p07gbar
+*
+* Permission is hereby granted, free of charge, to any person obtaining a copy
+* of this software and associated documentation files (the "Software"), to deal
+* in the Software without restriction, including without limitation the rights
+* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+* copies of the Software, and to permit persons to whom the Software is
+* furnished to do so, subject to the following conditions:
+*
+* The above copyright notice and this permission notice shall be included in
+* all copies or substantial portions of the Software.
+*
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+* THE SOFTWARE.
+*
+*/
+
+#include "Flasher.h"
+
+Flasher::Flasher(PinName pin, int startState):_led(pin)
+{
+    state = checkState(startState);
+    flashTimes[0] = 10;
+    flashTimes[1] = 10;
+    flashTimes[2] = 2;
+    flashTimes[3] = 1;
+    flashTimes[4] = 0.3;
+    flashbase.attach(this, &Flasher::tick, flashTimes[state]);
+    active = true;    
+    tick();
+}
+
+void Flasher::updateFlash(int statein)
+{
+    state = checkState(statein);
+    flashbase.attach(this, &Flasher::tick, flashTimes[state]);
+    tick();
+}
+
+int Flasher::getState()
+{
+    return state;
+}
+
+void Flasher::pauseFor(float time)
+{
+    active = false;
+    forTime = time;
+    returntoState = state;
+    flashbase.detach();
+    forbase.attach(this, &Flasher::timeout, time);
+}
+
+void Flasher::onFor(float time,int newState, int returnState = 0)
+{
+    active = true;
+    state = checkState(newState);
+    returntoState = checkState(returnState);
+    flashbase.attach(this, &Flasher::tick, flashTimes[state]);
+    forTime = time;
+    forbase.attach(this, &Flasher::timeout, time);
+}
+
+void Flasher::pause()
+{
+    active = false;
+    _led = 0;
+    flashbase.detach();
+    forbase.detach();
+}
+
+void Flasher::resume()
+{
+    active = true;
+    flashbase.attach(this, &Flasher::tick, flashTimes[state]);
+}
+
+void Flasher::setFlashTime(int statein, float newTime)
+{
+    flashTimes[checkState(statein)] = newTime;
+}
+
+float Flasher::getFlashTime(int statein)
+{
+    float toRet = flashTimes[checkState(statein)];
+    return toRet;
+}
+
+void Flasher::tick()
+{
+    if(active)
+    {
+        switch(state)
+        {
+            case 0:
+            _led = 0;
+            break;
+            case 1:
+            _led = 1;
+            break;
+            case 2:
+            case 3:
+            case 4:
+            _led = !_led;
+            break;
+            default:
+            _led = 0;
+            break;
+        }
+    }
+}
+
+void Flasher::timeout()
+{
+    active = true;
+    state = returntoState;
+    forTime = 0;
+    flashbase.attach(this, &Flasher::tick, flashTimes[state]);
+    forbase.detach();
+    tick();
+}
+
+int Flasher::checkState(int statein)
+{
+    if(statein > NUMSTATES || statein < 0)
+    {
+        return 0;
+    }
+    else 
+    {
+        return statein;
+    }
+}

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Flasher.h	Sat Feb 19 14:27:21 2011 +0000
@@ -0,0 +1,181 @@
+/* Small library to debug and alert with a single LED
+ * Copyright (c) 2011 p07gbar
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+#ifndef FLASHER_H
+#define FLASHER_H
+
+#include "mbed.h"
+
+#define NUMSTATES 5
+#define OFF 0
+#define ON 1
+#define SLOW 2
+#define MEDIUM 3
+#define QUICK 4
+#define FAST 4
+
+/** A LED Flasher class based on Ticker and Timeout
+ *  
+ * States are defined in words:
+ * 
+ * OFF, ON, SLOW, MEDIUM, QUICK or FAST
+ * 
+ * With default times of (in seconds):
+ * 
+ * Slow: 2
+ * 
+ * Medium: 1
+ * 
+ * Fast/Quick: 0.3
+ * 
+ *
+ * Example:
+ * @code
+ * // Switches LED1 through the different modes
+ * #include "mbed.h"
+ * #include "Flasher.h"
+ * 
+ * Flasher myFlasher(LED1, OFF); //Defines myFlasher on LED1 starting off
+ * 
+ * int main() {
+ *      while(1){   
+ *          wait(5);
+ *          myFlasher.updateFlash(ON);
+ *          wait(5);
+ *          myFlasher.updateFlash(SLOW);
+ *          wait(5);
+ *          myFlasher.updateFlash(MEDIUM);
+ *          wait(5);
+ *          myFlasher.updateFlash(QUICK);
+ *          wait(5);
+ *          myFlasher.onFor(3,ON,MEDIUM);
+ *          wait(5);
+ *          myFlasher.pauseFor(2);
+ *          wait(5);
+ *          myFlasher.updateFlash(OFF);
+ *      }
+ *  }
+ * @endcode
+ */
+
+
+class Flasher {
+
+public:
+
+/** Create a Flasher object attached to the specified Pin and Start State
+ *
+ * @param pin DigitalOut pin to connect the LED to
+ * @param startState State for the object to start in
+ *
+ */
+Flasher(PinName pin, int startState);
+
+/** Set new state for the obeject
+ *
+ * @param statein New State for the object
+ */
+ 
+void updateFlash(int statein);
+
+/** Read the current state of the object
+ * 
+ * @param returns The current state
+ */
+ 
+int getState();
+
+/** Turn the LED off for a specified period, returns to old state
+ * 
+ * @param time Time in seconds to be off for
+ */
+
+void pauseFor(float time);
+
+/** Sets a new state for a while then returns to the return state
+ * 
+ * @param time Time in seconds to be in new state for
+ * @param newState The new state for it to be in
+ * @param returnState The state for it to return to
+ */
+
+void onFor(float time, int newState, int returnState);
+
+/** Stops the flasher until resume is called
+ */
+
+void pause();
+
+/** Resumes the flasher
+ */
+ 
+void resume();
+
+/** Configures the flash times for a specified state
+ * 
+ * @param statein State to change
+ * @param newTime new flash period
+ */
+ 
+void setFlashTime(int statein, float newTime);
+
+/** Reads back the flash time for a state
+ * 
+ * @param statein State to read back
+ * @param returns Time of that states flash
+ */
+
+float getFlashTime(int statein);
+
+
+
+private:
+
+DigitalOut _led;
+
+int state;
+
+int returntoState;
+
+bool active;
+
+float forTime;
+
+float flashTimes[NUMSTATES];
+
+Ticker flashbase;
+
+Timeout forbase;
+
+void tick();
+
+void timeout();
+
+int checkState(int statein);
+
+};
+
+#endif
+
+
+