ALSA: hda - Rename power_mgmt flag with power_save_node

David suggested that the name "power_mgmt" is too ambiguous.  Rename
the flag with a bit clearer one "power_save_node".

Also, add the corresponding description to HD-Audio.txt, too.

Reported-by: David Henningsson <david.henningsson@canonical.com>
Signed-off-by: Takashi Iwai <tiwai@suse.de>

diff --git a/Documentation/sound/alsa/HD-Audio.txt b/Documentation/sound/alsa/HD-Audio.txt
index 42a0a39..e7193aa 100644 (file)
--- a/Documentation/sound/alsa/HD-Audio.txt
+++ b/Documentation/sound/alsa/HD-Audio.txt
@@ -466,7 +466,11 @@ The generic parser supports the following hints:
 - add_jack_modes (bool): add "xxx Jack Mode" enum controls to each
   I/O jack for allowing to change the headphone amp and mic bias VREF
   capabilities
-- power_down_unused (bool): power down the unused widgets
+- power_save_node (bool): advanced power management for each widget,
+  controlling the power sate (D0/D3) of each widget node depending on
+  the actual pin and stream states
+- power_down_unused (bool): power down the unused widgets, a subset of
+  power_save_node, and will be dropped in future
 - add_hp_mic (bool): add the headphone to capture source if possible
 - hp_mic_detect (bool): enable/disable the hp/mic shared input for a
   single built-in mic case; default true

