Skip to contentSkip to conversation

env: mmc: fix offsets relative to the end of the partition

PATCH Applied Michael Walle 5 participants 7 messages Jun 5, 2025 – Jul 2, 2025

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 env: mmc: fix offsets relative to the end of the partition

According to the help text, you can set negative offsets to indicated that the offset is relative to the end of the parition. But kconfig doesn't let you specify negative hex values. I think this fell through the cracks when converting the symbol from a '#define' to a kconfig option.

Introduce a new boolean kconfig option to switch on the "relative to the end" behavior.

---
v2:
- made the Kconfig help text clearer on MMC hardware partitions. I've used the term "MMC hardware partition" as it was already used in some help texts. Thanks Quentin.
- fixed typo. Thanks Quentin.

 env/Kconfig | 42 +++++++++++++++++++++++++-----------------
 env/mmc.c   |  8 ++++++++
 2 files changed, 33 insertions(+), 17 deletions(-)
env/Kconfig +25 -17
index d7a7e81144b..58500becbb7 100644
@@ -231,14 +231,6 @@ config ENV_IS_IN_MMC
 	  These two #defines specify the offset and size of the environment
 	  area within the specified MMC device.
 
-	  If offset is positive (the usual case), it is treated as relative to
-	  the start of the MMC partition. If offset is negative, it is treated
-	  as relative to the end of the MMC partition. This can be useful if
-	  your board may be fitted with different MMC devices, which have
-	  different sizes for the MMC partitions, and you always want the
-	  environment placed at the very end of the partition, to leave the
-	  maximum possible space before it, to store other data.
-
 	  These two values are in units of bytes, but must be aligned to an
 	  MMC sector boundary.
 
@@ -249,9 +241,6 @@ config ENV_IS_IN_MMC
 	  valid backup copy in case the other copy is corrupted, e.g. due
 	  to a power failure during a "saveenv" operation.
 
-	  This value may also be positive or negative; this is handled in the
-	  same way as CONFIG_ENV_OFFSET.
-
 	  In case CONFIG_SYS_MMC_ENV_PART is 1 (i.e. environment in eMMC boot
 	  partition) then setting CONFIG_ENV_OFFSET_REDUND to the same value
 	  as CONFIG_ENV_OFFSET makes use of the second eMMC boot partition for
@@ -611,9 +600,18 @@ config ENV_OFFSET
 	  Offset from the start of the device (or partition).
 
 	  This offset may be interpreted differently depending on the chosen
-	  ENV_IS_IN_* options. For example, for ENV_IS_IN_MMC=y, this offset may
-	  be negative to indicate an offset backwards from the end of the
-	  partition. See the relevant help messages for more details.
+	  ENV_IS_IN_* options. See the relevant help messages for more details.
+
+config ENV_OFFSET_RELATIVE_END
+	bool "Offset is relative to the end of the partition"
+	depends on ENV_IS_IN_MMC
+	help
+	  Treat the environment offset as relative to the end of the MMC
+	  hardware partition. This can be useful if your board may be fitted
+	  with different MMC devices, which have different sizes for the MMC
+	  hardware partitions, and you always want the environment placed at the
+	  very end of the partition, to leave the maximum possible space before
+	  it, to store other data.
 
 config ENV_OFFSET_REDUND
 	hex "Redundant environment offset"
@@ -626,9 +624,19 @@ config ENV_OFFSET_REDUND
 	  environment location.
 
 	  This offset may be interpreted differently depending on the chosen
-	  ENV_IS_IN_* options. For example, for ENV_IS_IN_MMC=y, this offset may
-	  be negative to indicate an offset backwards from the end of the
-	  partition. See the relevant help messages for more details.
+	  ENV_IS_IN_* options. See the relevant help messages for more details.
+
+config ENV_OFFSET_REDUND_RELATIVE_END
+	bool "Offset is relative to the end of the partition"
+	depends on SYS_REDUNDAND_ENVIRONMENT
+	depends on ENV_IS_IN_MMC
+	help
+	  Treat the redundant environment offset as relative to the end of the
+	  MMC hardware partition. This can be useful if your board may be
+	  fitted with different MMC devices, which have different sizes for the
+	  MMC hardware partitions, and you always want the environment placed at
+	  the very end of the partition, to leave the maximum possible space
+	  before it, to store other data.
 
 config ENV_SIZE
 	hex "Environment Size"
env/mmc.c +8 -0
index 8848371eb4f..8211470a08f 100644
@@ -29,11 +29,19 @@
 
 #else
 /* Default ENV offset when not defined in Device Tree */
+#if !defined(CONFIG_ENV_OFFSET_RELATIVE_END)
 #define ENV_MMC_OFFSET		CONFIG_ENV_OFFSET
+#else
+#define ENV_MMC_OFFSET		(-(CONFIG_ENV_OFFSET))
+#endif
 
 #if defined(CONFIG_ENV_OFFSET_REDUND)
+#if !defined(CONFIG_ENV_OFFSET_REDUND_RELATIVE_END)
 #define ENV_MMC_OFFSET_REDUND	CONFIG_ENV_OFFSET_REDUND
 #else
