Blame view

RIOT/cpu/sam0_common/include/cmsis/samd21/README.md 1.77 KB
fb11e647   vrobic   reseau statique a...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
  # CMSIS from Atmel Software Foundation (ASF)
  
  The include files in the directory tree are copied from ASF.  See
  https://spaces.atmel.com/gf/project/asf/frs/?action=FrsReleaseBrowse&frs_package_id=4
  (dd. 2016-07-15 ASF version 3.30 was used)
  
  The directory tree was copied "as is" and its structure is as follows:
  
      cmsis
      └── samd21
          ├── include
          │   ├── component
          │   ├── instance
          │   └── pio
          └── source
              ├── gcc
              └── iar
  
  There is only one include file (per CPU variant) that should be included in
  the source code.  For SAMD21 that is cmsis/samd21/include/samd21.h.  But
  that will only work if the proper define is set.  The define is named after
  the variant, for example `__SAMD21J18A__`.  This define must be set in the
  `Makefile.include` of the board.
  
  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.
  
  ## Trailing White Space
  
  Because of the whitespace check (dist/tools/whitespacecheck/check.sh) all
  the trailing white space had to be removed.  Please take this into account
  when comparing to the original ASF distribution.
  
      find include/ -name '*.h' -exec sed -i 's/\s*$//' '{}' +
  
  ## LITTLE_ENDIAN
  
  These include files define `LITTLE_ENDIAN`.  But we think this is wrong.  It
  seems more logical to let the compiler decide in which mode the ARM code is
  to be translated.  In include/machine/endian.h there is already a define of
  `LITTLE_ENDIAN` (and `BIG_ENDIAN`) for a different purpose.
  
  So, we decided to remove the define from the ASF CMSIS files.  The command
  for it (running from this directory) is:
  
      find include/ -name '*.h' -exec sed -i '/^#define\s\s*LITTLE_ENDIAN/d' '{}' +