dspp-reader 0.1.2__tar.gz

dspp_reader-0.1.2/.github/workflows/python-publish.yml

@@ -0,0 +1,70 @@
+# This workflow will upload a Python Package to PyPI when a release is created
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries
+
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Upload Python Package
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  release-build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Build release distributions
+        run: |
+          # NOTE: put your own distribution build steps here.
+          python -m pip install build
+          python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+  pypi-publish:
+    runs-on: ubuntu-latest
+    needs:
+      - release-build
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing
+      id-token: write
+
+    # Dedicated environments with protections for publishing are strongly recommended.
+    # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules
+    environment:
+      name: pypi
+      # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status:
+      # url: https://pypi.org/p/YOURPROJECT
+      #
+      # ALTERNATIVE: if your GitHub Release name is the PyPI project version string
+      # ALTERNATIVE: exactly, uncomment the following line instead:
+      # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }}
+
+    steps:
+      - name: Retrieve release distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: Publish release distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

dspp_reader-0.1.2/.gitignore

@@ -0,0 +1,2 @@
+/docs/build/
+dspp_reader/version.py

dspp_reader-0.1.2/.readthedocs.yaml

@@ -0,0 +1,25 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version, and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+   configuration: docs/source/conf.py
+
+# Optionally, but recommended,
+# declare the Python requirements required to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+   install:
+   - requirements: requirements.txt
+   - method: pip
+     path: .
+        

dspp_reader-0.1.2/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, NOIRLab
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

