Freescale Semiconductor I.MX 6Solo Manuale utente

i.MX 6Solo/6DualLite Linux Reference

Manual

Document Number: IMX6SDLLXRM

Rev L3.0.35_4.1.0, 09/2013

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

2 Freescale Semiconductor, Inc.

Contents

Section number Title Page

Chapter 1

About This Book

1.1 Audience.......................................................................................................................................................................23

1.1.1 Conventions.....................................................................................................................................................23

1.1.2 Definitions, Acronyms, and Abbreviations......................................................................................................23

Chapter 2

Introduction

2.1 Overview.......................................................................................................................................................................27

2.1.1 Software Base..................................................................................................................................................27

2.1.2 Features............................................................................................................................................................27

Chapter 3

Machine Specific Layer (MSL)

3.1 Introduction...................................................................................................................................................................33

3.2 Interrupts (Operation)...................................................................................................................................................34

3.2.1 Interrupt Hardware Operation..........................................................................................................................34

3.2.2 Interrupt Software Operation...........................................................................................................................34

3.2.3 Interrupt Features.............................................................................................................................................35

3.2.4 Interrupt Source Code Structure......................................................................................................................35

3.2.5 Interrupt Programming Interface.....................................................................................................................35

3.3 Timer.............................................................................................................................................................................36

3.3.1 Timer Software Operation...............................................................................................................................36

3.3.2 Timer Features.................................................................................................................................................36

3.3.3 Timer Source Code Structure...........................................................................................................................37

3.3.4 Timer Programming Interface..........................................................................................................................37

3.4 Memory Map................................................................................................................................................................37

3.4.1 Memory Map Hardware Operation..................................................................................................................37

3.4.2 Memory Map Software Operation...................................................................................................................37

3.4.3 Memory Map Features.....................................................................................................................................37

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

Freescale Semiconductor, Inc. 3

Section number Title Page

3.4.4 Memory Map Source Code Structure..............................................................................................................38

3.4.5 Memory Map Programming Interface.............................................................................................................38

3.5 IOMUX.........................................................................................................................................................................38

3.5.1 IOMUX Hardware Operation..........................................................................................................................39

3.5.2 IOMUX Software Operation............................................................................................................................39

3.5.3 IOMUX Features..............................................................................................................................................40

3.5.4 IOMUX Source Code Structure.......................................................................................................................40

3.5.5 IOMUX Programming Interface......................................................................................................................40

3.5.6 IOMUX Control Through GPIO Module........................................................................................................40

3.5.6.1 GPIO Hardware Operation...............................................................................................................41

3.5.6.1.1 Muxing Control...............................................................................................................41

3.5.6.1.2 PULLUP Control............................................................................................................41

3.5.6.2 GPIO Software Operation (general)................................................................................................41

3.5.6.3 GPIO Implementation......................................................................................................................41

3.5.6.4 GPIO Source Code Structure...........................................................................................................42

3.5.6.5 GPIO Programming Interface..........................................................................................................42

3.6 General Purpose Input/Output(GPIO)..........................................................................................................................42

3.6.1 GPIO Software Operation................................................................................................................................42

3.6.1.1 API for GPIO...................................................................................................................................43

3.6.2 GPIO Features..................................................................................................................................................43

3.6.3 GPIO Module Source Code Structure..............................................................................................................43

3.6.4 GPIO Programming Interface 2.......................................................................................................................44

Chapter 4

Smart Direct Memory Access (SDMA) API

4.1 Overview.......................................................................................................................................................................45

4.1.1 Hardware Operation.........................................................................................................................................45

4.1.2 Software Operation..........................................................................................................................................45

4.1.3 Source Code Structure.....................................................................................................................................46

4.1.4 Menu Configuration Options...........................................................................................................................47

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

4 Freescale Semiconductor, Inc.

Section number Title Page

4.1.5 Programming Interface....................................................................................................................................47

4.1.6 Usage Example................................................................................................................................................47

Chapter 5

AHB-to-APBH Bridge with DMA (APBH-Bridge-DMA)

5.1 Overview.......................................................................................................................................................................49

5.1.1 Hardware Operation.........................................................................................................................................49

5.1.2 Software Operation..........................................................................................................................................50

5.1.3 Source Code Structure.....................................................................................................................................50

5.1.4 Menu Configuration Options...........................................................................................................................51

5.1.5 Programming Interface....................................................................................................................................51

5.1.6 Usage Example................................................................................................................................................51

Chapter 6

Image Processing Unit (IPU) Drivers

6.1 Introduction...................................................................................................................................................................53

