Update README and improve error messaging in scanner and wizard

- Added troubleshooting notes in README for battery-powered device limitations and polling warnings.
- Enhanced scanner output to clarify when no IP is found, indicating potential battery-powered or offline status.
- Updated wizard to provide hints for "permission deny" errors, suggesting users check their Tuya IoT subscription.
- Bump version to 1.17.7.

Author: jasonacox

README.md

@@ -637,6 +637,8 @@ By default, the scan functions will retry 15 times to find new devices. If you a
 ## Troubleshooting
 
 * Tuya devices only allow one TCP connection at a time.  Make sure you close the TuyaSmart or SmartLife app before using *TinyTuya* to connect.
+* **Battery-powered devices** (sensors, door/window contacts, etc.) are asleep most of the time and do not maintain a local network connection. They will not appear in scans and cannot be controlled locally — they only push data to the cloud when triggered. This is expected behaviour, not a TinyTuya bug.
+* **Polling too aggressively can cause devices to drop or reset their connection.** Avoid polling faster than once per second for most devices. For energy-monitoring plugs and other data-heavy devices, a 5–10 second interval is safer. Use `set_socketPersistent(True)` with a heartbeat loop rather than opening a new connection on every poll.
 * Some devices ship with older firmware that may not work with *TinyTuya*. If you're experiencing issues, please try updating the device's firmware in the official app.
 * The LOCAL KEY for Tuya devices will change every time a device is removed and re-added to the TuyaSmart app. If you're getting decrypt errors, try getting the key again as it might have changed. 
 * Devices running protocol version 3.1 (e.g. below Firmware 1.0.5) do not require a device *Local_Key* to read the status. All devices will require a device *Local_Key* to control the device.

RELEASE.md

@@ -1,5 +1,11 @@
 # RELEASE NOTES
 
+## v1.17.7 - UX Improvements
+
+* Scanner: Improved messaging for devices with no IP address — now clearly indicates the device may be battery-powered or sleeping and that local control is not supported, instead of the generic "Error: No IP found".
+* Wizard: When the Tuya Cloud API returns a "permission deny" error (or error code 1010), the wizard now prints a targeted hint suggesting the user check their IoT Core service subscription at https://iot.tuya.com.
+* README: Added troubleshooting notes clarifying battery-powered device limitations and warning against aggressive polling intervals that can cause devices to drop or reset their connection.
+
 ## v1.17.6 - RFRemoteControlDevice Bug Fixes
 
 * Contrib: Fix `RFRemoteControlDevice` - three bugs that each independently caused `rfstudy_send` commands to be silently ignored by the device by @kongo09 in https://github.com/jasonacox/tinytuya/pull/684:

tinytuya/core/core.py

@@ -101,7 +101,7 @@
 if HAVE_COLORAMA:
     init()
 
-version_tuple = (1, 17, 6)  # Major, Minor, Patch
+version_tuple = (1, 17, 7)  # Major, Minor, Patch
 version = __version__ = "%d.%d.%d" % version_tuple
 __author__ = "jasonacox"
 

tinytuya/scanner.py

@@ -1841,8 +1841,8 @@ def _display_status( item, dps, term ):
         name = item['gwId']
     ip = item['ip']
     if not ip:
-        print("    %s[%-25.25s] %sError: No IP found%s" %
-              (term.subbold, name, term.alert, term.normal))
+        print("    %s[%-25.25s] %sNo IP found - Battery-powered or offline%s" %
+              (term.subbold, name, term.alertdim, term.normal))
     elif not dps:
         print("    %s[%-25.25s] %s%-18s - %sNo Response" %
               (term.subbold, name, term.dim, ip, term.alert))

tinytuya/wizard.py

@@ -192,6 +192,9 @@ def wizard(color=True, retries=None, forcescan=False, nocloud=False, assume_yes=
         if cloud.error:
             err = cloud.error['Payload'] if 'Payload' in cloud.error else 'Unknown Error'
             print('\n\n' + bold + 'Error from Tuya server: ' + dim + err)
+            if 'permission' in str(err).lower() or '1010' in str(err):
+                print(bold + 'Hint: ' + dim + 'This may indicate your Tuya IoT subscription has expired.')
+                print('      Visit https://iot.tuya.com to check and renew your IoT Core service.')
             print('Check API Key and Secret')
             return
 
@@ -208,6 +211,9 @@ def wizard(color=True, retries=None, forcescan=False, nocloud=False, assume_yes=
         if type(tuyadevices) != list:
             err = tuyadevices['Payload'] if 'Payload' in tuyadevices else 'Unknown Error'
             print('\n\n' + bold + 'Error from Tuya server: ' + dim + err)
+            if 'permission' in str(err).lower() or '1010' in str(err):
+                print(bold + 'Hint: ' + dim + 'This may indicate your Tuya IoT subscription has expired.')
+                print('      Visit https://iot.tuya.com to check and renew your IoT Core service.')
             print('Check DeviceID and Region')
             return