i.MX Linux® Reference Manual Document Number: IMXLXRM Rev. 0, 10/2016 i.MX Linux® Reference Manual, Rev. 0, 10/2016 2 NXP Semiconductors Contents Section number Title Page Chapter 1 About this Book 1.1 Audience....................................................................................................................................................................... 29 1.1.1 Conventions................................................................................................................................................... 29 1.1.2 Definitions, Acronyms, and Abbreviations....................................................................................................29 Chapter 2 Introduction 2.1 Overview.......................................................................................................................................................................33 2.1.1 Software Base................................................................................................................................................ 34 2.1.2 Features.......................................................................................................................................................... 34 Chapter 3 Machine-Specific Layer (MSL) 3.1 Introduction...................................................................................................................................................................39 3.2 Interrupts (Operation)................................................................................................................................................... 40 3.2.1 Interrupt Hardware Operation........................................................................................................................40 3.2.2 Interrupt Software Operation......................................................................................................................... 40 3.2.3 Interrupt Features........................................................................................................................................... 41 3.2.4 Interrupt Source Code Structure.................................................................................................................... 41 3.2.5 Interrupt Programming Interface................................................................................................................... 42 3.3 Interrupts.......................................................................................................................................................................42 3.3.1 Interrupt Hardware Operation 3780,MX28................................................................................................... 42 3.3.2 Interrupt Software Operation 3780, MX28....................................................................................................43 3.3.3 Interrupt Requirements.................................................................................................................................. 43 3.3.4 Interrupt Source Code Structure Implementation.......................................................................................... 43 3.3.5 Interrupt Programming Interface, 3780, MX28............................................................................................. 44 3.3.6 Interrupt Unit Test..........................................................................................................................................44 3.4 Timer.............................................................................................................................................................................44 3.4.1 Timer Hardware Operation............................................................................................................................ 45 i.MX Linux® Reference Manual, Rev. 0, 10/2016 NXP Semiconductors 3 Section number Title Page 3.4.2 Timer Hardware Operation 3780, MX28.......................................................................................................45 3.4.3 Timer Software Operation............................................................................................................................. 46 3.4.4 Timer Features............................................................................................................................................... 46 3.4.5 Timer Source Code Structure.........................................................................................................................46 3.4.6 Timer Programming Interface 3780...............................................................................................................46 3.4.7 Timer Programming Interface........................................................................................................................46 3.4.8 Timer Programming Interface........................................................................................................................47 3.4.9 Timer Unit Test..............................................................................................................................................47 3.5 Memory Map................................................................................................................................................................ 47 3.5.1 Memory Map Hardware Operation................................................................................................................47 3.5.2 Memory Map Software Operation................................................................................................................. 47 3.5.3 Memory Map Features................................................................................................................................... 48 3.5.4 Memory Map Source Code Structure............................................................................................................ 48 3.6 IOMUX.........................................................................................................................................................................49 3.6.1 IOMUX Hardware Operation........................................................................................................................ 49 3.6.2 IOMUX Software Operation..........................................................................................................................50 3.6.3 IOMUX Features............................................................................................................................................50 3.6.4 IOMUX Source Code Structure.....................................................................................................................50 3.6.5 IOMUX Programming Interface....................................................................................................................51 3.6.6 IOMUX Control Through GPIO Module...................................................................................................... 51 3.6.6.1 GPIO Hardware Operation...........................................................................................................51 3.6.6.1.1 Muxing Control...........................................................................................................51 3.6.6.1.2 PULLUP Control........................................................................................................ 52 3.6.6.2 GPIO Software Operation (general)............................................................................................ 52 3.6.6.3 GPIO Implementation.................................................................................................................. 52 3.7 General Purpose Input/Output(GPIO).......................................................................................................................... 52 3.7.1 GPIO Software Operation..............................................................................................................................52 3.7.1.1 API for GPIO............................................................................................................................... 53 3.7.2 GPIO Features................................................................................................................................................53 i.MX Linux® Reference Manual, Rev. 0, 10/2016 4 NXP Semiconductors Section number Title Page 3.7.3 GPIO Module Source Code Structure............................................................................................................53 3.7.4 GPIO Programming Interface 2..................................................................................................................... 54 Chapter 4 Smart Direct Memory Access (SDMA) API 4.1 Overview.......................................................................................................................................................................55 4.1.1 Hardware Operation.......................................................................................................................................55 4.1.2 Software Operation........................................................................................................................................ 55 4.1.3 Source Code Structure................................................................................................................................... 56 4.1.4 Programming Interface.................................................................................................................................