w1-therm-api 0.1.0__tar.gz

w1_therm_api-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: 🐛 Bug Report
+about: Create a report to help us improve the package
+title: "[BUG] "
+labels: ["bug"]
+assignees: ""
+---
+
+### Describe the Bug
+A clear and concise description of what the bug is.
+
+### Reproduction Steps
+Steps to reproduce the behavior:
+1. Run code '...'
+2. Pass arguments '...'
+3. See error
+
+### Expected Behavior
+A clear and concise description of what you expected to happen.
+
+### Code Snippet & Error Logs
+If applicable, add a minimal Python code snippet and the full terminal traceback error logs to help explain your problem.
+
+```python
+# Paste your code here
+```
+
+### Environment Information
+- **OS:** [e.g. macOS, Ubuntu, Windows]
+- **Python Version:** [e.g. 3.11.4]
+- **Package Version:** [e.g. 0.1.2]
+

w1_therm_api-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,27 @@
+---
+name: 🚀 Feature Request
+about: Suggest an idea or new functionality for this package
+title: "[FEATURE] "
+labels: ["enhancement", "feature"]
+assignees: ""
+---
+
+### Is your feature request related to a problem? Please describe.
+A clear and concise description of what the problem is. (e.g., "I'm frustrated when trying to parse XYZ files because...")
+
+### Describe the solution you'd like
+A clear and concise description of what you want to happen and how you envision the new Python API/syntax looking.
+
+```python
+# If applicable, show an ideal code example of how you'd like to use it:
+import my_package
+
+my_package.new_feature(option="value")
+```
+
+### Describe alternatives you've considered
+A clear and concise description of any alternative solutions or workarounds you've tried.
+
+### Additional context
+Add any other context, screenshots, or examples about the feature request here.
+

w1_therm_api-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,28 @@
+## Description
+Provide a brief summary of the changes introduced by this pull request and the problems they solve.
+
+Fixes # (issue number)
+
+## Type of Change
+Please delete options that are not relevant.
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] 🚀 New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📝 Documentation update
+
+## How Has This Been Tested?
+Please describe the tests that you ran to verify your changes. 
+- [ ] **Unit Tests:** Run `pytest` locally to ensure no regressions.
+- [ ] **Manual Verification:** Tested locally using the following script/input:
+  ```python
+  # Paste manual testing snippet if applicable
+  ```
+
+## Checklist
+- [ ] My code follows the code style and formatting guidelines of this project.
+- [ ] I have performed a self-review of my own code.
+- [ ] I have commented my code, particularly in hard-to-understand areas.
+- [ ] I have made corresponding changes to the documentation.
+- [ ] My changes generate no new warnings or console errors.
+- [ ] New and existing unit tests pass locally with my changes.
+

w1_therm_api-0.1.0/.github/release.yml

@@ -0,0 +1,25 @@
+changelog:
+  exclude:
+    labels:
+      - ignore
+      - duplicate
+    authors:
+      - dependabot[bot]
+
+  categories:
+    - title: "🚀 New Features"
+      labels:
+        - enhancement
+        - feature
+    - title: "🐛 Bug Fixes"
+      labels:
+        - bug
+        - fix
+    - title: "📝 Documentation"
+      labels:
+        - documentation
+        - docs
+    - title: "⚙️ Dependency Updates"
+      labels:
+        - dependencies
+

