config_gen/README (cfbf6e7) - libetherpix · BlinkenArea

README

The tool etherpix_config_gen creates the major part of a etherpix config file
from a drawing of the display in DXF format.

See for example "examples/5x2panels8x12.dxf".

The layers containing drawing data are:

layer "video": one rectangle describing the area of the video frame,
               representing the outline of the video area of the physical
               display
layer "pixel": one circle (diameter does not matter) for each LED
               located at the correct position, representing the
               physical position of the LED in the physical display
comment: the two points above mean that the drawing is actually a to-scale
         mechanical drawing of the real display
layer "cable 1": lines connecting the pixel circles in the drawing in the
                 same way as the real wires connect the real LEDs,
                 the lines have to go a bit into each pixel circle,
                 make sure different cable lines do no touch or cross
layer "cable 0": another layer for data cables, use this when a cable line
                 crosses a cable line on layer "cable 1"
layer "distributor 0": one rectangle describing the first distributor, all
                       cable line to the first pixel of each chain must
                       start in this rectable; the cable lines going out
                       of this rectangle must be in order, i.e. first
                       line leaving is output 0, second one is output 1,
                       and so on; the first four outputs go to the first
                       RJ45 connector, ...; the text in the drawing is
                       ignored (example file contains "000" for the
                       human that is seeing the drawing)
layer "distributor 1": second distributor (not in example drawing)
layer "distributor 0x2": ...
layer "network": a small line going into the distributor rectangle,
                 counting outputs starts at this line, no other purpose
                 besides marking the position of the first output

There are four more layers for providing some numbers about the installation.
Those numbers are encoded in the layer names. There are no drawing objects
on those layers.

layer "cfg_width 40": number of pixels in the video frame in horizontal
                      direction
layer "cfg_height 24": number of pixels in the video frame in vertical
                       direction
layer "cfg_outputs 32": number of outputs at each distributor
layer "cfg_pixels 96": number of pixels connected to each output of the distributors,
                       if outputs have different numbers of pixels,
                       use the maximum number

libetherpix

clarify readme file