forked from Imagelibrary/rtems
rtems: Generate <rtems/rtems/modes.h>
Change license to BSD-2-Clause according to file histories and documentation re-licensing agreement. Update #3899. Update #3993.
This commit is contained in:
Sebastian Huber
@@ -1,129 +1,253 @@
|
|||||||
|
/* SPDX-License-Identifier: BSD-2-Clause */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @file
|
* @file
|
||||||
*
|
*
|
||||||
* @ingroup ClassicModes
|
* @brief This header file provides the task modes API of the Task Manager.
|
||||||
*
|
|
||||||
* This include file contains all constants and structures associated
|
|
||||||
* with the RTEMS thread and RTEMS_ASR modes.
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/* COPYRIGHT (c) 1989-2013.
|
/*
|
||||||
* On-Line Applications Research Corporation (OAR).
|
* Copyright (C) 2020 embedded brains GmbH (http://www.embedded-brains.de)
|
||||||
|
* Copyright (C) 2008 On-Line Applications Research Corporation (OAR)
|
||||||
*
|
*
|
||||||
* The license and distribution terms for this file may be
|
* Redistribution and use in source and binary forms, with or without
|
||||||
* found in the file LICENSE in this distribution or at
|
* modification, are permitted provided that the following conditions
|
||||||
* http://www.rtems.org/license/LICENSE.
|
* are met:
|
||||||
|
* 1. Redistributions of source code must retain the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer.
|
||||||
|
* 2. Redistributions in binary form must reproduce the above copyright
|
||||||
|
* notice, this list of conditions and the following disclaimer in the
|
||||||
|
* documentation and/or other materials provided with the distribution.
|
||||||
|
*
|
||||||
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||||
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||||
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||||
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
||||||
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
||||||
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
||||||
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
||||||
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
||||||
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
||||||
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
||||||
|
* POSSIBILITY OF SUCH DAMAGE.
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
/*
|
||||||
|
* This file is part of the RTEMS quality process and was automatically
|
||||||
|
* generated. If you find something that needs to be fixed or
|
||||||
|
* worded better please post a report or patch to an RTEMS mailing list
|
||||||
|
* or raise a bug report:
|
||||||
|
*
|
||||||
|
* https://docs.rtems.org/branches/master/user/support/bugs.html
|
||||||
|
*
|
||||||
|
* For information on updating and regenerating please refer to:
|
||||||
|
*
|
||||||
|
* https://docs.rtems.org/branches/master/eng/req/howto.html
|
||||||
|
*/
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/header */
|
||||||
|
|
||||||
#ifndef _RTEMS_RTEMS_MODES_H
|
#ifndef _RTEMS_RTEMS_MODES_H
|
||||||
#define _RTEMS_RTEMS_MODES_H
|
#define _RTEMS_RTEMS_MODES_H
|
||||||
|
|
||||||
|
#include <stdint.h>
|
||||||
#include <rtems/score/cpu.h>
|
#include <rtems/score/cpu.h>
|
||||||
|
|
||||||
#ifdef __cplusplus
|
#ifdef __cplusplus
|
||||||
extern "C" {
|
extern "C" {
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/group */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @defgroup ClassicModes Modes
|
* @defgroup RTEMSAPIClassicModes Task Modes
|
||||||
*
|
*
|
||||||
* @ingroup RTEMSAPIClassic
|
* @ingroup RTEMSAPIClassic
|
||||||
*
|
*
|
||||||
* This encapsulates functionality related to the task modes supported
|
* @brief This group contains the Classic API task modes.
|
||||||
* by the Classic API Task Manager.
|
|
||||||
*/
|
*/
|
||||||
/**@{*/
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/all-mode-masks */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* The following type defines the control block used to manage
|
* @ingroup RTEMSAPIClassicModes
|
||||||
* each a mode set.
|
|
||||||
*/
|
|
||||||
typedef uint32_t rtems_mode;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* The following constants define the individual modes and masks
|
|
||||||
* which may be used to compose a mode set and to alter modes.
|
|
||||||
*/
|
|
||||||
#define RTEMS_ALL_MODE_MASKS 0x0000ffff
|
|
||||||
|
|
||||||
/**
|
|
||||||
* This mode constant is the default mode set.
|
|
||||||
*/
|
|
||||||
#define RTEMS_DEFAULT_MODES 0x00000000
|
|
||||||
|
|
||||||
/**
|
|
||||||
* This mode constant is used when the user wishes to obtain their
|
|
||||||
* current execution mode.
|
|
||||||
*/
|
|
||||||
#define RTEMS_CURRENT_MODE 0
|
|
||||||
|
|
||||||
/** This mode constant corresponds to the timeslice enable/disable bit. */
|
|
||||||
#define RTEMS_TIMESLICE_MASK 0x00000200
|
|
||||||
|
|
||||||
/** This mode constant corresponds to the preemption enable/disable bit. */
|
|
||||||
#define RTEMS_PREEMPT_MASK 0x00000100
|
|
||||||
|
|
||||||
/** This mode constant corresponds to the signal enable/disable bit. */
|
|
||||||
#define RTEMS_ASR_MASK 0x00000400
|
|
||||||
|
|
||||||
/** This mode constant corresponds to the interrupt enable/disable bits. */
|
|
||||||
#define RTEMS_INTERRUPT_MASK CPU_MODES_INTERRUPT_MASK
|
|
||||||
|
|
||||||
/** This mode constant is used to indicate preemption is enabled. */
|
|
||||||
#define RTEMS_PREEMPT 0x00000000
|
|
||||||
/** This mode constant is used to indicate preemption is disabled. */
|
|
||||||
#define RTEMS_NO_PREEMPT 0x00000100
|
|
||||||
|
|
||||||
/** This mode constant is used to indicate timeslicing is disabled. */
|
|
||||||
#define RTEMS_NO_TIMESLICE 0x00000000
|
|
||||||
/** This mode constant is used to indicate timeslicing is enabled. */
|
|
||||||
#define RTEMS_TIMESLICE 0x00000200
|
|
||||||
|
|
||||||
/** This mode constant is used to indicate signal processing is enabled. */
|
|
||||||
#define RTEMS_ASR 0x00000000
|
|
||||||
/** This mode constant is used to indicate signal processing is disabled. */
|
|
||||||
#define RTEMS_NO_ASR 0x00000400
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @brief RTEMS_INTERRUPT_LEVEL
|
|
||||||
*
|
*
|
||||||
* This function returns the processor dependent interrupt
|
* @brief This task mode constant is a bit mask with all mode bits set.
|
||||||
* level which corresponds to the requested interrupt level.
|
|
||||||
*
|
|
||||||
* @note RTEMS supports 256 interrupt levels using the least
|
|
||||||
* significant eight bits of MODES.CONTROL. On any
|
|
||||||
* particular CPU, fewer than 256 levels may be supported.
|
|
||||||
*/
|
*/
|
||||||
#define RTEMS_INTERRUPT_LEVEL( _mode_set ) \
|
#define RTEMS_ALL_MODE_MASKS 0x0000ffff
|
||||||
( (_mode_set) & RTEMS_INTERRUPT_MASK )
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/asr */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @brief Interrupt Mask Variable
|
* @ingroup RTEMSAPIClassicModes
|
||||||
*
|
*
|
||||||
* This variable is used by bindings from languages other than C and C++.
|
* @brief This task mode constant indicates that signal processing is disabled.
|
||||||
|
*/
|
||||||
|
#define RTEMS_ASR 0x00000000
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/asr-mask */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This mode constant corresponds to the signal enable/disable bit.
|
||||||
|
*/
|
||||||
|
#define RTEMS_ASR_MASK 0x00000400
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/current-mode */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant indicates that the current task mode of the
|
||||||
|
* executing task shall be returned by rtems_task_mode().
|
||||||
|
*/
|
||||||
|
#define RTEMS_CURRENT_MODE 0
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/default */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant represents the default mode set.
|
||||||
|
*/
|
||||||
|
#define RTEMS_DEFAULT_MODES 0x00000000
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/interrupt-mask */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant corresponds to the interrupt enable/disable
|
||||||
|
* bits.
|
||||||
|
*/
|
||||||
|
#define RTEMS_INTERRUPT_MASK CPU_MODES_INTERRUPT_MASK
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/interrupt-level */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief Maps the interrupt level to the associated processor-dependent task
|
||||||
|
* mode interrupt level.
|
||||||
|
*
|
||||||
|
* The Classic API supports 256 interrupt levels using the least significant
|
||||||
|
* eight bits of the mode set. On any particular processor variant, fewer than
|
||||||
|
* 256 levels may be supported. At least level 0 (all interrupts enabled) and
|
||||||
|
* level 1 (interrupts disabled, on most architectures) are supported.
|
||||||
|
*
|
||||||
|
* @param _interrupt_level is the interrupt level to map.
|
||||||
|
*
|
||||||
|
* @return null Returns the processor-dependent task mode interrupt level
|
||||||
|
* associated with the interrupt level.
|
||||||
|
*/
|
||||||
|
#define RTEMS_INTERRUPT_LEVEL( _interrupt_level ) \
|
||||||
|
( ( _interrupt_level ) & RTEMS_INTERRUPT_MASK )
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/interrupt-mask-constant */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant has the same value as #RTEMS_INTERRUPT_MASK.
|
||||||
|
*
|
||||||
|
* This task mode constant is used by bindings from languages other than C and
|
||||||
|
* C++.
|
||||||
*/
|
*/
|
||||||
extern const uint32_t rtems_interrupt_mask;
|
extern const uint32_t rtems_interrupt_mask;
|
||||||
|
|
||||||
/**
|
/* Generated from spec:/rtems/mode/if/mode */
|
||||||
* @brief Body for RTEMS_INTERRUPT_LEVEL Macro
|
|
||||||
*
|
|
||||||
* @param[in] level is the desired interrupt level
|
|
||||||
*
|
|
||||||
* @retval This methods returns a mode with the desired interrupt
|
|
||||||
* @a level in the proper bitfield location.
|
|
||||||
*
|
|
||||||
* @note This variable is used by bindings from languages other than
|
|
||||||
* C and C++.
|
|
||||||
*/
|
|
||||||
rtems_mode rtems_interrupt_level_body(
|
|
||||||
uint32_t level
|
|
||||||
);
|
|
||||||
|
|
||||||
/**@}*/
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This type represents a Classic API task mode set.
|
||||||
|
*/
|
||||||
|
typedef uint32_t rtems_mode;
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/interrupt-level-body */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief Maps the interrupt level to the associated processor-dependent task
|
||||||
|
* mode interrupt level.
|
||||||
|
*
|
||||||
|
* This function is used by bindings from languages other than C and C++.
|
||||||
|
*
|
||||||
|
* @param level is the interrupt level to map.
|
||||||
|
*
|
||||||
|
* @return Returns RTEMS_INTERRUPT_LEVEL() for the interrupt level.
|
||||||
|
*/
|
||||||
|
rtems_mode rtems_interrupt_level_body( uint32_t level );
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/no-asr */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant indicates that signal processing is disabled.
|
||||||
|
*/
|
||||||
|
#define RTEMS_NO_ASR 0x00000400
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/no-preempt */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant indicates that preemption is disabled.
|
||||||
|
*/
|
||||||
|
#define RTEMS_NO_PREEMPT 0x00000100
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/no-timeslice */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant indicates that timeslicing is disabled.
|
||||||
|
*/
|
||||||
|
#define RTEMS_NO_TIMESLICE 0x00000000
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/preempt */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant indicates that preemption is enabled.
|
||||||
|
*/
|
||||||
|
#define RTEMS_PREEMPT 0x00000000
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/preempt-mask */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant corresponds to the preemption enable/disable
|
||||||
|
* bit.
|
||||||
|
*/
|
||||||
|
#define RTEMS_PREEMPT_MASK 0x00000100
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/timeslice */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant indicates that timeslicing is enabled.
|
||||||
|
*/
|
||||||
|
#define RTEMS_TIMESLICE 0x00000200
|
||||||
|
|
||||||
|
/* Generated from spec:/rtems/mode/if/timeslice-mask */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup RTEMSAPIClassicModes
|
||||||
|
*
|
||||||
|
* @brief This task mode constant corresponds to the timeslice enable/disable
|
||||||
|
* bit.
|
||||||
|
*/
|
||||||
|
#define RTEMS_TIMESLICE_MASK 0x00000200
|
||||||
|
|
||||||
#ifdef __cplusplus
|
#ifdef __cplusplus
|
||||||
}
|
}
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
#endif
|
#endif /* _RTEMS_RTEMS_MODES_H */
|
||||||
/* end of include file */
|
|
||||||
|
|||||||
Reference in New Issue
Block a user