<< lib/operating-system/usb/SLUSBDevice.sleela SLeeLa Standard Library Definition. Definition: Defines SLUSBDevice — a named Universal Serial Bus device or controller. It extends SLHardwareComponent and models the finite USB specification generations by name (USB 1.1, 2.0, 3.2 Gen 1/Gen 2/Gen 2x2, USB4) together with the attributes a machine description needs: signalling rate, connector type (A / B / C / Micro), device class (HID, mass storage, hub, audio, video), and whether the port can deliver USB Power Delivery. A machine description requests a controller/device by generation and class and attaches it to the machine's USB tree. Family: operating-system. Extends SLHardwareComponent. >> #sleela 2.5 material; class SLUSBDevice extends SLHardwareComponent { < ---- 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 = 10945; String metaAuthor = "Kiro Agent"; String metaDate = "2026-10-16"; String metaCopyright = "SLeeLa project"; String metaTrademark = "none"; String metaCorporation = "none"; < metaOrigin: National | | 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; } < Specification-generation ordinals. > < Full Speed, 12 Mb/s > static final int USB_1_1 = 0; < High Speed, 480 Mb/s > static final int USB_2_0 = 1; < 5 Gb/s (formerly USB 3.0) > static final int USB_3_2G1 = 2; < 10 Gb/s (formerly USB 3.1) > static final int USB_3_2G2 = 3; < 20 Gb/s > static final int USB_3_2G2X2 = 4; < 40 Gb/s > static final int USB4 = 5; < Device-class ordinals (USB class codes, abbreviated set). > static final int UC_HID = 1; static final int UC_MASS = 2; static final int UC_HUB = 3; static final int UC_AUDIO = 4; static final int UC_VIDEO = 5; < host controller / root hub > static final int UC_CONTROLLER = 6; < USB_* > int generation; < UC_* > int usbClass; < signalling rate in Mb/s > int rateMbps; < "Type-A" / "Type-B" / "Type-C" / "Micro-B" > String connector; < 1 if USB-PD capable > int powerDelivery; < for hubs/controllers > int maxPorts; void configure(String manufacturer, String partName, int gen, int cls) { configureComponent(manufacturer, partName, CLASS_USB); generation = gen; usbClass = cls; connector = "Type-C"; powerDelivery = 1; maxPorts = 0; if (gen == USB_1_1) { rateMbps = 12; connector = "Type-A"; powerDelivery = 0; } if (gen == USB_2_0) { rateMbps = 480; connector = "Type-A"; powerDelivery = 0; } if (gen == USB_3_2G1) { rateMbps = 5000; connector = "Type-A"; } if (gen == USB_3_2G2) { rateMbps = 10000; } if (gen == USB_3_2G2X2) { rateMbps = 20000; } if (gen == USB4) { rateMbps = 40000; } if (cls == UC_HUB || cls == UC_CONTROLLER) { maxPorts = 4; } } < Configure by generation name ("USB1.1","USB2.0","USB3.2G1","USB3.2G2","USB3.2G2x2","USB4"). > void configureByName(String manufacturer, String partName, String genName, int cls) { if (genName == "USB4") { configure(manufacturer, partName, USB4, cls); return; } if (genName == "USB3.2G2x2") { configure(manufacturer, partName, USB_3_2G2X2, cls); return; } if (genName == "USB3.2G2") { configure(manufacturer, partName, USB_3_2G2, cls); return; } if (genName == "USB3.2G1") { configure(manufacturer, partName, USB_3_2G1, cls); return; } if (genName == "USB2.0") { configure(manufacturer, partName, USB_2_0, cls); return; } configure(manufacturer, partName, USB_1_1, cls); } void setConnector(String c) { connector = c; } void setPorts(int ports) { maxPorts = ports; } String generationName() { if (generation == USB4) { return "USB4"; } if (generation == USB_3_2G2X2) { return "USB 3.2 Gen 2x2"; } if (generation == USB_3_2G2) { return "USB 3.2 Gen 2"; } if (generation == USB_3_2G1) { return "USB 3.2 Gen 1"; } if (generation == USB_2_0) { return "USB 2.0"; } return "USB 1.1"; } String usbClassName() { if (usbClass == UC_HID) { return "HID"; } if (usbClass == UC_MASS) { return "Mass Storage"; } if (usbClass == UC_HUB) { return "Hub"; } if (usbClass == UC_AUDIO) { return "Audio"; } if (usbClass == UC_VIDEO) { return "Video"; } return "Host Controller"; } int signallingRateMbps() { return rateMbps; } String connectorType() { return connector; } boolean hasPowerDelivery() { return powerDelivery == 1; } int portCount() { return maxPorts; } boolean isController() { return usbClass == UC_CONTROLLER; } }