Commits

Todd Giles committed 3eac959 Merge

Merged master into Version-1

  • Participants
  • Parent commits 416c053, 57cc649
  • Branches Version-1

Comments (0)

Files changed (2)

 Directory Structure
 ===================
 
-* py/synchronized_lights.py - Play a single song while synchronizing lights to the music.
-* py/hardware_controller.py - Useful for verifying your hardware configuration (blink all lights, turn them on / off, etc...).
-* py/check_sms.py - Check sms messages from a google voice account to allow for voting for the next song!
-* config/* - Configuration files go here.
+* bin/* - Various bash scripts / tools to aid in playing songs, controlling volume, etc...
+* config/* - Configuration files.
 * crontab/synchronized_lights - Add these via 'sudo crontab -e' to start / stop the lightshow automatically
 * logs/* - Log files will be output here.
-* bin/* - Various bash scripts / tools to aid in playing songs, controlling volume, etc...
+* music/* - Music files go here (includes some samples).
+* py/* - All the python code.
+* tools/* - Tools helpful for those developing / debugging lightshowPi.
 
 Contributors
 ============
 * Chris Usey
 * Ryan Jennings
 * Sean Millar
-* Scott Driscoll
+* Scott Driscoll
+
+Release Notes
+============
+
+2014/02/16 :: Version 1
+- First "stable" release

File config/defaults.cfg

 #
 # https://projects.drogon.net/raspberry-pi/wiringpi/software-pwm-library/
 #
-# Change the pwm range used for this software pwm by changing this setting.
-# The default pwm range of 167 makes for an approximate 60Hz pwm frequency.
-pwm_range = 167
+# TODO(toddgiles): Add a page to the wiki with examples of different types of lights and
+# relays and the effect produced for various PWM ranges.  The text below should be taken
+# with a grain of salt as I have not been able to test as completely as I'd like to yet.
+#
+# Change the pwm range used for this software pwm by changing this setting.  The optimal 
+# setting really depends on your hardware setup.  If you are using zero-cross relays and 
+# driving an AC load then using a pwm range of 500 gives decent results (flickering
+# effect for many led lights with input rectifiers, and a decent fade for incandescents).
+# A range of 500 generates a 20Hz pwm frequency.
+#
+# If you have random cross relays that can shut-off / on at any time then going for a
+# 60 Hz pwm frequency can be advantageous, although timing this to the actual zero crossings
+# of the power line used will give the best fading effect - again with incandescent bulbs.
+# A range of 167 approximately generates a 60Hz pwm frequency.
+#
+# If you are attempting to fade a DC led load then the default range of 100 which gives a
+# 100Hz pwm frequency works fine.
+pwm_range = 100
 
 [lightshow]