1    /*
     2     *  Copyright 2012 by Texas Instruments Incorporated.
     3     *
     4     */
     5    
     6    /* 
     7     * Copyright (c) 2012, Texas Instruments Incorporated
     8     * All rights reserved.
     9     *
    10     * Redistribution and use in source and binary forms, with or without
    11     * modification, are permitted provided that the following conditions
    12     * are met:
    13     *
    14     * *  Redistributions of source code must retain the above copyright
    15     *    notice, this list of conditions and the following disclaimer.
    16     *
    17     * *  Redistributions in binary form must reproduce the above copyright
    18     *    notice, this list of conditions and the following disclaimer in the
    19     *    documentation and/or other materials provided with the distribution.
    20     *
    21     * *  Neither the name of Texas Instruments Incorporated nor the names of
    22     *    its contributors may be used to endorse or promote products derived
    23     *    from this software without specific prior written permission.
    24     *
    25     * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    26     * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
    27     * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
    28     * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
    29     * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
    30     * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
    31     * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
    32     * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
    33     * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
    34     * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
    35     * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    36     * 
    37     */
    38    
    39    
    40    /*
    41     *  ======== Settings.xdc ========
    42     *
    43     */
    44    
    45    package ti.sdo.tiler.remote;
    46    
    47    
    48    /*!
    49     *  ======== Settings ========
    50     *  Global configuration settings for the ti.sdo.tiler.remote package
    51     *
    52     */
    53    
    54    @Template("./Settings.xdt")
    55    
    56    metaonly module Settings
    57    {
    58    
    59        // -------- Module Constants --------
    60    
    61        // -------- Module Types --------
    62    
    63        /*!
    64         *  Available tiler library implementations
    65         *
    66         *  @value(TilerLib_Stub) This library implements stub functions
    67         *  which make remote function calls to a tiler manager on another
    68         *  core. When using this value, you must also specify the
    69         *  {@link #tilerDaemon} config param.
    70         *
    71         *  @value(TilerLib_Skel) This library implements the skel
    72         *  functions which are the remote parts of the stub functions.
    73         *  Use this value when configuring the tiler daemon. When using
    74         *  this value, you must also specify the {@link #tilerManagerOS}
    75         *  config param.
    76         *
    77         *  @value(TilerLib_Direct) This library links in direct calls to
    78         *  the tiler manager. Use this value when configuring a program
    79         *  which is running on the same core as the tiler manager. When
    80         *  using this value, you must also specify the {@link #tilerManagerOS}
    81         *  config param.
    82         */
    83        enum TilerLib {
    84            TilerLib_Stub,
    85            TilerLib_Skel,
    86            TilerLib_Direct
    87        };
    88    
    89        // -------- Module Parameters --------
    90    
    91        /*!
    92         *  Heap id to use for allocating messages
    93         *
    94         *  When using a remote tiler manager, the client application must
    95         *  send messages to execute the tiler manager functions. This config
    96         *  param is used by the underlying IPC layers to identify which heap
    97         *  should be used for allocating these messages.
    98         *
    99         *  If the executable is making direct (local) calls to the tiler
   100         *  manager, then leave this config param undefined.
   101         */
   102        config UInt16 heapId;
   103    
   104        /*!
   105         *  Specifies the name of the tiler daemon
   106         *
   107         *  When configuring an executable which is using a tiler manager
   108         *  that is running on another core, this config param must be set
   109         *  to the name of the tiler daemon.
   110         */
   111        config String tilerDaemonName = null;
   112    
   113        /*!
   114         *  Specify which tiler library implementation to use
   115         *
   116         *  This config param specifies which tiler library implementation to
   117         *  link into the program. There are several different versions:
   118         *
   119         *  @p(blist)
   120         *  - A tiler client program where the tiler manager is running
   121         *  on another core. Use {@link #TilerLib_Stub}.
   122         *
   123         *  - A tiler daemon program which is used to service remote
   124         *  tiler client programs. The daemon must be running on the same core
   125         *  as the tiler manager. Use {@link #TilerLib_Skel}.
   126         *
   127         *  - A tiler client program running on the same core as the
   128         *  tiler manager. Use {@link #TilerLib_Direct}.
   129         *  @p
   130         */
   131        config TilerLib tilerLib;
   132    
   133    }
   134    /*
   135     *  @(#) ti.sdo.tiler.remote; 1, 0, 0,2; 8-10-2012 11:05:38; /db/atree/library/trees/ipcutils/ipcutils-a03/src/ xlibrary
   136    
   137     */
   138