万博网页版登陆页派论坛

QQ登录

只需一步,快速开始

查看: 27|回复: 0
收起左侧

MH-Z19B

[复制链接]
发表于 2024-10-21 22:58:11 | 显示全部楼层 |阅读模式
"""
Serial port output (UART) module for the MH_Z19 sensor family.
"""

from machine import UART, Pin
from utime import sleep
import struct

UART_TX_PIN = 0
UART_RX_PIN = 1
UART_ID = 0
BAUD_RATE = 9600  # according to manual
DATA_BIT = 8  # 8 bytes according to manual
STOP_BIT = 1  # 1 byte according to manual
PARITY_BIT = None  # null according to manual

class MH_Z19:
    """
    Communicate with the MH_Z19 sensor from the Raspberry Pi Pico.

    This rudimentary implementation is my very first attempt of working with
    uart in micropython. Use with caution. There is no warranty.

    The MH_Z19B sensor's datasheet can be found at
    https://www.winsen-sensor.com/d/ ... z19b-co2-ver1_0.pdf

    The MH_Z19C sensor's datasheet can be found at
    https://www.winsen-sensor.com/d/ ... 2-manual-ver1_0.pdf
    """
    RETRY_COUNT = 5

    def __init__(self, tx_pin: Pin, rx_pin: Pin, uart_id=0):
        self.sensor = UART(uart_id, baudrate=BAUD_RATE, tx=tx_pin, rx=rx_pin,
                           bits=DATA_BIT, parity=PARITY_BIT, stop=STOP_BIT)

    def read_co2(self):
        """
        Read the CO2 value (command 0x86, checksum 0x79).
        """
        for _retry in range(self.RETRY_COUNT):
            result = self.sensor.write(b"\xff\x01\x86\x00\x00\x00\x00\x00\x79")
            s = self.sensor.read(result)

            if (s and len(s) >= 4 and s[0] == 0xff and s[1] == 0x86 and
                ord(self.checksum(s[1:-1])) == s[-1]):
                return s[2]*256 + s[3]
            sleep(0.1)
        return

    def read_all(self):
        for _retry in range(self.RETRY_COUNT):
            result = self.sensor.write(b"\xff\x01\x86\x00\x00\x00\x00\x00\x79")
            s = self.sensor.read(result)

            if (s and len(s) >= 9 and s[0] == 0xff and s[1] == 0x86 and
                ord(self.checksum(s[1:-1])) == s[-1]):
                return {'co2': s[2]*256 + s[3],
                        'temperature': s[4] - 40,
                        'TT': s[4],
                        'SS': s[5],
                        'UhUl': s[6]*256 + s[7]}
            sleep(0.1)
        return {}

    def calibrate_zero(self) -> None:
        """
        Perform zero point calibration (0x87).

        Zero point is 400ppm, please make sure the sensor had been worked
        under 400ppm for at least 20 minutes.
        """
        request = b"\xff\x01\x87\x00\x00\x00\x00\x00\x78"
        result = self.sensor.write(request)

    def calibrate_span(self, span) -> None:
        """
        Perform span calibration (0x88).

        Note: Please do zero calibration (`calibrate_zero`) before span
        calibration.
        Please make sure the sensor worked under the given level of co2 for
        at least 20 minutes.
        Use at least 1000ppm as span, ideally 2000ppm.
        """
        b3 = span // 256  # high byte
        byte3 = struct.pack('B', b3)
        b4 = span % 256  # low byte
        byte4 = struct.pack('B', b4)
        c = checksum([0x01, 0x88, b3, b4])
        request = b"\xff\x01\x88" + byte3 + byte4 + b"\x00\x00\x00" + c
        result = self.sensor.write(request)

    def enable_self_calibration(self) -> None:
        """
        Enable automatic baseline correction (command 0x79).

        This function is usually suitable for indoor air quality monitor
        such as offices, schools and homes.
        The sensor factory default is to enable the automatic zero calibration
        function.
        Enable with 0xa0.
        """
        self.sensor.write(b"\xff\x01\x79\xa0\x00\x00\x00\x00\xe6")

    def disable_self_calibration(self) -> None:
        """
        Disable automatic baseline correction (command 0x79).

        This function is usually suitable for greenhouse, farm and
        refrigerators.
        Disable with 0x00.
        """
        self.sensor.write(b"\xff\x01\x79\x00\x00\x00\x00\x00\x86")

    def checksum(self, array) -> bytes:
        """
        Return the checksum byte.
        """
        csum = sum(array) % 0x100
        if csum == 0:
            return struct.pack('B', 0)
        else:
            return struct.pack('B', 0xff - csum + 1)


if __name__ == "__main__":
    sensor = MH_Z19(Pin(UART_TX_PIN), Pin(UART_RX_PIN), UART_ID)
    print(sensor.read_co2())


回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

小黑屋|手机版|Archiver|万博网页版登陆页派论坛 ( 粤ICP备15075382号-1  

GMT+8, 2024-11-1 11:33 , Processed in 1.125000 second(s), 25 queries , Gzip On.

Powered by Shumeipai.net! X3.2

© 2001-2015 万博网页版登陆页派论坛安全联盟

快速回复 返回顶部 返回列表