Operands and parameters
SSR_ID- system-register identifier
SrcL- Reg5 source: R0..R23, T#1..T#4, or U#1..U#4
SSRSET writes the complete encoded system-register address.
PTO-SCALAR-SSRSETssrset SrcL, SSR_ID| Field | Bits | Signedness | Architectural role | Encoded zero |
|---|---|---|---|---|
SSR_ID | 12 | encoding-defined | system-register identifier | Encoded zero selects value zero of the system-register identifier. |
SrcL | 5 | encoding-defined | Reg5 source: R0..R23, T#1..T#4, or U#1..U#4 | Encoded zero names the architectural zero GPR. |
Loading WaveDrom diagram… The encoding table and WaveJSON remain available below.
| Decoded item | Bit range | Value |
|---|---|---|
| SSR_ID | 31:20 | variable |
| SrcL | 19:15 | variable |
| Constant | 14:0 | 15'b001000000111011 |
{
"reg": [
{
"bits": 15,
"name": "15'b001000000111011"
},
{
"bits": 5,
"name": "SrcL"
},
{
"bits": 12,
"name": "SSR_ID"
}
],
"config": {
"bits": 32,
"fontsize": 13,
"hspace": 900,
"lanes": 1,
"offset": 0
}
}ssrset SrcL, SSR_ID
SSR_IDSrcLThis Operation comes directly from the instruction owner; the page does not rewrite its behavior.
readonly func InstructionContractOperation_SSRSET() => ScalarOperationbegin return ScalarOperation_SSRSET;end;readonly func InstructionContractHandler_SSRSET() => ScalarSemanticHandlerbegin return ScalarHandler_ExecuteSystemRegisterSet;end;
pure func InstructionContractRequiresSystemBlock_SSRSET() => booleanbegin return TRUE;end;
pure func InstructionContractSystemTransferKind_SSRSET() => bits(2)begin return '01';end;
pure func InstructionContractSystemAddressWidth_SSRSET() => integer {5,12,24}begin return 12;end;
pure func InstructionContractPushesTemporaryT_SSRSET() => booleanbegin return FALSE;end;// PTO-INSTRUCTION: {"assembly":["ssrset SrcL, SSR_ID"],"block":[],"catalog_indices":[434],"catalog_records":[{"asm":"ssrset SrcL, SSR_ID","constraints":[],"encoding":[{"index":0,"mask":"0x00007fff","match":"0x0000103b","width_bits":32}],"encoding_kind":"L32","fields":[{"name":"SSR_ID","pieces":[{"instruction_lsb":20,"value_lsb":0,"width":12}],"signedness":"encoding-defined","width":12},{"name":"SrcL","pieces":[{"instruction_lsb":15,"value_lsb":0,"width":5}],"signedness":"encoding-defined","width":5}],"form_id":"ssrset_32_4dd3b71802c6","length_bits":32,"mnemonic":"SSRSET","semantic_family":"SYS","semantic_group":"SYS","semantic_handler":"ExecuteSystemRegisterSet","semantic_summary":"SSRSET writes the complete encoded system-register address.","status":"accepted"}],"classification":["sys"],"contract":{"block_composition":["SSRSET executes as one scalar operation in the body of an active SYS block."],"canonical_assembly":["ssrset SrcL, SSR_ID"],"defaults":["Every displayed operand is encoded explicitly. Encoded zero is an assigned value and never denotes omission."],"encoding_class":"standalone-encoded","examples":["ssrset SrcL, SSR_ID"],"exceptions":["Invalid block placement raises Illegal Block Exception before encoded-field legality or effects.","A reserved encoding or rejected access raises Illegal Instruction before destination, queue, system-state, or TPC effects."],"field_contracts":{},"field_zero_meanings":{"SSR_ID":"Encoded zero selects value zero of the system-register identifier.","SrcL":"Encoded zero names the architectural zero GPR."},"legality":["Every fixed bit and explicit field constraint is checked before operation semantics.","The complete encoded address is checked against its RO, WO, RW, unknown-address, and current-ACR access rules before effects."],"memory_effects":["none"],"operands":[{"field":"SSR_ID","role":"system-register identifier"},{"field":"SrcL","role":"Reg5 source: R0..R23, T#1..T#4, or U#1..U#4"}],"ordering":["Preflight the complete address, current-ACR permission, and writable access class before reading SrcL.","Snapshot SrcL, perform the register write, and then advance TPC."],"standalone_opcode":true,"state_effects":["Write the complete XLEN source to the selected writable system register.","A rejected write preserves the source and target register except for ordinary trap entry."]},"depends_on":["PTO-SCALAR-MODEL-SYS-REGISTERS"],"id":"PTO-SCALAR-SSRSET","mnemonic":"SSRSET","summary":"SSRSET writes the complete encoded system-register address.","surface":"scalar"}// PTO-REVIEW: {"review_method":"formal-definition-read","outcome":"FORMAL-COMPLETE","reviewed_fields":["assembly","encoding","defaults","operation","state","memory","ordering","faults","reserved"]}// NDF-BEGIN: PTO-SSRSET-ADR-CONTRACT-001// ndf: kind=contract level=L1 layer=scalar status=accepted// Decisions: ADR-0031.// SSRSET MUST enforce its mnemonic-owned system or maintenance access// domain before effects and MUST preserve destination, queue, and system state// on rejection except for the ordinary instruction-attempt trap envelope.// NDF-END: PTO-SSRSET-ADR-CONTRACT-001// DOC-BEGIN: decodereadonly func InstructionContractOperation_SSRSET() => ScalarOperationbegin return ScalarOperation_SSRSET;end;// DOC-END: decode// DOC-BEGIN: operationreadonly func InstructionContractHandler_SSRSET() => ScalarSemanticHandlerbegin return ScalarHandler_ExecuteSystemRegisterSet;end;
pure func InstructionContractRequiresSystemBlock_SSRSET() => booleanbegin return TRUE;end;
pure func InstructionContractSystemTransferKind_SSRSET() => bits(2)begin return '01';end;
pure func InstructionContractSystemAddressWidth_SSRSET() => integer {5,12,24}begin return 12;end;
pure func InstructionContractPushesTemporaryT_SSRSET() => booleanbegin return FALSE;end;// DOC-END: operation
SSRSET writes a complete XLEN value to an assigned writable system register.
The ASL DOC region selects ScalarHandler_ExecuteSystemRegisterSet. Placement and encoded legality are checked before sources or system state can change.
The instruction occupies one scalar operation position in the body of an active SYS block.
SSR_ID carries the system-register identifier; SrcL carries the Reg5 source: R0..R23, T#1..T#4, or U#1..U#4.
Encoded zero is an assigned field value, never an omitted operand.
After writable-access preflight, the complete XLEN source replaces the selected system register and then TPC advances.
A rejected write preserves both the source and target register beyond ordinary trap entry.
Address, current-ACR permission, and writable access class are checked before SrcL is read.
Invalid SYS-block placement is rejected before field checks. Reserved encodings or denied access produce no destination, queue, system-state, or TPC effect beyond the ordinary trap envelope.
This spelling example is illustrative; exact legality and effects remain in the generated contract below.
Start with ssrset SrcL, SSR_ID and trace its encoded fields through preflight before following the selected system effect.
Bodies come from owning ASL. Dragging or buttons change only this page-session view order.
Decisions: ADR-0031. SSRSET MUST enforce its mnemonic-owned system or maintenance access domain before effects and MUST preserve destination, queue, and system state on rejection except for the ordinary instruction-attempt trap envelope.
PTO-SSRSET-ADR-CONTRACT-001asl/scalar/sys/SSRSET.asla72f6c4ce6cf839d11b78ae5379920fdb7b7c3bab84d578d2da7a734fdf1a0e691d7b7638f31d6c3c8850a78d121b67a42695a1381480e8d6bf0b8f189a6529e18 matching entries
PTO-AVS-SCALAR-SSRSET-DECODE-001tests/asl/scalar/sys/SSRSET/scalar-decode-ssrset-canonical-001.asl2942133c5fc83b3eb24c81f6a3f7d4277ccb03b7f4a7f4da752ec28ac2d92021PTO-AVS-SYS-SSRSET-ACCESS-001tests/asl/scalar/sys/SSRSET/scalar-fault-ssrset-access-001.asl6f81276bf8ac282d9b1341a528b7a72d21f23e3e8eb7b885a53e1e0607459ed3PTO-AVS-SYS-SSRSET-EXEC-001tests/asl/scalar/sys/SSRSET/scalar-exec-ssrset-direct-001.asld7aa800fb6afe64572ebf7eff05882384e5369b192aadea1efd04fa2732fa53dPTO-AVS-SYS-SSRSET-PLACE-001tests/asl/scalar/sys/SSRSET/scalar-fault-ssrset-place-001.aslf89bbd15842f5ce3b77d2587082311c3e0094670f31ca1788e3906f54f05fad5PTO-AVS-SYS-SSRSET-RING-001tests/asl/scalar/sys/SSRSET/scalar-fault-ssrset-ring-001.aslab98d1277aefc80ad50fc31c4579fe6e4011fcb4f05638502adf50a285f40000PTO-AVS-SYS-SSRSET-TSRC-001tests/asl/scalar/sys/SSRSET/scalar-exec-ssrset-tsrc-001.asl83bbae534cb17128be5d3c274dc0a3caa7a5ccec6e9c2ebf6e2e521d3b4154b2PTO-AVS-SYS-SSRSET-UNKNOWN-001tests/asl/scalar/sys/SSRSET/scalar-fault-ssrset-unknown-001.asl19b70e90cc1e6b3e5dbcf368484ff07e631f91649ad298db9decf0933d916831PTO-AVS-SYS-SSRSET-USRC-001tests/asl/scalar/sys/SSRSET/scalar-exec-ssrset-usrc-001.asl25d617426d4d22d0e4486da090c470b7131256a705adcb085afa2ad245dc5c55PTO-EVIDENCE-RELEASE-TRACEABILITYPTO-EVIDENCE-RELEASE-TRACEABILITYspec/evidence/release-traceability-readiness.jsonc7327021d39dc67ac5564bc55073b3870a397d79ac8d9648284d56e33bc14a3ePTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSUREPTO-EVIDENCE-INSTRUCTION-CONTRACT-CLOSUREspec/evidence/instruction-contract-closure.json3ef2bb62421c79dff8fa77a1c7983923b523244b8090812883ef81286ca8106aPTO-EVIDENCE-ARCHITECTURE-READINESSPTO-EVIDENCE-ARCHITECTURE-READINESSspec/evidence/architecture-readiness.json4b0b85199101251bea744e0f3591cc31906909dc80d5ab651c417a936036a004PTO-EVIDENCE-RELEASE-GATE-READINESSPTO-EVIDENCE-RELEASE-GATE-READINESSspec/evidence/release-gate-readiness.jsona0f4d2b6920c08981ea55fd8ef820708a40d4feb5402c5150e8e9ab532d84ce0PTO-EVIDENCE-RELEASE-MANIFESTPTO-EVIDENCE-RELEASE-MANIFESTspec/release-manifest.json1a64c109ed7a90351c41e2a418b3c0ebaf8ad975838986d2101385186b85c0d8Loading ADR-0003…
ADR-0003docs/status/decisions/0003-pto-owned-system-register-names.mdc6a5379776c3b29c25f0896bc56f84d8f5c15832bbba0859b822aa99a65e342dLoading ADR-0018…
ADR-0018docs/status/decisions/0018-pto-v0-trap-disposition.mdce33454ffd2a595425ebece5954c9990ea2b9c4890008ad700599f767d7b9716Loading ADR-0031…
ADR-0031docs/status/decisions/0031-scalar-sys-totality-and-profile-boundaries.md5680b3516be6c28a1ccb198c99f5efb66317c65330f6d87434173024d2795a7dLoading ADR-0059…
ADR-0059docs/status/decisions/0059-mnemonic-field-encoding-closure.mdf18d13f735cfaf9f2803c754c5818f4af33d1cc42c489f0d9ce060b07bb3a196Loading ADR-0084…
ADR-0084docs/status/decisions/0084-scalar-system-and-queue-operations.mde068992fa81e2c4ac46e492391a2f784141d68e041bf0b9e0586c37217d1e08c{
"classification": [
"sys"
],
"documentation": "docs/scalar/sys/SSRSET.md",
"id": "PTO-SCALAR-SSRSET",
"instruction_contract": {
"artifact": "spec/evidence/instruction-contract-closure.json",
"mnemonic": "SSRSET",
"ndf_clause": "PTO-INST-SCALAR-SSRSET"
},
"mnemonic": "SSRSET",
"readiness_subjects": [
"ADR-0003",
"ADR-0018",
"ADR-0031",
"ADR-0059",
"ADR-0084"
],
"semantic_tests": [
"PTO-AVS-SYS-SSRSET-ACCESS-001",
"PTO-AVS-SYS-SSRSET-EXEC-001",
"PTO-AVS-SYS-SSRSET-PLACE-001",
"PTO-AVS-SYS-SSRSET-RING-001",
"PTO-AVS-SYS-SSRSET-TSRC-001",
"PTO-AVS-SYS-SSRSET-UNKNOWN-001",
"PTO-AVS-SYS-SSRSET-USRC-001"
],
"source": "asl/scalar/sys/SSRSET.asl",
"surface": "scalar",
"tests": [
"PTO-AVS-SCALAR-SSRSET-DECODE-001",
"PTO-AVS-SYS-SSRSET-ACCESS-001",
"PTO-AVS-SYS-SSRSET-EXEC-001",
"PTO-AVS-SYS-SSRSET-PLACE-001",
"PTO-AVS-SYS-SSRSET-RING-001",
"PTO-AVS-SYS-SSRSET-TSRC-001",
"PTO-AVS-SYS-SSRSET-UNKNOWN-001",
"PTO-AVS-SYS-SSRSET-USRC-001"
]
}0.58.5 · Release candidate7dc8b7e5b121d2b2499a2273bebff29e2cd86812a72f6c4ce6cf839d11b78ae5379920fdb7b7c3bab84d578d2da7a734fdf1a0e674a8662b6bd8a3750de3c3b3e211506899c0804396fded13398c85eb337374f9asl/scalar/sys/SSRSET.aslasl/scalar/sys/SSRSET.aslasl/scalar/sys/SSRSET.asl