+ viUcs8Rt!RR4t!RR4tRtR#)zlBase bus and driver API. Copyright Jonas Malaco and contributors SPDX-License-Identifier: GPL-3.0-or-later csa]tRt^ toRt]R4tRtRtRt Rt Rt Rt R t R t]R 4t]R 4t]R 4t]R4t]R4t]R4t]R4t]R4tRtRtRtVtR#) BaseDriveraBase driver API. All drivers are expected to implement this API for compatibility with the liquidctl CLI or other thirdy party tools. Drivers will automatically implement the context manager protocol, but this should only be used from a call to `connect`. Example: for dev in .find_supported_devices(): with dev.connect(): print(dev.get_status()) if dev.serial_number == '49385027ZP': dev.set_fixed_speed('fan3', 42) c \4h)zPFind and bind to compatible devices. Returns a list of bound driver instances. ZNotImplementedError)clskwargs&,:/usr/lib/python3.14/site-packages/liquidctl/driver/base.pyfind_supported_devicesZ!BaseDriver.find_supported_devices "##c r)zConnect to the device. Returns `self`. ## Notes for driver authors Procedure before any read or write operation can be performed. Typically a handshake between driver and device. rselfrrrconnectZBaseDriver.connect&s "##r c r)a~Initialize the device and the driver. This method should be called every time the systems boots, resumes from a suspended state, or if the device has just been (re)connected. In those scenarios, no other method, except `connect()` or `disconnect()`, should be called until the device and driver has been (re-)initialized. Returns None or a list of `(property, value, unit)` tuples, similarly to `get_status()`. ## Notes for driver authors Apart from `connect()`, some devices might require a one-time initialization procedure after powering on, or to detect hardware changes. This should be called *after* connecting to the device. rr rr initializeZBaseDriver.initialize3s $"##r c r)zDisconnect from the device. ## Notes for driver authors Procedure before the driver can safely unbind from the device. Typically just cleanup. rr rr disconnectZBaseDriver.disconnectGs "##r c r)zJGet a status report. Returns a list of `(property, value, unit)` tuples. rr rr get_statusZBaseDriver.get_statusR "##r c r)z*Set the color mode for a specific channel.r)r channelmodeZcolorsr&&&&,r set_colorZBaseDriver.set_colorZ "##r c r)z,Set the screen mode and content. Unstable. r)r rrZvaluerrr set_screenZBaseDriver.set_screen_rr c r)z+Set channel to follow a speed duty profile.r)r rZprofiler&&&,rset_speed_profileZBaseDriver.set_speed_profilegrr c r)z"Set channel to a fixed speed duty.r)r rZdutyrrrset_fixed_speedZBaseDriver.set_fixed_speedlrr c r)z7Human readable description of the corresponding device.rr &r descriptionZBaseDriver.descriptionq "##r c r)z*Numeric vendor identifier, or None if N/A.rrrr vendor_idZBaseDriver.vendor_idwrr c r)z+Numeric product identifier, or None if N/A.rrrr product_idZBaseDriver.product_id}rr c r)zMDevice versioning number, or None if N/A. In USB devices this is bcdDevice. rrrrrelease_numberZBaseDriver.release_numberrr c r)z5Serial number reported by the device, or None if N/A.rrrr serial_numberZBaseDriver.serial_numberrr c r)z/Bus the device is connected to, or None if N/A.rrrrbusZBaseDriver.busrr c r)zvAddress of the device on the corresponding bus, or None if N/A. This typically depends on the bus enumeration order. rrrraddressZBaseDriver.addressrr c r)a@Physical location of the device, or None if N/A. This typically refers to a USB port, which is *not* dependent on bus enumeration order. However, a USB port is hub-specific, and hubs can be chained. Thus, for USB devices, this returns a tuple of port numbers, from the root hub to the parent of the connected device. rrrrportZBaseDriver.ports "##r csV#Nrrr __enter__ZBaseDriver.__enter__s r cs&VP4R#r%)r)r Zargss&*r__exit__ZBaseDriver.__exit__s  r r&N)__name__ __module__ __qualname____firstlineno____doc__Z classmethodrr r rrrrrrZpropertyrrrr r!r"r#r$r'r(__static_attributes____classdictcell__Z __classdict__@rrr s$$$ $$( $$$ $$ $ $$ $$ $$ $$$$ $$ $$ $ $r rcs*a]tRt^toRtRtRtVtR#)BaseBusz Base bus API.c sR#)zAFind compatible devices and yield corresponding driver instances.Nr&r rr find_devicesZBaseBus.find_devicessr r&N)r)r*r+r,r-r3r.r/r0r1rr2r2sr r2c s\VP44pTPVP4UUu.uFp\V4Fq3NK K upp4#uuppi)zTRecursively find loaded subclasses of `cls`. Returns a set of subclasses of `cls`. )ZsetZ__subclasses__Zunionfind_all_subclasses)rZsubZcZss& rr4r4sS c  " #C 99!3!3!5V!5A?RST?U!a?Ua!5V WWVsA N)r-rr2r4r&r rr5s'ggTXr