Home › Packages › xlt

Package xlt

This package contains 6 source unit(s) defining 6 class(es) / struct(s). Each unit below lists its fields (the values it stores) and methods (the actions it performs), with a plain explanation of each.

compile-xlt-models #sleela 2.5 (lib/xlt/examples/compile-xlt-models.sleela)

CompileXltModelsExample class

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
mainvoid main()No description in source.
printResultvoid printResult(SLXltBuildResult r)No description in source.

SLXltBuildResult #sleela 2.5 (lib/xlt/SLXltBuildResult.sleela)

SLXltBuildResult class

Defines SLXltBuildResult — the outcome of compiling an .xlt CPU-model sheet. Per the format's contract, compilation yields exactly one of two things: (a) SUCCESS: the model was built, with a list of what was built (the CPU SKU and each part that resolved and was installed), or (b) a CONGRUENCE report: an ordered list of reasons the model could NOT be built — a missing part (a declared ref resolved to nothing) or a part that is "not agreeable to design" (resolves, but does not agree with another declared part, e.g. memory channels exceeding the board). The result is deliberately like a diagnostics bag: structured, ordered, and human-readable, so the author sees precisely why integrity failed, in the document order the parts were declared. Family: xlt. Produced by SLXltCompiler. Mirrors the role of Nordshrift's diagnostics + component manifest for the SST path.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
modelNameString modelNameNo description in source.
successint success1 = built; 0 = congruence failure
builtCountint builtCountWhat was built (success path) — one line per installed part, in order.
reasonCountint reasonCountWhy it could not be built (failure path) — one reason per line, in order.
MAX_LINESstatic final int MAX_LINES = 6No description in source.
REASON_MISSINGstatic final int REASON_MISSING = 1Reason kinds, so a consumer can distinguish the two failure classes. a declared part resolved to nothing
REASON_DISAGREESstatic final int REASON_DISAGREES = 2a part is not agreeable to design
ranProgramint ranProgramOptional program-run outcome (set when the model declared a `program`). 1 = a workload was run on the built CPU
programOutputint programOutputthe program's observable output

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String name)No description in source.
recordBuiltvoid recordBuilt(String line)No description in source.
recordReasonvoid recordReason(int kind, String detail)Record a congruence reason. `kind` is REASON_MISSING or REASON_DISAGREES; the recorded line is prefixed so the report reads clearly.
setRunvoid setRun(int output)No description in source.
programRanboolean programRan()No description in source.
outputint output()No description in source.
sealvoid seal()Seal the outcome: success iff at least one part was built AND no congruence reason was recorded (every declared part resolved and agreed).
builtboolean built()No description in source.
builtLinesint builtLines()No description in source.
reasonLinesint reasonLines()No description in source.
builtLineString builtLine(int i)No description in source.
reasonLineString reasonLine(int i)No description in source.
modelString model()No description in source.

SLXltCompiler #sleela 2.5 (lib/xlt/SLXltCompiler.sleela)

SLXltCompiler class

Defines SLXltCompiler — the compiler for the XLT (.xlt) CPU-model

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
partsSLComponentCatalog partsNo description in source.
registrySLXltProducerRegistry registrywhat refs are recognized, per slot
buildSLExecutorBuild buildthe real assembly produced on success
memChannelsWantedint memChannelsWantedchannels the declared memory needs (for agreement)
boardChannelsint boardChannelschannels the declared board routes (0 = no board)

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
registerProducervoid registerProducer(int slot, String ref, int attr)Allow callers to register additional producers before compiling, so a new part becomes recognizable without editing the compiler.
compileSLXltBuildResult compile(SLXltSource src)Compile an .xlt source to a build result. Ordered, orthogonal, congruent.
assembledSLExecutorBuild assembled()No description in source.
languageOfint languageOf(String lang)Map an .xlt language token to the SLWorkload.LANG_* id (-1 if unknown).
runProgramvoid runProgram(SLXltSource src, int lang, SLXltBuildResult res)Assemble the machine and politely run the declared program on it: a grant, an SLWorkload, and SleelaVMCreator.run on build.processor(). The capability flags (nativeram/gpu/dma) are requested on the creator so the run honors what the model declared.
memoryForSLMemoryModule memoryFor(String ref, int capMiB)---------------- ref -> real catalog producer mappings ------------------ Recognition and channel attributes come from SLXltProducerRegistry; these methods only map an already-recognized ref to the concrete catalog call (the surface language cannot `new` a type from a runtime string).
boardForSLMotherboard boardFor(String ref)No description in source.
storageForSLStorageDevice storageFor(String ref)No description in source.
busForSLSystemBus busFor(String ref)No description in source.

