2024-01-30 10:53:12 -05:00
|
|
|
# SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
|
2023-01-30 04:40:30 -05:00
|
|
|
# SPDX-License-Identifier: Apache-2.0
|
|
|
|
import logging
|
|
|
|
import shutil
|
|
|
|
from pathlib import Path
|
2024-01-30 10:53:12 -05:00
|
|
|
from typing import List
|
|
|
|
from typing import Optional
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
import pytest
|
2024-01-30 10:53:12 -05:00
|
|
|
from test_build_system_helpers import EnvDict
|
|
|
|
from test_build_system_helpers import file_contains
|
|
|
|
from test_build_system_helpers import IdfPyFunc
|
|
|
|
from test_build_system_helpers import run_cmake
|
2023-01-30 04:40:30 -05:00
|
|
|
|
2023-02-23 04:56:06 -05:00
|
|
|
ESP32C3_TARGET = 'esp32c3'
|
|
|
|
ESP32C2_TARGET = 'esp32c2'
|
|
|
|
ESP32S3_TARGET = 'esp32s3'
|
2023-01-30 04:40:30 -05:00
|
|
|
ESP32S2_TARGET = 'esp32s2'
|
|
|
|
ESP32_TARGET = 'esp32'
|
|
|
|
|
|
|
|
|
|
|
|
def clean_app(test_app_copy: Path) -> None:
|
|
|
|
shutil.rmtree(test_app_copy / 'build')
|
|
|
|
(test_app_copy / 'sdkconfig').unlink()
|
|
|
|
|
|
|
|
|
|
|
|
@pytest.mark.usefixtures('test_app_copy')
|
|
|
|
def test_target_from_environment_cmake(default_idf_env: EnvDict) -> None:
|
|
|
|
logging.info('Can override IDF_TARGET from environment')
|
|
|
|
env = default_idf_env
|
|
|
|
env.update({'IDF_TARGET': ESP32S2_TARGET})
|
|
|
|
run_cmake('-G', 'Ninja', '..', env=env)
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S2_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
|
|
|
|
def test_target_from_environment_idf_py(idf_py: IdfPyFunc, default_idf_env: EnvDict, test_app_copy: Path) -> None:
|
2023-03-04 04:39:32 -05:00
|
|
|
def reconfigure_and_check_return_values(errmsg: str, opts: Optional[List[str]] = None) -> None:
|
|
|
|
opts = opts or []
|
|
|
|
ret = idf_py(*opts, 'reconfigure', check=False)
|
2023-01-30 04:40:30 -05:00
|
|
|
assert ret.returncode == 2
|
|
|
|
assert errmsg in ret.stderr
|
|
|
|
|
|
|
|
idf_py('set-target', ESP32S2_TARGET)
|
|
|
|
default_idf_env.update({'IDF_TARGET': ESP32_TARGET})
|
|
|
|
|
2024-01-30 10:53:12 -05:00
|
|
|
cfg_path = (test_app_copy / 'sdkconfig').as_posix()
|
2023-02-23 04:56:06 -05:00
|
|
|
|
2023-01-30 04:40:30 -05:00
|
|
|
logging.info("idf.py fails if IDF_TARGET settings don't match the environment")
|
2023-02-23 04:56:06 -05:00
|
|
|
reconfigure_and_check_return_values("Project sdkconfig '{}' was generated for target '{}', but environment "
|
|
|
|
"variable IDF_TARGET is set to '{}'.".format(cfg_path, ESP32S2_TARGET,
|
|
|
|
ESP32_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
logging.info("idf.py fails if IDF_TARGET settings in CMakeCache.txt don't match the environment")
|
|
|
|
(test_app_copy / 'sdkconfig').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32_TARGET))
|
|
|
|
reconfigure_and_check_return_values("Target settings are not consistent: '{}' in the environment, "
|
|
|
|
"'{}' in CMakeCache.txt.".format(ESP32_TARGET, ESP32S2_TARGET))
|
|
|
|
|
|
|
|
logging.info("idf.py fails if IDF_TARGET settings in CMakeCache.txt don't match the sdkconfig")
|
|
|
|
default_idf_env.pop('IDF_TARGET')
|
2023-02-23 04:56:06 -05:00
|
|
|
reconfigure_and_check_return_values("Project sdkconfig '{}' was generated for target '{}', but CMakeCache.txt "
|
|
|
|
"contains '{}'.".format(cfg_path, ESP32_TARGET, ESP32S2_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
2023-03-04 04:39:32 -05:00
|
|
|
logging.info('idf.py fails if IDF_TARGET is set differently in environment and with -D option')
|
|
|
|
(test_app_copy / 'sdkconfig').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
default_idf_env.update({'IDF_TARGET': ESP32S2_TARGET})
|
|
|
|
reconfigure_and_check_return_values("Target '{}' specified on command line is not consistent with target '{}' "
|
|
|
|
'in the environment.'.format(ESP32_TARGET, ESP32S2_TARGET),
|
|
|
|
['-D', 'IDF_TARGET={}'.format(ESP32_TARGET)])
|
|
|
|
|
|
|
|
logging.info('idf.py fails if IDF_TARGET is set differently in CMakeCache.txt and with -D option')
|
|
|
|
default_idf_env.pop('IDF_TARGET')
|
|
|
|
reconfigure_and_check_return_values("Target '{}' specified on command line is not consistent with "
|
|
|
|
"target '{}' in CMakeCache.txt.".format(ESP32_TARGET, ESP32S2_TARGET),
|
|
|
|
['-D', 'IDF_TARGET={}'.format(ESP32_TARGET)])
|
|
|
|
|
2023-01-30 04:40:30 -05:00
|
|
|
|
2023-02-28 12:15:12 -05:00
|
|
|
def test_target_consistency_cmake(default_idf_env: EnvDict, test_app_copy: Path) -> None:
|
|
|
|
def reconfigure_and_check_return_values(errmsg: str, opts: Optional[List[str]] = None) -> None:
|
|
|
|
opts = opts or []
|
|
|
|
ret = run_cmake(*opts, '-G', 'Ninja', '..', env=default_idf_env, check=False)
|
|
|
|
assert ret.returncode == 1
|
|
|
|
assert errmsg in ret.stderr
|
|
|
|
|
|
|
|
run_cmake('-G', 'Ninja', '..')
|
|
|
|
|
2024-01-30 10:53:12 -05:00
|
|
|
cfg_path = (test_app_copy / 'sdkconfig').as_posix()
|
2023-02-28 12:15:12 -05:00
|
|
|
|
|
|
|
logging.info("cmake fails if IDF_TARGET settings don't match the environment")
|
|
|
|
default_idf_env.update({'IDF_TARGET': ESP32S2_TARGET})
|
|
|
|
reconfigure_and_check_return_values(f"IDF_TARGET '{ESP32_TARGET}' in CMake cache does not "
|
|
|
|
f"match currently selected IDF_TARGET '{ESP32S2_TARGET}'")
|
|
|
|
|
|
|
|
logging.info("cmake fails if IDF_TARGET settings don't match the sdkconfig")
|
|
|
|
default_idf_env.pop('IDF_TARGET')
|
|
|
|
(test_app_copy / 'sdkconfig').write_text(f'CONFIG_IDF_TARGET="{ESP32S2_TARGET}"')
|
|
|
|
reconfigure_and_check_return_values(f"Target '{ESP32S2_TARGET}' in sdkconfig '{cfg_path}' does not "
|
|
|
|
f"match currently selected IDF_TARGET '{ESP32_TARGET}'.")
|
|
|
|
|
|
|
|
logging.info("cmake fails if IDF_TOOLCHAIN settings don't match the environment")
|
|
|
|
(test_app_copy / 'sdkconfig').write_text(f'CONFIG_IDF_TARGET="{ESP32_TARGET}"')
|
|
|
|
default_idf_env.update({'IDF_TOOLCHAIN': 'clang'})
|
|
|
|
reconfigure_and_check_return_values("IDF_TOOLCHAIN 'gcc' in CMake cache does not match "
|
|
|
|
"currently selected IDF_TOOLCHAIN 'clang'")
|
|
|
|
|
|
|
|
logging.info("cmake fails if IDF_TARGET settings don't match CMAKE_TOOLCHAIN_FILE")
|
|
|
|
default_idf_env.pop('IDF_TOOLCHAIN')
|
|
|
|
reconfigure_and_check_return_values("CMAKE_TOOLCHAIN_FILE 'toolchain-esp32' does not "
|
|
|
|
f"match currently selected IDF_TARGET '{ESP32S2_TARGET}'",
|
|
|
|
['-D', f'IDF_TARGET={ESP32S2_TARGET}',
|
|
|
|
'-D', 'SDKCONFIG=custom_sdkconfig'])
|
|
|
|
|
|
|
|
|
2023-01-30 04:40:30 -05:00
|
|
|
def test_target_precedence(idf_py: IdfPyFunc, default_idf_env: EnvDict, test_app_copy: Path) -> None:
|
|
|
|
logging.info('IDF_TARGET takes precedence over the value of CONFIG_IDF_TARGET in sdkconfig.defaults')
|
|
|
|
(test_app_copy / 'sdkconfig.defaults').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
default_idf_env.update({'IDF_TARGET': ESP32_TARGET})
|
|
|
|
idf_py('reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32_TARGET))
|
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET_{}=y'.format(ESP32_TARGET.upper()))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
|
|
|
|
def test_target_using_D_parameter(idf_py: IdfPyFunc, test_app_copy: Path) -> None:
|
|
|
|
logging.info('Can set target using idf.py -D')
|
|
|
|
idf_py('-DIDF_TARGET={}'.format(ESP32S2_TARGET), 'reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S2_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
logging.info('Can set target using -D as subcommand parameter for idf.py')
|
|
|
|
clean_app(test_app_copy)
|
|
|
|
idf_py('reconfigure', '-DIDF_TARGET={}'.format(ESP32S2_TARGET))
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S2_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
|
|
|
|
@pytest.mark.usefixtures('test_app_copy')
|
|
|
|
def test_target_using_settarget_parameter_alternative_name(idf_py: IdfPyFunc) -> None:
|
|
|
|
logging.info('idf.py understands alternative target names')
|
|
|
|
idf_py('set-target', ESP32S2_TARGET.upper())
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S2_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
|
|
|
|
@pytest.mark.usefixtures('test_app_copy')
|
2023-03-28 05:18:04 -04:00
|
|
|
def test_target_using_settarget_parameter(idf_py: IdfPyFunc, default_idf_env: EnvDict) -> None:
|
2023-01-30 04:40:30 -05:00
|
|
|
logging.info('Can set target using idf.py set-target')
|
|
|
|
idf_py('set-target', ESP32S2_TARGET)
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S2_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
logging.info('Can guess target from sdkconfig, if CMakeCache does not exist')
|
|
|
|
idf_py('fullclean')
|
|
|
|
idf_py('reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S2_TARGET))
|
2023-01-30 04:40:30 -05:00
|
|
|
|
2023-03-28 05:18:04 -04:00
|
|
|
logging.info('Can set target if IDF_TARGET env is set and old sdkconfig exists')
|
|
|
|
default_idf_env.update({'IDF_TARGET': ESP32_TARGET})
|
|
|
|
idf_py('set-target', ESP32_TARGET)
|
|
|
|
default_idf_env.pop('IDF_TARGET')
|
2023-04-06 22:42:12 -04:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32_TARGET))
|
2023-03-28 05:18:04 -04:00
|
|
|
|
2023-01-30 04:40:30 -05:00
|
|
|
|
|
|
|
def test_target_using_sdkconfig(idf_py: IdfPyFunc, test_app_copy: Path) -> None:
|
|
|
|
logging.info('Can set the default target using sdkconfig.defaults')
|
|
|
|
(test_app_copy / 'sdkconfig.defaults').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
idf_py('reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET_{}=y'.format(ESP32S2_TARGET.upper()))
|
2023-02-23 04:56:06 -05:00
|
|
|
|
|
|
|
|
|
|
|
def test_target_guessing(idf_py: IdfPyFunc, test_app_copy: Path, default_idf_env: EnvDict) -> None:
|
|
|
|
"""
|
|
|
|
Tests are performed from the lowest to the highest priority, while
|
|
|
|
configs, except from the sdkconfig, and parameters of previous tests are
|
|
|
|
preserved.
|
|
|
|
"""
|
|
|
|
|
|
|
|
logging.info('Can guess target from sdkconfig.defaults')
|
|
|
|
(test_app_copy / 'sdkconfig.defaults').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32_TARGET))
|
|
|
|
idf_py('reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32_TARGET))
|
2023-02-23 04:56:06 -05:00
|
|
|
|
|
|
|
logging.info('Can guess target from SDKCONFIG_DEFAULTS environment variable')
|
|
|
|
(test_app_copy / 'sdkconfig1').write_text('NOTHING HERE')
|
|
|
|
(test_app_copy / 'sdkconfig2').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
clean_app(test_app_copy)
|
|
|
|
default_idf_env.update({'SDKCONFIG_DEFAULTS': 'sdkconfig1;sdkconfig2'})
|
|
|
|
idf_py('reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S2_TARGET))
|
2023-02-23 04:56:06 -05:00
|
|
|
|
|
|
|
logging.info('Can guess target from SDKCONFIG_DEFAULTS using -D')
|
|
|
|
(test_app_copy / 'sdkconfig3').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32S2_TARGET))
|
|
|
|
(test_app_copy / 'sdkconfig4').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32S3_TARGET))
|
|
|
|
clean_app(test_app_copy)
|
|
|
|
idf_py('-D', 'SDKCONFIG_DEFAULTS=sdkconfig4;sdkconfig3', 'reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig', 'CONFIG_IDF_TARGET="{}"'.format(ESP32S3_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32S3_TARGET))
|
2023-02-23 04:56:06 -05:00
|
|
|
|
|
|
|
logging.info('Can guess target from custom sdkconfig')
|
|
|
|
(test_app_copy / 'sdkconfig5').write_text('CONFIG_IDF_TARGET="{}"'.format(ESP32C3_TARGET))
|
|
|
|
clean_app(test_app_copy)
|
|
|
|
idf_py('-D', 'SDKCONFIG=sdkconfig5', '-D', 'SDKCONFIG_DEFAULTS=sdkconfig4;sdkconfig3', 'reconfigure')
|
2023-02-08 13:27:01 -05:00
|
|
|
assert file_contains('sdkconfig5', 'CONFIG_IDF_TARGET="{}"'.format(ESP32C3_TARGET))
|
|
|
|
assert file_contains('build/CMakeCache.txt', 'IDF_TARGET:STRING={}'.format(ESP32C3_TARGET))
|