Contents

AN4503

2/26

DocID026411 Rev 2

Contents

1

Document overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.1

Android sensor HAL overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

1.1.1

Kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.1.2

Sensor libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

1.1.3

Application framework . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2

Test environment / ecosystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2.1

Connecting the sensors to the PandaBoard . . . . . . . . . . . . . . . . . . . . . . . . 6

2.2

Specific settings for the Ubuntu 13.04 environment . . . . . . . . . . . . . . . . . . 7

2.3

Building Android KitKat-4.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

2.3.1

Downloading the packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

2.3.2

Apply required patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.3.3

Compile the sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

2.3.4

Flash the image to the PandaBoard SD card . . . . . . . . . . . . . . . . . . . . 11

3

Linux kernel space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3.1

Overview of the environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3.1.1

I²C bus initialization patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3.1.2

I²C_board_info structure patch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.1.3

As an example of platform_data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.1.4

After rebuilding the kernel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.2

Driver description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3.2.1

How to build and install the device drivers . . . . . . . . . . . . . . . . . . . . . . . 13

3.2.2

Controlling the device drivers from Linux user space . . . . . . . . . . . . . . 14

3.3

Permission setting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.4

Output data from the driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.4.1

Where to find the data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

3.4.2

Sample application for reading data . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4

Android sensor HAL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.1.1

Sensor libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.2

Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18