From b5c326d772cb9cbe52e0379c7f7200816e8abdf0 Mon Sep 17 00:00:00 2001
From: s-hadinger <49731213+s-hadinger@users.noreply.github.com>
Date: Thu, 2 Jan 2025 10:44:39 +0100
Subject: [PATCH] Berry Leds update comments (#22748)

---
 .../berry_tasmota/src/embedded/leds.be        | 26 ++++++++-----------
 .../xdrv_52_3_berry_leds.ino                  | 14 ++++------
 2 files changed, 16 insertions(+), 24 deletions(-)

diff --git a/lib/libesp32/berry_tasmota/src/embedded/leds.be b/lib/libesp32/berry_tasmota/src/embedded/leds.be
index 8c339bc13..3a17e047c 100644
--- a/lib/libesp32/berry_tasmota/src/embedded/leds.be
+++ b/lib/libesp32/berry_tasmota/src/embedded/leds.be
@@ -8,18 +8,14 @@
 # 01 : begin        void -> void
 # 02 : show         void -> void
 # 03 : CanShow      void -> bool
-# 04 : IsDirty      void -> bool
-# 05 : Dirty        void -> void
+# 04 : IsDirty      void -> bool (deprecated)
+# 05 : Dirty        void -> void (deprecated)
 # 06 : Pixels       void -> bytes() (mapped to the buffer)
 # 07 : PixelSize    void -> int
 # 08 : PixelCount   void -> int
-# 09 : ClearTo      (color:??) -> void
-# 10 : SetPixelColor (idx:int, color:??) -> void
-# 11 : GetPixelColor (idx:int) -> color:??
-# 20 : RotateLeft   (rot:int [, first:int, last:int]) -> void
-# 21 : RotateRight  (rot:int [, first:int, last:int]) -> void
-# 22 : ShiftLeft    (rot:int [, first:int, last:int]) -> void
-# 23 : ShiftRight   (rot:int [, first:int, last:int]) -> void
+# 09 : ClearTo      (color:0xRRGGBB or 0xWWRRGGBB) -> void
+# 10 : SetPixelColor (idx:int, color:0xRRGGBB or 0xWWRRGGBB) -> void
+# 11 : GetPixelColor (idx:int) -> color:0xRRGGBB or 0xWWRRGGBB
 
 class Leds_ntv end
 
@@ -116,10 +112,10 @@ class Leds : Leds_ntv
   def can_show()
     return self.call_native(3)
   end
-  def is_dirty()
+  def is_dirty()                ## DEPRECATED
     return self.call_native(4)
   end
-  def dirty()
+  def dirty()                   ## DEPRECATED
     self.call_native(5)
   end
   def pixels_buffer(old_buf)
@@ -216,10 +212,10 @@ class Leds : Leds_ntv
       def can_show()
         return self.strip.can_show()
       end
-      def is_dirty()
+      def is_dirty()                ## DEPRECATED
         return self.strip.is_dirty()
       end
-      def dirty()
+      def dirty()                   ## DEPRECATED
         self.strip.dirty()
       end
       def pixels_buffer()
@@ -303,10 +299,10 @@ class Leds : Leds_ntv
       def can_show()
         return self.strip.can_show()
       end
-      def is_dirty()
+      def is_dirty()                ## DEPRECATED
         return self.strip.is_dirty()
       end
-      def dirty()
+      def dirty()                   ## DEPRECATED
         self.strip.dirty()
       end
       def pixels_buffer()
diff --git a/tasmota/tasmota_xdrv_driver/xdrv_52_3_berry_leds.ino b/tasmota/tasmota_xdrv_driver/xdrv_52_3_berry_leds.ino
index 555f4c44d..43c944621 100644
--- a/tasmota/tasmota_xdrv_driver/xdrv_52_3_berry_leds.ino
+++ b/tasmota/tasmota_xdrv_driver/xdrv_52_3_berry_leds.ino
@@ -59,18 +59,14 @@ extern "C" {
   // # 01 : begin        void -> void
   // # 02 : show         void -> void
   // # 03 : CanShow      void -> bool
-  // # 04 : IsDirty      void -> bool
-  // # 05 : Dirty        void -> void
+  // # 04 : IsDirty      void -> bool (deprecated)
+  // # 05 : Dirty        void -> void (deprecated)
   // # 06 : Pixels       void -> bytes() (mapped to the buffer)
   // # 07 : PixelSize    void -> int
   // # 08 : PixelCount   void -> int
-  // # 09 : ClearTo      (color:??) -> void
-  // # 10 : SetPixelColor (idx:int, color:??) -> void
-  // # 11 : GetPixelColor (idx:int) -> color:??
-  // # 20 : RotateLeft   (rot:int [, first:int, last:int]) -> void
-  // # 21 : RotateRight  (rot:int [, first:int, last:int]) -> void
-  // # 22 : ShiftLeft    (rot:int [, first:int, last:int]) -> void
-  // # 23 : ShiftRight   (rot:int [, first:int, last:int]) -> void
+  // # 09 : ClearTo      (color:0xRRGGBB or 0xWWRRGGBB) -> void
+  // # 10 : SetPixelColor (idx:int, color:0xRRGGBB or 0xWWRRGGBB) -> void
+  // # 11 : GetPixelColor (idx:int) -> color:0xRRGGBB or 0xWWRRGGBB
 
   void * be_get_tasmotaled(bvm *vm) {
     be_getmember(vm, 1, "_p");