regmap: provide regmap_field helpers for simple bit operations
authorLi Chen <lchen@ambarella.com>
Mon, 23 May 2022 03:26:58 +0000 (20:26 -0700)
committerMark Brown <broonie@kernel.org>
Wed, 15 Jun 2022 10:17:45 +0000 (11:17 +0100)
We have set/clear/test operations for regmap, but not for regmap_field yet.
So let's introduce regmap_field helpers too.

In many instances regmap_field_update_bits() is used for simple bit setting
and clearing. In these cases the last argument is redundant and we can
hide it with a static inline function.

This adds three new helpers for simple bit operations: set_bits,
clear_bits and test_bits (the last one defined as a regular function).

Signed-off-by: Li Chen <lchen@ambarella.com>
Link: https://lore.kernel.org/r/180eef422c3.deae9cd960729.8518395646822099769@zohomail.com
Signed-off-by: Mark Brown <broonie@kernel.org>
drivers/base/regmap/regmap.c
include/linux/regmap.h

index 2221d98..cb0be5e 100644 (file)
@@ -2221,6 +2221,28 @@ int regmap_field_update_bits_base(struct regmap_field *field,
 EXPORT_SYMBOL_GPL(regmap_field_update_bits_base);
 
 /**
+ * regmap_field_test_bits() - Check if all specified bits are set in a
+ *                            register field.
+ *
+ * @field: Register field to operate on
+ * @bits: Bits to test
+ *
+ * Returns -1 if the underlying regmap_field_read() fails, 0 if at least one of the
+ * tested bits is not set and 1 if all tested bits are set.
+ */
+int regmap_field_test_bits(struct regmap_field *field, unsigned int bits)
+{
+       unsigned int val, ret;
+
+       ret = regmap_field_read(field, &val);
+       if (ret)
+               return ret;
+
+       return (val & bits) == bits;
+}
+EXPORT_SYMBOL_GPL(regmap_field_test_bits);
+
+/**
  * regmap_fields_update_bits_base() - Perform a read/modify/write cycle a
  *                                    register field with port ID
  *
index 8952fa3..d5b08f4 100644 (file)
@@ -1336,6 +1336,22 @@ static inline int regmap_field_update_bits(struct regmap_field *field,
                                             NULL, false, false);
 }
 
+static inline int regmap_field_set_bits(struct regmap_field *field,
+                                       unsigned int bits)
+{
+       return regmap_field_update_bits_base(field, bits, bits, NULL, false,
+                                            false);
+}
+
+static inline int regmap_field_clear_bits(struct regmap_field *field,
+                                         unsigned int bits)
+{
+       return regmap_field_update_bits_base(field, bits, 0, NULL, false,
+                                            false);
+}
+
+int regmap_field_test_bits(struct regmap_field *field, unsigned int bits);
+
 static inline int
 regmap_field_force_update_bits(struct regmap_field *field,
                               unsigned int mask, unsigned int val)
@@ -1769,6 +1785,27 @@ regmap_field_force_update_bits(struct regmap_field *field,
        return -EINVAL;
 }
 
+static inline int regmap_field_set_bits(struct regmap_field *field,
+                                       unsigned int bits)
+{
+       WARN_ONCE(1, "regmap API is disabled");
+       return -EINVAL;
+}
+
+static inline int regmap_field_clear_bits(struct regmap_field *field,
+                                         unsigned int bits)
+{
+       WARN_ONCE(1, "regmap API is disabled");
+       return -EINVAL;
+}
+
+static inline int regmap_field_test_bits(struct regmap_field *field,
+                                        unsigned int bits)
+{
+       WARN_ONCE(1, "regmap API is disabled");
+       return -EINVAL;
+}
+
 static inline int regmap_fields_write(struct regmap_field *field,
                                      unsigned int id, unsigned int val)
 {