Getting started with Lightberry

Raspberry Pi

Lightberry requires Raspberry Pi to work. Only minimal set is required:

Any Raspberry Pi: 2 / B+ / B / A+ / A
SD Card
Power supply: min. 1A
Internet connection: ethernet cable, USB Wi-Fi Card
Optional: HDMI Cable, Case

Next step is to prepare system for your Raspberry Pi.

Choose right system for you with the help of this article
Write it on your SD Card with this tutorial: Windows
Insert in Raspberry Pi

Lightberry

Lightberry is a base for our system, it contains LEDs, power supply and converter. Base itself out of box work with remote signals and XBMC. You can expand its functionality with kits.

Lightberry set contains:

LEDs of a chosen size and type
Matching power supply: 5V 4A for regular Lightberry, 5V 6A for 4m Lightberry HD or 5V 8A for 5m Lightberry HD
Lightberry converter box
Raspberry Pi - Converter box connection cable

Now it's time to mount it!

Mount LEDs on the back of TV
Connect Converter box to
- Raspberry Pi
- Lightberry LEDs
- Power supply
Plug all power adapters into sockets

Configure your setup

Let's now prepare a config file crafted for your hyperion setup.

We recommend using our
Lightberry Confiuration plugin

Generate one using HyperCon tool
Add grabber section if you have kit
Use this tutorial to upload file to OpenELEC config directory
Restart Raspberry Pi

Device section

Depending on your LEDs and converter type you need a specific device configuration settings

RPI GPIO Converter WS2801 (if we didn't specify LED type it's WS2801)

    "device": {
      "name"       : "MyPi",
      "type"       : "lightberry",
      "output"     : "/dev/spidev0.0",
      "rate"       : 1000000,
      "colorOrder" : "rgb"
    },

RPI GPIO Converter APA102

    "device": {
      "name"       : "MyPi",
      "type"       : "apa102",
      "output"     : "/dev/spidev0.0",
      "rate"       : 500000,
      "colorOrder" : "bgr"
    },

USB Converter WS2801 (if we didn't specify LED type it's WS2801)

    "device": {
        "type": "adalight",
        "name": "MyPi",
        "colorOrder": "rgb",
        "output": "/dev/ttyACM0"
    },

USB Converter APA102

    "device": {
        "colorOrder": "bgr",
        "rate": 500000,
        "type": "adalightapa102",
        "name": "MyPi",
        "output": "/dev/ttyACM0"
    },

Grabber section

If you have ANY of our kits and want to use it, you have to add this section to your file. Place it before endOfJson tag.

UTV007 based EasyCap grabbers

    "grabber-v4l2" :
    {
        "device" : "/dev/video0",
        "input" : 0,
        "standard" : "PAL",
        "width" : 720,
        "height" : 576,
        "frameDecimation" : 2,
        "sizeDecimation" : 8,
        "priority" : 800,
        "mode" : "2D",
        "cropLeft" : 5,
        "cropRight" : 5,
        "cropTop" : 5,
        "cropBottom" : 5,
        "redSignalThreshold" : 0.2,
        "greenSignalThreshold" : 0.2,
        "blueSignalThreshold" : 0.2
    },

STK1160 based EasyCap grabbers

    "grabber-v4l2" :
    {
        "device" : "/dev/video0",
        "input" : 0,
        "standard" : "PAL",
        "width" : 240,
        "height" : 192,
        "frameDecimation" : 2,
        "sizeDecimation" : 2,
        "priority" : 800,
        "mode" : "2D",
        "cropLeft" : 0,
        "cropRight" : 0,
        "cropTop" : 0,
        "cropBottom" : 0,
        "redSignalThreshold" : 0.2,
        "greenSignalThreshold" : 0.2,
        "blueSignalThreshold" : 0.2
    },