├── README.md ├── Cymatic_Lighting ├── Adafruit_NeoPixel.h └── Cymatic_Lighting.ino └── LICENSE /README.md: -------------------------------------------------------------------------------- 1 | # Cymatic Lighting 2 | Open source Cymatic Lighting system for Deaf & Hard-of-Hearing to see music & alerts using Arduino & digital LEDs. 3 | 4 | *Brought to you by www.cymaspace.org.* 5 | 6 | Video Primer: https://youtu.be/OnrxPVjEhr8 7 | 8 | Solution submitted to the AT&T Connectability Challenge: http://connectability.challengepost.com/. 9 | *Our solution requires some additional hardware & software components.* 10 | 11 | **Hardware:** 12 | * Arduino UNO (or other compatible microcontroller) 13 | * MSGEQ7 Spectrum Audio Shield: https://www.sparkfun.com/products/13116 14 | * Neopixel (WS2811 or WS2812B) Individually Addressable LED Strip: http://www.adafruit.com/products/1376 15 | 16 | **Software:** 17 | * Adafruit Neopixel library: https://github.com/adafruit/Adafruit_NeoPixel 18 | * Arduino IDE: https://www.arduino.cc/en/Main/Software 19 | * CymaSpace Cymatic Lighting Software Sketch: 20 | https://github.com/CymaSpace/Cymatic-Lighting 21 | 22 | **Step 1:** 23 | Connect Sparkfun Spectrum Audio Shield to the Arduino (it will fit exactly onto an Arduino Uno). 24 | 25 | **Step 2:** 26 | To quickly get up and running follow the steps in the Adafruit Neopixel Uberguide: https://learn.adafruit.com/adafruit-neopixel-uberguide/arduino-library 27 | 28 | Connect the +5V input on the LED strip to the + (positive) terminal on the Arduino/Spectrum Shield, DIN to digital pin 5 on the Arduino/Spectrum Shield, and – (minus or GND) on the strip must connect to a GND pin on the Arduino/Spectrum Shield (there are usually several — any will do). 29 | 30 | **Step 3:** 31 | Install Arduino IDE & Arduino NeoPixel Library (again reference Adafruit Neopixel Uberguide for more detailed instructions). 32 | 33 | **Step 4:** 34 | Download our software sketch '/Cymatic-Lighting' from Github and unzip the contents into your Arduino Sketches folder. 35 | 36 | **Step 5:** 37 | Upload sketch from Arduino software IDE to the Arduino hardware (make sure USB cable is connected to computer if not already!). 38 | 39 | **Step 6:** 40 | Plug in a standard 3.5mm audio cable into either audio jack on the Spectrum Audio Shield and the other end into a sound-source (MP3 Player, Phone, “Handimic” Microphone with line level output etc). 41 | 42 | **Step 7:** 43 | Play music or make sound and enjoy the visualization on the LED strip. 44 | -------------------------------------------------------------------------------- /Cymatic_Lighting/Adafruit_NeoPixel.h: -------------------------------------------------------------------------------- 1 | /*-------------------------------------------------------------------- 2 | This file is part of the Adafruit NeoPixel library. 3 | 4 | NeoPixel is free software: you can redistribute it and/or modify 5 | it under the terms of the GNU Lesser General Public License as 6 | published by the Free Software Foundation, either version 3 of 7 | the License, or (at your option) any later version. 8 | 9 | NeoPixel is distributed in the hope that it will be useful, 10 | but WITHOUT ANY WARRANTY; without even the implied warranty of 11 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 | GNU Lesser General Public License for more details. 13 | 14 | You should have received a copy of the GNU Lesser General Public 15 | License along with NeoPixel. If not, see 16 | . 17 | --------------------------------------------------------------------*/ 18 | 19 | #ifndef ADAFRUIT_NEOPIXEL_H 20 | #define ADAFRUIT_NEOPIXEL_H 21 | 22 | #if (ARDUINO >= 100) 23 | #include 24 | #else 25 | #include 26 | #include 27 | #endif 28 | 29 | // 'type' flags for LED pixels (third parameter to constructor): 30 | #define NEO_GRB 0x01 // Wired for GRB data order 31 | #define NEO_COLMASK 0x01 32 | #define NEO_KHZ800 0x02 // 800 KHz datastream 33 | #define NEO_SPDMASK 0x02 34 | // Trinket flash space is tight, v1 NeoPixels aren't handled by default. 35 | // Remove the ifndef/endif to add support -- but code will be bigger. 36 | // Conversely, can comment out the #defines to save space on other MCUs. 37 | #ifndef __AVR_ATtiny85__ 38 | #define NEO_RGB 0x00 // Wired for RGB data order 39 | #define NEO_KHZ400 0x00 // 400 KHz datastream 40 | #endif 41 | 42 | class Adafruit_NeoPixel { 43 | 44 | public: 45 | 46 | // Constructor: number of LEDs, pin number, LED type 47 | Adafruit_NeoPixel(uint16_t n, uint8_t p=6, uint8_t t=NEO_GRB + NEO_KHZ800); 48 | ~Adafruit_NeoPixel(); 49 | 50 | void 51 | begin(void), 52 | show(void), 53 | setPin(uint8_t p), 54 | setPixelColor(uint16_t n, uint8_t r, uint8_t g, uint8_t b), 55 | setPixelColor(uint16_t n, uint32_t c), 56 | setBrightness(uint8_t); 57 | uint8_t 58 | *getPixels() const; 59 | uint16_t 60 | numPixels(void) const; 61 | static uint32_t 62 | Color(uint8_t r, uint8_t g, uint8_t b); 63 | uint32_t 64 | getPixelColor(uint16_t n) const; 65 | 66 | private: 67 | 68 | const uint16_t 69 | numLEDs, // Number of RGB LEDs in strip 70 | numBytes; // Size of 'pixels' buffer below 71 | #if defined(NEO_RGB) || defined(NEO_KHZ400) 72 | const uint8_t 73 | type; // Pixel flags (400 vs 800 KHz, RGB vs GRB color) 74 | #endif 75 | uint8_t 76 | pin, // Output pin number 77 | brightness, 78 | *pixels; // Holds LED color values (3 bytes each) 79 | uint32_t 80 | endTime; // Latch timing reference 81 | #ifdef __AVR__ 82 | const volatile uint8_t 83 | *port; // Output PORT register 84 | uint8_t 85 | pinMask; // Output PORT bitmask 86 | #endif 87 | 88 | }; 89 | 90 | #endif // ADAFRUIT_NEOPIXEL_H 91 | -------------------------------------------------------------------------------- /Cymatic_Lighting/Cymatic_Lighting.ino: -------------------------------------------------------------------------------- 1 | #include 2 | #define PIN 5 3 | #define CNT_LIGHTS 60 4 | 5 | Adafruit_NeoPixel strip = Adafruit_NeoPixel(CNT_LIGHTS, PIN, NEO_GRB + NEO_KHZ800); 6 | //fixed settings 7 | int analogPinL = 1; // read from multiplexer using analog input 0 8 | int analogPinR = 0; // read from multiplexer using analog input 0 9 | int strobePin = 4; // strobe is attached to digital pin 4 10 | int resetPin = 5; // reset is attached to digital pin 5 11 | int spectrumValueL[6]; 12 | int spectrumValueR[6]; // to hold a2d values 13 | int previousSpectrumValueL[6]; // to hold a2d values 14 | int previousSpectrumValueR[6]; // to hold a2d values 15 | int global_brightness = 255; // Sets global brightness, i.e. 64 is 1/4 brightness. 16 | int useColor[2]; 17 | int num; 18 | float waveValue; 19 | int prop[CNT_LIGHTS]; 20 | int prop_history[CNT_LIGHTS]; 21 | int refresh_counter = 0; 22 | int use_refresh = 0; 23 | float use_brightness = 0; 24 | int tmp_refresh_adj = 0; 25 | 26 | //lowest reading the MSGEQ7 should recognize 1-1000 range 27 | int minFilter = 50; 28 | //higher number refreshes slow - refreshed every nth interation 29 | int refresh = 20; 30 | 31 | 32 | 33 | 34 | void setup() 35 | { 36 | Serial.begin(9600); // print to serial monitor 37 | strip.begin(); 38 | strip.show(); // Initialize all pixels to 'off' 39 | pinMode(analogPinL, INPUT); 40 | pinMode(analogPinR, INPUT); 41 | pinMode(strobePin, OUTPUT); 42 | pinMode(resetPin, OUTPUT); 43 | analogReference(DEFAULT); 44 | digitalWrite(resetPin, LOW); 45 | digitalWrite(strobePin, HIGH); 46 | } 47 | 48 | void loop() 49 | { 50 | runTime(); 51 | } 52 | 53 | 54 | void runTime() 55 | { 56 | 57 | digitalWrite(resetPin, HIGH); 58 | digitalWrite(resetPin, LOW); 59 | int changeL = 0; 60 | int changeR = 0; 61 | int changePinL = 0; 62 | int changePinR = 0; 63 | int k,i,r,g,b; 64 | float pot_value = 0.0; 65 | 66 | int use_le = 0; 67 | int use_ls = ((CNT_LIGHTS/2)-1); 68 | int use_rs = ((CNT_LIGHTS/2)+0); 69 | int use_re = (CNT_LIGHTS-1); 70 | int spectrum_totalL = 0; 71 | int spectrum_totalR = 0; 72 | int spectrum_counts = 0; 73 | 74 | 75 | 76 | //get readings from chip 77 | for (i = 0; i < 7; i++) 78 | { 79 | spectrum_counts++; 80 | previousSpectrumValueL[i] = spectrumValueL[i]; 81 | previousSpectrumValueR[i] = spectrumValueR[i]; 82 | digitalWrite(strobePin, LOW); 83 | delayMicroseconds(30); // to allow the output to settle 84 | spectrumValueL[i] = analogRead(analogPinL); 85 | spectrumValueR[i] = analogRead(analogPinR); 86 | 87 | spectrum_totalL+= spectrumValueL[i]; 88 | spectrum_totalR+= spectrumValueR[i]; 89 | 90 | if( spectrumValueL[i] > 400 && i <=1) 91 | tmp_refresh_adj+= 23; 92 | if( spectrumValueR[i] > 400 && i <=1) 93 | tmp_refresh_adj+= 23; 94 | 95 | digitalWrite(strobePin, HIGH); 96 | 97 | }//for i 98 | 99 | changePinL = (spectrum_totalL); 100 | changePinR = (spectrum_totalR); 101 | use_refresh = refresh; 102 | use_brightness = global_brightness; 103 | 104 | use_refresh = 0; 105 | 106 | 107 | 108 | 109 | if(tmp_refresh_adj < 0) { tmp_refresh_adj = 0; } 110 | if(tmp_refresh_adj > 200) { tmp_refresh_adj = 200; } 111 | 112 | refresh_counter++; 113 | if(refresh_counter>=(use_refresh - round(tmp_refresh_adj * .1))) 114 | { 115 | //reset the counter 116 | refresh_counter = 0; 117 | tmp_refresh_adj-= 1; 118 | 119 | //save the history - RIGHT SIDE 120 | for (k = use_rs; k <= use_re; k++) 121 | { 122 | prop_history[k] = prop[k-1]; 123 | }//for 124 | 125 | for (k = use_rs; k <= use_re; k++) 126 | { 127 | prop[k] = prop_history[k]; 128 | }//for 129 | 130 | 131 | //save the history - LEFT SIDE 132 | for (k = use_ls; k >= use_le; k--) 133 | { 134 | prop_history[k] = prop[k+1]; 135 | }//for 136 | 137 | for (k = use_ls; k >= use_le; k--) 138 | { 139 | prop[k] = prop_history[k]; 140 | }//for 141 | 142 | //current; 143 | prop[use_rs] = changePinR; 144 | prop[use_ls] = changePinL; 145 | 146 | for (k = 0; k < CNT_LIGHTS; k++) 147 | { 148 | num = prop[k]; 149 | //Serial.println(num); 150 | if(num>=0) 151 | { 152 | get_color(); 153 | strip.setPixelColor( k, useColor[0], useColor[1], useColor[2]); 154 | }//if 155 | }//for 156 | 157 | 158 | }//if refresh 159 | 160 | 161 | strip.show(); 162 | } 163 | 164 | void get_color() 165 | { 166 | int r,g,b; 167 | 168 | if(num < 500) 169 | { 170 | r = 0; g = 0; b = 0; 171 | 172 | useColor[0] = g; 173 | useColor[1] = r; 174 | useColor[2] = b; 175 | } 176 | 177 | if(num>500) 178 | { 179 | getWaveLength(); 180 | getRGB(); 181 | 182 | 183 | } 184 | } 185 | 186 | void getWaveLength() 187 | { 188 | float minVal = 500; 189 | float maxVal = 4700; 190 | float minWave = 350; 191 | float maxWave = 650; 192 | maxVal = 0; 193 | minVal = 0; 194 | if(num>maxVal) 195 | maxVal = num; 196 | 197 | waveValue = ((num - minVal) / (maxVal-minVal) * (maxWave - minWave)) + minWave; 198 | } 199 | 200 | void getRGB() 201 | { 202 | float gamma = .8; 203 | float rz, gz, bz; 204 | int intsMax = 255; 205 | int r,g,b; 206 | 207 | if(waveValue >380 && waveValue <=439) 208 | { 209 | rz = (waveValue-440)/(440-380); 210 | gz = 0; 211 | bz = 1; 212 | } 213 | 214 | if(waveValue >=440 && waveValue <=489) 215 | { 216 | rz = 0; 217 | gz = (waveValue-440)/(490-440); 218 | bz = 1; 219 | } 220 | 221 | if(waveValue >=490 && waveValue <=509) 222 | { 223 | rz = 0; 224 | gz = 1; 225 | bz = (waveValue-510)/(510-490); 226 | } 227 | 228 | if(waveValue >=510 && waveValue <=579) 229 | { 230 | rz = (waveValue-510)/(580-510); 231 | gz = 1; 232 | bz = 0; 233 | } 234 | 235 | if(waveValue >=580 && waveValue <=644) 236 | { 237 | rz = 1; 238 | gz = (waveValue-645)/(645-580); 239 | bz = 0; 240 | } 241 | 242 | if(waveValue >=645 && waveValue <=780) 243 | { 244 | rz = 1; 245 | gz = 0; 246 | bz = 0; 247 | } 248 | 249 | r = rz * 255; 250 | b = bz * 255; 251 | g = gz * 255; 252 | 253 | useColor[0] = g; 254 | useColor[1] = r; 255 | useColor[2] = b; 256 | 257 | } 258 | 259 | 260 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Apache License 2 | Version 2.0, January 2004 3 | http://www.apache.org/licenses/ 4 | 5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 6 | 7 | 1. Definitions. 8 | 9 | "License" shall mean the terms and conditions for use, reproduction, 10 | and distribution as defined by Sections 1 through 9 of this document. 11 | 12 | "Licensor" shall mean the copyright owner or entity authorized by 13 | the copyright owner that is granting the License. 14 | 15 | "Legal Entity" shall mean the union of the acting entity and all 16 | other entities that control, are controlled by, or are under common 17 | control with that entity. For the purposes of this definition, 18 | "control" means (i) the power, direct or indirect, to cause the 19 | direction or management of such entity, whether by contract or 20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the 21 | outstanding shares, or (iii) beneficial ownership of such entity. 22 | 23 | "You" (or "Your") shall mean an individual or Legal Entity 24 | exercising permissions granted by this License. 25 | 26 | "Source" form shall mean the preferred form for making modifications, 27 | including but not limited to software source code, documentation 28 | source, and configuration files. 29 | 30 | "Object" form shall mean any form resulting from mechanical 31 | transformation or translation of a Source form, including but 32 | not limited to compiled object code, generated documentation, 33 | and conversions to other media types. 34 | 35 | "Work" shall mean the work of authorship, whether in Source or 36 | Object form, made available under the License, as indicated by a 37 | copyright notice that is included in or attached to the work 38 | (an example is provided in the Appendix below). 39 | 40 | "Derivative Works" shall mean any work, whether in Source or Object 41 | form, that is based on (or derived from) the Work and for which the 42 | editorial revisions, annotations, elaborations, or other modifications 43 | represent, as a whole, an original work of authorship. For the purposes 44 | of this License, Derivative Works shall not include works that remain 45 | separable from, or merely link (or bind by name) to the interfaces of, 46 | the Work and Derivative Works thereof. 47 | 48 | "Contribution" shall mean any work of authorship, including 49 | the original version of the Work and any modifications or additions 50 | to that Work or Derivative Works thereof, that is intentionally 51 | submitted to Licensor for inclusion in the Work by the copyright owner 52 | or by an individual or Legal Entity authorized to submit on behalf of 53 | the copyright owner. For the purposes of this definition, "submitted" 54 | means any form of electronic, verbal, or written communication sent 55 | to the Licensor or its representatives, including but not limited to 56 | communication on electronic mailing lists, source code control systems, 57 | and issue tracking systems that are managed by, or on behalf of, the 58 | Licensor for the purpose of discussing and improving the Work, but 59 | excluding communication that is conspicuously marked or otherwise 60 | designated in writing by the copyright owner as "Not a Contribution." 61 | 62 | "Contributor" shall mean Licensor and any individual or Legal Entity 63 | on behalf of whom a Contribution has been received by Licensor and 64 | subsequently incorporated within the Work. 65 | 66 | 2. Grant of Copyright License. Subject to the terms and conditions of 67 | this License, each Contributor hereby grants to You a perpetual, 68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 69 | copyright license to reproduce, prepare Derivative Works of, 70 | publicly display, publicly perform, sublicense, and distribute the 71 | Work and such Derivative Works in Source or Object form. 72 | 73 | 3. Grant of Patent License. Subject to the terms and conditions of 74 | this License, each Contributor hereby grants to You a perpetual, 75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable 76 | (except as stated in this section) patent license to make, have made, 77 | use, offer to sell, sell, import, and otherwise transfer the Work, 78 | where such license applies only to those patent claims licensable 79 | by such Contributor that are necessarily infringed by their 80 | Contribution(s) alone or by combination of their Contribution(s) 81 | with the Work to which such Contribution(s) was submitted. If You 82 | institute patent litigation against any entity (including a 83 | cross-claim or counterclaim in a lawsuit) alleging that the Work 84 | or a Contribution incorporated within the Work constitutes direct 85 | or contributory patent infringement, then any patent licenses 86 | granted to You under this License for that Work shall terminate 87 | as of the date such litigation is filed. 88 | 89 | 4. Redistribution. You may reproduce and distribute copies of the 90 | Work or Derivative Works thereof in any medium, with or without 91 | modifications, and in Source or Object form, provided that You 92 | meet the following conditions: 93 | 94 | (a) You must give any other recipients of the Work or 95 | Derivative Works a copy of this License; and 96 | 97 | (b) You must cause any modified files to carry prominent notices 98 | stating that You changed the files; and 99 | 100 | (c) You must retain, in the Source form of any Derivative Works 101 | that You distribute, all copyright, patent, trademark, and 102 | attribution notices from the Source form of the Work, 103 | excluding those notices that do not pertain to any part of 104 | the Derivative Works; and 105 | 106 | (d) If the Work includes a "NOTICE" text file as part of its 107 | distribution, then any Derivative Works that You distribute must 108 | include a readable copy of the attribution notices contained 109 | within such NOTICE file, excluding those notices that do not 110 | pertain to any part of the Derivative Works, in at least one 111 | of the following places: within a NOTICE text file distributed 112 | as part of the Derivative Works; within the Source form or 113 | documentation, if provided along with the Derivative Works; or, 114 | within a display generated by the Derivative Works, if and 115 | wherever such third-party notices normally appear. The contents 116 | of the NOTICE file are for informational purposes only and 117 | do not modify the License. You may add Your own attribution 118 | notices within Derivative Works that You distribute, alongside 119 | or as an addendum to the NOTICE text from the Work, provided 120 | that such additional attribution notices cannot be construed 121 | as modifying the License. 122 | 123 | You may add Your own copyright statement to Your modifications and 124 | may provide additional or different license terms and conditions 125 | for use, reproduction, or distribution of Your modifications, or 126 | for any such Derivative Works as a whole, provided Your use, 127 | reproduction, and distribution of the Work otherwise complies with 128 | the conditions stated in this License. 129 | 130 | 5. Submission of Contributions. Unless You explicitly state otherwise, 131 | any Contribution intentionally submitted for inclusion in the Work 132 | by You to the Licensor shall be under the terms and conditions of 133 | this License, without any additional terms or conditions. 134 | Notwithstanding the above, nothing herein shall supersede or modify 135 | the terms of any separate license agreement you may have executed 136 | with Licensor regarding such Contributions. 137 | 138 | 6. Trademarks. This License does not grant permission to use the trade 139 | names, trademarks, service marks, or product names of the Licensor, 140 | except as required for reasonable and customary use in describing the 141 | origin of the Work and reproducing the content of the NOTICE file. 142 | 143 | 7. Disclaimer of Warranty. Unless required by applicable law or 144 | agreed to in writing, Licensor provides the Work (and each 145 | Contributor provides its Contributions) on an "AS IS" BASIS, 146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 147 | implied, including, without limitation, any warranties or conditions 148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A 149 | PARTICULAR PURPOSE. You are solely responsible for determining the 150 | appropriateness of using or redistributing the Work and assume any 151 | risks associated with Your exercise of permissions under this License. 152 | 153 | 8. Limitation of Liability. In no event and under no legal theory, 154 | whether in tort (including negligence), contract, or otherwise, 155 | unless required by applicable law (such as deliberate and grossly 156 | negligent acts) or agreed to in writing, shall any Contributor be 157 | liable to You for damages, including any direct, indirect, special, 158 | incidental, or consequential damages of any character arising as a 159 | result of this License or out of the use or inability to use the 160 | Work (including but not limited to damages for loss of goodwill, 161 | work stoppage, computer failure or malfunction, or any and all 162 | other commercial damages or losses), even if such Contributor 163 | has been advised of the possibility of such damages. 164 | 165 | 9. Accepting Warranty or Additional Liability. While redistributing 166 | the Work or Derivative Works thereof, You may choose to offer, 167 | and charge a fee for, acceptance of support, warranty, indemnity, 168 | or other liability obligations and/or rights consistent with this 169 | License. However, in accepting such obligations, You may act only 170 | on Your own behalf and on Your sole responsibility, not on behalf 171 | of any other Contributor, and only if You agree to indemnify, 172 | defend, and hold each Contributor harmless for any liability 173 | incurred by, or claims asserted against, such Contributor by reason 174 | of your accepting any such warranty or additional liability. 175 | 176 | END OF TERMS AND CONDITIONS 177 | 178 | APPENDIX: How to apply the Apache License to your work. 179 | 180 | To apply the Apache License to your work, attach the following 181 | boilerplate notice, with the fields enclosed by brackets "{}" 182 | replaced with your own identifying information. (Don't include 183 | the brackets!) The text should be enclosed in the appropriate 184 | comment syntax for the file format. We also recommend that a 185 | file or class name and description of purpose be included on the 186 | same "printed page" as the copyright notice for easier 187 | identification within third-party archives. 188 | 189 | Copyright {yyyy} {name of copyright owner} 190 | 191 | Licensed under the Apache License, Version 2.0 (the "License"); 192 | you may not use this file except in compliance with the License. 193 | You may obtain a copy of the License at 194 | 195 | http://www.apache.org/licenses/LICENSE-2.0 196 | 197 | Unless required by applicable law or agreed to in writing, software 198 | distributed under the License is distributed on an "AS IS" BASIS, 199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 200 | See the License for the specific language governing permissions and 201 | limitations under the License. 202 | 203 | --------------------------------------------------------------------------------