Skip to content

Commit

Permalink
Updated Readme with some requirements
Browse files Browse the repository at this point in the history
  • Loading branch information
Memphiz authored Sep 10, 2020
1 parent a8f302a commit df783f4
Showing 1 changed file with 19 additions and 0 deletions.
19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,21 @@
# LedTableSimulator
Simulation frontend for a 10 x 10 RGB Pixel Led Table

This Repository contains a platform agnostic UI frontend that visualizes a 10 x 10 RGB LED Matrix LedTable.

Requirements:
1. The UI should be as platform independend as possible (at least MacOS, Linux and Windows should be supported, Bonus points for Android and iOS)
2. The UI should contain a 10 x 10 LED Pixel Matrix with rather huge pixels (lets say 64x64 screen pixels form one LED pixel)
3. The Simulator should receive the pixel values to be shown based on the following specification:
a. Each pixel is represented bye 3 Bytes
b. Each byte in a single pixel datum represents a single color value (0 - 255 where 0 is off, and 255 is maximum brightness)
c. The color order of each pixel is BGR (blue, green red)
d. The pixel values for the whole table are represented as a byte array of size 10 x 10 x 3 bytes.
4. The pixel data array of point 3.d is named framebuffer from now on
5. The Simulator should receive the framebuffer via MQTT by subscribing to the topic ledtable/simulation/framebuffer
6. Whenever the framebuffer is received via mqtt - the UI should update its state based on the framebuffer content
7. The pixel order inside the framebuffer is as follows (snake pattern):
a. Width is 10 pixels - refered to by W
b. Height is 10 pixel - refered to by H
c. X and Y are coordinates on the table where x = 0 is the very left and y = 0 is the very bottom of the table.
d. Pixel order is x0y0 .. xWy0, xWy1 .. x0y1, x0y2 .. xWy2, xWy3 ..x0y3 .. up to yH

0 comments on commit df783f4

Please sign in to comment.