Why You Need Cloud Bridge

Most Tuya devices — smart plugs, lights, AC units, climate controllers — talk to GrowVPD Pro directly over your local network (LAN). No cloud needed. They are fast, private, and they keep working even if your internet drops.

But a few categories of Tuya devices only ever push data to the Tuya cloud and never accept LAN polling:

  • Battery WiFi temperature/humidity sensors (wsdcg category)
  • Battery CO2 sensors (co2bj)
  • Light/door sensors (ldcg, mcs)
  • Tuya cloud cameras (sp) for snapshots

For those, GrowVPD Pro needs to authenticate against the Tuya OpenAPI as you. The Cloud Bridge wizard makes that happen in 5 in-app steps, with no PC and no command-line tools.

Heads up. First-time setup takes 15–30 minutes because Tuya’s console requires email verification and a free trial. Plan to do it once, in a quiet moment.

Before You Start

You will need:

  • The Smart Life or Tuya Smart app installed on the same phone, with all your Tuya devices already added there.
  • An email account you can check on your phone (used for the Tuya developer trial).
  • About 20 minutes of focus.

The 5 Steps

Step 1

Open the wizard

In GrowVPD Pro, go to Automation → Add platform → Tuya → "I have cloud-only sensors". The wizard opens with a short explainer and a "Start" button.

Step 2

Create your free Tuya IoT trial

The wizard opens an in-app browser at iot.tuya.com. Sign up with your email, verify it, then create a new "Cloud Project". Choose any name (e.g. "GrowVPD"). Pick the region nearest to where your devices are paired (EU / US / CN / India). The wizard links the right hint above the field.

This trial is free, anonymous, and isolated from our infrastructure — the credentials live only in your phone’s encrypted store, never on our server.

Step 3

Subscribe to required APIs

Inside your Tuya Cloud Project, go to Service API → Go to authorize and subscribe (free trial) to the three APIs the wizard lists:

  1. IoT Core
  2. Smart Home Basic Service
  3. Smart Home Pulsar Service (push streaming)

Tap "I subscribed" in the wizard when done.

Step 4

Link your Smart Life account

Open the project’s "Devices → Link Tuya App Account" tab and scan the QR code with your Smart Life app. This tells Tuya’s cloud to expose your existing devices to your project. Smart Life will show a confirmation popup — tap "Authorize".

Step 5

Paste credentials and validate

Back in the wizard, paste:

  • Access ID / Client ID — from the project’s "Overview" tab
  • Access Secret / Client Secret — same place
  • Region — pre-selected from Step 2

Tap "Validate". The wizard hits Tuya’s OpenAPI, fetches a token, and lists every device in your project. Pick the ones to import (you can filter by category or by tent), tap "Add", and you’re done.

What Happens After Setup

GrowVPD Pro stores your credentials encrypted in SecureCredentialStore (uses Android Keystore). It then:

  • Polls Tuya OpenAPI every 5–15 minutes for cloud-only devices.
  • Subscribes to Tuya Pulsar — a websocket push channel — so battery sensors stream into your diary the moment Tuya’s cloud sees them.
  • Auto-refreshes the access token when it expires (default 2 hours).
  • Continues using LAN for all your other Tuya plugs/AC units/lights — the bridge is only used where it’s necessary.

Troubleshooting

"Validate failed: invalid signature" — double-check Access ID and Secret are pasted without leading/trailing spaces. Tuya’s console adds a "Copy" button next to each field; use it.

"No devices found" — you skipped Step 4. Re-link the Smart Life account by scanning the QR.

"Region mismatch" — the wizard picked the wrong region. Open Smart Life → Me → Settings → Account and Security and verify the country listed there. Re-create the Cloud Project in that region (free).

"Trial expired" (after 6 months) — Tuya offers free trial extensions in the console. Click "Renew" and the wizard’s validation will pass again immediately.

Privacy note. All Cloud Bridge traffic goes device → Tuya cloud → your phone. Our servers see nothing. The whole point of Path A (Cloud Bridge) is to remove our infrastructure from the loop.

Alternatives if Cloud Bridge Feels Too Much

If 5 steps and a developer trial sound like overkill, two simpler paths exist:

  • Swap to Zigbee TH sensors (Aqara WSDCGQ11LM, Sonoff SNZB-02) — same job, no cloud at all.
  • Use a self-hosted home agent (Path B, 2026 Q4) — we ship a small Kotlin/JVM relay you can run on a Raspberry Pi or NAS.