ADDTPC

1// PTO-INSTRUCTION: {"assembly":["addtpc simm, ->{t, u, Rd}"],"block":[],"catalog_indices":[5],"catalog_records":[{"asm":"addtpc simm, ->{t, u, Rd}","constraints":[{"field":"RegDst","operator":"not-equal","value":10}],"encoding":[{"index":0,"mask":"0x0000007f","match":"0x00000007","width_bits":32}],"encoding_kind":"L32","fields":[{"name":"RegDst","pieces":[{"instruction_lsb":7,"value_lsb":0,"width":5}],"signedness":"encoding-defined","width":5},{"name":"imm20","pieces":[{"instruction_lsb":12,"value_lsb":0,"width":20}],"signedness":"encoding-defined","width":20}],"form_id":"addtpc_32_e5aa0f0abca3","length_bits":32,"mnemonic":"ADDTPC","semantic_family":"BRU","semantic_group":"BRU","semantic_handler":"AddToPC","semantic_summary":"ADDTPC - Add a signed 4 KiB page displacement to the current TPC.","status":"accepted"}],"classification":["bru"],"contract":{"block_composition":["none"],"canonical_assembly":["addtpc simm, ->{t, u, Rd}"],"defaults":["The imm20 field is sign-extended and scaled by 4096 bytes; encoded zero contributes a zero page displacement and produces the current instruction TPC.","The selected assembly form determines which fields are present; every present field carries its encoded value and no encoded zero means omission."],"encoding_class":"standalone-encoded","examples":["addtpc simm, ->{t, u, Rd}"],"exceptions":["Reserved field encodings raise Fault_IllegalInstruction before effects; handler-specific arithmetic, memory, control-flow, system-register, and privilege faults follow the embedded normative ASL operation."],"field_contracts":{},"field_zero_meanings":{"RegDst":"Encoded zero names the architectural zero GPR.","imm20":"Encoded zero contributes a zero page displacement and produces the current instruction TPC."},"legality":["addtpc_32_e5aa0f0abca3.RegDst excludes 10; the excluded encoding is reserved."],"memory_effects":["none"],"operands":[{"field":"RegDst","role":"absolute GPR destination"},{"field":"imm20","role":"signed 20-bit 4 KiB page displacement"}],"ordering":["Read the current instruction TPC before computing the wrapping XLEN result.","After the destination effect, the scalar dispatch boundary advances TPC by four bytes."],"standalone_opcode":true,"state_effects":["ADDTPC writes TPC + (SignExtend(imm20) << 12), wrapping at XLEN, through the selected Reg5 destination.","The instruction does not install a control-flow target and does not directly modify TPC."]},"depends_on":["PTO-BLOCK-MODEL-SCHEMA-PROFILE-ENCODING"],"id":"PTO-SCALAR-ADDTPC","mnemonic":"ADDTPC","summary":"ADDTPC - Add a signed 4 KiB page displacement to the current TPC.","surface":"scalar"}2// PTO-REVIEW: {"review_method":"formal-definition-read","outcome":"FORMAL-COMPLETE","reviewed_fields":["assembly","encoding","defaults","operation","state","memory","ordering","faults","reserved"]}3// NDF-BEGIN: PTO-ADDTPC-PAGE-0014// ndf: kind=contract level=L1 layer=scalar status=accepted5// ADDTPC MUST add SignExtend(imm20) shifted left by twelve to the current6// instruction TPC, MUST wrap at XLEN, and MUST write only through the selected7// Reg5 destination. It MUST NOT install a control-flow target or directly8// advance TPC. Encoded immediate zero MUST produce the current TPC.9// NDF-END: PTO-ADDTPC-PAGE-00110// DOC-BEGIN: decode11readonly func InstructionContractOperation_ADDTPC() => ScalarOperation12begin13    return ScalarOperation_ADDTPC;14end;15// DOC-END: decode16// DOC-BEGIN: operation17readonly func InstructionContractHandler_ADDTPC() => ScalarSemanticHandler18begin19    return ScalarHandler_AddToPC;20end;21
22pure func InstructionContractUsesTPC_ADDTPC()23    => boolean24begin25    return TRUE;26end;27
28pure func InstructionContractImmediateWidth_ADDTPC()29    => integer {20}30begin31    return 20;32end;33
34pure func InstructionContractImmediateIsSigned_ADDTPC()35    => boolean36begin37    return TRUE;38end;39
40pure func InstructionContractPageShift_ADDTPC()41    => integer {12}42begin43    return 12;44end;45
46pure func InstructionContractWritesTPC_ADDTPC()47    => boolean48begin49    return FALSE;50end;51
52pure func InstructionContractTarget_ADDTPC(53    base: Word,54    page_offset: Word)55    => Word56begin57    return base + LSL(page_offset, 12);58end;59// DOC-END: operation60