Fixed file description and applied doxygen style

Removed old style file description and documnetation and apply
doxygen synatx.

Change-Id: I3ac9f06d4f574bf3c79c6f6044cec3a7e2f6e4c8
Signed-off-by: Anas Nashif <anas.nashif@intel.com>
This commit is contained in:
Anas Nashif 2015-12-04 10:09:39 -05:00
commit 275ca60b08
182 changed files with 796 additions and 796 deletions

View file

@ -1,5 +1,3 @@
/* armAtomic.S - ARC atomic operations library */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,11 +14,13 @@
* limitations under the License.
*/
/*
DESCRIPTION
This library provides routines to perform a number of atomic operations
on a memory location: add, subtract, increment, decrement, bitwise OR,
bitwise NOR, bitwise AND, bitwise NAND, set, clear and compare-and-swap.
/**
* @file
* @brief ARC atomic operations library
*
* This library provides routines to perform a number of atomic operations
* on a memory location: add, subtract, increment, decrement, bitwise OR,
* bitwise NOR, bitwise AND, bitwise NAND, set, clear and compare-and-swap.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* cpu_idle.S - CPU power management */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
CPU power management routines.
/**
* @file
* @brief CPU power management
*
* CPU power management routines.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* fast_irq.S - handling of transitions to-and-from fast IRQs (FIRQ) */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,11 +14,13 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module implements the code for handling entry to and exit from Fast IRQs.
See isr_wrapper.S for details.
/**
* @file
* @brief Handling of transitions to-and-from fast IRQs (FIRQ)
*
* This module implements the code for handling entry to and exit from Fast IRQs.
*
* See isr_wrapper.S for details.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* fatal.c - fatal fault handling */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Fatal fault handling
*
* This module implements the routines necessary for handling fatal faults on
* ARCv2 CPUs.
*/

View file

@ -1,5 +1,3 @@
/* fault.c - common fault handler for ARCv2 */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Common fault handler for ARCv2
*
* Common fault handler for ARCv2 processors.
*/

View file

@ -1,5 +1,3 @@
/* fault_s.S - fault handlers for ARCv2 */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Fault handlers for ARCv2
*
* Fault handlers for ARCv2 processors.
*/

View file

@ -1,5 +1,3 @@
/* irq_manage.c - ARCv2 interrupt management */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARCv2 interrupt management
*
*
* Interrupt management:
*

View file

@ -1,5 +1,3 @@
/* isr_wrapper.S - wrapper around ISRs with logic for context switching */
/*
* Copyright (c) 2014-2015 Wind River Systems, Inc.
*
@ -16,11 +14,13 @@
* limitations under the License.
*/
/*
DESCRIPTION
Wrapper installed in vector table for handling dynamic interrupts that accept
a parameter.
/**
* @file
* @brief Wrapper around ISRs with logic for context switching
*
*
* Wrapper installed in vector table for handling dynamic interrupts that accept
* a parameter.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* offsets.c - ARCv2 nano kernel structure member offset definition file */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARCv2 nano kernel structure member offset definition file
*
* This module is responsible for the generation of the absolute symbols whose
* value represents the member offsets for various ARCv2 nanokernel
* structures.

View file

@ -1,5 +1,3 @@
/* prep_c.c - full C support initialization */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Full C support initialization
*
*
* Initialization of full C support: zero the .bss, copy the .data if XIP,
* call _Cstart().

View file

@ -1,5 +1,3 @@
/* regular_irq.S - handling of transitions to-and-from regular IRQs (RIRQ) */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,12 +14,14 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module implements the code for handling entry to and exit from regular
IRQs.
See isr_wrapper.S for details.
/**
* @file
* @brief Handling of transitions to-and-from regular IRQs (RIRQ)
*
* This module implements the code for handling entry to and exit from regular
* IRQs.
*
* See isr_wrapper.S for details.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* reset.S - reset handler */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
Reset handler that prepares the system for running C code.
/**
* @file
* @brief Reset handler
*
* Reset handler that prepares the system for running C code.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* swap.S - thread context switching */
/*
* Copyright (c) 2014-2015 Wind River Systems, Inc.
*
@ -16,12 +14,14 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module implements the routines necessary for thread context switching
on ARCv2 CPUs.
See isr_wrapper.S for details.
/**
* @file
* @brief Thread context switching
*
* This module implements the routines necessary for thread context switching
* on ARCv2 CPUs.
*
* See isr_wrapper.S for details.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* fatal_error.c - ARCv2 system fatal error handler */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARCv2 system fatal error handler
*
* This module provides the _SysFatalErrorHandler() routine for ARCv2 BSPs.
*/

