DemiRGB setup


Attach your strip lighting to J2 on the DemiRGB, making sure to line up the triangles on the board to the corresponding triangle or arrow on the strip light connector. Apply power (12V DC, at least 2A, 2.1mm inner pin positive), and the controller will perform a self test, fading the strip light in and out 8 times through various color combinations.

Wifi access point

The DemiRGB will create its own wifi access point, in the format “DemiRGB-??????”. The default password is “RGBControl” (case-sensitive). If you connect to it, you will be given an IP in the 192.168.4.X range.

To test, on a Linux or MacOS computer (or Windows with curl installed manually), you can send a demo command to the controller:

$ curl -v --data-binary '{"cmd":"demo"}' -H 'Content-type: application/json'

Network setup mode

To enter network setup mode, use the small jumper to short the “Cfg” and “G” pins of JP11.2, then reset the DemiRGB by pressing the Reset button on the D1 Mini, or by cycling power. The blue status LED on the D1 Mini will flash slowly; remove the jumper within the next 10 seconds to enter setup mode. The blue status LED will continue to flash slowly while in setup mode.

Connect to the “DemiRGB-??????” access point, and open in a web browser. In setup mode, you can enable and disable the Wifi client and access points, and set a device password.

Enable the Wifi client, and enter your main access point’s ESSID and password. It is recommended that you leave the DemiRGB’s access point enabled until you are sure the device client is successfully connecting to your network.

The setup page lists the DemiRGB’s Wifi client MAC address. It is recommended you configure your router / DHCP server to give this device a static address, so its IP does not change. Most routers allow for this, here is an example list of router vendor documentation:

SmartThings setup

Go to the SmartThings developer portal and log in with your SmartThings username and password.

Click “My Device Handlers”, then “+ Create New Device Handler”, then “From Code”. Paste in the contents of the DemiRGB SmartThings device handler, found here.

Click “Create”, and “DemiRGB LED Strip Controller” will now be created for your account.

Click “My Devices”, then “+ New Device”. Enter the following:

The “Device Network Id” is a hex representation of the DemiRGB’s IP address and port. For example, if the DemiRGB’s IP address on the network is, the Device Network Id would be C0A8010F:0050.

Click “Create”, and your SmartThings setup is complete.

DemiRGB API command reference

For full details on the HTTP JSON API used to communicate with DemiRGB, see here.

Factory reset

If you completely lose access to the DemiRGB (for example, the device’s access point is disabled and its wifi client has wrong information), you can perform a factory reset. Use the small jumper to short the “Cfg” and “G” pins of JP11.2, then reset the DemiRGB. The blue status LED on the D1 Mini will flash slowly; wait 10 seconds and it will begin flashing quickly. Remove the jumper once this happens to start the factory reset. Once the factory reset is complete, it will flash slowly and you can reset the device.

Hardware revision notes

Revision 1.2

There is no dedicated configuration / setup jumper pins on revision 1.2. Instead, short the “G” and “C” pins on J4 to do the same.