[PATCH v2 6/7] docs: nova-core: Document basics of the Falcon

[Bagas Sanjaya]

On Sat, May 03, 2025 at 12:07:58AM -0400, Joel Fernandes wrote:
> +Conceptual diagram (not exact) of the Falcon and its memory subsystem is as follows:
> +
> +           External Memory (Framebuffer / System DRAM)
> +                            ▲  │
> +                            │  │
> +                            │  ▼
> +┏━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━┻━━━━━━━━━━━━━━━━━━━━━━┓
> +┃                           │                         ┃
> +┃   ┏━━━━━━━━━━━━━━━┓       │                         ┃
> +┃   ┃     FBIF      ┣━━━━━━━┛                         ┃  FALCON
> +┃   ┃ (FrameBuffer  ┃   Memory Interface              ┃  PROCESSOR
> +┃   ┃  InterFace)   ┃                                 ┃
> +┃   ┃  Apertures    ┃                                 ┃
> +┃   ┃  Configures   ┃                                 ┃
> +┃   ┃  mem access   ┃                                 ┃
> +┃   ┗━━━━━━━▲━━━━━━━┛                                 ┃
> +┃           │                                         ┃
> +┃           │ FBDMA uses configured FBIF apertures    ┃
> +┃           │ to access External Memory
> +┃           │
> +┃   ┏━━━━━━━▼━━━━━━━┓      ┏━━━━━━━━━━━━━━━━┓
> +┃   ┃    FBDMA      ┃  cfg ┃     RISC       ┃
> +┃   ┃ (FrameBuffer  ┣<────>┫     CORE       ┣─────>. Direct Core Access
> +┃   ┃  DMA Engine)  ┃      ┃                ┃      ┃
> +┃   ┃ - Master dev. ┃      ┃ (can run both  ┃      ┃
> +┃   ┗━━━━━━━▲━━━━━━━┛      ┃ Falcon and     ┃      ┃
> +┃           │        cfg-->┃ RISC-V code)   ┃      ┃
> +┃           │        /     ┃                ┃      ┃
> +┃           │        |     ┗━━━━━━━━━━━━━━━━┛      ┃    ┏━━━━━━━━━━━━┓
> +┃           │        │                             ┃    ┃   BROM     ┃
> +┃           │        │                             <───>┫ (Boot ROM) ┃
> +┃           │       /                              ┃    ┗━━━━━━━━━━━━┛
> +┃           │      ▼                               ┃
> +┃   ┏━━━━━━━━━━━━━━━┓                              ┃
> +┃   ┃    IO-PMP     ┃ Controls access by FBDMA     ┃
> +┃   ┃ (IO Physical  ┃ and other IO Masters         ┃
> +┃   ┃ Memory Protect)                              ┃
> +┃   ┗━━━━━━━▲━━━━━━━┛                              ┃
> +┃           │                                      ┃
> +┃           │ Protected Access Path for FBDMA      ┃
> +┃           ▼                                      ┃
> +┃   ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓      ┃
> +┃   ┃       Memory                          ┃      ┃
> +┃   ┃   ┏━━━━━━━━━━━━━━━┓  ┏━━━━━━━━━━━━━┓  ┃      ┃
> +┃   ┃   ┃    IMEM       ┃  ┃    DMEM     ┃  ┃<─────┛
> +┃   ┃   ┃ (Instruction  ┃  ┃   (Data     ┃  ┃
> +┃   ┃   ┃  Memory)      ┃  ┃   Memory)   ┃  ┃
> +┃   ┃   ┗━━━━━━━━━━━━━━━┛  ┗━━━━━━━━━━━━━┛  ┃
> +┃   ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
> +┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Wrap the diagram in literal code block. Also, note that it can look messy in
htmldocs output with certain fonts due to box drawing characters. Consider using
ASCII constructs (dashes and vertical bars) instead.

Thanks.

-- 
An old man doll... just what I always wanted! - Clara
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 228 bytes
Desc: not available
URL: <https://lists.freedesktop.org/archives/dri-devel/attachments/20250505/6014118a/attachment.sig>