Package xlt
compile-xlt-models #sleela 2.5 (lib/xlt/examples/compile-xlt-models.sleela)
CompileXltModelsExample class
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
main | void main() | No description in source. |
printResult | void 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
modelName | String modelName | No description in source. |
success | int success | 1 = built; 0 = congruence failure |
builtCount | int builtCount | What was built (success path) — one line per installed part, in order. |
reasonCount | int reasonCount | Why it could not be built (failure path) — one reason per line, in order. |
MAX_LINES | static final int MAX_LINES = 6 | No description in source. |
REASON_MISSING | static final int REASON_MISSING = 1 | Reason kinds, so a consumer can distinguish the two failure classes. a declared part resolved to nothing |
REASON_DISAGREES | static final int REASON_DISAGREES = 2 | a part is not agreeable to design |
ranProgram | int ranProgram | Optional program-run outcome (set when the model declared a `program`). 1 = a workload was run on the built CPU |
programOutput | int programOutput | the program's observable output |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String name) | No description in source. |
recordBuilt | void recordBuilt(String line) | No description in source. |
recordReason | void 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. |
setRun | void setRun(int output) | No description in source. |
programRan | boolean programRan() | No description in source. |
output | int output() | No description in source. |
seal | void seal() | Seal the outcome: success iff at least one part was built AND no congruence reason was recorded (every declared part resolved and agreed). |
built | boolean built() | No description in source. |
builtLines | int builtLines() | No description in source. |
reasonLines | int reasonLines() | No description in source. |
builtLine | String builtLine(int i) | No description in source. |
reasonLine | String reasonLine(int i) | No description in source. |
model | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
parts | SLComponentCatalog parts | No description in source. |
registry | SLXltProducerRegistry registry | what refs are recognized, per slot |
build | SLExecutorBuild build | the real assembly produced on success |
memChannelsWanted | int memChannelsWanted | channels the declared memory needs (for agreement) |
boardChannels | int boardChannels | channels the declared board routes (0 = no board) |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
registerProducer | void 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. |
compile | SLXltBuildResult compile(SLXltSource src) | Compile an .xlt source to a build result. Ordered, orthogonal, congruent. |
assembled | SLExecutorBuild assembled() | No description in source. |
languageOf | int languageOf(String lang) | Map an .xlt language token to the SLWorkload.LANG_* id (-1 if unknown). |
runProgram | void 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. |
memoryFor | SLMemoryModule 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). |
boardFor | SLMotherboard boardFor(String ref) | No description in source. |
storageFor | SLStorageDevice storageFor(String ref) | No description in source. |
busFor | SLSystemBus 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
SLOT_CPU | static final int SLOT_CPU = 1 | Slot ids the parts divide into (orthogonal document slots). |
SLOT_MEMORY | static final int SLOT_MEMORY = 2 | No description in source. |
SLOT_BOARD | static final int SLOT_BOARD = 3 | No description in source. |
SLOT_CADENCE | static final int SLOT_CADENCE = 4 | No description in source. |
SLOT_STORAGE | static final int SLOT_STORAGE = 5 | No description in source. |
SLOT_BUS | static final int SLOT_BUS = 6 | No description in source. |
count | int count | Registered entries, stored over an SLRAM-free parallel-array shape: each entry is (slot, ref, attr). Bounded; grown by register(). |
MAX | static final int MAX = 64 | No description in source. |
slots | SLRAM slots | Parallel 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 |
attrs | SLRAM attrs | integer attribute per entry (channels, etc.) |
refsLo | SLRAM refsLo | ref string handles are not storable in SLRAM; see refs bank |
refs | SLXltRefBank refs | string bank holding the ref per entry |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure() | No description in source. |
register | boolean register(int slot, String ref, int attr) | Register one producer: its slot, ref string, and integer attribute. |
known | boolean known(int slot, String ref) | Is `ref` a registered producer for `slot`? |
attrOf | int attrOf(int slot, String ref) | The integer attribute registered for (slot, ref); 0 if not found. |
entries | int entries() | No description in source. |
loadDefaults | void 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.
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
cap | int cap | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(int capacity) | No description in source. |
put | void put(int i, String v) | No description in source. |
get | String 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
Fields — the named values this unit stores.
| Field | Declaration | What it holds |
|---|---|---|
path | String path | the .xlt file path |
modelName | String modelName | the `model Name { ... }` identifier |
target | String target | `target sleela;` |
libraryRoot | String libraryRoot | the /lib root parts resolve against |
cpuRef | String cpuRef | The declared parts, one per orthogonal slot (each may be set at most once). CPU SKU class name, e.g. "SLAMDEPYC9575F" |
boardRef | String boardRef | SLMotherboard preset, e.g. "wrx90" (empty = none) |
memoryRef | String memoryRef | SLMemoryModule preset, e.g. "ddr2_800" |
memoryCapMiB | int memoryCapMiB | capacity argument for the memory preset |
cadenceRef | String cadenceRef | cadence to present, e.g. "DDR2" (empty = native) |
storageRef | String storageRef | SLStorageDevice preset (empty = none) |
busRef | String busRef | SLSystemBus preset (empty = none) |
gpuFlag | int gpuFlag | Capability directives: bare orthogonal flags (declared at most once each). `gpu;` -> build.enableGPU() |
dmaFlag | int dmaFlag | `dma;` -> build.enableDMA() |
nativeRamFlag | int nativeRamFlag | `nativeram;` -> declare the NATIVE_RAM feature bit |
usualTierRef | String usualTierRef | Memory-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" |
accurateTierRef | String accurateTierRef | memory preset for the accurate tier, e.g. "ddr5_6400" |
mainTier | String mainTier | "usual" or "accurate" — which the main program uses |
programPath | String programPath | Optional 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) |
programLang | String programLang | "sleela" | "c" | "cpp" | "java" |
grantWords | int grantWords | memory words requested (0 = compiler default) |
grantBudget | int grantBudget | cycle budget requested (0 = compiler default) |
validated | int validated | No description in source. |
Methods — the actions this unit can perform.
| Method | Signature | What it does |
|---|---|---|
configure | void configure(String sourcePath, String root) | No description in source. |
setModelName | void setModelName(String name) | No description in source. |
setTarget | void setTarget(String t) | No description in source. |
declareCpu | boolean declareCpu(String ref) | Orthogonal part declarations: each returns false if the slot was already filled (a duplicate breaks document orthogonality and must be reported). |
declareBoard | boolean declareBoard(String ref) | No description in source. |
declareMemory | boolean declareMemory(String ref, int capMiB) | No description in source. |
declareCadence | boolean declareCadence(String ref) | No description in source. |
declareStorage | boolean declareStorage(String ref) | No description in source. |
declareBus | boolean declareBus(String ref) | No description in source. |
declareGpu | boolean declareGpu() | Capability directives: each may be declared at most once (orthogonal). |
declareDma | boolean declareDma() | No description in source. |
declareNativeRam | boolean declareNativeRam() | No description in source. |
declareUsualTier | boolean declareUsualTier(String ref) | Memory-tier designation (orthogonal: each tier declared at most once). |
declareAccurateTier | boolean declareAccurateTier(String ref) | No description in source. |
declareMainTier | boolean declareMainTier(String which) | No description in source. |
declareProgram | boolean declareProgram(String path, String lang) | Workload + grant (each declared at most once; orthogonal). |
declareGrant | boolean declareGrant(int words, int budget) | No description in source. |
validate | boolean validate() | No description in source. |
sourcePath | String sourcePath() | No description in source. |
name | String name() | No description in source. |
targetName | String targetName() | No description in source. |
cpu | String cpu() | No description in source. |
board | String board() | No description in source. |
memory | String memory() | No description in source. |
memoryCapacity | int memoryCapacity() | No description in source. |
cadence | String cadence() | No description in source. |
storage | String storage() | No description in source. |
bus | String bus() | No description in source. |
hasBoard | boolean hasBoard() | No description in source. |
hasCadence | boolean hasCadence() | No description in source. |
hasStorage | boolean hasStorage() | No description in source. |
hasBus | boolean hasBus() | No description in source. |
wantsGpu | boolean wantsGpu() | No description in source. |
wantsDma | boolean wantsDma() | No description in source. |
wantsNativeRam | boolean wantsNativeRam() | No description in source. |
usualTier | String usualTier() | No description in source. |
accurateTier | String accurateTier() | No description in source. |
main | String main() | No description in source. |
hasTiers | boolean hasTiers() | No description in source. |
program | String program() | No description in source. |
programLanguage | String programLanguage() | No description in source. |
hasProgram | boolean hasProgram() | No description in source. |
grantWordsRequested | int grantWordsRequested() | No description in source. |
grantBudgetRequested | int grantBudgetRequested() | No description in source. |