Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit d2bedfe7 authored by Mark Brown's avatar Mark Brown Committed by Samuel Ortiz
Browse files

mfd: Initial core support for WM831x series devices 



The WM831x series of devices are register compatible processor power
management subsystems, providing regulator and power path management
facilities along with other services like watchdog, RTC and touch
panel controllers.

This patch adds very basic support, providing basic single register
I2C access, handling of the security key and registration of the
devices.

Signed-off-by: default avatarMark Brown <broonie@opensource.wolfsonmicro.com>
Signed-off-by: default avatarSamuel Ortiz <sameo@linux.intel.com>
parent 3bed6e41

drivers/mfd/wm831x-core.c

0 → 100644
+1357 −0

File added.

Preview size limit exceeded, changes collapsed.

include/linux/mfd/wm831x/core.h

0 → 100644
+247 −0
Original line number Original line Diff line number Diff line 
/*

 * include/linux/mfd/wm831x/core.h -- Core interface for WM831x

 *

 * Copyright 2009 Wolfson Microelectronics PLC.

 *

 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>

 *

 *  This program is free software; you can redistribute  it and/or modify it

 *  under  the terms of  the GNU General  Public License as published by the

 *  Free Software Foundation;  either version 2 of the  License, or (at your

 *  option) any later version.

 *

 */



#ifndef __MFD_WM831X_CORE_H__

#define __MFD_WM831X_CORE_H__



/*

 * Register values.

 */

#define WM831X_RESET_ID                         0x00

#define WM831X_REVISION                         0x01

#define WM831X_PARENT_ID                        0x4000

#define WM831X_SYSVDD_CONTROL                   0x4001

#define WM831X_THERMAL_MONITORING               0x4002

#define WM831X_POWER_STATE                      0x4003

#define WM831X_WATCHDOG                         0x4004

#define WM831X_ON_PIN_CONTROL                   0x4005

#define WM831X_RESET_CONTROL                    0x4006

#define WM831X_CONTROL_INTERFACE                0x4007

#define WM831X_SECURITY_KEY                     0x4008

#define WM831X_SOFTWARE_SCRATCH                 0x4009

#define WM831X_OTP_CONTROL                      0x400A

#define WM831X_GPIO_LEVEL                       0x400C

#define WM831X_SYSTEM_STATUS                    0x400D

#define WM831X_ON_SOURCE                        0x400E

#define WM831X_OFF_SOURCE                       0x400F

#define WM831X_SYSTEM_INTERRUPTS                0x4010

#define WM831X_INTERRUPT_STATUS_1               0x4011

#define WM831X_INTERRUPT_STATUS_2               0x4012

#define WM831X_INTERRUPT_STATUS_3               0x4013

#define WM831X_INTERRUPT_STATUS_4               0x4014

#define WM831X_INTERRUPT_STATUS_5               0x4015

#define WM831X_IRQ_CONFIG                       0x4017

#define WM831X_SYSTEM_INTERRUPTS_MASK           0x4018

#define WM831X_INTERRUPT_STATUS_1_MASK          0x4019

#define WM831X_INTERRUPT_STATUS_2_MASK          0x401A

#define WM831X_INTERRUPT_STATUS_3_MASK          0x401B

#define WM831X_INTERRUPT_STATUS_4_MASK          0x401C

#define WM831X_INTERRUPT_STATUS_5_MASK          0x401D

#define WM831X_RTC_WRITE_COUNTER                0x4020

#define WM831X_RTC_TIME_1                       0x4021

#define WM831X_RTC_TIME_2                       0x4022

#define WM831X_RTC_ALARM_1                      0x4023

#define WM831X_RTC_ALARM_2                      0x4024

#define WM831X_RTC_CONTROL                      0x4025

#define WM831X_RTC_TRIM                         0x4026

#define WM831X_TOUCH_CONTROL_1                  0x4028

#define WM831X_TOUCH_CONTROL_2                  0x4029

#define WM831X_TOUCH_DATA_X                     0x402A

#define WM831X_TOUCH_DATA_Y                     0x402B

#define WM831X_TOUCH_DATA_Z                     0x402C

#define WM831X_AUXADC_DATA                      0x402D

#define WM831X_AUXADC_CONTROL                   0x402E

#define WM831X_AUXADC_SOURCE                    0x402F

#define WM831X_COMPARATOR_CONTROL               0x4030

#define WM831X_COMPARATOR_1                     0x4031

#define WM831X_COMPARATOR_2                     0x4032

#define WM831X_COMPARATOR_3                     0x4033

#define WM831X_COMPARATOR_4                     0x4034

#define WM831X_GPIO1_CONTROL                    0x4038

#define WM831X_GPIO2_CONTROL                    0x4039

#define WM831X_GPIO3_CONTROL                    0x403A

