pi-sht1x 1.0.10

命令行 - REPL

您可以直接从 REPL 调用 SHT1x 类。为了使用该库，您需要导入包：

from pi_sht1x import SHT1x

现在您可以创建传感器对象并进行测量：

with SHT1x(18, 23, gpio_mode=GPIO.BCM) as sensor:
    temp = sensor.read_temperature()
    humidity = sensor.read_humidity(temp)
    sensor.calculate_dew_point(temp, humidity)
    print(sensor)

这将使用data_pin=18、sck_pin=23、gpio_mode=GPIO.BCM以及vdd (3.5V)、分辨率(High)、加热器(False)、otp_no_reload (False) 和crc_check (True )的默认值创建 SHT1x 对象）。输出将如下所示：

Temperature: 24.05°C [75.25°F]
Humidity: 22.80%
Dew Point: 1.38°C

请注意，此库应与with语句之类的上下文管理器一起使用。将它与上下文管理器一起使用将允许程序自行正确清理并将 GPIO 引脚重置回默认状态。

例子.py

该脚本位于示例文件夹中，包括多种使用 SHT1x 类进行温度、湿度和露点测量的方法。为了使用该脚本，请务必使用您在设置中本地使用的 pin 号更新文件顶部附近的DATA_PIN和SCK_PIN常量：

DATA_PIN = 18
SCK_PIN = 23

基于数据表推荐 3.3V 为传感器供电的事实，默认电压（如果在实例化对象时未指定）为 3.5V。如果您使用 5V 为传感器供电，请务必在创建对象时设置该值。要运行脚本：

sudo python3 examples/examples.py

运行该脚本会练习传感器的所有功能。请务必查看脚本以了解您可以做什么以及如何使用传感器进行自定义。样本输出：

$ sudo python3 examples/examples.py
Test: using default values: 3.5V, High resolution, no heater, otp_no_reload off, CRC checking enabled...
Temperature: 24.49°C [76.04°F]
Humidity: 20.68%
Dew Point: 0.47°C

Temperature: 24.48°C [76.02°F]
Humidity: 20.68%
Dew Point: 0.46°C

Temperature: 24.47°C [76.01°F]
Humidity: 20.68%
Dew Point: 0.45°C

Temperature: 24.51°C [76.06°F]
Humidity: 20.68%
Dew Point: 0.47°C

Temperature: 24.51°C [76.06°F]
Humidity: 20.68%
Dew Point: 0.47°C
Test complete.

Test: reading all measurements using GPIO.BCM mode, 3V, High resolution, heater off, otp_no_reload off, and CRC check on.
Temperature: 24.48°C [76.02°F]
Humidity: 20.61%
Dew Point: 0.42°C

Temperature: 24.46°C [75.98°F]
Humidity: 20.61%
Dew Point: 0.40°C

Temperature: 24.46°C [75.98°F]
Humidity: 20.61%
Dew Point: 0.40°C

Temperature: 24.48°C [76.02°F]
Humidity: 20.68%
Dew Point: 0.46°C

Temperature: 24.48°C [76.02°F]
Humidity: 20.65%
Dew Point: 0.44°C
Test complete.
.
.
.

RPi.GPIO模块需要 root 权限才能与 Raspberry Pi 上的 GPIO 引脚通信，因此您需要以 root (sudo) 身份运行脚本。

传感器.py

该脚本可从终端调用，并且传感器参数被传递到脚本中。

sudo python3 sensor.py 18 23 -g 'BCM'

这将使用data_pin=18、sck_pin=23和gpio_mode=GPIO.BCM执行传感器脚本。然后，该脚本将创建 SHT1x 类的实例并读取温度、湿度并计算露点五次，每次测量之间休眠 2 秒。输出将如下所示：

$ sudo python3 examples/sensor.py 18 23 -g 'BCM'
Temperature: 24.05°C [75.25°F]
Humidity: 22.79%
Dew Point: 1.37°C

Temperature: 24.03°C [75.21°F]
Humidity: 22.79%
Dew Point: 1.36°C

Temperature: 24.01°C [75.16°F]
Humidity: 22.79%
Dew Point: 1.33°C

Temperature: 24.01°C [75.17°F]
Humidity: 22.86%
Dew Point: 1.38°C

Temperature: 24.02°C [75.19°F]
Humidity: 22.86%
Dew Point: 1.39°C

要获取可以提供给脚本的所有参数的列表，请使用python3 sensor.py -h获取帮助：

$ sudo python3 examples/sensor.py -h
usage: sensor.py [-h] [-g {BCM,BOARD}] [-v {5V,4V,3.5V,3V,2.5V}]
                 [-r {HIGH,LOW}] [-e] [-o] [-c]
                 data-pin sck-pin

Reads the temperature and relative humidity from the SHT1x series of sensors
using the pi_sht1x library.

positional arguments:
  data-pin              Data pin used to connect to the sensor.
  sck-pin               SCK pin used to connect to the sensor.

optional arguments:
  -h, --help            show this help message and exit
  -g {BCM,BOARD}, --gpio-mode {BCM,BOARD}
                        RPi.GPIO mode used, either GPIO.BOARD or GPIO.BCM.
                        Defaults to GPIO.BCM.
  -v {5V,4V,3.5V,3V,2.5V}, --vdd {5V,4V,3.5V,3V,2.5V}
                        Voltage used to power the sensor. Defaults to 3.5V.
  -r {HIGH,LOW}, --resolution {HIGH,LOW}
                        Resolution used by the sensor, 14/12-bit or 12-8-bit.
                        Defaults to High.
  -e, --heater          Used to turn the internal heater on (used for
                        calibration).
  -o, --otp-no-reload   Used to enable OTP no reload, will save about 10ms per
                        measurement.
  -c, --no-crc-check    Performs CRC checking.