picolibrary-microchip-sam-d21da1

Usage

Table of Contents

1. Dependency
   1. Configuration Options
   2. picolibrary Configuration Requirements
   3. picolibrary-arm-cortex-m0plus Configuration Requirements
2. Development

Dependency

To use picolibrary-microchip-sam-d21da1 as a dependency, simply add the subdirectory containing the repository to a CMake build, and link with the picolibrary-microchip-sam-d21da1 static library.

add_subdirectory( picolibrary-microchip-sam-d21da1 )

target_link_libraries(
    foo
    picolibrary-microchip-sam-d21da1
)

The picolibrary-microchip-sam-d21da1 static library does not include ::picolibrary::Microchip::SAM::D21DA1::version(). To use ::picolibrary::Microchip::SAM::D21DA1::version(), link with the picolibrary-microchip-sam-d21da1-version static library.

target_link_libraries(
    foo
    picolibrary-microchip-sam-d21da1
    picolibrary-microchip-sam-d21da1-version
)

The picolibrary-microchip-sam-d21da1 static library does not include the default interrupt vector table instance and associated interrupt handler functions. To use the default interrupt vector table instance and associated interrupt handler functions, include the picolibrary-microchip-sam-d21da1-interrupt-default_vector_table object library object in an executable’s sources list.

add_executable(
    foo
    $<TARGET_OBJECTS:picolibrary-microchip-sam-d21da1-interrupt-default_vector_table>
)

Configuration Options

picolibrary-microchip-sam-d21da1 supports the following project configuration options:

• PICOLIBRARY_MICROCHIP_SAM_D21DA1_ENABLE_INTERACTIVE_TESTING (defaults to OFF): enable interactive testing
• PICOLIBRARY_MICROCHIP_SAM_D21DA1_USE_PARENT_PROJECT_PICOLIBRARY_ARM_CORTEX_M0PLUS (defaults to ON): use parent project’s picolibrary-arm-cortex-m0plus

picolibrary Configuration Requirements

If PICOLIBRARY_MICROCHIP_SAM_D21DA1_USE_PARENT_PROJECT_PICOLIBRARY_ARM_CORTEX_M0PLUS is ON, picolibrary must be configured as follows:

• PICOLIBRARY_ENABLE_AUTOMATED_TESTING must be OFF
• PICOLIBRARY_ENABLE_INTERACTIVE_TESTING must be ON if PICOLIBRARY_MICROCHIP_SAM_D21DA1_ENABLE_INTERACTIVE_TESTING is ON

picolibrary-arm-cortex-m0plus Configuration Requirements

If PICOLIBRARY_MICROCHIP_SAM_D21DA1_USE_PARENT_PROJECT_PICOLIBRARY_ARM_CORTEX_M0PLUS is ON, picolibrary-arm-cortex-m0plus must be configured as follows:

• PICOLIBRARY_ARM_CORTEX_M0PLUS_IMPLEMENTATION_INCLUDE_DIR must be set to the path to picolibrary-microchip-sam-d21da1’s include/ directory

Development

The repository’s Git pre-commit hook script is the simplest way to configure, and build picolibrary-microchip-sam-d21da1 during development. See the pre-commit script’s help text for usage details.

./git/hooks/pre-commit --help

Additional checks, such as static analysis, are performed by the repository’s GitHub Actions CI workflow.

This site is open source. Improve this page.