utop: Add initial implementation for ESP32.

Signed-off-by: Daniël van de Giessen <daniel@dvdgiessen.nl>

Author: DvdGiessen

micropython/utop/README.md

@@ -0,0 +1,12 @@
+# utop
+
+Provides a top-like live overview of the running system.
+
+On the `esp32` port this depends on the `esp32.idf_task_stats()` function, which
+can be enabled by adding the following lines to the board `sdkconfig`:
+
+```ini
+CONFIG_FREERTOS_USE_TRACE_FACILITY=y
+CONFIG_FREERTOS_VTASKLIST_INCLUDE_COREID=y
+CONFIG_FREERTOS_GENERATE_RUN_TIME_STATS=y
+```

micropython/utop/manifest.py

@@ -0,0 +1,6 @@
+metadata(
+    version="0.1.0",
+    description="Provides a top-like live overview of the running system.",
+)
+
+module("utop.py")

micropython/utop/utop.py

@@ -0,0 +1,66 @@
+import gc
+import time
+
+try:
+    import esp32
+except ImportError:
+    esp32 = None
+
+def top(update_interval_ms=1000, timeout_ms=None):
+    time_start = time.ticks_ms()
+    previous_total_runtime = None
+    previous_task_runtimes = {}
+    previous_line_count = 0
+    esp32_task_state_names = ('running', 'ready', 'blocked', 'suspended', 'deleted', 'invalid')
+
+    while timeout_ms is None or abs(time.ticks_diff(time.ticks_ms(), time_start)) < timeout_ms:
+        if previous_line_count > 0:
+            print('\x1B[{}A'.format(previous_line_count), end='')
+        line_count = 0
+
+        if esp32 is not None:
+            if not hasattr(esp32, 'idf_task_stats'):
+                print('INFO: esp32.idf_task_stats() is not available, cannot list active tasks.\x1B[K')
+                line_count += 1
+            else:
+                print('   CPU%  CORE  PRIORITY  STATE      STACKWATERMARK  NAME\x1B[K')
+                line_count += 1
+
+                total_runtime, tasks = esp32.idf_task_stats()
+                tasks.sort(key=lambda t: t[1])
+                for task_name, task_id, task_state, task_priority, task_runtime, task_stackhighwatermark, task_coreid in tasks:
+                    task_runtime_percentage = '-'
+                    if total_runtime > 0:
+                        if previous_total_runtime is not None and task_id in previous_task_runtimes:
+                            task_cpu_percentage = 100 * (task_runtime - previous_task_runtimes[task_id]) / (total_runtime - previous_total_runtime)
+                        else:
+                            task_cpu_percentage = 100 * task_runtime / total_runtime
+                        task_runtime_percentage = '{:.2f}%'.format(task_cpu_percentage)
+                    task_state_name = 'unknown'
+                    if task_state >= 0 and task_state < len(esp32_task_state_names):
+                        task_state_name = esp32_task_state_names[task_state]
+
+                    print('{:>7}  {:>4d}  {:>8d}  {:<9}  {:<14d}  {}\x1B[K'.format(
+                        task_runtime_percentage,
+                        task_coreid,
+                        task_priority,
+                        task_state_name,
+                        task_stackhighwatermark,
+                        task_name
+                    ))
+                    line_count += 1
+
+                    previous_task_runtimes[task_id] = task_runtime
+        else:
+            print('INFO: Platform does not support listing active tasks.\x1B[K')
+            line_count += 1
+
+        if previous_line_count > line_count:
+            for _ in range(previous_line_count - line_count):
+                print('\x1B[K')
+            print('\x1B[{}A'.format(previous_line_count - line_count), end='')
+
+        previous_total_runtime = total_runtime
+        previous_line_count = line_count
+
+        time.sleep_ms(update_interval_ms)