a5766f11cf
This improves the machine level API in order to configure
regulator constraints and consumers as platform data and removes the
old string based API that required several calls to set up each regulator.
The intention is to create a struct regulator_init_data, populate
it's fields with constraints, consumers devices, etc and then register
the regulator device from board.c in the standard Linux way.
e.g. regulator LDO2 (supplying codec and sim) platform data.
/* regulator LDO2 consumer devices */
static struct regulator_consumer_supply ldo2_consumers[] = {
{
.dev = &platform_audio_device.dev,
.supply = "codec_avdd",
},
{
.dev = &platform_sim_device.dev,
.supply = "sim_vcc",
}
};
/* regulator LDO2 constraints */
static struct regulator_init_data ldo2_data = {
.constraints = {
.min_uV = 3300000,
.max_uV = 3300000,
.valid_modes_mask = REGULATOR_MODE_NORMAL,
.apply_uV = 1,
},
.num_consumer_supplies = ARRAY_SIZE(ldo2_consumers),
.consumer_supplies = ldo2_consumers,
};
/* machine regulator devices with thier consumers and constraints */
static struct platform_device wm8350_regulator_devices[] = {
{
.name = "wm8350-regulator",
.id = WM8350_LDO_2,
.dev = {
.platform_data = &ldo2_data,
},
},
};
Changes in detail:-
o Removed all const char* regulator config functions in machine API.
o Created new struct regulator_init_data to contain regulator
machine configuration constraints and consmuers.
o Changed set_supply(), set_machine_constraints(),
set_consumer_device_supply() to remove their string identifier
parameters. Also made them static and moved functions nearer top of
core.c.
o Removed no longer used inline func to_rdev()
o Added regulator_get_init_drvdata() to retrieve init data.
o Added struct device* as parameter to regulator_register().
o Changed my email address.
Signed-off-by: Eric Miao <eric.miao@marvell.com>
Signed-off-by: Mark Brown <broonie@opensource.wolfsonmicro.com>
Signed-off-by: Liam Girdwood <lrg@slimlogic.co.uk>
93 lines
2.6 KiB
Text
93 lines
2.6 KiB
Text
Regulator Machine Driver Interface
|
|
===================================
|
|
|
|
The regulator machine driver interface is intended for board/machine specific
|
|
initialisation code to configure the regulator subsystem.
|
|
|
|
Consider the following machine :-
|
|
|
|
Regulator-1 -+-> Regulator-2 --> [Consumer A @ 1.8 - 2.0V]
|
|
|
|
|
+-> [Consumer B @ 3.3V]
|
|
|
|
The drivers for consumers A & B must be mapped to the correct regulator in
|
|
order to control their power supply. This mapping can be achieved in machine
|
|
initialisation code by creating a struct regulator_consumer_supply for
|
|
each regulator.
|
|
|
|
struct regulator_consumer_supply {
|
|
struct device *dev; /* consumer */
|
|
const char *supply; /* consumer supply - e.g. "vcc" */
|
|
};
|
|
|
|
e.g. for the machine above
|
|
|
|
static struct regulator_consumer_supply regulator1_consumers[] = {
|
|
{
|
|
.dev = &platform_consumerB_device.dev,
|
|
.supply = "Vcc",
|
|
},};
|
|
|
|
static struct regulator_consumer_supply regulator2_consumers[] = {
|
|
{
|
|
.dev = &platform_consumerA_device.dev,
|
|
.supply = "Vcc",
|
|
},};
|
|
|
|
This maps Regulator-1 to the 'Vcc' supply for Consumer B and maps Regulator-2
|
|
to the 'Vcc' supply for Consumer A.
|
|
|
|
Constraints can now be registered by defining a struct regulator_init_data
|
|
for each regulator power domain. This structure also maps the consumers
|
|
to their supply regulator :-
|
|
|
|
static struct regulator_init_data regulator1_data = {
|
|
.constraints = {
|
|
.min_uV = 3300000,
|
|
.max_uV = 3300000,
|
|
.valid_modes_mask = REGULATOR_MODE_NORMAL,
|
|
},
|
|
.num_consumer_supplies = ARRAY_SIZE(regulator1_consumers),
|
|
.consumer_supplies = regulator1_consumers,
|
|
};
|
|
|
|
Regulator-1 supplies power to Regulator-2. This relationship must be registered
|
|
with the core so that Regulator-1 is also enabled when Consumer A enables it's
|
|
supply (Regulator-2). The supply regulator is set by the supply_regulator_dev
|
|
field below:-
|
|
|
|
static struct regulator_init_data regulator2_data = {
|
|
.supply_regulator_dev = &platform_regulator1_device.dev,
|
|
.constraints = {
|
|
.min_uV = 1800000,
|
|
.max_uV = 2000000,
|
|
.valid_ops_mask = REGULATOR_CHANGE_VOLTAGE,
|
|
.valid_modes_mask = REGULATOR_MODE_NORMAL,
|
|
},
|
|
.num_consumer_supplies = ARRAY_SIZE(regulator2_consumers),
|
|
.consumer_supplies = regulator2_consumers,
|
|
};
|
|
|
|
Finally the regulator devices must be registered in the usual manner.
|
|
|
|
static struct platform_device regulator_devices[] = {
|
|
{
|
|
.name = "regulator",
|
|
.id = DCDC_1,
|
|
.dev = {
|
|
.platform_data = ®ulator1_data,
|
|
},
|
|
},
|
|
{
|
|
.name = "regulator",
|
|
.id = DCDC_2,
|
|
.dev = {
|
|
.platform_data = ®ulator2_data,
|
|
},
|
|
},
|
|
};
|
|
/* register regulator 1 device */
|
|
platform_device_register(&wm8350_regulator_devices[0]);
|
|
|
|
/* register regulator 2 device */
|
|
platform_device_register(&wm8350_regulator_devices[1]);
|