Merge branch 'feature/unify_core_host_target_tests' into 'master'

ci: unify core host target tests

Closes IDF-6621, IDF-6622, IDF-6623, and IDF-6624

See merge request espressif/esp-idf!22944

components/esp_system/test_apps/linux_apis/CMakeLists.txt

@@ -0,0 +1,9 @@
+# For more information about build system see
+# https://docs.espressif.com/projects/esp-idf/en/latest/api-guides/build-system.html
+# The following five lines of boilerplate have to be in your project's
+# CMakeLists in this exact order for cmake to work correctly
+cmake_minimum_required(VERSION 3.16)
+
+include($ENV{IDF_PATH}/tools/cmake/project.cmake)
+set(COMPONENTS main)
+project(test_esp_system)

components/esp_system/test_apps/linux_apis/README.md

@@ -0,0 +1,2 @@
+| Supported Targets | Linux |
+| ----------------- | ----- |

components/esp_system/test_apps/linux_apis/main/CMakeLists.txt

@@ -0,0 +1,3 @@
+idf_component_register(SRCS "esp_system_test.c"
+                    INCLUDE_DIRS "."
+                    PRIV_REQUIRES unity esp_system)

components/esp_system/test_apps/linux_apis/main/esp_system_test.c

@@ -0,0 +1,115 @@
+/*
+ * SPDX-FileCopyrightText: 2022-2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#include <stdio.h>
+#include <stdlib.h>
+#include <setjmp.h>
+#include "unity.h"
+#include "unity_test_runner.h"
+
+#include "esp_system.h"
+
+static jmp_buf env;
+static uint32_t token;
+
+static void jump_back_shutdown_handler(void)
+{
+    longjmp(env, 1);
+}
+
+static void dummy_shutdown_handler_0(void) { }
+static void dummy_shutdown_handler_1(void) { }
+static void dummy_shutdown_handler_2(void) { }
+static void dummy_shutdown_handler_3(void) { }
+static void dummy_shutdown_handler_4(void) { }
+
+static void action(void)
+{
+    token++;
+}
+
+static void cleanup(void)
+{
+    esp_unregister_shutdown_handler(jump_back_shutdown_handler);
+    esp_unregister_shutdown_handler(dummy_shutdown_handler_0);
+    esp_unregister_shutdown_handler(dummy_shutdown_handler_1);
+    esp_unregister_shutdown_handler(dummy_shutdown_handler_2);
+    esp_unregister_shutdown_handler(dummy_shutdown_handler_3);
+    esp_unregister_shutdown_handler(dummy_shutdown_handler_4);
+    esp_unregister_shutdown_handler(action);
+}
+
+TEST_CASE("reset_reason", "[esp_system]")
+{
+    TEST_ASSERT_EQUAL(ESP_RST_POWERON, esp_reset_reason());
+}
+
+TEST_CASE("unregister_handler_works", "[esp_system]")
+{
+    token = 0;
+    // for some reason, the handlers are executed in reverse order of adding handlers, so we always
+    // register the jumping handler at first to make it execute last
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(jump_back_shutdown_handler));
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(action));
+    TEST_ASSERT_EQUAL(ESP_OK, esp_unregister_shutdown_handler(action));
+
+    if (setjmp(env) == 0) {
+        esp_restart();
+    }
+
+    // fist unregister before any assert to avoid skipping by assert's longjmp
+    cleanup();
+
+    TEST_ASSERT_EQUAL(0, token);
+}
+
+TEST_CASE("register_shutdown_handler_twice_fails", "[esp_system]")
+{
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(jump_back_shutdown_handler));
+    TEST_ASSERT_EQUAL(ESP_ERR_INVALID_STATE, esp_register_shutdown_handler(jump_back_shutdown_handler));
+
+    cleanup();
+}
+
+TEST_CASE("register_shutdown_handler_works", "[esp_system]")
+{
+    token = 0;
+    TEST_ASSERT_EQUAL(esp_register_shutdown_handler(jump_back_shutdown_handler), ESP_OK);
+    TEST_ASSERT_EQUAL(esp_register_shutdown_handler(action), ESP_OK);
+
+    if (setjmp(env) == 0) {
+        esp_restart();
+    }
+
+    cleanup();
+
+    TEST_ASSERT_EQUAL(1, token);
+}
+
+TEST_CASE("register_too_many_shutdown_handler_fails", "[esp_system]")
+{
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(dummy_shutdown_handler_0));
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(dummy_shutdown_handler_1));
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(dummy_shutdown_handler_2));
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(dummy_shutdown_handler_3));
+    TEST_ASSERT_EQUAL(ESP_OK, esp_register_shutdown_handler(dummy_shutdown_handler_4));
+
+    TEST_ASSERT_EQUAL(esp_register_shutdown_handler(jump_back_shutdown_handler), ESP_ERR_NO_MEM);
+
+    cleanup();
+}
+
+TEST_CASE("heap_size_stubs", "[esp_system]")
+{
+    TEST_ASSERT_EQUAL(UINT32_MAX, esp_get_free_heap_size());
+    TEST_ASSERT_EQUAL(UINT32_MAX, esp_get_free_internal_heap_size());
+    TEST_ASSERT_EQUAL(UINT32_MAX, esp_get_minimum_free_heap_size());
+}
+
+void app_main(void)
+{
+    printf("Running esp_system host test app");
+    unity_run_menu();
+}

components/esp_system/test_apps/linux_apis/pytest_esp_system_linux.py

@@ -0,0 +1,12 @@
+# SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
+# SPDX-License-Identifier: Unlicense OR CC0-1.0
+import pytest
+from pytest_embedded import Dut
+
+
+@pytest.mark.linux
+@pytest.mark.host_test
+def test_esp_system_linux(dut: Dut) -> None:
+    dut.expect_exact('Press ENTER to see the list of tests.')
+    dut.write('*')
+    dut.expect_unity_test_output(timeout=10)

components/esp_system/test_apps/linux_apis/sdkconfig.defaults

@@ -0,0 +1 @@
+CONFIG_IDF_TARGET="linux"