adafruit-circuitpython-mlx90393 2.0.16__tar.gz → 2.1.1__tar.gz

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/.github/workflows/release_gh.yml

@@ -16,3 +16,4 @@ jobs:
       uses: adafruit/workflows-circuitpython-libs/release-gh@main
       with:
         github-token: ${{ secrets.GITHUB_TOKEN }}
+        upload-url: ${{ github.event.release.upload_url }}

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/.gitignore

@@ -37,6 +37,7 @@ _build
 
 # Virtual environment-specific files
 .env
+.venv
 
 # MacOS-specific files
 *.DS_Store

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/.pre-commit-config.yaml

@@ -4,21 +4,21 @@
 
 repos:
   - repo: https://github.com/python/black
-    rev: 22.3.0
+    rev: 23.3.0
     hooks:
       - id: black
   - repo: https://github.com/fsfe/reuse-tool
-    rev: v0.14.0
+    rev: v1.1.2
     hooks:
       - id: reuse
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.2.0
+    rev: v4.4.0
     hooks:
       - id: check-yaml
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/pycqa/pylint
-    rev: v2.15.5
+    rev: v2.17.4
     hooks:
       - id: pylint
         name: pylint (library code)

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/.pylintrc

@@ -396,4 +396,4 @@ min-public-methods=1
 
 # Exceptions that will emit a warning when being caught. Defaults to
 # "Exception"
-overgeneral-exceptions=Exception
+overgeneral-exceptions=builtins.Exception

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: adafruit-circuitpython-mlx90393
-Version: 2.0.16
+Version: 2.1.1
 Summary: CircuitPython driver for the MLX90393 3-axis magnetometer.
 Author-email: Adafruit Industries <circuitpython@adafruit.com>
 License: MIT

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/adafruit_circuitpython_mlx90393.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: adafruit-circuitpython-mlx90393
-Version: 2.0.16
+Version: 2.1.1
 Summary: CircuitPython driver for the MLX90393 3-axis magnetometer.
 Author-email: Adafruit Industries <circuitpython@adafruit.com>
 License: MIT

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/adafruit_circuitpython_mlx90393.egg-info/SOURCES.txt

@@ -33,4 +33,5 @@ docs/index.rst.license
 docs/requirements.txt
 docs/_static/favicon.ico
 docs/_static/favicon.ico.license
-examples/mlx90393_simpletest.py
+examples/mlx90393_simpletest.py
+examples/mlx90393_temperature.py

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/adafruit_mlx90393.py

@@ -41,7 +41,7 @@ try:
 except ImportError:
     pass
 
-__version__ = "2.0.16"
+__version__ = "2.1.1"
 __repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_MLX90393.git"
 
 _CMD_SB = const(0b00010000)  # Start burst mode
@@ -57,6 +57,7 @@ _CMD_RT = const(0b11110000)  # Reset
 _CMD_NOP = const(0x00)  # NOP
 
 _CMD_AXIS_ALL = const(0xE)  # X+Y+Z axis bits for commands
+_CMD_TEMP = const(0x01)  # Temperature bit for commands
 
 _CMD_REG_CONF1 = const(0x00)  # Gain
 _CMD_REG_CONF2 = const(0x01)  # Burst, comm mode
@@ -518,3 +519,34 @@ class MLX90393:  # pylint: disable=too-many-instance-attributes
         z *= _LSB_LOOKUP[hallconf_index][self._gain_current][self._res_z][1]
 
         return x, y, z
+
+    @property
+    def temperature(self) -> float:
+        """
+        Reads a single temperature sample from the magnetometer.
+        Temperature value in Celsius
+        """
+        # Read the temperature reference from register 0x24
+        treference = self.read_reg(0x24)
+
+        # Value taken from maximum time of temperature conversion on the datasheet section 12.
+        # maximum time for temperature conversion = 1603 us
+        delay = 0.1
+
+        # Set the device to single measurement mode
+        self._transceive(bytes([_CMD_SM | _CMD_TEMP]))
+
+        time.sleep(delay)
+
+        # Read the 'temp' data
+        data = self._transceive(bytes([_CMD_RM | _CMD_TEMP]), 2)
+
+        # Unpack status and raw int values
+        self._status_last = data[0]
+
+        # from https://www.melexis.com/-/media/files/documents/
+        # application-notes/mlx90393-temperature-compensation-application-note-melexis.pdf
+        tvalue = struct.unpack(">H", data[1:3])[0]
+        # See previous link for conversion formula
+
+        return 35 + ((tvalue - treference) / 45.2)

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/docs/conf.py

@@ -17,6 +17,7 @@ sys.path.insert(0, os.path.abspath(".."))
 # ones.
 extensions = [
     "sphinx.ext.autodoc",
+    "sphinxcontrib.jquery",
     "sphinx.ext.intersphinx",
     "sphinx.ext.napoleon",
     "sphinx.ext.todo",

adafruit-circuitpython-mlx90393-2.1.1/docs/examples.rst

@@ -0,0 +1,17 @@
+Simple test
+------------
+
+Ensure your device works with this simple test.
+
+.. literalinclude:: ../examples/mlx90393_simpletest.py
+    :caption: examples/mlx90393_simpletest.py
+    :linenos:
+
+Temperature test
+-----------------
+
+Example showing how to measure temperature with the sensor
+
+.. literalinclude:: ../examples/mlx90393_temperature.py
+    :caption: examples/mlx90393_temperature.py
+    :linenos:

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/docs/requirements.txt

@@ -3,3 +3,4 @@
 # SPDX-License-Identifier: Unlicense
 
 sphinx>=4.0.0
+sphinxcontrib-jquery

adafruit-circuitpython-mlx90393-2.1.1/examples/mlx90393_temperature.py

@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: 2023 Jose D. Montoya
+# SPDX-License-Identifier: MIT
+
+import time
+import board
+import adafruit_mlx90393
+
+i2c = board.I2C()  # uses board.SCL and board.SDA
+# i2c = board.STEMMA_I2C()  # For using the built-in STEMMA QT connector on a microcontroller
+SENSOR = adafruit_mlx90393.MLX90393(i2c, gain=adafruit_mlx90393.GAIN_1X)
+
+
+while True:
+    temp = SENSOR.temperature
+
+    print("Temperature: {} °C".format(temp))
+
+    # Display the status field if an error occurred, etc.
+    if SENSOR.last_status > adafruit_mlx90393.STATUS_OK:
+        SENSOR.display_status()
+    time.sleep(1.0)

{adafruit-circuitpython-mlx90393-2.0.16 → adafruit-circuitpython-mlx90393-2.1.1}/pyproject.toml

@@ -12,7 +12,7 @@ requires = [
 [project]
 name = "adafruit-circuitpython-mlx90393"
 description = "CircuitPython driver for the MLX90393 3-axis magnetometer."
-version = "2.0.16"
+version = "2.1.1"
 readme = "README.rst"
 authors = [
     {name = "Adafruit Industries", email = "circuitpython@adafruit.com"}

adafruit-circuitpython-mlx90393-2.0.16/docs/examples.rst

@@ -1,8 +0,0 @@
-Simple test
-------------
-
-Ensure your device works with this simple test.
-
-.. literalinclude:: ../examples/mlx90393_simpletest.py
-    :caption: examples/mlx90393_simpletest.py
-    :linenos: