A 5-minute guide to intelligent climate control.

Setting up a smart home shouldn't feel like rocket science. Follow this guide to connect your home to the OASIS Cloud.

📖 The Story of Alex and the "Cozy Cabin"
throughout this guide, we will follow Alex.
Alex has a weekend home called "Cozy Cabin".
Alex wants to control the Living Room heater using a simple Xiaomi Temperature Sensor that is already connected to Home Assistant.

Let's see how Alex sets this up.

1. The Keys to the Kingdom 🗝️

Before we start, you need your credentials. These connect your private Home Assistant instance to your secure area on the OASIS Cloud.

• API URL: Usually provided by your OASIS provider
  (e.g., https://www.oasis-climate.com/api/v1).
• API Key: Your secret passkey.

Alex logs into the OASIS Dashboard, generates a new API Key labeled "Home Assistant", and copies it to the clipboard.

2. The First Connection 🔌

1. Go to Settings > Devices & Services in Home Assistant.
2. Click Add Integration and search for OASIS Climate.
3. You will be greeted by the setup screen.
4. Paste your API URL and API Key.

Alex pastes the key. The integration instantly validates the credentials with the cloud. Success!

3. Defining Your Home 🏠

OASIS needs to know which "Home" it is managing.

• If you are new: The integration will automatically suggest creating a new home based on your Home Assistant name.
• If you are an existing user: You will see a list of your homes.

The integration asks: "Select Home".
Alex sees "Create new home: Cozy Cabin" in the dropdown and selects it.
OASIS creates the "Cozy Cabin" in the cloud database instantly.

4. Creating Your Thermostats 🌡️

Now that the house exists, we need to define the zones. In OASIS, a Thermostat is a logical zone (like a room) that you want to control.

1. Find the OASIS Climate integration in your list.
2. Click Configure.
3. Select "Add new Thermostat".
4. Give it a name.

Alex types "Living Room" and hits Submit.
Like magic, a new climate entity appears in Home Assistant. Alex can now set the target temperature, but... wait! The current temperature is missing. OASIS is blind!

5. Giving OASIS "Senses" 👁️

This is where the magic happens. We don't force you to buy proprietary hardware. We use what you already have. We need to tell OASIS which sensor reads the temperature for the "Living Room".

1. Click Configure on the integration again.
2. Select "Manage Sensors".
3. Select the Thermostat: "Living Room".
4. Select the Sensor Slot: "Temperature (Indoor)".
5. Select Action to perform: "Link Sensor".
6. Select Home Assistant Entity: Living Room Temperature.

You will see two fields:

• Sensor Slot: What kind of data is this? (e.g., Indoor Temperature, Humidity, Window Contact).
• Entity: Which Home Assistant device provides this data?

Alex selects:

• Slot: Temperature (Indoor)
• Entity: sensor.living_room_temperature

Alex clicks Submit. Suddenly, the "Living Room" thermostat on the dashboard updates. It now shows 19.5°C. The link is live.

6. Enabling Telemetry 📡

For the AI to learn, it needs data. You need to allow OASIS to record the history of your sensors.

1. Go to your Dashboard (Overview).
2. Look for the OASIS Telemetry switch (or find it in your entities).
3. Turn it ON.

You can also adjust how often data is sent using the configuration numbers (Batch Size & Flush Interval) to balance speed vs. network usage.

Alex flips the switch. The system begins buffering data. Every 5 minutes, a packet of temperature history is sent to the cloud. The AI starts analyzing the thermal properties of the Cozy Cabin.

🎉 You are done

Your home is now connected.

• Control: Change the temperature from Home Assistant, and the OASIS Cloud receives the command instantly.
• Feedback: Change the mode from the OASIS Web Dashboard, and Home Assistant updates immediately.

Enjoy your comfort. Let OASIS handle the rest.