machine_type.h revision f2f96fb86d42396716b3e556da7a930956e712fb
12228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 22228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/* ----------------------------------------------------------------------------------------------------------- 32228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectSoftware License for The Fraunhofer FDK AAC Codec Library for Android 42228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 54f0d97057c5c640b25518358886f8c47da9fc052Jean-Michel Trivi� Copyright 1995 - 2013 Fraunhofer-Gesellschaft zur F�rderung der angewandten Forschung e.V. 62228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project All rights reserved. 72228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 82228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1. INTRODUCTION 92228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectThe Fraunhofer FDK AAC Codec Library for Android ("FDK AAC Codec") is software that implements 102228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectthe MPEG Advanced Audio Coding ("AAC") encoding and decoding scheme for digital audio. 112228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectThis FDK AAC Codec software is intended to be used on a wide variety of Android devices. 122228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 132228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectAAC's HE-AAC and HE-AAC v2 versions are regarded as today's most efficient general perceptual 142228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectaudio codecs. AAC-ELD is considered the best-performing full-bandwidth communications codec by 152228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectindependent studies and is widely deployed. AAC has been standardized by ISO and IEC as part 162228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectof the MPEG specifications. 172228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 182228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectPatent licenses for necessary patent claims for the FDK AAC Codec (including those of Fraunhofer) 192228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectmay be obtained through Via Licensing (www.vialicensing.com) or through the respective patent owners 202228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectindividually for the purpose of encoding or decoding bit streams in products that are compliant with 212228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectthe ISO/IEC MPEG audio standards. Please note that most manufacturers of Android devices already license 222228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectthese patent claims through Via Licensing or directly from the patent owners, and therefore FDK AAC Codec 232228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectsoftware may already be covered under those patent licenses when it is used for those licensed purposes only. 242228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 252228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectCommercially-licensed AAC software libraries, including floating-point versions with enhanced sound quality, 262228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectare also available from Fraunhofer. Users are encouraged to check the Fraunhofer website for additional 272228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectapplications information and documentation. 282228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 292228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project2. COPYRIGHT LICENSE 302228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 312228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectRedistribution and use in source and binary forms, with or without modification, are permitted without 322228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectpayment of copyright license fees provided that you satisfy the following conditions: 332228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 342228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectYou must retain the complete text of this software license in redistributions of the FDK AAC Codec or 352228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectyour modifications thereto in source code form. 362228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 372228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectYou must retain the complete text of this software license in the documentation and/or other materials 382228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectprovided with redistributions of the FDK AAC Codec or your modifications thereto in binary form. 392228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectYou must make available free of charge copies of the complete source code of the FDK AAC Codec and your 402228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectmodifications thereto to recipients of copies in binary form. 412228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 422228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectThe name of Fraunhofer may not be used to endorse or promote products derived from this library without 432228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectprior written permission. 442228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 452228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectYou may not charge copyright license fees for anyone to use, copy or distribute the FDK AAC Codec 462228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectsoftware or your modifications thereto. 472228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 482228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectYour modified versions of the FDK AAC Codec must carry prominent notices stating that you changed the software 492228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectand the date of any change. For modified versions of the FDK AAC Codec, the term 502228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project"Fraunhofer FDK AAC Codec Library for Android" must be replaced by the term 512228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project"Third-Party Modified Version of the Fraunhofer FDK AAC Codec Library for Android." 522228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 532228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project3. NO PATENT LICENSE 542228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 552228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectNO EXPRESS OR IMPLIED LICENSES TO ANY PATENT CLAIMS, including without limitation the patents of Fraunhofer, 562228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectARE GRANTED BY THIS SOFTWARE LICENSE. Fraunhofer provides no warranty of patent non-infringement with 572228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectrespect to this software. 582228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 592228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectYou may use this FDK AAC Codec software or modifications thereto only for purposes that are authorized 602228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectby appropriate patent licenses. 612228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 622228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project4. DISCLAIMER 632228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 642228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectThis FDK AAC Codec software is provided by Fraunhofer on behalf of the copyright holders and contributors 652228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project"AS IS" and WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, including but not limited to the implied warranties 662228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectof merchantability and fitness for a particular purpose. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR 672228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectCONTRIBUTORS BE LIABLE for any direct, indirect, incidental, special, exemplary, or consequential damages, 682228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectincluding but not limited to procurement of substitute goods or services; loss of use, data, or profits, 692228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projector business interruption, however caused and on any theory of liability, whether in contract, strict 702228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectliability, or tort (including negligence), arising in any way out of the use of this software, even if 712228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectadvised of the possibility of such damage. 722228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 732228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project5. CONTACT INFORMATION 742228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 752228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectFraunhofer Institute for Integrated Circuits IIS 762228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectAttention: Audio and Multimedia Departments - FDK AAC LL 772228e360595641dd906bf1773307f43d304f5b2The Android Open Source ProjectAm Wolfsmantel 33 782228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project91058 Erlangen, Germany 792228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 802228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectwww.iis.fraunhofer.de/amm 812228e360595641dd906bf1773307f43d304f5b2The Android Open Source Projectamm-info@iis.fraunhofer.de 822228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project----------------------------------------------------------------------------------------------------------- */ 832228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 842228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/************************** Fraunhofer IIS FDK SysLib ********************** 852228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 862228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project Author(s): 872228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 882228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project******************************************************************************/ 892228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 902228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \file machine_type.h 912228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \brief Type defines for various processors and compiler tools. 922228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 932228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 942228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#if !defined(__MACHINE_TYPE_H__) 952228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#define __MACHINE_TYPE_H__ 962228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 972228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 982228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/* Library calling convention spec. __cdecl and friends might be added here as required. */ 992228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LINKSPEC_H 1002228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LINKSPEC_CPP 1012228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1022228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1032228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** 1042228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * collate all corresponding compiler specific macros to detect a debug build, and set the DEBUG macro if that is the case. 1052228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1062228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#if defined(_DEBUG) 1072228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#define DEBUG 1082228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 1092228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1102228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1112228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/* for doxygen the following docu parts must be separated */ 1122228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var SCHAR 1132228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing at least 1 byte signed integer on all supported platforms. 1142228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1152228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var UCHAR 1162228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing at least 1 byte unsigned integer on all supported platforms. 1172228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1182228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var INT 1192228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing at least 4 byte signed integer on all supported platforms. 1202228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1212228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var UINT 1222228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing at least 4 byte unsigned integer on all supported platforms. 1232228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1242228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var LONG 1252228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing 4 byte signed integer on all supported platforms. 1262228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1272228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var ULONG 1282228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing 4 byte unsigned integer on all supported platforms. 1292228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1302228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var SHORT 1312228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing 2 byte signed integer on all supported platforms. 1322228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1332228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var USHORT 1342228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing 2 byte unsigned integer on all supported platforms. 1352228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1362228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var INT64 1372228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing 8 byte signed integer on all supported platforms. 1382228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1392228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var UINT64 1402228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing 8 byte unsigned integer on all supported platforms. 1412228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1422228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \def SHORT_BITS 1432228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Number of bits the data type short represents. sizeof() is not suited to get this info, 1442228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * because a byte is not always defined as 8 bits. 1452228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1462228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \def CHAR_BITS 1472228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Number of bits the data type char represents. sizeof() is not suited to get this info, 1482228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * because a byte is not always defined as 8 bits. 1492228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1502228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/** \var INT_PCM 1512228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Data type representing the width of input and output PCM samples. 1522228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 1532228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1542228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1552228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef signed int INT; 1562228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef unsigned int UINT; 157f2f96fb86d42396716b3e556da7a930956e712fbMarcus Oakland#ifdef __LP64__ 1582228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project /* force FDK long-datatypes to 4 byte */ 1592228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project /* jdr: Use defines to avoid type alias problems on 64 bit machines. */ 1602228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LONG INT 1612228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define ULONG UINT 162f2f96fb86d42396716b3e556da7a930956e712fbMarcus Oakland#else /* __LP64__ */ 1632228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef signed long LONG; 1642228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef unsigned long ULONG; 165f2f96fb86d42396716b3e556da7a930956e712fbMarcus Oakland#endif /* __LP64__ */ 1662228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef signed short SHORT; 1672228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef unsigned short USHORT; 1682228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef signed char SCHAR; 1692228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef unsigned char UCHAR; 1702228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1712228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define SHORT_BITS 16 1722228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define CHAR_BITS 8 1732228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1742228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1752228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/* Define 64 bit base integer type. */ 176577fcbb570d023be4cea9564292dd2bd95f40c3bJean-Michel Trivi#ifdef _MSC_VER 1772228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef __int64 INT64; 1782228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef unsigned __int64 UINT64; 1792228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#else 1802228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef long long INT64; 1812228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef unsigned long long UINT64; 1822228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 1832228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1842228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#ifndef NULL 1852228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #ifdef __cplusplus 1862228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define NULL 0 1872228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #else 1882228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define NULL ((void *)0) 1892228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #endif 1902228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 1912228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 1922228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/* Assert is functional on x86 PC's and also when debugging is turned on. */ 1932228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#if defined(DEBUG) || defined(__i686__) || defined(__i586__) || defined(__i386__) || defined(__x86_64__) || defined(_M_IX86) || defined(FDK_DEBUG) || defined(FDK_ASSERT_ENABLE) 1942228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #include <assert.h> 1952228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define FDK_ASSERT(x) assert(x) 1962228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#else 1972228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define FDK_ASSERT(ignore) 1982228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 1992228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2002228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project typedef SHORT INT_PCM; 2012228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define WAV_BITS 16 2022228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define SAMPLE_BITS 16 2032228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define SAMPLE_MAX (((LONG)1<<(SAMPLE_BITS-1))-1) 2042228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define SAMPLE_MIN (~SAMPLE_MAX) 2052228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2062228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*! 2072228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* \def RAM_ALIGN 2082228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* Used to align memory as prefix before memory declaration. For example: 2092228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project \code 2102228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project RAM_ALIGN 2112228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project int myArray[16]; 2122228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project \endcode 2132228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2142228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project Note, that not all platforms support this mechanism. For example with TI compilers 2152228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project a preprocessor pragma is used, but to do something like 2162228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2172228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project \code 2182228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define RAM_ALIGN #pragma DATA_ALIGN(x) 2192228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project \encode 2202228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2212228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project would require the preprocessor to process this line twice to fully resolve it. Hence, 2222228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project a fully platform-independant way to use alignment is not supported. 2232228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2242228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* \def ALIGNMENT_DEFAULT 2252228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* Default alignment in bytes. 2262228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project*/ 2272228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#if defined(__GNUC__) /* cppp replaced: elif */ 2282228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define ALIGNMENT_DEFAULT 8 2292228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define RAM_ALIGN __attribute__((aligned(ALIGNMENT_DEFAULT))) 2302228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#else 2312228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define ALIGNMENT_DEFAULT 8 2322228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define RAM_ALIGN 2332228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 2342228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2352228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2362228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*! 2372228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* \def RESTRICT 2382228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* The restrict keyword is supported by some platforms and RESTRICT maps to 2392228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* either the corresponding keyword on each platform or to void if the 2402228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* compiler does not provide such feature. 2412228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* 2422228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* \def WORD_ALIGNED(x) 2432228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* Tells the compiler that pointer x is WORD aligned. 2442228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* At the moment only supported by TI compilers. 2452228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* 2462228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* \def DWORD_ALIGNED(x) 2472228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* Tells the compiler that pointer x is DWORD aligned. 2482228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project* At the moment only supported by TI compilers. 2492228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project*/ 2502228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define RESTRICT 2512228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define WORD_ALIGNED(x) 2522228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define DWORD_ALIGNED(x) 2532228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2542228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2552228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*----------------------------------------------------------------------------------- 2562228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * ALIGN_SIZE 2572228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project *-----------------------------------------------------------------------------------*/ 2582228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*! 2592228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \brief This macro aligns a given value depending on ::ALIGNMENT_DEFAULT. 2602228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * 2612228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * For example if #ALIGNMENT_DEFAULT equals 8, then: 2622228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * - ALIGN_SIZE(3) returns 8 2632228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * - ALIGN_SIZE(8) returns 8 2642228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * - ALIGN_SIZE(9) returns 16 2652228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 2662228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#define ALIGN_SIZE(a) ((a)+ (((INT)ALIGNMENT_DEFAULT - ((INT)(a) & (ALIGNMENT_DEFAULT-1)) ) & (ALIGNMENT_DEFAULT-1))) 2672228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2682228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*----------------------------------------------------------------------------------- 2692228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * ALIGN_PTR 2702228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * cast (a) to width of pointer 2712228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project *-----------------------------------------------------------------------------------*/ 2722228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*! 2732228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \brief This macro aligns a given address depending on ::ALIGNMENT_DEFAULT. 2742228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 2752228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#define ALIGN_PTR(a) ( (unsigned char*)(a) + (((INT)ALIGNMENT_DEFAULT - ((INT)(UINT64)(a) & (ALIGNMENT_DEFAULT-1)) ) & (ALIGNMENT_DEFAULT-1)) ) 2762228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2772228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project /* Alignment macro for libSYS heap implementation */ 2782228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#define ALIGNMENT_EXTRES ( ALIGNMENT_DEFAULT ) 2792228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#define ALGN_SIZE_EXTRES(a) ((a)+ (((INT)ALIGNMENT_EXTRES - ((INT)(a) & (ALIGNMENT_EXTRES-1)) ) & (ALIGNMENT_EXTRES-1))) 2802228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2812228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 2822228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*! 2832228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def FORCEINLINE 2842228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Sometimes compiler do not do what they are told to do, and in case of inlining some 2852228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * additional command might be necessary depending on the platform. 2862228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * 2872228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def FDK_INLINE 2882228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Defines how the compiler is told to inline stuff. 2892228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 2902228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#ifdef DEBUG 2912228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#undef FORCEINLINE 2922228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#define FORCEINLINE 2932228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#else 2942228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#ifndef FORCEINLINE 2952228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #if defined(__GNUC__) /* cppp replaced: elif */ 2962228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define FORCEINLINE __attribute((always_inline)) 2972228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #else 2982228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define FORCEINLINE 2992228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #endif 3002228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 3012228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 3022228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3032228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project /* for all other platforms */ 3042228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define FDK_INLINE inline 3052228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3062228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3072228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/*! 3082228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_DATA_L1 3092228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * The LNK_SECTION_* defines allow memory to be drawn from specific memory 3102228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * sections. Used as prefix before variable declaration. 3112228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * 3122228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_DATA_L2 3132228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3142228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_L1_DATA_A 3152228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3162228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_L1_DATA_B 3172228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3182228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_CONSTDATA_L1 3192228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3202228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_CONSTDATA 3212228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3222228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_CODE_L1 3232228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3242228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_CODE_L2 3252228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3262228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * \def LNK_SECTION_INITCODE 3272228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * See ::LNK_SECTION_DATA_L1 3282228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 3292228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/************************************************** 3302228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Code Section macros 3312228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project **************************************************/ 3322228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_CODE_L1 3332228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_CODE_L2 3342228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_INITCODE 3352228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3362228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project/* Memory section macros. */ 3372228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3382228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project /* default fall back */ 3392228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_DATA_L1 3402228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_DATA_L2 3412228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_CONSTDATA 3422228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_CONSTDATA_L1 3432228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3442228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_L1_DATA_A 3452228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #define LNK_SECTION_L1_DATA_B 3462228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3472228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3482228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#ifdef _MSC_VER 3492228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project /* 3502228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * Sometimes certain features are excluded from compilation and therefore the warning 4065 may occur: 3512228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * "switch statement contains 'default' but no 'case' labels" 3522228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project * We consider this warning irrelevant and disable it. 3532228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project */ 3542228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project #pragma warning( disable : 4065 ) 3552228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif 3562228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project 3572228e360595641dd906bf1773307f43d304f5b2The Android Open Source Project#endif /* __MACHINE_TYPE_H__ */ 358