6.2 Hardware Operation......................................................................................................................................................55

6.3 Software Operation.......................................................................................................................................................55

6.3.1 Overview of IPU Frame Buffer Drivers..........................................................................................................56

6.3.1.1 IPU Frame Buffer Hardware Operation...........................................................................................57

6.3.1.2 IPU Frame Buffer Software Operation............................................................................................57

6.3.1.3 Synchronous Frame Buffer Driver...................................................................................................58

6.3.2 IPU Backlight Driver.......................................................................................................................................59

6.3.3 IPU Device Driver...........................................................................................................................................59

6.4 Source Code Structure .................................................................................................................................................60

6.4.1 Menu Configuration Options...........................................................................................................................61

6.5 Unit Test........................................................................................................................................................................64

6.5.1 Framebuffer Tests............................................................................................................................................65

6.5.2 Video4Linux API test......................................................................................................................................65

6.5.3 IPU Device Unit test........................................................................................................................................66

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

Freescale Semiconductor, Inc. 5

Section number Title Page

Chapter 7

MIPI DSI Driver

7.1 Introduction...................................................................................................................................................................71

7.1.1 Overview of MIPI DSI IP Driver.....................................................................................................................71

7.1.2 Overview of MIPI DSI Display Panel Driver..................................................................................................72

7.1.3 Hardware Operation.........................................................................................................................................72

7.2 Software Operation.......................................................................................................................................................72

7.2.1 MIPI DSI IP Driver Software Operation.........................................................................................................72

7.2.2 MIPI DSI Display Panel Driver Software Operation.......................................................................................73

7.3 Driver Features..............................................................................................................................................................73

7.3.1 Source Code Structure.....................................................................................................................................74

7.3.2 Menu Configuration Options...........................................................................................................................74

7.3.3 Programming Interface....................................................................................................................................74

Chapter 8

Video for Linux Two (V4L2) Driver

8.1 Introduction...................................................................................................................................................................75

8.2 V4L2 Capture Device...................................................................................................................................................76

8.2.1 V4L2 Capture IOCTLs....................................................................................................................................76

8.2.2 Using the V4L2 Capture APIs.........................................................................................................................78

8.3 V4L2 Output Device.....................................................................................................................................................79

8.3.1 V4L2 Output IOCTLs......................................................................................................................................79

8.3.2 Using the V4L2 Output APIs...........................................................................................................................80

8.4 Source Code Structure .................................................................................................................................................80

8.4.1 Menu Configuration Options...........................................................................................................................81

8.4.2 V4L2 Programming Interface..........................................................................................................................81

Chapter 9

Electrophoretic Display Controller (EPDC) Frame Buffer Driver

9.1 Introduction...................................................................................................................................................................83

9.2 Hardware Operation......................................................................................................................................................84

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

6 Freescale Semiconductor, Inc.

Section number Title Page

9.3 Software Operation.......................................................................................................................................................84

9.3.1 EPDC Frame Buffer Driver Overview.............................................................................................................84

9.3.2 EPDC Frame Buffer Driver Extensions...........................................................................................................85

9.3.3 EPDC Panel Configuration..............................................................................................................................85

9.3.3.1 Boot Command Line Parameters.....................................................................................................86

9.3.4 EPDC Waveform Loading...............................................................................................................................87

9.3.4.1 Using a Default Waveform File.......................................................................................................87

9.3.4.2 Using a Custom Waveform File.......................................................................................................88

9.3.5 EPDC Panel Initialization................................................................................................................................88

9.3.6 Grayscale Framebuffer Selection.....................................................................................................................89

9.3.7 Enabling An EPDC Splash Screen...................................................................................................................89

9.4 Source Code Structure .................................................................................................................................................90

9.5 Menu Configuration Options........................................................................................................................................90

9.6 Programming Interface.................................................................................................................................................91

9.6.1 IOCTLs/Functions...........................................................................................................................................91

9.6.2 Structures and Defines.....................................................................................................................................94

Chapter 10

Pixel Pipeline (PxP) DMA-ENGINE Driver

10.1 Introduction...................................................................................................................................................................97

10.2 Hardware Operation......................................................................................................................................................97

10.3 Software Operation.......................................................................................................................................................97

10.3.1 Key Data Structs..............................................................................................................................................97

10.3.2 Channel Management......................................................................................................................................98

10.3.3 Descriptor Management...................................................................................................................................98

10.3.4 Completion Notification..................................................................................................................................98

10.3.5 Limitations.......................................................................................................................................................99

10.4 Menu Configuration Options........................................................................................................................................99

