ADP5520/01 MFD Linux驱动程序

消耗积分:0 | 格式:pdf | 大小:258.93KB | 2021-04-21

hxjq

分享资料个

This version (09 Oct 2015 16:26) was approved by Lars-Peter Clausen.The Previously approved version (05 Sep 2012 14:16) is available.

ADP5520/01 MFD Linux Driver

Supported Devices

Evaluation Boards

ADP5520-EVALZ

Description

The ADP5520/01 driver utilizes several Linux device-driver subsystems and provides various software interfaces. It is therefore implemented as a multifunction device (MFD). In this particular case the ADP5520 backlight driver and I/O expander, concurrently leverages the Linux backlight, LED, GPIO, and input subsystems for its keypad functionality.

Core

The ADP5520/01 core driver in drivers/mfd provides common services for the subsystem drivers. These services include register access, control and shared interrupt management.

The core registers/enumerates platform devices for the various subsystems via the platform device and driver system.

When a platform driver for one of the subsystems is instantiated, the core initializes the chip (which may be specified by the platform data).

The ADP5520/01 platform drivers follow the standard driver model convention, where discovery/enumeration is handled outside the drivers, and drivers provide probe() and remove() methods.

Resources

Each peripheral (subsystem device) has a view of the device which is implicitly narrowed to the specific set of resources that peripheral requires in order to function correctly.

Configuration

The device driver uses a set of platform data to pass configurations through to the core and the subsidiary drivers so that there can be support for multiple ADP5520/01 devices built into a single kernel image.

Software configurable features

Backlight:

Ambient Light Sensor Support
Configurable Fade On/Off times
Configurable Brightness/Intensity in 127 steps

LED:

Up to 3 LEDs configurable
Configurable Fade On/Off times
LED Blink On/Off times
Configurable Brightness/Intensity in 64 steps from [0..255]

Keypad:

Configurable keypad size matrix (rows, columns) up to 16 keys
Enabling and disabling automatic key repeat feature.

GPIO:

Configurable number of dedicated GPIOs, up to 8 GPIOs
Configurable Pull-Ups

Source Code

Status

Source	Mainlined?
git	Yes

Files

Function	File
MFD-CORE	drivers/mfd/adp5520.c
include	include/linux/mfd/adp5520.h
BACKLIGHT	drivers/video/backlight/adp5520_bl.c
LED	drivers/led/leds-adp5520.c
GPIO	drivers/gpio/adp5520-gpio.c¹⁾
KEYPAD	drivers/input/keyboard/adp5520-keys.c²⁾

Example platform device initialization

For compile time configuration, it’s common Linux practice to keep board- and application-specific configuration out of the main driver file, instead putting it into the board support file.

For devices on custom boards, as typical of embedded and SoC-(system-on-chip) based hardware, Linux uses platform_data to point to board-specific structures describing devices and how they are connected to the SoC. This can include available ports, chip variants, preferred modes, default initialization, additional pin roles, and so on. This shrinks the board-support packages (BSPs) and minimizes board and application specific #ifdefs in drivers.

21 Oct 2010 16:10

Since Keypad, GPIO and optional LEDs (2, 3) are multiplexed, you need to avoid double configurations. Please refer to the table below.

ADP5520 PIN	R3	R2	R1	R0	C0	C1	C2	C3
GPIO	GPIO_R3	GPIO_R2	GPIO_R1	GPIO_R0	GPIO_C0	GPIO_C1	GPIO_C2	GPIO_C3
Keypad	ROW_R3	ROW_R2	ROW_R1	ROW_R0	COL_C0	COL_C1	COL_C2	COL_C3
LED	LED3							LED2

Please refer to include/linux/mfd/adp5520.h for detailed configuration defines.

Backlight

LED

GPIO

Keypad

ADP5520/ADP5501 MFD Core Support

Declaring I2C devices

Unlike PCI or USB devices, I2C devices are not enumerated at the hardware level. Instead, the software must know which devices are connected on each I2C bus segment, and what address these devices are using. For this reason, the kernel code must instantiate I2C devices explicitly. There are different ways to achieve this, depending on the context and requirements. However the most common method is to declare the I2C devices by bus number.

