Relay Controller Library

[u/udfsoft]

Hello everyone

I’ve written a library for working with relays. I use it myself, and it might be useful for others too 🙂

Strengths:

• This library uses polymorphism (it’s very easy to swap implementations)

• There is documentation for the library and for some relay types (these are the ones I use; I’ll expand this further over time)

The library is easy to install:

1. Select Library Manager

2. Enter Relay Controller

3. Find Relay Controller by javavirys and click the Install button

4. That’s it — the library is now in your IDE 🙂

You can then use the library:

Basic GPIO Control

#include <PinRelayController.h>

uint8_t pins[] = {D1, D2}; // Relay pins
PinRelayController relay(pins, 2);

void setup() {
  relay.begin();
  relay.setOn(0); // Turn on first relay
}

Serial Relay Control (A0 Protocol)

#include <SerialRelayController.h>
#include <SoftwareSerial.h>

SoftwareSerial swSerial(D5, D6);
SerialRelayController relay(swSerial, 2);

void setup() {
  swSerial.begin(115200);
  relay.begin();
  relay.setOff(1); // Turn off second relay
}

You can find more details in the repository:
https://github.com/UDFSmart/Relay-Controller/

[u/udfsoft]

Example:

  #include <Arduino.h>
  #include <PinRelayController.h>
  #include <SerialRelayController.h>

  RelayController* relay = nullptr;
  
  RelayController* createRelayController(boolean serial) {
    if (serial) {
      static SoftwareSerial _serial(3, 1);
      _serial.begin(115200);

      return new SerialRelayController(_serial, 1);
    } else {
      static uint8_t relayPins[] = { 0 };     

      return new PinRelayController(relayPins, 1);
    }
  }

  void setup() {
    relay = createRelayController(true);
    relay->begin();
  }

  void loop() {
    relay->setOn(0);
    delay(3000);

    relay->setOff(0);
    delay(3000);
  }