micrOSDevToolKit 2.9.1__py3-none-any.whl → 2.26.1__py3-none-any.whl

micrOS/source/Config.py

@@ -12,21 +12,28 @@ Designed by Marcell Ban aka BxNxM
 #################################################################
 #                           IMPORTS                             #
 #################################################################
-from os import remove
 from re import search
 from json import load, dump
+from uos import remove
 from utime import sleep
-from Debug import DebugCfg, console_write, errlog_add
+from Debug import DebugCfg, console_write, syslog
+from Files import OSPath, path_join, is_file
+from uos import rename as move_file
 try:
     from microIO import set_pinmap
 except:
-    errlog_add("[ERR] LogicalPins import: set_pinmap")
+    syslog("[ERR] microIO import: set_pinmap")
     set_pinmap = None
 
 
 class Data:
-    # micrOS config path
-    CONFIG_PATH = "node_config.json"
+    """
+    Data class for managing configuration data.
+    """
+    __slots__ = []
+
+    CONFIG_NAME = "node_config.json"
+    CONFIG_PATH = path_join(OSPath.CONFIG, CONFIG_NAME)
     CONFIG_CACHE = {"version": "n/a",
                     "auth": False,
                     "staessid": "your_wifi_name",
@@ -64,17 +71,23 @@ class Data:
                     "boostmd": True,
                     "guimeta": "...",       # special "offloaded" key indicator
                     "cstmpmap": "n/a",
-                    "telegram": "n/a",      # telegram bot token
                     "espnow": False}
 
     @staticmethod
     def init():
+        # Migrate config from / to /config
+        if is_file(Data.CONFIG_NAME):
+            console_write(f"[CONF] Migrate {Data.CONFIG_NAME} to {Data.CONFIG_PATH}")
+            move_file(Data.CONFIG_NAME, Data.CONFIG_PATH)
         # Inject user config into template
         Data.__inject_default_conf()
         # [!!!] Init selected pinmap - default pinmap calculated by platform
-        if set_pinmap is not None:
-            pinmap = set_pinmap(Data.CONFIG_CACHE['cstmpmap'])
-            console_write(f"[PIN MAP] {pinmap}")
+        if callable(set_pinmap):
+            try:
+                pinmap = set_pinmap(Data.CONFIG_CACHE['cstmpmap'])
+                console_write(f"[PIN MAP] {pinmap}")
+            except Exception as e:
+                console_write(f"\n[PIN MAP] !!! SETUP ERROR !!!: {e}\n")
         # SET dbg based on config settings (inject user conf)
         DebugCfg.DEBUG = Data.CONFIG_CACHE['dbg']
         if DebugCfg.DEBUG:
@@ -91,12 +104,12 @@ class Data:
         liveconf = Data.read_cfg_file(nosafe=True)
         # Remove obsolete keys from conf
         try:
-            remove('cleanup.pds')       # Try to remove cleanup.pds (cleanup indicator by micrOSloader)
+            remove('.cleanup')       # Try to remove .cleanup (cleanup indicator by micrOSloader)
             console_write("[CONF] Purge obsolete keys")
             for key in (key for key in liveconf if key not in Data.CONFIG_CACHE):
                 liveconf.pop(key, None)
         except Exception:
-            console_write("[CONF] SKIP obsolete keys check (no cleanup.pds)")
+            console_write("[CONF] SKIP obsolete keys check (no .cleanup)")
         # Merge template to live conf (store active conf in Data.CONFIG_CACHE)
         Data.CONFIG_CACHE.update(liveconf)
         console_write("[CONF] User config injection done")
@@ -105,7 +118,7 @@ class Data:
             Data.write_cfg_file()
             console_write("[CONF] Save conf successful")
         except Exception as e:
-            errlog_add(f"[ERR] Save (__inject) conf failed: {e}")
+            syslog(f"[ERR] Save (__inject) conf failed: {e}")
         finally:
             del liveconf
 
@@ -123,7 +136,7 @@ class Data:
                 if nosafe:
                     break
                 sleep(0.2)
-                errlog_add(f'[ERR] read_cfg_file error: {e}')
+                syslog(f'[ERR] read_cfg_file error: {e}')
         # Return config cache
         return conf
 
@@ -136,7 +149,7 @@ class Data:
                     dump(Data.CONFIG_CACHE, f)
                 break
             except Exception as e:
-                errlog_add(f'[ERR] write_cfg_file {Data.CONFIG_PATH} (json): {e}')
+                syslog(f'[ERR] write_cfg_file {Data.CONFIG_PATH} (json): {e}')
             sleep(0.2)
         return True
 
@@ -145,20 +158,16 @@ class Data:
         value_in_cfg = Data.CONFIG_CACHE[key]
         try:
             if isinstance(value_in_cfg, bool):
