micrOSDevToolKit 2.9.10__py3-none-any.whl → 2.9.11__py3-none-any.whl

micrOS/release_info/micrOS_ReleaseInfo/system_analysis_sum.json

@@ -319,7 +319,7 @@
             23
         ],
         "load": [
-            9061,
+            9087,
             55
         ],
         "core_dep": [

micrOS/source/LM_espnow.py

@@ -1,23 +1,49 @@
 import Espnow
 
 def load():
+    """
+    Initialize ESPNOW protocal
+    """
     return Espnow.initialize()
 
-def send(peer, msg='ping'):
+def send(peer, msg='modules'):
+    """
+    Send message to peer (by mac address)
+    :param peer: mac address of espnow device
+    :param msg: message string/load module call
+    """
     return Espnow.espnow_send(peer, msg)
 
 def start_server():
+    """
+    Start ESPNOW server/listener
+    - this can receive espnow messages
+    - it includes Load Module execution logic (beta)
+    """
     return Espnow.espnow_server()
 
 def stats():
+    """
+    Get ESPNOW stats
+    """
     return Espnow.stats()
 
 def add_peer(peer):
+    """
+    Add ESPNOW peer to known hosts
+    - It is needed before first send(...)
+    """
     now = Espnow.initialize()
     return Espnow.add_peer(now, peer)
 
 def mac_address():
+    """
+    Get ESPNOW compatible mac address
+    """
     return Espnow.mac_address()
 
 def help():
+    """
+    [beta] ESPNOW sender/receiver with LM execution
+    """
     return 'load', 'send <peer> "ping"', 'start_server', 'add_peer <peer>', 'stats', 'mac_address'

{micrOSDevToolKit-2.9.10.dist-info → micrOSDevToolKit-2.9.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: micrOSDevToolKit
-Version: 2.9.10
+Version: 2.9.11
 Summary: Development and deployment environment for micrOS, the diy micropython automation OS (IoT)
 Home-page: https://github.com/BxNxM/micrOS
 Author: Marcell Ban
@@ -126,14 +126,6 @@ Link for python 3.9+ [download](https://www.python.org/downloads/release/python-
 > Note: **Allow extend system path** with that python version (installation parameter) </br>
 > On **Windows**: RUN AS ADMINISTARTOR
 
-### 1.2 Install git
-
-Link for git [download](https://git-scm.com/downloads)
-
-> Git is a distributed version control system that helps developers track changes, collaborate on code, and manage project history efficiently.
-
-It is needed to be able to download webrepl client (automatic), that is used for OverTheAir file transfers and other features.
-
 ----------------------------------------
 
 ### 2. Install micrOS devToolKit GUI
@@ -495,29 +487,71 @@ Official [DockerHub](https://hub.docker.com/repository/docker/bxnxm/micros-gatew
 
 ## FUTURE RELEASE PLANS
 
-Version **3.0.0-0**
+Version **3.0.0-0** `micrOS-Autonomous`
 
 ```
     Core:
-    - Async SSL/TLS integration (micropython 1.22+ required)
-        - urequest module async redesign for rest clients
-            - LM_telegram (Notify) + server (listener - chatbot)
-            - Time (ntp location + sunset/sunrise api)
-    - ESP-NOW (peer-to-peer communication) integration into InterCon
-    - ??? New intercon syntax ???:
+    - (1) Async SSL/TLS integration (micropython 1.22+ required)                [DONE]
+        - urequest module async redesign for rest clients                       [OK]
+            - LM_telegram (Notify) + server (listener - chatbot)                [OK]
+    - (2) ESP-NOW (peer-to-peer communication) integration into InterCon        [PoC][TODO]
+    - (3) New intercon syntax - command level integration:                      [TODO]
     	- rgb toggle >>RingLight.local
     	- similar as: intercon sendcmd host="RingLight.local" cmd="rgb toggle"
+    - (4) Create multi level project structure (curret is flat fs)               [TODO] FS
+		- New micrOS FS structure:
+			- Note:
+				- On device (boot) micrOS Hooks.py/os_dir_fs_hook (check+correct)  [Phase1-FS:TODO]
+				- DevToolKit USB & OTA feature adaptation                          [Phase2-FS:TODO]
+					- os_dir_fs_handler (usb+webrepl) features
+
+			- root fs (stays untouched (approx.: 24)): /
+				- micrOS.py (core)
+				- Config.py (core)
+				- Tasks.py (core)
+				- Shell.py (core)
+				- Web.py (core)
+				- Server.py (core)
+				- node_config,json (core config)
+				- etc... (core)
+
+			- module folder - mip complient: /lib
+				- LM_* (approx.: 54)
+				- IO_* (approx.: 5)
+				- *.py/.mpy (driver)
+				- Dynamic/Runtime (approx.: 0-8):
+					- *.pds (LM app cache - persistent data storage)
+					- *.dat (Common datalogger output)
+
+			- web folder: /web
+				- *.html
+				- *.js
+				- *.css
+
+		- (5) Proper mip installer support (/lib)                                [TODO]
+			- Note: Autonomous package management over wifi (github) 
+				- pacman download
+				- pacman ls
+				- pacman dirtree
+				- pacman ...
 ```
 
-Version **3.1.0-0**
+Version **3.1.0-0** `micrOS-SecurePower`
 
 ```
     Core:
     - Async socket servers with SSL/TLS integration (with auth.)
         - WebCli (https?), ShellCli (ssocket/sterminal) and InterCon
+    - Low power mode with ESPNOW + (AP mode?)
+    	- Remote controller / Sensor UseCase
+    	- --- client mode (fyi: normally micrOS operates in server mode) 
+    - Intercon-Wire (?)
+    	- Idea of wired message communication protocol same as Intercon-Shell/Intercon-espnow
+    	- Possible HW protocols: i2c / onewire / uart BUT it should support bidirectional message transfers
+    	- Goal: CoProcessor easy integration feature - Arduino env support 
 ```
 
-Version **4.0.0-0**
+Version **4.0.0-0** `micrOS-???`
 
 ```
     Core:
@@ -525,6 +559,7 @@ Version **4.0.0-0**
         - Network
             - wifi (defualt, current interfaces)
             - Study of BLE (Shell)
+            - Com. (wifi/now/ble...lora?/etc?.) as plugin architecture (?)
     - Low power mode (with BLE) and soft-sleep / deep-sleep
 ```
 

{micrOSDevToolKit-2.9.10.dist-info → micrOSDevToolKit-2.9.11.dist-info}/RECORD

@@ -32,7 +32,7 @@ micrOS/micropython/esp32s3_spiram_oct-20231005-v1.21.0.bin,sha256=S-sv_QeL_Tylg1
 micrOS/micropython/esp32s3_spiram_oct-20241129-v1.24.1.bin,sha256=VbOF_F0YeqttkQd2ePTW66Jd34RU8u9ccFfcv8kxO_U,1662672
 micrOS/micropython/rpi-pico-w-20241129-v1.24.1.uf2,sha256=v4aYIbWaE94_f6DDzBWS-a9L1BzlcdkZwld9R7bOVA4,1727488
 micrOS/micropython/tinypico-20241129-v1.24.1.bin,sha256=Kf3cr766a5SK99CZy8bwdWjwvAZxls3tBYvaHBsw7ac,1527200
-micrOS/release_info/micrOS_ReleaseInfo/system_analysis_sum.json,sha256=8-NZSImslog5jRt31IYIPyCUzYyomKWmp2NI_sEILsE,5759
+micrOS/release_info/micrOS_ReleaseInfo/system_analysis_sum.json,sha256=hUcG245oSHjZoAqx0yjbKXGGUHWNa7p0kcyDvMwxEKo,5759
 micrOS/source/.DS_Store,sha256=1lFlJ5EFymdzGAUAaI30vcaaLHt3F1LwpG7xILf9jsM,6148
 micrOS/source/Common.py,sha256=PAdtseGY6QxUM-5elOAcApUv8AwGQ_smsYex0FeV5w8,7937
 micrOS/source/Config.py,sha256=E3OTMRI1_T94GMADcvG7MKiuGsKsnbLn17KXHcjhqXM,8795
@@ -67,7 +67,7 @@ micrOS/source/LM_dimmer.py,sha256=Jhpeh0Kq7Dnt9nA8PVobENbsf1x-U7rOv9EGGdhC_30,83
 micrOS/source/LM_distance.py,sha256=iVqQchaUOvK8Ilzr7qMi-ESvS_U8RsBwdqNHY_4qZ-c,4394
 micrOS/source/LM_ds18.py,sha256=mLaH97j8d4lUXcjS8hNtwU8hL5Ybt-Q1WuoiWPnk5Ho,1807
 micrOS/source/LM_esp32.py,sha256=yUIMWsfimCAhgyV4pT4sh-kqE_mDL83cmAZji_2uFpI,1738
-micrOS/source/LM_espnow.py,sha256=0ihRds2Uzl5neSfVHxFP4Zdj9o66fN-NPqKe2iMYblw,475
+micrOS/source/LM_espnow.py,sha256=Tto5JGnhbqyKT0hzDlJ_G-o_34dVf0CIaiMPbP-xbHU,1070
 micrOS/source/LM_gameOfLife.py,sha256=Mvr_S5zsJ6x_pMCGrkdgl5QdejNQjAF9mBYLN5-OA38,7685
 micrOS/source/LM_genIO.py,sha256=rTiFByly8ImjHBgc2RceGczGp1rzti7Juz_Vvg5hrtc,5013
 micrOS/source/LM_haptic.py,sha256=W0WiuOCxIu9RB-pWu8r8fvHmvuseet1UI7RSc9WO8zo,2862
@@ -130,9 +130,9 @@ micrOS/source/uwidgets_pro.js,sha256=gbkk3SVttEVvDCwde-pJhAh4k7GuCFPdcWNq32pcKPE
 micrOS/source/__pycache__/Common.cpython-312.pyc,sha256=qugnjE4Q1mMrR3VJaMhq71hsOoWLuft2lwv4O8Bo6ts,10366
 micrOS/source/__pycache__/Logger.cpython-312.pyc,sha256=CCdkMRG0lBy7nVsc4DHwdRK0Ap0Mu9yB5fa_Hxx-RHY,5075
 micrOS/source/__pycache__/Server.cpython-312.pyc,sha256=xy1ImeXPtGhtYlAWpuWaxLmJO2nLVGdefOuqltABR9k,20615
-micrOSDevToolKit-2.9.10.data/scripts/devToolKit.py,sha256=4GutIOErF1ny0HSNWQZzEneZdUWhSdqKPBjpRFTr5do,11192
+micrOSDevToolKit-2.9.11.data/scripts/devToolKit.py,sha256=4GutIOErF1ny0HSNWQZzEneZdUWhSdqKPBjpRFTr5do,11192
 toolkit/DevEnvCompile.py,sha256=H19-60ZpHzP30C-wqR5QTzMDHHpWrTk0Uzh--TZHxvw,12148
-toolkit/DevEnvOTA.py,sha256=OkEtO5cpym-kEgGpE3TQbyZ-nQOzZpGzbFdbgCibe7I,25356
+toolkit/DevEnvOTA.py,sha256=vNa827MOhbNQbeMGGu72YmGlNN_Tm9D6Trdnz3YGpyU,25499
 toolkit/DevEnvUSB.py,sha256=G-Ram-OR27flvVhul8J_ObiMY07Wjvom6Prc4dTfkmo,34108
 toolkit/Gateway.py,sha256=OSsJYeAmFhNnb1uu2bjLvZzE3A32O7lza8-NxlGr1DQ,25335
 toolkit/LM_to_compile.dat,sha256=TmcSZcPNVtJKWdyMxY1YtHPnqbD6zcI7B7FISbr6as4,579
@@ -168,6 +168,7 @@ toolkit/dashboard_apps/_micPlotting.py,sha256=zYXhyYKyyA_13ZQybccO4a6t8uyaFJNxlh
 toolkit/dashboard_apps/_presencePlotting.py,sha256=cHWR_4YqbNLB6d4mmHjGCYb3Dg5rqWIyu2lpnz0l-Hs,3737
 toolkit/dashboard_apps/uLightDemo.py,sha256=Q8PL56coysM71qV9SCU05yTyCsAMhtzDSjVeg_CkBtc,3163
 toolkit/lib/LocalMachine.py,sha256=m5xaWRx1PumKFLQ5_O8vVxC4NTclF1h9J3__pK8N-C4,18734
+toolkit/lib/Repository.py,sha256=DVoS67rCJzHtJvPTZt-r4Gkmt28ZuC7UYdSAuczsPs0,2440
 toolkit/lib/SafeInput.py,sha256=gMXsMalPcFCwlN6niJlG2twOHfoGsEgHL9-Uh2YQJHE,855
 toolkit/lib/SearchDevices.py,sha256=1nnJDwo_U5cCN2xsdNUT6EQqdt2fW-qAWXWzyzXzyyc,5813
 toolkit/lib/SerialDriverHandler.py,sha256=Zn0zeq4mshTMVc6fzycvrOZiKt6w6YOxJcTWw3BMN2M,7344
@@ -180,6 +181,7 @@ toolkit/lib/micrOSClientHistory.py,sha256=EyCqbFeMy940bfXq4Yfu8dcvb7GnBvuHHxOAIg
 toolkit/lib/pip_package_installer.py,sha256=jpC-y1KR72_PJlqyUR6-U5b6l1szVqnIZ4nrSgUsOTM,4262
 toolkit/simulator_lib/.DS_Store,sha256=1lFlJ5EFymdzGAUAaI30vcaaLHt3F1LwpG7xILf9jsM,6148
 toolkit/simulator_lib/IO_darwin.py,sha256=f8HOfQKJvniShvjpBe6f4nisr6oJd9SnvxPsbdNIGQk,2336
+toolkit/simulator_lib/aioespnow.py,sha256=NPAX85zLCb6ZJVW8n18tULV4NbHK1IzHYMR43QXAxUQ,480
 toolkit/simulator_lib/camera.py,sha256=BIyj6dF_PoszzTZ3Ea_-gsJ3aly_xGy5NMKeJGVSbFI,1485
 toolkit/simulator_lib/dht.py,sha256=WB56YlZJYop4a2wnFWyWSI9FsPC_zH885a-A4rDNGKo,278
 toolkit/simulator_lib/dotstar.py,sha256=Le6RvSAz3byjiF2RX4JWB8LVsNQtfMqPfM47fg-YFzs,95
@@ -207,6 +209,7 @@ toolkit/simulator_lib/view01.jpg,sha256=YI_faDB9yyFLzJKTCu1nW4XXxyvGPLfgdYtzW7vm
 toolkit/simulator_lib/view02.jpg,sha256=7EWtt8StDpLw3yDMG1nD8XjJgsC0ixpAq3SwPCb842k,35580
 toolkit/simulator_lib/webrepl.py,sha256=owxkwtNlV9zrE2inPtoLCc8U2QgmZOhxpcsX3wMPbik,37
 toolkit/simulator_lib/__pycache__/IO_darwin.cpython-312.pyc,sha256=LKUIXwaw3DBrvvRhIFi93xolxnI6W7CR6WePeApVo7I,1823
+toolkit/simulator_lib/__pycache__/aioespnow.cpython-312.pyc,sha256=25jb4hcOhdbJnWJCH_Vh0Uwc6I8tvpFw3xpFznP4BQA,1555
 toolkit/simulator_lib/__pycache__/camera.cpython-312.pyc,sha256=hzK7NNmBQsIigz7Gof9FNblwVnP4Ffc3cILPLI-US6w,3152
 toolkit/simulator_lib/__pycache__/dht.cpython-312.pyc,sha256=-02X-tLNXpZIb2DhJI_-Qi1m-MmddzbQIpZUZVH9HZk,946
 toolkit/simulator_lib/__pycache__/dht.cpython-39.pyc,sha256=YwCF50_3cJ9QvAaVa5Mkl0EeASSIr8gwPtREzFcCEmk,878
@@ -303,7 +306,7 @@ toolkit/workspace/precompiled/LM_dimmer.mpy,sha256=dRdDr3WfFy-um3-fRiK4IuZdwBTUD
 toolkit/workspace/precompiled/LM_distance.mpy,sha256=6VoSsyd-hQ4P16USDnSqpq5gpi0v2WbseeHnTFJxuJA,1506
 toolkit/workspace/precompiled/LM_ds18.mpy,sha256=1TYvc8hj1ypE1v52l6u83e8XqUi0_Rjwil-BnYXDSKI,644
 toolkit/workspace/precompiled/LM_esp32.py,sha256=yUIMWsfimCAhgyV4pT4sh-kqE_mDL83cmAZji_2uFpI,1738
-toolkit/workspace/precompiled/LM_espnow.py,sha256=0ihRds2Uzl5neSfVHxFP4Zdj9o66fN-NPqKe2iMYblw,475
+toolkit/workspace/precompiled/LM_espnow.py,sha256=Tto5JGnhbqyKT0hzDlJ_G-o_34dVf0CIaiMPbP-xbHU,1070
 toolkit/workspace/precompiled/LM_gameOfLife.mpy,sha256=mAOivt472fRGOcpgx6xShyfbrpT0GTbLhT2vujncS4w,2051
 toolkit/workspace/precompiled/LM_genIO.mpy,sha256=F9utR5Ng-QuTq5R5ISvYPO8xASEdSnndc1hFfxcNWOE,1722
 toolkit/workspace/precompiled/LM_haptic.mpy,sha256=46BgYkjC3AdNaJaKflFnY0oEUsd9qg6yGquX7jyFLnM,1276
@@ -364,8 +367,8 @@ toolkit/workspace/precompiled/urequests.mpy,sha256=-JDY-DOtJrGdwQo0-P809zZu-cJBR
 toolkit/workspace/precompiled/ustyle.css,sha256=P-s8ENwAcWoZi5bocrK3_kVzEjaRFKtFvEF6JRh4MBY,1429
 toolkit/workspace/precompiled/uwidgets.js,sha256=BGeUSbNHn6PClgIgIE6QszwQVJ6j7lzgCBwvIX8cYgo,6631
 toolkit/workspace/precompiled/uwidgets_pro.js,sha256=gbkk3SVttEVvDCwde-pJhAh4k7GuCFPdcWNq32pcKPE,3639
-micrOSDevToolKit-2.9.10.dist-info/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
-micrOSDevToolKit-2.9.10.dist-info/METADATA,sha256=YVrj02zAhSoulyDir7LmXfcWVUWoAIUhzxc1nN6aBsQ,53805
-micrOSDevToolKit-2.9.10.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-micrOSDevToolKit-2.9.10.dist-info/top_level.txt,sha256=rOGOIXqLBdGZAoDTiLdZ9B_leFB7bMv7YabLwuIc2bc,25
-micrOSDevToolKit-2.9.10.dist-info/RECORD,,
+micrOSDevToolKit-2.9.11.dist-info/LICENSE,sha256=hIahDEOTzuHCU5J2nd07LWwkLW7Hko4UFO__ffsvB-8,34523
+micrOSDevToolKit-2.9.11.dist-info/METADATA,sha256=BqgNJ6O6FQZJclGKfkWwg2h04G8pL1_n1zVdaSVRsVY,55250
+micrOSDevToolKit-2.9.11.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+micrOSDevToolKit-2.9.11.dist-info/top_level.txt,sha256=rOGOIXqLBdGZAoDTiLdZ9B_leFB7bMv7YabLwuIc2bc,25
+micrOSDevToolKit-2.9.11.dist-info/RECORD,,

toolkit/DevEnvOTA.py

@@ -12,6 +12,7 @@ try:
     from .lib.TerminalColors import Colors
     from .lib.SafeInput import input_with_timeout
     from .lib.file_extensions import check_all_extensions
+    from .lib.Repository import git_clone_archive, git_clone
 except Exception as e:
     print("Import warning __name__:{}: {}".format(__name__, e))
     from DevEnvCompile import Compile
@@ -19,8 +20,10 @@ except Exception as e:
     from lib.TerminalColors import Colors
     from lib.SafeInput import input_with_timeout
     from lib.file_extensions import check_all_extensions
-    sys.path.append(MYPATH)
-    import socketClient
+    from lib.Repository import git_clone_archive, git_clone
+
+sys.path.append(MYPATH)
+import socketClient
 
 
 #################################################
@@ -52,15 +55,17 @@ class OTA(Compile):
             # Change workdir
             workdir_handler = LocalMachine.SimplePopPushd()
             workdir_handler.pushd(os.path.dirname(os.path.dirname(webrepl_path)))
+            webrepl_url = 'https://github.com/micropython/webrepl.git'
 
-            command = 'git clone {url} {name}'.format(
-                name='webrepl',
-                url='https://github.com/micropython/webrepl.git')
-            self.console("Clone webrepl repo: {}".format(command))
+            self.console(f"Clone webrepl repo: {webrepl_url}")
             if self.dry_run:
-                exitcode, stdout, stderr = 0, 'dry-run', ''
+                exitcode, stdout, stderr = 0, "", ""
             else:
-                exitcode, stdout, stderr = LocalMachine.CommandHandler.run_command(command, shell=True)
+                # Git clone with command line tool
+                exitcode, stdout, stderr = git_clone(url=webrepl_url)
+                if exitcode != 0:
+                    # Git clone archive - without git
+                    exitcode, stdout, stderr = git_clone_archive(url=webrepl_url)
 
             # Restore workdir
             workdir_handler.popd()
@@ -156,7 +161,6 @@ class OTA(Compile):
     def update_with_webrepl(self, force=False, device=None, lm_only=False, loader_update=False, ota_password='ADmin123'):
         """
         OTA UPDATE via webrepl
-            git clone https://github.com/micropython/webrepl.git
             info: https://techoverflow.net/2020/02/22/how-to-upload-files-to-micropython-using-webrepl-using-webrepl_cli-py/
             ./webrepl/webrepl_cli.py -p <password> <input_file> espressif.local:<output_file>
         """

toolkit/lib/Repository.py

@@ -0,0 +1,64 @@
+import requests
+import zipfile
+import io
+import os
+
+try:
+    from .LocalMachine import CommandHandler
+except:
+    from LocalMachine import CommandHandler
+
+
+def git_clone_archive(url):
+    """
+    Clone git repo as archive (without git installed)
+    Note: No git history, it is just a snapshot
+    :param url: https://github.com/micropython/webrepl
+    """
+    print(f"CLONE ARCHIVE: {url}")
+    url = url.replace(".git", "") if url.endswith(".git") else url
+    # URL of the repository zip archive (adjust branch name if needed)
+    target_name = url.split("/")[-1].strip()
+    zip_url = f"{url}/archive/refs/heads/master.zip"
+    response = requests.get(zip_url)
+    if response.status_code == 200:
+        # Read the downloaded content as a binary stream
+        with zipfile.ZipFile(io.BytesIO(response.content)) as z:
+            for member in z.infolist():
+                # Each member's filename is something like 'webrepl-master/filename'
+                # Remove the first directory component
+                parts = member.filename.split('/', 1)
+                if len(parts) > 1:
+                    relative_path = parts[1]
+                else:
+                    relative_path = parts[0]
+
+                # Build the target path relative to the current directory
+                target_path = os.path.join(target_name, relative_path)
+
+                if member.is_dir():
+                    os.makedirs(target_path, exist_ok=True)
+                else:
+                    os.makedirs(os.path.dirname(target_path), exist_ok=True)
+                    with z.open(member) as source, open(target_path, 'wb') as target_file:
+                        target_file.write(source.read())
+        print(f"\tRepository extracted successfully: {target_name}")
+        return 0, zip_url, ""
+    print(f"\tFailed to download repository archive: {target_name}")
+    return 1, zip_url, ""
+
+
+def git_clone(url):
+    """
+    Git clone - subshell call
+    - git is needed to be preinstalled
+    """
+    print(f"GIT CLONE: {url}")
+    target_name = url.split("/")[-1].strip().replace(".git", "")
+    command = 'git clone {url} {name}'.format(name=target_name, url=url)
+    exitcode, stdout, stderr = CommandHandler.run_command(command, shell=True)
+    if exitcode == 0:
+        print(f"\tRepository was cloned successfully: {target_name}")
+    else:
+        print(f"\tRepository clone failed: {target_name}")
+    return exitcode, stdout, stderr

toolkit/simulator_lib/aioespnow.py

@@ -0,0 +1,28 @@
+
+
+class AIOESPNow:
+
+    def __init__(self):
+        self._active = False
+        self.peers_table = None
+
+    def active(self, state=None):
+        if state is not None:
+            self._active = state
+        return self._active
+
+    def stats(self):
+        pass
+
+    def add_peer(self, mac):
+        pass
+
+    async def asend(self, mac, full_msg):
+        pass
+
+    def send(self, mac, full_msg):
+        pass
+
+    def __iter__(self):
+        return (i for i in range(0, 3))
+

toolkit/workspace/precompiled/LM_espnow.py

@@ -1,23 +1,49 @@
 import Espnow
 
 def load():
+    """
+    Initialize ESPNOW protocal
+    """
     return Espnow.initialize()
 
-def send(peer, msg='ping'):
+def send(peer, msg='modules'):
+    """
+    Send message to peer (by mac address)
+    :param peer: mac address of espnow device
+    :param msg: message string/load module call
+    """
     return Espnow.espnow_send(peer, msg)
 
 def start_server():
+    """
+    Start ESPNOW server/listener
+    - this can receive espnow messages
+    - it includes Load Module execution logic (beta)
+    """
     return Espnow.espnow_server()
 
 def stats():
+    """
+    Get ESPNOW stats
+    """
     return Espnow.stats()
 
 def add_peer(peer):
+    """
+    Add ESPNOW peer to known hosts
+    - It is needed before first send(...)
+    """
     now = Espnow.initialize()
     return Espnow.add_peer(now, peer)
 
 def mac_address():
+    """
+    Get ESPNOW compatible mac address
+    """
     return Espnow.mac_address()
 
 def help():
+    """
+    [beta] ESPNOW sender/receiver with LM execution
+    """
     return 'load', 'send <peer> "ping"', 'start_server', 'add_peer <peer>', 'stats', 'mac_address'