#define WM831X_GPIO4_CONTROL                    0x403B

#define WM831X_GPIO5_CONTROL                    0x403C

#define WM831X_GPIO6_CONTROL                    0x403D

#define WM831X_GPIO7_CONTROL                    0x403E

#define WM831X_GPIO8_CONTROL                    0x403F

#define WM831X_GPIO9_CONTROL                    0x4040

#define WM831X_GPIO10_CONTROL                   0x4041

#define WM831X_GPIO11_CONTROL                   0x4042

#define WM831X_GPIO12_CONTROL                   0x4043

#define WM831X_GPIO13_CONTROL                   0x4044

#define WM831X_GPIO14_CONTROL                   0x4045

#define WM831X_GPIO15_CONTROL                   0x4046

#define WM831X_GPIO16_CONTROL                   0x4047

#define WM831X_CHARGER_CONTROL_1                0x4048

#define WM831X_CHARGER_CONTROL_2                0x4049

#define WM831X_CHARGER_STATUS                   0x404A

#define WM831X_BACKUP_CHARGER_CONTROL           0x404B

#define WM831X_STATUS_LED_1                     0x404C

#define WM831X_STATUS_LED_2                     0x404D

#define WM831X_CURRENT_SINK_1                   0x404E

#define WM831X_CURRENT_SINK_2                   0x404F

#define WM831X_DCDC_ENABLE                      0x4050

#define WM831X_LDO_ENABLE                       0x4051

#define WM831X_DCDC_STATUS                      0x4052

#define WM831X_LDO_STATUS                       0x4053

#define WM831X_DCDC_UV_STATUS                   0x4054

#define WM831X_LDO_UV_STATUS                    0x4055

#define WM831X_DC1_CONTROL_1                    0x4056

#define WM831X_DC1_CONTROL_2                    0x4057

#define WM831X_DC1_ON_CONFIG                    0x4058

#define WM831X_DC1_SLEEP_CONTROL                0x4059

#define WM831X_DC1_DVS_CONTROL                  0x405A

#define WM831X_DC2_CONTROL_1                    0x405B

#define WM831X_DC2_CONTROL_2                    0x405C

#define WM831X_DC2_ON_CONFIG                    0x405D

#define WM831X_DC2_SLEEP_CONTROL                0x405E

#define WM831X_DC2_DVS_CONTROL                  0x405F

#define WM831X_DC3_CONTROL_1                    0x4060

#define WM831X_DC3_CONTROL_2                    0x4061

#define WM831X_DC3_ON_CONFIG                    0x4062

#define WM831X_DC3_SLEEP_CONTROL                0x4063

#define WM831X_DC4_CONTROL                      0x4064

#define WM831X_DC4_SLEEP_CONTROL                0x4065

#define WM831X_EPE1_CONTROL                     0x4066

#define WM831X_EPE2_CONTROL                     0x4067

#define WM831X_LDO1_CONTROL                     0x4068

#define WM831X_LDO1_ON_CONTROL                  0x4069

#define WM831X_LDO1_SLEEP_CONTROL               0x406A

#define WM831X_LDO2_CONTROL                     0x406B

#define WM831X_LDO2_ON_CONTROL                  0x406C

#define WM831X_LDO2_SLEEP_CONTROL               0x406D

#define WM831X_LDO3_CONTROL                     0x406E

#define WM831X_LDO3_ON_CONTROL                  0x406F

#define WM831X_LDO3_SLEEP_CONTROL               0x4070

#define WM831X_LDO4_CONTROL                     0x4071

#define WM831X_LDO4_ON_CONTROL                  0x4072

#define WM831X_LDO4_SLEEP_CONTROL               0x4073

#define WM831X_LDO5_CONTROL                     0x4074

#define WM831X_LDO5_ON_CONTROL                  0x4075

#define WM831X_LDO5_SLEEP_CONTROL               0x4076

#define WM831X_LDO6_CONTROL                     0x4077

#define WM831X_LDO6_ON_CONTROL                  0x4078

#define WM831X_LDO6_SLEEP_CONTROL               0x4079

#define WM831X_LDO7_CONTROL                     0x407A

#define WM831X_LDO7_ON_CONTROL                  0x407B

#define WM831X_LDO7_SLEEP_CONTROL               0x407C

#define WM831X_LDO8_CONTROL                     0x407D

#define WM831X_LDO8_ON_CONTROL                  0x407E

#define WM831X_LDO8_SLEEP_CONTROL               0x407F

#define WM831X_LDO9_CONTROL                     0x4080

#define WM831X_LDO9_ON_CONTROL                  0x4081

#define WM831X_LDO9_SLEEP_CONTROL               0x4082

#define WM831X_LDO10_CONTROL                    0x4083