-                del value_in_cfg
                 if str(value).lower() == 'true':
                     return True
                 if str(value).lower() == 'false':
                     return False
                 raise Exception("type_handler type handling error")
             if isinstance(value_in_cfg, str):
-                del value_in_cfg
                 return str(value)
             if isinstance(value_in_cfg, int):
-                del value_in_cfg
                 return int(value)
             if isinstance(value_in_cfg, float):
-                del value_in_cfg
                 return float(value)
         except Exception as e:
             console_write(f"Input value type error! {e}")
@@ -171,16 +180,17 @@ class Data:
         These kind of parameters are not cached in memory
         """
         # Write str value to file
+        offloaded_key = path_join(OSPath.CONFIG, f'.{key}.key')
         if isinstance(value, str) and key in Data.CONFIG_CACHE:
             try:
-                with open(f'.{key}.key', 'w') as f:
+                with open(offloaded_key, 'w') as f:
                     f.write(value)
                 return True
             except Exception:
                 return False
         # Read str value from file
         try:
-            with open(f'.{key}.key', 'r') as f:
+            with open(offloaded_key, 'r') as f:
                 return f.read().strip()
         except Exception:
             # Return default value if key not exists
@@ -217,7 +227,7 @@ def cfgget(key=None):
             return Data.disk_keys(key)
         return val
     except Exception as e:
-        errlog_add(f'[ERR] cfgget {key} error: {e}')
+        syslog(f'[ERR] cfgget {key} error: {e}')
     return None
 
 def cfgput(key, value, type_check=False):
@@ -242,7 +252,7 @@ def cfgput(key, value, type_check=False):
         del value
         return True
     except Exception as e:
-        errlog_add(f'[ERR] cfgput {key} error: {e}')
+        syslog(f'[ERR] cfgput {key} error: {e}')
         return False
 
 #################################################################

micrOS/source/Debug.py

@@ -1,12 +1,18 @@
+"""
+micrOS Console and Log write interface implementations.
+- with progress led feature, simple and custom
+    Designed by Marcell Ban aka BxNxM
+"""
+
 from machine import Pin
 try:
-    from Logger import syslog
+    from Logger import syslog as logger_syslog
 except:
-    syslog = None
+    logger_syslog = None
 try:
-    from microIO import resolve_pin, pinmap_search, detect_platform
+    from microIO import resolve_pin, pinmap_search, register_pin
 except:
-    detect_platform = None
+    pinmap_search = None
 
 
 #############################################
@@ -17,110 +23,60 @@ except:
 class DebugCfg:
     DEBUG = True        # DEBUG PRINT ON/OFF - SET FROM ConfigHandler
     PLED_STEP = None    # PROGRESS LED OBJECT - init in init_pled
-    NEO_WHEEL = None    # NEOPIXEL (ws2812/esp32s3) color wheel object
-    COLOR_INDEX = 0     # APA102 TinyPico color wheel counter
 
     @staticmethod
     def init_pled():
         # CALL FROM ConfigHandler
-        if detect_platform is None:
+        if pinmap_search is None:
             # Check LogicalPins module loadable (robustness...)
             return
-        micro_platform = detect_platform()
-        if micro_platform == "tinypico":
-            # Progress led for TinyPico
-            DebugCfg._init_apa102()
-            return
         pled = pinmap_search('builtin')['builtin']
-        if pled is not None:
-            if isinstance(pled, int):
-                # SET PROGRESS LED WITH BUILT-IN step FUNCTION
-                if micro_platform == "esp32s3":
-                    # Progress led for esp32s3
-                    DebugCfg._init_ws2812()
-                else:
-                    # Progress led for esp32/etc
-                    DebugCfg._init_simple()
-            else:
-                # OVERRIDE PROGRESS LED WITH CUSTOM step FUNCTION
-                DebugCfg.PLED_STEP = pled
+        if pled is None:
+            # No available builtin pin, skip pled init...
+            return
+        # CONFIGURE PROGRESS LED
+        if isinstance(pled, int):
+            # [MODE] Simple flashing progress LED
+            try:
+                # Progress led for esp32/etc
+                led_obj = Pin(abs(resolve_pin('builtin')), Pin.OUT)
+                if resolve_pin('builtin') < 0:
+                    # Pin number start with (-), like -8 (means inverted output)
+                    led_obj.value(1)            # Turn OFF built-in LED state invert (1:OFF)
+                # Set function callback for step function (simple led - blink)
+                DebugCfg.PLED_STEP = lambda: led_obj.value(not led_obj.value())  # # double-blink: return None
+            except Exception as e:
+                syslog(f"[PLED] led error: {e}")
+        elif callable(pled):
+            # [MODE] OVERRIDE PROGRESS LED WITH CUSTOM step FUNCTION
+            DebugCfg.PLED_STEP = pled
+            DebugCfg._auto_register_pin()
+        else:
+            syslog(f"[WARN] pled type not supported: {pled}")
 
-    @staticmethod
-    def step():
-        """
-        DEBUG LED FEEDBACK
-        - handle 3 types of builtin LEDs: analog, neopixel(ws2812), apa102
-        - automatic selection based on board type + builtin logical pin number
-        """
-        try:
-            if callable(DebugCfg.PLED_STEP):
-                return DebugCfg.PLED_STEP()         # Run step function (return None: double-blink OR True: no d-b)
-        except Exception as e:
-            errlog_add(f"[PLED] step error: {e}")
-        return True
 
     @staticmethod
-    def _init_simple():
+    def _auto_register_pin():
         try:
-            # Progress led for esp32/etc
-            led_obj = Pin(abs(resolve_pin('builtin')), Pin.OUT)
-            if resolve_pin('builtin') < 0:     # Pin number start with (-), like -8 (means inverted output)
-                led_obj.value(1)                # Turn OFF built-in LED state invert (1:OFF)
-            # Set function callback for step function (simple led - blink)
-            DebugCfg.PLED_STEP = lambda: led_obj.value(not led_obj.value())     # # double-blink: return None
+            pin = DebugCfg.PLED_STEP(pin=True)
+            if isinstance(pin, int):
+                register_pin('builtin', pin)
         except Exception as e:
-            errlog_add(f"[PLED] led error: {e}")
+            syslog(f"[ERR] pled pin registration: {e}", console=False)
 
-    @staticmethod
-    def _init_apa102():
-        try:
-            from machine import SoftSPI
-            from dotstar import DotStar
-            from tinypico import DOTSTAR_CLK, DOTSTAR_DATA, SPI_MISO, set_dotstar_power, dotstar_color_wheel
-            spi = SoftSPI(sck=Pin(DOTSTAR_CLK), mosi=Pin(DOTSTAR_DATA), miso=Pin(SPI_MISO))
-            # Create a DotStar instance
-            dotstar = DotStar(spi, 1, brightness=0.4)  # Just one DotStar, half brightness
-            # Turn on the power to the DotStar
-            set_dotstar_power(True)
-            DebugCfg.PLED_STEP = lambda: DebugCfg._step_apa102(led_obj=dotstar, color_wheel=dotstar_color_wheel)
-        except Exception as e:
-            errlog_add(f"[PLED] apa102 error: {e}")
-
-    @staticmethod
-    def _step_apa102(led_obj, color_wheel):
-        # Get the R,G,B values of the next colour
-        r, g, b = color_wheel(DebugCfg.COLOR_INDEX*2)
-        # Set the colour on the DOTSTAR
-        led_obj[0] = (int(r * 0.6), g, b, 0.4)
-        # Increase the wheel index
-        DebugCfg.COLOR_INDEX = 0 if DebugCfg.COLOR_INDEX > 1000 else DebugCfg.COLOR_INDEX + 2
-        return True                  # No double-blink
 
     @staticmethod
-    def _init_ws2812():
+    def step():
+        """
+        DEBUG LED FLASHING FEEDBACK
+        - handle step callback function execution
+        """
         try:
-            from neopixel import NeoPixel
-            neo_pin = Pin(resolve_pin('builtin'))
-            led_obj = NeoPixel(neo_pin, 1)
-            DebugCfg.PLED_STEP = lambda: DebugCfg._step_ws2812(led_obj)
+            if callable(DebugCfg.PLED_STEP):
+                return DebugCfg.PLED_STEP()         # Run step function (return None: double-blink OR True: no d-b)
         except Exception as e:
-            errlog_add(f"[PLED] ws2812 error: {e}")
-
-    @staticmethod
-    def _step_ws2812(led_obj):
-        def _color_wheel():
-            while True:
-                yield 10, 0, 0
-                yield 5, 5, 0
-                yield 0, 10, 0
-                yield 0, 5, 5
-                yield 0, 0, 10
-                yield 5, 0, 5
-        if DebugCfg.NEO_WHEEL is None:
-            DebugCfg.NEO_WHEEL = _color_wheel()
-        led_obj[0] = next(DebugCfg.NEO_WHEEL)
-        led_obj.write()
-        return True                     # No double-blink
+            syslog(f"[PLED] step error: {e}")
+        return True
 
 
 def console_write(msg):
@@ -131,10 +87,10 @@ def console_write(msg):
             if analog is None:
                 DebugCfg.step()             # Double-blink
         except Exception as e:
-            errlog_add(f"[ERR] console_write: {e}", console=False)
+            syslog(f"[ERR] console_write: {e}", console=False)
 
 
-def errlog_add(data, console=True):
+def syslog(data, console=True):
     """
     :param data: msg string / data
     :param console: activate console_write (default: True)
@@ -142,4 +98,4 @@ def errlog_add(data, console=True):
     """
     if console:
         console_write(data)
-    return False if syslog is None else syslog(data)
+    return False if logger_syslog is None else logger_syslog(data)