View file

@ -1,5 +1,3 @@
/* thread.c - new thread creation for ARCv2 */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief New thread creation for ARCv2
*
* Core nanokernel fiber related primitives for the ARCv2 processor
* architecture.
*/

View file

@ -1,5 +1,3 @@
/* thread_entry_wrapper.S - wrapper for _thread_entry */
/*
* Copyright (c) 2014-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Wrapper for _thread_entry
*
* Wrapper for _thread_entry routine when called from the initial context.
*/

View file

@ -1,5 +1,3 @@
/* vector_table.c - populated exception vector table */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Populated exception vector table
*
* Vector table with exceptions filled in. The reset vector is the system entry
* point, ie. the first instruction executed.
*

View file

@ -1,5 +1,3 @@
/* nano_private.h - private nanokernel definitions */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Private nanokernel definitions
*
* This file contains private nanokernel structures definitions and various
* other definitions for the ARCv2 processor architecture.
*

View file

@ -1,5 +1,3 @@
/* cache.h - cache helper functions (ARC) */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Cache helper functions (ARC)
*
* This file contains private nanokernel structures definitions and various
* other definitions for the ARCv2 processor architecture.
*/

View file

@ -1,5 +1,3 @@
/* irq.h - interrupt helper functions (ARC) */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Interrupt helper functions (ARC)
*
* This file contains private nanokernel structures definitions and various
* other definitions for the ARCv2 processor architecture.
*/

View file

@ -1,5 +1,3 @@
/* vector_table.h - definitions for the exception vector table */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Definitions for the exception vector table
*
*
* Definitions for the boot vector table.
*

View file

@ -1,5 +1,3 @@
/* board.h - board configuration macros for the generic arc BSP */
/*
* Copyright (c) 2014-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Board configuration macros for the generic arc BSP
*
* This header file is used to specify and describe board-level aspects for the
* generic arc BSP.
*/

View file

@ -1,5 +1,3 @@
/* irq_vector_table.c - IRQ part of vector table for generic arc BSP */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief IRQ part of vector table for generic arc BSP
*
* This file contains the IRQ part of the vector table. It is meant to be used
* for one of two cases:
*

View file

@ -1,5 +1,3 @@
/* linker.cmd - Linker command/script file */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
This is the linker script for both standard images and XIP images.
/**
* @file
* @brief Linker command/script file
*
* This is the linker script for both standard images and XIP images.
*/
/* Flash base address and size */

View file

@ -1,5 +1,3 @@
/* sw_isr_table.c - Software ISR table for generic arc BSP */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Software ISR table for generic arc BSP
*
* This contains the ISR table meant to be used for ISRs that take a parameter.
* It is also used when ISRs are to be connected at runtime, and in this case
* provides a table that is filled with _SpuriousIRQ bindings.

View file

@ -1,5 +1,3 @@
/* system.c - system/hardware module for generic arc BSP */
/*
* Copyright (c) 2014-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief System/hardware module for generic arc BSP
*
* This module provides routines to initialize and support board-level hardware
* for the generic arc platform.
*/

View file

@ -1,5 +1,3 @@
/* armAtomic.S - ARM atomic operations library */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,11 +14,13 @@
* limitations under the License.
*/
/*
DESCRIPTION
This library provides routines to perform a number of atomic operations
on a memory location: add, subtract, increment, decrement, bitwise OR,
bitwise NOR, bitwise AND, bitwise NAND, set, clear and compare-and-swap.
/**
* @file
* @brief ARM atomic operations library
*
* This library provides routines to perform a number of atomic operations
* on a memory location: add, subtract, increment, decrement, bitwise OR,
* bitwise NOR, bitwise AND, bitwise NAND, set, clear and compare-and-swap.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* nmi.c - NMI handler infrastructure */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief NMI handler infrastructure
*
* Provides a boot time handler that simply hangs in a sleep loop, and a run
* time handler that resets the CPU. Also provides a mechanism for hooking a
* custom run time handler.

