object.h

Go to the documentation of this file.

 
/*
 *  COPYRIGHT (c) 1989-2011.
 *  On-Line Applications Research Corporation (OAR).
 *
 *  The license and distribution terms for this file may be
 *  found in the file LICENSE in this distribution or at
 *  http://www.rtems.org/license/LICENSE.
 */
 
#ifndef _RTEMS_SCORE_OBJECT_H
#define _RTEMS_SCORE_OBJECT_H
 
#include <rtems/score/basedefs.h>
#include <rtems/score/cpu.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef union {
  const char *name_p;
  uint32_t    name_u32;
} Objects_Name;
 
typedef uint32_t   Objects_Id;
 
typedef uint16_t   Objects_Maximum;
 
#define OBJECTS_INDEX_START_BIT  0U
#define OBJECTS_NODE_START_BIT  16U
 
#define OBJECTS_API_START_BIT   24U
 
#define OBJECTS_CLASS_START_BIT 27U
 
#define OBJECTS_INDEX_MASK      (Objects_Id)0x0000ffffU
 
#define OBJECTS_NODE_MASK       (Objects_Id)0x00ff0000U
 
#define OBJECTS_API_MASK        (Objects_Id)0x07000000U
 
#define OBJECTS_CLASS_MASK      (Objects_Id)0xf8000000U
 
#define OBJECTS_INDEX_VALID_BITS  (Objects_Id)0x0000ffffU
 
#define OBJECTS_NODE_VALID_BITS   (Objects_Id)0x000000ffU
 
#define OBJECTS_API_VALID_BITS    (Objects_Id)0x00000007U
 
#define OBJECTS_CLASS_VALID_BITS  (Objects_Id)0x0000001fU
 
#define OBJECTS_UNLIMITED_OBJECTS 0x80000000U
 
#define OBJECTS_ID_INITIAL_INDEX  (0)
 
#define OBJECTS_ID_FINAL_INDEX    (0xffffU)
 
typedef enum {
  OBJECTS_NO_API       = 0,
  OBJECTS_INTERNAL_API = 1,
  OBJECTS_CLASSIC_API  = 2,
  OBJECTS_POSIX_API    = 3,
  OBJECTS_FAKE_OBJECTS_API = 7
} Objects_APIs;
 
#define OBJECTS_APIS_LAST OBJECTS_POSIX_API
 
#define OBJECTS_ID_NONE 0
 
#define OBJECTS_ID_OF_SELF ((Objects_Id) 0)
 
#define OBJECTS_SEARCH_ALL_NODES   0
 
#define OBJECTS_SEARCH_OTHER_NODES 0x7FFFFFFE
 
#define OBJECTS_SEARCH_LOCAL_NODE  0x7FFFFFFF
 
#define OBJECTS_WHO_AM_I           0
 
#define OBJECTS_ID_INITIAL(_api, _class, _node) \
  _Objects_Build_id( (_api), (_class), (_node), OBJECTS_ID_INITIAL_INDEX )
 
#define OBJECTS_ID_FINAL           ((Objects_Id)~0)
 
#define  _Objects_Build_name( _C1, _C2, _C3, _C4 ) \
  ( (uint32_t)(_C1) << 24 | \
    (uint32_t)(_C2) << 16 | \
    (uint32_t)(_C3) << 8 | \
    (uint32_t)(_C4) )
 
RTEMS_INLINE_ROUTINE Objects_APIs _Objects_Get_API(
  Objects_Id id
)
{
  return (Objects_APIs) ((id >> OBJECTS_API_START_BIT) & OBJECTS_API_VALID_BITS);
}
 
RTEMS_INLINE_ROUTINE uint32_t _Objects_Get_class(
  Objects_Id id
)
{
  return (uint32_t)
    ((id >> OBJECTS_CLASS_START_BIT) & OBJECTS_CLASS_VALID_BITS);
}
 
RTEMS_INLINE_ROUTINE uint32_t _Objects_Get_node(
  Objects_Id id
)
{
  return (id >> OBJECTS_NODE_START_BIT) & OBJECTS_NODE_VALID_BITS;
}
 
RTEMS_INLINE_ROUTINE Objects_Maximum _Objects_Get_index(
  Objects_Id id
)
{
  return
    (Objects_Maximum)((id >> OBJECTS_INDEX_START_BIT) &
                                          OBJECTS_INDEX_VALID_BITS);
}
 
#define _Objects_Build_id( the_api, the_class, node, index ) \
  ( (Objects_Id) ( (Objects_Id) the_api   << OBJECTS_API_START_BIT )   | \
                 ( (Objects_Id) the_class << OBJECTS_CLASS_START_BIT ) | \
                 ( (Objects_Id) node      << OBJECTS_NODE_START_BIT )  | \
                 ( (Objects_Id) index     << OBJECTS_INDEX_START_BIT ) )
 
#define _Objects_Is_unlimited( maximum ) \
  ( ( ( maximum ) & OBJECTS_UNLIMITED_OBJECTS ) != 0 )
 
/*
 * We cannot use an inline function for this since it may be evaluated at
 * compile time.
 */
#define _Objects_Maximum_per_allocation( maximum ) \
  ((Objects_Maximum) ((maximum) & ~OBJECTS_UNLIMITED_OBJECTS))
 
#if defined(RTEMS_MULTIPROCESSING)
extern uint16_t _Objects_Local_node;
#else
#define _Objects_Local_node ((uint16_t) 1)
#endif
 
#ifdef __cplusplus
}
#endif
 
#endif
/* end of include file */