You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
242 lines
8.1 KiB
242 lines
8.1 KiB
5 years ago
|
# Copyright (c) 2014-present PlatformIO <contact@platformio.org>
|
||
|
|
#
|
||
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
||
|
|
# you may not use this file except in compliance with the License.
|
||
|
|
# You may obtain a copy of the License at
|
||
|
|
#
|
||
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
||
|
|
#
|
||
|
|
# Unless required by applicable law or agreed to in writing, software
|
||
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
||
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
|
|
# See the License for the specific language governing permissions and
|
||
|
|
# limitations under the License.
|
||
|
|
|
||
|
|
from __future__ import absolute_import
|
||
|
|
|
||
|
|
import sys
|
||
|
|
from os.path import isdir, isfile, join
|
||
|
|
|
||
|
|
from SCons.Script import ARGUMENTS # pylint: disable=import-error
|
||
|
|
from SCons.Script import COMMAND_LINE_TARGETS # pylint: disable=import-error
|
||
|
|
|
||
|
|
from platformio import exception, fs, util
|
||
|
|
from platformio.compat import WINDOWS
|
||
|
|
from platformio.managers.platform import PlatformFactory
|
||
|
|
from platformio.project.config import ProjectOptions
|
||
|
|
|
||
|
|
# pylint: disable=too-many-branches, too-many-locals
|
||
|
|
|
||
|
|
|
||
|
|
@util.memoized()
|
||
|
|
def PioPlatform(env):
|
||
|
|
variables = env.GetProjectOptions(as_dict=True)
|
||
|
|
if "framework" in variables:
|
||
|
|
# support PIO Core 3.0 dev/platforms
|
||
|
|
variables["pioframework"] = variables["framework"]
|
||
|
|
p = PlatformFactory.newPlatform(env["PLATFORM_MANIFEST"])
|
||
|
|
p.configure_default_packages(variables, COMMAND_LINE_TARGETS)
|
||
|
|
return p
|
||
|
|
|
||
|
|
|
||
|
|
def BoardConfig(env, board=None):
|
||
|
|
with fs.cd(env.subst("$PROJECT_DIR")):
|
||
|
|
try:
|
||
|
|
p = env.PioPlatform()
|
||
|
|
board = board or env.get("BOARD")
|
||
|
|
assert board, "BoardConfig: Board is not defined"
|
||
|
|
return p.board_config(board)
|
||
|
|
except (AssertionError, exception.UnknownBoard) as e:
|
||
|
|
sys.stderr.write("Error: %s\n" % str(e))
|
||
|
|
env.Exit(1)
|
||
|
|
|
||
|
|
|
||
|
|
def GetFrameworkScript(env, framework):
|
||
|
|
p = env.PioPlatform()
|
||
|
|
assert p.frameworks and framework in p.frameworks
|
||
|
|
script_path = env.subst(p.frameworks[framework]["script"])
|
||
|
|
if not isfile(script_path):
|
||
|
|
script_path = join(p.get_dir(), script_path)
|
||
|
|
return script_path
|
||
|
|
|
||
|
|
|
||
|
|
def LoadPioPlatform(env):
|
||
|
|
p = env.PioPlatform()
|
||
|
|
installed_packages = p.get_installed_packages()
|
||
|
|
|
||
|
|
# Ensure real platform name
|
||
|
|
env["PIOPLATFORM"] = p.name
|
||
|
|
|
||
|
|
# Add toolchains and uploaders to $PATH and $*_LIBRARY_PATH
|
||
|
|
systype = util.get_systype()
|
||
|
|
for name in installed_packages:
|
||
|
|
type_ = p.get_package_type(name)
|
||
|
|
if type_ not in ("toolchain", "uploader", "debugger"):
|
||
|
|
continue
|
||
|
|
pkg_dir = p.get_package_dir(name)
|
||
|
|
env.PrependENVPath(
|
||
|
|
"PATH", join(pkg_dir, "bin") if isdir(join(pkg_dir, "bin")) else pkg_dir
|
||
|
|
)
|
||
|
|
if not WINDOWS and isdir(join(pkg_dir, "lib")) and type_ != "toolchain":
|
||
|
|
env.PrependENVPath(
|
||
|
|
"DYLD_LIBRARY_PATH" if "darwin" in systype else "LD_LIBRARY_PATH",
|
||
|
|
join(pkg_dir, "lib"),
|
||
|
|
)
|
||
|
|
|
||
|
|
# Platform specific LD Scripts
|
||
|
|
if isdir(join(p.get_dir(), "ldscripts")):
|
||
|
|
env.Prepend(LIBPATH=[join(p.get_dir(), "ldscripts")])
|
||
|
|
|
||
|
|
if "BOARD" not in env:
|
||
|
|
return
|
||
|
|
|
||
|
|
# update board manifest with overridden data from INI config
|
||
|
|
board_config = env.BoardConfig()
|
||
|
|
for option, value in env.GetProjectOptions():
|
||
|
|
if not option.startswith("board_"):
|
||
|
|
continue
|
||
|
|
option = option.lower()[6:]
|
||
|
|
try:
|
||
|
|
if isinstance(board_config.get(option), bool):
|
||
|
|
value = str(value).lower() in ("1", "yes", "true")
|
||
|
|
elif isinstance(board_config.get(option), int):
|
||
|
|
value = int(value)
|
||
|
|
except KeyError:
|
||
|
|
pass
|
||
|
|
board_config.update(option, value)
|
||
|
|
|
||
|
|
# load default variables from board config
|
||
|
|
for option_meta in ProjectOptions.values():
|
||
|
|
if not option_meta.buildenvvar or option_meta.buildenvvar in env:
|
||
|
|
continue
|
||
|
|
data_path = (
|
||
|
|
option_meta.name[6:]
|
||
|
|
if option_meta.name.startswith("board_")
|
||
|
|
else option_meta.name.replace("_", ".")
|
||
|
|
)
|
||
|
|
try:
|
||
|
|
env[option_meta.buildenvvar] = board_config.get(data_path)
|
||
|
|
except KeyError:
|
||
|
|
pass
|
||
|
|
|
||
|
|
if "build.ldscript" in board_config:
|
||
|
|
env.Replace(LDSCRIPT_PATH=board_config.get("build.ldscript"))
|
||
|
|
|
||
|
|
|
||
|
|
def PrintConfiguration(env): # pylint: disable=too-many-statements
|
||
|
|
platform = env.PioPlatform()
|
||
|
|
board_config = env.BoardConfig() if "BOARD" in env else None
|
||
|
|
|
||
|
|
def _get_configuration_data():
|
||
|
|
return (
|
||
|
|
None
|
||
|
|
if not board_config
|
||
|
|
else [
|
||
|
|
"CONFIGURATION:",
|
||
|
|
"https://docs.platformio.org/page/boards/%s/%s.html"
|
||
|
|
% (platform.name, board_config.id),
|
||
|
|
]
|
||
|
|
)
|
||
|
|
|
||
|
|
def _get_plaform_data():
|
||
|
|
data = ["PLATFORM: %s %s" % (platform.title, platform.version)]
|
||
|
|
src_manifest_path = platform.pm.get_src_manifest_path(platform.get_dir())
|
||
|
|
if src_manifest_path:
|
||
|
|
src_manifest = fs.load_json(src_manifest_path)
|
||
|
|
if "version" in src_manifest:
|
||
|
|
data.append("#" + src_manifest["version"])
|
||
|
|
if int(ARGUMENTS.get("PIOVERBOSE", 0)):
|
||
|
|
data.append("(%s)" % src_manifest["url"])
|
||
|
|
if board_config:
|
||
|
|
data.extend([">", board_config.get("name")])
|
||
|
|
return data
|
||
|
|
|
||
|
|
def _get_hardware_data():
|
||
|
|
data = ["HARDWARE:"]
|
||
|
|
mcu = env.subst("$BOARD_MCU")
|
||
|
|
f_cpu = env.subst("$BOARD_F_CPU")
|
||
|
|
if mcu:
|
||
|
|
data.append(mcu.upper())
|
||
|
|
if f_cpu:
|
||
|
|
f_cpu = int("".join([c for c in str(f_cpu) if c.isdigit()]))
|
||
|
|
data.append("%dMHz," % (f_cpu / 1000000))
|
||
|
|
if not board_config:
|
||
|
|
return data
|
||
|
|
ram = board_config.get("upload", {}).get("maximum_ram_size")
|
||
|
|
flash = board_config.get("upload", {}).get("maximum_size")
|
||
|
|
data.append(
|
||
|
|
"%s RAM, %s Flash" % (fs.format_filesize(ram), fs.format_filesize(flash))
|
||
|
|
)
|
||
|
|
return data
|
||
|
|
|
||
|
|
def _get_debug_data():
|
||
|
|
debug_tools = (
|
||
|
|
board_config.get("debug", {}).get("tools") if board_config else None
|
||
|
|
)
|
||
|
|
if not debug_tools:
|
||
|
|
return None
|
||
|
|
data = [
|
||
|
|
"DEBUG:",
|
||
|
|
"Current",
|
||
|
|
"(%s)"
|
||
|
|
% board_config.get_debug_tool_name(env.GetProjectOption("debug_tool")),
|
||
|
|
]
|
||
|
|
onboard = []
|
||
|
|
external = []
|
||
|
|
for key, value in debug_tools.items():
|
||
|
|
if value.get("onboard"):
|
||
|
|
onboard.append(key)
|
||
|
|
else:
|
||
|
|
external.append(key)
|
||
|
|
if onboard:
|
||
|
|
data.extend(["On-board", "(%s)" % ", ".join(sorted(onboard))])
|
||
|
|
if external:
|
||
|
|
data.extend(["External", "(%s)" % ", ".join(sorted(external))])
|
||
|
|
return data
|
||
|
|
|
||
|
|
def _get_packages_data():
|
||
|
|
data = []
|
||
|
|
for name, options in platform.packages.items():
|
||
|
|
if options.get("optional"):
|
||
|
|
continue
|
||
|
|
pkg_dir = platform.get_package_dir(name)
|
||
|
|
if not pkg_dir:
|
||
|
|
continue
|
||
|
|
manifest = platform.pm.load_manifest(pkg_dir)
|
||
|
|
original_version = util.get_original_version(manifest["version"])
|
||
|
|
info = "%s %s" % (manifest["name"], manifest["version"])
|
||
|
|
extra = []
|
||
|
|
if original_version:
|
||
|
|
extra.append(original_version)
|
||
|
|
if "__src_url" in manifest and int(ARGUMENTS.get("PIOVERBOSE", 0)):
|
||
|
|
extra.append(manifest["__src_url"])
|
||
|
|
if extra:
|
||
|
|
info += " (%s)" % ", ".join(extra)
|
||
|
|
data.append(info)
|
||
|
|
if not data:
|
||
|
|
return None
|
||
|
|
return ["PACKAGES:"] + ["\n - %s" % d for d in sorted(data)]
|
||
|
|
|
||
|
|
for data in (
|
||
|
|
_get_configuration_data(),
|
||
|
|
_get_plaform_data(),
|
||
|
|
_get_hardware_data(),
|
||
|
|
_get_debug_data(),
|
||
|
|
_get_packages_data(),
|
||
|
|
):
|
||
|
|
if data and len(data) > 1:
|
||
|
|
print(" ".join(data))
|
||
|
|
|
||
|
|
|
||
|
|
def exists(_):
|
||
|
|
return True
|
||
|
|
|
||
|
|
|
||
|
|
def generate(env):
|
||
|
|
env.AddMethod(PioPlatform)
|
||
|
|
env.AddMethod(BoardConfig)
|
||
|
|
env.AddMethod(GetFrameworkScript)
|
||
|
|
env.AddMethod(LoadPioPlatform)
|
||
|
|
env.AddMethod(PrintConfiguration)
|
||
|
|
return env
|