RIOT-OS/RIOT
RIOT-OS/RIOT
1
0
Fork 0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
Code Releases Activity
0e4252c7f5
RIOT/cpu/sam0_common/include/vendor
History
Benjamin Valentin 3cd119a6e6 cpu/sam0_common: import vendor files for samd51 
Atmel Software Framework (ASF) provides a set of low-level header files
that give access to different hardware peripherals of Atmel's ICs.

Origin: Atmel SAMD51 Series Device Support (1.1.96)
License: Apache-2.0
URL: http://packs.download.atmel.com/Atmel.SAMD51_DFP.1.1.96.atpack
2019-06-06 16:47:11 +02:00
..
samd21/include cpu, sam0_common: update vendor headers 2017-09-20 17:11:54 +02:00
samd51/include cpu/sam0_common: import vendor files for samd51 2019-06-06 16:47:11 +02:00
same54/include cpu/sam0_common: import vendor files for same54 2019-06-06 16:47:11 +02:00
saml10/include cpu/sam0_common: add support for saml10/saml11 2019-01-21 17:06:58 +01:00
saml11/include cpu/sam0_common: add support for saml10/saml11 2019-01-21 17:06:58 +01:00
saml21 cpu, sam0_common: update vendor headers 2017-09-20 17:11:54 +02:00
samr21/include cpu, sam0_common: update vendor headers 2017-09-20 17:11:54 +02:00
samr30 cpu/samr30: add support for samr30g18a 2018-10-01 10:15:08 +02:00
README.md cpu/sam0_common: update README for SAML1x addition 2019-02-01 23:33:31 +01:00
sam0.h cpu/samr30: add support for samr30g18a 2018-10-01 10:15:08 +02:00
sam23.h cpu/sam0_common: add support for saml10/saml11 2019-01-21 17:06:58 +01:00
samd5x.h cpu/sam0_common: import vendor files for samd51 2019-06-06 16:47:11 +02:00

README.md

CMSIS from Atmel Software Foundation (ASF)

The include files in this directory tree are copied from Atmel sources. Most of the sam0 files are from ASF (Atmel Software Foundation, version 3.35.1). The SAMR30 files are from ASF 3.34.2. The SAML10 and SAML11 files are from, so called, atpacks.

The sam0 files

The directory tree was copied "as is" from ASF path sam0/utils/cmsis/ and its structure is as follows:

cmsis
├── samd21
│   ├── include
│   │   ├── component
│   │   ├── instance
│   │   └── pio
│   └── source
│       ├── gcc
│       └── iar
.
.
.
├── samr21
│   ├── include
│   │   ├── component
│   │   ├── instance
│   │   └── pio
.   └── source
.       ├── gcc
.       └── iar

However, as only the header files in include and its subfolders are required, all source folders are removed.

Be aware that if you want to make changes to any file in this tree that the changes will be lost when a new ASF release is going to be used.

sam0.h

A SAM based CPU should include sam0.h in this directory, which will resolve any CPU family specific includes required.

SAML10/SAML11 files

Since 2019 the necessary variant files are available in atpacks at

http://packs.download.atmel.com/

saml10: Atmel.SAML10_DFP.1.0.142.atpack saml11: Atmel.SAML11_DFP.1.0.91.atpack

Each atpack has an include subdirectory with the files we copy into RIOT. The files are copied unmodified.

sam23.h

A SAML1x based CPU should include sam23.h in this directory, which will resolve any CPU family specific includes required.

Usage and porting for SAM based CPUs

If other CPUs are needed, copy the include files from ASF or atpack for the respective CPU family here and adapt sam0.h or sam23.h accordingly.