1765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang/* 2765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Author: Jun Kato and Yevgeniy Kiveisha <yevgeniy.kiveisha@intel.com> 3765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Contributions: Jon Trulson <jtrulson@ics.com> 4765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Copyright (c) 2014 Intel Corporation. 5765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 6765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * This module is based on the my9221 driver 7765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 8765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Permission is hereby granted, free of charge, to any person obtaining 9765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * a copy of this software and associated documentation files (the 10765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * "Software"), to deal in the Software without restriction, including 11765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * without limitation the rights to use, copy, modify, merge, publish, 12765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * distribute, sublicense, and/or sell copies of the Software, and to 13765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * permit persons to whom the Software is furnished to do so, subject to 14765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * the following conditions: 15765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 16765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * The above copyright notice and this permission notice shall be 17765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * included in all copies or substantial portions of the Software. 18765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 19765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, 20765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 21765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 22765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 23765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 24765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 25765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 26765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 27765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#pragma once 28765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 29765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#include <string> 30765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#include <mraa/aio.hpp> 31765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#include <mraa/common.hpp> 32765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 33765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#include <mraa/gpio.hpp> 34765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 35765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#define MAX_BIT_PER_BLOCK 16 36765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#define CMDMODE 0x0000 37765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#define BIT_HIGH 0x00ff 38765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#define BIT_LOW 0x0000 39765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 40765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#define HIGH 1 41765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang#define LOW 0 42765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 43765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhangnamespace upm { 44765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 45765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 46765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @brief Grove Circular LED library 47765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @defgroup grovecircularled libupm-grovecircularled 48765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @ingroup seeed display gpio 49765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 50765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 51765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 52765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @library grovecircularled 53765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @sensor grovecircularled 54765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @comname Grove Circular LED 55765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @type display 56765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @man seeed 57765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @web http://www.seeedstudio.com/wiki/Grove_-_Circular_LED 58765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @con gpio 59765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 60765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @brief API for the Grove Circular LED module 61765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 62765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * This is a circular LED ring based on the MY9221 chip. It is often used 63765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * with a rotary encoder and has 24 controllable LEDs. 64765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 65765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @image html grovecircularled.jpg 66765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @snippet grovecircularled.cxx Interesting 67765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 68765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang class GroveCircularLED { 69765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang public: 70765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 71765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Instantiates an MY9221 object 72765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 73765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @param di Data pin 74765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @param dcki Clock pin 75765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 76765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang GroveCircularLED (uint8_t di, uint8_t dcki); 77765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 78765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 79765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Sets the lighting status 80765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 81765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @param level Selected level for the circular LED (0-24) 82765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @param direction Up or down; up is true and default 83765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 84765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Result setLevel (uint8_t level, bool direction=true); 85765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 86765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 87765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Sets the spinner (lights up all the other LEDs but one) 88765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 89765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @param position Selected position for the spinner (0-23) 90765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 91765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Result setSpinner (uint8_t position); 92765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 93765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 94765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Sets the lighting status 95765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * 96765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * @param status Boolean array (24 elements) 97765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 98765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Result setStatus (bool status[24]); 99765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 100765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang /** 101765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang * Returns the name of the component 102765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang */ 103765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang std::string name() 104765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang { 105765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang return m_name; 106765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang } 107765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang private: 108765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Result lockData (); 109765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Result send16bitBlock (short data); 110765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 111765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang std::string m_name; 112765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Gpio m_clkPinCtx; 113765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang mraa::Gpio m_dataPinCtx; 114765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang }; 115765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang 116765adb95dc941c32690d6c43bc08b9d07d197fcbJianxun Zhang} 117