+ viacsRt^RIt^RIHtHtHt^RIHt]!RR]44t]!RR]44t R Rlt R t R t R#) aBConstants and methods for interfacing with PMBus compliant devices. Specifications: - Power Systems Management Protocol Specification. Revision 1.3.1, 2015. Available uppon request, check the PMBus website. - Power Systems Management Protocol Specification. Revision 1.2, 2010. Available on the PMBus website. http://pmbus.org/Assets/PDFS/Public/PMBus_Specification_Part_I_Rev_1-2_20100906.pdf http://pmbus.org/Assets/PDFS/Public/PMBus_Specification_Part_II_Rev_1-2_20100906.pdf - System Management Bus (SMBus) Specification. Version 3.1, 2018. Available on the SMBus website. http://smbus.org/specs/SMBus_3_1_20180319.pdf Additional references: - Milios, John. CRC-8 firmware implementations for SMBus. 1999. http://sbs-forum.org/marcom/dc2/20_crc-8_firmware_implementations.pdf - Pircher, Thomas. pycrc -- parameterisable CRC calculation utility and C source code generator: CRC algorithms implemented in Python. https://github.com/tpircher/pycrc/blob/master/pycrc/algorithms.py - White, Robert V. Using the PMBus Protocol. 2005. http://pmbus.org/Assets/Present/Using_The_PMBus_20051012.pdf Copyright Jonas Malaco and contributors Includes a CRC-8 implementation adapted from pycrc by Thomas Pircher. Copyright (c) 2006-2017 Thomas Pircher SPDX-License-Identifier: GPL-3.0-or-later N)IntEnumIntFlaguniquemkCrcFuncs]tRt^+t^t^tRtR#)WriteBitN)__name__ __module__ __qualname____firstlineno__ZWRITEZREAD__static_attributes__r4/usr/lib/python3.14/site-packages/liquidctl/pmbus.pyrr+s E Dr rcs]tRt^1tRt^t^t^t^t^ t ^:t ^;t ^t^?t^t^t^t^t^t^t^t^t^t^t^t^t^t^t^t^t^t ^t!^t"^t#^t$^t%^t&^t'^t(^t)^t*^t+^t,^t-^t.^t/Rt0R#) CommandCodez2Incomplete enumeration of the PMBus command codes.rN)1rrr r __doc__ZPAGEZ CLEAR_FAULTSZPAGE_PLUS_WRITEZPAGE_PLUS_READZ VOUT_MODEZFAN_CONFIG_1_2Z FAN_COMMAND_1Z FAN_COMMAND_2ZFAN_CONFIG_3_4Z FAN_COMMAND_3Z FAN_COMMAND_4ZREAD_EINZ READ_EOUTZREAD_VINZREAD_IINZ READ_VCAPZ READ_VOUTZ READ_IOUTZREAD_TEMPERATURE_1ZREAD_TEMPERATURE_2ZREAD_TEMPERATURE_3ZREAD_FAN_SPEED_1ZREAD_FAN_SPEED_2ZREAD_FAN_SPEED_3ZREAD_FAN_SPEED_4ZREAD_DUTY_CYCLEZREAD_FREQUENCYZ READ_POUTZREAD_PINZREAD_PMBUS_REVISONZMFR_IDZ MFR_MODELZ MFR_REVISIONZ MFR_LOCATIONZMFR_DATEZ MFR_SERIALZMFR_SPECIFIC_D1ZMFR_SPECIFIC_D2ZMFR_SPECIFIC_D8ZMFR_SPECIFIC_DCZMFR_SPECIFIC_EEZMFR_SPECIFIC_F0ZMFR_SPECIFIC_FCr rr r rr1s< DLONINMMNMMHIHHIIIONIH FILLHJOOOOOOOr rcs\PVR,RR7pVf$V^ , pVR,pVR8d VR, pM V^,pTpV^8d V^ , pV^V,,#)aRead PMBus LINEAR11 and ULINEAR16 numeric values. If `vout_exp` is None the value is interpreted as a 2 byte LINEAR11 value. The mantissa is stored in the lower 11 bits, in two's-complement, and the exponent is is stored in the upper 5 bits, also in two's-complement. Otherwise the value is assumed to be encoded in ULINEAR16, where the exponent is read from the lower 5 bits of `vout_exp` (which is assumed to be the output from VOUT_MOE) and the mantissa is the unsigned 2 byte integer in `bytes`. Per the SMBus specification, the lowest order byte is sent first (endianess is little). >>> linear_to_float(bytes.fromhex('67e3')) 54.4375 >>> linear_to_float(bytes.fromhex('6703'), vout_exp=0x1c) 54.4375 :NiNlittle) byteorderi)intZ from_bytes)bytesZvout_expZtmpZexpZfras&& r linear_to_floatrhso( ..rh. 7CRiEk :*Co RxBh C<r csdV^8XdR#Rp\P!\P!\P!V4V, ^44p\ V^V),,4pV^8d V^ ,pV^8d VR,p\ P V^ ,V,^RR7#)aEncode float in PMBus LINEAR11 format. A LINEAR11 number is a 2 byte value with an 11 bit two's complement mantissa and a 5 bit two's complement exponent. Per the SMBus specification, the lowest order byte is sent first (endianess is little). >>> float_to_linear11(3.3).hex() '4dc3' >>> float_to_linear11(0.0).hex() '0000' >>> linear_to_float(float_to_linear11(2812)) 2812 >>> linear_to_float(float_to_linear11(-2812)) -2812 srrr)Zlengthr)mathZceilZlogZfabsZroundrZto_bytes)ZfloatZmax_yZnZys& r float_to_linear11rs$ z E $((499U+E1156A ea1"goA1u F1u H <<bA a8< DDr cs$\R4!V4#)u Compute a 8-bit Packet Error Code (PEC) for `bytes`. According to the SMBus specification, the PEC is computed using a 8-bit cyclic rendundancy check (CRC-8) with the polynominal x⁸ + x² + x¹ + x⁰. The computation uses a 256-byte lookup table. Based on https://github.com/tpircher/pycrc/blob/master/pycrc/algorithms.py. >>> hex(compute_pec(bytes('123456789', 'ascii'))) '0xf4' >>> hex(compute_pec(bytes.fromhex('5c'))) '0x93' >>> hex(compute_pec(bytes.fromhex('5c93'))) '0x0' zcrc-8r)rs&r compute_pecrs& G U ##r )N) rrZenumrrrZliquidctl.utilrrrrrrrr r rsa"H ))#w 3'33lDE<$r