Home /Modules/cpu/SLALU.sleela

SLALU.sleela

lib/cpu/SLALU.sleela · 154 line(s) · sleela

<< lib/cpu/SLALU.sleela
   SLeeLa Standard Library Definition.
   Definition: Defines SLALU — the Arithmetic Logic Unit. It is the CPU's
     calculator: given two operand words and an operation selector, it computes
     a result and sets condition flags (zero, negative, carry, overflow). It
     uses SLAdder for add/subtract (subtraction via two's-complement add) and
     gate-level logic for the bitwise operations.
   
   Operations: ADD, SUB, AND, OR, XOR, NOT, SHL, SHR, CMP, PASS.
   Flags follow the usual CPU status register convention.
   
   Family: cpu. Composes SLAdder; pure Sleela arithmetic. >>
#sleela 2.5
material;
class SLALU {
  < ---- Descriptive metadata (version 1.11 nested-friendly accessors) ---- >
  << Eleven catalogued attributes with getter/setter pairs, so a GUI, loader,
     or catalog can read and (where appropriate) override this record.
     Values are faithful to the subject's real origin where publicly known. >>
  String metaVersion = "1.0.0";
  int metaId = 10197;
  String metaAuthor = "Kiro Agent";
  String metaDate = "2026-10-16";
  String metaCopyright = "SLeeLa project";
  String metaTrademark = "none";
  String metaCorporation = "none";
  < metaOrigin: National | <nation> | International | Galactic >
  String metaOrigin = "International";
  String metaBirthDate = "2026-10-06";
  < metaScienceRating: maturity/robustness on a 1..10 scale >
  int metaScienceRating = 9;
  < metaNationalSchedule: a real, citable instrument or "none" >
  String metaNationalSchedule = "none";

  String getMetaVersion() { return metaVersion; }
  void setMetaVersion(String v) { metaVersion = v; }
  int getMetaId() { return metaId; }
  void setMetaId(int v) { metaId = v; }
  String getAuthor() { return metaAuthor; }
  void setAuthor(String v) { metaAuthor = v; }
  String getDate() { return metaDate; }
  void setDate(String v) { metaDate = v; }
  String getCopyright() { return metaCopyright; }
  void setCopyright(String v) { metaCopyright = v; }
  String getTrademark() { return metaTrademark; }
  void setTrademark(String v) { metaTrademark = v; }
  String getCorporation() { return metaCorporation; }
  void setCorporation(String v) { metaCorporation = v; }
  String getOrigin() { return metaOrigin; }
  void setOrigin(String v) { metaOrigin = v; }
  String getBirthDate() { return metaBirthDate; }
  void setBirthDate(String v) { metaBirthDate = v; }
  int getScienceRating() { return metaScienceRating; }
  void setScienceRating(int v) { metaScienceRating = v; }
  String getNationalSchedule() { return metaNationalSchedule; }
  void setNationalSchedule(String v) { metaNationalSchedule = v; }
  static final int OP_ADD = 0;
  static final int OP_SUB = 1;
  static final int OP_AND = 2;
  static final int OP_OR  = 3;
  static final int OP_XOR = 4;
  static final int OP_NOT = 5;
  static final int OP_SHL = 6;
  static final int OP_SHR = 7;
  static final int OP_CMP = 8;
  static final int OP_PASS= 9;
  static final int OP_MUL = 10;
  static final int OP_DIV = 11;
  static final int OP_MOD = 12;
  static final int OP_NEG = 13;

  int width;
  SLAdder adder;
  int result;
  int flagZero;
  int flagNeg;
  int flagCarry;
  int flagOverflow;

  void configure(int bits) {
    width = bits;
    adder = new SLAdder(); adder.configure(bits);
    result = 0; flagZero = 0; flagNeg = 0; flagCarry = 0; flagOverflow = 0;
  }

  int pow2(int n) { int p = 1; int i = 0; while (i < n) { p = p * 2; i = i + 1; } return p; }
  < 2^width >
  int mask() { return pow2(width); }
  int bitAt(int v, int i) { return (v / pow2(i)) % 2; }
  int signBit(int v) { return bitAt(v, width - 1); }

  int bitwise(int a, int b, int op) {
    int out = 0; int i = 0;
    while (i < width) {
      int x = bitAt(a, i); int y = bitAt(b, i); int r = 0;
      if (op == OP_AND) { if (x == 1 && y == 1) { r = 1; } }
      if (op == OP_OR)  { if (x == 1 || y == 1) { r = 1; } }
      if (op == OP_XOR) { if (x != y) { r = 1; } }
      if (op == OP_NOT) { if (x == 0) { r = 1; } }
      if (r == 1) { out = out + pow2(i); }
      i = i + 1;
    }
    return out;
  }

  void setFlags(int value, int carry, int overflow) {
    int m = mask();
    int v = value % m;
    if (v < 0) { v = v + m; }
    result = v;
    if (result == 0) { flagZero = 1; } else { flagZero = 0; }
    flagNeg = signBit(result);
    flagCarry = carry;
    flagOverflow = overflow;
  }

  int execute(int a, int b, int op) {
    if (op == OP_ADD) {
      int s = adder.add(a % mask(), b % mask());
      setFlags(s, adder.carry(), 0);
    } else if (op == OP_SUB || op == OP_CMP) {
      < two's complement subtract: a + (~b + 1) >
      int nb = (bitwise(b, 0, OP_NOT) + 1) % mask();
      int s = adder.add(a % mask(), nb);
      setFlags(s, adder.carry(), 0);
    } else if (op == OP_MUL) {
      setFlags((a * b) % mask(), 0, 0);
    } else if (op == OP_DIV) {
      < div-by-zero sets overflow >
      if (b == 0) { setFlags(0, 0, 1); } else { setFlags(a / b, 0, 0); }
    } else if (op == OP_MOD) {
      if (b == 0) { setFlags(0, 0, 1); } else { setFlags(a % b, 0, 0); }
    } else if (op == OP_NEG) {
      setFlags((mask() - (a % mask())) % mask(), 0, 0);
    } else if (op == OP_AND || op == OP_OR || op == OP_XOR || op == OP_NOT) {
      setFlags(bitwise(a, b, op), 0, 0);
    } else if (op == OP_SHL) {
      setFlags((a * pow2(b)) % mask(), 0, 0);
    } else if (op == OP_SHR) {
      setFlags(a / pow2(b), 0, 0);
    } else {
      < OP_PASS >
      setFlags(a, 0, 0);
    }
    return result;
  }

  int out() { return result; }
  int zero() { return flagZero; }
  int negative() { return flagNeg; }
  int carry() { return flagCarry; }
  int overflow() { return flagOverflow; }
}