micrOSDevToolKit 2.6.6__tar.gz → 2.7.0__tar.gz

{micrOSDevToolKit-2.6.6 → microsdevtoolkit-2.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: micrOSDevToolKit
-Version: 2.6.6
+Version: 2.7.0
 Summary: Development and deployment environment for micrOS, the diy micropython automation OS (IoT)
 Home-page: https://github.com/BxNxM/micrOS
 Author: Marcell Ban
@@ -8,14 +8,27 @@ Author-email: miros.framework@gmail.com
 License: MIT
 Project-URL: Bug Tracker, https://github.com/BxNxM/micrOS/issues
 Project-URL: GitHub Discussions, https://github.com/BxNxM/micrOS/discussions
-Platform: UNKNOWN
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Requires-Dist: adafruit-ampy
+Requires-Dist: mpremote
+Requires-Dist: esptool
+Requires-Dist: ipaddress
+Requires-Dist: netaddr
+Requires-Dist: pylint
+Requires-Dist: pyserial
+Requires-Dist: resources
+Requires-Dist: flask
+Requires-Dist: flask_restful
+Requires-Dist: numpy
+Requires-Dist: json2html
+Requires-Dist: requests
+Requires-Dist: Flask-BasicAuth
+Requires-Dist: soundfile
 
 # ![LOGO](./media/logo_mini.png?raw=true) micrOS
 
-
-### micropython based smart edge platform #IoT
+> **"Simple, yet increadbly useful."**
 
 ![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/>
 
@@ -31,7 +44,7 @@ Thanks for ![GitHub stars](https://img.shields.io/github/stars/BxNxM/micrOS), fo
 [![PyPI Version](https://img.shields.io/pypi/v/micrOSDevToolKit)](https://pypi.org/project/micrOSDevToolKit/)
 
 
-**micrOS** is a mini **application** execution **platform** with ShellCli (socket) and WebCli (http) **servers** and several **other** embedded **features**.
+**micrOS** is a [micropython](http://micropython.org) based mini **application** execution **platform** with ShellCli (socket) and WebCli (http) **servers** and several **other** embedded **features**. 
 > It uses direct wifi connection to access the exposed functionalities.<br/>
 
 In case of any technical comments or requests, please use [![GitHub Discussions](https://img.shields.io/badge/GitHub-Discussions-green?logo=github&style=flat)](https://github.com/BxNxM/micrOS/discussions).
@@ -52,9 +65,6 @@ Access rest api over browser: `http://<nodename>.local`
 ⚠️  No external server or service required for client-device communication <br/>
 &nbsp;&nbsp; ⚠️ 🛡 Works on Local Network (WiFi-WLAN) <br/>
 🛠 Easy to create custom application(s) aka create your own Load Modules: <br/>
-&nbsp;&nbsp; 1. Write **LM_**`<your_app>`**.py** <br/>
-&nbsp;&nbsp; 2. Copy (OTA/USB) python script to your device (drag&drop)<br/>
-&nbsp;&nbsp; 3. Call any function from **`<your_app>`** module <br/>
 🦾 Built-in scheduling (IRQs):<br/>
 &nbsp;&nbsp; - Time stamp based <br/>
 &nbsp;&nbsp; - Geolocation based clock setup + time tags: sunset, sunrise <br/>
@@ -70,8 +80,8 @@ Access rest api over browser: `http://<nodename>.local`
 4. micrOS System and features [link](https://github.com/BxNxM/micrOS/#micros-framework-features)
 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 customization with LMs: [link](./APPLICATION_GUIDE.md)
-8. micrOS gateway with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
+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)
 
 ----------------------------------------
@@ -222,57 +232,65 @@ It will install your board via USB with default settings. **Continue with micrOS
     - ⏳**Boot phase** - preload Load Module(s)
         - For pinout and last state initialization - based on node_config `boothook`
         - 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
           - 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)`
+                - Comments `#` can be used in `timirqcbf`
             - 🗓cron [time stump!LM task] pool execution `cron` & `crontasks`
                 - `Timer(1)` 
                 - 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 -> optional range handling: 0-2 means Monday to Wednesday
+                    - `WD: 0...6` 0=Monday, 6=Sunday
+                        - optional **range handling**: 0-2 means Monday to Wednesday
                 - tag: `sunset` / `sunrise`
                     - example: `sunset!rgb rgb r=10 g=60 b=100; etc.`, it will set rgb color on analog rgb periphery at every sunset, every day.
                     - optional minute offset (+/-): sunrise+30
+                - Comments cannot be used in `crontasks`! No multiple commands in this mode!
 
                 - API: [api.sunrise-sunset.org](https://api.sunrise-sunset.org/json?lat={lat}&lng={lon}&date=today&formatted=0)
         - 💣Event based
             - Set trigger event `irqX`
                 - Trigger up/down/both `irqX_trig`
                 - With LM callback function `irqX_cbf`
-            - X = 1, 2, 3 or 4
+                - Comments `#` can be used in `irqX_cbf`
+            - `X` can be = 1, 2, 3 or 4
+
 
-- ⚙️**[L]oad [M]odule** aka **application** handling
+- ⚙️**[L]oad [M]odule** aka **application** execution
 	- Lot of built-in functions (table below)
 	- Create your own module with 3 easy steps
 		- Create a python file, naming convention: `LM_<your_app_name>.py`
 			- Replace `<your_app_name>` for anything you prefer!
 		- Write python functions, you can call any function from that module...
-		- Upload modul with "drag&Drop" with help of devToolKit GUI `devToolKit.py`
+		- Upload modul with "drag&Drop" devToolKit GUI `devToolKit.py`
 
 - 📨**ShellCli** - wireless communication interface with the nodes
-	- **System commands**: `help, version, reboot, webrepl, webrepl --update, etc.`
-		- After `webrepl --update` command the micrOS system reboots and waits for ota update in webrepl mode.
+	- **System commands**: `help, version, reboot, modules, webrepl, webrepl --update, etc.`
+		- After `webrepl --update` command the micrOS system reboots and waits for ota update in webrepl mode about 20 seconds.
 	- **Config handling** SET/GET/DUMP - **node_config.json**
 		- enter configuration mode: `conf`
-		- exit configuration mode:`noconf`
 		- Print out all parameters and values: `dump`
+		- exit configuration mode:`noconf`
 	- **LM** - Load Module function execution (application modules)
 		- Example: `system info`
-- 🖇**Logical IO** pinout handling - lookuptables for each board
+- 🖇**microIO** pinout handling - lookuptables for each board
 	- Predefined pinout modules for esp32, tinyPico
 	- 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`
 
 - 🔄 **Task manager** aka **Async LM jobs**
 	- Capable of execute [L]oad [M]odules in the background 
-	- Invoke with single execution `&` or loop execution `&&`
+	- Invoke with single execution `&` or for loop execution `&&`
 	- Example:
 		- In loop: `system heartbeat &&`
 			- Loop frequency conrol: `system heartbeat &&1000`, it will execute every sec 
@@ -286,6 +304,36 @@ It will install your board via USB with default settings. **Continue with micrOS
 
 - Socket client python plugin - interactive - non interactive mode
 
+----------------------
+
+### Boards and suggestions
+
+There are multiple types of MCU-s (esp32, esp32s3, etc.) available to order, **BUT** to be able to enable **more features** (~2 Load Modules) and **full capable WebUI** interface you need to have more then **190-210kb** of ram (basic boards)(ℹ️).
+
+There is a solution ✅, additinal psram: **~2-4-8Mb** boards are available. It used to name as **psram** or **spiram**, even there is a type **octo-psram**, so check it before buy!!! Psram needs to be **supported on micropython** side as well !!!
+
+**Suggestions - 🔮futureproof hardware:**
+
+**`esp32s3`**: Very fast new espressif module that supports psram detection, so you can freely select any module with this MCU with additinal ram, and micros will work with the best performance, typical ram sizes: **2Mb** (more then enough for everage usage), **4-8Mb** (capacble of image and sound processing tasks and load all GPIO-s 🚀)
+
+**`esp32s3-octo`** Same sa normal psram, just uses 8 pins to connect to the MCU, basically faster...
+
+**`tinypico`** excellet hardware, bit pricy, with 4Mb of ram.
+
+**`esp32cam`** it has a custom image and attached 8Mb of ram.
+
+So prefer boards with more psram 2Mb-8Mb, **minumum requirement for the full flatched setup ~400kb** but smallest psram is **2Mb**, in practive:
+
+- max measured 4Mb is 3.2% 128kb - oled_ui and lot of things loaded...
+- camera stream can use about 50% of ram, that means about 2Mb of ram usage.
+
+ℹ️ With basic 190-210kb of ram you can use the system with ShellCli with no issue, just webUI dashboard cannot be load due to memory limitations..., **under 140kb of system ram the system not reliable**, so these boards are not supported.
+
+> Note:
+
+**`esp32`** also can be totally fine with ShellCli, WebCli and 1 load module or multiple modules based on module size... just can be limited by the available memory soonor the later ... (WebCli javascript, htmls are quite small but can be few tens of kilobytes, also multiple async tasks in the background can take same, and roughly around 80% of memory usage system can be instable and restarts.) **So if you have a spare one try out micrOS with a range of features :)**
+
+----------------------
 
 ## Built in periphery support
 
@@ -1063,5 +1111,3 @@ gource \
 
 git push -u origin master
 
-
-

micrOSDevToolKit-2.6.6/micrOSDevToolKit.egg-info/PKG-INFO → microsdevtoolkit-2.7.0/README.md

@@ -1,21 +1,6 @@
-Metadata-Version: 2.1
-Name: micrOSDevToolKit
-Version: 2.6.6
-Summary: Development and deployment environment for micrOS, the diy micropython automation OS (IoT)
-Home-page: https://github.com/BxNxM/micrOS
-Author: Marcell Ban
-Author-email: miros.framework@gmail.com
-License: MIT
-Project-URL: Bug Tracker, https://github.com/BxNxM/micrOS/issues
-Project-URL: GitHub Discussions, https://github.com/BxNxM/micrOS/discussions
-Platform: UNKNOWN
-Description-Content-Type: text/markdown
-License-File: LICENSE
-
 # ![LOGO](./media/logo_mini.png?raw=true) micrOS
 
-
-### micropython based smart edge platform #IoT
+> **"Simple, yet increadbly useful."**
 
 ![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/>
 
@@ -31,7 +16,7 @@ Thanks for ![GitHub stars](https://img.shields.io/github/stars/BxNxM/micrOS), fo
 [![PyPI Version](https://img.shields.io/pypi/v/micrOSDevToolKit)](https://pypi.org/project/micrOSDevToolKit/)
 
 
-**micrOS** is a mini **application** execution **platform** with ShellCli (socket) and WebCli (http) **servers** and several **other** embedded **features**.
+**micrOS** is a [micropython](http://micropython.org) based mini **application** execution **platform** with ShellCli (socket) and WebCli (http) **servers** and several **other** embedded **features**. 
 > It uses direct wifi connection to access the exposed functionalities.<br/>
 
 In case of any technical comments or requests, please use [![GitHub Discussions](https://img.shields.io/badge/GitHub-Discussions-green?logo=github&style=flat)](https://github.com/BxNxM/micrOS/discussions).
@@ -52,9 +37,6 @@ Access rest api over browser: `http://<nodename>.local`
 ⚠️  No external server or service required for client-device communication <br/>
 &nbsp;&nbsp; ⚠️ 🛡 Works on Local Network (WiFi-WLAN) <br/>
 🛠 Easy to create custom application(s) aka create your own Load Modules: <br/>
-&nbsp;&nbsp; 1. Write **LM_**`<your_app>`**.py** <br/>
-&nbsp;&nbsp; 2. Copy (OTA/USB) python script to your device (drag&drop)<br/>
-&nbsp;&nbsp; 3. Call any function from **`<your_app>`** module <br/>
 🦾 Built-in scheduling (IRQs):<br/>
 &nbsp;&nbsp; - Time stamp based <br/>
 &nbsp;&nbsp; - Geolocation based clock setup + time tags: sunset, sunrise <br/>
@@ -70,8 +52,8 @@ Access rest api over browser: `http://<nodename>.local`
 4. micrOS System and features [link](https://github.com/BxNxM/micrOS/#micros-framework-features)
 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 customization with LMs: [link](./APPLICATION_GUIDE.md)
-8. micrOS gateway with Prometheus&Grafana: [link](https://github.com/BxNxM/micrOS/#micros-gateway-in-docker)
+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)
 
 ----------------------------------------
@@ -222,57 +204,65 @@ It will install your board via USB with default settings. **Continue with micrOS
     - ⏳**Boot phase** - preload Load Module(s)
         - For pinout and last state initialization - based on node_config `boothook`
         - 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
           - 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)`
+                - Comments `#` can be used in `timirqcbf`
             - 🗓cron [time stump!LM task] pool execution `cron` & `crontasks`
                 - `Timer(1)` 
                 - 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 -> optional range handling: 0-2 means Monday to Wednesday
+                    - `WD: 0...6` 0=Monday, 6=Sunday
+                        - optional **range handling**: 0-2 means Monday to Wednesday
                 - tag: `sunset` / `sunrise`
                     - example: `sunset!rgb rgb r=10 g=60 b=100; etc.`, it will set rgb color on analog rgb periphery at every sunset, every day.
                     - optional minute offset (+/-): sunrise+30
+                - Comments cannot be used in `crontasks`! No multiple commands in this mode!
 
                 - API: [api.sunrise-sunset.org](https://api.sunrise-sunset.org/json?lat={lat}&lng={lon}&date=today&formatted=0)
         - 💣Event based
             - Set trigger event `irqX`
                 - Trigger up/down/both `irqX_trig`
                 - With LM callback function `irqX_cbf`
-            - X = 1, 2, 3 or 4
+                - Comments `#` can be used in `irqX_cbf`
+            - `X` can be = 1, 2, 3 or 4
+
 
-- ⚙️**[L]oad [M]odule** aka **application** handling
+- ⚙️**[L]oad [M]odule** aka **application** execution
 	- Lot of built-in functions (table below)
 	- Create your own module with 3 easy steps
 		- Create a python file, naming convention: `LM_<your_app_name>.py`
 			- Replace `<your_app_name>` for anything you prefer!
 		- Write python functions, you can call any function from that module...
-		- Upload modul with "drag&Drop" with help of devToolKit GUI `devToolKit.py`
+		- Upload modul with "drag&Drop" devToolKit GUI `devToolKit.py`
 
 - 📨**ShellCli** - wireless communication interface with the nodes
-	- **System commands**: `help, version, reboot, webrepl, webrepl --update, etc.`
-		- After `webrepl --update` command the micrOS system reboots and waits for ota update in webrepl mode.
+	- **System commands**: `help, version, reboot, modules, webrepl, webrepl --update, etc.`
+		- After `webrepl --update` command the micrOS system reboots and waits for ota update in webrepl mode about 20 seconds.
 	- **Config handling** SET/GET/DUMP - **node_config.json**
 		- enter configuration mode: `conf`
-		- exit configuration mode:`noconf`
 		- Print out all parameters and values: `dump`
+		- exit configuration mode:`noconf`
 	- **LM** - Load Module function execution (application modules)
 		- Example: `system info`
-- 🖇**Logical IO** pinout handling - lookuptables for each board
+- 🖇**microIO** pinout handling - lookuptables for each board
 	- Predefined pinout modules for esp32, tinyPico
 	- 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`
 
 - 🔄 **Task manager** aka **Async LM jobs**
 	- Capable of execute [L]oad [M]odules in the background 
-	- Invoke with single execution `&` or loop execution `&&`
+	- Invoke with single execution `&` or for loop execution `&&`
 	- Example:
 		- In loop: `system heartbeat &&`
 			- Loop frequency conrol: `system heartbeat &&1000`, it will execute every sec 
@@ -286,6 +276,36 @@ It will install your board via USB with default settings. **Continue with micrOS
 
 - Socket client python plugin - interactive - non interactive mode
 
+----------------------
+
+### Boards and suggestions
+
+There are multiple types of MCU-s (esp32, esp32s3, etc.) available to order, **BUT** to be able to enable **more features** (~2 Load Modules) and **full capable WebUI** interface you need to have more then **190-210kb** of ram (basic boards)(ℹ️).
+
+There is a solution ✅, additinal psram: **~2-4-8Mb** boards are available. It used to name as **psram** or **spiram**, even there is a type **octo-psram**, so check it before buy!!! Psram needs to be **supported on micropython** side as well !!!
+
+**Suggestions - 🔮futureproof hardware:**
+
+**`esp32s3`**: Very fast new espressif module that supports psram detection, so you can freely select any module with this MCU with additinal ram, and micros will work with the best performance, typical ram sizes: **2Mb** (more then enough for everage usage), **4-8Mb** (capacble of image and sound processing tasks and load all GPIO-s 🚀)
+
+**`esp32s3-octo`** Same sa normal psram, just uses 8 pins to connect to the MCU, basically faster...
+
+**`tinypico`** excellet hardware, bit pricy, with 4Mb of ram.
+
+**`esp32cam`** it has a custom image and attached 8Mb of ram.
+
+So prefer boards with more psram 2Mb-8Mb, **minumum requirement for the full flatched setup ~400kb** but smallest psram is **2Mb**, in practive:
+
+- max measured 4Mb is 3.2% 128kb - oled_ui and lot of things loaded...
+- camera stream can use about 50% of ram, that means about 2Mb of ram usage.
+
+ℹ️ With basic 190-210kb of ram you can use the system with ShellCli with no issue, just webUI dashboard cannot be load due to memory limitations..., **under 140kb of system ram the system not reliable**, so these boards are not supported.
+
+> Note:
+
+**`esp32`** also can be totally fine with ShellCli, WebCli and 1 load module or multiple modules based on module size... just can be limited by the available memory soonor the later ... (WebCli javascript, htmls are quite small but can be few tens of kilobytes, also multiple async tasks in the background can take same, and roughly around 80% of memory usage system can be instable and restarts.) **So if you have a spare one try out micrOS with a range of features :)**
+
+----------------------
 
 ## Built in periphery support
 
@@ -1063,5 +1083,3 @@ gource \
 
 git push -u origin master
 
-
-

{micrOSDevToolKit-2.6.6 → microsdevtoolkit-2.7.0}/micrOS/release_info/micrOS_ReleaseInfo/system_analysis_sum.json

@@ -2,14 +2,14 @@
     "files": {
         "Time.py": [
             9.17,
-            6
+            7
         ],
         "micrOSloader.py": [
             7.85,
             1
         ],
         "Hooks.py": [
-            9.47,
+            9.41,
             1
         ],
         "Server.py": [
@@ -22,7 +22,7 @@
         ],
         "Config.py": [
             9.44,
-            13
+            14
         ],
         "reset.py": [
             8.75,
@@ -38,15 +38,15 @@
         ],
         "Types.py": [
             8.87,
-            22
+            28
         ],
         "Logger.py": [
             8.57,
             4
         ],
         "Common.py": [
-            9.6,
-            26
+            9.49,
+            32
         ],
         "InterConnect.py": [
             9.4,
@@ -54,11 +54,11 @@
         ],
         "Debug.py": [
             8.4,
-            17
+            16
         ],
         "Network.py": [
             9.71,
-            9
+            8
         ],
         "Scheduler.py": [
             9.61,
@@ -66,7 +66,7 @@
         ],
         "microIO.py": [
             9.26,
-            38
+            42
         ],
         "micrOS.py": [
             9.29,
@@ -81,7 +81,7 @@
             0
         ],
         "urequests.py": [
-            8.83,
+            8.94,
             4
         ],
         "LM_roboarm.py": [
@@ -101,8 +101,8 @@
             0
         ],
         "LM_system.py": [
-            7.65,
-            3
+            8.31,
+            4
         ],
         "LM_robustness.py": [
             7.57,
@@ -118,7 +118,7 @@
         ],
         "LM_oled.py": [
             9.23,
-            3
+            4
         ],
         "LM_tinyrgb.py": [
             7.95,
@@ -154,6 +154,10 @@
         ],
         "LM_oled_sh1106.py": [
             8.84,
+            2
+        ],
+        "LM_haptic.py": [
+            9.25,
             1
         ],
         "LM_ld2410.py": [
@@ -162,7 +166,7 @@
         ],
         "LM_neopixel.py": [
             7.59,
-            1
+            2
         ],
         "LM_cct.py": [
             8.83,
@@ -177,7 +181,7 @@
             0
         ],
         "LM_i2c.py": [
-            5.71,
+            7.6,
             0
         ],
         "LM_dht22.py": [
@@ -189,7 +193,11 @@
             0
         ],
         "LM_esp32.py": [
-            4.38,
+            6.52,
+            1
+        ],
+        "LM_veml7700.py": [
+            7.62,
             0
         ],
         "LM_pet_feeder.py": [
@@ -197,7 +205,7 @@
             0
         ],
         "LM_rencoder.py": [
-            8.92,
+            8.64,
             0
         ],
         "LM_keychain.py": [
@@ -208,6 +216,14 @@
             7.94,
             0
         ],
+        "LM_sound_event.py": [
+            8.49,
+            0
+        ],
+        "LM_oledui.py": [
+            8.52,
+            0
+        ],
         "LM_telegram.py": [
             9.02,
             0
@@ -221,7 +237,7 @@
             1
         ],
         "LM_distance.py": [
-            8.26,
+            8.89,
             0
         ],
         "LM_VL53L0X.py": [
@@ -240,13 +256,17 @@
             8.78,
             4
         ],
+        "LM_trackball.py": [
+            8.43,
+            1
+        ],
         "LM_dashboard_be.py": [
             6.5,
             0
         ],
         "LM_dimmer.py": [
             8.33,
-            0
+            1
         ],
         "LM_demo.py": [
             8.57,
@@ -258,7 +278,7 @@
         ],
         "LM_gameOfLife.py": [
             9.29,
-            2
+            3
         ],
         "LM_catgame.py": [
             8.85,
@@ -266,7 +286,7 @@
         ],
         "LM_intercon.py": [
             8.18,
-            3
+            4
         ],
         "LM_ds18.py": [
             6.0,
@@ -274,7 +294,7 @@
         ],
         "LM_i2s_mic.py": [
             8.37,
-            1
+            2
         ],
         "LM_sdcard.py": [
             7.88,
@@ -283,12 +303,12 @@
     },
     "summary": {
         "core": [
-            3167,
+            3184,
             21
         ],
         "load": [
-            6814,
-            49
+            8685,
+            54
         ],
         "core_dep": [
             true,
@@ -296,10 +316,10 @@
         ],
         "load_dep": [
             true,
-            4
+            5
         ],
         "core_score": 9.1,
-        "load_score": 8.08,
-        "version": "2.6.5-0"
+        "load_score": 8.21,
+        "version": "2.6.6-6"
     }
 }

{micrOSDevToolKit-2.6.6 → microsdevtoolkit-2.7.0}/micrOS/source/Common.py

@@ -1,18 +1,15 @@
 """
-micrOS Load Module programming API-s
+micrOS Load Module programming Official API-s
     Designed by Marcell Ban aka BxNxM
 """
 
 from Server import SocketServer, WebCli
-from Debug import errlog_add
+from Debug import errlog_add, console_write
 from Logger import logger, log_get
 from microIO import resolve_pin
+from Tasks import TaskBase, Manager, lm_exec
 from machine import Pin, ADC
-try:
-    from Tasks import TaskBase, Manager, lm_exec
-except Exception as ie:
-    print(f"Import ERROR, TaskManager: {ie}")
-    TaskBase, Manager = None, None
+
 TELEGRAM = None
 
 ################## Common LM features ##################
@@ -81,7 +78,7 @@ class SmartADC:
         return {'raw': raw, 'percent': round(percent*100, 1), 'volt': volt}
 
     @staticmethod
-    def get_singleton(pin):
+    def get_singleton(pin):                                         # TODO: rename to get_instance
         if pin in SmartADC.OBJS.keys():
             return SmartADC.OBJS[pin]
         SmartADC.OBJS[pin] = SmartADC(pin)
@@ -97,10 +94,6 @@ def micro_task(tag, task=None):
         [2] tag=taskID: return existing task object by tag
     :param task: coroutine to execute (with built-in overload protection and lcm)
     """
-    # [0] Check dependencies
-    if TaskBase is None or Manager is None:
-        # RETURN: None - cannot utilize async task functionality
-        return None
     if task is None:
         # [1] Task is None -> Get task mode by tag
         # RETURN task obj (access obj.out + obj.done (automatic - with keyword arg))
@@ -134,13 +127,19 @@ def manage_task(tag, operation):
     raise Exception(f"Invalid operation: {operation}")
 
 
-def exec_cmd(cmd):
+def exec_cmd(cmd, skip_check=False):
     """
     [LM] Single (sync) LM execution
     :param cmd: command string list
+    :param skip_check: skip cmd type check, micropython bug
     return state, output
     """
-    return lm_exec(cmd) if isinstance(cmd, list) else False, "Invalid cmd type, must be list"
+    # [BUG] Solution with isinstance/type is not reliable... micropython 1.22
+    #          Invalid type, must be list: <class list>" ...
+    if skip_check:
+        return lm_exec(cmd)
+    return lm_exec(cmd) if isinstance(cmd, list) else False, f"Invalid type, must be list: {type(cmd)}"
+
 
 
 def notify(text):
@@ -217,3 +216,8 @@ def data_logger(f_name, data=None, limit=12, msgobj=None):
 def syslog(msg):
     """ Wrapper of errlog_add """
     return errlog_add(f"[U]{msg}")
+
+
+def console(msg):
+    """ Wrapper of console_write """
+    return console_write(msg)