10.5 Source Code Structure..................................................................................................................................................99

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

Freescale Semiconductor, Inc. 7

Section number Title Page

Chapter 11

Graphics Processing Unit (GPU)

11.1 Introduction...................................................................................................................................................................101

11.1.1 Driver Features.................................................................................................................................................101

11.1.1.1 Hardware Operation.........................................................................................................................101

11.1.1.2 Software Operation..........................................................................................................................102

11.1.1.3 Source Code Structure ....................................................................................................................102

11.1.1.4 Library Structure .............................................................................................................................102

11.1.1.5 API References................................................................................................................................104

11.1.1.6 Menu Configuration Options...........................................................................................................104

Chapter 12

Direct FB

12.1 Introduction...................................................................................................................................................................105

12.1.1 Hardware Operation.........................................................................................................................................105

12.2 Software Operation.......................................................................................................................................................105

12.2.1 DirectFB Acceleration Architecture................................................................................................................106

12.2.2 i.MX DirectFB Driver Details.........................................................................................................................107

12.2.3 The gal_config File for i.MX DirectFB Driver................................................................................................107

12.3 DirectFB EGL...............................................................................................................................................................109

12.4 Setting Up DirectFB Acceleration................................................................................................................................109

Chapter 13

HDMI Driver

13.1 Introduction...................................................................................................................................................................111

13.1.1 Hardware Operation.........................................................................................................................................111

13.2 Software Operation.......................................................................................................................................................113

13.2.1 Core..................................................................................................................................................................113

13.2.2 Video................................................................................................................................................................114

13.2.3 Display Device Registration and Initialization................................................................................................115

13.2.4 Hotplug Handling and Video Mode Changes..................................................................................................116

13.2.5 Audio................................................................................................................................................................116

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

8 Freescale Semiconductor, Inc.

Section number Title Page

13.2.6 CEC..................................................................................................................................................................118

13.3 Source Code Structure..................................................................................................................................................118

13.3.1 Linux Menu Configuration Options.................................................................................................................120

13.4 Unit Test........................................................................................................................................................................121

13.4.1 Video................................................................................................................................................................121

13.4.2 Audio................................................................................................................................................................122

13.4.3 CEC..................................................................................................................................................................122

Chapter 14

X Windows Acceleration

14.1 Introduction...................................................................................................................................................................123

14.2 Hardware Operation......................................................................................................................................................123

14.3 Software Operation.......................................................................................................................................................123

14.3.1 X Windows Acceleration Architecture............................................................................................................124

14.3.2 i.MX 6 Driver for X-Windows System............................................................................................................125

14.3.3 i.MX 6 Direct Rendering Infrastructure (DRI) for X-Windows System.........................................................127

14.3.4 EGL- X Library................................................................................................................................................128

14.3.5 xorg.conf for i.MX 6........................................................................................................................................128

14.3.6 Setup X-Windows System Acceleration..........................................................................................................130

Chapter 15

Video Processing Unit (VPU) Driver

15.1 Hardware Operation......................................................................................................................................................133

15.1.1 Software Operation..........................................................................................................................................134

15.1.2 Source Code Structure.....................................................................................................................................135

15.1.3 Menu Configuration Options...........................................................................................................................136

15.1.4 Programming Interface....................................................................................................................................137

15.1.5 Defining an Application...................................................................................................................................138

Chapter 16

OmniVision Camera Driver

16.1 OV5640 Using MIPI CSI-2 interface...........................................................................................................................139

16.1.1 Hardware Operation.........................................................................................................................................139

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

Freescale Semiconductor, Inc. 9

Section number Title Page

16.1.2 Software Operation..........................................................................................................................................139

16.1.3 Source Code Structure.....................................................................................................................................140

16.1.4 Linux Menu Configuration Options.................................................................................................................140

16.2 OV5640 Using parallel interface..................................................................................................................................141

16.2.1 Hardware Operation.........................................................................................................................................141

16.2.2 Software Operation..........................................................................................................................................141

16.2.3 Source Code Structure.....................................................................................................................................142

16.2.4 Linux Menu Configuration Options.................................................................................................................142

Chapter 17

MIPI CSI2 Driver

17.1 Introduction...................................................................................................................................................................143

17.1.1 MIPI CSI2 Driver Overview............................................................................................................................143

17.1.2 Hardware Operation.........................................................................................................................................144

17.2 Software Operation.......................................................................................................................................................144

17.2.1 MIPI CSI2 Driver Initialize Operation............................................................................................................144

17.2.2 MIPI CSI2 Common API Operation................................................................................................................145

