NAME Device::BlinkyTape - Control a BlinkyTape led strip SYNOPSIS use Device::BlinkyTape::WS2811; # BlinkyTape uses WS2811 my $bb = Device::BlinkyTape::WS2811->new(dev => '/dev/tty.usbmodem'); # Set all led pixels on full white $bb->all_on(); # Set all led pixels off $bb->all_off(); # Send a white pixel (RGB 255/255/255). # Pixels are sent one by one from left to right. $bb->send_pixel(255,255,255); $bb->send_pixel(5,5,5); # Show all sent pixels and reset send_pixel to the first pixel. $bb->show(); dev The device where your usb ledstrip is at. Defaults to /dev/tty.usbmodem. port Instead of giving the device you can create the instance of this module by directly giving it a Device:SerialPort object. By default the Device::SerialPort object is created from the device given in the 'dev' parameter. gamma Specify the gamma correction. Defaults to [1,1,1] led_count Specify the led count, counting from 1. The default is 60. simulate Specify if the module should simulate a BlinkyTape onscreen instead of using one in the usb port. Defaults to 0 (false). If this is true then the port and dev parameters have no effect. sleeptime Sending data too fast freezes the BlinkyTape. Sleeping for 30 microseconds between each byte makes sure the atmega processor of the BlinkyTape can keep up with the incoming data. all_on Turns all leds on. all_off Turns all leds off. send_pixel(r,g,b) Send the RGB value for the next pixel. Values 0-254 are sent as is, value 255 is converted to 254. show Shows the sent pixels and resets the send_pixel to the first led pixel of the strip. This is done by sending a single 255 value byte to the led strip. ABOUT BLINKYTAPE Blinkytape is a controllable led strip available at http://blinkiverse.com/blinkytape/ USING THE MODULE ON OS X WITHOUT OWNING A BLINKYTAPE This module comes with a BlinkyTape simulator. Install X11 server to use the simulator: http://xquartz.macosforge.org/landing/ BUGS The device is not yet available so the module has been implemented by inspecting partly undocumented and unfinished code in other languages. Feel free to file any bug reports in Github, patches welcome. REFERENCE READING Communicating with the Arduino in Perl http://playground.arduino.cc/interfacing/PERL Perl communication to Arduino over serial USB http://www.windmeadow.com/node/38 AUTHOR Oskari Okko Ojala Based on exampls/Blinkyboard.py in Blinkiverse's BlinkyTape repository at https://github.com/blinkiverse/BlinkyTape/ by Max Henstell (mhenstell) and Marty McGuire (martymcguire). COPYRIGHT AND LICENSE Copyright (C) Oskari Okko Ojala 2013 This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl you may have available.