View file

@ -1,5 +1,3 @@
/* prep_c.c - full C support initialization */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Full C support initialization
*
*
* Initialization of full C support: zero the .bss, copy the .data if XIP,
* call _Cstart().

View file

@ -1,5 +1,3 @@
/* reset_s.S - reset handler */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
Reset handler that prepares the system for running C code.
/**
* @file
* @brief Reset handler
*
* Reset handler that prepares the system for running C code.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* scb.h - ARM CORTEX-M3 System Control Block interface */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM CORTEX-M3 System Control Block interface
*
*
* Most of the SCB interface consists of simple bit-flipping methods, and is
* implemented as inline functions in scb.h. This module thus contains only data

View file

@ -1,5 +1,3 @@
/* scs.c - ARM CORTEX-M Series System Control Space */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM CORTEX-M Series System Control Space
*
* Most of the SCS interface consists of simple bit-flipping methods, and is
* implemented as inline functions in scs.h. This module thus contains only data
* definitions and more complex routines, if needed.

View file

@ -1,5 +1,3 @@
/* ISR table for static ISR declarations for ARM */
/*
* Copyright (c) 2015 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
Software ISR table for ARM
/**
* @file
* @brief ISR table for static ISR declarations for ARM
*
* Software ISR table for ARM
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* vector_table.S - populated vector table in ROM */
/*
* Copyright (c) 2013-2015 Wind River Systems, Inc.
*
@ -16,14 +14,16 @@
* limitations under the License.
*/
/*
DESCRIPTION
Vector table in ROM for starting system. The reset vector is the system entry
point, ie. the first instruction executed.
The table is populated with all the system exception handlers. The NMI vector
must be populated with a valid handler since it can happen at any time. The
rest should not be triggered until the kernel is ready to handle them.
/**
* @file
* @brief Populated vector table in ROM
*
* Vector table in ROM for starting system. The reset vector is the system entry
* point, ie. the first instruction executed.
*
* The table is populated with all the system exception handlers. The NMI vector
* must be populated with a valid handler since it can happen at any time. The
* rest should not be triggered until the kernel is ready to handle them.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* vector_table.h - definitions for the boot vector table */
/*
* Copyright (c) 2013-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Definitions for the boot vector table
*
*
* Definitions for the boot vector table.
*

View file

@ -1,5 +1,3 @@
/* cpu_idle.S - ARM CORTEX-M3 power management */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
DESCRIPTION
/**
* @file
* @brief ARM CORTEX-M3 power management
*
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* exc_exit.S - ARM CORTEX-M3 exception/interrupt exit API */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,12 +14,14 @@
* limitations under the License.
*/
/*
DESCRIPTION
Provides functions for performing kernel handling when exiting exceptions or
interrupts that are installed directly in the vector table (i.e. that are not
wrapped around by _isr_wrapper()).
/**
* @file
* @brief ARM CORTEX-M3 exception/interrupt exit API
*
*
* Provides functions for performing kernel handling when exiting exceptions or
* interrupts that are installed directly in the vector table (i.e. that are not
* wrapped around by _isr_wrapper()).
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* fatal.c - nanokernel fatal error handler for ARM Cortex-M */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Nanokernel fatal error handler for ARM Cortex-M
*
* This module provides the _NanoFatalErrorHandler() routine for ARM Cortex-M.
*/

View file

@ -1,5 +1,3 @@
/* fault.c - common fault handler for ARM Cortex-M */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Common fault handler for ARM Cortex-M
*
* Common fault handler for ARM Cortex-M processors.
*/

View file