dspp_reader-0.1.2/PKG-INFO

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: dspp_reader
+Version: 0.1.2
+Summary: Software for reading SQMs and TESS-W4C devices, used for measuring sky brightness.
+Author-email: Simón Torres <simon.torres@noirlab.edu>, Guillermo Damke <guillermo.damke@noirlab.edu>
+Maintainer-email: Simón Torres <simon.torres@noirlab.edu>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://dspp-reader.readthedocs.io/en/latest/
+Project-URL: Bug Reports, https://github.com/dark-sky-protection/dspp_reader/issues
+Project-URL: Source, https://github.com/dark-sky-protection/dspp_reader
+Keywords: sqm,sqm-le,tess-4c,sky,darkness,astronomy
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: POSIX :: Other
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: astropy
+Requires-Dist: astroplan
+Requires-Dist: packaging
+Requires-Dist: requests
+Requires-Dist: sphinx
+Requires-Dist: sphinxcontrib-napoleon
+Requires-Dist: pydata-sphinx-theme
+Requires-Dist: pyyaml
+Requires-Dist: tzlocal
+Dynamic: license-file
+
+# Dark Sky Protection Photometers Reader
+
+[![Upload Python Package](https://github.com/dark-sky-protection/dspp_reader/actions/workflows/python-publish.yml/badge.svg)](https://github.com/dark-sky-protection/dspp_reader/actions/workflows/python-publish.yml)
+[![Documentation Status](https://readthedocs.org/projects/dspp-reader/badge/?version=latest)](https://dspp-reader.readthedocs.io/en/latest/?badge=latest)

dspp_reader-0.1.2/README.md

@@ -0,0 +1,4 @@
+# Dark Sky Protection Photometers Reader
+
+[![Upload Python Package](https://github.com/dark-sky-protection/dspp_reader/actions/workflows/python-publish.yml/badge.svg)](https://github.com/dark-sky-protection/dspp_reader/actions/workflows/python-publish.yml)
+[![Documentation Status](https://readthedocs.org/projects/dspp-reader/badge/?version=latest)](https://dspp-reader.readthedocs.io/en/latest/?badge=latest)

dspp_reader-0.1.2/docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = source
+BUILDDIR      = build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

dspp_reader-0.1.2/docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=source
+set BUILDDIR=build
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.https://www.sphinx-doc.org/
+	exit /b 1
+)
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

dspp_reader-0.1.2/docs/source/conf.py

@@ -0,0 +1,37 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version('dspp_reader')
+except PackageNotFoundError:
+    __version__ = '0.0.0'
+
+version = '.'.join(__version__.split('.')[:2])
+release = __version__
+project = 'Dark Sky Protection Photometers Reader'
+copyright = '2025, NOIRLab'
+author = 'Simón Torres, Guillermo Damke'
+license = 'bsd3'
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = []
+
+templates_path = ['_templates']
+exclude_patterns = []
+
+
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = 'pydata_sphinx_theme'
+html_static_path = ['_static']
+html_static_path = ['_static']

dspp_reader-0.1.2/docs/source/index.rst

@@ -0,0 +1,16 @@
+.. Dark Sky Protection Project Reader documentation master file, created by
+   sphinx-quickstart on Thu Nov 20 14:55:08 2025.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Dark Sky Protection Photometers Reader documentation
+====================================================
+
+Add your content using ``reStructuredText`` syntax. See the
+`reStructuredText <https://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html>`_
+documentation for details.
+
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:

dspp_reader-0.1.2/dspp_reader/sqmle/scripts.py

@@ -0,0 +1,87 @@
+import logging
+import os
+import sys
+
+from importlib.metadata import version
+
+import yaml
+
+from dspp_reader.sqmle.sqmle import SQMLE
+from dspp_reader.tools import get_args, setup_logging
+
+__version__ = version("dspp-reader")
+
+CONFIG_FIELDS = [
+    "site_id",
+    "site_name",
+    "site_latitude",
+    "site_longitude",
+    "site_elevation",
+    "site_timezone",
+    "device_type",
+    "device_id",
+    "device_altitude",
+    "device_azimuth",
+    "device_ip",
+    "device_port",
+    "device_window_correction",
+    "number_of_reads",
+    "reads_frequency",
+    "save_to_file",
+    "save_to_database",
+    "post_to_api",
+    "save_files_to",
+    "file_format",
+]
+
+
+def read_sqmle(args=None):
+    args = get_args(args=args, has_upd=False, default_device_type='sqmle')
+
+    site = {}
+    if args.config_file and os.path.isfile(args.config_file):
+        with open(args.config_file, "r") as f:
+            site = yaml.safe_load(f) or {}
+
+    config = {}
+    for field in CONFIG_FIELDS:
+        config[field] = site.get(field, getattr(args, field))
+
+    if args.config_file_example:
+        print("# Add this to a .yaml file, reference it later with --config-file <file_name>.yaml")
+        print(yaml.dump(config, default_flow_style=False, sort_keys=False))
+        sys.exit(0)
+
+    setup_logging(debug=args.debug, device_type=config["device_type"], device_id=config["device_id"])
+    logger = logging.getLogger()
+    logger.info(f"Starting SQMLE reader, Version: {__version__}")
+
+    try:
+        sqmle = SQMLE(
+            site_id=config["site_id"],
+            site_name=config["site_name"],
+            site_latitude=config["site_latitude"],
+            site_longitude=config["site_longitude"],
+            site_elevation=config["site_elevation"],
+            site_timezone=config["site_timezone"],
+            device_type=config["device_type"],
+            device_id=config["device_id"],
+            device_altitude=config["device_altitude"],
+            device_azimuth=config["device_azimuth"],
+            device_ip=config["device_ip"],
+            device_port=config["device_port"],
+            device_window_correction=config["device_window_correction"],
+            number_of_reads=config["number_of_reads"],
+            reads_frequency=config["reads_frequency"],
+            save_to_file=config["save_to_file"],
+            save_to_database=config["save_to_database"],
+            post_to_api=config["post_to_api"],
+            save_files_to=config["save_files_to"],
+            file_format=config["file_format"]
+        )
+
+        sqmle()
+    except KeyboardInterrupt:
+        print("\n")
+        logger.info(f"Exiting SQMLE reader on user request, Version: {__version__}")
+        sys.exit(0)

dspp_reader-0.1.2/dspp_reader/sqmle/sqmle.py

@@ -0,0 +1,297 @@
+import astropy.units as u
+import datetime
+import os
+import re
+import socket
+import logging
+import sys
+
+from astropy.units import Quantity
+from pathlib import Path
+from time import sleep
+from zoneinfo import ZoneInfo
+
+from dspp_reader.tools import Device, Site
+from dspp_reader.tools.generics import augment_data, get_filename
+
+logger = logging.getLogger()
+
+READ = b'rx\r\n'
+READ_WITH_SERIAL_NUMBER = b'Rx\r\n'
+REQUEST_CALIBRATION_INFORMATION = b'cx\r\n'
+UNIT_INFORMATION_REQUEST = b'ix\r\n'
+
+
+class SQMLE(object):
+    def __init__(self,
+                 site_id: str = '',
+                 site_name: str = '',
+                 site_timezone: str = '',
+                 site_latitude: str = '',
+                 site_longitude: str = '',
+                 site_elevation: str = '',
+                 device_type:str = 'sqmle',
+                 device_id:str = None,
+                 device_altitude:float = None,
+                 device_azimuth:float = None,
+                 device_ip:str = None,
+                 device_port=10001,
+                 device_window_correction:float = 0,
+                 number_of_reads=3,
+                 reads_frequency=30,
+                 save_to_file=True,
+                 save_to_database=False,
+                 post_to_api=False,
+                 save_files_to: Path = os.getcwd(),
+                 file_format: str = "tsv",):
+        self.site_id = site_id
+        self.site_name = site_name
+        self.site_timezone = site_timezone
+        self.site_latitude = site_latitude
+        self.site_longitude = site_longitude
+        self.site_elevation = site_elevation
+        self.device_type = device_type
+        self.device_id = device_id
+        self.device_port = device_port
+        self.device_altitude = device_altitude
+        self.device_azimuth = device_azimuth
+        self.device_ip = device_ip
+        self.device_window_correction = device_window_correction
+
+        self.number_of_reads = number_of_reads
+        self.reads_frequency = reads_frequency
+        self.save_to_file = save_to_file
+        self.save_to_database = save_to_database
+        self.post_to_api = post_to_api
+        self.save_files_to = Path(save_files_to)
+        self.file_format = file_format
+        self.separator = ''
+        if self.file_format == "tsv":
+            self.separator = "\t"
+        elif self.file_format == "csv":
+            self.separator = ","
+        elif self.file_format == "txt":
+            self.separator = " "
+        else:
+            self.separator = " "
+
+        self.site = None
+        if all([self.site_id, self.site_name, self.site_timezone, self.site_latitude, self.site_longitude, self.site_elevation]):
+            self.site = Site(
+                id=self.site_id,
+                name=self.site_name,
+                latitude=self.site_latitude,
+                longitude=self.site_longitude,
+                elevation=self.site_elevation,
+                timezone=self.site_timezone)
+        else:
+            logger.error(f"Not enough site info provided: Please provide: site_id, site_name, site_timezone, site_latitude, site_longitude, site_elevation")
+
+        self.device = None
+        if all([self.device_type, self.device_id, self.device_port, self.device_altitude, self.device_azimuth, self.device_ip, self.device_port]):
+            self.device = Device(
+                serial_id=self.device_id,
+                type=self.device_type,
+                altitude=self.device_altitude,
+                azimuth=self.device_azimuth,
+                window_correction=self.device_window_correction,
+                site=self.site,
+                ip=self.device_ip,
+                port=self.device_port,
+            )
+        else:
+            logger.error("Not enough information to define device")
+
+        self.socket = None
+        if self.device:
+            while not self.socket:
+                try:
+                    logger.debug(f"Creating socket connection for {self.device.type} {self.device.serial_id}")
+                    self.socket = socket.create_connection((self.device.ip, self.device.port), timeout=5)
+                    logger.info(f"Created socket connection for {self.device.type} {self.device.serial_id}")
+                except OSError as e:
+                    timeout = 20
+                    print(
+                        f"\r{datetime.datetime.now().astimezone()}: Unable to connect to {self.device.serial_id} at {self.device.ip}:{self.device.port}: {e}")
+                    for i in range(1, timeout + 1, 1):
+                        print(f"\rAttempting again in {timeout - i} seconds...", end="", flush=True)
+                        sleep(1)
+        else:
+            logger.error(f"A device is needed to be able to continue")
+            logger.info(f"Use the argument  --help for more information")
+            sys.exit(1)
+
+        if self.save_to_file:
+            if not os.path.exists(self.save_files_to):
+                try:
+                    os.makedirs(self.save_files_to)
+                    logger.info(f"Created directory {self.save_files_to}")
+                except OSError:
+                    logger.error(f"Could not create directory {self.save_files_to}")
+                    sys.exit(1)
+            logger.info(f"Data will be saved to {self.save_files_to}")
+
+    def __call__(self):
+        try:
+            while True:
+                if self.device and self.socket:
+                    if self.device.site:
+                        next_period_start, next_period_end, time_to_next_start, time_to_next_end = self.device.site.get_time_range()
+                        if time_to_next_end > time_to_next_start:
+                            logger.debug(
+                                f"Next Sunset is at {next_period_start.strftime('%Y-%m-%d %H:%M:%S %Z (UTC%z)')}")
+                            hours = int(time_to_next_start.sec // 3600)
+                            minutes = int((time_to_next_start.sec % 3600) // 60)
+                            seconds = int(time_to_next_start.sec % 60)
+
+                            try:
+                                self._send_command(command=UNIT_INFORMATION_REQUEST, sock=self.socket)
+                                message = f"Waiting for {hours:02d} hours {minutes:02d} minutes {seconds:02d} seconds until next sunset {next_period_start.to_datetime(timezone=ZoneInfo(self.device.site.timezone)).strftime('%Y-%m-%d %H:%M:%S')} {self.device.site.timezone} "
+                                if logger.getEffectiveLevel() == logging.DEBUG:
+                                    logger.debug(message)
+                                else:
+                                    print(f"\r{message}", end="", flush=True)
+                            except OSError as e:
+                                error_message = f"Socket error: {e}. The device may be unavailable."
+                                if logger.getEffectiveLevel() == logging.DEBUG:
+                                    logger.debug(error_message)
+                                else:
+                                    print(f"\033[2K\r{error_message}", end="", flush=True)
+
+                            continue
+                    else:
+                        logger.warning(f"No device has been defined, this program will continue reading continuously.")
+
+                    self.timestamp = datetime.datetime.now(datetime.UTC)
+                    data = {}
+                    measurements = []
+                    for read in range(1, self.number_of_reads + 1, 1):
+                        logger.debug(f"Reading {read} of {self.number_of_reads}...")
+                        data = self._send_command(command=READ_WITH_SERIAL_NUMBER, sock=self.socket)
+                        logger.debug(f"Response: {data}")
+                        parsed_data = self._parse_data(data=data, command=READ_WITH_SERIAL_NUMBER)
+                        measurements.append(parsed_data)
+                        if self.device.serial_id:
+                            if self.device.serial_id != parsed_data['serial_number']:
+                                logger.warning(
+                                    f"Serial number mismatch: {self.device.serial_id} != {parsed_data['serial_number']}")
+                    if len(measurements) == 1:
+                        data = measurements[0]
+                    elif len(measurements) > 1:
+                        raise NotImplementedError("Averaging data does is not yet implemented. Use --number-of-reads 1")
+
+                    corrected_data =  self.__apply_window_correction(data=data)
+
+                    print(data['magnitude'], corrected_data['magnitude'], self.device_window_correction)
+
+                    augmented_data = augment_data(data=corrected_data, timestamp=self.timestamp, device=self.device)
+
+                    if self.save_to_file:
+                        self._write_to_txt(data=augmented_data)
+                    if self.save_to_database:
+                        self._write_to_database()
+                    if self.post_to_api:
+                        self._post_to_api()
+                for i in range(self.reads_frequency):
+                    print(f"\rNext read in {self.reads_frequency - i} seconds...", end="", flush=True)
+                    sleep(1)
+        except KeyboardInterrupt:
+            logger.info("SQM-LE stopped by user")
+        except ConnectionRefusedError:
+            logger.info("SQM-LE connection refused")
+        finally:
+            if self.socket:
+                self.socket.close()
+
+    def _send_command(self, command, sock):
+        sock.sendall(command)
+        data = sock.recv(1024)
+        return data.decode()
+
+    def __apply_window_correction(self, data):
+        data['magnitude'] = data['magnitude'] + self.device_window_correction * u.mag
+        return data
+
+    def _parse_data(self, data, command):
+        data = data.split(',')
+        if command == READ:
+            return {
+                'type': data[0],
+                'magnitude' : float(re.sub('m', '', data[1])) * u.mag,
+                'frequency' : float(re.sub('Hz', '', data[2])) * u.Hz,
+                'period_count' : int(re.sub('c', '', data[3])) * u.count,
+                'period_seconds' : float(re.sub('s', '', data[4])) * u.second,
+                'temperature' : float(re.sub('C', '', data[5])) * u.C,
+            }
+        elif command == READ_WITH_SERIAL_NUMBER:
+            return {
+                'type': data[0],
+                'magnitude' : float(re.sub('m', '', data[1])) * u.mag,
+                'frequency' : float(re.sub('Hz', '', data[2])) * u.Hz,
+                'period_count' : int(re.sub('c', '', data[3])) * u.count,
+                'period_seconds' : float(re.sub('s', '', data[4])) * u.second,
+                'temperature' : float(re.sub('C', '', data[5])) * u.C,
+                'serial_number' : str(int(data[6])),
+            }
+        elif command == REQUEST_CALIBRATION_INFORMATION:
+            return {
+                'type': data[0],
+                'magnitude_offset_calibration': float(data[1]),
+                'dark_period': float(data[2]),
+                'temperature_light_calibration': float(data[3]),
+                'magnitude_offset_manufacturer': float(data[4]),
+                'temperature_dark_calibration': float(data[5]),
+            }
+        elif command == UNIT_INFORMATION_REQUEST:
+            return {
+                'type': data[0],
+                'protocol_number': data[1],
+                'model_number': data[2],
+                'feature_number': data[3],
+                'serial_number': data[4],
+            }
+        else:
+            logger.error(f"Unknown command: {command}")
+            return data
+
+
+
+    def __get_header(self, data, filename):
+        columns = []
+        units = []
+        for key in data.keys():
+            columns.append(key)
+            if isinstance(data[key], Quantity):
+                units.append(f"# {key}: {data[key].unit}\n")
+        return f"# Filename {filename}\n{''.join(units)}# {self.separator.join(columns)}\n"
+
+    def __get_line_for_plain_text(self, data):
+        fields = []
+        for key in data.keys():
+            if isinstance(data[key], Quantity):
+                fields.append(str(data[key].value))
+            else:
+                fields.append(str(data[key]))
+        return f"{self.separator.join(fields)}\n"
+
+
+    def _write_to_txt(self, data):
+        filename = get_filename(
+            save_files_to=self.save_files_to,
+            device_name=self.device.serial_id,
+            device_type='sqmle',
+            file_format=self.file_format)
+        if not os.path.exists(filename):
+            header = self.__get_header(data=data, filename=filename)
+            with open(filename, 'w') as f:
+                f.write(header)
+        data_line = self.__get_line_for_plain_text(data=data)
+        with open(filename, "a") as f:
+            f.write(data_line)
+            logger.debug(f"Data written to {filename}")
+
+    def _write_to_database(self):
+        pass
+
+    def _post_to_api(self):
+        pass