drivers/gpu/drm/nouveau/nvkm/nvfw/hs.c
Source file repositories/reference/linux-study-clean/drivers/gpu/drm/nouveau/nvkm/nvfw/hs.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/gpu/drm/nouveau/nvkm/nvfw/hs.c- Extension
.c- Size
- 4256 bytes
- Lines
- 102
- Domain
- Driver Families
- Bucket
- drivers/gpu
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
core/subdev.hnvfw/hs.h
Detected Declarations
function filesfunction nvfw_hs_header_v2function nvfw_hs_load_headerfunction nvfw_hs_load_header_v2
Annotated Snippet
#include <core/subdev.h>
#include <nvfw/hs.h>
const struct nvfw_hs_header *
nvfw_hs_header(struct nvkm_subdev *subdev, const void *data)
{
const struct nvfw_hs_header *hdr = data;
nvkm_debug(subdev, "hsHeader:\n");
nvkm_debug(subdev, "\tsigDbgOffset : 0x%x\n", hdr->sig_dbg_offset);
nvkm_debug(subdev, "\tsigDbgSize : 0x%x\n", hdr->sig_dbg_size);
nvkm_debug(subdev, "\tsigProdOffset : 0x%x\n", hdr->sig_prod_offset);
nvkm_debug(subdev, "\tsigProdSize : 0x%x\n", hdr->sig_prod_size);
nvkm_debug(subdev, "\tpatchLoc : 0x%x\n", hdr->patch_loc);
nvkm_debug(subdev, "\tpatchSig : 0x%x\n", hdr->patch_sig);
nvkm_debug(subdev, "\thdrOffset : 0x%x\n", hdr->hdr_offset);
nvkm_debug(subdev, "\thdrSize : 0x%x\n", hdr->hdr_size);
return hdr;
}
const struct nvfw_hs_header_v2 *
nvfw_hs_header_v2(struct nvkm_subdev *subdev, const void *data)
{
const struct nvfw_hs_header_v2 *hdr = data;
nvkm_debug(subdev, "hsHeader:\n");
nvkm_debug(subdev, "\tsigProdOffset : 0x%x\n", hdr->sig_prod_offset);
nvkm_debug(subdev, "\tsigProdSize : 0x%x\n", hdr->sig_prod_size);
nvkm_debug(subdev, "\tpatchLoc : 0x%x\n", hdr->patch_loc);
nvkm_debug(subdev, "\tpatchSig : 0x%x\n", hdr->patch_sig);
nvkm_debug(subdev, "\tmetadataOffset : 0x%x\n", hdr->meta_data_offset);
nvkm_debug(subdev, "\tmetadataSize : 0x%x\n", hdr->meta_data_size);
nvkm_debug(subdev, "\tnumSig : 0x%x\n", hdr->num_sig);
nvkm_debug(subdev, "\theaderOffset : 0x%x\n", hdr->header_offset);
nvkm_debug(subdev, "\theaderSize : 0x%x\n", hdr->header_size);
return hdr;
}
const struct nvfw_hs_load_header *
nvfw_hs_load_header(struct nvkm_subdev *subdev, const void *data)
{
const struct nvfw_hs_load_header *hdr = data;
int i;
nvkm_debug(subdev, "hsLoadHeader:\n");
nvkm_debug(subdev, "\tnonSecCodeOff : 0x%x\n",
hdr->non_sec_code_off);
nvkm_debug(subdev, "\tnonSecCodeSize : 0x%x\n",
hdr->non_sec_code_size);
nvkm_debug(subdev, "\tdataDmaBase : 0x%x\n", hdr->data_dma_base);
nvkm_debug(subdev, "\tdataSize : 0x%x\n", hdr->data_size);
nvkm_debug(subdev, "\tnumApps : 0x%x\n", hdr->num_apps);
for (i = 0; i < hdr->num_apps; i++) {
nvkm_debug(subdev,
"\tApp[%d] : offset 0x%x size 0x%x\n", i,
hdr->apps[(i * 2) + 0], hdr->apps[(i * 2) + 1]);
}
return hdr;
}
const struct nvfw_hs_load_header_v2 *
nvfw_hs_load_header_v2(struct nvkm_subdev *subdev, const void *data)
{
const struct nvfw_hs_load_header_v2 *hdr = data;
int i;
nvkm_debug(subdev, "hsLoadHeader:\n");
nvkm_debug(subdev, "\tosCodeOffset : 0x%x\n", hdr->os_code_offset);
nvkm_debug(subdev, "\tosCodeSize : 0x%x\n", hdr->os_code_size);
nvkm_debug(subdev, "\tosDataOffset : 0x%x\n", hdr->os_data_offset);
nvkm_debug(subdev, "\tosDataSize : 0x%x\n", hdr->os_data_size);
nvkm_debug(subdev, "\tnumApps : 0x%x\n", hdr->num_apps);
for (i = 0; i < hdr->num_apps; i++) {
nvkm_debug(subdev,
"\tApp[%d] : offset 0x%x size 0x%x\n", i,
hdr->app[i].offset, hdr->app[i].size);
}
return hdr;
}
Annotation
- Immediate include surface: `core/subdev.h`, `nvfw/hs.h`.
- Detected declarations: `function files`, `function nvfw_hs_header_v2`, `function nvfw_hs_load_header`, `function nvfw_hs_load_header_v2`.
- Atlas domain: Driver Families / drivers/gpu.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.