SLXltProducerRegistry #sleela 2.5 (lib/xlt/SLXltProducerRegistry.sleela)

SLXltProducerRegistry class

Defines SLXltProducerRegistry — the explicit registry of part producers the XLT compiler resolves declared refs against. Instead of the compiler hardcoding "is this a known ref" tables inline, each recognizable part ref (CPU SKU, memory preset, board, cadence, storage, bus) is REGISTERED here under its slot, and the compiler asks the registry whether a ref is known and (for memory/board) what channel count it implies for the agreement check. A new part becomes recognizable by registering it, not by editing the compiler — the open/closed seam the SST symbol tables have. A registered entry carries: the slot it belongs to, the ref string, and an integer attribute (memory channel count, or board routed channels; 0/1 otherwise). Registration order does not matter; lookup is by (slot, ref). Family: xlt. Consulted by SLXltCompiler; mirrors the resolution role of lib/sst/SSTSymbolTable for the CPU-model format.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
SLOT_CPUstatic final int SLOT_CPU = 1Slot ids the parts divide into (orthogonal document slots).
SLOT_MEMORYstatic final int SLOT_MEMORY = 2No description in source.
SLOT_BOARDstatic final int SLOT_BOARD = 3No description in source.
SLOT_CADENCEstatic final int SLOT_CADENCE = 4No description in source.
SLOT_STORAGEstatic final int SLOT_STORAGE = 5No description in source.
SLOT_BUSstatic final int SLOT_BUS = 6No description in source.
countint countRegistered entries, stored over an SLRAM-free parallel-array shape: each entry is (slot, ref, attr). Bounded; grown by register().
MAXstatic final int MAX = 64No description in source.
slotsSLRAM slotsParallel stores (no arrays in the surface language: use a small fixed bank backed by an SLRAM-less scheme is awkward, so we page into an SLRAM pair). slot id per entry
attrsSLRAM attrsinteger attribute per entry (channels, etc.)
refsLoSLRAM refsLoref string handles are not storable in SLRAM; see refs bank
refsSLXltRefBank refsstring bank holding the ref per entry

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure()No description in source.
registerboolean register(int slot, String ref, int attr)Register one producer: its slot, ref string, and integer attribute.
knownboolean known(int slot, String ref)Is `ref` a registered producer for `slot`?
attrOfint attrOf(int slot, String ref)The integer attribute registered for (slot, ref); 0 if not found.
entriesint entries()No description in source.
loadDefaultsvoid loadDefaults()The default roster: every ref the SLComponentCatalog + CPU folders expose, with memory/board channel attributes for the agreement check.

SLXltRefBank #sleela 2.5 (lib/xlt/SLXltRefBank.sleela)

SLXltRefBank class

Defines SLXltRefBank — a small fixed-capacity bank of String values indexed by integer position, used by SLXltProducerRegistry to hold the ref string of each registered producer (SLRAM stores words, not strings, so the registry pages its integer attributes into SLRAM and its ref strings into this bank at the same index). The surface language has no arrays, so the bank is a bounded set of explicit slots selected by index, the same idiom SLVMClass uses for its f0..f7 / m0..m7 members. Family: xlt. Internal helper for SLXltProducerRegistry.

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
capint capNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(int capacity)No description in source.
putvoid put(int i, String v)No description in source.
getString get(int i)No description in source.

SLXltSource #sleela 2.5 (lib/xlt/SLXltSource.sleela)

SLXltSource class

Defines SLXltSource — the canonical source-time representation of

Carries the standard Metadata Class record — eleven catalogued provenance attributes (version, id, author, date, copyright, trademark, corporation, origin, birth date, science rating, national schedule) with matching get/set accessors. These are omitted from the tables below for brevity.

Fields — the named values this unit stores.

