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 tap 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 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 the Welcome to Home button, then tap the Home Management button, which will navigate to the Home Management screen. Select the home into which you want to create/add rooms, then tap 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 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