+#define ENV_MMC_OFFSET_REDUND	(-(CONFIG_ENV_OFFSET_REDUND))
+#endif
+#else
 #define ENV_MMC_OFFSET_REDUND	ENV_MMC_INVALID_OFFSET
 #endif
 #endif
Signature · 1 line
2.39.5
Reviewed-by on v2 1/1
#1 lore raw

Hi Michael,

Quoted 1 line · Michael Walle

According to the help text, you can set negative offsets to indicated

s/indicated/indicate/

Quoted 1 line

that the offset is relative to the end of the parition. But kconfig

s/parition/partition/

Quoted 4 lines

doesn't let you specify negative hex values. I think this fell through the cracks when converting the symbol from a '#define' to a kconfig option.

Maybe a Fixes: tag would be nice there, but since we don't have stable releases like the kernel, not sure it matters much :)

Quoted 4 lines

Introduce a new boolean kconfig option to switch on the "relative to the end" behavior.

Not sure about the ramifications, but the change looks reasonable to me, so:

Maybe we should have some test for that to make sure it works as expected and keeps working as expected?

Thanks!
Quentin

#2 lore raw
Quoted 9 lines · Quentin Schulz

Hi Michael,

Quoted 1 line · Michael Walle

According to the help text, you can set negative offsets to indicated

s/indicated/indicate/

Quoted 1 line

that the offset is relative to the end of the parition. But kconfig

Quoted 8 lines

s/parition/partition/

Quoted 4 lines

doesn't let you specify negative hex values. I think this fell through the cracks when converting the symbol from a '#define' to a kconfig option.

Maybe a Fixes: tag would be nice there, but since we don't have stable releases like the kernel, not sure it matters much :)

Please always include a Fixes tag when appropriate.

Thank you,
Andrew

Quoted 13 lines
Quoted 4 lines

Introduce a new boolean kconfig option to switch on the "relative to the end" behavior.

Not sure about the ramifications, but the change looks reasonable to me, so:

Maybe we should have some test for that to make sure it works as expected and keeps working as expected?

Thanks!
Quentin

#3 lore raw

Hi Andrew,

Quoted 4 lines
Quoted 1 line

Maybe a Fixes: tag would be nice there, but since we don't have stable

releases like the kernel, not sure it matters much :)

Please always include a Fixes tag when appropriate.

Will do. But please use reply-to-all as not everyone is subscribed to all the MLs and I've just found your reply by accident.

-michael

#4 lore raw
In reply to Michael Walle
Quoted 5 lines · Michael Walle

According to the help text, you can set negative offsets to indicated that the offset is relative to the end of the parition. But kconfig doesn't let you specify negative hex values. I think this fell through the cracks when converting the symbol from a '#define' to a kconfig option.

Not sure with u-boot upstream master, but with a downstream NXP-based tree (version v2024.04) I think it just works with something like:

ccimx91-dvk_defconfig:CONFIG_ENV_OFFSET=0xFFFFFFFFFFFFC000 ccimx91-dvk_defconfig:CONFIG_ENV_OFFSET_REDUND=0xFFFFFFFFFFFFC000 ccimx93-dvk_defconfig:CONFIG_ENV_OFFSET=0xFFFFFFFFFFFFC000 ccimx93-dvk_defconfig:CONFIG_ENV_OFFSET_REDUND=0xFFFFFFFFFFFFC000

After all, the symbol gets translated to a signed s64 variable.

--
Javier Viguera
Digi International Inc.

#5 lore raw

Hi Javier,

Quoted 6 lines
Quoted 5 lines

According to the help text, you can set negative offsets to indicated that the offset is relative to the end of the parition. But kconfig doesn't let you specify negative hex values. I think this fell through the cracks when converting the symbol from a '#define' to a kconfig option.

Quoted 6 lines

Not sure with u-boot upstream master, but with a downstream NXP-based tree (version v2024.04) I think it just works with something like:

ccimx91-dvk_defconfig:CONFIG_ENV_OFFSET=0xFFFFFFFFFFFFC000 ccimx91-dvk_defconfig:CONFIG_ENV_OFFSET_REDUND=0xFFFFFFFFFFFFC000 ccimx93-dvk_defconfig:CONFIG_ENV_OFFSET=0xFFFFFFFFFFFFC000 ccimx93-dvk_defconfig:CONFIG_ENV_OFFSET_REDUND=0xFFFFFFFFFFFFC000

Yeah, but I wouldn't call that very user friendly if you have to convert the offset the two's complement representation yourself.

Quoted 1 line

After all, the symbol gets translated to a signed s64 variable.

Also I've just noticed, that env/sf.c uses ulong to store ENV_OFFSET.

-michael

Applied
#6 lore raw
In reply to Michael Walle
Quoted 10 lines · Michael Walle

According to the help text, you can set negative offsets to indicated that the offset is relative to the end of the parition. But kconfig doesn't let you specify negative hex values. I think this fell through the cracks when converting the symbol from a '#define' to a kconfig option.

Introduce a new boolean kconfig option to switch on the "relative to the end" behavior.

Applied to mmc-next after resolved conflicts. Sorry for late.

Thanks,
Peng