FieldDeclarationWhat it holds
pathString paththe .xlt file path
modelNameString modelNamethe `model Name { ... }` identifier
targetString target`target sleela;`
libraryRootString libraryRootthe /lib root parts resolve against
cpuRefString cpuRefThe declared parts, one per orthogonal slot (each may be set at most once). CPU SKU class name, e.g. "SLAMDEPYC9575F"
boardRefString boardRefSLMotherboard preset, e.g. "wrx90" (empty = none)
memoryRefString memoryRefSLMemoryModule preset, e.g. "ddr2_800"
memoryCapMiBint memoryCapMiBcapacity argument for the memory preset
cadenceRefString cadenceRefcadence to present, e.g. "DDR2" (empty = native)
storageRefString storageRefSLStorageDevice preset (empty = none)
busRefString busRefSLSystemBus preset (empty = none)
gpuFlagint gpuFlagCapability directives: bare orthogonal flags (declared at most once each). `gpu;` -> build.enableGPU()
dmaFlagint dmaFlag`dma;` -> build.enableDMA()
nativeRamFlagint nativeRamFlag`nativeram;` -> declare the NATIVE_RAM feature bit
usualTierRefString usualTierRefMemory-tier designation: the model may split memory into a "usual" tier (for usual activities) and an "accurate" tier (for competency/accuracy), and name which is the default (main) tier. Each memory preset slot below. memory preset for the usual tier, e.g. "ddr2_800"
accurateTierRefString accurateTierRefmemory preset for the accurate tier, e.g. "ddr5_6400"
mainTierString mainTier"usual" or "accurate" — which the main program uses
programPathString programPathOptional workload: the program this model should politely run on the built CPU (source path + language), and the resource grant it is admitted under. e.g. "app.sleela" (empty = build hardware only)
programLangString programLang"sleela" | "c" | "cpp" | "java"
grantWordsint grantWordsmemory words requested (0 = compiler default)
grantBudgetint grantBudgetcycle budget requested (0 = compiler default)
validatedint validatedNo description in source.

Methods — the actions this unit can perform.

MethodSignatureWhat it does
configurevoid configure(String sourcePath, String root)No description in source.
setModelNamevoid setModelName(String name)No description in source.
setTargetvoid setTarget(String t)No description in source.
declareCpuboolean declareCpu(String ref)Orthogonal part declarations: each returns false if the slot was already filled (a duplicate breaks document orthogonality and must be reported).
declareBoardboolean declareBoard(String ref)No description in source.
declareMemoryboolean declareMemory(String ref, int capMiB)No description in source.
declareCadenceboolean declareCadence(String ref)No description in source.
declareStorageboolean declareStorage(String ref)No description in source.
declareBusboolean declareBus(String ref)No description in source.
declareGpuboolean declareGpu()Capability directives: each may be declared at most once (orthogonal).
declareDmaboolean declareDma()No description in source.
declareNativeRamboolean declareNativeRam()No description in source.
declareUsualTierboolean declareUsualTier(String ref)Memory-tier designation (orthogonal: each tier declared at most once).
declareAccurateTierboolean declareAccurateTier(String ref)No description in source.
declareMainTierboolean declareMainTier(String which)No description in source.
declareProgramboolean declareProgram(String path, String lang)Workload + grant (each declared at most once; orthogonal).
declareGrantboolean declareGrant(int words, int budget)No description in source.
validateboolean validate()No description in source.
sourcePathString sourcePath()No description in source.
nameString name()No description in source.
targetNameString targetName()No description in source.
cpuString cpu()No description in source.
boardString board()No description in source.
memoryString memory()No description in source.
memoryCapacityint memoryCapacity()No description in source.
cadenceString cadence()No description in source.
storageString storage()No description in source.
busString bus()No description in source.
hasBoardboolean hasBoard()No description in source.
hasCadenceboolean hasCadence()No description in source.
hasStorageboolean hasStorage()No description in source.
hasBusboolean hasBus()No description in source.
wantsGpuboolean wantsGpu()No description in source.
wantsDmaboolean wantsDma()No description in source.
wantsNativeRamboolean wantsNativeRam()No description in source.
usualTierString usualTier()No description in source.
accurateTierString accurateTier()No description in source.
mainString main()No description in source.
hasTiersboolean hasTiers()No description in source.
programString program()No description in source.
programLanguageString programLanguage()No description in source.
hasProgramboolean hasProgram()No description in source.
grantWordsRequestedint grantWordsRequested()No description in source.
grantBudgetRequestedint grantBudgetRequested()No description in source.