|
qualcomm/qbox
|
Reference: ARM DDI 0517 (CoreLink MMU-500 TRM), ARM IHI 0062 (SMMUv2 Architecture Specification)
This model implements a functional subset of the ARM MMU-500 sufficient for AArch64 LPAE page table walks (stage 1, stage 2, and nested stage 1+2), stream matching, TLB invalidation via DMI, and global address translation services. Only registers with associated behavioral logic are explicitly declared in the model; all other registers in the SMMU address space (identification, debug, performance monitors, etc.) are accessible as memory via the reg_model_maker ZIP configuration.
| Area | Status | Notes |
|---|---|---|
| Global config (SCR0, NSCR0, SCR1, SACR) | Functional | SCR0 and NSCR0 independently control secure and non-secure request handling. SACR is banked, and NSACR selects its non-secure bank. |
| Configuration access security | Functional | Normal and debug accesses share a bank resolver. Non-secure accesses to defined NS global aliases are supported for firmware compatibility. SCR1.GASRAE blocks non-secure global accesses, including aliases. Register DMI is disabled. |
| Identification (IDR0-2, IDR7) | Functional | IDR0.NUMSMRG, IDR0.ATOSNS, IDR1.NUMCB, IDR1.NUMPAGENDXB, IDR7 set from CCI params at start_of_simulation |
| Stream Match (SMR[n]) | Functional | VALID/MASK/ID fields used by smmu500_stream_id_match() |
| Stream-to-Context (S2CR[n]) | Functional | CBNDX and TYPE are used; translation, bypass, and fault actions are supported |
| Context Bank Attribute (CBAR[n]) | Functional | TYPE (bits [17:16]) drives stage selection; CBNDX for S2 CB (bits [15:8]) |
| Context Bank Attribute 2 (CBA2R[n]) | Functional | VA64 (bit 0) checked during page table walk |
| Global fault status (SGFSR, NSGFSR) | Functional | ICF/USF/SMCF are banked by request security state, clear on write-1-to-clear, and drive irq_global when the corresponding GFIE is set |
| GATS (privileged and unprivileged stage 1/stage 1+2 variants, GPAR) | Functional | Post-write on the _H register triggers translation; result in GPAR; invalid context-bank indices report an error and set SGFSR.ICF |
| Per-CB TLB invalidation (TLBIALL, TLBIASID, VA/IPA variants, TLBSYNC, TLBSTATUS) | Functional | TLBI writes trigger conservative DMI invalidation across all TBUs for the addressed CB; TLBSYNC completes synchronously and TLBSTATUS reads idle |
| Global TLB invalidation | Functional | Global invalidate commands trigger conservative DMI invalidation across all TBUs; VMID-targeted commands invalidate CBs whose CBAR.VMID matches |
| TBU_PWR_STATUS | Stored | Populated from p_num_tbu |
The remaining global fault and address-translation status registers preserve their secure and non-secure banks but have no additional behavioral logic. Other unmodelled address-space registers retain the reg_model_maker default behavior.
| Register | Status | Notes |
|---|---|---|
| CB_SCTLR | Functional | Bit 0 (M) enables translation; bit 6 (CFIE) used for IRQ |
| CB_ACTLR | Stored | |
| CB_RESUME | Stored | No stall/resume logic |
| CB_TCR2 | Functional | Upper 32 bits of 64-bit TCR for stage 1 |
| CB_TTBR0 (LOW/HIGH) | Functional | Base address for page table walk |
| CB_TTBR1 (LOW/HIGH) | Functional | Used for VA[63]=1 (upper address range) |
| CB_TCR_LPAE | Functional | T0SZ, T1SZ, TG0, TG1, EPD0, EPD1, SL0, PS fields all used |
| CB_CONTEXTIDR | Stored | |
| CB_PRRR_MAIR0 | Stored | Memory attribute registers present but not used in translation |
| CB_NMRR_MAIR1 | Stored | |
| CB_FSR | Functional | TF/AFF/PF/EF/ASF classification, MULTI latching, W1C, and context IRQ |
| CB_FSRRESTORE | Stored | Exists at correct offset |
| CB_FAR (LOW/HIGH) | Functional | Written on stage 2 faults |
| CB_FSYNR0 | Functional | PLVL, WNR, PNU, IND, NSATTR, ATOF, PTWF, AFR, and S1CBNDX are recorded for the first fault |
| CB_FSYNR1 | Functional | MID/PID/BID are recorded from the optional TLM transaction-attributes extension |
| CB_IPAFAR (LOW/HIGH) | Functional | Written with faulting VA/IPA on faults |
| CB_TLBIVA/TLBIVAA/TLBIVAL/TLBIVAAL | Functional | Post-write conservatively invalidates all DMI views for the addressed CB |
| CB_TLBIIPAS2/TLBIIPAS2L | Functional | Post-write conservatively invalidates all DMI views for the addressed CB |
| CB_TLBIASID | Functional | Post-write invalidates DMI views for the addressed CB; the model has no ASID-tagged TLB cache |
| CB_TLBIALL | Functional | Post-write triggers DMI invalidation for the CB |
| CB_TLBSYNC | Functional | Completion is synchronous |
| CB_TLBSTATUS | Functional | Always reads 0 (no pending operations) |
| Feature | Status | Notes |
|---|---|---|
| AArch64 Stage 1 LPAE walk | Implemented | 4KB, 16KB, 64KB granule sizes supported |
| AArch64 Stage 2 walk | Implemented | SL0 starting level, separate PS field extraction, and concatenated root-table selection |
| Nested S1+S2 translation | Implemented | S1 descriptor addresses translated through S2 as read accesses; nested stage-1 faults stop before final stage-2 translation; S2 faults during S1 walks are reported as PTWF |
| TTBR0/TTBR1 split (VA[63]) | Implemented | Upper/lower VA range with separate TG, TSZ |
| EPD (Translation Disable) | Implemented | EPD0 checked; faults if set |
| Block translations | Implemented | Block entries at correct levels per granule |
| Table attribute accumulation | Implemented | Bits [63:59] of table descriptors accumulated |
| Address size checks | Implemented | Translation-table addresses are checked against PAMAX; completed output addresses are checked against the selected PS/output size |
| Access permission (AP) | Implemented | S1: AP[1] privileged-only check and AP[2] read-only check; S2: HAP S2AP checking |
| Access flag (AF) check | Implemented | Bit 10 of descriptor checked; fault if not set |
| DMA-based descriptor reads | Implemented | Page table descriptors read via dma_socket b_transport |
| CBAR.TYPE stage selection | Implemented | All four types (S2-only, S1+fault, S1-only, S1+S2) |
| Feature | Status | Notes |
|---|---|---|
| Multiple TBUs per TCU | Implemented | Vector of TBU pointers; configurable via p_num_tbu |
| TBU b_transport forwarding | Implemented | Translates address, forwards to downstream_socket |
| TBU transport_dbg | Implemented | Debug transport with address translation |
| TBU DMI (get_direct_mem_ptr) | Implemented | Full DMI support with page-aligned virtual-to-physical mapping; QEMU IOMMU indexes keep Secure and Non-secure direct mappings separate |
| DMI invalidation on TLBI and global controls | Implemented | TLBIALL/TLBIASID and SCR0/NSCR0 writes trigger upstream DMI invalidation |
| Per-CB DMI range tracking | Implemented | dmi_range[] tracks valid ranges per context bank |
| Thread-safe DMI locking | Implemented | Mutex-based locking; THREAD_SAFE_REENTRANT compile-time option |
| Topology ID (stream ID) | Implemented | CCI param per TBU; used for stream matching |
| Feature | Status | Notes |
|---|---|---|
| Per-CB context fault IRQ | Implemented | irq_context[cb] is asserted while any CB_FSR fault bit is set and SCTLR.CFIE is enabled; it is recomputed on fault-status, CFIE, and reset changes |
| Global fault IRQ | Implemented | Asserted while either security bank has ICF, USF, or SMCF set and its corresponding GFIE is enabled |
| Feature | Status | Notes |
|---|---|---|
| Register reset via signal | Implemented | reset first invalidates every tracked TBU DMI range, then triggers M.reset() under the translation lock, restores register defaults, and deasserts IRQ outputs |
The repository includes a dedicated SMMU500 unit test bench under tests/components/smmu500. The tests cover stream matching, S2CR bypass/fault handling, global and context fault status, W1C behavior, GATS operations, stage-1 and stage-2 translations, nested translation, fault syndrome recording, TBU read/write/debug forwarding, DMI range handling, and TLBI-triggered DMI invalidation.
The model implements ICF, USF, and SMCF for stream-mapping transactions. ICF is reported and rejects the transaction when a matched S2CR selects TYPE=0b10 (Fault), TYPE is reserved, or the selected CBNDX is outside the implemented context-bank range. Secure transactions record SGFSR status and non-secure transactions record NSGFSR status. irq_global is asserted when either bank has a pending fault with its corresponding GFIE enabled. Both status banks are write-1-to-clear. GATS requests with a context-bank index outside p_num_cb also report ICF and return GPAR.F = 1.
Configuration-access faults (SGFSR.CAF) and their SCR0.GCFGFRE/GCFGFIE reporting paths remain unsupported because the generic register target does not currently expose security/access metadata needed to identify disallowed configuration accesses.
The S2CR.TYPE field (bits [17:16]) is checked:
SGFSR and NSGFSR ICF, USF, and SMCF implement independent write-1-to-clear behavior. CB_FSR fault status bits also implement write-1-to-clear semantics; clearing the last fault deasserts the context IRQ. The FSRRESTORE companion registers have no special relationship to FSR.
Read-only and write-only register access semantics are partially enforced. IDR0/1/2/7 are restored from model configuration after writes, and implemented TLBI command registers are cleared after writes. The remaining register set does not generally enforce architectural RO/WO access policy.
The model classifies synchronous translation failures into the context-bank FSR status bits:
For the first fault, CB_FSYNR0 records the walk level, write/read direction, privileged/unprivileged state, instruction/data state, security state, address-translation-operation state, page-table-walk-fault state, asynchronous recording state, and stage-1 context-bank index. Nested stage-2 faults that occur while fetching stage-1 descriptors are reported to the stage-1 context as page-table-walk faults, with IPAFAR set to the descriptor IPA. CB_FSYNR1 records MID/PID/BID when the smmu500_transaction_attrs_extension is attached; otherwise those fields default to zero. The first fault's FAR/IPAFAR and syndrome are preserved when MULTI is set.
Field-specific gs::QemuMemTx*TlmExtension types carry QEMU MemTxAttrs fields for QEMU-to-QBox transactions. The SMMU consumes only the gs::QemuMemTxSecureTlmExtension security-state field; all other QEMU attributes do not affect SMMU translation or fault reporting. QemuInitiatorSocket attaches it for QEMU memory accesses. The optional gs::smmu500_transaction_attrs_extension carries the remaining request attributes: privilege level, instruction/data access, address translation operation, asynchronous state, and MID/PID/BID syndrome fields. When both are present, the QEMU transaction-attributes extension is authoritative for security state. The implemented GATS registers are secure-bank operations, so their page-table walks and context-fault syndrome use the secure state; GATS1P*/GATS1U* select the privilege state.
When an ordinary TLM transaction has no such extension, the model defaults to a privileged, non-secure data access. This is a compatibility policy: it does not prove that the originating requester was privileged, and therefore cannot report an unprivileged-access permission fault for an unannotated transaction. Translation, access-flag, read/write permission, external-walk, and address-size faults remain independently checked.
The CPU or interconnect bridge is responsible for attaching request attributes at the TBU ingress. For AXI-like request attributes, the intended mapping is:
Security-tagged register accesses are checked at the SMMU register socket. Banked GR0 primary addresses select the caller's security bank; defined aliases in 0x400..0x7ff select the same non-secure bank from either security state. Non-secure alias access is supported for firmware compatibility, including QNX polling NSTLBGSTATUS at 0x474. Non-secure access is also limited by SCR1.NSNUMSMRGO, SCR1.NSNUMCBO, SCR1.GASRAE, and its stage-2 context banks when restricted access is enabled. An unannotated TLM request retains legacy unrestricted compatibility behavior. Register DMI is disabled so cached host pointers cannot bypass bank selection or register-write side effects.
CB_TLBIVA, CB_TLBIVAA, CB_TLBIVAL, CB_TLBIVAAL, CB_TLBIIPAS2, and CB_TLBIIPAS2L are implemented as conservative per-CB DMI invalidations. The model does not maintain a VA/IPA-tagged TLB, so these commands invalidate all tracked DMI for the addressed context bank rather than a precise VA/IPA entry.
Global TLB invalidation operations (STLBIALL, TLBIVMID, TLBIALLNSNH, TLBIALLH, TLBIVMIDS1, and 64-bit VA variants) are implemented as conservative DMI invalidations. The model does not maintain architectural TLB entries, so address-specific commands invalidate broader DMI state than hardware would.
All eight GATS operations are implemented as translation requests:
The model uses the operation variant to select privileged versus unprivileged permission checks and read versus write permission checks. The result is written to GPAR/GPAR_H. Invalid context-bank indices return GPAR.F = 1 and set SGFSR.ICF.
Only the AArch64 LPAE (Long Descriptor) page table format is implemented. The AArch32 Short-Descriptor format (used when CBA2R.VA64=0 and the CB is configured for 32-bit virtual addresses) is not supported.
The TBU accepts an integration-specific transport encoding:
The integration provides topology_id as a 15-bit base SID. For TBU traffic whose address is below 64 GiB, address bits [35:32] carry an optional CSID. A nonzero carried CSID replaces configured_csid; otherwise the configured CSID is retained. The model composes the matched stream ID as:
For that legacy carrier form, the IOVA passed to the page-table walk is limited to 32 bits. A TBU address at or above 64 GiB has no carrier: its full address is retained as the IOVA and its configured CSID is used. A selected context with CBA2R.VA64=0 also constrains the walk input to 32 bits. The resulting SID is matched exactly against the programmed SMR entries. An unresolved SID follows the configured unidentified-stream behavior; it is not rewritten to another programmed CSID.
This encoding is not an architectural SMMU interface; the ARM interface provides the StreamID and IOVA independently. The core validates the decoded IOVA against TTBR0 or TTBR1 according to the architecture. Direct translations and GATS operations preserve their full 64-bit input address.
When SCR0.CLIENTPD=1, the model returns addr_mask = -1 (full bypass, identity mapping). For an unmatched stream, SCR0.USFCFG controls whether the stream faults: when set, USF is recorded and the transaction is rejected; when clear, the transaction bypasses without recording USF. For multiple matches, SCR0.SMCFCFG controls whether SMCF is recorded and rejected; when clear, the first matching S2CR action is used. There is no software parameter override for these architectural controls.
Stage-1 input addresses are checked against the selected TTBR0 or TTBR1 range. Out-of-range or non-canonical addresses raise CB_FSR.ASF.
The model classifies the main synchronous translation fault types into CB_FSR.TF, AFF, PF, EF, and ASF, records first-fault syndrome state, and latches CB_FSR.MULTI on later faults. It does not model stalled-fault delivery or resume behavior, and FSRRESTORE remains storage-only.
SMMU500 selects SCR0/SGFSR for secure transactions and NSCR0/NSGFSR for non-secure transactions before checking CLIENTPD or stream-mapping controls. The security state is also retained on internal page-table-walk DMA transactions. QEMU maps transaction attributes to an IOMMU index and QBox keeps DMI mappings separate for each index, so Secure and Non-secure requests may use DMI even when their translation controls differ. Writes to either control register invalidate already granted TBU DMI ranges.
The model performs a full page table walk on every translation. There is no TLB cache in the TCU (Translation Control Unit). Only the TBU-side DMI mechanism provides translation caching. This is functionally correct but differs from hardware which caches translations in both TBU micro-TLBs and TCU main TLB.
The model encodes the GATS input as:
This uses the lower 12 bits for the context bank index and the upper bits for the VA. If the decoded context bank is outside p_num_cb, the model reports an invalid-context fault via SGFSR.ICF and returns an error in GPAR. The spec uses a different encoding where the CB index and VA are packed differently depending on the register width.
TLBSYNC/TLBSTATUS always indicate completion (TLBSTATUS reads 0) because invalidation is performed synchronously in the post_write callback. Hardware would have asynchronous invalidation where TLBSTATUS.SACTIVE indicates pending operations.
| Parameter | Default | Description |
|---|---|---|
| p_pamax | 48 | Physical address width (bits) |
| p_num_smr | 224 | Number of Stream Match Register groups |
| p_num_cb | 16 | Number of context banks |
| p_num_pages | 16 | Number of global register pages |
| p_ato | true | Address Translation Operations supported |
| p_version | 0x21 | IDR7 version (major.minor = 2.1) |
| p_idr2 | 0x7111 | IDR2 advertised translation-table formats and address sizes |
| p_num_tbu | 1 | Number of Translation Buffer Units |