[PATCH v3 0/7] Documentation for nova-core

[Joel Fernandes]

On 7/2/2025 7:00 AM, Alexandre Courbot wrote:
> 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/DB0I8WAH970B.25D3S59AYF85P@nvidia.com/
> 
> Signed-off-by: Joel Fernandes <joelagnelf at nvidia.com>
> Signed-off-by: Alexandre Courbot <acourbot at nvidia.com>

Thanks a lot Alex!!!

 - Joel


> ---
> 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/20250503040802.1411285-1-joelagnelf@nvidia.com/
> 
> ---
> 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   | 182 ++++++++++++++++++++++++++++++++
>  Documentation/gpu/nova/core/vbios.rst   | 180 +++++++++++++++++++++++++++++++
>  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           |  18 +++-
>  10 files changed, 669 insertions(+), 15 deletions(-)
> ---
> base-commit: 4092e1b41202ff39aad75a40a03ac1d318443670
> change-id: 20250702-nova-docs-b9900d0505b5
> 
> Best regards,