w1_therm_api-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # Critical for OIDC Trusted Publishing
+      contents: write  # Crucial to let the action attach binaries to your release
+
+    steps:
+    - name: Checkout Source
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11' # Fixed syntax from 'python-numeric-version'
+
+    - name: Install Build Tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+
+    - name: Build Package Distributions
+      run: python -m build
+
+    - name: Upload Binaries to GitHub Release
+      uses: softprops/action-gh-release@v2
+      with:
+        files: dist/*      # Automatically grabs both the .whl and .tar.gz files
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Built-in token, no setup required
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+

w1_therm_api-0.1.0/.gitignore

@@ -0,0 +1,22 @@
+# VS Code
+.vscode/
+
+# Python
+__pycache__/
+*.pyc
+
+# Node
+node_modules/
+
+# Compiled binaries
+*.o
+*.out
+*.exe
+
+# Logs
+*.log
+
+# Raspberry Pi specific
+*.swp
+
+.attic

w1_therm_api-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.5
+Name: w1-therm-api
+Version: 0.1.0
+Summary: A fast Python API wrapper for the Linux w1_therm kernel driver supporting simultaneous conversions.
+Project-URL: Homepage, https://github.com/troxel/w1-therm-api
+Project-URL: Bug-Tracker, https://github.com/issues
+Author-email: Steven Troxel <troxel@perlworks.com>
+License: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# w1-therm-api
+
+A Python script to support the Linux `w1_therm` kernel driver. It discovers
+multiple 1-Wire buses, 1wire temperature sensors, triggers simultaneous conversions on supported buses, and returns temperatures in Fahrenheit by default.
+
+The package reads the driver's sysfs interface directly and has no runtime
+dependencies.
+
+## Requirements
+
+- Linux with the kernel `w1_therm` driver loaded.
+- Read/write access to `/sys/bus/w1/devices` (or an alternate sysfs root).
+- Python 3.7 or later.
+
+`W1Bus` recognizes the common `w1_therm` temperature families: `28-`, `10-`,
+`22-`, and `3b-`.
+
+## Install
+
+```bash
+python -m pip install w1-therm-api
+```
+
+## Usage
+
+```python
+from w1_therm_api import W1Bus
+
+bus = W1Bus()
+
+# Send Convert T to each master that exposes therm_bulk_read, then wait for
+# the driver's cached results to become available.
+if bus.convert():
+	for sensor_id, temperature_f in bus.read_temperatures():
+		if temperature_f is None:
+			print(f"{sensor_id}: unavailable")
+		else:
+			print(f"{sensor_id}: {temperature_f:.2f} F")
+```
+
+To receive Celsius values, select it when creating the bus:
+
+```python
+bus = W1Bus(unit="C")
+```
+
+Sensors are discovered when `W1Bus` is created. To ask each master to search
+for new devices and refresh that list:
+
+```python
+bus.rescan()
+print(bus.sensors)
+```
+
+For systems without `therm_bulk_read`, individual reads still work:
+
+```python
+for sensor_id, temperature_f in bus.read_temperatures():
+	print(sensor_id, temperature_f)
+```
+
+## How It Uses `w1_therm`
+
+When available, `convert()` writes `trigger` to each master's
+`therm_bulk_read` entry. It then polls until the driver reports that the
+conversion result is ready before reading every sensor's `temperature` entry.
+This lets devices on a bus convert in parallel, including parasite-powered
+devices when the driver and adapter support a strong pullup.
+
+`read_temperature()` first reads the cached `temperature` value. If that file
+is missing, empty, invalid, or reports the DS18x20 power-on value of 85 C, it
+falls back to `w1_slave` and validates its CRC status. Failed reads and
+power-on values are returned as `(sensor_id, None)`; valid values are returned
+as `(sensor_id, temperature_f)`.
+
+The underlying sysfs entries and their behavior are documented in the Linux
+kernel's `w1_therm` driver ABI. This package does not configure resolution,
+EEPROM, alarm, power, or driver feature settings.
+
+## API
+
+```python
+W1Bus(
+	devices_dir="/sys/bus/w1/devices",
+	known_families=("28-", "10-", "22-", "3b-"),
+	unit="F",
+)
+```
+
+- `find_masters()` returns discovered `w1_bus_master*` directories.
+- `find_sensors()` returns recognized sensor directories.
+- `rescan(timeout=2.0)` requests a bus search and refreshes `sensors`.
+- `start_conversion()` triggers bulk conversion and returns whether any master was triggered.
+- `wait_for_conversion(timeout=2.0)` waits for all triggered bulk conversions.
+- `convert(timeout=2.0)` performs both steps.
+- `read_temperature(sensor_path)` returns `(sensor_id, temperature_f | None)`.
+- `read_temperatures()` reads every currently discovered sensor.
+- `unit` accepts `"F"` (default) or `"C"`; unit names are case-insensitive.
+
+## License
+
+MIT.

w1_therm_api-0.1.0/README.md

@@ -0,0 +1,102 @@
+# w1-therm-api
+
+A Python script to support the Linux `w1_therm` kernel driver. It discovers
+multiple 1-Wire buses, 1wire temperature sensors, triggers simultaneous conversions on supported buses, and returns temperatures in Fahrenheit by default.
+
+The package reads the driver's sysfs interface directly and has no runtime
+dependencies.
+
+## Requirements
+
+- Linux with the kernel `w1_therm` driver loaded.
+- Read/write access to `/sys/bus/w1/devices` (or an alternate sysfs root).
+- Python 3.7 or later.
+
+`W1Bus` recognizes the common `w1_therm` temperature families: `28-`, `10-`,
+`22-`, and `3b-`.
+
+## Install
+
+```bash
+python -m pip install w1-therm-api
+```
+
+## Usage
+
+```python
+from w1_therm_api import W1Bus
+
+bus = W1Bus()
+
+# Send Convert T to each master that exposes therm_bulk_read, then wait for
+# the driver's cached results to become available.
+if bus.convert():
+	for sensor_id, temperature_f in bus.read_temperatures():
+		if temperature_f is None:
+			print(f"{sensor_id}: unavailable")
+		else:
+			print(f"{sensor_id}: {temperature_f:.2f} F")
+```
+
+To receive Celsius values, select it when creating the bus:
+
+```python
+bus = W1Bus(unit="C")
+```
+
+Sensors are discovered when `W1Bus` is created. To ask each master to search
+for new devices and refresh that list:
+
+```python
+bus.rescan()
+print(bus.sensors)
+```
+
+For systems without `therm_bulk_read`, individual reads still work:
+
+```python
+for sensor_id, temperature_f in bus.read_temperatures():
+	print(sensor_id, temperature_f)
+```
+
+## How It Uses `w1_therm`
+
+When available, `convert()` writes `trigger` to each master's
+`therm_bulk_read` entry. It then polls until the driver reports that the
+conversion result is ready before reading every sensor's `temperature` entry.
+This lets devices on a bus convert in parallel, including parasite-powered
+devices when the driver and adapter support a strong pullup.
+
+`read_temperature()` first reads the cached `temperature` value. If that file
+is missing, empty, invalid, or reports the DS18x20 power-on value of 85 C, it
+falls back to `w1_slave` and validates its CRC status. Failed reads and
+power-on values are returned as `(sensor_id, None)`; valid values are returned
+as `(sensor_id, temperature_f)`.
+
+The underlying sysfs entries and their behavior are documented in the Linux
+kernel's `w1_therm` driver ABI. This package does not configure resolution,
+EEPROM, alarm, power, or driver feature settings.
+
+## API
+
+```python
+W1Bus(
+	devices_dir="/sys/bus/w1/devices",
+	known_families=("28-", "10-", "22-", "3b-"),
+	unit="F",
+)
+```
+
+- `find_masters()` returns discovered `w1_bus_master*` directories.
+- `find_sensors()` returns recognized sensor directories.
+- `rescan(timeout=2.0)` requests a bus search and refreshes `sensors`.
+- `start_conversion()` triggers bulk conversion and returns whether any master was triggered.
+- `wait_for_conversion(timeout=2.0)` waits for all triggered bulk conversions.
+- `convert(timeout=2.0)` performs both steps.
+- `read_temperature(sensor_path)` returns `(sensor_id, temperature_f | None)`.
+- `read_temperatures()` reads every currently discovered sensor.
+- `unit` accepts `"F"` (default) or `"C"`; unit names are case-insensitive.
+
+## License
+
+MIT.

w1_therm_api-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "w1-therm-api"
+version = "0.1.0"
+description = "A fast Python API wrapper for the Linux w1_therm kernel driver supporting simultaneous conversions."
+readme = "README.md"
+requires-python = ">=3.7"
+license = { text = "MIT" }
+authors = [
+    { name = "Steven Troxel", email = "troxel@perlworks.com" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Topic :: System :: Hardware :: Hardware Drivers",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/troxel/w1-therm-api"
+Bug-Tracker = "https://github.com/issues"
+

w1_therm_api-0.1.0/src/w1_therm_api/__init__.py

@@ -0,0 +1,5 @@
+from .api import W1_DEVICES_DIR, W1Bus
+
+__version__ = "0.1.0"
+__all__ = ["W1_DEVICES_DIR", "W1Bus"]
+

w1_therm_api-0.1.0/src/w1_therm_api/api.py

@@ -0,0 +1,171 @@
+import glob
+import os
+import re
+import time
+
+W1_DEVICES_DIR = "/sys/bus/w1/devices"
+KNOWN_FAMILIES = ("28-", "10-", "22-", "3b-")
+POWER_ON_RESET_MDEG_C = 85000
+
+def mdeg_to_f(mdeg_c: int) -> float:
+    return (mdeg_c / 1000.0) * 9.0 / 5.0 + 32.0
+
+class W1Bus:
+    """Discover, convert, and read sensors on Linux 1-Wire masters using the w1_therm interface."""
+
+    def __init__(
+        self,
+        devices_dir: str = W1_DEVICES_DIR,
+        known_families: tuple[str, ...] = KNOWN_FAMILIES,
+        unit: str = "F",
+    ) -> None:
+        unit = unit.upper()
+        if unit not in ("C", "F"):
+            raise ValueError("unit must be 'C' or 'F'")
+        self.devices_dir = devices_dir
+        self.known_families = known_families
+        self.unit = unit
+        self.masters = self.find_masters()
+        self.sensors = self.find_sensors()
+
+    def find_masters(self) -> list[str]:
+        """Find all 1-Wire master buses."""
+        return glob.glob(os.path.join(self.devices_dir, "w1_bus_master*"))
+
+    def find_sensors(self) -> list[str]:
+        """Find all currently registered temperature sensor devices."""
+        if not os.path.exists(self.devices_dir):
+            return []
+        return sorted(
+            os.path.join(self.devices_dir, entry)
+            for entry in os.listdir(self.devices_dir)
+            if any(entry.startswith(prefix) for prefix in self.known_families)
+        )
+
+    def rescan(self, timeout: float = 2.0) -> None:
+        """Force masters to add new sensors and remove unresponsive ones."""
+        search_files = []
+        for master in self.masters:
+            search_file = os.path.join(master, "w1_master_search")
+            if not os.path.exists(search_file):
+                continue
+            try:
+                with open(search_file, "w") as file:
+                    file.write("1")
+                search_files.append(search_file)
+            except OSError as error:
+                print(f"Warning: failed to trigger bus search on {master}: {error}")
+
+        deadline = time.monotonic() + timeout
+        pending = search_files
+        while pending and time.monotonic() < deadline:
+            remaining = []
+            for search_file in pending:
+                try:
+                    with open(search_file) as file:
+                        count = file.read().strip()
+                except OSError:
+                    continue
+                if count != "0":
+                    remaining.append(search_file)
+            if remaining:
+                time.sleep(0.05)
+            pending = remaining
+
+        self.sensors = self.find_sensors()
+
+    def start_conversion(self) -> bool:
+        """Start one simultaneous Convert T on each supported master."""
+        triggered = False
+        for bulk_file in self._bulk_files():
+            try:
+                with open(bulk_file, "w") as file:
+                    file.write("trigger\n")
+                triggered = True
+            except OSError as error:
+                print(f"Warning: failed to trigger bulk conversion: {error}")
+        return triggered
+
+    def wait_for_conversion(self, timeout: float = 2.0) -> bool:
+        """Wait until every supported master has a cached result ready."""
+        deadline = time.monotonic() + timeout
+        pending = self._bulk_files()
+
+        while pending and time.monotonic() < deadline:
+            remaining = []
+            for bulk_file in pending:
+                try:
+                    with open(bulk_file) as file:
+                        state = file.read().strip()
+                except OSError:
+                    return False
+                if state == "1":
+                    continue
+                if state == "-1":
+                    remaining.append(bulk_file)
+                    continue
+                return False
+            if remaining:
+                time.sleep(0.005)
+            pending = remaining
+
+        return not pending
+
+    def convert(self, timeout: float = 2.0) -> bool:
+        """Start conversion and wait to finish a bulk temperature conversion."""
+        return self.start_conversion() and self.wait_for_conversion(timeout)
+
+    def read_temperature(self, sensor_path: str) -> tuple[str, float | None]:
+
+        """Read one cached temperature in the configured unit."""
+        sensor_id = os.path.basename(sensor_path)
+        temp_file = os.path.join(sensor_path, "temperature")
+        if os.path.exists(temp_file):
+            try:
+                with open(temp_file) as file:
+                    temp_mdeg_c = int(file.read().strip())
+                if temp_mdeg_c != POWER_ON_RESET_MDEG_C:
+                    return sensor_id, self._convert_temperature(temp_mdeg_c)
+            except (OSError, ValueError):
+                pass
+        # Fallback to parsing the w1_slave file if the temperature file is not available or invalid.
+        return self.parse_w1_slave(sensor_path)
+
+    def read_temperatures(self) -> list[tuple[str, float | None]]:
+        """Read all currently registered sensor temperatures."""
+        return [self.read_temperature(sensor) for sensor in self.sensors]
+
+    def _bulk_files(self) -> list[str]:
+        return [
+            bulk_file
+            for bulk_file in (
+                os.path.join(master, "therm_bulk_read") for master in self.masters
+            )
+            if os.path.exists(bulk_file)
+        ]
+
+    def _convert_temperature(self, mdeg_c: int) -> float:
+        if self.unit == "C":
+            return mdeg_c / 1000.0
+        return mdeg_to_f(mdeg_c)
+
+    def parse_w1_slave(self, sensor_path: str) -> tuple[str, float | None]:
+        sensor_id = os.path.basename(sensor_path)
+        slave_file = os.path.join(sensor_path, "w1_slave")
+        if not os.path.exists(slave_file):
+            return sensor_id, None
+
+        try:
+            with open(slave_file) as file:
+                lines = file.readlines()
+            if len(lines) < 2 or "YES" not in lines[0]:
+                return sensor_id, None
+            match = re.search(r"t=(-?\d+)", lines[1])
+            if match is None:
+                return sensor_id, None
+            temp_mdeg_c = int(match.group(1))
+            if temp_mdeg_c == POWER_ON_RESET_MDEG_C:
+                return sensor_id, None
+            return sensor_id, self._convert_temperature(temp_mdeg_c)
+        except (OSError, ValueError):
+            return sensor_id, None

w1_therm_api-0.1.0/src/w1_therm_api/w1_therm_proto.txt

@@ -0,0 +1,35 @@
+Support is provided through the sysfs entry w1_slave. Each open and read sequence will initiate a temperature conversion, then provide two lines of ASCII output. The first line contains the nine hex bytes read along with a calculated crc value and YES or NO if it matched. If the crc matched the returned values are retained. The second line displays the retained values along with a temperature in millidegrees Centigrade after t=.
+
+Alternatively, temperature can be read using temperature sysfs, it returns only the temperature in millidegrees Centigrade.
+
+A bulk read of all devices on the bus could be done writing trigger to therm_bulk_read entry at w1_bus_master level. This will send the convert command to all devices on the bus, and if parasite powered devices are detected on the bus (and strong pullup is enabled in the module), it will drive the line high during the longer conversion time required by parasited powered device on the line. Reading therm_bulk_read will return 0 if no bulk conversion pending, -1 if at least one sensor still in conversion, 1 if conversion is complete but at least one sensor value has not been read yet. Result temperature is then accessed by reading the temperature entry of each device, which may return empty if conversion is still in progress. Note that if a bulk read is sent but one sensor is not read immediately, the next access to temperature on this device will return the temperature measured at the time of issue of the bulk read command (not the current temperature).
+
+A strong pullup will be applied during the conversion if required.
+
+conv_time is used to get current conversion time (read), and adjust it (write). A temperature conversion time depends on the device type and its current resolution. Default conversion time is set by the driver according to the device datasheet. A conversion time for many original device clones deviate from datasheet specs. There are three options: 1) manually set the correct conversion time by writing a value in milliseconds to conv_time; 2) auto measure and set a conversion time by writing 1 to conv_time; 3) use features to enable poll for conversion completion. Options 2, 3 can’t be used in parasite power mode. To get back to the default conversion time write 0 to conv_time.
+
+Writing a resolution value (in bits) to w1_slave will change the precision of the sensor for the next readings. Allowed resolutions are defined by the sensor. Resolution is reset when the sensor gets power-cycled.
+
+To store the current resolution in EEPROM, write 0 to w1_slave. Since the EEPROM has a limited amount of writes (>50k), this command should be used wisely.
+
+Alternatively, resolution can be read or written using the dedicated resolution entry on each device, if supported by the sensor.
+
+Some non-genuine DS18B20 chips are fixed in 12-bit mode only, so the actual resolution is read back from the chip and verified.
+
+Note: Changing the resolution reverts the conversion time to default.
+
+The write-only sysfs entry eeprom_cmd is an alternative for EEPROM operations. Write save to save device RAM to EEPROM. Write restore to restore EEPROM data in device RAM.
+
+ext_power entry allows checking the power state of each device. Reads 0 if the device is parasite powered, 1 if the device is externally powered.
+
+Sysfs alarms allow read or write TH and TL (Temperature High an Low) alarms. Values shall be space separated and in the device range (typical -55 degC to 125 degC). Values are integer as they are store in a 8bit register in the device. Lowest value is automatically put to TL. Once set, alarms could be search at master level.
+
+The module parameter strong_pullup can be set to 0 to disable the strong pullup, 1 to enable autodetection or 2 to force strong pullup. In case of autodetection, the driver will use the “READ POWER SUPPLY” command to check if there are pariste powered devices on the bus. If so, it will activate the master’s strong pullup. In case the detection of parasite devices using this command fails (seems to be the case with some DS18S20) the strong pullup can be force-enabled.
+
+If the strong pullup is enabled, the master’s strong pullup will be driven when the conversion is taking place, provided the master driver does support the strong pullup (or it falls back to a pullup resistor). The DS18b20 temperature sensor specification lists a maximum current draw of 1.5mA and that a 5k pullup resistor is not sufficient. The strong pullup is designed to provide the additional current required.
+
+The DS28EA00 provides an additional two pins for implementing a sequence detection algorithm. This feature allows you to determine the physical location of the chip in the 1-wire bus without needing pre-existing knowledge of the bus ordering. Support is provided through the sysfs w1_seq. The file will contain a single line with an integer value representing the device index in the bus starting at 0.
+
+features sysfs entry controls optional driver settings per device. Insufficient power in parasite mode, line noise and insufficient conversion time may lead to conversion failure. Original DS18B20 and some clones allow for detection of invalid conversion. Write bit mask 1 to features to enable checking the conversion success. If byte 6 of scratchpad memory is 0xC after conversion and temperature reads 85.00 (powerup value) or 127.94 (insufficient power), the driver returns a conversion error. Bit mask 2 enables poll for conversion completion (normal power only) by generating read cycles on the bus after conversion starts. In parasite power mode this feature is not available. Feature bit masks may be combined (OR). More details in ABI file testing/sysfs-driver-w1_therm
+
+GX20MH01 device shares family number 0x28 with DS18*20. The device is generally compatible with DS18B20. Added are lowest 2-5, 2-6 temperature bits in Config register; R2 bit in Config register enabling 13 and 14 bit resolutions. The device is powered up in 14-bit resolution mode. The conversion times specified in the datasheet are too low and have to be increased. The device supports driver features 1 and 2.