This method is appropriate when the I2C bus is a system bus, as in many embedded systems, wherein each I2C bus has a number which is known in advance. It is thus possible to pre-declare the I2C devices that inhabit this bus. This is done with an array of struct i2c_board_info, which is registered by calling i2c_register_board_info().

So, to enable such a driver one need only edit the board support file by adding an appropriate entry to i2c_board_info.

For more information see: Documentation/i2c/instantiating-devices

21 Oct 2010 16:10

ADP5520 IRQ Usage:
If you aren’t planning to utilize the Keypad interface, you don’t need to specify an IRQ in bfin_i2c_board_info.

Adding Linux driver support

Fist of all you need to enable i2c support followed by the ADP5520 MFD Core Driver. Then you may select individual components like LCD backlight, LEDs, GPIOs and Keypad under the corresponding menus.

ADP5520 MFD Core Support

Device Drivers  ---> 
	<*> I2C support  --->
		<*> Blackfin TWI I2C support
		Or:
		<*> GPIO-based bitbanging I2C


Device Drivers  ---> 
	Multifunction device drivers  --->
		[*] Analog Devices ADP5520/01 MFD PMIC Core Support

Backlight

Device Drivers  ---> 
	Graphics support  --->
		[*] Backlight & LCD device support  --->
			<*>   Lowlevel Backlight controls
			     Backlight Driver for ADP5520/ADP5501 using WLED

LED

Device Drivers  --->
	[*] LED Support  --->
		<*>   LED Class Support
		   LED Support for ADP5520/ADP5501 PMIC

GPIO

Device Drivers  --->
	[*] GPIO Support  --->
		[*]   /sys/class/gpio/... (sysfs interface)
		   GPIO Support for ADP5520 PMIC

Keypad

Device Drivers  --->
	Input device support  --->
		<*> Generic input layer (needed for keyboard, mouse, ...)
		<*>   Event interface
		[*]   Keyboards  --->
			   Keypad Support for ADP5520 PMIC

Hardware configuration

There is no dedicated Blackfin STAMP evaluation board for the ADP5520. During test and driver development we used the ADP5520 Demo Mother/Daughter Board. Connect the ADP5520 Demo Mother to an USB port.

It can be easily wired to the Blackfin STAMP TWI/I2C header.

BF537-STAMP (P10) TWI/I2C header		ADP5520 Daughter Board
PIN	Function	PIN/Function
5	SCL	SCL
6	SDA	SDA
10	GPIO_PG0	nINT
20	GND	GND

Driver testing

Backlight

root:/> modprobe adp5520_bl
root:/>

root:/> cd sys/class/backlight/adp5520-backlight/
root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/backlight/adp5520-backlight> ls -l
-r--r--r--    1 root     root         4096 Nov 12 10:31 actual_brightness
-rw-r--r--    1 root     root         4096 Nov 12 10:31 bl_power
-rw-r--r--    1 root     root         4096 Nov 12 10:31 brightness
-rw-rw-r--    1 root     root         4096 Nov 12 10:31 dark_dim
-rw-rw-r--    1 root     root         4096 Nov 12 10:31 dark_max
-rw-rw-r--    1 root     root         4096 Nov 12 10:31 daylight_dim
-rw-rw-r--    1 root     root         4096 Nov 12 10:31 daylight_max
lrwxrwxrwx    1 root     root            0 Nov 12 10:31 device -> ../../../0-0032
-r--r--r--    1 root     root         4096 Nov 12 10:31 max_brightness
-rw-rw-r--    1 root     root         4096 Nov 12 10:31 office_dim
-rw-rw-r--    1 root     root         4096 Nov 12 10:31 office_max
drwxr-xr-x    2 root     root            0 Nov 12 10:31 power
lrwxrwxrwx    1 root     root            0 Nov 12 10:31 subsystem -> ../../../../../../../../class/backlight

root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/backlight/adp5520-backlight> echo 127 > brightness
root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/backlight/adp5520-backlight> echo 50 > brightness
root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/backlight/adp5520-backlight> echo 0 > brightness

For more information on Backlight handling in Linux read: Documentation/ABI/stable/sysfs-class-backlight

LED

