Skip to content

Conversation

@flo-at
Copy link

@flo-at flo-at commented Dec 3, 2025

hat_map.dtb is required by the firmware to match HAT UUIDs from EEPROM data to their corresponding device tree overlays during boot. Without this file, HATs may fail to initialize properly even when their overlay files are present.

hat_map.dtb is generated and treated the same way overlay_map.dtb is. On the boot partition, it goes into the overlays/ directory, hence the special treatment.

- What I did
I changed rpi-base.inc so that hat_map.dtb is deployed and installed into the boot partition at the correct path.

- How I did it
It behaves just as overlay_map.dtb so I copied what was already in place to correctly handle that file.
The changes are minimal.

@agherzan
Copy link
Owner

agherzan commented Dec 4, 2025

Oh great! Yet another map file :)

Do you have some documentation on it? Also, could you update your git commit log format as per the contribution guidelines?

Thanks for this!

@flo-at
Copy link
Author

flo-at commented Dec 4, 2025

Documentation for this is lacking unfortunately. It came with this commit (also here).
There's nothing mentioned in the RPI config docs yet. I only found out about this when I compared a RPI OS setup to my Yocto based one that wouldn't recognize the HAT without an explicit dtoverlay= line in config.txt, while the same thing worked on RPI OS.

I'll check/update the commit log - sorry about that.

hat_map.dtb is required by the firmware to match HAT UUIDs from
EEPROM data to their corresponding device tree overlays during boot.
Without this file, HATs may fail to initialize properly even when their
overlay files are present.

Signed-off-by: Florian Wickert <[email protected]>
@flo-at
Copy link
Author

flo-at commented Dec 4, 2025

I created an issue in the RPI documentation repo: raspberrypi/documentation#4264

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants