On Fri, Jun 19, 2015 at 05:28:11PM +0900, Chanwoo Choi wrote: > On Fri, Jun 19, 2015 at 5:17 PM, Charles Keepax > <ckeepax@xxxxxxxxxxxxxxxxxxxxxxxxxxx> wrote: > > On Fri, Jun 19, 2015 at 11:25:57AM +0900, Chanwoo Choi wrote: > >> Hi Charles, > >> > >> On Thu, Jun 18, 2015 at 11:43 PM, Charles Keepax > >> <ckeepax@xxxxxxxxxxxxxxxxxxxxxxxxxxx> wrote: > >> > This patch adds bindings for the basic microphone detection platform > >> > data. > >> > > >> > Signed-off-by: Charles Keepax <ckeepax@xxxxxxxxxxxxxxxxxxxxxxxxxxx> > >> > --- > >> > + dbtime = 0; > >> > + device_property_read_u32(arizona->dev, "wlf,micd-dbtime", &dbtime); > >> > + switch (dbtime) { > >> > + case 2: > >> > >> I'd like you to define the constant variable for specific integer > >> value to improve the readability. > >> e.g., > >> > >> #define MICD_DBTIME_XXX 2 > >> #define MICD_DBTIME_XXX 4 > >> > >> > + pdata->micd_dbtime = 0x10000; > >> > >> Also, you better to define the constant variable for "0x10000" to > >> improbe readability in the include/linux/mfd/arizona.h. If you just > >> use the hex value, the other developer cannot analyze the meaning of > >> "0x10000". > >> > >> > + break; > >> > + case 4: > >> > >> ditto. > >> > > > > I am not sure these two really warrant a define the number in DT > > indicates the number of debounces to perform. > > > > #define MICD_DBTIME_TWO 2 > > No. I mean that you should define the appropriate name of definition > to indicate the meaning of 2 or 4. Just not 2 -> TWO. > > 2 is 2 second? or 2 is milli-second? or Is there any other meaning? > I can never know the meaning of '2' without any description and any > proper name of definition. It is literally two, two debounces, I really can't see what I could call the define. What do you think to the idea I suggested to rename the variable dbtime -> num_debounces? Thanks, Charles -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html