@ -1,5 +1,3 @@
/* fault_s.S - fault handlers for ARM Cortex-M */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
Fault handlers for ARM Cortex-M processors.
/**
* @file
* @brief Fault handlers for ARM Cortex-M
*
* Fault handlers for ARM Cortex-M processors.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* fiber_abort.c - ARM Cortex-M fiber_abort() routine */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM Cortex-M fiber_abort() routine
*
* The ARM Cortex-M architecture provides its own fiber_abort() to deal with
* different CPU modes (handler vs thread) when a fiber aborts. When its entry
* point returns or when it aborts itself, the CPU is in thread mode and must

View file

@ -1,5 +1,3 @@
/* gdb_stub.S - extra work performed upon exception entry/exit for GDB */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,15 +14,17 @@
* limitations under the License.
*/
/*
DESCRIPTION
Prep work done when entering exceptions consists of saving the callee-saved
registers before they get used by exception handlers, and recording the fact
that we are running in an exception.
Upon exception exit, it must be recorded that the task is not in an exception
anymore.
/**
* @file
* @brief Extra work performed upon exception entry/exit for GDB
*
*
* Prep work done when entering exceptions consists of saving the callee-saved
* registers before they get used by exception handlers, and recording the fact
* that we are running in an exception.
*
* Upon exception exit, it must be recorded that the task is not in an exception
* anymore.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* gdb_stub_irq_vector_table.c - stubs for IRQ part of vector table */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Stubs for IRQ part of vector table
*
* When GDB is enabled, the static IRQ vector table needs to install the
* _irq_vector_table_entry_with_gdb_stub stub to do some work before calling the
* user-installed ISRs.

View file

@ -1,5 +1,3 @@
/* irq_init.c - ARM Cortex-M interrupt initialization */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM Cortex-M interrupt initialization
*
* The ARM Cortex-M architecture provides its own fiber_abort() to deal with
* different CPU modes (handler vs thread) when a fiber aborts. When its entry
* point returns or when it aborts itself, the CPU is in thread mode and must

View file

@ -1,5 +1,3 @@
/* irq_manage.c - ARM CORTEX-M3 interrupt management */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM CORTEX-M3 interrupt management
*
*
* Interrupt management: enabling/disabling and dynamic ISR
* connecting/replacing. SW_ISR_TABLE_DYNAMIC has to be enabled for

View file

@ -1,5 +1,3 @@
/* isr_wrapper.S - ARM CORTEX-M3 wrapper for ISRs with parameter */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,11 +14,12 @@
* limitations under the License.
*/
/*
DESCRIPTION
Wrapper installed in vector table for handling dynamic interrupts that accept
a parameter.
/**
* @file
* @brief ARM CORTEX-M3 wrapper for ISRs with parameter
*
* Wrapper installed in vector table for handling dynamic interrupts that accept
* a parameter.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* offsets.c - ARM nano kernel structure member offset definition file */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM nano kernel structure member offset definition file
*
* This module is responsible for the generation of the absolute symbols whose
* value represents the member offsets for various ARM nanokernel
* structures.

View file

@ -1,5 +1,3 @@
/* swap.S - thread context switching for ARM Cortex-M */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,10 +14,12 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module implements the routines necessary for thread context switching
on ARM Cortex-M3/M4 CPUs.
/**
* @file
* @brief Thread context switching for ARM Cortex-M
*
* This module implements the routines necessary for thread context switching
* on ARM Cortex-M3/M4 CPUs.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* sysFatalErrorHandler - ARM Cortex-M system fatal error handler */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM Cortex-M system fatal error handler
*
* This module provides the _SysFatalErrorHandler() routine for Cortex-M
* platforms.
*/

View file

@ -1,5 +1,3 @@
/* task_abort.c - ARM Cortex-M _TaskAbort() routine */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM Cortex-M _TaskAbort() routine
*
* The ARM Cortex-M architecture provides its own _TaskAbort() to deal with
* different CPU modes (handler vs thread) when a task aborts. When its entry
* point returns or when it aborts itself, the CPU is in thread mode and must

View file

@ -1,5 +1,3 @@
/* thread.c - new thread creation for ARM Cortex-M */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief New thread creation for ARM Cortex-M
*
* Core nanokernel fiber related primitives for the ARM Cortex-M processor
* architecture.
*/

