iLights User Manual
Contents
1. LOW temp else temp 20 temp 20 down 1 set flag event handled in loop void crossUp High gt Low 16 for temp 0 temp lt 5 check to see that pin is high 5 times for confirmation if digitalRead zeroCross HIGH temp else temp 20 if temp 20 up 1 set flag event handled in loop References 1 Wichmann Heiko Open Source iTunes Visualizer VizKit Imagomat 1 Apr 2009 3 May 2009 lt http www imagomat de gt 2 Archer Tom and Rick Leinecker CSerial A C Class for Serial Communications CodeGuru 7 Aug 1999 3 May 2009 lt http www codeguru com gt 172. output BUS2 Serial begin 38400 connect to the serial port pinMode dataReady OUTPUT set data ready pin output pinMode nextValue INPUT set next value trigger input pinMode sync OUTPUT digitalWrite dataReady LOW no data ready PORTB B00000000 ditigalWrite nextValue HIGH decide if pull up resistor necessary void loop if Serial available gt 0 may have to set ready for 32 bit long delay 3 serialData Serial read read the serial port temp Serial read 48 10 temp Serial read 48 temp brightness 0 temp byte serialData Serial read reads one byte at a time returns 1 if no data temp Serial read 48 10 temp Serial read 48 temp brightness 1 temp byte serialData gt gt 8 temp Serial read 48 10 temp Serial read 48 temp brightness 2 temp byte serialData gt gt 16 temp Serial read 48 10 temp Serial read 48 temp brightness 3 temp byte serialData gt gt 24 Serial read read null termination character from transmitted string transmit 1 switch transmit case 0 break nothing to send case 1 send first two values PORTB brightness 0 PORTC brightness 1 digitalWrite sync HIGH sets count on arduino 2 to 0 syncs transmission digitalWrite dataReady HIGH data ready if digitalRead
3. spectrumDataArray currHistoryNum numberOfAudioChannels numberOfSpectrumEntries i 0 channel 0 spectrumDataSubBands index float spectrumDataArray currHistoryNum 0 i channel 0 spectrumDataSubBands index float 10 for i 0 i lt numberOfSubBands i if spectrumDataSubBands i gt maxSpectrumSum maxSpectrumSum spectrumDataSubBands i for i 0 i lt numberOfSubBands i spectrumDataSubBands i spectrumDataSubBands i maxSpectrumSum maximum value 1 0 glEnable GL_BLEND glBlendFunc GL_SRC_ALPHA GL_ONE_MINUS_SRC_ALPHA glBegin GL QUADS for i 0 i lt numberOfSubBands i spectrumVal spectrumDataSubBands i for k 0 k lt numberOfBlocksPerBarGraph k if spectrumVal coordHeight gt k heightOfCell glColor4d 1 1 1 8 else glColor4d 0 8 0 8 0 8 0 1 yPos float k heightOfCell float heightOfGapBetweenBlocks this gt xPixelToCoord 150 aCamera glVertex2d xPos 0 0 yPos glVertex2d xPos widthOfBlock glVertex2d xPos widthOfBlock yPos yPos heightOfBlock glVertex2d xPos 0 0 yPos heightOfBlock xPos widthOfCell 11 glEnd glDisable GL BLEND free spectrumDataSubBands Embedded Programming The system uses two microcontrollers which must be programmed using an Ardui
4. 1294 1293 1293 1291 1290 1289 1288 1286 1285 1283 1280 1278 1276 1273 1270 1266 1262 1257 1252 1246 1240 1232 1224 1215 1205 1194 1181 1167 1150 1132 112 1090 1064 1036 1004 968 928 883 833 777 714 643 564 475 376 265 140 0 void setup run once when the sketch starts DDRB DDRB amp B11000000 sets port B pins 0 5 as input paralle brightness values BUS1 DDRC DDRC amp B11000000 sets port C pins 0 5 as input paralle light number values BUS2 DDRD B11110010 sets port D pin0 input High when data ready pinl output switch when data read pin2 input for zero cross detection pin 3 input for reset count pins4 7 output triac triggers pin7 not used Note pins 4 7 set high when this microcontroller is reset lights on attachInterrupt 0 crossDown FALLING interrupt on pin2 calls cross at falling edge void loop runs over and over again On zero cross trigger handle dimming of lights Waits delay brightness i which is a portion of the entire ac half cycle and then triggers appropriate channel if up triggerLights attachInterrupt 0 crossDown FALLING up 0 if digitalRead 0 parallelIn after handling critical timing operations check read parallel data from other arduino same as above statement for switch High gt Low if down triggerLights attachInterrupt 0 crossUp RI
5. SING down 0 if digitalRead 0 parallelIn after handling critical timing operations check read parallel data from other arduino Responsible for triggering lights with correct timing void triggerLights 15 i 0 while i lt maxDelay if i brightness 0 digitalWrite triggerl HIGH if i brightness 1 digitalWrite trigger2 HIGH if i brightness 2 digitalWrite trigger3 HIGH if i brightness 3 digitalWrite trigger4 HIGH i for i 3 i lt 8 i digitalWrite i LOW void parallelIn read parralel inputs if digitalRead 3 gt 0 count 0 this bit high when first byte sent SYNC COUNTERS brightness 0 lookup PINB brightness 1 lookup PINC digitalWrite 1 HIGH switch pin telling other arduino to make next value vailable delay 1 while 1 if digitalRead 0 break brightness 2 lookup PINB brightness 3 lookup PINC digitalWrite 1 LOW switch pin telling other arduino to make next value vailable next two funtions handle interupts when reciveing Low gt High or High gt Low triggers used two methods because each one confirms cross by confirming the trigger 5 times VO id fo i if crossDown Low gt High r temp 0 temp lt 5 check to see that pin is low 5 times for confirmation f digitalRead zeroCross
6. alled by iTunes and recognizes messages defined by the iTunes Visualizer SDk documentation The function iTunesPluginMain is called when iTunes opens and has been modified to open the serial connection on COM4 at this point The following code snippet contains this function lines 693 to 733 OSStatus iTunesPluginMain OSType message PluginMessageInfo pluginMessageInfo void refCon fendif OSStatus status switch message case kPluginInitMessage pluginMessageInfo u initMessage options kPluginWantsDisplayNotification status VisualMain RegisterVisualPlugin pluginMessageInfo break case kPluginCleanupMessage status noErr break case kPluginPrepareToQuitMessage status noErr break default status unimpErr break Attempt to open the serial port COM4 serial Open T COM4 Setup the serial port 38400 N81 handshake off serial Setup CSerial EBaud38400 CSerial EData8 CSerial EParNone CSer ial EStopl serial SetupHandshaking CSerial EHandshakeOff The serial port is now ready and we can send receive data If reload saved values reloadLightSettings return status Also added to this method is the iLightsSerial function This is the method responsible for calculating the average power contained in each user selected range packaging the data as an ANSI string and writing it to the COM port The code lines 577 to 672 r
7. esponsible is the following snippet void iLightsSerial UInt8 renderData SInt16 index SInt32 channel if renderData nil FELLE char iLights 9 need otherwise string not null terminated char light1 3 char light2 3 char light3 3 char light4 3 unsigned int temp 0 int i unsigned int low VisualPreferences getClLow low lookUp low unsigned int high VisualPreferences getClHigh high lookUp high for i low i lt high i temp renderData i sum left channel values temp renderData i 512 sum right channel values if high 1 low 0 temp temp 2 high 1 low gt gt 2 else temp 0 UInt8 numberl UInt8 temp temp 0 i 0 low VisualPreferences getC2Low low lookUp low high VisualPreferences getC2High high lookUp high for i low i lt high i ll temp renderData i sum left channel values temp renderData i 512 sum right channel values if high I low 0 temp temp 2 high 1 low gt gt 2 else temp 0 UInt8 number2 UInt8 temp temp 0 i 0 low VisualPreferences getC3Low low lookUp low high VisualPreferences getC3High high lookUp high for i low i lt high i temp renderData il sum left channel values temp renderData i 512 sum right channel values if high I low 0 te
8. ferences getClLow void return intclLow ferences getClHigh void return intclHigh ferences getC2Low void return intc2Low ferences getC2High void return intc2High ferences getC3Low void return intc3Low ferences getC3High void return intc3High int VisualPreferences getC4Low void return intc4Low int VisualPreferences getC4High void return intc4High VisualConfiguration cpp Set Plugin name to iLights The only change to this file was to change the plug in name from VizKit to iLights when it shows up in the iTunes Visualizer menu Lines 49 59 INDIVIDUAL VISUALIZER IDENTIFICATION CONFIGURATION start const char const VisualConfiguration visualizerPluginIdentifierName iLagNbsts const char const VisualConfiguration visualizerShowName iLights void VisualConfiguration prepareVisualizerShowNameUnicode dif TARGET OS WIN wchar t visualizerShowNameUnicode wchar L iLights utf 16 this gt visualizerShowNameUnicode uintl6 visualizerShowNameUnicode wchar endif Ensemble Folder VisualStageControl Turn off all visual actors except ProcessMonitor VisualStageControl is responsible for calling the visual actors to be displayed in the stage or iTunes visualizer window More about this can be found in the VizKit 1 documentation We modified this file by commenting out all of the lines that called act
9. his functionality alone was found to be too slow for light control Each time the lights were updated the program needed to read the values from a text file Because of this int values were added to store the light settings while the program is running The update now only had to read these values through get int methods Additionally the program was writing to a text file each time a setting was changed This caused a noticible delay To fix this the program was modified to only back up to text when a user clicks the Save button on the Light Settings tab Get Set methods lines 90 107 Set and get methods for void VisualP value void VisualP value void VisualP value void VisualP value void VisualP value void VisualP value void VisualP value void VisualP value int VisualPr int VisualPr int VisualPr int VisualPr int VisualPr int VisualPr int storage values references setClLow unsigned int value intclLow ref nces setClHigh unsigned int value intclHigh ref ne setC2Low unsigned int value intc2Low ref nces setC2High unsigned int value intc2High ref nces setC3Low unsigned int value intc3Low ref nces setC3High unsigned int value intc3High ref nc setC4Low unsigned int value intc4Low ref nces setC4High unsigned int value intc4High
10. iLiehts User Manual Univeristy of Massachusetts Senior Design Project 2009 Table of Contents Installation and Usage Set Up pg 3 Using iLights pg 3 iLights Plug in dll file Added Files pg 4 Modified Files pg 4 12 Embedded Design Arduinos Serial to Parallel converter pg 12 14 Hardware Control pg 14 17 iLights User Manual Set Up Installing Plug in To install the plug in you must copy VizKit dll into folder C Program Files iTunes Plug ins This file is names VizKit after the open source project it is based upon Do not change the name of this file as this may cause problems when running the plug in Driver This project requires a driver for the USB to serial converter used to communicate with the iLights hardware To install this driver first attach the USB cable the device does not need to be turned on The computer will recognize the device and ask if you would like to locate the driver or let windows search for the driver Select that you will choose the location and direct the search to the CDM 2 04 16 WHQL Certified folder contained in the iLights project directory Windows will now install the proper driver There is one more step to make sure that the iLights plug in can communicate with the hardware The driver you just installed creates a virtual COM port when the USB cable is connected This port must be labeled COM4 in order for the plug in to find the hardware To do this go to Start g
11. ightOfGapBetweenBlocks GLdouble widthOfCell GLdouble widthOfBlock spectrumDataSubBands sizeof float for i 0 float ma i numberOfSubBands spectrumDataSubBands i 0 er const sintl6 currHistoryNum const uint32 numberOfSpectrumEntries const uint8 const aCamera EntriesPerBarGraph 20 fCell heightOfBlock lloc numberOfSubBands i Of numberOfEntriesPerBarGraph numb numberOfSubBands position on screen rOfSpectrumEntries 2 coordWidth this gt xPixelToCoord 800 aCamera coordHeight this gt yPixelToCoord 250 aCamera heightOfCell coordHeight float numberOfBlocksPerBarGraph heightOfBlock heightOfCell 0 8 heightOfGapBetweenBlocks heightOfCell 0 2 widthOfCell coordWidth float numberOfSubBands widthOfBlock widthOfCell 0 9 xPos aCamera getMaxRightCoord coordWidth xPos this gt xPixelToCoord 250 aCamera glLineWidth 1 0f 10 glColor3d 1 1 1 glLoadIdentity glPointSize 1 0f glTranslated 0 0 aCamera getMaxBottomCoord this gt xPixelToCoord 10 aCamera 0 0 collect values for each subBand index 0 for i 0 i lt numberOfSpectrumEntries 2 i if i gt 0 amp amp i numberOfEntriesPerBarGraph 0 index if index lt numberOfSubBands 1 spectrumDataSubBands index float
12. is function reloadLightSettings is lines 674 684 void reloadLightSettings void VisualPreferences setClLow VisualPreferences getValue VisualPre ferences clLow VisualPreferences setClHigh VisualPreferences getValue VisualPr eferences clHigh VisualPreferences setC2Low VisualPreferences getValue VisualPre ferences c2Low VisualPreferences setC2High VisualPreferences getValue VisualPr eferences c2High VisualPreferences setC3Low VisualPreferences getValue VisualPre ferences c3Low Visua Preferenc eferences c3High ferences Visua Visua Preferenc c4Low Preferenc S setC3High VisualPreferences getValu S setC4Low VisualPreferences getValu eferences c4High VisualPreferences cpp S setC4High VisualPreferences getValu VisualPr VisualPre VisualPr Added persistant preferences for light control settings Added int values for light control settings for quick lookup by iLightsSerial function Added get set methods for these int values VisualPreferences cpp is responsible for storing user preferences It backs up these preferences to a text file so that the preferences remain after closing iTunes Preferences were added to this file by modifying the header file to recognize settings for high low frequency cuts of each light channel Using t
13. l persist even after closing iTunes iTunes Plug in dll file The iTunes plug in is built as a Visual Studio C project The project is based on Vizkit 1 an open source platform for building and iTunes visualizer This section will deal with modifications we made to this project For more information about the VizKit project see http www imagomat de vizkit Added Files Serial cpp 2 This file and its header Serial h provide an easy to use interface for transmitting receiveing via a Windows serial port They are from the Open Source CSerial project Documentation can be found at http www codeguru com cpp i n network serialcommunications article php c2503 User Input User input is taken via the Visualizer Options window When the user clicks on this from the iTunes drop down window a message is sent to our plug in This message is handled in the same way as VizKit by creating a Windows Dialog box Our project ads a box for light control drawn in Visual Studio Resources editor The resource file is called IDD_DIALOG4 The handler for this Window is Light2Pane cpp This file is commented To understand general UI operation implemented see Microsoft s MSDN pages at http msdn microsoft com Modified Files Main Folder VisualMain cpp add serial initialization call iLightsSerial function on receiving renderFrame message iLightsSerial function added This is the main function for the project This file is c
14. mp temp 2 high 1 low gt gt 2 else temp 0 UInt8 number3 UInt8 temp temp 0 i 0 low VisualPreferences getC4Low low lookUp low high VisualPreferences getC4High high lookUp high for i low i lt high i temp renderData i sum left channel values temp renderData i 512 sum right channel values if high 1 low 0 temp temp 2 high 1 low gt gt 2 else temp 0 UInt8 number4 UInt8 temp spkrintf rs similar to printf but prints to a char 2d will pad with Os makes sure all values 2 chars sprintf s lightl 2d numberl sprintf_s light2 2d number2 sprintf_s light3 2d number3 Sprintf s light4 2d number4 put together string to transmit strcat s iLights 9 light1 Streat s iLights 9 light2 streat s iLights 9 light3 strcat s iLights 9 light4 serial Write iLights r Fr This function is called each time iTunes requests the visualizer frame to be updated When iTunes sends a xvisualPluginRenderMessage it hands the plug in a pointer to information about the playing song At this time iLightsSerial is called and handed the FFT data with this line 380 iLightsSerial UInt8 visualPluginMessageInfo gt u renderMessage renderData gt spectrumData Additionally a function has been added to the main function which is called on startup to reload stored user settings Th
15. nextValue 13 digitalWrite dataReady LOW arduino 2 do not read data digitalWrite sync LOW transmit 2 break case 2 send second two values PORTB brightness 2 PORTC brightness 3 digitalWrite dataReady HIGH data ready if digitalRead nextValue 0 digitalWrite dataReady LOW arduino 2 do not read data transmit 0 break default break Second Microcontroller triac control iLights Code for the triac triggering microcontroller originated 2 3 2009 by Chris Merola tested 2 7 09 with parallel input generated on dip switches modified 3 2 09 to take inputs on 2 buses PORTB and PORTC sped up timing so that all data is read and processed in one zero cross cycle the pin which detects zero crossing of live AC signal int zeroCross 2 The 4 output channels to be triggered int triggerl 4 int trigger2 5 int trigger3 6 int trigger4 7 byte count 0 int input 0 int maxDelay 1300 1500 is as dim as you need to get volatile int i 0 volatile int state 0 volatile char temp char up 0 char down 0 unsigned int brightness 4 0 500 1000 1500 The lookup table with scaled values to provide a nonlinear dimming Scale 14 unsigned int lookup 64 1300 1300 1300 1300 1300 1298 1298 1298 1298 1297 1297 1297 1296 1296 1295 1295
16. no prototyping board The microcontrollers must be removed from the PCB if they are to be re programmed The code is written using Arduino type syntax which provides several nice functions and method calls but also accepts the user to write C code The link from the pc to the microcontroller that triggers the switching circuitry is composed of two parts one Arduino prototyping board with an Atmegal68 that has been programmed to read the serial port data and another which has been programmed for triggering the triac circuits The first microcontroller receives a string at 38400 baud which contains 6 bit values for each of the four channels These values represent the average power across the particular frequency band This data is stored until the second Arduino requests new values At this point the data is transmitted over ports B and C of the Atmegal68 used as parallel ports Parallel data is sent extremely fast since only bitwise data is needed and this allows for efficient communication of our signals Using two ports allows us to send update data for two channels simultaneously meaning it only takes two transmissions to send all four values The second microcontroller receives our parallel data and converts it into dimming delays using a lookup table This table is scaled in a logarithmic manner in order to match human perception of brightness The dimming is accomplished using a critically timed loop to properly set the phase delay at which t
17. o trigger each channel This loop is run approximately 1300 times over every full 120Hz AC signal which was discovered empirically To dim the lights to the specified level we simply run this loop a certain number of times determined by the proper value from the lookup table before sending the signal to trigger the power for that channel This gives us a very consistent way to maintain phase control Communicating with our pc in this way has allowed us to continuously send updating signals to each of the four lights at around 80 times a second without any visual delay between the music and the properly dimmed lighting Source Code First Microcontroller serial to parallel converter iLights Serial to parallel converter originated 2 3 2009 by Chris Merola modified 2 27 09 to receive ANSII string input modified 3 2 09 to use 2 simultaneous data buses PORTB and PORTC unsigned long serialData 0 variable to store the data from the serial port 32 bits 4 8bit blocks one for each channel only lower 6 bits are used due to port access limitation 12 int dataReady 2 use pin 2 to signal data ready to 2nd Arduino int nextValue 3 use pin 3 to receive data ready signal from Arduino byte brightness 4 0 0 0 0 byte temp int transmit 0 int sync 4 void setup DDRB DDRB B00111111 set Port B pins 0 5 as output BUS1 DDRC DDRC B00111111 set Port C pins 0 5 as
18. ors except ProcessMonitorActor which we modified into our iLights display Actions Folder ProcessMonitor Turn off all parts except debug info and spectrum analyzer For iLights we wanted to display a spectrum analyzer to aid the user in choosing frequency bands to control lights This actor already had a spectrum analyzer albeit smaller and in lower resolution than we liked It also had useful debug info such as frame rate also the rate our lights are updated so we kept this information We modified this file by comenting out lines calling additional components of the actor Actual drawing of these parts is handled in VisualGraphics cpp Graphics Folder VisualGraphics centered and higher resolution analyzer This file was only changed to modify features of the existing VizKit 1 spectrum analyzer The modified code lines 1587 1681 Modify drawSpectrumAnalyzer function to draw a large void VisualGraphics drawSpectrumAnalyz const uintl6 numberOfHistories const uintl6 numberOfAudioChannels spectrumDataArray const VisualCamera amp if currHistoryNum 1 return GLdouble xPos GLdouble yPos GLdouble coordWidth GLdouble coordHeight uintl6 index i k GLdouble spectrumVal uintl6 numberOfSubBands 50 float spectrumDataSubBands float maxSpectrumSum 0 uint32 numberOf uintl6 numberOfBlocksPerBarGraph GLdouble heightOfCell heightO heightOfGapBetweenBlocks GLdouble heightOfBlock GLdouble he
19. t My Computer Right click and select Properties From the Hardware tab click the Device Manger button Once in Device Manager expand the Ports COM amp LPT menu Find USB Serial Port COMx where x is the port number If this says COM4 proceed to the next section If not follow these instructions Double click on USB Serial Port COMx From the Port Settings tab click the Advanced button At the top there is a drop down list for COM Port Number Choose COM4 Using iLights Plug in iLights if you have any lights plugged into the box they will turn on as follows Channels 1 amp 2 full brightness Channel 3 half brightness Channel 4 off This indicates that the hardware is turned on You may plug lights into the box at any time on or off Next plug the USB cable into the computer Open iTunes only after the USB cable has been plugged into the computer With iTunes open select iLights from the visualizer menu When you click Show Visualizer the iLights window will appear and the lights will begin to react to the music To select frequency ranges for the lights go to Visualizer Options A box will pop up with two tabs Select the Light Control tab The interface is made up of 8 sliders a low and high frequency cut for each channel Next to each slider the frequency for the slider position is displayed Clicking save will store your settings so that the wil
Download Pdf Manuals
Related Search