Skip to contentSkip to conversation

FIELD_PREP failure in drivers/hwmon/macsmc-hwmon.c

PATCH Nathan Chancellor 3 participants 4 messages Jan 19 – Jan 29

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

Hi folks,

There is a build error from a FIELD_PREP in drivers/hwmon/macsmc-hwmon.c when building with clang-17 and older:

  drivers/hwmon/macsmc-hwmon.c:249:10: error: call to '__compiletime_assert_814' declared with 'error' attribute: FIELD_PREP: value too large for the field
    249 |                        FIELD_PREP(FLT_MANT_MASK, val);
        |                        ^
  include/linux/bitfield.h:137:3: note: expanded from macro 'FIELD_PREP'
    137 |                 __FIELD_PREP(_mask, _val, "FIELD_PREP: ");              \
        |                 ^
  include/linux/bitfield.h:90:3: note: expanded from macro '__FIELD_PREP'
     90 |                 __BF_FIELD_CHECK_MASK(mask, val, pfx);                  \
        |                 ^
  include/linux/bitfield.h:69:3: note: expanded from macro '__BF_FIELD_CHECK_MASK'
     69 |                 BUILD_BUG_ON_MSG(__builtin_constant_p(_val) ?           \
        |                 ^
  note: (skipping 2 expansions in backtrace; use -fmacro-backtrace-limit=0 to see all)
  include/linux/compiler_types.h:619:2: note: expanded from macro '_compiletime_assert'
    619 |         __compiletime_assert(condition, msg, prefix, suffix)
        |         ^
  include/linux/compiler_types.h:612:4: note: expanded from macro '__compiletime_assert'
    612 |                         prefix ## suffix();                             \
        |                         ^
  <scratch space>:18:1: note: expanded from here
     18 | __compiletime_assert_814
        | ^

This does not appear to be strictly clang related, as this can be reproduced with GCC if macsmc_hwmon_write_f32() and macsmc_hwmon_write_key() are marked as __always_inline (after an internal change in LLVM, these functions are not inlined anymore):

===

drivers/hwmon/macsmc-hwmon.c +2 -2
index 1c0bbec7e8eb..e66d6ee30d7f 100644
@@ -224,7 +224,7 @@ static int macsmc_hwmon_read_key(struct apple_smc *smc,
        return 0;
 }
 
-static int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
+static __always_inline int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
 {
        u64 val;
        u32 fval = 0;
@@ -252,7 +252,7 @@ static int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
        return apple_smc_write_u32(smc, key, fval);
 }
 
-static int macsmc_hwmon_write_key(struct apple_smc *smc,
+static __always_inline int macsmc_hwmon_write_key(struct apple_smc *smc,
                                  struct macsmc_hwmon_sensor *sensor, long val)
 {
        switch (sensor->info.type_code) {

===

In file included from <command-line>:
In function 'macsmc_hwmon_write_f32',
inlined from 'macsmc_hwmon_write_key' at drivers/hwmon/macsmc-hwmon.c:261:10,
inlined from 'macsmc_hwmon_write_fan.isra' at drivers/hwmon/macsmc-hwmon.c:317:10:
include/linux/compiler_types.h:631:45: error: call to '__compiletime_assert_814' declared with attribute error: FIELD_PREP: value too large for the field
631 | _compiletime_assert(condition, msg, __compiletime_assert_, __COUNTER__)
| ^
include/linux/compiler_types.h:612:25: note: in definition of macro '__compiletime_assert'

    612 |                         prefix ## suffix();                             \
        |                         ^~~~~~
  include/linux/compiler_types.h:631:9: note: in expansion of macro '_compiletime_assert'
    631 |         _compiletime_assert(condition, msg, __compiletime_assert_, __COUNTER__)
        |         ^~~~~~~~~~~~~~~~~~~
  include/linux/build_bug.h:39:37: note: in expansion of macro 'compiletime_assert'
     39 | #define BUILD_BUG_ON_MSG(cond, msg) compiletime_assert(!(cond), msg)
        |                                     ^~~~~~~~~~~~~~~~~~
  include/linux/bitfield.h:69:17: note: in expansion of macro 'BUILD_BUG_ON_MSG'
     69 |                 BUILD_BUG_ON_MSG(__builtin_constant_p(_val) ?           \
        |                 ^~~~~~~~~~~~~~~~
  include/linux/bitfield.h:90:17: note: in expansion of macro '__BF_FIELD_CHECK_MASK'
     90 |                 __BF_FIELD_CHECK_MASK(mask, val, pfx);                  \
        |                 ^~~~~~~~~~~~~~~~~~~~~
  include/linux/bitfield.h:137:17: note: in expansion of macro '__FIELD_PREP'
    137 |                 __FIELD_PREP(_mask, _val, "FIELD_PREP: ");              \
        |                 ^~~~~~~~~~~~
  drivers/hwmon/macsmc-hwmon.c:249:24: note: in expansion of macro 'FIELD_PREP'
    249 |                        FIELD_PREP(FLT_MANT_MASK, val);
        |                        ^~~~~~~~~~

Justin did a little digging and saw that through

macsmc_hwmon_write_fan()
-> macsmc_hwmon_write_key()

    -> macsmc_hwmon_write_f32()

value is 1 so:

static __always_inline int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)

{
        u64 val;
        u32 fval = 0;
        int exp = 0, neg;

        val = abs(value); // val == 1
        neg = val != value;

        if (val) {
                int msb = __fls(val) - exp; // __fls(1) == 0, thus msb == 0

                if (msb > 23) {
                        val >>= msb - FLT_MANT_BIAS;
                        exp -= msb - FLT_MANT_BIAS;
                } else if (msb < 23) {
                        val <<= FLT_MANT_BIAS - msb; // val = (1 << 23) == 0x800000
                        exp += msb;
                }

                fval = FIELD_PREP(FLT_SIGN_MASK, neg) |
                       FIELD_PREP(FLT_EXP_MASK, exp + FLT_EXP_BIAS) |
                       // Fails __BF_FIELD_CHECK_MASK as
                       //
                       // __builtin_ffsll(0x7FFFFF) - 1) == 0
                       //
                       // ~(0x7FFFFF >> 0) & (0x800000) == 0x800000
                       FIELD_PREP(FLT_MANT_MASK, val);
        }

        return apple_smc_write_u32(smc, key, fval);
}

It seems like msb of zero is unexpected in this path but I am not sure what the fix is, hence the report.

Cheers,
Nathan

maintainer
#1 lore raw

Hi,

Quoted 128 lines · Nathan Chancellor

Hi folks,

There is a build error from a FIELD_PREP in drivers/hwmon/macsmc-hwmon.c when building with clang-17 and older:

  drivers/hwmon/macsmc-hwmon.c:249:10: error: call to '__compiletime_assert_814' declared with 'error' attribute: FIELD_PREP: value too large for the field
    249 |                        FIELD_PREP(FLT_MANT_MASK, val);
        |                        ^
  include/linux/bitfield.h:137:3: note: expanded from macro 'FIELD_PREP'
    137 |                 __FIELD_PREP(_mask, _val, "FIELD_PREP: ");              \
        |                 ^
  include/linux/bitfield.h:90:3: note: expanded from macro '__FIELD_PREP'
     90 |                 __BF_FIELD_CHECK_MASK(mask, val, pfx);                  \
        |                 ^
  include/linux/bitfield.h:69:3: note: expanded from macro '__BF_FIELD_CHECK_MASK'
     69 |                 BUILD_BUG_ON_MSG(__builtin_constant_p(_val) ?           \
        |                 ^
  note: (skipping 2 expansions in backtrace; use -fmacro-backtrace-limit=0 to see all)
  include/linux/compiler_types.h:619:2: note: expanded from macro '_compiletime_assert'
    619 |         __compiletime_assert(condition, msg, prefix, suffix)
        |         ^
  include/linux/compiler_types.h:612:4: note: expanded from macro '__compiletime_assert'
    612 |                         prefix ## suffix();                             \
        |                         ^
  <scratch space>:18:1: note: expanded from here
     18 | __compiletime_assert_814
        | ^

This does not appear to be strictly clang related, as this can be reproduced with GCC if macsmc_hwmon_write_f32() and macsmc_hwmon_write_key() are marked as __always_inline (after an internal change in LLVM, these functions are not inlined anymore):

===

drivers/hwmon/macsmc-hwmon.c +2 -2
index 1c0bbec7e8eb..e66d6ee30d7f 100644
@@ -224,7 +224,7 @@ static int macsmc_hwmon_read_key(struct apple_smc *smc,
        return 0;
 }
 
-static int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
+static __always_inline int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
 {
        u64 val;
        u32 fval = 0;
@@ -252,7 +252,7 @@ static int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
        return apple_smc_write_u32(smc, key, fval);
 }
 
-static int macsmc_hwmon_write_key(struct apple_smc *smc,
+static __always_inline int macsmc_hwmon_write_key(struct apple_smc *smc,
                                  struct macsmc_hwmon_sensor *sensor, long val)
 {
        switch (sensor->info.type_code) {

===

In file included from <command-line>:
In function 'macsmc_hwmon_write_f32',
inlined from 'macsmc_hwmon_write_key' at drivers/hwmon/macsmc-hwmon.c:261:10,
inlined from 'macsmc_hwmon_write_fan.isra' at drivers/hwmon/macsmc-hwmon.c:317:10:
include/linux/compiler_types.h:631:45: error: call to '__compiletime_assert_814' declared with attribute error: FIELD_PREP: value too large for the field
631 | _compiletime_assert(condition, msg, __compiletime_assert_, __COUNTER__)
| ^
include/linux/compiler_types.h:612:25: note: in definition of macro '__compiletime_assert'

    612 |                         prefix ## suffix();                             \
        |                         ^~~~~~
  include/linux/compiler_types.h:631:9: note: in expansion of macro '_compiletime_assert'
    631 |         _compiletime_assert(condition, msg, __compiletime_assert_, __COUNTER__)
        |         ^~~~~~~~~~~~~~~~~~~
  include/linux/build_bug.h:39:37: note: in expansion of macro 'compiletime_assert'
     39 | #define BUILD_BUG_ON_MSG(cond, msg) compiletime_assert(!(cond), msg)
        |                                     ^~~~~~~~~~~~~~~~~~
  include/linux/bitfield.h:69:17: note: in expansion of macro 'BUILD_BUG_ON_MSG'
     69 |                 BUILD_BUG_ON_MSG(__builtin_constant_p(_val) ?           \
        |                 ^~~~~~~~~~~~~~~~
  include/linux/bitfield.h:90:17: note: in expansion of macro '__BF_FIELD_CHECK_MASK'
     90 |                 __BF_FIELD_CHECK_MASK(mask, val, pfx);                  \
        |                 ^~~~~~~~~~~~~~~~~~~~~
  include/linux/bitfield.h:137:17: note: in expansion of macro '__FIELD_PREP'
    137 |                 __FIELD_PREP(_mask, _val, "FIELD_PREP: ");              \
        |                 ^~~~~~~~~~~~
  drivers/hwmon/macsmc-hwmon.c:249:24: note: in expansion of macro 'FIELD_PREP'
    249 |                        FIELD_PREP(FLT_MANT_MASK, val);
        |                        ^~~~~~~~~~

Justin did a little digging and saw that through

macsmc_hwmon_write_fan()
-> macsmc_hwmon_write_key()

    -> macsmc_hwmon_write_f32()

value is 1 so:

static __always_inline int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)

{
        u64 val;
        u32 fval = 0;
        int exp = 0, neg;

        val = abs(value); // val == 1
        neg = val != value;

        if (val) {
                int msb = __fls(val) - exp; // __fls(1) == 0, thus msb == 0

                if (msb > 23) {
                        val >>= msb - FLT_MANT_BIAS;
                        exp -= msb - FLT_MANT_BIAS;
                } else if (msb < 23) {
                        val <<= FLT_MANT_BIAS - msb; // val = (1 << 23) == 0x800000
                        exp += msb;
                }

                fval = FIELD_PREP(FLT_SIGN_MASK, neg) |
                       FIELD_PREP(FLT_EXP_MASK, exp + FLT_EXP_BIAS) |
                       // Fails __BF_FIELD_CHECK_MASK as
                       //
                       // __builtin_ffsll(0x7FFFFF) - 1) == 0
                       //
                       // ~(0x7FFFFF >> 0) & (0x800000) == 0x800000
                       FIELD_PREP(FLT_MANT_MASK, val);
        }

        return apple_smc_write_u32(smc, key, fval);
}
Quoted 3 lines

It seems like msb of zero is unexpected in this path but I am not sure what the fix is, hence the report.

I attached two AI reviews of the driver. That may give some hints.

James, please have a look.

Thanks,
Guenter

---
commit 785205fd81399bd8e49065aee3362a99d5702321
Author: James Calligeros <[email protected]>
hwmon: Add Apple Silicon SMC hwmon driver

Add a hwmon driver to expose current, power, temperature, and voltage monitoring sensors, as well as fan speed monitoring and control via the SMC on Apple Silicon devices.

Quoted 9 lines
drivers/hwmon/macsmc-hwmon.c new file +3 -0
new file mode 100644
index 000000000000..1c0bbec7e8eb
@@ -0,0 +1,851 @@
+// SPDX-License-Identifier: GPL-2.0-only OR MIT
+/*
+ * Apple SMC hwmon driver for Apple Silicon platforms

[ ... ]

drivers/hwmon/macsmc-hwmon.c

Quoted 8 lines

+ */

drivers/hwmon/macsmc-hwmon.c new file +7 -0
+
+#include <linux/bitfield.h>
+#include <linux/hwmon.h>
+#include <linux/mfd/macsmc.h>
+#include <linux/module.h>
+#include <linux/of.h>
+#include <linux/platform_device.h>

The driver uses __fls() later on. Should <linux/bitops.h> be included here?

Quoted 4 lines
drivers/hwmon/macsmc-hwmon.c new file +4 -0
+
+#define MAX_LABEL_LENGTH	32
+
+/* Temperature, voltage, current, power, fan(s) */

[ ... ]

Quoted 54 lines
drivers/hwmon/macsmc-hwmon.c new file +54 -0
+/*
+ * Many sensors report their data as IEEE-754 floats. No other SMC function uses
+ * them.
+ */
+static int macsmc_hwmon_read_f32_scaled(struct apple_smc *smc, smc_key key,
+					int *p, int scale)
+{
+	u32 fval;
+	u64 val;
+	int ret, exp;
+
+	ret = apple_smc_read_u32(smc, key, &fval);
+	if (ret < 0)
+		return ret;
+
+	val = ((u64)((fval & FLT_MANT_MASK) | BIT(23)));
+	exp = ((fval >> 23) & 0xff) - FLT_EXP_BIAS - FLT_MANT_BIAS;
+
+	/* We never have negatively scaled SMC floats */
+	val *= scale;
+
+	if (exp > 63)
+		val = U64_MAX;
+	else if (exp < -63)
+		val = 0;
+	else if (exp < 0)
+		val >>= -exp;
+	else if (exp != 0 && (val & ~((1UL << (64 - exp)) - 1))) /* overflow */
+		val = U64_MAX;
+	else
+		val <<= exp;
+
+	if (fval & FLT_SIGN_MASK) {
+		if (val > (-(s64)INT_MIN))
+			*p = INT_MIN;
+		else
+			*p = -val;
+	} else {
+		if (val > INT_MAX)
+			*p = INT_MAX;
+		else
+			*p = val;
+	}
+
+	return 0;
+}
+
+/*
+ * The SMC has keys of multiple types, denoted by a FourCC of the same format
+ * as the key ID. We don't know what data type a key encodes until we poke at it.
+ */
+static int macsmc_hwmon_read_key(struct apple_smc *smc,
+				 struct macsmc_hwmon_sensor *sensor, int scale,
+				 long *val)

drivers/hwmon/macsmc-hwmon.c

Quoted 10 lines
drivers/hwmon/macsmc-hwmon.c new file +10 -0
+{
+	int ret;
+
+	switch (sensor->info.type_code) {
+	/* 32-bit IEEE 754 float */
+	case __SMC_KEY('f', 'l', 't', ' '): {
+		u32 flt_ = 0;
+
+		ret = macsmc_hwmon_read_f32_scaled(smc, sensor->macsmc_key,
+						   &flt_, scale);

macsmc_hwmon_read_f32_scaled() takes int * as its third argument, but here a pointer to u32 is passed. This results in the signed integer result being stored in an unsigned variable. When flt_ is subsequently assigned to *val (which is long), the sign extension is lost, causing negative values (such as temperatures below zero) to be reported as large positive numbers. Should flt_ be declared as int instead?

Quoted 8 lines
drivers/hwmon/macsmc-hwmon.c new file +8 -0
+		if (ret)
+			return ret;
+
+		*val = flt_;
+		break;
+	}
+	/* 48.16 fixed point decimal */
+	case __SMC_KEY('i', 'o', 'f', 't'): {

[ ... ]

Quoted 6 lines
drivers/hwmon/macsmc-hwmon.c new file +6 -0
+		break;
+	}
+	default:
+		return -EOPNOTSUPP;
+	}
+

drivers/hwmon/macsmc-hwmon.c

Quoted 10 lines
drivers/hwmon/macsmc-hwmon.c new file +10 -0
+	return 0;
+}
+
+static int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
+{
+	u64 val;
+	u32 fval = 0;
+	int exp = 0, neg;
+
+	val = abs(value);

Does value come from user input? If value is INT_MIN, abs(value) might be undefined or return INT_MIN. Also, macsmc_hwmon_write passes long val, which is truncated to int value here. While fan speeds are likely small, should this take long to match the caller and handle potential overflow or large values correctly?

drivers/hwmon/macsmc-hwmon.c

Quoted 8 lines
drivers/hwmon/macsmc-hwmon.c new file +8 -0
+	neg = val != value;
+
+	if (val) {
+		int msb = __fls(val) - exp;
+
+		if (msb > 23) {
+			val >>= msb - FLT_MANT_BIAS;
+			exp -= msb - FLT_MANT_BIAS;

If msb > 23 (e.g. value is 1<<24), exp (which is 0) is decremented by 1 (24 - 23). This results in an effective exponent of -1. Should exp be incremented by msb - FLT_MANT_BIAS instead, similar to how it is incremented in the msb < 23 case (where it becomes msb)? The current logic seems to produce incorrect float values for integers larger than 2^23.

drivers/hwmon/macsmc-hwmon.c

Quoted 5 lines
drivers/hwmon/macsmc-hwmon.c new file +5 -0
+		} else if (msb < 23) {
+			val <<= FLT_MANT_BIAS - msb;
+			exp += msb;
+		}
+

What happens if msb == 23? The else if (msb < 23) condition is false, so it falls through. exp remains 0. However, for 1<<23, the exponent should be 23. It seems the msb == 23 case is mishandled and results in an incorrect exponent of 0.

drivers/hwmon/macsmc-hwmon.c

Quoted 7 lines
drivers/hwmon/macsmc-hwmon.c new file +7 -0
+		fval = FIELD_PREP(FLT_SIGN_MASK, neg) |
+		       FIELD_PREP(FLT_EXP_MASK, exp + FLT_EXP_BIAS) |
+		       FIELD_PREP(FLT_MANT_MASK, val);
+	}
+
+	return apple_smc_write_u32(smc, key, fval);
+}

[ ... ]

---
2nd review, pointing out the possible problem with FIELD_PREP:

The following is a review of commit 785205fd81399bd8e49065aee3362a99d5702321.

drivers/hwmon/macsmc-hwmon.c

The function macsmc_hwmon_write_f32 contains two issues: incorrect exponent calculation for larger integers and a value overflow in FIELD_PREP.

1. Incorrect Exponent Calculation

In macsmc_hwmon_write_f32, the logic for handling values where msb > 23 is incorrect.

   1         } else if (msb < 23) {
   2             val <<= FLT_MANT_BIAS - msb;
   3             exp += msb;
   4         }
  For msb < 23, exp correctly becomes msb (since exp starts at 0).
  However:

   1         if (msb > 23) {
   2             val >>= msb - FLT_MANT_BIAS;
   3             exp -= msb - FLT_MANT_BIAS;
  For msb > 23, exp is decremented. For example, if value is 2^24 (msb=24), exp becomes -1. The correct exponent should be 24. The code effectively calculates the inverse direction for the exponent when shifting right. It should simply be
  exp = msb in all cases (conceptually), or exp += msb if accumulating.

2. Value Overflow to FIELD_PREP

   1         fval = FIELD_PREP(FLT_SIGN_MASK, neg) |
   2                FIELD_PREP(FLT_EXP_MASK, exp + FLT_EXP_BIAS) |
   3                FIELD_PREP(FLT_MANT_MASK, val);

FLT_MANT_MASK covers bits 0-22. After the normalization shifts, val has the implicit leading bit set at bit 23 (defined as FLT_MANT_BIAS). FIELD_PREP checks if the value fits within the mask. Since bit 23 is set in val but not in FLT_MANT_MASK, this will trigger a warning/error (depending on kernel config) about value overflow. The implicit bit should be masked off before passing it to FIELD_PREP.

Suggested Fix:

    1 static int macsmc_hwmon_write_f32(struct apple_smc *smc, smc_key key, int value)
    2 {
    3     u64 val;
    4     u32 fval = 0;
    5     int exp = 0, neg;
    6 
    7     val = abs(value);
    8     neg = val != value;
    9 

10 if (val) {
11 int msb = __fls(val) - exp;
12
13 if (msb > 23)
14 val >>= msb - FLT_MANT_BIAS;
15 else
16 val <<= FLT_MANT_BIAS - msb;
17
18 exp += msb;
19
20 fval = FIELD_PREP(FLT_SIGN_MASK, neg) |
21 FIELD_PREP(FLT_EXP_MASK, exp + FLT_EXP_BIAS) |
22 FIELD_PREP(FLT_MANT_MASK, val & FLT_MANT_MASK);
23 }
24
25 return apple_smc_write_u32(smc, key, fval);
26 }

Note: __fls returns unsigned long, so mixing it with int exp is slightly messy but likely fine given the range of int. The simplified logic exp += msb works because exp starts at 0. Masking val ensures FIELD_PREP doesn't complain about the implicit bit.

maintainer
#2 lore raw
Quoted 6 lines · Guenter Roeck

Hi,

On Mon, Jan 19, 2026 at 12:58:17PM -0700, Nathan Chancellor wrote:

James, please have a look.

I didn't get any response, so I submitted two patches which should fix at least some of the problems with the driver.

Guenter

#3 lore raw

Hi all,

Quoted 3 lines · Guenter Roeck

I didn't get any response, so I submitted two patches which should fix at least some of the problems with the driver.

Apologies for getting to this last week. I have been both out of town for work and extremely unwell for most of this month. Thank you for taking a look.

Quoted 1 line

Guenter

James