View file

@ -1,5 +1,3 @@
/* exc.h - exception/interrupt context helpers for Cortex-M CPUs */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Exception/interrupt context helpers for Cortex-M CPUs
*
* Exception/interrupt context helpers.
*/

View file

@ -1,5 +1,3 @@
/* stack.h - stack helpers for Cortex-M CPUs */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Stack helpers for Cortex-M CPUs
*
* Stack helper functions.
*/

View file

@ -14,7 +14,7 @@
* limitations under the License.
*/
/*
/**
* @file
* @brief Kernel event logger support for ARM
*/

View file

@ -1,5 +1,3 @@
/* nano_private.h - private nanokernel definitions (ARM) */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Private nanokernel definitions (ARM)
*
* This file contains private nanokernel structures definitions and various
* other definitions for the ARM Cortex-M3 processor architecture.
*

View file

@ -1,5 +1,3 @@
/* start_task.h - ARM nanokernel declarations to start a task */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief ARM nanokernel declarations to start a task
*
* ARM-specific parts of start_task().
*
* Currently empty, only here for abstraction.

View file

@ -1,5 +1,3 @@
/* board.h - board configuration macros for the fsl_frdm_k64f platform */
/*
* Copyright (c) 2014-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Board configuration macros for the fsl_frdm_k64f platform
*
* This header file is used to specify and describe board-level aspects for the
* 'fsl_frdm_k64f' platform.
*/

View file

@ -1,5 +1,3 @@
/* irq_vector_table.c - IRQ part of vector table */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief IRQ part of vector table
*
* This file contains the IRQ part of the vector table. It is meant to be used
* for one of two cases:
*

View file

@ -1,5 +1,3 @@
/* linker.cmd - Linker command/script file */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
This is the linker script for both standard images and XIP images.
/**
* @file
* @brief Linker command/script file
*
* This is the linker script for both standard images and XIP images.
*/
/*

View file

@ -1,5 +1,3 @@
/* nmi_on_reset.S - default basic NMI handler before the kernel is up */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,13 +14,15 @@
* limitations under the License.
*/
/*
DESCRIPTION
Provide a default handler for NMI before the system is up. The default action
is to hard hang, sleeping.
This might be preferable than rebooting to help debugging, or because
rebooting might trigger the exact same problem over and over.
/**
* @file
* @brief Default basic NMI handler before the kernel is up
*
* Provide a default handler for NMI before the system is up. The default action
* is to hard hang, sleeping.
*
* This might be preferable than rebooting to help debugging, or because
* rebooting might trigger the exact same problem over and over.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* system.c - system/hardware module for fsl_frdm_k64f platform */
/*
* Copyright (c) 2014-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief System/hardware module for fsl_frdm_k64f platform
*
* This module provides routines to initialize and support board-level
* hardware for the fsl_frdm_k64f platform.
*/

View file

@ -1,5 +1,3 @@
/* wdog.S - watchdog initialization for fsl_frdm_k64f platform */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module initializes the watchdog for the fsl_frdm_k64f platform.
/**
* @file
* @brief Watchdog initialization for fsl_frdm_k64f platform
*
* This module initializes the watchdog for the fsl_frdm_k64f platform.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* board.h - board configuration macros for the QEMU for arm platform */
/*
* Copyright (c) 2013-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Board configuration macros for the QEMU for arm platform
*
* This header file is used to specify and describe board-level aspects for
* the 'QEMU' platform.
*/

View file

@ -1,5 +1,3 @@
/* irq_vector_table.c - IRQ part of vector table */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief IRQ part of vector table
*
* This file contains the IRQ part of the vector table. It is meant to be used
* for one of two cases:
*

View file