#define WM831X_LDO10_ON_CONTROL                 0x4084

#define WM831X_LDO10_SLEEP_CONTROL              0x4085

#define WM831X_LDO11_ON_CONTROL                 0x4087

#define WM831X_LDO11_SLEEP_CONTROL              0x4088

#define WM831X_POWER_GOOD_SOURCE_1              0x408E

#define WM831X_POWER_GOOD_SOURCE_2              0x408F

#define WM831X_CLOCK_CONTROL_1                  0x4090

#define WM831X_CLOCK_CONTROL_2                  0x4091

#define WM831X_FLL_CONTROL_1                    0x4092

#define WM831X_FLL_CONTROL_2                    0x4093

#define WM831X_FLL_CONTROL_3                    0x4094

#define WM831X_FLL_CONTROL_4                    0x4095

#define WM831X_FLL_CONTROL_5                    0x4096

#define WM831X_UNIQUE_ID_1                      0x7800

#define WM831X_UNIQUE_ID_2                      0x7801

#define WM831X_UNIQUE_ID_3                      0x7802

#define WM831X_UNIQUE_ID_4                      0x7803

#define WM831X_UNIQUE_ID_5                      0x7804

#define WM831X_UNIQUE_ID_6                      0x7805

#define WM831X_UNIQUE_ID_7                      0x7806

#define WM831X_UNIQUE_ID_8                      0x7807

#define WM831X_FACTORY_OTP_ID                   0x7808

#define WM831X_FACTORY_OTP_1                    0x7809

#define WM831X_FACTORY_OTP_2                    0x780A

#define WM831X_FACTORY_OTP_3                    0x780B

#define WM831X_FACTORY_OTP_4                    0x780C

#define WM831X_FACTORY_OTP_5                    0x780D

#define WM831X_CUSTOMER_OTP_ID                  0x7810

#define WM831X_DC1_OTP_CONTROL                  0x7811

#define WM831X_DC2_OTP_CONTROL                  0x7812

#define WM831X_DC3_OTP_CONTROL                  0x7813

#define WM831X_LDO1_2_OTP_CONTROL               0x7814

#define WM831X_LDO3_4_OTP_CONTROL               0x7815

#define WM831X_LDO5_6_OTP_CONTROL               0x7816

#define WM831X_LDO7_8_OTP_CONTROL               0x7817

#define WM831X_LDO9_10_OTP_CONTROL              0x7818

#define WM831X_LDO11_EPE_CONTROL                0x7819

#define WM831X_GPIO1_OTP_CONTROL                0x781A

#define WM831X_GPIO2_OTP_CONTROL                0x781B

#define WM831X_GPIO3_OTP_CONTROL                0x781C

#define WM831X_GPIO4_OTP_CONTROL                0x781D

#define WM831X_GPIO5_OTP_CONTROL                0x781E

#define WM831X_GPIO6_OTP_CONTROL                0x781F

#define WM831X_DBE_CHECK_DATA                   0x7827



/*

 * R0 (0x00) - Reset ID

 */

#define WM831X_CHIP_ID_MASK                     0xFFFF  /* CHIP_ID - [15:0] */

#define WM831X_CHIP_ID_SHIFT                         0  /* CHIP_ID - [15:0] */

#define WM831X_CHIP_ID_WIDTH                        16  /* CHIP_ID - [15:0] */



/*

 * R1 (0x01) - Revision

 */

#define WM831X_PARENT_REV_MASK                  0xFF00  /* PARENT_REV - [15:8] */

#define WM831X_PARENT_REV_SHIFT                      8  /* PARENT_REV - [15:8] */

#define WM831X_PARENT_REV_WIDTH                      8  /* PARENT_REV - [15:8] */

#define WM831X_CHILD_REV_MASK                   0x00FF  /* CHILD_REV - [7:0] */

#define WM831X_CHILD_REV_SHIFT                       0  /* CHILD_REV - [7:0] */

#define WM831X_CHILD_REV_WIDTH                       8  /* CHILD_REV - [7:0] */



/*

 * R16384 (0x4000) - Parent ID

 */

#define WM831X_PARENT_ID_MASK                   0xFFFF  /* PARENT_ID - [15:0] */

#define WM831X_PARENT_ID_SHIFT                       0  /* PARENT_ID - [15:0] */

#define WM831X_PARENT_ID_WIDTH                      16  /* PARENT_ID - [15:0] */



struct wm831x {

	struct mutex io_lock;



	struct device *dev;

	int (*read_dev)(struct wm831x *wm831x, unsigned short reg,

			int bytes, void *dest);

	int (*write_dev)(struct wm831x *wm831x, unsigned short reg,

			 int bytes, void *src);



	void *control_data;



	/* The WM831x has a security key blocking access to certain

	 * registers.  The mutex is taken by the accessors for locking

	 * and unlocking the security key, locked is used to fail

	 * writes if the lock is held.

	 */

