Skip to main content

Using the ESP RainMaker Home App

Scan QR Code to Add Device

  1. For devices with a QR code, you can tap + in the top right corner of the Home page. Select Scan QR code (please turn on the Bluetooth and Wi-Fi of your phone and connect your phone to a 2.4 GHz Wi-Fi network before scanning smart devices).
  2. Enter the Wi-Fi password and click Connect.
  3. The device will automatically connect to your app. After the connection is established, you can customize your device name, device group, and share control with others.

Manually Add Smart Devices

You can manually add smart devices using either BLE (Bluetooth Low Energy) or SoftAP (Wi-Fi Access Point) provisioning methods.

Using BLE Provisioning

Prerequisites: Enable Bluetooth and Location services on your phone. Connect to a 2.4 GHz Wi-Fi network.

  1. Select Bluetooth - On the "Add Device" screen, tap "Bluetooth" (description: "Add device using Bluetooth connection").
  2. Scan & Connect - The app scans for nearby devices automatically. Tap your device from the list. Connection takes 5-10 seconds. Use Refresh if your device doesn't appear.
  3. Enter POP Code (if required) - Enter the Proof of Possession code from your device label, then tap "Verify". This step is skipped for devices without security.
  1. Select Wi-Fi - Choose your Wi-Fi network from the list, or toggle "Join Other Network" for hidden networks.
  2. Enter Password - Enter your Wi-Fi password and tap "Connect". Optionally check "Remember this network".
  3. Provisioning - Wait 10-30 seconds while the app configures your device. Don't close the app during this process.
  4. Continue - Tap "Continue" to complete setup. Your device appears on the Home screen and is ready to use.

Using SoftAP Provisioning

Prerequisites: Enable Location services. Connect to a 2.4 GHz Wi-Fi network. Ensure the device is broadcasting its SoftAP network.

  1. Select SoftAP - On the "Add Device" screen, tap "SoftAP" (description: "Add device using SoftAP connection").
  2. Connect to Device
    • iOS: Tap "Go to Wi-Fi Settings". Your phone's Wi-Fi settings will open. Select the device's network. Return to the app and tap "Continue". The app verifies you're connected to the device's Wi-Fi.
    • Android: The app automatically scans for SoftAP devices. Available devices appear in a list. Tap on your device to select it (checkmark appears), then tap "Connect to Device". Connection takes 5-10 seconds. Use Refresh if your device doesn't appear.
  3. Enter POP Code (if required) - Enter the Proof of Possession code from your device label, then tap "Verify". This step is skipped for devices without security.
  4. Select Wi-Fi - Choose your home Wi-Fi network from the list, or toggle "Join Other Network" for hidden networks.
  5. Enter Password - Enter your Wi-Fi password and tap "Connect". Optionally check "Remember this network".
  6. Provisioning - Wait 10-30 seconds while the app configures your device. Don't close the app during this process. On iOS, the device will disconnect from its own Wi-Fi and connect to your home network.
  7. Continue - Tap "Continue" to complete setup. Your device appears on the Home screen and is ready to use.

Reset Devices (e.g., Bulb)

  1. If your smart device (such as a bulb) remains steadily on, it is successfully connected.
  2. If you want to reset your smart device, turn it off and on at an interval of two seconds and repeat the actions (off-on) five times until it is reset successfully and flashes yellow.

Delete Devices

  1. Open Device Control - On the Home page, find and tap the device you want to delete. The device control screen will open.
  2. Access Device Settings - Tap the Settings icon (gear icon) in the upper right corner of the control screen to open the Device Settings page.
  3. Remove Device - Scroll down to the bottom of the Settings page and tap the "Remove Device" button (red button).
  4. Confirm Removal - A confirmation dialog will appear asking you to confirm the deletion. Tap "Remove" to permanently remove the device.
  5. Factory Reset - The app will automatically perform a factory reset on the device (if supported) and then remove it from your account. You'll be returned to the Home page.

Room Management

  1. Access Rooms - Tap on the "Welcome to Home" button, then click on the "Home Management" button, which will navigate to the Home Management screen. Select the home into which you want to create/add rooms, then click on the "Room Management" tab. All rooms in that home are displayed.
  1. Create New Room - In the Room Management screen, tap the "+" button in the upper right corner to start creating a room.
  2. Name Your Room - Tap "Room Name" to select or customize a room name. You can:
    • Choose from suggested names (Bedroom, Living Room, Kitchen, etc.)
    • Create a custom name of your choice
  3. Add Devices - Tap devices from the "Add Devices" list to add them to your room. Selected devices appear in the "Existing Devices" section. Tap "Save" to finish.
  4. Access Room - A room tab will appear on the Home page showing all devices in that room.

Add or Delete Room Devices

  1. Access Rooms - Tap "Rooms" in the bottom navigation bar.
  2. Select Room - Tap on the room card you want to edit. The room details page will open.
  3. Edit Room - On the room page, tap the Settings icon (gear icon) in the upper right corner, or tap "Edit Room" to enter edit mode.
  4. Modify Devices:
    • Remove Device: Tap the minus (−) icon next to a device in the "Existing Devices" section to remove it from the room
    • Add Device: Tap the plus (+) icon next to a device in the "Add Devices" section to add it to the room
    • Rename Room: Tap "Room Name" to change the room's name
  5. Save Changes - Tap "Save" to apply your changes.

Voice Assistant

  1. Connect to Voice Assistant - You can connect smart devices to a voice assistant to control them more easily with voice.
  2. Access Integration - First, go to User > Voice Assistants and Integrations, tap a voice assistant you want to connect to, and then follow the instructions as listed in the workflow.

On this page