# Welcome

Welcome to the Luxio Wiki.


# 1. Buying Hardware

## Controller

For each Luxio LED Strip, you need a single [Wemos LOLIN D1 mini V4](https://www.wemos.cc/en/latest/d1/d1_mini.html). These are only a few dollars on AliExpress.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>LOLIN D1 mini V4</strong></td><td><a href="https://aliexpress.com/item/1005005407298963.html">https://aliexpress.com/item/1005005407298963.html</a></td><td><a href="/files/mkQ1E2z1Ne7vkxCJLDD7">/files/mkQ1E2z1Ne7vkxCJLDD7</a></td><td><a href="https://aliexpress.com/item/1005005407298963.html">https://aliexpress.com/item/1005005407298963.html</a></td></tr></tbody></table>

## LED Strip

Luxio works exclusively with any WS2812b LED Strip.

These are digital, individual-addressable LEDs placed on a strip varying in length — usually between 1 meter and 5 meter.

You can configure the number of LEDs for every Luxio, so you can buy varying lengths. Just keep note of the power usage.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Classic</strong></td><td><a href="https://aliexpress.com/item/1005005288299757.html">https://aliexpress.com/item/1005005288299757.html</a></td><td><a href="/files/qlwac7wwj0XuEApgzx3z">/files/qlwac7wwj0XuEApgzx3z</a></td><td><a href="https://aliexpress.com/item/1005005288299757.html">https://aliexpress.com/item/1005005288299757.html</a></td></tr><tr><td><strong>Diffuse</strong></td><td><a href="https://aliexpress.com/item/1005005671523389.html">https://aliexpress.com/item/1005005671523389.html</a></td><td><a href="/files/5cTKtILvcnrVazKjbu2e">/files/5cTKtILvcnrVazKjbu2e</a></td><td><a href="https://aliexpress.com/item/1005005671523389.html">https://aliexpress.com/item/1005005671523389.html</a></td></tr><tr><td><strong>Ring</strong></td><td><a href="https://nl.aliexpress.com/item/1005002286128420.html">https://nl.aliexpress.com/item/1005002286128420.html</a></td><td><a href="/files/DgjYiVqKPfUvQXmjm3t0">/files/DgjYiVqKPfUvQXmjm3t0</a></td><td><a href="https://nl.aliexpress.com/item/1005002286128420.html">https://nl.aliexpress.com/item/1005002286128420.html</a></td></tr></tbody></table>

## USB-C Cable

Any USB-C cable that transmits power should work, but keep mind that some have bad quality.

{% hint style="warning" %}
To do: suggest an USB-C Cable
{% endhint %}

## USB-C Adapter

Any 5V USB-C adapter will work, but it depends on the number of LEDs how much Ampere (A) you need.

The LOLIN D1 mini requires `200 mA`.

As a rule of thumb, every LED requires `50 mA` (that's `0.05 A`) when it's full-brightness and white.

For example, for a 2-meter LED Strip with 120 LEDs, you need `0.2 A + 0.05 ⨉ 120 = 6.2 A`.&#x20;

As you can see, that's a lot and these adapters are very rare to come by! Regular adapters are only about 2 A. However, in the real world, these adapters perform quite well, because your LED-strip is rarely full-brightness and white — which uses most power.

In our example, a `3 A` adapter would work fine.

{% hint style="warning" %}
To do: suggest an USB-C Adapter
{% endhint %}


# 2. Soldering

Solder the following 3 wires to the LED Strip connector (or to the LED strip directly).

{% hint style="info" %}
The LED strip has a direction, which is shown by arrows. Make sure to solder the `DI` wire on the left side of the arrow.
{% endhint %}

| LOLIN D1 mini V4 | LED Strip |                                                    |
| ---------------- | --------- | -------------------------------------------------- |
| `GND`            | `GND`     | White                                              |
| `VBUS`           | `+5V`     | <mark style="background-color:red;">Red</mark>     |
| `0`              | `DI`      | <mark style="background-color:green;">Green</mark> |

<figure><img src="/files/TzzW0Ya3lUC7hB5sMbEQ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
On older Wemos D1 mini, pin `0` may be called `D3`.
{% endhint %}


# 3. Flashing

To program the LOLIN D1 mini, connect its USB-C port to a PC or Mac.

Then visit <https://flash.luxio.lighting> in Google Chrome, Microsoft Edge or Opera.

Afterwards, you can connect the device to Wi-Fi. From then on, it will install software updates automatically.


# Weather

An effect that sends your phone's location to Luxio, which polls for weather data and shows an effect based on the state (e.g. sunny, raining, thunderstorm etc.).


# Matter

At some point, Luxio should support Matter. At least for turning on/off, setting the brightness, and setting a solid color.


# Luxio Link

Luxio Link would be a technology where multiple Luxio devices could work together as one large LED strip. Imagine a multi-monitor setup, where every monitor is placed in a virtual space in relation to each other.

The first Luxio could control pixels 1 — 60, the second Luxio does 61 — 120 etc.


