From 7374bfee5810ca7b2af51b18c4e59fe977fcc478 Mon Sep 17 00:00:00 2001
From: Hany Naji <hany.tamman77@gmail.com>
Date: Wed, 15 Apr 2026 14:38:11 +0200
Subject: [PATCH 1/2] Create STIPS IR Remote integration documentation

Added documentation for STIPS IR Remote integration, including setup, configuration, supported functionality, and troubleshooting.
---
 source/_integrations/stips_iru1.markdown | 69 ++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 source/_integrations/stips_iru1.markdown

diff --git a/source/_integrations/stips_iru1.markdown b/source/_integrations/stips_iru1.markdown
new file mode 100644
index 000000000000..0c37d2396383
--- /dev/null
+++ b/source/_integrations/stips_iru1.markdown
@@ -0,0 +1,69 @@
+---
+title: "STIPS IR Remote"
+description: "Control AC units through STIPS IRU1 over your local network."
+ha_category:
+  - Climate
+ha_iot_class: "Local Push"
+ha_domain: "stips_iru1"
+ha_platforms:
+  - climate
+ha_config_flow: true
+---
+
+# STIPS IR Remote
+
+The **STIPS IR Remote** integration lets Home Assistant control supported air conditioners through a **STIPS IRU1** device.
+
+During setup, Home Assistant signs in to your STIPS account to download your IR catalog, including areas, devices, and remotes. After setup, climate commands are sent locally on your LAN to the IRU1 device.
+
+## Prerequisites
+
+- A STIPS account with access to your IR catalog.
+- At least one STIPS IRU1 device linked to your account.
+- The IRU1 device and Home Assistant must be on the same local network.
+- The IRU1 device should be online and reachable by hostname on your LAN.
+
+## Configuration
+
+1. In Home Assistant, go to **Settings** > **Devices and Services**.
+2. Select **Add Integration**.
+3. Search for **STIPS IR Remote**.
+4. Enter:
+   - API host
+   - Username
+   - Password
+5. Finish setup.
+
+If setup succeeds, Home Assistant imports supported climate remotes from your STIPS catalog.
+
+## Supported functionality
+
+Climate platform support for:
+
+- Protocol AC remotes
+- Learned AC remotes
+- HVAC mode control
+- Target temperature control
+- Fan mode control
+- Swing mode control, where supported by the remote model
+- Turn on and turn off
+
+## Notes
+
+- Internet access is required during setup to fetch catalog data.
+- Normal climate command dispatch is local over LAN after setup.
+- If the device hostname cannot be resolved, ensure the IRU1 is online and reachable on your network, then reload or reconfigure the integration.
+
+## Limitations
+
+- This initial version supports climate entities only.
+- Non-climate remote features are planned for a follow-up release.
+
+## Troubleshooting
+
+If entities appear unavailable or commands fail:
+
+1. Confirm the IRU1 is powered on and connected to your LAN.
+2. Confirm Home Assistant can resolve and reach the device hostname.
+3. Reload the integration from **Devices and Services**.
+4. Reconfigure the integration if catalog data has changed.

From aa8250df24ad0a3c813ba8f8d27035354fa762c1 Mon Sep 17 00:00:00 2001
From: Hany Naji <hany.tamman77@gmail.com>
Date: Wed, 15 Apr 2026 20:59:12 +0200
Subject: [PATCH 2/2] Enhance STIPS IR Remote documentation and details

Updated formatting and added release version information.
---
 source/_integrations/stips_iru1.markdown | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/source/_integrations/stips_iru1.markdown b/source/_integrations/stips_iru1.markdown
index 0c37d2396383..6c22e67c52d3 100644
--- a/source/_integrations/stips_iru1.markdown
+++ b/source/_integrations/stips_iru1.markdown
@@ -8,9 +8,10 @@ ha_domain: "stips_iru1"
 ha_platforms:
   - climate
 ha_config_flow: true
+ha_release: "2026.4"
 ---
 
-# STIPS IR Remote
+## STIPS IR Remote
 
 The **STIPS IR Remote** integration lets Home Assistant control supported air conditioners through a **STIPS IRU1** device.
 
@@ -25,7 +26,7 @@ During setup, Home Assistant signs in to your STIPS account to download your IR
 
 ## Configuration
 
-1. In Home Assistant, go to **Settings** > **Devices and Services**.
+1. In Home Assistant, go to **Settings** > **Devices & services**.
 2. Select **Add Integration**.
 3. Search for **STIPS IR Remote**.
 4. Enter:
@@ -65,5 +66,5 @@ If entities appear unavailable or commands fail:
 
 1. Confirm the IRU1 is powered on and connected to your LAN.
 2. Confirm Home Assistant can resolve and reach the device hostname.
-3. Reload the integration from **Devices and Services**.
+3. From **Devices & services**, open STIPS IR Remote integration and reload the integration from (three-dots menu).
 4. Reconfigure the integration if catalog data has changed.