253 lines
7.2 KiB
C
253 lines
7.2 KiB
C
/*
|
|
* max8997.h - Driver for the Maxim 8997/8966
|
|
*
|
|
* Copyright (C) 2009-2010 Samsung Electrnoics
|
|
* MyungJoo Ham <myungjoo.ham@samsung.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.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*
|
|
* This driver is based on max8998.h
|
|
*
|
|
* MAX8997 has PMIC, MUIC, HAPTIC, RTC, FLASH, and Fuel Gauge devices.
|
|
* Except Fuel Gauge, every device shares the same I2C bus and included in
|
|
* this mfd driver. Although the fuel gauge is included in the chip, it is
|
|
* excluded from the driver because a) it has a different I2C bus from
|
|
* others and b) it can be enabled simply by using MAX17042 driver.
|
|
*/
|
|
|
|
#ifndef __LINUX_MFD_MAX8998_H
|
|
#define __LINUX_MFD_MAX8998_H
|
|
|
|
#include <linux/regulator/consumer.h>
|
|
|
|
/* MAX8997/8966 regulator IDs */
|
|
enum max8998_regulators {
|
|
MAX8997_LDO1 = 0,
|
|
MAX8997_LDO2,
|
|
MAX8997_LDO3,
|
|
MAX8997_LDO4,
|
|
MAX8997_LDO5,
|
|
MAX8997_LDO6,
|
|
MAX8997_LDO7,
|
|
MAX8997_LDO8,
|
|
MAX8997_LDO9,
|
|
MAX8997_LDO10,
|
|
MAX8997_LDO11,
|
|
MAX8997_LDO12,
|
|
MAX8997_LDO13,
|
|
MAX8997_LDO14,
|
|
MAX8997_LDO15,
|
|
MAX8997_LDO16,
|
|
MAX8997_LDO17,
|
|
MAX8997_LDO18,
|
|
MAX8997_LDO21,
|
|
MAX8997_BUCK1,
|
|
MAX8997_BUCK2,
|
|
MAX8997_BUCK3,
|
|
MAX8997_BUCK4,
|
|
MAX8997_BUCK5,
|
|
MAX8997_BUCK6,
|
|
MAX8997_BUCK7,
|
|
MAX8997_EN32KHZ_AP,
|
|
MAX8997_EN32KHZ_CP,
|
|
MAX8997_ENVICHG,
|
|
MAX8997_ESAFEOUT1,
|
|
MAX8997_ESAFEOUT2,
|
|
MAX8997_CHARGER_CV, /* control MBCCV of MBCCTRL3 */
|
|
MAX8997_CHARGER, /* charger current, MBCCTRL4 */
|
|
MAX8997_CHARGER_TOPOFF, /* MBCCTRL5 */
|
|
|
|
MAX8997_REG_MAX,
|
|
};
|
|
|
|
struct max8997_regulator_data {
|
|
int id;
|
|
struct regulator_init_data *initdata;
|
|
};
|
|
|
|
enum max8997_muic_usb_type {
|
|
MAX8997_USB_HOST,
|
|
MAX8997_USB_DEVICE,
|
|
};
|
|
|
|
enum max8997_muic_charger_type {
|
|
MAX8997_CHARGER_TYPE_NONE = 0,
|
|
MAX8997_CHARGER_TYPE_USB,
|
|
MAX8997_CHARGER_TYPE_DOWNSTREAM_PORT,
|
|
MAX8997_CHARGER_TYPE_DEDICATED_CHG,
|
|
MAX8997_CHARGER_TYPE_500MA,
|
|
MAX8997_CHARGER_TYPE_1A,
|
|
MAX8997_CHARGER_TYPE_DEAD_BATTERY = 7,
|
|
};
|
|
|
|
struct max8997_muic_reg_data {
|
|
u8 addr;
|
|
u8 data;
|
|
};
|
|
|
|
/**
|
|
* struct max8997_muic_platform_data
|
|
* @usb_callback: callback function for USB
|
|
* inform callee of USB type (HOST or DEVICE)
|
|
* and attached state(true or false)
|
|
* @charger_callback: callback function for charger
|
|
* inform callee of charger_type
|
|
* and attached state(true or false)
|
|
* @deskdock_callback: callback function for desk dock
|
|
* inform callee of attached state(true or false)
|
|
* @cardock_callback: callback function for car dock
|
|
* inform callee of attached state(true or false)
|
|
* @mhl_callback: callback function for MHL (Mobile High-definition Link)
|
|
* inform callee of attached state(true or false)
|
|
* @uart_callback: callback function for JIG UART
|
|
* inform callee of attached state(true or false)
|
|
* @init_data: array of max8997_muic_reg_data
|
|
* used for initializing registers of MAX8997 MUIC device
|
|
* @num_init_data: array size of init_data
|
|
*/
|
|
struct max8997_muic_platform_data {
|
|
void (*usb_callback)(enum max8997_muic_usb_type usb_type,
|
|
bool attached);
|
|
void (*charger_callback)(bool attached,
|
|
enum max8997_muic_charger_type charger_type);
|
|
void (*deskdock_callback) (bool attached);
|
|
void (*cardock_callback) (bool attached);
|
|
void (*mhl_callback) (bool attached);
|
|
void (*uart_callback) (bool attached);
|
|
|
|
struct max8997_muic_reg_data *init_data;
|
|
int num_init_data;
|
|
};
|
|
|
|
enum max8997_haptic_motor_type {
|
|
MAX8997_HAPTIC_ERM,
|
|
MAX8997_HAPTIC_LRA,
|
|
};
|
|
|
|
enum max8997_haptic_pulse_mode {
|
|
MAX8997_EXTERNAL_MODE,
|
|
MAX8997_INTERNAL_MODE,
|
|
};
|
|
|
|
enum max8997_haptic_pwm_divisor {
|
|
MAX8997_PWM_DIVISOR_32,
|
|
MAX8997_PWM_DIVISOR_64,
|
|
MAX8997_PWM_DIVISOR_128,
|
|
MAX8997_PWM_DIVISOR_256,
|
|
};
|
|
|
|
/**
|
|
* max8997_haptic_platform_data
|
|
* @pwm_channel_id: channel number of PWM device
|
|
* valid for MAX8997_EXTERNAL_MODE
|
|
* @pwm_period: period in nano second for PWM device
|
|
* valid for MAX8997_EXTERNAL_MODE
|
|
* @type: motor type
|
|
* @mode: pulse mode
|
|
* MAX8997_EXTERNAL_MODE: external PWM device is used to control motor
|
|
* MAX8997_INTERNAL_MODE: internal pulse generator is used to control motor
|
|
* @pwm_divisor: divisor for external PWM device
|
|
* @internal_mode_pattern: internal mode pattern for internal mode
|
|
* [0 - 3]: valid pattern number
|
|
* @pattern_cycle: the number of cycles of the waveform
|
|
* for the internal mode pattern
|
|
* [0 - 15]: available cycles
|
|
* @pattern_signal_period: period of the waveform for the internal mode pattern
|
|
* [0 - 255]: available period
|
|
*/
|
|
struct max8997_haptic_platform_data {
|
|
unsigned int pwm_channel_id;
|
|
unsigned int pwm_period;
|
|
|
|
enum max8997_haptic_motor_type type;
|
|
enum max8997_haptic_pulse_mode mode;
|
|
enum max8997_haptic_pwm_divisor pwm_divisor;
|
|
|
|
unsigned int internal_mode_pattern;
|
|
unsigned int pattern_cycle;
|
|
unsigned int pattern_signal_period;
|
|
};
|
|
|
|
enum max8997_led_mode {
|
|
MAX8997_NONE,
|
|
MAX8997_FLASH_MODE,
|
|
MAX8997_MOVIE_MODE,
|
|
MAX8997_FLASH_PIN_CONTROL_MODE,
|
|
MAX8997_MOVIE_PIN_CONTROL_MODE,
|
|
};
|
|
|
|
/**
|
|
* struct max8997_led_platform_data
|
|
* The number of LED devices for MAX8997 is two
|
|
* @mode: LED mode for each LED device
|
|
* @brightness: initial brightness for each LED device
|
|
* range:
|
|
* [0 - 31]: MAX8997_FLASH_MODE and MAX8997_FLASH_PIN_CONTROL_MODE
|
|
* [0 - 15]: MAX8997_MOVIE_MODE and MAX8997_MOVIE_PIN_CONTROL_MODE
|
|
*/
|
|
struct max8997_led_platform_data {
|
|
enum max8997_led_mode mode[2];
|
|
u8 brightness[2];
|
|
};
|
|
|
|
struct max8997_platform_data {
|
|
/* IRQ */
|
|
int irq_base;
|
|
int ono;
|
|
int wakeup;
|
|
|
|
/* ---- PMIC ---- */
|
|
struct max8997_regulator_data *regulators;
|
|
int num_regulators;
|
|
|
|
/*
|
|
* SET1~3 DVS GPIOs control Buck1, 2, and 5 simultaneously. Therefore,
|
|
* With buckx_gpiodvs enabled, the buckx cannot be controlled
|
|
* independently. To control buckx (of 1, 2, and 5) independently,
|
|
* disable buckx_gpiodvs and control with BUCKxDVS1 register.
|
|
*
|
|
* When buckx_gpiodvs and bucky_gpiodvs are both enabled, set_voltage
|
|
* on buckx will change the voltage of bucky at the same time.
|
|
*
|
|
*/
|
|
bool ignore_gpiodvs_side_effect;
|
|
int buck125_gpios[3]; /* GPIO of [0]SET1, [1]SET2, [2]SET3 */
|
|
int buck125_default_idx; /* Default value of SET1, 2, 3 */
|
|
unsigned int buck1_voltage[8]; /* buckx_voltage in uV */
|
|
bool buck1_gpiodvs;
|
|
unsigned int buck2_voltage[8];
|
|
bool buck2_gpiodvs;
|
|
unsigned int buck5_voltage[8];
|
|
bool buck5_gpiodvs;
|
|
|
|
/* ---- Charger control ---- */
|
|
/* eoc stands for 'end of charge' */
|
|
int eoc_mA; /* 50 ~ 200mA by 10mA step */
|
|
/* charge Full Timeout */
|
|
int timeout; /* 0 (no timeout), 5, 6, 7 hours */
|
|
|
|
/* ---- MUIC ---- */
|
|
struct max8997_muic_platform_data *muic_pdata;
|
|
|
|
/* ---- HAPTIC ---- */
|
|
struct max8997_haptic_platform_data *haptic_pdata;
|
|
|
|
/* RTC: Not implemented */
|
|
/* ---- LED ---- */
|
|
struct max8997_led_platform_data *led_pdata;
|
|
};
|
|
|
|
#endif /* __LINUX_MFD_MAX8998_H */
|