@ -1,5 +1,3 @@
/* nmi_on_reset.S - default basic NMI handler before the kernel is up */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,13 +14,15 @@
* limitations under the License.
*/
/*
DESCRIPTION
Provide a default handler for NMI before the system is up. The default action
is to hard hang, sleeping.
This might be preferable than rebooting to help debugging, or because
rebooting might trigger the exact same problem over and over.
/**
* @file
* @brief Default basic NMI handler before the kernel is up
*
* Provide a default handler for NMI before the system is up. The default action
* is to hard hang, sleeping.
*
* This might be preferable than rebooting to help debugging, or because
* rebooting might trigger the exact same problem over and over.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* scp.c - TI LM3S6965 System Control Peripherals interface */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief TI LM3S6965 System Control Peripherals interface
*
*
* Library for controlling target-specific devices present in the 0x400fe000
* peripherals memory region.

View file

@ -1,5 +1,3 @@
/* scp.h - TI LM3S6965 System Control Peripherals interface */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief TI LM3S6965 System Control Peripherals interface
*
* This module defines the System Control Peripheral Registers for TI LM3S6965
* processor. The registers defined are in region 0x400fe000.
*

View file

@ -1,5 +1,3 @@
/* system.c - system/hardware module for ti_lm3s6965 platform */
/*
* Copyright (c) 2013-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief System/hardware module for ti_lm3s6965 platform
*
* This module provides routines to initialize and support board-level hardware
* for the ti_lm3s6965 platform.
*/

View file

@ -15,9 +15,10 @@
* limitations under the License.
*/
/*
/**
* @file Atomic ops for x86
* DESCRIPTION This module provides the atomic operators for IA-32
*
* This module provides the atomic operators for IA-32
* architectures on platforms that support the LOCK prefix instruction.
*
* The atomic operations are guaranteed to be atomic with respect

View file

@ -1,5 +1,3 @@
/* cache.c - cache manipulation */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -15,8 +13,10 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Cache manipulation
*
* This module contains functions for manipulation caches.
*/

View file

@ -1,5 +1,3 @@
/* cache_s.S - cache manipulation */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -15,9 +13,11 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
DESCRIPTION
This module contains functions for manipulating caches.
/**
* @file
* @brief Cache manipulation
*
* This module contains functions for manipulating caches.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* crt0.S - crt0 module for the IA-32 boards */
/*
* Copyright (c) 2010-2015 Wind River Systems, Inc.
*
@ -15,10 +13,12 @@
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
DESCRIPTION
This module contains the initial code executed by the Zephyr Kernel ELF image
after having been loaded into RAM.
/**
* @file
* @brief Crt0 module for the IA-32 boards
*
* This module contains the initial code executed by the Zephyr Kernel ELF image
* after having been loaded into RAM.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* driver_static_irq_stubs.S - interrupt stubs */
/*
* Copyright (c) 2012-2015, Wind River Systems, Inc.
*
@ -16,10 +14,12 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module contains the static interrupt stubs for the various drivers employed
by x86 platforms.
/**
* @file
* @brief Interrupt stubs
*
* This module contains the static interrupt stubs for the various drivers employed
* by x86 platforms.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* excconnect.c - exception management support for IA-32 arch */
/*
* Copyright (c) 2010-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Exception management support for IA-32 arch
*
* This module provides routines to manage exceptions (synchronous interrupts)
* on the IA-32 architecture.
*

View file

@ -1,5 +1,3 @@
/* fatal.c - nanokernel fatal error handler */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Nanokernel fatal error handler
*
* This module provides the _NanoFatalErrorHandler() routine.
*/

View file

@ -1,5 +1,3 @@
/* float.c - floating point resource sharing routines */
/*
* Copyright (c) 2010-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Floating point resource sharing routines
*
* This module allows multiple tasks and fibers to safely share the system's
* floating point resources, by allowing the system to save FPU state
* information in a task or fiber's stack region when a pre-emptive context

View file

@ -1,5 +1,3 @@
/* gdt.c - Global Descriptor Table support */
/*
* Copyright (c) 2011-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Global Descriptor Table support
*
* This module contains routines for updating the global descriptor table (GDT)
* for the IA-32 architecture.
*/

View file

