Control Your Smart Home
with YaranaSmartHome

YaranaSmartHome turns your ESP32 into a professional relay controller compatible with the Yarana Smart Home ecosystem.

Install the library through the Arduino Library Manager or by importing the ZIP package.

Method 1: Arduino Library Manager

1. Open Arduino IDE Launch the Arduino IDE on your computer.
2. Go to Library Manager Navigate to Sketch → Include Library → Manage Libraries…
3. Search for YaranaSmartHome Type YaranaSmartHome in the search box and press Enter.
4. Install the library Click Install on the YaranaSmartHome library by Yarana Web Tech.
5. Restart Arduino IDE Close and reopen Arduino IDE to load the library properly.
6. Open the example Go to File → Examples → YaranaSmartHome → YaranaBasic to start.

Method 2: ZIP Import

1. Download the library Get the latest version from the Yarana Web Tech website.
2. Open Arduino IDE Go to Sketch → Include Library → Add .ZIP Library…
3. Select the ZIP file Choose the downloaded YaranaSmartHome-x.x.x.zip file.
4. Install and restart Wait for confirmation, then restart Arduino IDE if needed.

Before using YaranaSmartHome, install these dependencies from the Arduino Library Manager:

Setting up YaranaSmartHome is straightforward. Define your relay pins, configure the basics, and you're ready to control your devices.

// Include the library
#include <YaranaSmartHome.h>

// Create the library instance
YaranaSmartHome yarana;

void setup() {
  Serial.begin(115200);

  // Configure your device
  YaranaConfig config;
  config.relayCount = 4;  // Use 4 or 8 relays

  // Set relay pins (use safe pins only)
  YARANA_SET_RELAY_PIN(config, 0, 32);
  YARANA_SET_RELAY_PIN(config, 1, 26);
  YARANA_SET_RELAY_PIN(config, 2, 27);
  YARANA_SET_RELAY_PIN(config, 3, 14);

  // Activate active-low mode (for most relay modules)
  config.relayActiveLow = true;

  // Initialize the library
  yarana.begin(config);
}

void loop() {
  // Keep the library running
  yarana.loop();
}

Choose your relay module type and configure the pins accordingly. We provide safe pin assignments for both 4-channel and 8-channel setups.

4-Channel Relay Module

YaranaConfig config;
config.relayCount = 4;
YARANA_SET_RELAY_PIN(config, 0, 32);  // Relay 1 → GPIO32
YARANA_SET_RELAY_PIN(config, 1, 26);  // Relay 2 → GPIO26
YARANA_SET_RELAY_PIN(config, 2, 27);  // Relay 3 → GPIO27
YARANA_SET_RELAY_PIN(config, 3, 14);  // Relay 4 → GPIO14

8-Channel Relay Module

YaranaConfig config;
config.relayCount = 8;
YARANA_SET_RELAY_PIN(config, 0, 32);  // Relay 1 → GPIO32
YARANA_SET_RELAY_PIN(config, 1, 26);  // Relay 2 → GPIO26
YARANA_SET_RELAY_PIN(config, 2, 27);  // Relay 3 → GPIO27
YARANA_SET_RELAY_PIN(config, 3, 14);  // Relay 4 → GPIO14
YARANA_SET_RELAY_PIN(config, 4, 25);  // Relay 5 → GPIO25
YARANA_SET_RELAY_PIN(config, 5, 33);  // Relay 6 → GPIO33
YARANA_SET_RELAY_PIN(config, 6, 16);  // Relay 7 → GPIO16
YARANA_SET_RELAY_PIN(config, 7, 17);  // Relay 8 → GPIO17

Not all ESP32 GPIO pins are safe to use with relays. The library protects you from common mistakes.

The Yarana Smart Home app makes setup effortless. No complex coding or network configuration needed.

Once set up, you have complete control over your relays through the app. The library handles all the communication in the background.

What You Can Do

The library is designed to be simple. You only need to know a few key functions.

Essential Functions

Helper Macro

// Always use this macro to set relay pins safely
YARANA_SET_RELAY_PIN(config, relay_number, gpio_pin);

// Example:
YARANA_SET_RELAY_PIN(config, 0, 32);  // Safe
YARANA_SET_RELAY_PIN(config, 1, 2);   // Error: GPIO2 is reserved

Need help or want to learn more about IoT and ESP32? Here are the best resources: