1# SPDX-License-Identifier: (GPL-2.0 OR MIT) 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/riscv/extensions.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: RISC-V ISA extensions 8 9maintainers: 10 - Paul Walmsley <paul.walmsley@sifive.com> 11 - Palmer Dabbelt <palmer@sifive.com> 12 - Conor Dooley <conor@kernel.org> 13 14description: | 15 RISC-V has a large number of extensions, some of which are "standard" 16 extensions, meaning they are ratified by RISC-V International, and others 17 are "vendor" extensions. 18 This document defines properties that indicate whether a hart supports a 19 given extension. 20 21 Once a standard extension has been ratified, no changes in behaviour can be 22 made without the creation of a new extension. 23 The properties for standard extensions therefore map to their originally 24 ratified states, with the exception of the I, Zicntr & Zihpm extensions. 25 See the "i" property for more information. 26 27select: 28 properties: 29 compatible: 30 contains: 31 const: riscv 32 33properties: 34 riscv,isa: 35 description: 36 Identifies the specific RISC-V instruction set architecture 37 supported by the hart. These are documented in the RISC-V 38 User-Level ISA document, available from 39 https://riscv.org/specifications/ 40 41 Due to revisions of the ISA specification, some deviations 42 have arisen over time. 43 Notably, riscv,isa was defined prior to the creation of the 44 Zicntr, Zicsr, Zifencei and Zihpm extensions and thus "i" 45 implies "zicntr_zicsr_zifencei_zihpm". 46 47 While the isa strings in ISA specification are case 48 insensitive, letters in the riscv,isa string must be all 49 lowercase. 50 $ref: /schemas/types.yaml#/definitions/string 51 pattern: ^rv(?:64|32)imaf?d?q?c?b?k?j?p?v?h?(?:[hsxz](?:[0-9a-z])+)?(?:_[hsxz](?:[0-9a-z])+)*$ 52 deprecated: true 53 54 riscv,isa-base: 55 description: 56 The base ISA implemented by this hart, as described by the 20191213 57 version of the unprivileged ISA specification. 58 enum: 59 - rv32i 60 - rv64i 61 62 riscv,isa-extensions: 63 $ref: /schemas/types.yaml#/definitions/string-array 64 minItems: 1 65 description: Extensions supported by the hart. 66 items: 67 anyOf: 68 # single letter extensions, in canonical order 69 - const: i 70 description: | 71 The base integer instruction set, as ratified in the 20191213 72 version of the unprivileged ISA specification. 73 74 This does not include Chapter 10, "Counters", which was moved into 75 the Zicntr and Zihpm extensions after the ratification of the 76 20191213 version of the unprivileged specification. 77 78 - const: m 79 description: 80 The standard M extension for integer multiplication and division, as 81 ratified in the 20191213 version of the unprivileged ISA 82 specification. 83 84 - const: a 85 description: 86 The standard A extension for atomic instructions, as ratified in the 87 20191213 version of the unprivileged ISA specification. 88 89 - const: f 90 description: 91 The standard F extension for single-precision floating point, as 92 ratified in the 20191213 version of the unprivileged ISA 93 specification. 94 95 - const: d 96 description: 97 The standard D extension for double-precision floating-point, as 98 ratified in the 20191213 version of the unprivileged ISA 99 specification. 100 101 - const: q 102 description: 103 The standard Q extension for quad-precision floating-point, as 104 ratified in the 20191213 version of the unprivileged ISA 105 specification. 106 107 - const: c 108 description: 109 The standard C extension for compressed instructions, as ratified in 110 the 20191213 version of the unprivileged ISA specification. 111 112 - const: v 113 description: 114 The standard V extension for vector operations, as ratified 115 in-and-around commit 7a6c8ae ("Fix text that describes vfmv.v.f 116 encoding") of the riscv-v-spec. 117 118 - const: h 119 description: 120 The standard H extension for hypervisors as ratified in the 20191213 121 version of the privileged ISA specification. 122 123 # multi-letter extensions, sorted alphanumerically 124 - const: smaia 125 description: | 126 The standard Smaia supervisor-level extension for the advanced 127 interrupt architecture for machine-mode-visible csr and behavioural 128 changes to interrupts as frozen at commit ccbddab ("Merge pull 129 request #42 from riscv/jhauser-2023-RC4") of riscv-aia. 130 131 - const: smstateen 132 description: | 133 The standard Smstateen extension for controlling access to CSRs 134 added by other RISC-V extensions in H/S/VS/U/VU modes and as 135 ratified at commit a28bfae (Ratified (#7)) of riscv-state-enable. 136 137 - const: ssaia 138 description: | 139 The standard Ssaia supervisor-level extension for the advanced 140 interrupt architecture for supervisor-mode-visible csr and 141 behavioural changes to interrupts as frozen at commit ccbddab 142 ("Merge pull request #42 from riscv/jhauser-2023-RC4") of riscv-aia. 143 144 - const: sscofpmf 145 description: | 146 The standard Sscofpmf supervisor-level extension for count overflow 147 and mode-based filtering as ratified at commit 01d1df0 ("Add ability 148 to manually trigger workflow. (#2)") of riscv-count-overflow. 149 150 - const: sstc 151 description: | 152 The standard Sstc supervisor-level extension for time compare as 153 ratified at commit 3f9ed34 ("Add ability to manually trigger 154 workflow. (#2)") of riscv-time-compare. 155 156 - const: svinval 157 description: 158 The standard Svinval supervisor-level extension for fine-grained 159 address-translation cache invalidation as ratified in the 20191213 160 version of the privileged ISA specification. 161 162 - const: svnapot 163 description: 164 The standard Svnapot supervisor-level extensions for napot 165 translation contiguity as ratified in the 20191213 version of the 166 privileged ISA specification. 167 168 - const: svpbmt 169 description: 170 The standard Svpbmt supervisor-level extensions for page-based 171 memory types as ratified in the 20191213 version of the privileged 172 ISA specification. 173 174 - const: zacas 175 description: | 176 The Zacas extension for Atomic Compare-and-Swap (CAS) instructions 177 is supported as ratified at commit 5059e0ca641c ("update to 178 ratified") of the riscv-zacas. 179 180 - const: zba 181 description: | 182 The standard Zba bit-manipulation extension for address generation 183 acceleration instructions as ratified at commit 6d33919 ("Merge pull 184 request #158 from hirooih/clmul-fix-loop-end-condition") of 185 riscv-bitmanip. 186 187 - const: zbb 188 description: | 189 The standard Zbb bit-manipulation extension for basic bit-manipulation 190 as ratified at commit 6d33919 ("Merge pull request #158 from 191 hirooih/clmul-fix-loop-end-condition") of riscv-bitmanip. 192 193 - const: zbc 194 description: | 195 The standard Zbc bit-manipulation extension for carry-less 196 multiplication as ratified at commit 6d33919 ("Merge pull request 197 #158 from hirooih/clmul-fix-loop-end-condition") of riscv-bitmanip. 198 199 - const: zbkb 200 description: 201 The standard Zbkb bitmanip instructions for cryptography as ratified 202 in version 1.0 of RISC-V Cryptography Extensions Volume I 203 specification. 204 205 - const: zbkc 206 description: 207 The standard Zbkc carry-less multiply instructions as ratified 208 in version 1.0 of RISC-V Cryptography Extensions Volume I 209 specification. 210 211 - const: zbkx 212 description: 213 The standard Zbkx crossbar permutation instructions as ratified 214 in version 1.0 of RISC-V Cryptography Extensions Volume I 215 specification. 216 217 - const: zbs 218 description: | 219 The standard Zbs bit-manipulation extension for single-bit 220 instructions as ratified at commit 6d33919 ("Merge pull request #158 221 from hirooih/clmul-fix-loop-end-condition") of riscv-bitmanip. 222 223 - const: zfa 224 description: 225 The standard Zfa extension for additional floating point 226 instructions, as ratified in commit 056b6ff ("Zfa is ratified") of 227 riscv-isa-manual. 228 229 - const: zfh 230 description: 231 The standard Zfh extension for 16-bit half-precision binary 232 floating-point instructions, as ratified in commit 64074bc ("Update 233 version numbers for Zfh/Zfinx") of riscv-isa-manual. 234 235 - const: zfhmin 236 description: 237 The standard Zfhmin extension which provides minimal support for 238 16-bit half-precision binary floating-point instructions, as ratified 239 in commit 64074bc ("Update version numbers for Zfh/Zfinx") of 240 riscv-isa-manual. 241 242 - const: zk 243 description: 244 The standard Zk Standard Scalar cryptography extension as ratified 245 in version 1.0 of RISC-V Cryptography Extensions Volume I 246 specification. 247 248 - const: zkn 249 description: 250 The standard Zkn NIST algorithm suite extensions as ratified in 251 version 1.0 of RISC-V Cryptography Extensions Volume I 252 specification. 253 254 - const: zknd 255 description: | 256 The standard Zknd for NIST suite: AES decryption instructions as 257 ratified in version 1.0 of RISC-V Cryptography Extensions Volume I 258 specification. 259 260 - const: zkne 261 description: | 262 The standard Zkne for NIST suite: AES encryption instructions as 263 ratified in version 1.0 of RISC-V Cryptography Extensions Volume I 264 specification. 265 266 - const: zknh 267 description: | 268 The standard Zknh for NIST suite: hash function instructions as 269 ratified in version 1.0 of RISC-V Cryptography Extensions Volume I 270 specification. 271 272 - const: zkr 273 description: 274 The standard Zkr entropy source extension as ratified in version 275 1.0 of RISC-V Cryptography Extensions Volume I specification. 276 This string being present means that the CSR associated to this 277 extension is accessible at the privilege level to which that 278 device-tree has been provided. 279 280 - const: zks 281 description: 282 The standard Zks ShangMi algorithm suite extensions as ratified in 283 version 1.0 of RISC-V Cryptography Extensions Volume I 284 specification. 285 286 - const: zksed 287 description: | 288 The standard Zksed for ShangMi suite: SM4 block cipher instructions 289 as ratified in version 1.0 of RISC-V Cryptography Extensions 290 Volume I specification. 291 292 - const: zksh 293 description: | 294 The standard Zksh for ShangMi suite: SM3 hash function instructions 295 as ratified in version 1.0 of RISC-V Cryptography Extensions 296 Volume I specification. 297 298 - const: zkt 299 description: 300 The standard Zkt for data independent execution latency as ratified 301 in version 1.0 of RISC-V Cryptography Extensions Volume I 302 specification. 303 304 - const: zicbom 305 description: 306 The standard Zicbom extension for base cache management operations as 307 ratified in commit 3dd606f ("Create cmobase-v1.0.pdf") of riscv-CMOs. 308 309 - const: zicbop 310 description: 311 The standard Zicbop extension for cache-block prefetch instructions 312 as ratified in commit 3dd606f ("Create cmobase-v1.0.pdf") of 313 riscv-CMOs. 314 315 - const: zicboz 316 description: 317 The standard Zicboz extension for cache-block zeroing as ratified 318 in commit 3dd606f ("Create cmobase-v1.0.pdf") of riscv-CMOs. 319 320 - const: zicntr 321 description: 322 The standard Zicntr extension for base counters and timers, as 323 ratified in the 20191213 version of the unprivileged ISA 324 specification. 325 326 - const: zicond 327 description: 328 The standard Zicond extension for conditional arithmetic and 329 conditional-select/move operations as ratified in commit 95cf1f9 330 ("Add changes requested by Ved during signoff") of riscv-zicond. 331 332 - const: zicsr 333 description: | 334 The standard Zicsr extension for control and status register 335 instructions, as ratified in the 20191213 version of the 336 unprivileged ISA specification. 337 338 This does not include Chapter 10, "Counters", which documents 339 special case read-only CSRs, that were moved into the Zicntr and 340 Zihpm extensions after the ratification of the 20191213 version of 341 the unprivileged specification. 342 343 - const: zifencei 344 description: 345 The standard Zifencei extension for instruction-fetch fence, as 346 ratified in the 20191213 version of the unprivileged ISA 347 specification. 348 349 - const: zihintpause 350 description: 351 The standard Zihintpause extension for pause hints, as ratified in 352 commit d8ab5c7 ("Zihintpause is ratified") of the riscv-isa-manual. 353 354 - const: zihintntl 355 description: 356 The standard Zihintntl extension for non-temporal locality hints, as 357 ratified in commit 0dc91f5 ("Zihintntl is ratified") of the 358 riscv-isa-manual. 359 360 - const: zihpm 361 description: 362 The standard Zihpm extension for hardware performance counters, as 363 ratified in the 20191213 version of the unprivileged ISA 364 specification. 365 366 - const: zimop 367 description: 368 The standard Zimop extension version 1.0, as ratified in commit 369 58220614a5f ("Zimop is ratified/1.0") of the riscv-isa-manual. 370 371 - const: ztso 372 description: 373 The standard Ztso extension for total store ordering, as ratified 374 in commit 2e5236 ("Ztso is now ratified.") of the 375 riscv-isa-manual. 376 377 - const: zvbb 378 description: 379 The standard Zvbb extension for vectored basic bit-manipulation 380 instructions, as ratified in commit 56ed795 ("Update 381 riscv-crypto-spec-vector.adoc") of riscv-crypto. 382 383 - const: zvbc 384 description: 385 The standard Zvbc extension for vectored carryless multiplication 386 instructions, as ratified in commit 56ed795 ("Update 387 riscv-crypto-spec-vector.adoc") of riscv-crypto. 388 389 - const: zve32f 390 description: 391 The standard Zve32f extension for embedded processors, as ratified 392 in commit 6f702a2 ("Vector extensions are now ratified") of 393 riscv-v-spec. 394 395 - const: zve32x 396 description: 397 The standard Zve32x extension for embedded processors, as ratified 398 in commit 6f702a2 ("Vector extensions are now ratified") of 399 riscv-v-spec. 400 401 - const: zve64d 402 description: 403 The standard Zve64d extension for embedded processors, as ratified 404 in commit 6f702a2 ("Vector extensions are now ratified") of 405 riscv-v-spec. 406 407 - const: zve64f 408 description: 409 The standard Zve64f extension for embedded processors, as ratified 410 in commit 6f702a2 ("Vector extensions are now ratified") of 411 riscv-v-spec. 412 413 - const: zve64x 414 description: 415 The standard Zve64x extension for embedded processors, as ratified 416 in commit 6f702a2 ("Vector extensions are now ratified") of 417 riscv-v-spec. 418 419 - const: zvfh 420 description: 421 The standard Zvfh extension for vectored half-precision 422 floating-point instructions, as ratified in commit e2ccd05 423 ("Remove draft warnings from Zvfh[min]") of riscv-v-spec. 424 425 - const: zvfhmin 426 description: 427 The standard Zvfhmin extension for vectored minimal half-precision 428 floating-point instructions, as ratified in commit e2ccd05 429 ("Remove draft warnings from Zvfh[min]") of riscv-v-spec. 430 431 - const: zvkb 432 description: 433 The standard Zvkb extension for vector cryptography bit-manipulation 434 instructions, as ratified in commit 56ed795 ("Update 435 riscv-crypto-spec-vector.adoc") of riscv-crypto. 436 437 - const: zvkg 438 description: 439 The standard Zvkg extension for vector GCM/GMAC instructions, as 440 ratified in commit 56ed795 ("Update riscv-crypto-spec-vector.adoc") 441 of riscv-crypto. 442 443 - const: zvkn 444 description: 445 The standard Zvkn extension for NIST algorithm suite instructions, as 446 ratified in commit 56ed795 ("Update riscv-crypto-spec-vector.adoc") 447 of riscv-crypto. 448 449 - const: zvknc 450 description: 451 The standard Zvknc extension for NIST algorithm suite with carryless 452 multiply instructions, as ratified in commit 56ed795 ("Update 453 riscv-crypto-spec-vector.adoc") of riscv-crypto. 454 455 - const: zvkned 456 description: 457 The standard Zvkned extension for Vector AES block cipher 458 instructions, as ratified in commit 56ed795 ("Update 459 riscv-crypto-spec-vector.adoc") of riscv-crypto. 460 461 - const: zvkng 462 description: 463 The standard Zvkng extension for NIST algorithm suite with GCM 464 instructions, as ratified in commit 56ed795 ("Update 465 riscv-crypto-spec-vector.adoc") of riscv-crypto. 466 467 - const: zvknha 468 description: | 469 The standard Zvknha extension for NIST suite: vector SHA-2 secure, 470 hash (SHA-256 only) instructions, as ratified in commit 471 56ed795 ("Update riscv-crypto-spec-vector.adoc") of riscv-crypto. 472 473 - const: zvknhb 474 description: | 475 The standard Zvknhb extension for NIST suite: vector SHA-2 secure, 476 hash (SHA-256 and SHA-512) instructions, as ratified in commit 477 56ed795 ("Update riscv-crypto-spec-vector.adoc") of riscv-crypto. 478 479 - const: zvks 480 description: 481 The standard Zvks extension for ShangMi algorithm suite 482 instructions, as ratified in commit 56ed795 ("Update 483 riscv-crypto-spec-vector.adoc") of riscv-crypto. 484 485 - const: zvksc 486 description: 487 The standard Zvksc extension for ShangMi algorithm suite with 488 carryless multiplication instructions, as ratified in commit 56ed795 489 ("Update riscv-crypto-spec-vector.adoc") of riscv-crypto. 490 491 - const: zvksed 492 description: | 493 The standard Zvksed extension for ShangMi suite: SM4 block cipher 494 instructions, as ratified in commit 56ed795 ("Update 495 riscv-crypto-spec-vector.adoc") of riscv-crypto. 496 497 - const: zvksh 498 description: | 499 The standard Zvksh extension for ShangMi suite: SM3 secure hash 500 instructions, as ratified in commit 56ed795 ("Update 501 riscv-crypto-spec-vector.adoc") of riscv-crypto. 502 503 - const: zvksg 504 description: 505 The standard Zvksg extension for ShangMi algorithm suite with GCM 506 instructions, as ratified in commit 56ed795 ("Update 507 riscv-crypto-spec-vector.adoc") of riscv-crypto. 508 509 - const: zvkt 510 description: 511 The standard Zvkt extension for vector data-independent execution 512 latency, as ratified in commit 56ed795 ("Update 513 riscv-crypto-spec-vector.adoc") of riscv-crypto. 514 515 - const: xandespmu 516 description: 517 The Andes Technology performance monitor extension for counter overflow 518 and privilege mode filtering. For more details, see Counter Related 519 Registers in the AX45MP datasheet. 520 https://www.andestech.com/wp-content/uploads/AX45MP-1C-Rev.-5.0.0-Datasheet.pdf 521 522additionalProperties: true 523... 524