@ -1,5 +1,3 @@
/* excstub.S - exception management support for IA-32 architecture */
/*
* Copyright (c) 2011-2015 Wind River Systems, Inc.
*
@ -16,12 +14,14 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module implements assembly routines to manage exceptions (synchronous
interrupts) on the Intel IA-32 architecture. More specifically,
exceptions are implemented in this module. The stubs are invoked when entering
and exiting a C exception handler.
/**
* @file
* @brief Exception management support for IA-32 architecture
*
* This module implements assembly routines to manage exceptions (synchronous
* interrupts) on the Intel IA-32 architecture. More specifically,
* exceptions are implemented in this module. The stubs are invoked when entering
* and exiting a C exception handler.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* intstub.S - interrupt management support for IA-32 architecture */
/*
* Copyright (c) 2010-2014 Wind River Systems, Inc.
*
@ -16,12 +14,14 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module implements assembly routines to manage interrupts on
the Intel IA-32 architecture. More specifically, the interrupt (asynchronous
exception) stubs are implemented in this module. The stubs are invoked when
entering and exiting a C interrupt handler.
/**
* @file
* @brief Interrupt management support for IA-32 architecture
*
* This module implements assembly routines to manage interrupts on
* the Intel IA-32 architecture. More specifically, the interrupt (asynchronous
* exception) stubs are implemented in this module. The stubs are invoked when
* entering and exiting a C interrupt handler.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* swap.S - nanokernel swapper code for IA-32 */
/*
* Copyright (c) 2010-2015 Wind River Systems, Inc.
*
@ -16,15 +14,17 @@
* limitations under the License.
*/
/*
DESCRIPTION
This module implements the _Swap() routine for the IA-32 architecture.
Note that the file include/nanokernel/x86/swapstk.h defines
a representation of the save stack frame generated by _Swap() in order
to generate offsets (in the form of absolute symbols) for consumption by
host tools. Please update swapstk.h if changing the structure of the
save frame on the stack.
/**
* @file
* @brief Nanokernel swapper code for IA-32
*
* This module implements the _Swap() routine for the IA-32 architecture.
*
* Note that the file include/nanokernel/x86/swapstk.h defines
* a representation of the save stack frame generated by _Swap() in order
* to generate offsets (in the form of absolute symbols) for consumption by
* host tools. Please update swapstk.h if changing the structure of the
* save frame on the stack.
*/
#define _ASMLANGUAGE

View file

@ -1,5 +1,3 @@
/* thread.c - nanokernel thread support primitives */
/*
* Copyright (c) 2010-2015 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Nanokernel thread support primitives
*
* This module provides core nanokernel fiber related primitives for the IA-32
* processor architecture.
*/

View file

@ -1,5 +1,3 @@
/* intconnect.c - interrupt management support for IA-32 arch */
/*
* Copyright (c) 2010-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Interrupt management support for IA-32 arch
*
* This module provides routines to manage asynchronous interrupts
* on the IA-32 architecture.
*

View file

@ -1,5 +1,3 @@
/* offsets.c - nanokernel structure member offset definition file */
/*
* Copyright (c) 2010-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Nanokernel structure member offset definition file
*
* This module is responsible for the generation of the absolute symbols whose
* value represents the member offsets for various IA-32 nanokernel structures.
*

View file

@ -1,5 +1,3 @@
/* strtask.c - Intel nanokernel APIs to start a task */
/*
* Copyright (c) 2010-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Intel nanokernel APIs to start a task
*
* Intel-specific parts of start_task(). Only FP functionality currently.
*/

View file

@ -1,5 +1,3 @@
/* sysFatalErrorHandler - common system fatal error handler */
/*
* Copyright (c) 2013-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Common system fatal error handler
*
* This module provides the _SysFatalErrorHandler() routine which is common to
* supported platforms.
*/

View file

@ -1,5 +1,3 @@
/* gdt.h - IA-32 Global Descriptor Table (GDT) definitions */
/*
* Copyright (c) 2011-2012, 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief IA-32 Global Descriptor Table (GDT) definitions
*
* This file provides definitions for the Global Descriptor Table (GDT) for the
* IA-32 architecture.
*/

View file

@ -1,5 +1,3 @@
/* idtEnt.h - IA-32 IDT Entry code */
/*
* Copyright (c) 2012-2014, Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief IA-32 IDT Entry code
*
* This header file provides code for constructing an IA-32 interrupt
* descriptor.
*/

View file