diff --git a/sound/pci/hda/hda_codec.h b/sound/pci/hda/hda_codec.h
index 148e84c..ccf355d 100644 (file)
--- a/sound/pci/hda/hda_codec.h
+++ b/sound/pci/hda/hda_codec.h
@@ -371,7 +371,7 @@ struct hda_codec {
        unsigned int cached_write:1;    /* write only to caches */
        unsigned int dp_mst:1; /* support DP1.2 Multi-stream transport */
        unsigned int dump_coef:1; /* dump processing coefs in codec proc file */
-       unsigned int power_mgmt:1; /* advanced PM for each widget */
+       unsigned int power_save_node:1; /* advanced PM for each widget */
 #ifdef CONFIG_PM
        unsigned int d3_stop_clk:1;     /* support D3 operation without BCLK */
        atomic_t in_pm;         /* suspend/resume being performed */

diff --git a/sound/pci/hda/hda_generic.c b/sound/pci/hda/hda_generic.c
index 1cafcbb..0ef2459 100644 (file)
--- a/sound/pci/hda/hda_generic.c
+++ b/sound/pci/hda/hda_generic.c
@@ -140,9 +140,9 @@ static void parse_user_hints(struct hda_codec *codec)
        val = snd_hda_get_bool_hint(codec, "single_adc_amp");
        if (val >= 0)
                codec->single_adc_amp = !!val;
-       val = snd_hda_get_bool_hint(codec, "power_mgmt");
+       val = snd_hda_get_bool_hint(codec, "power_save_node");
        if (val >= 0)
-               codec->power_mgmt = !!val;
+               codec->power_save_node = !!val;
 
        val = snd_hda_get_bool_hint(codec, "auto_mute");
        if (val >= 0)
@@ -661,7 +661,7 @@ static bool is_active_nid(struct hda_codec *codec, hda_nid_t nid,
                struct nid_path *path = snd_array_elem(&spec->paths, n);
                if (!path->active)
                        continue;
-               if (codec->power_mgmt) {
+               if (codec->power_save_node) {
                        if (!path->stream_enabled)
                                continue;
                        /* ignore unplugged paths except for DAC/ADC */
@@ -879,8 +879,8 @@ void snd_hda_activate_path(struct hda_codec *codec, struct nid_path *path,
                path->active = false;
 
        /* make sure the widget is powered up */
-       if (enable && (spec->power_down_unused || codec->power_mgmt))
-               path_power_update(codec, path, codec->power_mgmt);
+       if (enable && (spec->power_down_unused || codec->power_save_node))
+               path_power_update(codec, path, codec->power_save_node);
 
        for (i = path->depth - 1; i >= 0; i--) {
                hda_nid_t nid = path->path[i];
@@ -905,7 +905,7 @@ static void path_power_down_sync(struct hda_codec *codec, struct nid_path *path)
 {
        struct hda_gen_spec *spec = codec->spec;
 
-       if (!(spec->power_down_unused || codec->power_mgmt) || path->active)
+       if (!(spec->power_down_unused || codec->power_save_node) || path->active)
                return;
        sync_power_state_change(codec, path_power_update(codec, path, true));
 }
@@ -3981,7 +3981,7 @@ static hda_nid_t set_pin_power_jack(struct hda_codec *codec, hda_nid_t pin,
 {
        bool on;
 
-       if (!codec->power_mgmt)
+       if (!codec->power_save_node)
                return 0;
 
        on = snd_hda_jack_detect_state(codec, pin) != HDA_JACK_NOT_PRESENT;
@@ -4038,7 +4038,7 @@ static void add_all_pin_power_ctls(struct hda_codec *codec, bool on)
        struct auto_pin_cfg *cfg = &spec->autocfg;
        int i;
 
-       if (!codec->power_mgmt)
+       if (!codec->power_save_node)
                return;
        add_pin_power_ctls(codec, cfg->line_outs, cfg->line_out_pins, on);
        if (cfg->line_out_type != AUTO_PIN_HP_OUT)
@@ -4067,7 +4067,7 @@ static void sync_all_pin_power_ctls(struct hda_codec *codec)
        struct auto_pin_cfg *cfg = &spec->autocfg;
        int i;
 
-       if (!codec->power_mgmt)
+       if (!codec->power_save_node)
                return;
        sync_pin_power_ctls(codec, cfg->line_outs, cfg->line_out_pins);
        if (cfg->line_out_type != AUTO_PIN_HP_OUT)
@@ -4111,7 +4111,7 @@ static int add_fake_beep_paths(struct hda_codec *codec)
        hda_nid_t nid = spec->beep_nid;
        int err;
 
-       if (!codec->power_mgmt || !nid)
+       if (!codec->power_save_node || !nid)
                return 0;
        err = add_fake_paths(codec, nid, cfg->line_outs, cfg->line_out_pins);
        if (err < 0)
@@ -4233,7 +4233,7 @@ static void do_automute(struct hda_codec *codec, int num_pins, hda_nid_t *pins,
                }
 
                set_pin_eapd(codec, nid, !mute);
-               if (codec->power_mgmt) {
+               if (codec->power_save_node) {
                        bool on = !mute;
                        if (on)
                                on = snd_hda_jack_detect_state(codec, nid)
@@ -4741,11 +4741,11 @@ static void mute_all_mixer_nid(struct hda_codec *codec, hda_nid_t mix)
  * @nid: audio widget
  * @on: power on/off flag
  *
- * Set this in patch_ops.stream_pm.  Only valid with power_mgmt flag.
+ * Set this in patch_ops.stream_pm.  Only valid with power_save_node flag.
  */
 void snd_hda_gen_stream_pm(struct hda_codec *codec, hda_nid_t nid, bool on)
 {
-       if (codec->power_mgmt)
+       if (codec->power_save_node)
                set_path_power(codec, nid, -1, on);
 }
 EXPORT_SYMBOL_GPL(snd_hda_gen_stream_pm);
@@ -4916,14 +4916,14 @@ int snd_hda_gen_parse_auto_config(struct hda_codec *codec,
  dig_only:
        parse_digital(codec);
 
-       if (spec->power_down_unused || codec->power_mgmt)
+       if (spec->power_down_unused || codec->power_save_node)
                codec->power_filter = snd_hda_gen_path_power_filter;
 
        if (!spec->no_analog && spec->beep_nid) {
                err = snd_hda_attach_beep_device(codec, spec->beep_nid);
                if (err < 0)
                        return err;
-               if (codec->beep && codec->power_mgmt) {
+               if (codec->beep && codec->power_save_node) {
                        err = add_fake_beep_paths(codec);
                        if (err < 0)
                                return err;

diff --git a/sound/pci/hda/patch_sigmatel.c b/sound/pci/hda/patch_sigmatel.c
index 7e531d5..5b7c173 100644 (file)
--- a/sound/pci/hda/patch_sigmatel.c
+++ b/sound/pci/hda/patch_sigmatel.c
@@ -4494,7 +4494,7 @@ static int patch_stac92hd73xx(struct hda_codec *codec)
                return err;
 
        spec = codec->spec;
-       codec->power_mgmt = 1;
+       codec->power_save_node = 1;
        spec->linear_tone_beep = 0;
        spec->gen.mixer_nid = 0x1d;
        spec->have_spdif_mux = 1;
@@ -4600,7 +4600,7 @@ static int patch_stac92hd83xxx(struct hda_codec *codec)
        codec->epss = 0; /* longer delay needed for D3 */
 
        spec = codec->spec;
-       codec->power_mgmt = 1;
+       codec->power_save_node = 1;
        spec->linear_tone_beep = 0;
        spec->gen.own_eapd_ctl = 1;
        spec->gen.power_down_unused = 1;
@@ -4650,7 +4650,7 @@ static int patch_stac92hd95(struct hda_codec *codec)
        codec->epss = 0; /* longer delay needed for D3 */
 
        spec = codec->spec;
-       codec->power_mgmt = 1;
+       codec->power_save_node = 1;
        spec->linear_tone_beep = 0;
        spec->gen.own_eapd_ctl = 1;
        spec->gen.power_down_unused = 1;
@@ -4692,7 +4692,7 @@ static int patch_stac92hd71bxx(struct hda_codec *codec)
                return err;
 
        spec = codec->spec;
-       codec->power_mgmt = 1;
+       codec->power_save_node = 1;
        spec->linear_tone_beep = 0;
        spec->gen.own_eapd_ctl = 1;
        spec->gen.power_down_unused = 1;

diff --git a/sound/pci/hda/patch_via.c b/sound/pci/hda/patch_via.c
index d5d1dca..485663b 100644 (file)
--- a/sound/pci/hda/patch_via.c
+++ b/sound/pci/hda/patch_via.c
@@ -133,7 +133,7 @@ static struct via_spec *via_new_spec(struct hda_codec *codec)
        spec->gen.keep_eapd_on = 1;
        spec->gen.pcm_playback_hook = via_playback_pcm_hook;
        spec->gen.add_stereo_mix_input = HDA_HINT_STEREO_MIX_AUTO;
-       codec->power_mgmt = 1;
+       codec->power_save_node = 1;
        spec->gen.power_down_unused = 1;
        return spec;
 }
@@ -236,7 +236,7 @@ static int via_pin_power_ctl_get(struct snd_kcontrol *kcontrol,
                                 struct snd_ctl_elem_value *ucontrol)
 {
        struct hda_codec *codec = snd_kcontrol_chip(kcontrol);
-       ucontrol->value.enumerated.item[0] = codec->power_mgmt;
+       ucontrol->value.enumerated.item[0] = codec->power_save_node;
        return 0;
 }
 
@@ -247,9 +247,9 @@ static int via_pin_power_ctl_put(struct snd_kcontrol *kcontrol,
        struct via_spec *spec = codec->spec;
        bool val = !!ucontrol->value.enumerated.item[0];
 
-       if (val == codec->power_mgmt)
+       if (val == codec->power_save_node)
                return 0;
-       codec->power_mgmt = val;
+       codec->power_save_node = val;
        spec->gen.power_down_unused = val;
        analog_low_current_mode(codec);
        return 1;
@@ -295,7 +295,7 @@ static void __analog_low_current_mode(struct hda_codec *codec, bool force)
        bool enable;
        unsigned int verb, parm;
 
-       if (!codec->power_mgmt)
+       if (!codec->power_save_node)
                enable = false;
        else
                enable = is_aa_path_mute(codec) && !spec->gen.active_streams;
@@ -517,7 +517,7 @@ static int via_parse_auto_config(struct hda_codec *codec)
                return err;
 
        /* disable widget PM at start for compatibility */
-       codec->power_mgmt = 0;
+       codec->power_save_node = 0;
        spec->gen.power_down_unused = 0;
        return 0;
 }