17.3 Driver Features..............................................................................................................................................................145

17.3.1 Source Code Structure.....................................................................................................................................146

17.3.2 Menu Configuration Options...........................................................................................................................146

17.3.3 Programming Interface....................................................................................................................................146

17.3.4 Interrupt Requirements....................................................................................................................................147

Chapter 18

Low-level Power Management (PM) Driver

18.1 Hardware Operation......................................................................................................................................................149

18.1.1 Software Operation..........................................................................................................................................149

18.1.2 Source Code Structure.....................................................................................................................................150

18.1.3 Menu Configuration Options...........................................................................................................................150

18.1.4 Programming Interface....................................................................................................................................151

18.1.5 Unit Test...........................................................................................................................................................151

i.MX 6Solo/6DualLite Linux Reference Manual, Rev. L3.0.35_4.1.0, 09/2013

10 Freescale Semiconductor, Inc.

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali Freescale Semiconductor Hardware per computer

Freescale Semiconductor

Freescale Semiconductor MPC8349E PowerQUICC II Pro Manuale utente

Freescale Semiconductor

Freescale Semiconductor NXP 56F8014 Manuale utente

Freescale Semiconductor

Freescale Semiconductor SC140 DSP Core Manuale utente

Freescale Semiconductor

Freescale Semiconductor USB-KW24D512 Manuale utente

Freescale Semiconductor

Freescale Semiconductor PowerQUICC III Istruzioni per l'installazione e il funzionamento

Freescale Semiconductor

Freescale Semiconductor TWR-MPC8309 Manuale utente

Freescale Semiconductor

Freescale Semiconductor EVB9S12NE64 Manuale utente

Freescale Semiconductor

Freescale Semiconductor e200z3 Manuale utente

Freescale Semiconductor

Freescale Semiconductor MCF5480 Manuale utente

Freescale Semiconductor

Freescale Semiconductor PowerPC MPC823 Manuale utente

Freescale Semiconductor

Freescale Semiconductor Motorola MMDS0508 Manuale utente

Freescale Semiconductor

Freescale Semiconductor EVBCRTOUCH Manuale utente

Freescale Semiconductor

Freescale Semiconductor MSC8144E Manuale utente

Freescale Semiconductor

Freescale Semiconductor TWR-VF65GS10 Manuale utente

Freescale Semiconductor

Freescale Semiconductor MC68HC08KH12 Manuale utente

Freescale Semiconductor

Freescale Semiconductor FRDM-KL25Z Manuale utente

Freescale Semiconductor

Freescale Semiconductor TWR-K60D100M Manuale utente

Freescale Semiconductor

Freescale Semiconductor FRDM-STBC-SA9500 Guida di riferimento

Freescale Semiconductor

Freescale Semiconductor FRDM-K64F Manuale utente

Freescale Semiconductor

Freescale Semiconductor TWR-WIFI-G1011MI Manuale utente

Freescale Semiconductor

Freescale Semiconductor i.MX27 PDK 1.0 Manuale utente

Freescale Semiconductor

Freescale Semiconductor MPC8349EA PowerQUICC II Pro Manuale utente

Freescale Semiconductor

Freescale Semiconductor Demonstration Board DEMO9S08AC60E Manuale utente

Freescale Semiconductor

Freescale Semiconductor MC68HC908MR16 Manuale utente

Manuali Hardware per computer popolari di altre marche

EMC2

EMC2 VNX Series Manuale del proprietario

Panasonic

Panasonic DV0PM20105 Manuale utente

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Manuale utente

Gigabyte

Gigabyte B660M DS3H AX DDR4 Manuale utente

Raidon

Raidon iT2300 Manuale utente

National Instruments

National Instruments PXI-8186 Manuale utente

Hauppauge

Hauppauge WinTV-HVR-2250 Manuale utente

Kontron

Kontron CP6002 Manuale utente

Manhattan

Manhattan 702843 Manuale utente

Aphex

Aphex 230 Manuale utente

AMD

AMD Phenom II Manuale operativo

Intel

Intel NUC 12 Pro Manuale utente

dbx

dbx Zone Pro 1260 Manuale utente

Galaxy

Galaxy GHDX2-2430S-24F4D Manuale utente

Intel

Intel AXXRMFBU4 Manuale utente

Kontron

Kontron DIMM-PC/MD Manuale utente

ST X-NUCLEO-SAFEA1B Istruzioni operative

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Manuale utente

Freescale Semiconductor i.MX 6Solo Manuale utente

Manuali Hardware per computer popolari di altre marche