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

{micrOSDevToolKit-2.9.1.dist-info → microsdevtoolkit-2.26.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: micrOSDevToolKit
-Version: 2.9.1
+Version: 2.26.1
 Summary: Development and deployment environment for micrOS, the diy micropython automation OS (IoT)
 Home-page: https://github.com/BxNxM/micrOS
 Author: Marcell Ban
@@ -19,18 +19,54 @@ Requires-Dist: pylint
 Requires-Dist: pyserial
 Requires-Dist: resources
 Requires-Dist: flask
-Requires-Dist: flask-restful
+Requires-Dist: flask_restful
 Requires-Dist: numpy
 Requires-Dist: json2html
 Requires-Dist: requests
 Requires-Dist: Flask-BasicAuth
 Requires-Dist: soundfile
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: summary
 
 # ![LOGO](./media/logo_mini.png?raw=true) micrOS
 
 > **"The mini yet powerful operating system for DIY projects."**
 
-![telnet](https://img.shields.io/badge/wifi-telnet-blue) ![esp32S2](https://img.shields.io/badge/esp32-S2-olive) ![tinypico](https://img.shields.io/badge/esp32-tinypico-olive) ![esp32S3](https://img.shields.io/badge/esp32-S3-olive) ![esp32S3](https://img.shields.io/badge/esp32-S3_RAM-olive) ![PYQT](https://img.shields.io/badge/esp32-PYQT-olive) ![raspberry-pico-w](https://img.shields.io/badge/raspberry-pico_W-critical) ![espCAM-esp-s](https://img.shields.io/badge/esp32-CAM_OV2640-olive) ![esp32-c3](https://img.shields.io/badge/esp32-C3_RISCV-olive) ![OTA](https://img.shields.io/badge/ota-update-blue) ![GPIO](https://img.shields.io/badge/gpio-i2c-success) ![clock](https://img.shields.io/badge/rtc-ntp-success) ![async](https://img.shields.io/badge/async-task_manager-success) ![irq](https://img.shields.io/badge/hardware-IRQs-success) ![socket](https://img.shields.io/badge/socket-STA_or_AP-blue) ![cron](https://img.shields.io/badge/scheduling-cron-success) ![stable](https://img.shields.io/badge/stabile-master_HEAD-success) ![stable](https://img.shields.io/badge/micropython-OS-gold)<br/>
+![stable](https://img.shields.io/badge/master-HEAD-success)
+![stable](https://img.shields.io/badge/micropython-OS-gold)
+![async](https://img.shields.io/badge/async-task_manager-olive)
+![config](https://img.shields.io/badge/config-manager-olive)
+![cron](https://img.shields.io/badge/IRQs-Cron-olive)
+![events](https://img.shields.io/badge/IRQs-Events-olive)
+![web](https://img.shields.io/badge/Web-Rest-olive)
+![web](https://img.shields.io/badge/Web-UI-olive)
+![socket](https://img.shields.io/badge/Socket-Shell-olive)
+![GPIO](https://img.shields.io/badge/GPIO-I2C-olive)
+![clock](https://img.shields.io/badge/RTC-NTP-olive)
+![wifi](https://img.shields.io/badge/Wifi-STA_or_AP-blue)
+![OTA](https://img.shields.io/badge/OTA-Update-blue)
+![ic1](https://img.shields.io/badge/InterCon-socket-blue)
+![ic2](https://img.shields.io/badge/InterCon-espnow-blue)
+<br/>
+![tinypico](https://img.shields.io/badge/esp32-tinypico-purple)
+![esp32S3](https://img.shields.io/badge/esp32-S3-purple)
+![esp32S3](https://img.shields.io/badge/esp32-S3_RAM-purple)
+![espCAM-esp-s](https://img.shields.io/badge/esp32-CAM_OV2640-purple)
+![esp32-c6](https://img.shields.io/badge/esp32-C6_RISCV-purple)
+![esp32-c3](https://img.shields.io/badge/esp32-C3_RISCV-purple)
+![esp32S2](https://img.shields.io/badge/esp32-S2-purple)
+![PYQT](https://img.shields.io/badge/esp32-PYQT-purple)
+![raspberry-pico-w](https://img.shields.io/badge/raspberry-pico_W-critical)
+![esp32-etc](https://img.shields.io/badge/esp32-etc.-purple)
+<br/>
 
 
 Thanks for ![GitHub stars](https://img.shields.io/github/stars/BxNxM/micrOS), follow us on:
@@ -57,8 +93,8 @@ Access rest api over browser: `http://<nodename>.local`
 ----------------------------------------
 ----------------------------------------
 
-📲 💻 ShellCli: Generic session-based communication API <br/>
-📲 WebCli: Apple shortcuts compatible **REST API** and **http homepage** <br/>
+📲 💻 ShellCli: Generic session-based communication API (OAM Interface) <br/>
+📲 WebCli: Apple shortcuts compatible **REST API** and **HTTP Homepage** <br/>
 &nbsp;&nbsp; ✉️ Expose upython module functions - telnet **TCP/IP** and **REST API** <br/>
 ⚙️ 📝 Device initialization from user config <br/>
 🧩  Codeless end user experience via phone client <br/>
@@ -74,15 +110,17 @@ Access rest api over browser: `http://<nodename>.local`
 🚀🎈Lightweight and high performance core system that leaves you space 😎
 
 ## ◉ Shortcuts:
-1. micrOS Client Application [link](https://github.com/BxNxM/micrOS/#micros-client-application)
+1. 📲 micrOS Client Application [link](https://github.com/BxNxM/micrOS/#micros-client-application)
 2. micrOS Installer [link](https://github.com/BxNxM/micrOS/#installing-micros-with-devtoolkit-esp32-and-more)
-3. micrOS Tutorials [link](https://github.com/BxNxM/micrOS/#micros-video-tutorials)
+3. ▶️ micrOS Tutorials [link](https://github.com/BxNxM/micrOS/#micros-video-tutorials)
 4. micrOS System and features [link](https://github.com/BxNxM/micrOS/#micros-framework-features)
+5. 🎮 Built-in app modules: [link](https://htmlpreview.github.io/?https://github.com/BxNxM/micrOS/blob/master/micrOS/client/sfuncman/sfuncman.html)
 5. Pin mapping - GPIO [link](https://github.com/BxNxM/micrOS/#device-pinouts-for-wiring)
-6. micrOS Node configuration [link](https://github.com/BxNxM/micrOS/#micros-node-configuration-parameters-with-description)
-7. micrOS create custom Load Modules: [link](./APPLICATION_GUIDE.md)
-8. micrOS Gateway server with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
-9. Release notes: [link](https://github.com/BxNxM/micrOS/#relese-note)
+6. ⚙️ micrOS Node configuration [link](https://github.com/BxNxM/micrOS/#micros-node-configuration-parameters-with-description)
+7. 🧑‍💻 micrOS create custom Load Modules: [link](./APPLICATION_GUIDE.md)
+8. 📦 micrOS Package Management: [link](https://github.com/BxNxM/micrOSPackages)
+9. micrOS Gateway server with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
+10. Release notes: [release-note](https://github.com/BxNxM/micrOS/#release-note)
 
 ----------------------------------------
 ----------------------------------------
@@ -109,20 +147,18 @@ I would suggest to use micrOS GUI as a primary interface for micrOS development
 
 ## 1. Prerequisites
 
-### 1.1 Install python3.9+
+### 1.1 Install python3.12+
 
-Link for python 3.9+ [download](https://www.python.org/downloads/release/python-390/)
+Download Python 3.12+ [link](https://www.python.org/downloads/release/python-3120/)
 
 > 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)
+Check Python3 version
 
-> 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.
+```bash
+python3 --version
+```
 
 ----------------------------------------
 
@@ -237,26 +273,31 @@ It will install your board via USB with default settings. **Continue with micrOS
 ![MICROSARCHITECTURE](./media/micrOSArchitecture.png?raw=true)
 
 - 🕯**micrOS loader** - starts micrOS or WEBREPL(update / recovery modes)
-	- **OTA update** - push update over wifi (webrepl automation) / monitor update and auto restart node
+	- **OTA update** - push update over wifi (webrepl automation: monitor update and auto restart node)
 - 📄**Config handling** - user config - **node_config.json**
-    - ⏳**Boot phase** - preload Load Module(s)
-        - For pinout and last state initialization - based on node_config `boothook`
+    - ⏳**Boot phase** - preload Load Module(s) - based on node_config
+        - Parameter: `boothook` Device initialization (optional), load applications (pinout and last state initialization)
+        	- It runs **as soon as possible** in the boot sequence (before network setup) 
         - Example values: `rgb load; neopixel load`
         - Comments `#` can be used: `#rgb load; neopixel load`, excellect for experimentation.
     - 📡**Network handling** - based on node_config 
-        - STA / AP network modes, `nwmd`
-        - NTP + UTC aka clock setup
+        - Parameter: `nwmd` network modes: `STA` Station OR `AP` AccessPoint
+        - In STA mode: NTP + UTC aka clock setup
           - API: [ip-api.com](http://ip-api.com/json/?fields=lat,lon,timezone,offset)
         - Static IP configuration, `devip`
         - dhcp hostname setup, `devfid`.local
         - system `uptime` measurement
     - ⚙️**Scheduling / External events** - Interrupt callback - based on node_config 
         - Time based
-            - ⌛️simple LM task pool execution `timirq` & `timirqcbf`
-                - `Timer(0)`
+            - ⌛️simple LM task pool execution on `Timer(0)`
+                - To enable the feature set `timirq` to `True`
+                - Set period in milliseconds with `timirqseq` like: `5000`
+                - Configure callbalcks with `timirqcbf`
+                		- Example: `bme280 measure`, so this will measure with the sensor every 5 seconds.
                 - Comments `#` can be used in `timirqcbf`
-            - 🗓cron [time stump!LM task] pool execution `cron` & `crontasks`
-                - `Timer(1)` 
+            - 🗓cron [time stump!LM task] pool execution `Timer(1)`
+                - To enable this feature set `cron` to `True`
+                - Configure callbalcks with `crontasks `
                 - timestamp: `WD:H:M:S!LM FUNC`, ranges: `0-6:0-23:0-59:0-59!LM FUNC`
                     - example: `*:8:0:0!rgb rgb r=10 g=60 b=100; etc.`, it will set rgb color on analog rgb periphery at 8am every day.
                     - `WD: 0...6` 0=Monday, 6=Sunday
@@ -292,11 +333,13 @@ It will install your board via USB with default settings. **Continue with micrOS
 		- exit configuration mode:`noconf`
 	- **LM** - Load Module function execution (application modules)
 		- Example: `system info`
+		- That points to `/modules/LM_system.py` file `info()` function and calls it.
 - 🖇**microIO** pinout handling - lookuptables for each board
-	- Predefined pinout modules for esp32, tinyPico
+	- Predefined pinout modules for esp32, tinyPico, etc. (files under: `modules/IO_*.py`)
 	- Create your pinout based on `IO_esp32.py`, naming convencion: `IO_<name>.py`
 	- To activate your custom pinout set `cstmpmap` config parameter to `<name>`
 	- HINT: to get pin number you can get it by pin label, like: `system pinamp`
+	- HINT: with `cstmpmap` you can overwrite pin mapping as well, like: `neop:25` set neop virtual pin to pin 25 real pinout. 
 
 - 🔄 **Task manager** aka **Async LM jobs**
 	- Capable of execute [L]oad [M]odules in the background 
@@ -308,12 +351,30 @@ It will install your board via USB with default settings. **Continue with micrOS
 			- Delayed execution (ms): `system heartbeat &1000`, waits 1 sec before execution.
 	- Stop task: `task kill system.heartbeat`
 	- Show task live ouput: `task show system.heartbeat`
+	- List tasks with `task list`:
+	
+```
+TinyDevBoard $ task list
+---- micrOS  top ----
+#queue: 18 #load: 3%
+
+#Active   #taskID
+Yes       server
+Yes       idle
+Yes       telegram.server_bot
+Yes       espnow.server
+```
 
 
 ⌘ DevToolKit CLI feature:
 
 - Socket client python plugin - interactive - non interactive mode
 
+```bash
+./devToolKit.py --search --connect
+```
+
+
 ----------------------
 
 ### Boards and suggestions
@@ -363,14 +424,14 @@ So prefer boards with more psram 2Mb-8Mb, **minumum requirement for the full fla
 
 LogicalPin lookup tables:
 
-- [tinypico](./micrOS/source/IO_tinypico.py)
-- [esp32](./micrOS/source/IO_esp32.py)
-- [esp32s2](./micrOS/source/IO_esp32s2.py)
-- [esp32s3](./micrOS/source/IO_esp32s3.py)
-- [raspberryPicoW](./micrOS/source/IO_rp2.py) - reset needed after ota update (webrepl limitation)
+- [tinypico](micrOS/source/modules/IO_tinypico.py)
+- [esp32](micrOS/source/modules/IO_esp32.py)
+- [esp32s2](micrOS/source/modules/IO_esp32s2.py)
+- [esp32s3](micrOS/source/modules/IO_esp32s3.py)
+- [raspberryPicoW](micrOS/source/modules/IO_rp2.py) - reset needed after ota update (webrepl limitation)
 - `IO_*.py` [etc.](./micrOS/source)
 
-> Note: Good idea to use costant variable for pin map declaration, check the files for more info, These files are also precompiled automatically into byte steams -> `.mpy`
+> Note: Good idea to use costant variable for pin map declaration, check the files for more info, These files are also precompiled automatically into byte streams -> `.mpy`
 
 ![MicrOStinyPicopinout](./media/NodeMCUPinOutTinyPico.png?raw=true)
 
@@ -395,15 +456,16 @@ These parameters controlls micrOS core functionalities, so you can define an ent
 
 |      Config keys    |   Default value and type    | Reboot required |              Description                     |
 | :-----------------: | :-------------------------: | :-------------: | ----------------------------------------- |
-|   **`devfid`**      |    `node01`  `<str>`        |       Yes       | Device friendly "unique" ID - (1) defines AccessPoint (AP) network name and (2) in Station (STA) network mode the DHCP device name for IP address resolve also (3) this is the ShellCli prompt.
+|   **`devfid`**      |    `node01`  `<str>`        |       No       | Device friendly "unique" ID - (1) defines AccessPoint (AP) network name and (2) in Station (STA) network mode the DHCP device name for IP address resolve also (3) this is the ShellCli prompt.
 |   **`staessid`**    |   `your_wifi_name` `<str>`  |       Yes       | Wifi router name to connect (for STA default connection mode). You can list multiple wifi names separated with `;`
 |   **`stapwd`**      | `your_wifi_passwd` `<str>`  |       Yes       | Wifi router password (for STA default connection mode). You can list multiple wifi passwords separated with `;` connected in order to `staessid` wifi names.
 |   **`appwd`**       |   `ADmin123`  `<str>`       |       Yes       | Device system password.: Used in AP password (access point mode) + webrepl password + micrOS auth
 | **`boothook`**      |    `n/a` `<str>`            |      Yes        | Add Load Module execution(s) to the boot sequence. Separator `;`. Examples: `rgb load; cct load` but you can call any load module function here if you want to run it at boot time.
 | **`webui`**         |       `False`  `bool`       |      Yes        | Launch http rest server on port 80 (in parallel with micrOS shell on port 9008 aka `socport`). It has 2 endpoints: / aka main page (index.html) and /rest aka rest (json) interface for load module execution. Example: `<devfid>.local` or `<devfid>.local/rest` + optional parameters: `/rgb/toggle`. **Apple shortcuts compatible**
+| **`espnow`**         |     `False`  `bool`       |      Yes        | Enable **ESPNow communication protocol**. It starts `espnow.server` task, that can receive espnow messages and execute Load Module commands. It is an extension for **InterCon** feature example: `system heartbeat >>target.local`. 
 | | |
 | **`cron`**          |     `False`  `<bool>`       |       Yes       | Enable timestamp based Load Module execution aka Cron scheduler (linux terminology), Timer(1) hardware interrupt enabler.
-| **`crontasks`**     |     `n/a`  `<str>`          |       Yes       | Cron scheduler input, task format: `WD:H:M:S!module function` e.g.: `1:8:0:0!system heartbeat`, task separator in case of multiple tasks: `;`. [WD:0-6, H:0-23, M:0-59, S:0-59] in case of each use: `*`. Instead `WD:H:M:S` you can use suntime tags: `sunset`, `sunrise`, optional offset: `sunset+-<minutes>`, `sunrise+-<minutes>`, example: `sunset-30!system heartbeat`. Range of days: WD can be conrete day number or range like: 0-2 means Monday to Wednesday.
+| **`crontasks`**     |     `n/a`  `<str>`          |       No       | Cron scheduler input, task format: `WD:H:M:S!module function` e.g.: `1:8:0:0!system heartbeat`, task separator in case of multiple tasks: `;`. [WD:0-6, H:0-23, M:0-59, S:0-59] in case of each use: `*`. Instead `WD:H:M:S` you can use suntime tags: `sunset`, `sunrise`, optional offset: `sunset+-<minutes>`, `sunrise+-<minutes>`, example: `sunset-30!system heartbeat`. Range of days: WD can be conrete day number or range like: 0-2 means Monday to Wednesday.
 | | |
 | **`irq1`**          |     `False`  `<bool>`       |      Yes        | External event interrupt enabler - Triggers when desired signal state detected - button press happens / motion detection / etc.
 | **`irq1_cbf`**      |     `n/a`  `<str>`          |      Yes        | `irq1` enabled, calls the given Load Modules, e.x.: `module function optional_parameter(s)` when external trigger happens.
@@ -422,8 +484,6 @@ These parameters controlls micrOS core functionalities, so you can define an ent
 | **`timirq`**        |     `False`  `<bool>`       |       Yes       | Timer(0) interrupt enabler - background "subprocess" like execution, timer based infinite loop for the LoadModule execution.
 | **`timirqcbf`**     |      `n/a`   `<str>`        |      Yes        | if `timirq` enabled, calls the given Load Module(s), e.x.: `module function optional_parameter(s)`, task separator: `;`
 | **`timirqseq`**     |    `1000`   `<int>`         |      Yes        | Timer interrupt period in ms, default: `3000` ms (for `timirq` infinite loop timer value)
-| | |
-| **`telegram`**      |      `n/a`  `str`           |      No          | `TELEGRAM_BOT_TOKEN` to enable micrOS Notifications. **Hint**, to create bot with botfather: [click](https://blog.devgenius.io/how-to-set-up-your-telegram-bot-using-botfather-fd1896d68c02). After enabling this, send `/ping` to telegram chat for chat ID sync.
 
 ### Advanced parameter options:
 
@@ -438,7 +498,7 @@ These parameters controlls micrOS core functionalities, so you can define an ent
 | **`nwmd`**          |     `n/a`  `<str>`          |      Yes        | Prefered network mode - `AP` or `STA`, default is `STA`.
 | **`soctout`**       |   `30`      `<int>`         |      Yes        | Socket server connection timeout. If user is passive for `soctout` sec, and new connection incoming, then close passive connection. So it is time limit per connection in the `aioqueue`.
 | **`socport`**       |    `9008`  `<int>`          |      Yes        | Socket server service port (should not be changed due to client and API inconpatibility).
-| **`auth`**          |     `False` `<bool>`        |       Yes       | Enables socket password authentication, password: `appwd`. Passwordless functions: `hello`, `version`, `exit`. **WARNING** OTA upade not supported in this mode (yet).
+| **`auth`**          |     `False` `<bool>`        |       Yes       | Enables socket password authentication, password: `appwd`. Passwordless functions: `hello`, `version`, `exit`. Plus access for loaded modules. Auth protects the configuration and new module loads.
 | | |
 | **`dbg`**	         |     `True`    `<bool>`      |       Yes       | Debug mode - enable micrOS system printout, server info, etc. + progress LED.
 | **`hwuid`**         |      `n/a`  `<str>`         |      N/A        | USED BY SYSTEM (state storage) - hardware address - dev uid
@@ -483,41 +543,144 @@ Official [DockerHub](https://hub.docker.com/repository/docker/bxnxm/micros-gatew
 ----------------------------------------
 
 
-## FUTURE RELEASE PLANS
+## FUTURE MAIN 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        [DONE]
+       - Multi command same device improvement (session ID handling)            [DONE]
+    - (3) New intercon syntax - command level integration:                      [DONE]
     	- rgb toggle >>RingLight.local
-    	- similar as: intercon sendcmd host="RingLight.local" cmd="rgb toggle"
+    	- similar as (obsolete): intercon sendcmd host="RingLight.local" cmd="rgb toggle"
+    	- espnow integration into `rgb toggle >>RingLight.local` syntax (when available on target)
+    - (4) Create multi level project structure (curret is flat fs)              [DONE]
+		- New micrOS FS structure:
+			- Automatic dir creation at bootup: '/logs', '/web', '/data', '/config', '/modules'
+			- Automatic sub-dir handling /source and /precompiled
+			- Automatic dir creation over USB
+			
+			System Core File Structure:
+			- [DONE] root fs (stays untouched (approx.: 24)): /
+				- micrOS.py (core)
+				- Config.py (core)
+				- Tasks.py (core)
+				- Shell.py (core)
+				- Web.py (core)
+				- Server.py (core)
+				- etc... (core)
+			- [DONE] web folder: /web
+				- *.html
+				- *.js
+				- *.css
+				- etc.
+			- [DONE][RUNTIME] data folder: /data
+			   - Dynamic/Runtime (approx.: 0-8):
+				   - *.pds (LM app cache - persistent data storage)
+					- *.dat (Common datalogger output)
+				- Or store any application data here
+			- [DONE][RUNTIME] logs folder: /logs
+				- *.log
+				- *.sys.log
+			- [DONE] config folder /config
+             - node_config.json (core config)
+             - *.key files (offloaded core config values, like: guimeta)
+          - [DONE] module folder /modules - (mip complient: /modules/lib)
+				- LM_* (approx.: 54)
+				- IO_* (approx.: 5)
+
+
+		- (5) [DONE] Universal task creation response: `{taskID: verdict}`
+
+		- (6) [DONE] Proper mip installer support (/modules or /lib or /web)
+			- Note: Autonomous package management over wifi (github)
+				- pacman install <package-url>
+				- pacman uninstall <package-name>
+				- pacman upgrade <package-name>
+				- pacman ls
+				- pacman dirtree
+		- (7) [DONE] /config/requirements.txt handling (native micropython requirements syntax)
+			-  pacman install "requirements.txt"
+		- (8) [DONE] micrOS/packages - submodule to create individual installable applications for micrOS
+			- Application registry (package.json and pacman.json): https://github.com/BxNxM/micrOSPackages 
+			- micrOS devToolKit micrOS/packages Load Module feature rendering (same as for built-in LMs)
+				- sfuncman.json and sfuncman.html - external packages highlight
+
+		- (9) [DONE] micropython uplift to `1.27`
+			- [DONE] fix micrOS USB update config restore issue
+
+		- (10) [DONE] WebEngine: Web mounts/aliases for /data and /modules
+			- Default web mount: /web
+			- Extended web mounts (if in this dict logic): 
+				WEB_MOUNTS = {
+					#             PATH
+    				"$modules": "/modules",
+    				"$data": "/data",
+    				...
+				}
+		   - Absolute usr input path check (Files.py)
+			- Fileserver integration
+				- custom listing for /modules (without .mpy files)
+				- mount pathes write access handlig
+				- mount pathes read (+visibility) access handlig
+
+		- (11) [DONE] @Auth.sudo decorator
+			- Require pwd="<password>" parameter
+			- Two modes:
+				- Always require
+				- Require when force=True (_force_only=(True, 0))
+			- Apply this to:
+				- pacman rm
+				- pacman rmdir
+				- pacman uninstall
+				- pacman upgrade ... force=True
+				- ...
+
+	[TODO] TESTING + RELEASE  `./micrOS/release_info/micrOS_ReleaseInfo`
+		- Create release notes (legacy: `release_3.0.0-0_note_esp32.md`)
+		- Introduce automatic release metrics generation...
+			- `system_analysis_sum.json` and `devices_system_metrics.json` 
+
 ```
 
-Version **3.1.0-0**
+Version **3.1.0-0** `micrOS-Waterbear`
 
 ```
     Core:
-    - Async socket servers with SSL/TLS integration (with auth.)
-        - WebCli (https?), ShellCli (ssocket/sterminal) and InterCon
+    - Low power mode (wake on event, hibernate command)?
+    	- Remote controller / Sensor UseCase
+    - WebEngine additional path shering:
+    	- web shared root (already done): /web
+    	- optional additional pathes:
+    		- @modules -> /modules
+    		- @data    -> /data
 ```
 
-Version **4.0.0-0**
+
+Version **3.X.0-0** `micrOS-SecurePower`
 
 ```
     Core:
-    - Network stack redesign
-        - Network
-            - wifi (defualt, current interfaces)
-            - Study of BLE (Shell)
-    - Low power mode (with BLE) and soft-sleep / deep-sleep
+    - Async socket servers with SSL/TLS integration (with auth.)
+        - ShellCli (with TLS) and InterCon adaptation (default port: 9008, new secure port 9009)
+        - WebCli (https) and webUI adaptation
+    - 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
+    - Application deployment automation: /config/compose.json
+    	- enables application deployment:
+    		- configuration (node_config.json) handling - safe parameter injection (boothook and irqs)
+    		- [done] requirements.txt handling
+    	- Automatic behaviour in core system if file exists in STA mode
 ```
 
+<a id="release-note"></a>
+## Release notes
 
 |  VERSION (TAG) |    RELEASE INFO    |  MICROS CORE MEMORY USAGE  |  SUPPORTED DEVICE(S) | APP PROFILES | Load Modules  |     NOTE       |
 | :----------: | :----------------: | :------------------------:   |  :-----------------: | :------------: | :------------:| -------------- |
@@ -531,6 +694,7 @@ Version **4.0.0-0**
 |  **v 1.21.0-4** | [release_Info-1.21.0-4](./micrOS/release_info/micrOS_ReleaseInfo/release_1.21.0-4_note_esp32.md) |  **57.3%** 63 728 byte | esp32 (tinyPico, esp32s2, esp32s3) | [App Profiles](./micrOS/release_info/node_config_profiles/) | [LM manual](./micrOS/client/sfuncman/sfuncman_1.21.0-4.json) | Full async core system with advanced task management and device to device communication, task scheduling and much more ... with more then 30 application/pheriphery support.
 |  **v 2.0.0-0** | [release_Info-2.0.0-0](./micrOS/release_info/micrOS_ReleaseInfo/release_2.0.0-0_note_esp32.md) |  **45.4%** 68.7 kb | esp32 (tinyPico, esp32s2, esp32s3) | [App Profiles](./micrOS/release_info/node_config_profiles/) | [LM manual](./micrOS/client/sfuncman/sfuncman_2.0.0-0.json) | Optimizations, WebCli with web frontends, Camera support. Micropython 1.21 async maxed out :D
 |  **v 2.6.0-0** | [release_Info-2.6.0-0](./micrOS/release_info/micrOS_ReleaseInfo/release_2.6.0-0_note_esp32.md) |  **48.3%** 72.6 kb  | esp32 (tinyPico, esp32s2, esp32s3) | [App Profiles](./micrOS/release_info/node_config_profiles/) | [LM manual](./micrOS/client/sfuncman/sfuncman_2.6.0-0.json) | WebCli http server enhancements. New webapps: dashboard. Core system official interface finalization towards Load Modules: Common.py, Types.py (frontend generation), microIO.py (pinout handling).
+|  **v 3.0.0-0** | [release_Info-3.0.0-0](./micrOS/release_info/micrOS_ReleaseInfo/release_3.0.0-0_note_esp32.md) |  **??%** ?? kb  | esp32 (tinyPico, esp32s2, esp32s3) | [App Profiles](./micrOS/release_info/node_config_profiles/) | [LM manual](./micrOS/client/sfuncman/sfuncman_3.0.0-0.json) | ... Coming soon ...
 
 ----------------------------------------
 ----------------------------------------
@@ -686,8 +850,6 @@ devToolKit.py -c -p '--dev BedLamp help'
       help
    dht22
         help
-   intercon
-           help
    robustness
              help
    system
@@ -817,8 +979,6 @@ BedLamp $ help
       help
    dht22
         help
-   intercon
-           help
    robustness
              help
    system
@@ -830,214 +990,113 @@ Bye!
 
 ## Project structure
 
-### micrOS resources library
-
-#### micrOS Core
-
-```
-Core micrOS resources
-1	154	Time.py                  (mlint: True)	(pylint: 9.17)	(ref.: 6)
-2	104	micrOSloader.py          (mlint: True)	(pylint: 7.59)	(ref.: 1)
-3	50	Hooks.py                 (mlint: True)	(pylint: 9.68)	(ref.: 1)
-4	418	Server.py                (mlint: True)	(pylint: 9.29)	(ref.: 4)
-5	454	Tasks.py                 (mlint: True)	(pylint: 9.71)	(ref.: 13)
-6	185	Config.py                (mlint: True)	(pylint: 9.44)	(ref.: 13)
-7	9	reset.py                 (mlint: True)	(pylint: 8.75)	(ref.: 0)
-8	225	Shell.py                 (mlint: True)	(pylint: 9.61)	(ref.: 1)
-9	179	Notify.py                (mlint: True)	(pylint: 9.55)	(ref.: 2)
-10	77	Types.py                 (mlint: True)	(pylint: 9.69)	(ref.: 11)
-11	157	Common.py                (mlint: True)	(pylint: 9.1)	(ref.: 24)
-12	153	InterConnect.py          (mlint: True)	(pylint: 9.4)	(ref.: 1)
-13	177	Debug.py                 (mlint: True)	(pylint: 8.72)	(ref.: 22)
-14	164	Network.py               (mlint: True)	(pylint: 9.71)	(ref.: 10)
-15	183	Scheduler.py             (mlint: True)	(pylint: 9.61)	(ref.: 1)
-16	113	microIO.py               (mlint: True)	(pylint: 9.08)	(ref.: 38)
-17	49	micrOS.py                (mlint: True)	(pylint: 9.3)	(ref.: 1)
-18	113	Interrupts.py            (mlint: True)	(pylint: 9.05)	(ref.: 2)
-19	15	main.py                  (mlint: True)	(pylint: 8.89)	(ref.: 0)
-20	117	urequests.py             (mlint: True)	(pylint: 8.9)	(ref.: 4)
-
-SUM CODE LINES (WITH COMMENTS, WITHOUT EMPTY LINES): 3096
-```
-
-#### micrOS Load Modules
-
 ```
-micrOS Load Module resources
-1	231	LM_roboarm.py            (mlint: True)	(pylint: 9.11)	(ref.: 0)
-2	122	LM_stepper.py            (mlint: True)	(pylint: 8.9)	(ref.: 1)
-3	118	LM_genIO.py              (mlint: True)	(pylint: 7.26)	(ref.: 1)
-4	498	LM_oled_ui.py            (mlint: False)	(pylint: 8.83)	(ref.: 0)
-5	190	LM_system.py             (mlint: True)	(pylint: 7.57)	(ref.: 3)
-6	63	LM_robustness.py         (mlint: True)	(pylint: 7.5)	(ref.: 0)
-7	115	LM_co2.py                (mlint: True)	(pylint: 8.42)	(ref.: 3)
-8	34	LM_rest.py               (mlint: False)	(pylint: 7.0)	(ref.: 0)
-9	266	LM_oled.py               (mlint: True)	(pylint: 9.23)	(ref.: 3)
-10	72	LM_tinyrgb.py            (mlint: True)	(pylint: 7.95)	(ref.: 0)
-11	96	LM_aht10.py              (mlint: True)	(pylint: 8.73)	(ref.: 0)
-12	293	LM_bme280.py             (mlint: True)	(pylint: 8.03)	(ref.: 0)
-13	37	LM_ph_sensor.py          (mlint: True)	(pylint: 5.79)	(ref.: 0)
-14	241	LM_buzzer.py             (mlint: True)	(pylint: 8.83)	(ref.: 0)
-15	199	LM_switch.py             (mlint: True)	(pylint: 8.56)	(ref.: 2)
-16	113	LM_servo.py              (mlint: True)	(pylint: 7.73)	(ref.: 4)
-17	53	LM_rgbcct.py             (mlint: True)	(pylint: 8.62)	(ref.: 0)
-18	284	LM_oled_sh1106.py        (mlint: True)	(pylint: 8.79)	(ref.: 1)
-19	150	LM_ld2410.py             (mlint: True)	(pylint: 9.07)	(ref.: 0)
-20	273	LM_neopixel.py           (mlint: True)	(pylint: 7.59)	(ref.: 2)
-21	274	LM_cct.py                (mlint: True)	(pylint: 8.83)	(ref.: 1)
-22	38	LM_L9110_DCmotor.py      (mlint: True)	(pylint: 7.69)	(ref.: 0)
-23	256	LM_neoeffects.py         (mlint: True)	(pylint: 6.91)	(ref.: 0)
-24	30	LM_i2c.py                (mlint: True)	(pylint: 5.71)	(ref.: 0)
-25	69	LM_dht22.py              (mlint: True)	(pylint: 8.0)	(ref.: 0)
-26	59	LM_L298N_DCmotor.py      (mlint: True)	(pylint: 8.78)	(ref.: 0)
-27	37	LM_esp32.py              (mlint: True)	(pylint: 4.38)	(ref.: 0)
-28	56	LM_pet_feeder.py         (mlint: True)	(pylint: 7.88)	(ref.: 0)
-29	82	LM_rencoder.py           (mlint: True)	(pylint: 8.92)	(ref.: 0)
-30	247	LM_keychain.py           (mlint: False)	(pylint: 9.14)	(ref.: 0)
-31	69	LM_dht11.py              (mlint: True)	(pylint: 8.0)	(ref.: 0)
-32	74	LM_telegram.py           (mlint: False)	(pylint: 8.94)	(ref.: 0)
-33	177	LM_OV2640.py             (mlint: False)	(pylint: 9.06)	(ref.: 0)
-34	249	LM_rgb.py                (mlint: True)	(pylint: 8.66)	(ref.: 1)
-35	62	LM_distance.py           (mlint: True)	(pylint: 8.14)	(ref.: 0)
-36	313	LM_VL53L0X.py            (mlint: True)	(pylint: 9.07)	(ref.: 0)
-37	107	LM_light_sensor.py       (mlint: True)	(pylint: 8.94)	(ref.: 0)
-38	12	LM_rp2w.py               (mlint: True)	(pylint: 4.44)	(ref.: 0)
-39	190	LM_presence.py           (mlint: True)	(pylint: 8.75)	(ref.: 4)
-40	29	LM_dashboard_be.py       (mlint: True)	(pylint: 6.5)	(ref.: 0)
-41	170	LM_dimmer.py             (mlint: True)	(pylint: 8.22)	(ref.: 0)
-42	66	LM_demo.py               (mlint: False)	(pylint: 8.21)	(ref.: 0)
-43	105	LM_lmpacman.py           (mlint: True)	(pylint: 8.38)	(ref.: 0)
-44	176	LM_gameOfLife.py         (mlint: True)	(pylint: 9.29)	(ref.: 2)
-45	58	LM_catgame.py            (mlint: True)	(pylint: 8.46)	(ref.: 0)
-46	42	LM_intercon.py           (mlint: True)	(pylint: 8.18)	(ref.: 3)
-47	43	LM_ds18.py               (mlint: True)	(pylint: 5.0)	(ref.: 2)
-48	250	LM_i2s_mic.py            (mlint: False)	(pylint: 8.71)	(ref.: 1)
-49	34	LM_sdcard.py             (mlint: True)	(pylint: 7.88)	(ref.: 0)
-
-SUM CODE LINES (WITH COMMENTS, WITHOUT EMPTY LINES): 6822
+./micrOS/source
+├── Common.py
+├── Config.py
+├── Debug.py
+├── Espnow.py
+├── Files.py
+├── Hooks.py
+├── InterConnect.py
+├── Interrupts.py
+├── Logger.py
+├── Network.py
+├── Notify.py
+├── Scheduler.py
+├── Server.py
+├── Shell.py
+├── Tasks.py
+├── Time.py
+├── Types.py
+├── Web.py
+├── main.py
+├── micrOS.py
+├── micrOSloader.py
+├── reset.py
+├── urequests.py
+├── microIO.py
+├── config
+│   └── _git.keep
+├── modules
+│   ├── IO_esp32.py
+│   ├── IO_esp32c3.py
+│   ├── IO_esp32c6.py
+│   ├── IO_esp32s2.py
+│   ├── IO_esp32s3.py
+│   ├── IO_m5stamp.py
+│   ├── IO_qtpy.py
+│   ├── IO_rp2.py
+│   ├── IO_s3matrix.py
+│   ├── IO_tinypico.py
+│   ├── LM_L298N.py
+│   ├── LM_L9110_DCmotor.py
+│   ├── LM_OV2640.py
+│   ├── LM_VL53L0X.py
+│   ├── LM_aht10.py
+│   ├── LM_bme280.py
+│   ├── LM_buzzer.py
+│   ├── LM_cct.py
+│   ├── LM_cluster.py
+│   ├── LM_co2.py
+│   ├── LM_dashboard_be.py
+│   ├── LM_dht11.py
+│   ├── LM_dht22.py
+│   ├── LM_dimmer.py
+│   ├── LM_distance.py
+│   ├── LM_ds18.py
+│   ├── LM_esp32.py
+│   ├── LM_espnow.py
+│   ├── LM_gameOfLife.py
+│   ├── LM_genIO.py
+│   ├── LM_haptic.py
+│   ├── LM_i2c.py
+│   ├── LM_i2s_mic.py
+│   ├── LM_keychain.py
+│   ├── LM_ld2410.py
+│   ├── LM_light_sensor.py
+│   ├── LM_mqtt_client.py
+│   ├── LM_neoeffects.py
+│   ├── LM_neomatrix.py
+│   ├── LM_neopixel.py
+│   ├── LM_oled.py
+│   ├── LM_oled_sh1106.py
+│   ├── LM_oled_ui.py
+│   ├── LM_oledui.py
+│   ├── LM_pacman.py
+│   ├── LM_presence.py
+│   ├── LM_qmi8658.py
+│   ├── LM_rencoder.py
+│   ├── LM_rest.py
+│   ├── LM_rgb.py
+│   ├── LM_rgbcct.py
+│   ├── LM_roboarm.py
+│   ├── LM_robustness.py
+│   ├── LM_rp2w.py
+│   ├── LM_sdcard.py
+│   ├── LM_servo.py
+│   ├── LM_sound_event.py
+│   ├── LM_stepper.py
+│   ├── LM_switch.py
+│   ├── LM_system.py
+│   ├── LM_tcs3472.py
+│   ├── LM_telegram.py
+│   ├── LM_tinyrgb.py
+│   ├── LM_trackball.py
+│   └── LM_veml7700.py
+└── web
+    ├── dashboard.html
+    ├── index.html
+    ├── matrix_draw.html
+    ├── uapi.js
+    ├── udashboard.js
+    ├── ustyle.css
+    ├── uwidgets.js
+    └── uwidgets_pro.js
+
+4 directories, 98 files
 ```
 
-> LM (Load Modules) - Application logic - accessable over socket server as a command
-
-### micrOS devToolkit resources
-
-#### DevToolKit Dashboard apps
-
-> You can easly copy the `Template_app.py`, and create a new socket based app.
-[Template_app.py](https://github.com/BxNxM/micrOS/blob/master/toolkit/dashboard_apps/Template_app.py)
-
-```
-micrOS/toolkit/dashboard_apps
-│   ├── AirQualityBME280_app.py
-│   ├── AirQualityDHT22_CO2_app.py
-│   ├── AnalogCCT_app.py
-│   ├── AnalogRGB_app.py
-│   ├── CatGame_app.py
-│   ├── Dimmer_app.py
-│   ├── GetVersion_app.py
-│   ├── GetVersion_app.pyc
-│   ├── NeopixelTest_app.py
-│   ├── RoboArm_app.py
-│   ├── SysCheck_app.py
-│   ├── Template_app.py
-```
-
-#### Stored connection data and default node configs
-
-```
-micrOS/toolkit/user_data
-│   ├── device_conn_cache.json        <- connection cache
-│   └── node_config_archive
-│       ├── BigRGB-node_config.json
-│       ├── Chillight-node_config.json
-│       ├── Kapcsolo230-node_config.json
-│       ├── LampController-node_config.json
-│       ├── MeasureNode-node_config.json
-│       ├── MrGreen-node_config.json
-│       ├── RingLamp-node_config.json
-│       └── test-node_config.json
-```
-
-#### Virtaulenv for development and stored USB-Serial drivers
-
-```
-micrOS/env/
-├── __init__.py
-├── driver_cp210x
-│   ├── CP210x_Universal_Windows_Driver
-│   └── macOS_VCP_Driver
-├── requirements.txt
-└── venv
-    ├── bin
-    ├── include
-    ├── lib
-    └── pyvenv.cfg
-```
-
-#### Precompiled resources for easy install
-
-```
-micrOS/toolkit/workspace/precompiled
-    │   ├── BgJob.mpy
-    │   ├── Common.mpy
-    │   ├── ConfigHandler.mpy
-    │   ├── Debug.mpy
-    │   ├── Hooks.mpy
-    │   ├── InterConnect.mpy
-    │   ├── InterpreterCore.mpy
-    │   ├── InterpreterShell.mpy
-    │   ├── InterruptHandler.mpy
-    │   ├── LM_L298N_DCmotor.mpy
-    │   ├── LM_L9110_DCmotor.py
-    │   ├── LM_VL53L0X.py
-    │   ├── LM_bme280.mpy
-    │   ├── LM_buzzer.mpy
-    │   ├── LM_catgame.py
-    │   ├── LM_cct.mpy
-    │   ├── LM_co2.mpy
-    │   ├── LM_dht11.mpy
-    │   ├── LM_dht22.mpy
-    │   ├── LM_dimmer.mpy
-    │   ├── LM_distance_HCSR04.py
-    │   ├── LM_ds18.mpy
-    │   ├── LM_esp32.py
-    │   ├── LM_genIO.mpy
-    │   ├── LM_i2c.py
-    │   ├── LM_intercon.mpy
-    │   ├── LM_light_sensor.mpy
-    │   ├── LM_neoeffects.mpy
-    │   ├── LM_neopixel.mpy
-    │   ├── LM_oled.mpy
-    │   ├── LM_oled_ui.mpy
-    │   ├── LM_pet_feeder.py
-    │   ├── LM_ph_sensor.py
-    │   ├── LM_rgb.mpy
-    │   ├── LM_roboarm.mpy
-    │   ├── LM_robustness.py
-    │   ├── LM_servo.mpy
-    │   ├── LM_stepper.mpy
-    │   ├── LM_switch.mpy
-    │   ├── LM_system.mpy
-    │   ├── LM_tinyrgb.mpy
-    │   ├── IO_esp32.mpy
-    │   ├── IO_tinypico.mpy
-    │   ├── LogicalPins.mpy
-    │   ├── Network.mpy
-    │   ├── Scheduler.mpy
-    │   ├── SocketServer.mpy
-    │   ├── Time.mpy
-    │   ├── TinyPLed.mpy
-    │   ├── boot.py
-    │   ├── micrOS.mpy
-    │   ├── micrOSloader.mpy
-    │   └── reset.mpy
-```
-
-> Note: From the `micrOS/source/` by default the LMs are not compiling, to extend complied LM list add LM explicitly to the following file:
-
-```
-micrOs/toolkit/LM_to_compile.dat
-```
 
 ----------------------------------------