Home /Modules/operating-system/SLDriverLoaderEmitter.sleela

SLDriverLoaderEmitter.sleela

lib/operating-system/os-creator/SLDriverLoaderEmitter.sleela · 176 line(s) · sleela

<< lib/operating-system/os-creator/SLDriverLoaderEmitter.sleela
   SLeeLa Standard Library Definition.
   Definition: Defines SLDriverLoaderEmitter — the OS Creator(TM) emitter for the
     driver-loader piece. Given an SLOSModel it walks the model's driver manifest
     (SLDriverSet) and produces the C and C++ source for the stage the kernel
     runs to bring up devices: it probes the bus, loads every built-in driver
     first (storage must be present before the rootfs mounts), then loads module
     drivers on demand. It emits a drivers.conf listing each driver and its
     binding (builtin|module).
   
   This is piece #5 of the chain. The emitted C contains one load_driver() call
   per driver, ordered built-ins first, generated from the model's manifest.
   
   Family: operating-system. OS Creator(TM) piece emitter; consumes SLOSModel, fills SLOSPiece. >>
#sleela 2.5
material;
class SLDriverLoaderEmitter {
  < ---- 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 = 10889;
  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-10";
  < 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; }
  SLOSPiece emit(SLOSModel m) {
    SLOSPiece p = new SLOSPiece();
    p.configure("Driver Loader", "kernel/driver-loader", "driver_loader");

    String manifest = m.driverSet().driverManifest();

    String c = "/* driver_loader.c - device bring-up, OS Creator(TM) for " + m.name() + " */\n";
    c = c + "#include <stdint.h>\n\n";
    c = c + "extern int probe_buses(void);\n";
    c = c + "extern int load_driver(const char *name);\n\n";
    c = c + "int driver_loader_main(void) {\n";
    c = c + "    if (probe_buses() != 0) return 1;\n";
    c = c + "    /* Built-in drivers first (storage must precede the rootfs mount). */\n";
    c = c + emitLoadCalls(manifest, "builtin", 2);
    c = c + "    /* Module drivers on demand. */\n";
    c = c + emitLoadCalls(manifest, "module", 3);
    c = c + "    return 0;\n";
    c = c + "}\n";
    p.setC(c);

    String cpp = "// driver_loader.cpp - device bring-up (C++ surface) for " + m.name() + "\n";
    cpp = cpp + "#include <string>\n#include <vector>\nnamespace oscreator {\n";
    cpp = cpp + "class DriverLoader {\npublic:\n";
    cpp = cpp + "  std::vector<std::string> builtins = {" + driverList(manifest, "builtin") + "};\n";
    cpp = cpp + "  std::vector<std::string> modules  = {" + driverList(manifest, "module") + "};\n";
    cpp = cpp + "  int load() {\n";
    cpp = cpp + "    if (!probeBuses()) return 1;\n";
    cpp = cpp + "    for (auto &d : builtins) if (!loadDriver(d)) return 2;\n";
    cpp = cpp + "    for (auto &d : modules)  loadDriver(d);\n";
    cpp = cpp + "    return 0;\n  }\n";
    cpp = cpp + "private:\n  bool probeBuses();\n  bool loadDriver(const std::string&);\n";
    cpp = cpp + "};\n} // namespace oscreator\n";
    p.setCpp(cpp);

    String conf = "# drivers.conf - generated by OS Creator(TM)\n";
    conf = conf + "# format: <driver> <binding>\n";
    conf = conf + manifest + "\n";
    p.setConfig("drivers.conf", conf);

    p.setReadme("# Driver Loader piece\n\nProbes buses and loads drivers (`driver_loader.c`/"
      + "`driver_loader.cpp`): built-ins first (storage before the rootfs mount), then modules. "
      + "Driven by `drivers.conf`.\n");
    return p;
  }

  < One load_driver() call per manifest line whose binding matches, with the >
  < given error code on failure. >
  String emitLoadCalls(String manifest, String binding, int errCode) {
    String out = "";
    String line = "";
    int i = 0;
    int n = strLen(manifest);
    while (i <= n) {
      String ch = charAt(manifest, i);
      if (ch == "\n" || i == n) {
        if (lineBinding(line) == binding) {
          out = out + "    if (load_driver(\"" + lineName(line) + "\") != 0) return "
                    + intToStr(errCode) + ";\n";
        }
        line = "";
      } else {
        line = line + ch;
      }
      i = i + 1;
    }
    return out;
  }

  < A comma-separated C++ initializer list of driver names with the binding. >
  String driverList(String manifest, String binding) {
    String out = "";
    String line = "";
    int i = 0;
    int n = strLen(manifest);
    int first = 1;
    while (i <= n) {
      String ch = charAt(manifest, i);
      if (ch == "\n" || i == n) {
        if (lineBinding(line) == binding) {
          if (first == 1) { out = out + "\"" + lineName(line) + "\""; first = 0; }
          else { out = out + ", \"" + lineName(line) + "\""; }
        }
        line = "";
      } else {
        line = line + ch;
      }
      i = i + 1;
    }
    return out;
  }

  < "name binding" -> name (token before the space). >
  String lineName(String line) {
    int i = 0;
    int n = strLen(line);
    while (i < n) {
      if (charAt(line, i) == " ") { return substr(line, 0, i); }
      i = i + 1;
    }
    return line;
  }
  < "name binding" -> binding (token after the space). >
  String lineBinding(String line) {
    int i = 0;
    int n = strLen(line);
    while (i < n) {
      if (charAt(line, i) == " ") { return substr(line, i + 1, n); }
      i = i + 1;
    }
    return "";
  }

  int strLen(String s) { return native sleela_str_length(s); }
  String substr(String s, int a, int b) { return native sleela_str_substring(s, a, b); }
  String charAt(String s, int i) { return substr(s, i, i + 1); }
  String intToStr(int v) { return "" + v; }
}