1.1 Assembler and Preprocessor Manual (including ADSP-BFxxx and ADSP-21xxx) Revision 1.3, May 2014 Part Number 82-100121-01 Analog Devices, Inc. One Technology Way Norwood, Mass. 02062-9106 a Copyright Information ©2014 Analog Devices, Inc., ALL RIGHTS RESERVED. This document may not be reproduced in any form without prior, express written consent from Analog Devices, Inc. Printed in the USA. Disclaimer Analog Devices, Inc. reserves the right to change this product without prior notice. Information furnished by Analog Devices is believed to be accurate and reliable. However, no responsibility is assumed by Analog Devices for its use; nor for any infringement of patents or other rights of third parties which may result from its use. No license is granted by implication or otherwise under the patent rights of Analog Devices, Inc. Trademark and Service Mark Notice The Analog Devices logo, Blackfin, SHARC, EngineerZone, VisualDSP++, CrossCore Embedded Studio, EZ-KIT Lite, and EZ-Board are registered trademarks of Analog Devices, Inc. Blackfin+ is a trademark of Analog Devices, Inc. All other brand and product names are trademarks or service marks of their respective owners. CrossCore Embedded Studio 1.1.0 Assembler and Preprocessor Manual 2 Revision 1.3, May 2014 Contents Contents Chapter 1: Preface...................................................................................................................7 Purpose of This Manual......................................................................................................................................................................................7 Intended Audience............................................................................................................................................................................................. 7 Manual Contents.................................................................................................................................................................................................7 What's New in This Manual................................................................................................................................................................................ 8 Technical Support...............................................................................................................................................................................................8 Supported Processors........................................................................................................................................................................................ 8 Product Information...........................................................................................................................................................................................9 Analog Devices Web Site.........................................................................................................................................................................................................9 EngineerZone.......................................................................................................................................................................................................................... 9 Notation Conventions........................................................................................................................................................................................ 9 Chapter 2: Assembler........................................................................................................... 11 Assembler Guide...............................................................................................................................................................................................11 Assembler Overview............................................................................................................................................................................................................. 12 Writing Assembly Programs.................................................................................................................................................................................................12 Using Assembler Support for C Structs............................................................................................................................................................................... 18 Preprocessing a Program......................................................................................................................................................................................................20 Using Assembler Feature Macros.........................................................................................................................................................................................21 Generating Make Dependencies..........................................................................................................................................................................................37 Reading a Listing File............................................................................................................................................................................................................ 38 Assembler Syntax Reference........................................................................................................................................................................... 38 Assembler Keywords and Symbols...................................................................................................................................................................................... 38 Assembler Expressions......................................................................................................................................................................................................... 43 Assembler Operators............................................................................................................................................................................................................ 44 Numeric Formats................................................................................................................................................................................................................... 47 Comment Conventions......................................................................................................................................................................................................... 50 Conditional Assembly Directives......................................................................................................................................................................................... 50 C Struct Support in Assembly Built-In Functions................................................................................................................................................................52 Struct References...................................................................................................................................................................................................................53 Assembler Directives............................................................................................................................................................................................................ 55 Assembler Command-Line Reference.............................................................................................................................................................97 Running the Assembler.........................................................................................................................................................................................................97 Assembler Command-Line Switch Descriptions.................................................................................................................................................................99 Specifying Assembler Options...........................................................................................................................................................................................116 Chapter 3: Preprocessor.....................................................................................................119 Preprocessor Guide........................................................................................................................................................................................ 119 Writing Preprocessor Commands...................................................................................................................................................................................... 120 Header Files and #include Command................................................................................................................................................................................121 Writing Macros.................................................................................................................................................................................................................... 123 Using Predefined Preprocessor Macros.............................................................................................................................................................................128