	struct mutex key_lock;

	unsigned int locked:1;

};



/* Device I/O API */

int wm831x_reg_read(struct wm831x *wm831x, unsigned short reg);

int wm831x_reg_write(struct wm831x *wm831x, unsigned short reg,

		 unsigned short val);

void wm831x_reg_lock(struct wm831x *wm831x);

int wm831x_reg_unlock(struct wm831x *wm831x);

int wm831x_set_bits(struct wm831x *wm831x, unsigned short reg,

		    unsigned short mask, unsigned short val);

int wm831x_bulk_read(struct wm831x *wm831x, unsigned short reg,

		     int count, u16 *buf);



#endif

include/linux/mfd/wm831x/pdata.h

0 → 100644
+107 −0
Original line number Original line Diff line number Diff line 
/*

 * include/linux/mfd/wm831x/pdata.h -- Platform data for WM831x

 *

 * Copyright 2009 Wolfson Microelectronics PLC.

 *

 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>

 *

 *  This program is free software; you can redistribute  it and/or modify it

 *  under  the terms of  the GNU General  Public License as published by the

 *  Free Software Foundation;  either version 2 of the  License, or (at your

 *  option) any later version.

 *

 */



#ifndef __MFD_WM831X_PDATA_H__

#define __MFD_WM831X_PDATA_H__



struct wm831x;

struct regulator_init_data;



struct wm831x_backup_pdata {

	int charger_enable;

	int no_constant_voltage;  /** Disable constant voltage charging */

	int vlim;   /** Voltage limit in milivolts */

	int ilim;   /** Current limit in microamps */

};



struct wm831x_battery_pdata {

	int enable;         /** Enable charging */

	int fast_enable;    /** Enable fast charging */

	int off_mask;       /** Mask OFF while charging */

	int trickle_ilim;   /** Trickle charge current limit, in mA */

	int vsel;           /** Target voltage, in mV */

	int eoc_iterm;      /** End of trickle charge current, in mA */

	int fast_ilim;      /** Fast charge current limit, in mA */

	int timeout;        /** Charge cycle timeout, in minutes */

};



/* Sources for status LED configuration.  Values are register values

 * plus 1 to allow for a zero default for preserve.

 */

enum wm831x_status_src {

	WM831X_STATUS_PRESERVE = 0,  /* Keep the current hardware setting */

	WM831X_STATUS_OTP = 1,

	WM831X_STATUS_POWER = 2,

	WM831X_STATUS_CHARGER = 3,

	WM831X_STATUS_MANUAL = 4,

};



struct wm831x_status_pdata {

	enum wm831x_status_src default_src;

	const char *name;

	const char *default_trigger;

};



struct wm831x_touch_pdata {

	int fivewire;          /** 1 for five wire mode, 0 for 4 wire */

	int isel;              /** Current for pen down (uA) */

	int rpu;               /** Pen down sensitivity resistor divider */

	int pressure;          /** Report pressure (boolean) */

	int data_irq;          /** Touch data ready IRQ */

};



enum wm831x_watchdog_action {

	WM831X_WDOG_NONE = 0,

	WM831X_WDOG_INTERRUPT = 1,

	WM831X_WDOG_RESET = 2,

	WM831X_WDOG_WAKE = 3,

};



struct wm831x_watchdog_pdata {

	enum wm831x_watchdog_action primary, secondary;

	int update_gpio;

	unsigned int software:1;

};



#define WM831X_MAX_STATUS 2

#define WM831X_MAX_DCDC   4

#define WM831X_MAX_EPE    2

#define WM831X_MAX_LDO    11

#define WM831X_MAX_ISINK  2



struct wm831x_pdata {

	/** Called before subdevices are set up */

	int (*pre_init)(struct wm831x *wm831x);

	/** Called after subdevices are set up */

	int (*post_init)(struct wm831x *wm831x);



	int gpio_base;

	struct wm831x_backup_pdata *backup;

	struct wm831x_battery_pdata *battery;

	struct wm831x_touch_pdata *touch;

	struct wm831x_watchdog_pdata *watchdog;



	/** LED1 = 0 and so on */

	struct wm831x_status_pdata *status[WM831X_MAX_STATUS];

	/** DCDC1 = 0 and so on */

	struct regulator_init_data *dcdc[WM831X_MAX_DCDC];

	/** EPE1 = 0 and so on */

	struct regulator_init_data *epe[WM831X_MAX_EPE];

	/** LDO1 = 0 and so on */

	struct regulator_init_data *ldo[WM831X_MAX_LDO];

	/** ISINK1 = 0 and so on*/

	struct regulator_init_data *isink[WM831X_MAX_ISINK];

};



#endif