1    /* --COPYRIGHT--,EPL
     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     * --/COPYRIGHT--*/
    12    /*!
    13     *  ======== ti.mcu.msp430 ========
    14     *  Grace support for the MSP430
    15     *
    16     *  This package provides the top-level runtime interface to the code
    17     *  generated by Grace.  At this time, the only function externally callable
    18     *  by applications is `Grace_init()`.  To use this function you must
    19     *  include the header file that declares it's prototype.  For example,
    20     *  @p(code)
    21     *      #include <ti/mcu/msp430/Grace.h>
    22     *          :
    23     *      int main(void)
    24     *      {
    25     *          Grace_init();  // initialize device peripherals
    26     *             :           // do something interesting ...
    27     *          return (0);    // return status to C runtime
    28     *      }
    29     *  @p
    30     *  @a(Synopsys)
    31     *  @p(code)
    32     *      #include <ti/mcu/msp430/Grace.h>
    33     *
    34     *      void Grace_init(void)
    35     *  @p
    36     *  @a(Description)
    37     *  The function `Grace_init()` initializes the peripherals of your device
    38     *  according to the settings specified by your application's `.cfg` file.
    39     *  This file can be created "by hand" but is more typically created using
    40     *  the Grace graphical configuration tool.
    41     *
    42     *  `Grace_init()` assumes that, prior to execution, peripherals are in their
    43     *  power-on-reset state.  This allows it to to avoid spending unnecessary
    44     *  time and code space setting registers to default values already
    45     *  established by the hardware during reset.  However, this also means that
    46     *  `Grace_init()` can not be used to "soft reset" peripherals during
    47     *  runtime.
    48     *  @a(See Also)
    49     *  @p(blist)
    50     *     - {@link PLUGINS_ROOT/com.ti.sdo.grace.product.ui/welcome/Welcome_to_Grace.html Grace graphical configuration tool}
    51     *     - {@link ti.mcu.msp430.csl.CSL Grace file generation details}
    52     *  @p
    53     */
    54    package ti.mcu.msp430 [1, 0, 0]
    55    {
    56    }