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