O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Definir regras CMake

Ver fonte no GitHub

O sistema de compilação CMake depende CMakeLists.txt arquivos que definem as metas de construção. O CMakeLists.txt na raiz do seu repositório é o topo da árvore de construção e é um bom lugar para começar a definir os vários alvos, opções e macros utilizadas no processo de construção.

Os primeiros valores a definir são o nome do projeto e as plataformas suportadas.

Neste exemplo, vamos definir o nome do projeto para ot-efr32 com uma versão do 0.0.1 . Nós também definir uma variável EFR32_PLATFORM_VALUES que é uma lista de efr32 plataformas suportadas pelo ot-efr32 . Para o propósito deste exemplo, nós definimos múltiplas plataformas, mas ter uma plataforma única para o _PLATFORM_VALUES variável é muito bem também.

cmake_minimum_required(VERSION 3.10.2)
project(ot-efr32 VERSION 0.0.1)

set(EFR32_PLATFORM_VALUES
    "efr32mg1"
    "efr32mg12"
    "efr32mg13"
    "efr32mg21"
)

O CMakeLists.txt arquivo inclui um cheque que aborts constrói lançado para as plataformas sem suporte.

set_property(CACHE EFR32_PLATFORM PROPERTY STRINGS ${EFR32_PLATFORM_VALUES})
if(NOT EFR32_PLATFORM IN_LIST EFR32_PLATFORM_VALUES)
    message(FATAL_ERROR "Please select a supported platform: ${EFR32_PLATFORM_VALUES}")
endif()

A variável seguinte, que deve ser definido é OT_PLATFORM_LIB . Esta variável é usada pelos aplicativos de exemplo OpenThread para vincular à sua plataforma.

set(OT_PLATFORM_LIB "openthread-${EFR32_PLATFORM}")

Opções do OpenThread CMake

Vários recursos em OpenThread podem ser habilitados / desabilitados / configurados definindo variáveis ​​CMake.

No ot-efr32 plataforma, um mbedTLS externos biblioteca silabs-mbedtls é usado.

set(OT_BUILTIN_MBEDTLS_MANAGEMENT OFF CACHE BOOL "disable builtin mbedtls management" FORCE)
set(OT_EXTERNAL_MBEDTLS "silabs-mbedtls" CACHE STRING "use silabs mbedtls" FORCE)
set(OT_MBEDTLS ${OT_EXTERNAL_MBEDTLS})

Definir diretórios de saída

O diretório de saída para diferentes arquivos de destino pode ser configurado usando as variáveis ​​abaixo.

set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib)
set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/lib)
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${PROJECT_BINARY_DIR}/bin)

Adicionar OpenThread à árvore de construção

Para incluir o openthread submodule na árvore de construção:

add_subdirectory(openthread)

Passe propriedades de construção para OpenThread

A seção final deste arquivo permite que você defina as propriedades de construção (como definições, opções, e incluem diretórios) que você pode querer adicionar à openthread árvore de construção e suas bibliotecas da plataforma.

Uma maneira conveniente de adicionar essas definições é usando o ot-config -alvo. Esta meta é um alvo falso que é usado exclusivamente para o propósito de configuração definindo e está ligada contra por quase todos os alvos CEfectue em openthread .

# Define config filename macros
target_compile_definitions(ot-config INTERFACE
    OPENTHREAD_CONFIG_FILE="openthread-core-efr32-config.h"
    OPENTHREAD_PROJECT_CORE_CONFIG_FILE="openthread-core-efr32-config.h"
    OPENTHREAD_CORE_CONFIG_PLATFORM_CHECK_FILE="openthread-core-efr32-config-check.h"
)

# Disable -Wshadow and -Wpedantic
target_compile_options(ot-config INTERFACE
    -Wno-shadow
    -Wno-pedantic
)

# Add platform dirs to "include" dirs
target_include_directories(ot-config INTERFACE
    ${PROJECT_SOURCE_DIR}/src/src
    ${PROJECT_SOURCE_DIR}/src/${EFR32_PLATFORM}
    ${PROJECT_SOURCE_DIR}/src/${EFR32_PLATFORM}/crypto
)

Adicionar subdiretórios à árvore de construção

Agora que a configuração de nível superior está definida, é hora de adicionar outros subdiretórios à árvore de construção.

A src pasta é onde o código fonte camada plataforma Abstration está localizado. O third_party pasta contém qualquer código de terceiros.

Se você gostaria de incluir aplicativos de exemplo no repo, crie uma examples de pasta e adicioná-lo à árvore de construção também.

add_subdirectory(src)
add_subdirectory(third_party)

# Optional
add_subdirectory(examples)

A src diretório

Este é o coração do repositório e é onde a camada de abstração da plataforma é implementada. Ele também contém alguns outros arquivos necessários.

src/arm-none-eabi.cmake

Este é um arquivo de conjunto de ferramentas que define algumas variáveis ​​que o CMake usa no processo de construção. Um bom ponto de partida seria copiar o ot-efr32 versão deste arquivo e modificá-lo para caber sua plataforma.

src/CMakeLists.txt

É aqui que você define os arquivos de origem, inclui caminhos e sinalizadores de compilador para sua biblioteca de plataforma. Um bom exemplo desse arquivo para um repositório que suporta apenas uma única plataforma é de ot-cc2538 .

O suporte para várias plataformas em um único repositório é possível e vários repositórios de plataforma podem ser usados ​​como referência. Veja ot-efr32 e ot-nrf528xx .