summaryrefslogblamecommitdiffstats
path: root/glucometerutils/drivers/contourusb.py
blob: 8696b04001517780e1fd1b7dd507f3989157e023 (plain) (tree)




















                                                                             
                                                      

                                  
                                              
 
 
                                                      



                                                                                      
                                            

                             






                                           

 
                                          
                                                
 

                                                      
 
                                                 

                                
                          
                                                    


                                                                     
 
                                              
                                           


                                     
 
                                                                       






                                                                     



                                                                     
 
                                            

                                 
                                                                        

                                 
                                   
                                 
# -*- coding: utf-8 -*-
#
# SPDX-License-Identifier: MIT
"""Driver for ContourUSB devices.

Supported features:
    - get readings (blood glucose), including comments;
    - get date and time;
    - get serial number and software version;
    - get device info (e.g. unit)

Expected device path: /dev/hidraw4 or similar HID device. Optional when using
HIDAPI.

Further information on the device protocol can be found at

http://protocols.ascensia.com/Programming-Guide.aspx

"""

import datetime
from typing import Dict, Generator, NoReturn, Optional

from glucometerutils import common
from glucometerutils.support import contourusb


def _extract_timestamp(parsed_record: Dict[str, str]):
    """Extract the timestamp from a parsed record.

    This leverages the fact that all the reading records have the same base structure.
    """
    datetime_str = parsed_record["datetime"]

    return datetime.datetime(
        int(datetime_str[0:4]),  # year
        int(datetime_str[4:6]),  # month
        int(datetime_str[6:8]),  # day
        int(datetime_str[8:10]),  # hour
        int(datetime_str[10:12]),  # minute
        0,
    )


class Device(contourusb.ContourHidDevice):
    """Glucometer driver for Contour devices."""

    def __init__(self, device: Optional[str]) -> None:
        super().__init__((0x1A79, 0x6002), device)

    def get_meter_info(self) -> common.MeterInfo:
        self._get_info_record()
        return common.MeterInfo(
            "Contour USB",
            serial_number=self._get_serial_number(),
            version_info=("Meter versions: " + self._get_version(),),
            native_unit=self.get_glucose_unit(),
        )

    def get_glucose_unit(self) -> common.Unit:
        if self._get_glucose_unit() == "0":
            return common.Unit.MG_DL
        else:
            return common.Unit.MMOL_L

    def get_readings(self) -> Generator[common.AnyReading, None, None]:
        """
        Get reading dump from download data mode(all readings stored)
        This meter supports only blood samples
        """
        for parsed_record in self._get_multirecord():
            yield common.GlucoseReading(
                _extract_timestamp(parsed_record),
                int(parsed_record["value"]),
                comment=parsed_record["markers"],
                measure_method=common.MeasurementMethod.BLOOD_SAMPLE,
            )

    def get_serial_number(self) -> NoReturn:
        raise NotImplementedError

    def _set_device_datetime(self, date: datetime.datetime) -> NoReturn:
        raise NotImplementedError

    def zero_log(self) -> NoReturn:
        raise NotImplementedError