ASoC: simple-card: Adjust the comments of simple card.
authorXiubo Li <Li.Xiubo@freescale.com>
Wed, 10 Sep 2014 01:59:55 +0000 (09:59 +0800)
committerMark Brown <broonie@kernel.org>
Wed, 10 Sep 2014 10:52:37 +0000 (11:52 +0100)
Signed-off-by: Xiubo Li <Li.Xiubo@freescale.com>
Signed-off-by: Mark Brown <broonie@kernel.org>
sound/soc/generic/simple-card.c

index e0abe772c0404b8e955ea9db0617f8c8a58e49a1..f79347c4c62f9bd220f931d1cc000d0eab2eff1d 100644 (file)
@@ -122,7 +122,7 @@ asoc_simple_card_sub_parse_of(struct device_node *np,
        int ret;
 
        /*
-        * get node via "sound-dai = <&phandle port>"
+        * Get node via "sound-dai = <&phandle port>"
         * it will be used as xxx_of_node on soc_bind_dai_link()
         */
        ret = of_parse_phandle_with_args(np, "sound-dai",
@@ -135,19 +135,19 @@ asoc_simple_card_sub_parse_of(struct device_node *np,
        if (args_count)
                *args_count = args.args_count;
 
-       /* get dai->name */
+       /* Get dai->name */
        ret = snd_soc_of_get_dai_name(np, name);
        if (ret < 0)
                return ret;
 
-       /* parse TDM slot */
+       /* Parse TDM slot */
        ret = snd_soc_of_parse_tdm_slot(np, &dai->slots, &dai->slot_width);
        if (ret)
                return ret;
 
        /*
-        * dai->sysclk come from
-        *  "clocks = <&xxx>" (if system has common clock)
+        * Parse dai->sysclk come from "clocks = <&xxx>"
+        * (if system has common clock)
         *  or "system-clock-frequency = <xxx>"
         *  or device's module clock.
         */
@@ -240,9 +240,11 @@ static int asoc_simple_card_dai_link_of(struct device_node *node,
                goto dai_link_of_err;
 
        if (strlen(prefix) && !bitclkmaster && !framemaster) {
-               /* No dai-link level and master setting was not found from
-                  sound node level, revert back to legacy DT parsing and
-                  take the settings from codec node. */
+               /*
+                * No DAI link level and master setting was found
+                * from sound node level, revert back to legacy DT
+                * parsing and take the settings from codec node.
+                */
                dev_dbg(dev, "%s: Revert to legacy daifmt parsing\n",
                        __func__);
                dai_props->cpu_dai.fmt = dai_props->codec_dai.fmt =
@@ -271,10 +273,10 @@ static int asoc_simple_card_dai_link_of(struct device_node *node,
                goto dai_link_of_err;
        }
 
-       /* simple-card assumes platform == cpu */
+       /* Simple Card assumes platform == cpu */
        dai_link->platform_of_node = dai_link->cpu_of_node;
 
-       /* Link name is created from CPU/CODEC dai name */
+       /* DAI link name is created from CPU/CODEC dai name */
        name = devm_kzalloc(dev,
                            strlen(dai_link->cpu_dai_name)   +
                            strlen(dai_link->codec_dai_name) + 2,
@@ -296,11 +298,11 @@ static int asoc_simple_card_dai_link_of(struct device_node *node,
                dai_props->codec_dai.sysclk);
 
        /*
-        * soc_bind_dai_link() will check cpu name
-        * after of_node matching if dai_link has cpu_dai_name.
-        * but, it will never match if name was created by fmt_single_name()
-        * remove cpu_dai_name if cpu_args was 0.
-        * see
+        * In soc_bind_dai_link() will check cpu name after
+        * of_node matching if dai_link has cpu_dai_name.
+        * but, it will never match if name was created by
+        * fmt_single_name() remove cpu_dai_name if cpu_args
+        * was 0. See:
         *      fmt_single_name()
         *      fmt_multiple_name()
         */
@@ -329,10 +331,10 @@ static int asoc_simple_card_parse_of(struct device_node *node,
        if (!node)
                return -EINVAL;
 
-       /* parsing the card name from DT */
+       /* Parse the card name from DT */
        snd_soc_of_parse_card_name(&priv->snd_card, "simple-audio-card,name");
 
-       /* off-codec widgets */
+       /* The off-codec widgets */
        if (of_property_read_bool(node, "simple-audio-card,widgets")) {
                ret = snd_soc_of_parse_audio_simple_widgets(&priv->snd_card,
                                        "simple-audio-card,widgets");
@@ -387,7 +389,7 @@ static int asoc_simple_card_parse_of(struct device_node *node,
        return 0;
 }
 
-/* update the reference count of the devices nodes at end of probe */
+/* Decrease the reference count of the device nodes */
 static int asoc_simple_card_unref(struct platform_device *pdev)
 {
        struct snd_soc_card *card = platform_get_drvdata(pdev);
@@ -416,29 +418,27 @@ static int asoc_simple_card_probe(struct platform_device *pdev)
        struct device *dev = &pdev->dev;
        int num_links, ret;
 
-       /* get the number of DAI links */
+       /* Get the number of DAI links */
        if (np && of_get_child_by_name(np, "simple-audio-card,dai-link"))
                num_links = of_get_child_count(np);
        else
                num_links = 1;
 
-       /* allocate the private data and the DAI link array */
+       /* Allocate the private data and the DAI link array */
        priv = devm_kzalloc(dev,
                        sizeof(*priv) + sizeof(*dai_link) * num_links,
                        GFP_KERNEL);
        if (!priv)
                return -ENOMEM;
 
-       /*
-        * init snd_soc_card
-        */
+       /* Init snd_soc_card */
        priv->snd_card.owner = THIS_MODULE;
        priv->snd_card.dev = dev;
        dai_link = priv->dai_link;
        priv->snd_card.dai_link = dai_link;
        priv->snd_card.num_links = num_links;
 
-       /* get room for the other properties */
+       /* Get room for the other properties */
        priv->dai_props = devm_kzalloc(dev,
                        sizeof(*priv->dai_props) * num_links,
                        GFP_KERNEL);