Freescale Semiconductor I.MX 6Solo Manuel utilisateur

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.

Ce manuel convient aux modèles suivants

Table des matières

Autres manuels Freescale Semiconductor Matériel informatique

Freescale Semiconductor

Freescale Semiconductor MCS08QG8 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor TWR-MCF51QM Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MC68HC908MR16 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor Target Interface MMDS0508 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor TWR-MPC8309 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MSC8144E Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MCF52277 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MPC8349E PowerQUICC II Pro Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor M68HC08 series Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor 56F8013 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MPC8349EA MDS Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor 1322x-USB Dongle Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MPC8569E-MDS-PB Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor i.MX31 PDK 1.4 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MPC8309 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MCF5480 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor M9328MX21ADSE Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor PowerPC MPC823 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor TWR-K60N512 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor FRDM-K64F Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor FRDM-KE06 Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor TWR-K60D100M Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor MPC8272ADS Manuel utilisateur

Freescale Semiconductor

Freescale Semiconductor DSP56366 Manuel utilisateur

Manuels Matériel informatique populaires d'autres marques

EMC2

EMC2 VNX Series Manuel du propriétaire

Panasonic

Panasonic DV0PM20105 Manuel utilisateur

Mitsubishi Electric

Mitsubishi Electric Q81BD-J61BT11 Manuel utilisateur

Gigabyte

Gigabyte B660M DS3H AX DDR4 Manuel utilisateur

Raidon

Raidon iT2300 Manuel utilisateur

National Instruments

National Instruments PXI-8186 Manuel utilisateur

Hauppauge

Hauppauge WinTV-HVR-2250 Manuel utilisateur

Kontron

Kontron CP6002 Manuel utilisateur

Manhattan

Manhattan 702843 Manuel utilisateur

Aphex

Aphex 230 Manuel utilisateur

AMD

AMD Phenom II Manuel d'exploitation

Intel

Intel NUC 12 Pro Manuel utilisateur

dbx

dbx Zone Pro 1260 Manuel utilisateur

Galaxy

Galaxy GHDX2-2430S-24F4D Manuel utilisateur

Intel

Intel AXXRMFBU4 Manuel utilisateur

Kontron

Kontron DIMM-PC/MD Manuel utilisateur

ST X-NUCLEO-SAFEA1B Mode d'emploi

STEINWAY LYNGDORF

STEINWAY LYNGDORF SP-1 Manuel utilisateur

Freescale Semiconductor i.MX 6Solo Manuel utilisateur

Manuels Matériel informatique populaires d'autres marques