WLED/usermods/multi_relay
2022-01-22 20:49:43 +01:00
..
readme.md Add Home Assisant MQTT autodiscovery for usermod multi_relay. 2022-01-20 00:30:17 +01:00
usermod_multi_relay.h Added config option for HA autodiscovery. 2022-01-22 20:49:43 +01:00

Multi Relay

This usermod-v2 modification allows the connection of multiple relays each with individual delay and on/off mode.

HTTP API

All responses are returned as JSON.

Status Request: http://[device-ip]/relays Switch Command: http://[device-ip]/relays?switch=1,0,1,1
The number of numbers behind the switch parameter must correspond to the number of relays. The number 1 switches the relay on. The number 0 switches the relay off.

Toggle Command: http://[device-ip]/relays?toggle=1,0,1,1 The number of numbers behind the parameter switch must correspond to the number of relays. The number 1 causes a toggling of the relay. The number 0 leaves the state of the device.

Examples

  1. 4 relays at all, relay 2 will be toggled: http://[device-ip]/relays?toggle=0,1,0,0
  2. 3 relays at all, relay 1&3 will be switched on: http://[device-ip]/relays?switch=1,0,1

JSON API

You can switch relay state using the following JSON object transmitted to: http://[device-ip]/json

Switch relay 0 on: {"MultiRelay":{"relay":0,"on":true}} Switch relay4 3 & 4 off: {"MultiRelay":[{"relay":2,"on":false},{"relay":3,"on":false}]}

MQTT API

wled/deviceMAC/relay/0/command on|off|toggle wled/deviceMAC/relay/1/command on|off|toggle

When relay is switched it will publish a message:

wled/deviceMAC/relay/0 on|off

Usermod installation

  1. Register the usermod by adding #include "../usermods/multi_relay/usermod_multi_relay.h" at the top and usermods.add(new MultiRelay()); at the bottom of usermods_list.cpp. or
  2. Use #define USERMOD_MULTI_RELAY in wled.h or -D USERMOD_MULTI_RELAY in your platformio.ini

You can override the default maximum number (4) of relays by defining MULTI_RELAY_MAX_RELAYS.

Example usermods_list.cpp:

#include "wled.h"
/*
 * Register your v2 usermods here!
 *   (for v1 usermods using just usermod.cpp, you can ignore this file)
 */

/*
 * Add/uncomment your usermod filename here (and once more below)
 * || || ||
 * \/ \/ \/
 */
//#include "usermod_v2_example.h"
//#include "usermod_temperature.h"
#include "../usermods/usermod_multi_relay.h"

void registerUsermods()
{
  /*
   * Add your usermod class name here
   * || || ||
   * \/ \/ \/
   */
  //usermods.add(new MyExampleUsermod());
  //usermods.add(new UsermodTemperature());
  usermods.add(new MultiRelay());

}

Configuration

Usermod can be configured in Usermods settings page.

If there is no MultiRelay section, just save current configuration and re-open Usermods settings page.

Have fun - @blazoncek

Change log

2021-04

  • First implementation.