hl_fw_load_fw_to_device(9)

okay bestie, welcome to hl_fw_load_fw_to_device(9) from the Kernel API Manual ✨ this is literally the page for the function that loads F/W code to device's memory, and we're gonna get into it 🫶

💖 NAME 💖

hl_fw_load_fw_to_device — Load F/W code to device's memory. 💅

✨ SYNOPSIS ✨

int hl_fw_load_fw_to_device (struct hl_device *hdev , const char
       *fw_name , void __iomem *dst , u32 src_offset , u32 size );

🎀 ARGUMENTS 🎀

• hdev — pointer to hl_device structure. that's the device bestie, giving main character energy.
• fw_name — the firmware image name. yep, the name of the firmware image, no cap.
• dst — IO memory mapped address space to copy firmware to. it's the destination vibe.
• src_offset — offset in src FW to copy from. lowkey where the copy starts in the source firmware.
• size — amount of bytes to copy (0 to copy the whole binary). so if it's 0, the whole binary gets copied 👑

🦋 DESCRIPTION 🦋

Copy fw code from firmware file to device memory. that's it, that's the function 💖 it literally takes the fw code from the firmware file and copies it into the device's memory. no extra lore, just a firmware handoff with immaculate vibes ✨

🌸 RETURN 🌸

0 on success, non-zero for failure. so like, 0 means slay, non-zero means something went sideways 😭

💅 SEE ALSO 💅

• Kernel file ./drivers/accel/habanalabs/common/firmware_if.c
• hl_fw_version_cmp(9)
• extract_u32_until_given_char(9)
• hl_get_sw_major_minor_subminor(9)
• hl_get_preboot_major_minor(9)
• hl_release_firmware(9)
• hl_fw_copy_fw_to_device(9)
• hl_fw_copy_msg_to_device(9)
• hl_fw_send_cpu_message(9)
• hl_fw_preboot_update_state(9)
• hl_fw_dynamic_report_error_status(9)
• hl_fw_dynamic_send_cmd(9)
• hl_fw_dynamic_extract_fw_response(9)
• hl_fw_dynamic_wait_for_status(9)
• hl_fw_dynamic_send_clear_cmd(9)
• hl_fw_dynamic_send_protocol_cmd(9)
• hl_fw_compat_crc32(9)
• hl_fw_dynamic_validate_memory_bound(9)
• hl_fw_dynamic_validate_descriptor(9)
• hl_fw_dynamic_read_and_validate_descriptor(9)
• hl_fw_dynamic_request_descriptor(9)
• hl_fw_dynamic_read_device_fw_version(9)
• hl_fw_dynamic_copy_image(9)
• hl_fw_dynamic_copy_msg(9)
• hl_fw_boot_fit_update_state(9)
• hl_fw_dynamic_load_image(9)
• hl_fw_linux_update_state(9)
• hl_fw_dynamic_send_msg(9)
• hl_fw_dynamic_init_cpu(9)
• hl_fw_static_init_cpu(9)
• hl_fw_init_cpu(9)

mwah 💋 that's the whole page — source/version: ./drivers/accel/habanalabs/common, date: October 2026 🎀💖