root:/> modprobe leds-adp5520
Registered led device: adp5520-led1
Registered led device: adp5520-led2
Registered led device: adp5520-led3

root:/> cd sys/class/leds/adp5520-led
sys/class/leds/adp5520-led1/  sys/class/leds/adp5520-led3/
sys/class/leds/adp5520-led2/

root:/> cd sys/class/leds/adp5520-led1
root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/leds/adp5520-led1> ls -l
-rw-r--r--    1 root     root         4096 Nov 12 10:34 brightness
lrwxrwxrwx    1 root     root            0 Nov 12 10:34 device -> ../../../0-0032
drwxr-xr-x    2 root     root            0 Nov 12 10:34 power
lrwxrwxrwx    1 root     root            0 Nov 12 10:34 subsystem -> ../../../../../../../../class/leds
-rw-r--r--    1 root     root         4096 Nov 12 10:34 trigger
root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/leds/adp5520-led1> echo 10 > brightness
root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/leds/adp5520-led1> echo 255 > brightness
root:/sys/devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/leds/adp5520-led1> echo 0 > brightness

root:/> modprobe -r leds-adp5520
root:/>

For more information on LEDs handling in Linux read: Documentation/leds-class.txt

GPIO

root:/> modprobe adp5520-gpio
root:/> cd sys/class/gpio/gpiochip50/
root:/sys/devices/virtual/gpio/gpiochip50> ls -l
-r--r--r--    1 root     root         4096 Nov 12 10:37 base
-r--r--r--    1 root     root         4096 Nov 12 10:37 label
-r--r--r--    1 root     root         4096 Nov 12 10:37 ngpio
drwxr-xr-x    2 root     root            0 Nov 12 10:37 power
lrwxrwxrwx    1 root     root            0 Nov 12 10:37 subsystem -> ../../../../class/gpio
-rw-r--r--    1 root     root         4096 Nov 12 10:37 uevent
root:/sys/devices/virtual/gpio/gpiochip50> cd
root:/>

Note that you will have to enable the event_test utility under “Blackfin test programs” in your user space configuration.

--- Blackfin test programs
                   [*] Input event device test

For more information on GPIO handling in Linux read: Documentation/gpio.txt

Keypad

root:/> modprobe adp5520-keys
input: adp5520-keys as /devices/platform/i2c-bfin-twi.0/i2c-adapter/i2c-0/0-0032/adp5520-keys.5520/input/input0

root:/> event_test /dev/input/event0
Input driver version is 1.0.0
Input device ID: bus 0x18 vendor 0x1 product 0x5520 version 0x1
Input device name: "adp5520-keys"
Supported events:
  Event type 0 (Reset)
    Event code 0 (Reset)
    Event code 1 (Key)
  Event type 1 (Key)
    Event code 2 (1)
    Event code 3 (2)
    Event code 4 (3)
    Event code 5 (4)
    Event code 6 (5)
    Event code 7 (6)
    Event code 8 (7)
    Event code 9 (8)
    Event code 10 (9)
    Event code 11 (0)
    Event code 12 (Minus)
    Event code 13 (Equal)
    Event code 28 (Enter)
    Event code 41 (Grave)
    Event code 43 (BackSlash)
Testing ... (interrupt to exit)
Event: time 1415788674.340000, type 1 (Key), code 41 (Grave), value 1
Event: time 1415788674.340000, type 0 (Reset), code 0 (Reset), value 0
Event: time 1415788674.516000, type 1 (Key), code 41 (Grave), value 0
Event: time 1415788674.516000, type 0 (Reset), code 0 (Reset), value 0
Event: time 1415788674.912000, type 1 (Key), code 2 (1), value 1
Event: time 1415788674.912000, type 0 (Reset), code 0 (Reset), value 0
Event: time 1415788675.140000, type 1 (Key), code 2 (1), value 0
Event: time 1415788675.140000, type 0 (Reset), code 0 (Reset), value 0
Event: time 1415788675.892000, type 1 (Key), code 6 (5), value 1
Event: time 1415788675.892000, type 0 (Reset), code 0 (Reset), value 0
Event: time 1415788676.092000, type 1 (Key), code 6 (5), value 0
Event: time 1415788676.092000, type 0 (Reset), code 0 (Reset), value 0

root:/> modprobe -r adp5520-keys
root:/>

For more information on Input handling in Linux read: Documentation/input/input.txt

More Information

Linux-Input mailing list: linux [dash] input [at] vger [dot] kernel [dot] org
Linux-Input Patchwork Server
Linux-Input Git Repository

Need Help?

19 Nov 2012 14:04 · Lars-Peter Clausen

¹⁾ , ²⁾

ADP5520 only

下载并关注上传者 低至0.43元/天 开通VIP 免费下载

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。举报投诉

发评论

相关下载
相关文章

下载排行榜

UC3842/3/4/5电源管理芯片中文手册
2024-12-02 15次下载

下载
DMT0660数字万用表产品说明书
2024-12-03 13次下载

下载
ST7789V2单芯片控制器/驱动器英文手册
2024-11-24 11次下载

下载
TPS54202H降压转换器评估模块用户指南
2024-12-04 8次下载

下载
STM32F101x8/STM32F101xB手册
2024-12-06 8次下载

下载
HY12P65/HY12P66数字万用表芯片规格书
2024-12-03 6次下载

下载

ADP5520/01 MFD Linux驱动程序

Table of Contents

ADP5520/01 MFD Linux Driver

Supported Devices

Evaluation Boards

Description

Core

Resources

Configuration

Software configurable features

Source Code

Status

Files

Example platform device initialization

Backlight

LED

GPIO

Keypad

ADP5520/ADP5501 MFD Core Support

Declaring I2C devices

Adding Linux driver support

ADP5520 MFD Core Support

Backlight

LED

GPIO

Keypad

Hardware configuration

Driver testing

Backlight

LED

GPIO

Keypad

More Information

Linux驱动程序下载

嵌入式Linux驱动程序开发

LTC3676 Linux驱动程序

基于Linux的PXIe可重构仪器驱动程序

ADP5520：带I/O扩展器的背光驱动器产品手册

AD5449 IIO DAC Linux驱动程序

AD5380 IIO多通道Linux驱动程序DAC

AD7291 IIO ADC Linux驱动程序

AD5421 IIO DAC Linux驱动程序

AD5360 IIO多通道Linux驱动程序DAC

AD7303 IIO DAC Linux驱动程序

AD5446 IIO DAC Linux驱动程序

ADP150稳压器固定电压Linux驱动程序

IIO单通道串行ADC Linux驱动程序

ADP5520 LED驱动器

AD9834 IIO直接数字合成Linux驱动程序

AD7091R-5 Linux驱动程序

ADV7511 HDMI变送器Linux驱动程序

ADP5589输入键盘和GPIO Linux驱动程序

AD9832 IIO直接数字合成Linux驱动程序

AD7998 IIO ADC Linux驱动程序

数字电位器Linux驱动程序

ADP5588 GPIO Linux驱动程序

ADP5588输入键盘和GPIO Linux驱动程序

AD7887 IIO ADC Linux驱动程序

ADIS1613x Linux设备驱动程序

如何使用Linux内核实现USB驱动程序框架

Linux的LEDS GPIO驱动程序免费下载

嵌入式Linux设备驱动程序开发基础知识总结免费下载

TI达芬奇Linux驱动程序LSP 2.10的详细资料介绍

Linux设备驱动程序分类有哪些

linux驱动程序如何加载进内核

linux驱动程序主要有哪些功能

linux驱动程序的编译方法是什么

linux驱动程序运行在什么空间

虹科技术 Linux环境再升级：PLIN驱动程序正式发布

linux驱动程序的主要流程和功能

摩尔线程正式发布Linux驱动程序

如何配置和操作Linux驱动程序开发板

驱动程序开发步骤

怎样编写嵌入式Linux设备驱动程序呢

Xilinx Linux 如何理解V4L2的管道驱动程序

基于WDM驱动程序模型实现过滤器驱动程序的开发设计

如何编写基于ARM的裸机程序和基于Linux的驱动程序

如何写一个Linux设备驱动程序

Linux新的exFAT文件系统驱动程序要来了

米尔科技LINUX设备驱动程序教程