spec: Add /if/rtems/intr/*

55 files changed, 1014 insertions, 0 deletions

diff --git a/spec/groups/api/classic/intr.yml b/spec/groups/api/classic/intr.yml
new file mode 100644
index 00000000..a1449df9
--- /dev/null
+++ b/spec/groups/api/classic/intr.yml
@@ -0,0 +1,22 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: API
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+description: |
+  Any real-time executive must provide a mechanism for quick response to
+  externally generated interrupts to satisfy the critical time constraints of
+  the application.  The Interrupt Manager provides this mechanism for RTEMS.
+  This manager permits quick interrupt response times by providing the critical
+  ability to alter task execution which allows a task to be preempted upon exit
+  from an ISR.
+enabled-by: true
+identifier: RTEMSAPIClassicIntr
+interface-type: group
+links:
+- role: interface-placement
+  uid: /if/rtems/intr/header
+- role: interface-ingroup
+  uid: /groups/api/classic
+name: Interrupt Manager
+type: interface
diff --git a/spec/if/impl/cpu/simple-vectored-interrupts.yml b/spec/if/impl/cpu/simple-vectored-interrupts.yml
new file mode 100644
index 00000000..0f428d5b
--- /dev/null
+++ b/spec/if/impl/cpu/simple-vectored-interrupts.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header
+name: CPU_SIMPLE_VECTORED_INTERRUPTS
+type: interface
diff --git a/spec/if/impl/isr/handler-entry.yml b/spec/if/impl/isr/handler-entry.yml
new file mode 100644
index 00000000..bd74e0d6
--- /dev/null
+++ b/spec/if/impl/isr/handler-entry.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header
+name: ISR_Handler_entry
+type: interface
diff --git a/spec/if/impl/isr/handler.yml b/spec/if/impl/isr/handler.yml
new file mode 100644
index 00000000..8f0bd894
--- /dev/null
+++ b/spec/if/impl/isr/handler.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header
+name: ISR_Handler
+type: interface
diff --git a/spec/if/impl/isr/header-2.yml b/spec/if/impl/isr/header-2.yml
new file mode 100644
index 00000000..04b440b2
--- /dev/null
+++ b/spec/if/impl/isr/header-2.yml
@@ -0,0 +1,11 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: header-file
+links:
+- role: interface-placement
+  uid: /if/domains/implementation
+path: rtems/score/isrlevel.h
+prefix: cpukit/include
+type: interface
diff --git a/spec/if/impl/isr/header-3.yml b/spec/if/impl/isr/header-3.yml
new file mode 100644
index 00000000..13d86502
--- /dev/null
+++ b/spec/if/impl/isr/header-3.yml
@@ -0,0 +1,11 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: header-file
+links:
+- role: interface-placement
+  uid: /if/domains/implementation
+path: rtems/score/isrlock.h
+prefix: cpukit/include
+type: interface
diff --git a/spec/if/impl/isr/is-in-progress.yml b/spec/if/impl/isr/is-in-progress.yml
new file mode 100644
index 00000000..68d4bd2c
--- /dev/null
+++ b/spec/if/impl/isr/is-in-progress.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header
+name: _ISR_Is_in_progress
+type: interface
diff --git a/spec/if/impl/isr/level.yml b/spec/if/impl/isr/level.yml
new file mode 100644
index 00000000..6db3cbe3
--- /dev/null
+++ b/spec/if/impl/isr/level.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-2
+name: ISR_Level
+type: interface
diff --git a/spec/if/impl/isr/local-disable.yml b/spec/if/impl/isr/local-disable.yml
new file mode 100644
index 00000000..354fcca3
--- /dev/null
+++ b/spec/if/impl/isr/local-disable.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-2
+name: _ISR_Local_disable
+type: interface
diff --git a/spec/if/impl/isr/local-enable.yml b/spec/if/impl/isr/local-enable.yml
new file mode 100644
index 00000000..8870b679
--- /dev/null
+++ b/spec/if/impl/isr/local-enable.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-2
+name: _ISR_Local_enable
+type: interface
diff --git a/spec/if/impl/isr/local-flash.yml b/spec/if/impl/isr/local-flash.yml
new file mode 100644
index 00000000..e6edd923
--- /dev/null
+++ b/spec/if/impl/isr/local-flash.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-2
+name: _ISR_Local_flash
+type: interface
diff --git a/spec/if/impl/isr/lock-context.yml b/spec/if/impl/isr/lock-context.yml
new file mode 100644
index 00000000..32604146
--- /dev/null
+++ b/spec/if/impl/isr/lock-context.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: ISR_lock_Context
+type: interface
diff --git a/spec/if/impl/isr/lock-control.yml b/spec/if/impl/isr/lock-control.yml
new file mode 100644
index 00000000..651ee738
--- /dev/null
+++ b/spec/if/impl/isr/lock-control.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: ISR_lock_Control
+type: interface
diff --git a/spec/if/impl/isr/lock-declare.yml b/spec/if/impl/isr/lock-declare.yml
new file mode 100644
index 00000000..e484371b
--- /dev/null
+++ b/spec/if/impl/isr/lock-declare.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: ISR_LOCK_DECLARE
+type: interface
diff --git a/spec/if/impl/isr/lock-define.yml b/spec/if/impl/isr/lock-define.yml
new file mode 100644
index 00000000..a6f5a357
--- /dev/null
+++ b/spec/if/impl/isr/lock-define.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: ISR_LOCK_DEFINE
+type: interface
diff --git a/spec/if/impl/isr/lock-destroy.yml b/spec/if/impl/isr/lock-destroy.yml
new file mode 100644
index 00000000..9bd28a21
--- /dev/null
+++ b/spec/if/impl/isr/lock-destroy.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: _ISR_lock_Destroy
+type: interface
diff --git a/spec/if/impl/isr/lock-initialize.yml b/spec/if/impl/isr/lock-initialize.yml
new file mode 100644
index 00000000..2fe40328
--- /dev/null
+++ b/spec/if/impl/isr/lock-initialize.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: _ISR_lock_Initialize
+type: interface
diff --git a/spec/if/impl/isr/lock-initializer.yml b/spec/if/impl/isr/lock-initializer.yml
new file mode 100644
index 00000000..b64aa898
--- /dev/null
+++ b/spec/if/impl/isr/lock-initializer.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: ISR_LOCK_INITIALIZER
+type: interface
diff --git a/spec/if/impl/isr/lock-isr-disable-acquire.yml b/spec/if/impl/isr/lock-isr-disable-acquire.yml
new file mode 100644
index 00000000..e5b2a94c
--- /dev/null
+++ b/spec/if/impl/isr/lock-isr-disable-acquire.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: _ISR_lock_ISR_disable_and_acquire
+type: interface
diff --git a/spec/if/impl/isr/lock-isr-disable.yml b/spec/if/impl/isr/lock-isr-disable.yml
new file mode 100644
index 00000000..02612de4
--- /dev/null
+++ b/spec/if/impl/isr/lock-isr-disable.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: _ISR_lock_ISR_disable
+type: interface
diff --git a/spec/if/impl/isr/lock-member.yml b/spec/if/impl/isr/lock-member.yml
new file mode 100644
index 00000000..0fa0619c
--- /dev/null
+++ b/spec/if/impl/isr/lock-member.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: ISR_LOCK_MEMBER
+type: interface
diff --git a/spec/if/impl/isr/lock-reference.yml b/spec/if/impl/isr/lock-reference.yml
new file mode 100644
index 00000000..fa44b8ca
--- /dev/null
+++ b/spec/if/impl/isr/lock-reference.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: ISR_LOCK_REFERENCE
+type: interface
diff --git a/spec/if/impl/isr/lock-release-isr-enable.yml b/spec/if/impl/isr/lock-release-isr-enable.yml
new file mode 100644
index 00000000..bdaa41ac
--- /dev/null
+++ b/spec/if/impl/isr/lock-release-isr-enable.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-3
+name: _ISR_lock_Release_and_ISR_enable
+type: interface
diff --git a/spec/if/impl/isr/vector-number.yml b/spec/if/impl/isr/vector-number.yml
new file mode 100644
index 00000000..e179f936
--- /dev/null
+++ b/spec/if/impl/isr/vector-number.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header
+name: ISR_Vector_number
+type: interface
diff --git a/spec/if/impl/smp/header-2.yml b/spec/if/impl/smp/header-2.yml
new file mode 100644
index 00000000..bca78650
--- /dev/null
+++ b/spec/if/impl/smp/header-2.yml
@@ -0,0 +1,11 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: header-file
+links:
+- role: interface-placement
+  uid: /if/domains/implementation
+path: rtems/score/smplock.h
+prefix: cpukit/include
+type: interface
diff --git a/spec/if/impl/smp/lock-acquire.yml b/spec/if/impl/smp/lock-acquire.yml
new file mode 100644
index 00000000..214f4933
--- /dev/null
+++ b/spec/if/impl/smp/lock-acquire.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-2
+name: _SMP_lock_Acquire
+type: interface
diff --git a/spec/if/impl/smp/lock-release.yml b/spec/if/impl/smp/lock-release.yml
new file mode 100644
index 00000000..edfe9dfe
--- /dev/null
+++ b/spec/if/impl/smp/lock-release.yml
@@ -0,0 +1,10 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: unspecified
+links:
+- role: interface-placement
+  uid: header-2
+name: _SMP_lock_Release
+type: interface
diff --git a/spec/if/rtems/intr/catch.yml b/spec/if/rtems/intr/catch.yml
new file mode 100644
index 00000000..e7626c7e
--- /dev/null
+++ b/spec/if/rtems/intr/catch.yml
@@ -0,0 +1,38 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default:
+    body: null
+    params:
+    - ${isr-entry:/name} ${.:/params[0]/name}
+    - ${vector-number:/name} ${.:/params[1]/name}
+    - ${isr-entry:/name} *${.:/params[2]/name}
+    return: ${../status/code:/name}
+  variants: []
+description: null
+enabled-by: true
+interface-type: function
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_catch
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: new_isr_handler
+- description: '%'
+  dir: null
+  name: vector
+- description: '%'
+  dir: null
+  name: old_isr_handler
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/cause.yml b/spec/if/rtems/intr/cause.yml
new file mode 100644
index 00000000..f1db3f07
--- /dev/null
+++ b/spec/if/rtems/intr/cause.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: '%'
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_cause
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _interrupt_to_cause
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/clear.yml b/spec/if/rtems/intr/clear.yml
new file mode 100644
index 00000000..3d04f960
--- /dev/null
+++ b/spec/if/rtems/intr/clear.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: '%'
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_clear
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _interrupt_to_clear
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/disable.yml b/spec/if/rtems/intr/disable.yml
new file mode 100644
index 00000000..5c49be96
--- /dev/null
+++ b/spec/if/rtems/intr/disable.yml
@@ -0,0 +1,27 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/local-disable:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by:
+  not: RTEMS_SMP
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_disable
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _isr_cookie
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/enable.yml b/spec/if/rtems/intr/enable.yml
new file mode 100644
index 00000000..77301059
--- /dev/null
+++ b/spec/if/rtems/intr/enable.yml
@@ -0,0 +1,27 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/local-enable:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by:
+  not: RTEMS_SMP
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_enable
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _isr_cookie
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/flash.yml b/spec/if/rtems/intr/flash.yml
new file mode 100644
index 00000000..2a39a830
--- /dev/null
+++ b/spec/if/rtems/intr/flash.yml
@@ -0,0 +1,27 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/local-flash:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by:
+  not: RTEMS_SMP
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_flash
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _isr_cookie
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/header.yml b/spec/if/rtems/intr/header.yml
new file mode 100644
index 00000000..04de993a
--- /dev/null
+++ b/spec/if/rtems/intr/header.yml
@@ -0,0 +1,11 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+enabled-by: true
+interface-type: header-file
+links:
+- role: interface-placement
+  uid: /if/domains/api
+path: rtems/rtems/intr.h
+prefix: cpukit/include
+type: interface
diff --git a/spec/if/rtems/intr/is-in-progress.yml b/spec/if/rtems/intr/is-in-progress.yml
new file mode 100644
index 00000000..1346ce47
--- /dev/null
+++ b/spec/if/rtems/intr/is-in-progress.yml
@@ -0,0 +1,23 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/is-in-progress:/name}()
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_is_in_progress
+notes: null
+params: []
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/isr-entry.yml b/spec/if/rtems/intr/isr-entry.yml
new file mode 100644
index 00000000..e329554e
--- /dev/null
+++ b/spec/if/rtems/intr/isr-entry.yml
@@ -0,0 +1,21 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/handler:/name} ${.:/name}
+  variants:
+  - definition: ${/if/impl/isr/handler-entry:/name} ${.:/name}
+    enabled-by: ${/if/impl/cpu/simple-vectored-interrupts:/name} == ${../basedefs/true:/name}
+description: null
+enabled-by: true
+interface-type: typedef
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_isr_entry
+notes: null
+type: interface
diff --git a/spec/if/rtems/intr/isr.yml b/spec/if/rtems/intr/isr.yml
new file mode 100644
index 00000000..90e72976
--- /dev/null
+++ b/spec/if/rtems/intr/isr.yml
@@ -0,0 +1,19 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/handler:/name} ${.:/name}
+  variants: []
+description: null
+enabled-by: true
+interface-type: typedef
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_isr
+notes: null
+type: interface
diff --git a/spec/if/rtems/intr/level.yml b/spec/if/rtems/intr/level.yml
new file mode 100644
index 00000000..4c6c0400
--- /dev/null
+++ b/spec/if/rtems/intr/level.yml
@@ -0,0 +1,19 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/level:/name} ${.:/name}
+  variants: []
+description: null
+enabled-by: true
+interface-type: typedef
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_level
+notes: null
+type: interface
diff --git a/spec/if/rtems/intr/local-disable.yml b/spec/if/rtems/intr/local-disable.yml
new file mode 100644
index 00000000..58fa040a
--- /dev/null
+++ b/spec/if/rtems/intr/local-disable.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/local-disable:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_local_disable
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _isr_cookie
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/local-enable.yml b/spec/if/rtems/intr/local-enable.yml
new file mode 100644
index 00000000..08ef70d9
--- /dev/null
+++ b/spec/if/rtems/intr/local-enable.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/local-enable:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_local_enable
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _isr_cookie
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-acquire-isr.yml b/spec/if/rtems/intr/lock-acquire-isr.yml
new file mode 100644
index 00000000..0b74a23a
--- /dev/null
+++ b/spec/if/rtems/intr/lock-acquire-isr.yml
@@ -0,0 +1,35 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: do { (void) ${.:/params[1]/name}; } while ( 0 )
+  variants:
+  - definition: |
+      ${/if/impl/smp/lock-acquire:/name}(
+        &( ${.:/params[0]/name} )->Lock,
+        &( ${.:/params[1]/name} )->Lock_context
+      )
+    enabled-by: defined(${/if/build-options/smp:/name})
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_acquire_isr
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _lock
+- description: '%'
+  dir: null
+  name: _lock_context
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-acquire.yml b/spec/if/rtems/intr/lock-acquire.yml
new file mode 100644
index 00000000..0b0c4887
--- /dev/null
+++ b/spec/if/rtems/intr/lock-acquire.yml
@@ -0,0 +1,30 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: |
+    ${/if/impl/isr/lock-isr-disable-acquire:/name}( ${.:/params[0]/name}, ${.:/params[1]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_acquire
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _lock
+- description: '%'
+  dir: null
+  name: _lock_context
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-context.yml b/spec/if/rtems/intr/lock-context.yml
new file mode 100644
index 00000000..2c15b0eb
--- /dev/null
+++ b/spec/if/rtems/intr/lock-context.yml
@@ -0,0 +1,19 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/lock-context:/name} ${.:/name}
+  variants: []
+description: null
+enabled-by: true
+interface-type: typedef
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_context
+notes: null
+type: interface
diff --git a/spec/if/rtems/intr/lock-declare.yml b/spec/if/rtems/intr/lock-declare.yml
new file mode 100644
index 00000000..50876df3
--- /dev/null
+++ b/spec/if/rtems/intr/lock-declare.yml
@@ -0,0 +1,30 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: |
+    ${/if/impl/isr/lock-declare:/name}( ${.:/params[0]/name}, ${.:/params[1]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: RTEMS_INTERRUPT_LOCK_DECLARE
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _qualifier
+- description: '%'
+  dir: null
+  name: _designator
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-define.yml b/spec/if/rtems/intr/lock-define.yml
new file mode 100644
index 00000000..bd24ed3b
--- /dev/null
+++ b/spec/if/rtems/intr/lock-define.yml
@@ -0,0 +1,33 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: |
+    ${/if/impl/isr/lock-define:/name}( ${.:/params[0]/name}, ${.:/params[1]/name}, ${.:/params[2]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: RTEMS_INTERRUPT_LOCK_DEFINE
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _qualifier
+- description: '%'
+  dir: null
+  name: _designator
+- description: '%'
+  dir: null
+  name: _name
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-destroy.yml b/spec/if/rtems/intr/lock-destroy.yml
new file mode 100644
index 00000000..79a7005b
--- /dev/null
+++ b/spec/if/rtems/intr/lock-destroy.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/lock-destroy:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_destroy
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _lock
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-initialize.yml b/spec/if/rtems/intr/lock-initialize.yml
new file mode 100644
index 00000000..ae4319c5
--- /dev/null
+++ b/spec/if/rtems/intr/lock-initialize.yml
@@ -0,0 +1,30 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: |
+    ${/if/impl/isr/lock-initialize:/name}( ${.:/params[0]/name}, ${.:/params[1]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_initialize
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _lock
+- description: '%'
+  dir: null
+  name: _name
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-initializer.yml b/spec/if/rtems/intr/lock-initializer.yml
new file mode 100644
index 00000000..0af1b69d
--- /dev/null
+++ b/spec/if/rtems/intr/lock-initializer.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/lock-initializer:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: RTEMS_INTERRUPT_LOCK_INITIALIZER
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _name
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-isr-disable.yml b/spec/if/rtems/intr/lock-isr-disable.yml
new file mode 100644
index 00000000..48c3b5d8
--- /dev/null
+++ b/spec/if/rtems/intr/lock-isr-disable.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/lock-isr-disable:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_interrupt_disable
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _lock_context
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-member.yml b/spec/if/rtems/intr/lock-member.yml
new file mode 100644
index 00000000..fbee3cab
--- /dev/null
+++ b/spec/if/rtems/intr/lock-member.yml
@@ -0,0 +1,26 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/lock-member:/name}( ${.:/params[0]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: RTEMS_INTERRUPT_LOCK_MEMBER
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _designator
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-reference.yml b/spec/if/rtems/intr/lock-reference.yml
new file mode 100644
index 00000000..c2fabb75
--- /dev/null
+++ b/spec/if/rtems/intr/lock-reference.yml
@@ -0,0 +1,29 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/lock-reference:/name}( ${.:/params[0]/name}, ${.:/params[1]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: RTEMS_INTERRUPT_LOCK_REFERENCE
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _designator
+- description: '%'
+  dir: null
+  name: _target
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-release-isr.yml b/spec/if/rtems/intr/lock-release-isr.yml
new file mode 100644
index 00000000..02b14f5e
--- /dev/null
+++ b/spec/if/rtems/intr/lock-release-isr.yml
@@ -0,0 +1,35 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: do { (void) ${.:/params[1]/name}; } while ( 0 )
+  variants:
+  - definition: |
+      ${/if/impl/smp/lock-release:/name}(
+        &( ${.:/params[0]/name} )->Lock,
+        &( ${.:/params[1]/name} )->Lock_context
+      )
+    enabled-by: defined(${/if/build-options/smp:/name})
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_release_isr
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _lock
+- description: '%'
+  dir: null
+  name: _lock_context
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock-release.yml b/spec/if/rtems/intr/lock-release.yml
new file mode 100644
index 00000000..190cfee3
--- /dev/null
+++ b/spec/if/rtems/intr/lock-release.yml
@@ -0,0 +1,30 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: |
+    ${/if/impl/isr/lock-release-isr-enable:/name}( ${.:/params[0]/name}, ${.:/params[1]/name} )
+  variants: []
+description: null
+enabled-by: true
+interface-type: macro
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock_release
+notes: null
+params:
+- description: '%'
+  dir: null
+  name: _lock
+- description: '%'
+  dir: null
+  name: _lock_context
+return:
+  return: null
+  return-values: []
+type: interface
diff --git a/spec/if/rtems/intr/lock.yml b/spec/if/rtems/intr/lock.yml
new file mode 100644
index 00000000..7d90b77d
--- /dev/null
+++ b/spec/if/rtems/intr/lock.yml
@@ -0,0 +1,19 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/lock-control:/name} ${.:/name}
+  variants: []
+description: null
+enabled-by: true
+interface-type: typedef
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_interrupt_lock
+notes: null
+type: interface
diff --git a/spec/if/rtems/intr/vector-number.yml b/spec/if/rtems/intr/vector-number.yml
new file mode 100644
index 00000000..5897933f
--- /dev/null
+++ b/spec/if/rtems/intr/vector-number.yml
@@ -0,0 +1,19 @@
+SPDX-License-Identifier: CC-BY-SA-4.0 OR BSD-2-Clause
+brief: '%'
+copyrights:
+- Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
+- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
+definition:
+  default: ${/if/impl/isr/vector-number:/name} ${.:/name}
+  variants: []
+description: null
+enabled-by: true
+interface-type: typedef
+links:
+- role: interface-placement
+  uid: header
+- role: interface-ingroup
+  uid: /groups/api/classic/intr
+name: rtems_vector_number
+notes: null
+type: interface