Ricardo Benitez / mbed

meh

Fork of mbed by mbed official

TARGET_OC_MBUINO/power_api.h@89:552587b429a1, 2014-09-12 (annotated)

Committer:
bogdanm
Date:
Fri Sep 12 16:41:52 2014 +0100
Revision:
89:552587b429a1
Parent:
TARGET_GHI_MBUINO/power_api.h@88:9327015d4013 
Release 89 of the mbed library



Main changes:



- low power optimizations for Nordic targets

- code structure changes for Freescale K64F targets

- bug fixes in various backends

Who changed what in which revision?

UserRevisionLine numberNew contents of line
bogdanm 88:9327015d4013 1 /****************************************************************************
bogdanm 88:9327015d4013 2 * $Id:: power_api.h 6249 2011-01-25 19:23:47Z usb01267 $
bogdanm 88:9327015d4013 3 * Project: NXP LPC11Uxx software example
bogdanm 88:9327015d4013 4 *
bogdanm 88:9327015d4013 5 * Description:
bogdanm 88:9327015d4013 6 * Power API Header File for NXP LPC11Uxx Device Series
bogdanm 88:9327015d4013 7 *
bogdanm 88:9327015d4013 8 ****************************************************************************
bogdanm 88:9327015d4013 9 * Software that is described herein is for illustrative purposes only
bogdanm 88:9327015d4013 10 * which provides customers with programming information regarding the
bogdanm 88:9327015d4013 11 * products. This software is supplied "AS IS" without any warranties.
bogdanm 88:9327015d4013 12 * NXP Semiconductors assumes no responsibility or liability for the
bogdanm 88:9327015d4013 13 * use of the software, conveys no license or title under any patent,
bogdanm 88:9327015d4013 14 * copyright, or mask work right to the product. NXP Semiconductors
bogdanm 88:9327015d4013 15 * reserves the right to make changes in the software without
bogdanm 88:9327015d4013 16 * notification. NXP Semiconductors also make no representation or
bogdanm 88:9327015d4013 17 * warranty that such application will be suitable for the specified
bogdanm 88:9327015d4013 18 * use without further testing or modification.
bogdanm 88:9327015d4013 19 ****************************************************************************/
bogdanm 88:9327015d4013 20 #ifndef __LPC11UXX_POWER_API_H__
bogdanm 88:9327015d4013 21 #define __LPC11UXX_POWER_API_H__
bogdanm 88:9327015d4013 22
bogdanm 88:9327015d4013 23 #ifdef __cplusplus
bogdanm 88:9327015d4013 24 extern "C" {
bogdanm 88:9327015d4013 25 #endif
bogdanm 88:9327015d4013 26
bogdanm 88:9327015d4013 27 #define PWRROMD_PRESENT
bogdanm 88:9327015d4013 28
bogdanm 88:9327015d4013 29 typedef struct _PWRD {
bogdanm 88:9327015d4013 30 void (*set_pll)(unsigned int cmd[], unsigned int resp[]);
bogdanm 88:9327015d4013 31 void (*set_power)(unsigned int cmd[], unsigned int resp[]);
bogdanm 88:9327015d4013 32 } PWRD;
bogdanm 88:9327015d4013 33
bogdanm 88:9327015d4013 34 typedef struct _ROM {
bogdanm 88:9327015d4013 35 #ifdef USBROMD_PRESENT
bogdanm 88:9327015d4013 36 const USB * pUSBD;
bogdanm 88:9327015d4013 37 #else
bogdanm 88:9327015d4013 38 const unsigned p_usbd;
bogdanm 88:9327015d4013 39 #endif /* USBROMD_PRESENT */
bogdanm 88:9327015d4013 40 const unsigned p_clib;
bogdanm 88:9327015d4013 41 const unsigned p_cand;
bogdanm 88:9327015d4013 42 #ifdef PWRROMD_PRESENT
bogdanm 88:9327015d4013 43 const PWRD * pPWRD;
bogdanm 88:9327015d4013 44 #else
bogdanm 88:9327015d4013 45 const unsigned p_pwrd;
bogdanm 88:9327015d4013 46 #endif /* PWRROMD_PRESENT */
bogdanm 88:9327015d4013 47 const unsigned p_dev1;
bogdanm 88:9327015d4013 48 const unsigned p_dev2;
bogdanm 88:9327015d4013 49 const unsigned p_dev3;
bogdanm 88:9327015d4013 50 const unsigned p_dev4;
bogdanm 88:9327015d4013 51 } ROM;
bogdanm 88:9327015d4013 52
bogdanm 88:9327015d4013 53 //PLL setup related definitions
bogdanm 88:9327015d4013 54 #define CPU_FREQ_EQU 0 //main PLL freq must be equal to the specified
bogdanm 88:9327015d4013 55 #define CPU_FREQ_LTE 1 //main PLL freq must be less than or equal the specified
bogdanm 88:9327015d4013 56 #define CPU_FREQ_GTE 2 //main PLL freq must be greater than or equal the specified
bogdanm 88:9327015d4013 57 #define CPU_FREQ_APPROX 3 //main PLL freq must be as close as possible the specified
bogdanm 88:9327015d4013 58
bogdanm 88:9327015d4013 59 #define PLL_CMD_SUCCESS 0 //PLL setup successfully found
bogdanm 88:9327015d4013 60 #define PLL_INVALID_FREQ 1 //specified freq out of range (either input or output)
bogdanm 88:9327015d4013 61 #define PLL_INVALID_MODE 2 //invalid mode (see above for valid) specified
bogdanm 88:9327015d4013 62 #define PLL_FREQ_NOT_FOUND 3 //specified freq not found under specified conditions
bogdanm 88:9327015d4013 63 #define PLL_NOT_LOCKED 4 //PLL not locked => no changes to the PLL setup
bogdanm 88:9327015d4013 64
bogdanm 88:9327015d4013 65 //power setup elated definitions
bogdanm 88:9327015d4013 66 #define PARAM_DEFAULT 0 //default power settings (voltage regulator, flash interface)
bogdanm 88:9327015d4013 67 #define PARAM_CPU_PERFORMANCE 1 //setup for maximum CPU performance (higher current, more computation)
bogdanm 88:9327015d4013 68 #define PARAM_EFFICIENCY 2 //balanced setting (power vs CPU performance)
bogdanm 88:9327015d4013 69 #define PARAM_LOW_CURRENT 3 //lowest active current, lowest CPU performance
bogdanm 88:9327015d4013 70
bogdanm 88:9327015d4013 71 #define PARAM_CMD_SUCCESS 0 //power setting successfully found
bogdanm 88:9327015d4013 72 #define PARAM_INVALID_FREQ 1 //specified freq out of range (=0 or > 50 MHz)
bogdanm 88:9327015d4013 73 #define PARAM_INVALID_MODE 2 //specified mode not valid (see above for valid)
bogdanm 88:9327015d4013 74
bogdanm 88:9327015d4013 75 #define MAX_CLOCK_KHZ_PARAM 50000
bogdanm 88:9327015d4013 76
bogdanm 88:9327015d4013 77 #ifdef __cplusplus
bogdanm 88:9327015d4013 78 }
bogdanm 88:9327015d4013 79 #endif
bogdanm 88:9327015d4013 80
bogdanm 88:9327015d4013 81 #endif /* __LPC11UXX_POWER_API_H__ */
bogdanm 88:9327015d4013 82