1    /* 
     2     *  Copyright (c) 2008 Texas Instruments and others.
     3     *  All rights reserved. This program and the accompanying materials
     4     *  are made available under the terms of the Eclipse Public License v1.0
     5     *  which accompanies this distribution, and is available at
     6     *  http://www.eclipse.org/legal/epl-v10.html
     7     * 
     8     *  Contributors:
     9     *      Texas Instruments - initial implementation
    10     * 
    11     * */
    12    
    13    /*!
    14     *  ======== CallStack ========
    15     *  Provide call stack support to module ROV views
    16     *
    17     *  This module provides methods that enable module ROV views
    18     *  to specify current CPU registers and get the corresponding
    19     *  stack traceback for the current executable.
    20     *
    21     *  While the methods of this module are currently
    22     *  similar to the `ICallStack` interface, it is important to
    23     *  note that this module does not have instance methods; the
    24     *  `ICallStack` interface defines an interface for instance
    25     *  objects that enable the implementation of this module.
    26     *
    27     *  This module uses the `{@link xdc.rov.ICallStack}` instance
    28     *  provided by `{@link xdc.rov.Model}`.
    29     */
    30    metaonly module CallStack
    31    {
    32        /*!
    33         *  ======== clearRegisters ========
    34         *  Clear all register settings
    35         */
    36        Void clearRegisters();
    37    
    38        /*!
    39         *  ======== fetchRegisters ========
    40         *  Set a device register necessary for stack trace back analysis
    41         */
    42        Void fetchRegisters(String names[]);
    43    
    44        /*!
    45         *  ======== getRegister ========
    46         *  Set a device register necessary for stack trace back analysis
    47         */
    48        Long getRegister(String name);
    49    
    50        /*!
    51         *  ======== setRegister ========
    52         *  Set a device register necessary for stack trace back analysis
    53         */
    54        Void setRegister(String name, Long value);
    55    
    56        /*!
    57         *  ======== toText ========
    58         *  Create a string represenation of the call stack
    59         */
    60        String toText();
    61    }
    62    /*
    63     *  @(#) xdc.rov; 1, 0, 1,472; 3-20-2014 17:05:37; /db/ztree/library/trees/xdc/xdc-A32x/src/packages/
    64     */
    65