Ogemray

Ogemray SW40 25A – Homey App =========================== This Homey app adds local LAN support for the Ogemray SW40 25A relay running Shelly Gen2 firmware. The official Shelly app does not support this specific Ogemray hardware. This app fills that gap by providing reliable local polling for power, energy, and relay control. ------------------------------------------------------------ SUPPORTED FEATURES ------------------------------------------------------------ • Relay on / off control • Real-time power usage (W) • Energy usage (kWh) • Voltage (V) • Current (A) • Frequency (Hz) • Device temperature (°C) • Automatic recovery if the device IP address changes • Local-only operation (no cloud required) ------------------------------------------------------------ REQUIREMENTS ------------------------------------------------------------ • Ogemray SW40 25A relay (Model:S3PB-O3AR000001) • Shelly Gen2 firmware (minimal 1.7.1) • Device must be reachable on the local network • Homey Pro (SDK v3) ------------------------------------------------------------ IMPORTANT SECURITY NOTE ------------------------------------------------------------ ⚠️ Authentication must be DISABLED on the Shelly device ⚠️ Shelly Gen2 devices use HTTP Digest authentication when security is enabled. Homey does NOT support authenticated local RPC access for Shelly Gen2 devices. This is a technical limitation of the Shelly firmware and Homey SDK. If authentication is enabled, the device will show as unavailable in Homey with a clear error message. ------------------------------------------------------------ HOW TO DISABLE AUTHENTICATION (REQUIRED) ------------------------------------------------------------ 1. Open the Shelly web interface in your browser: http://<device-ip> 2. Go to: Settings → Authentication 3. Disable authentication for local access (or disable authentication entirely) 4. Save settings and reboot the device if required 5. Restart the Ogemray Homey app After this, Homey will automatically reconnect. ------------------------------------------------------------ PAIRING INSTRUCTIONS ------------------------------------------------------------ 1. Make sure the Shelly device is powered on and connected to your LAN 2. Open the Homey app 3. Add a new device 4. Select "Ogemray SW40 25A" 5. The device will be discovered automatically 6. Confirm pairing No cloud account or login is required. ------------------------------------------------------------ TROUBLESHOOTING ------------------------------------------------------------ Device shows "Authentication enabled": → Disable authentication in the Shelly web interface Device shows "Unreachable": → Check Wi-Fi connection → Verify IP address → Ensure the device is powered on Power or energy not updating: → This app uses polling (every 5 seconds) → Short network interruptions may delay updates briefly ------------------------------------------------------------ WHY POLLING IS USED ------------------------------------------------------------ Although Shelly Gen2 devices support WebSocket connections, local WebSocket event notifications are unreliable on many firmware versions. To guarantee stable operation, this app uses HTTP polling instead. This approach is proven, reliable, and used by many local integrations. ------------------------------------------------------------ PRIVACY ------------------------------------------------------------ • This app operates fully locally • No data is sent to the Shelly Cloud • No internet connection required • No user data is collected ------------------------------------------------------------ DISCLAIMER ------------------------------------------------------------ This app is not affiliated with Shelly or Ogemray. Use at your own risk. ------------------------------------------------------------ SUPPORT ------------------------------------------------------------ If you encounter issues: • Verify authentication is disabled • Check the Homey device logs • Restart the app and device ------------------------------------------------------------ VERSION ------------------------------------------------------------ Version: 0.9.0 Author: Robbert Mackiewicz