Function create_board

ci/boards.py:1315–1349

(board_name: str, no_project_options: bool = False)

def create_board(board_name: str, no_project_options: bool = False) -> Board:
    board: Board | None = None
    if no_project_options:
        board = Board(board_name=board_name, add_board_to_all=False)
    elif board_name in _BOARD_MAP:
        # Direct match on board_name (primary lookup)
        board = _BOARD_MAP[board_name]
    else:
        # Try reverse lookup by real_board_name (alias support)
        board = None
        for candidate in ALL:
            if candidate.real_board_name == board_name:
                board = candidate
                break

        # Case-insensitive fallback: some boards registered in `_BOARD_MAP`
        # use camelCase (`ATtiny1604`, `ATtiny1616`) while CI workflows and
        # docs frequently spell them lowercase. Resolving by lowercase
        # before falling through to a generic Board avoids
        # `UndefinedEnvPlatformError` at PlatformIO env-resolution time
        # (FastLED #2779).
        if board is None:
            target = board_name.lower()
            for candidate in ALL:
                if candidate.board_name.lower() == target:
                    board = candidate
                    break

        if board is None:
            # No match found - create generic board without special overrides
            # Assume platformio will know what to do with it
            board = Board(board_name=board_name, add_board_to_all=False)

    assert board is not None
    return board.clone()