@ -14,7 +14,7 @@
* limitations under the License.
*/
/*
/**
* @file
* @brief Kernel event logger support for x86
*/

View file

@ -1,5 +1,3 @@
/* nano_private.h - private nanokernel definitions (IA-32) */
/*
* Copyright (c) 2010-2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Private nanokernel definitions (IA-32)
*
* This file contains private nanokernel structures definitions and various
* other definitions for the Intel Architecture 32 bit (IA-32) processor
* architecture.

View file

@ -1,5 +1,3 @@
/* start_task.h - Intel nanokernel declarations to start a task */
/*
* Copyright (c) 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Intel nanokernel declarations to start a task
*
* Intel-specific parts of start_task(). Only FP functionality currently.
*/

View file

@ -1,5 +1,3 @@
/* swapstk.h - stack frame created by swap (IA-32) */
/*
* Copyright (c) 2011-2012, 2014 Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Stack frame created by swap (IA-32)
*
* This file details the stack frame generated by _Swap() when it saves a task
* or fiber's context. This is specific to the IA-32 processor architecture.
*

View file

@ -1,5 +1,3 @@
/* board.h - board configuration macros for the galileo platform */
/*
* Copyright (c) 2013-2015, Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Board configuration macros for the galileo platform
*
* This header file is used to specify and describe board-level aspects for
* the 'galileo' platform.
*/

View file

@ -1,5 +1,3 @@
/* galileo.c - system/hardware module for the galileo platform */
/*
* Copyright (c) 2013-2015, Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief System/hardware module for the galileo platform
*
* This module provides routines to initialize and support board-level hardware
* for the galileo platform.
*

View file

@ -1,5 +1,3 @@
/* linker.cmd - Linker command/script file */
/*
* Copyright (c) 2011-2014, Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
This is the linker script for both standard images and XIP images.
/**
* @file
* @brief Linker command/script file
*
* This is the linker script for both standard images and XIP images.
*/
#include <autoconf.h>

View file

@ -1,5 +1,3 @@
/* board.h - board configuration macros for the ia32 platform */
/*
* Copyright (c) 2010-2015, Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Board configuration macros for the ia32 platform
*
* This header file is used to specify and describe board-level aspects for
* the 'ia32' platform.
*/

View file

@ -1,5 +1,3 @@
/* ia32.c - system/hardware module for the ia32 platform */
/*
* Copyright (c) 2011-2015, Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief System/hardware module for the ia32 platform
*
* This module provides routines to initialize and support board-level hardware
* for the ia32 platform.
*/

View file

@ -1,5 +1,3 @@
/* linker.cmd - Linker command/script file */
/*
* Copyright (c) 2011-2014, Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
This is the linker script for both standard images and XIP images.
/**
* @file
* @brief Linker command/script file
*
* This is the linker script for both standard images and XIP images.
*/
#include <autoconf.h>

View file

@ -1,5 +1,3 @@
/* board.h - board configuration macros for the ia32_pci platform */
/*
* Copyright (c) 2013-2015, Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief Board configuration macros for the ia32_pci platform
*
* This header file is used to specify and describe board-level aspects for
* the 'ia32_pci' platform.
*/

View file

@ -1,5 +1,3 @@
/* ia32_pci.c - system/hardware module for the ia32_pci platform */
/*
* Copyright (c) 2013-2015, Wind River Systems, Inc.
*
@ -16,8 +14,10 @@
* limitations under the License.
*/
/*
* DESCRIPTION
/**
* @file
* @brief System/hardware module for the ia32_pci platform
*
* This module provides routines to initialize and support board-level hardware
* for the ia32_pci platform.
*

View file

@ -1,5 +1,3 @@
/* linker.cmd - Linker command/script file */
/*
* Copyright (c) 2011-2014, Wind River Systems, Inc.
*
@ -16,9 +14,11 @@
* limitations under the License.
*/
/*
DESCRIPTION
This is the linker script for both standard images and XIP images.
/**
* @file
* @brief Linker command/script file
*
* This is the linker script for both standard images and XIP images.
*/
#include <autoconf.h>

Some files were not shown because too many files have changed in this diff Show more