Skip to content

Documentation for nova-core

Alexandre Courbot dri-devel linux-doc lkml nouveau rust-for-linux 2 versions – Applied

Status from this message: Applied to nova-next, thanks!

Get series with b4
b4 am [email protected] change-id 20250702-nova-docs-b9900d0505b5

Versions newest first

  1. v4 Latest8 patches 2 repliesApplied
  2. v37 patches 12 repliesSuperseded

Changes in v4 from the cover letter

- Convert /* comments into //.
- Fix missing slashes in doccomments and minor typos.
- Move some less-important paragraphs to notes in the RST files.
- Link to v3: https://lore.kernel.org/r/[email protected]

Patches in v4 Applied

#Subject and filesSizeRepliesApplied
1/8gpu: nova-core: Add code comments related to devinitdrivers/gpu/nova-core/gfw.rs drivers/gpu/nova-core/regs.rs+47 -60 replies
2/8gpu: nova-core: Clarify sysmembar operationsdrivers/gpu/nova-core/fb.rs drivers/gpu/nova-core/gpu.rs drivers/gpu/nova-core/regs.rs+14 -20 replies
3/8gpu: nova-core: Clarify falcon codedrivers/gpu/nova-core/falcon.rs+22 -70 replies
4/8gpu: nova-core: convert `/*` comments to `//`drivers/gpu/nova-core/regs.rs+9 -90 replies
5/8Documentation: gpu: nova-core: Document vbios layoutDocumentation/gpu/nova/core/vbios.rst Documentation/gpu/nova/index.rst+182 -00 replies
6/8Documentation: gpu: nova-core: Document devinit processDocumentation/gpu/nova/core/devinit.rst Documentation/gpu/nova/index.rst+62 -00 replies
7/8Documentation: gpu: nova-core: Document fwsec operation and layoutDocumentation/gpu/nova/core/fwsec.rst Documentation/gpu/nova/index.rst+182 -00 replies
8/8Documentation: gpu: nova-core: Document basics of the FalconDocumentation/gpu/nova/core/falcon.rst Documentation/gpu/nova/index.rst+159 -00 replies

Reviews trailers per patch

2 of 8 patches have a Reviewed-by or Acked-by.

PatchBagas Sanjaya
1/8
2/8
3/8
4/8
5/8
6/8R-b
7/8
8/8R-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v4 thread

Cover letter [PATCH v4 0/8] Documentation for nova-core

This series adds some documentation that was relevant to the FWSEC-FRTS
[1] series, but wasn't sent alongside it as it was worked on in parallel.

It notably introduces a lot of HTMLdocs that adds key explanations to understand and work on the GSP boot process.

[1] https://lore.kernel.org/all/[email protected]/

---
Changes in v4:
- Convert /* comments into //.
- Fix missing slashes in doccomments and minor typos.
- Move some less-important paragraphs to notes in the RST files.
- Link to v3: https://lore.kernel.org/r/[email protected]

Changes in v3:
- Rebase on top of latest nova-next.
- Reorganize patches a bit and use standard prefixes.
- Convert diagrams to only use ASCII characters (thanks Bagas!).
- Move sysmembar documentation to the new SysmemFlush type.
- Reword things a bit here and there.
- Reorganize order of index.rst for a more natural flow.
- Link to v2: https://lore.kernel.org/rust-for-linux/[email protected]/

---
Alexandre Courbot (1):
gpu: nova-core: convert /* comments to //

Joel Fernandes (7):
gpu: nova-core: Add code comments related to devinit
gpu: nova-core: Clarify sysmembar operations
gpu: nova-core: Clarify falcon code
Documentation: gpu: nova-core: Document vbios layout
Documentation: gpu: nova-core: Document devinit process
Documentation: gpu: nova-core: Document fwsec operation and layout
Documentation: gpu: nova-core: Document basics of the Falcon

 Documentation/gpu/nova/core/devinit.rst |  61 +++++++++++
 Documentation/gpu/nova/core/falcon.rst  | 158 ++++++++++++++++++++++++++++
 Documentation/gpu/nova/core/fwsec.rst   | 181 ++++++++++++++++++++++++++++++++
 Documentation/gpu/nova/core/vbios.rst   | 181 ++++++++++++++++++++++++++++++++
 Documentation/gpu/nova/index.rst        |   4 +
 drivers/gpu/nova-core/falcon.rs         |  29 +++--
 drivers/gpu/nova-core/fb.rs             |  10 ++
 drivers/gpu/nova-core/gfw.rs            |  39 ++++++-
 drivers/gpu/nova-core/gpu.rs            |   3 +-
 drivers/gpu/nova-core/regs.rs           |  35 ++++--
 10 files changed, 677 insertions(+), 24 deletions(-)

---
base-commit: 4092e1b41202ff39aad75a40a03ac1d318443670
change-id: 20250702-nova-docs-b9900d0505b5

Best regards,

Signature · 1 line
Alexandre Courbot <[email protected]>