Code Monkey home page Code Monkey logo

fraqture's Introduction

fraqture

An interactive art framework that takes inputs from social media, maps them to the interactive parts of a drawing, and renders the art. The platform consists of a 50" TV display driven by Clojure's Quil library outlined with 540 DotStar LEDs driven by a Teensy 3.2.

installation-pic

Exhibitions

Come see fraqture live!

You can find Fraqture today in the 21C storefront window in downtown Durham, NC.

textify

Usage

lein run <drawing name>

For examples of what each of the drawings does, check out the gifs in examples.md. Start by trying lein run cycle.

Hardware

The Fraqture Project uses two custom-build LED panels with 270 individually addressable LEDs each to extend our canvas out from the screen. We are using a Teensy 3.2 to receive commands over a serial connection and use them to refresh the panels. The sections below discusses how to connect and issue commands to the panels.

Reset Communications

The LED serial communication is a basic state machine. When a device connects to the panel driver, it is impossible to know whether it is in the default state or not. To reset the state machine of the panel driver, simply wait 2 seconds in between messages and the state will be reset.

LED Commands

All LED panel commands follow the same structure, where the payload is strictly packed and all numbers larger than 8 bits are packed little endian.

1 BYTE        0-7 BYTES
+------------+-----------------+
| COMMAND ID | COMMAND PAYLOAD |
+------------+-----------------+

New commands can easily be added using the terminal_attach(terminal_t *term, terminal_cmd_t *cmd) function found in arduino/strobe/terminal.c.

Refresh Pixels

This command will refresh the LED array. This allows you to do multiple paint operations without eating the cost of refreshing the array after each one.

Command ID: R

Clear Pixels

This command will clear the LED arrays. This command has no payload.

Command ID: S

Window Pixels

This command will paint a window of pixels.

Command ID: W

Payload (in order):

  • u8 row-start: the starting row for the window
  • u8 col-start: the starting column for the window
  • u8 row-end: the starting row for the window
  • u8 col-end: the ending row for the window
  • u8 r: the brightness of the red LED in the pixel
  • u8 g: the brightness of the green LED in the pixel
  • u8 b: the brightness of the blue LED in the pixel

Set Pixel

This command will set an individual pixel.

Command ID: S

Payload (in order):

  • u16 index: the index of the pixel. The top left is pixel 0, and then it reads like a book.
  • u8 r: the brightness of the red LED in the pixel
  • u8 g: the brightness of the green LED in the pixel
  • u8 b: the brightness of the blue LED in the pixel

Requirements

System Setup

The overall diagram of how the LED controller, LED panels, power supply, and Mac Mini all interact can be seen below:

Since LED data is a serial stream, it originates by the Mac Mini's program sending data to the LED controller, which then sends it out to the 540 LEDs using SPI. The individual wires that need to be connected can be found below.

For the panel connections, the diagram shows a closeup of the screw terminals found on the backs of the panels. The panels should be positioned so that the screw terminals are in the lower-left of each panel. A legend for these connectors is below:

Line - Wire to another component.
X - Internal panel connection; leave connected.
N/C - No connection.

LED Controller


Panel 1 (Top)


Panel 2 (Bottom)


Power Supply Unit (PSU)

fraqture's People

Contributors

brandonmathis avatar dkniffin avatar sweetmandm avatar tylerrockwell avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.