grovecircularled: Initial import/implementation

This code is based off ofthe my9221 driver.  This modification was
done by Jun Kato, but abandoned.

This driver will not work correctly on Galileo.

Signed-off-by: Jon Trulson <jtrulson@ics.com>
Signed-off-by: Mihai Tudor Panu <mihai.tudor.panu@intel.com>

src/grovecircularled/grovecircularled.h

@@ -0,0 +1,115 @@
+/*
+ * Author: Jun Kato and Yevgeniy Kiveisha <yevgeniy.kiveisha@intel.com>
+ * Contributions: Jon Trulson <jtrulson@ics.com>
+ * Copyright (c) 2014 Intel Corporation.
+ *
+ * This module is based on the my9221 driver
+ * 
+ * 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.
+ */
+#pragma once
+
+#include <string>
+#include <mraa/aio.h>
+#include <mraa/gpio.h>
+
+#define MAX_BIT_PER_BLOCK     16
+#define CMDMODE               0x0000
+#define BIT_HIGH              0x00ff
+#define BIT_LOW               0x0000
+
+#define HIGH                  1
+#define LOW                   0
+
+namespace upm {
+
+  /**
+   * @brief Grove Circular LED library
+   * @defgroup grovecircularled libupm-grovecircularled
+   * @ingroup seeed display gpio
+   */
+  
+  /**
+   * @library grovecircularled
+   * @sensor grovecircularled
+   * @comname Grove Circular LED
+   * @type display
+   * @man seeed
+   * @web http://www.seeedstudio.com/wiki/Grove_-_Circular_LED
+   * @con gpio
+   *
+   * @brief API for Grove Circular LED module
+   *
+   * @snippet grovecircularled.cxx Interesting
+   */
+  class GroveCircularLED {
+  public:
+    /**
+     * Instantiates a MY9221 object
+     *
+     * @param di data pin
+     * @param dcki clock pin
+     */
+    GroveCircularLED (uint8_t di, uint8_t dcki);
+  
+    /**
+     * MY9221 object destructor
+     */
+    ~GroveCircularLED ();
+  
+    /**
+     * Set the lighting status
+     *
+     * @param level selected level for the circular led (0 - 24)
+     * @param direction up or down, true is up and is the default
+     */
+    mraa_result_t setLevel (uint8_t level, bool direction=true);
+  
+    /**
+     * Set the spinner (light up one but all the other LEDs)
+     *
+     * @param position selected position for the spinner (0 - 23)
+     */
+    mraa_result_t setSpinner (uint8_t position);
+
+    /**
+     * Set the lighting status
+     *
+     * @param status boolean array (24 elements)
+     */
+    mraa_result_t setStatus (bool status[24]);
+
+    /**
+     * Return name of the component
+     */
+    std::string name()
+      {
+        return m_name;
+      }
+  private:
+    mraa_result_t lockData ();
+    mraa_result_t send16bitBlock (short data);
+  
+    std::string m_name;
+    mraa_gpio_context m_clkPinCtx;
+    mraa_gpio_context m_dataPinCtx;
+  };
+ 
+}