Commit 89febd6a authored by Guodong Xu's avatar Guodong Xu Committed by Conor Dooley
Browse files

dt-bindings: riscv: Add Sha and its comprised extensions 



Add descriptions for the Sha extension and the seven extensions it
comprises: Shcounterenw, Shgatpa, Shtvala, Shvsatpa, Shvstvala, Shvstvecd,
and Ssstateen.

Sha is ratified in the RVA23 Profiles Version 1.0 (commit 0273f3c921b6
"rva23/rvb23 ratified") as a new profile-defined extension that captures
the full set of features that are mandated to be supported along with
the H extension.

Extensions Shcounterenw, Shgatpa, Shtvala, Shvsatpa, Shvstvala, Shvstvecd,
and Ssstateen are ratified in the RISC-V Profiles Version 1.0 (commit
b1d806605f87 "Updated to ratified state").

The requirement status for Sha and its comprised extension in RISC-V
Profiles are:
 - Sha: Mandatory in RVA23S64
 - H: Optional in RVA22S64; Mandatory in RVA23S64
 - Shcounterenw: Optional in RVA22S64; Mandatory in RVA23S64
 - Shgatpa: Optional in RVA22S64; Mandatory in RVA23S64
 - Shtvala: Optional in RVA22S64; Mandatory in RVA23S64
 - Shvsatpa: Optional in RVA22S64; Mandatory in RVA23S64
 - Shvstvala: Optional in RVA22S64; Mandatory in RVA23S64
 - Shvstvecd: Optional in RVA22S64; Mandatory in RVA23S64
 - Ssstateen: Optional in RVA22S64; Mandatory in RVA23S64

Signed-off-by: default avatarGuodong Xu <guodong@riscstar.com>
Acked-by: default avatarConor Dooley <conor.dooley@microchip.com>
Signed-off-by: default avatarConor Dooley <conor.dooley@microchip.com>
parent c7124133

Documentation/devicetree/bindings/riscv/extensions.yaml

+57 −0
Original line number Diff line number Diff line
@@ -129,6 +129,57 @@ properties: 
            Document Version 20211203.



        # multi-letter extensions, sorted alphanumerically

        - const: sha

          description: |

            The standard Sha extension for augmented hypervisor extension as

            ratified in RVA23 Profiles Version 1.0, with commit 0273f3c921b6

            ("rva23/rvb23 ratified").



            Sha captures the full set of features that are mandated to be

            supported along with the H extension. Sha comprises the following

            extensions: H, Shcounterenw, Shgatpa, Shtvala, Shvsatpa, Shvstvala,

            Shvstvecd, and Ssstateen.



        - const: shcounterenw

          description: |

            The standard Shcounterenw extension for support writable enables

            in hcounteren for any supported counter, as ratified in RISC-V

            Profiles Version 1.0, with commit b1d806605f87 ("Updated to

            ratified state.")



        - const: shgatpa

          description: |

            The standard Shgatpa extension indicates that for each supported

            virtual memory scheme SvNN supported in satp, the corresponding

            hgatp SvNNx4 mode must be supported. The hgatp mode Bare must

            also be supported. It is ratified in RISC-V Profiles Version 1.0,

            with commit b1d806605f87 ("Updated to ratified state.")



        - const: shtvala

          description: |

            The standard Shtvala extension for htval be written with the

            faulting guest physical address in all circumstances permitted by

            the ISA. It is ratified in RISC-V Profiles Version 1.0, with

            commit b1d806605f87 ("Updated to ratified state.")



        - const: shvsatpa

          description: |

            The standard Shvsatpa extension for vsatp supporting all translation

            modes supported in satp, as ratified in RISC-V Profiles Version 1.0,

            with commit b1d806605f87 ("Updated to ratified state.")



        - const: shvstvala

          description: |

            The standard Shvstvala extension for vstval provides all needed

            values as ratified in RISC-V Profiles Version 1.0, with commit

            b1d806605f87 ("Updated to ratified state.")



        - const: shvstvecd

          description: |

            The standard Shvstvecd extension for vstvec supporting Direct mode,

            as ratified in RISC-V Profiles Version 1.0, with commit b1d806605f87

            ("Updated to ratified state.")



        - const: smaia

          description: |

            The standard Smaia supervisor-level extension for the advanced
@@ -187,6 +238,12 @@ properties: 
            ratified at commit d70011dde6c2 ("Update to ratified state")

            of riscv-j-extension.



        - const: ssstateen

          description: |

            The standard Ssstateen extension for supervisor-mode view of the

            state-enable extension, as ratified in RISC-V Profiles Version 1.0,

            with commit b1d806605f87 ("Updated to ratified state.")



        - const: sstc

          description: |

            The standard Sstc supervisor-level extension for time compare as