Go to file
Gerson Fernando Budke d6221e73d7 asf: CMakeLists.txt: Use new family prefix
The newer HWMv2 impose a different semantic in the family names. This
update from SOC_FAMILY_SAMx to SOC_FAMILY_ATMEL_SAMx to comply with.

Signed-off-by: Gerson Fernando Budke <nandojve@gmail.com>
2024-02-21 12:45:09 +01:00
.github pinctrl: Add wake-up sources generation 2023-10-23 19:06:43 +02:00
asf asf: CMakeLists.txt: Use new family prefix 2024-02-21 12:45:09 +01:00
include/dt-bindings/pinctrl pinctrl: SAMx7x: Fix incorrect pinctrl config for pa21 2023-12-19 07:54:03 +01:00
pinconfigs pinctrl: SAMx7x: Fix incorrect pinctrl config for pa21 2023-12-19 07:54:03 +01:00
scripts pinctrl: Add wake-up sources generation 2023-10-23 19:06:43 +02:00
zephyr pinctrl: Add pinctrl script 2022-03-24 14:11:18 -03:00
.gitignore pinctrl: Add pinctrl tests 2022-03-24 14:11:18 -03:00
CMakeLists.txt CMakeLists.txt: Add include directory only for atmel devices 2022-07-05 12:11:53 -05:00
README.md docs: Improve documentation 2023-03-18 08:41:41 -03:00

README.md

Introduction

The hal_atmel is a set of register definitions for Atmel SAM/SAM0 SoC's. The HAL is organized following the directory structure detailed below.

Directory Structure

The directory is composed by six parts:

.
├── asf
├── include
├── pinconfigs
├── README.md
├── scripts
└── zephyr
  • Atmel Software Framework SoC specific include libraries.
  • Includes specific for these platforms
    • devicetree bindings
  • Pin definitions
  • Scripts used for code generation
  • ZephyrRTOS module directory (zephyr).
  • This README file.

How to submit code

Any contribution should follow the How to submit code using as premisses the Zephyr Contribution Guidelines. For more information about External Modules see Modules Section in special Submitting Changes to Modules

Repository specific guidelines

  • When submitting an updated firmware library version, it is important to make sure that the last firmware version will be merged. The library version is used to be checked at Atmel packs download site.
  • When submitting an updated firmware library version the patchset already applied should be rebased on top of the newer version.
  • The patchset must be sent as an individual commit per SoC series to easy rebase.
  • This repository is managed mainly on Linux. This means that changes should be submitted using Linux LF format. Usually running a similar command to find * type f -print0 | xargs -0 dos2unix -k should be enough.
  • Make sure directory structure is respected.
  • The asf/[sam|sam0]/include/<soc>/README file should be updated accordingly. If for some reason the file not exists it should be created.
  • Directory names should be converted to lowercase.
  • The recommendation is add all fixups in the hal_atmel instead on the ZephyrRTOS project.

The above are general guidelines and exceptions could happen. In this case, the exception should be addressed at review phase.

The standard API

The SAM/SAM0 standard API define all information to access Atmel SoC's peripherals. This library does not have namespaces and prefixes which easily results in name collision with ZephyrRTOS core and libraries. To avoid that situation, macros, enum values and function names should follow two general rules:

  • Public API functions must be prefixed with sam_ or sam0_.
  • Public defines and enum values must be uppercase and prefixed with SAM_ or SAM0_.