xref: /src/sys/dev/i2c/sht3xreg.h

/*	$NetBSD: sht3xreg.h,v 1.4 2024/02/02 22:39:10 andvar Exp $	*/

/*
 * Copyright (c) 2021 Brad Spencer <brad (at) anduin.eldar.org>
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#ifndef _DEV_I2C_SHT3XREG_H_
#define _DEV_I2C_SHT3XREG_H_

#define SHT3X_TYPICAL_ADDR_1	0x44
#define SHT3X_TYPICAL_ADDR_2	0x45


/* Measurement repeatability and clock steatching
 * for single shot measurement command
 */
#define SHT3X_MEASURE_REPEATABILITY_CS_HIGH	0x2C06
#define SHT3X_MEASURE_REPEATABILITY_CS_MEDIUM	0x2C0D
#define SHT3X_MEASURE_REPEATABILITY_CS_LOW	0x2C10
#define SHT3X_MEASURE_REPEATABILITY_NOCS_HIGH	0x2400
#define SHT3X_MEASURE_REPEATABILITY_NOCS_MEDIUM	0x240B
#define SHT3X_MEASURE_REPEATABILITY_NOCS_LOW	0x2416

/* Periodic measurements ... .5 mps, 1 mps, 2 mps, 4 mps
 * and 10 mps at various repeatability.  One sets up the
 * desired mps and repeatability and then calls fetch data
 * to get the data back at the specified period rate
 */
#define SHT3X_HALF_MPS_HIGH		0x2032
#define SHT3X_HALF_MPS_MEDIUM		0x2024
#define SHT3X_HALF_MPS_LOW		0x202F
#define SHT3X_ONE_MPS_HIGH		0x2130
#define SHT3X_ONE_MPS_MEDIUM		0x2126
#define SHT3X_ONE_MPS_LOW		0x212D
#define SHT3X_TWO_MPS_HIGH		0x2236
#define SHT3X_TWO_MPS_MEDIUM		0x2220
#define SHT3X_TWO_MPS_LOW		0x222B
#define SHT3X_FOUR_MPS_HIGH		0x2334
#define SHT3X_FOUR_MPS_MEDIUM		0x2322
#define SHT3X_FOUR_MPS_LOW		0x2329
#define SHT3X_TEN_MPS_HIGH		0x2737
#define SHT3X_TEN_MPS_MEDIUM		0x2721
#define SHT3X_TEN_MPS_LOW		0x272A
#define SHT3X_PERIODIC_FETCH_DATA	0xE000

/* ART, accelerated response time.  A method of getting periodic
 * measurements at 4Hz
 */
#define SHT3X_ART_ENABLE	0x2B32

/* Break command or stop periodic measurement */
#define SHT3X_BREAK	0x3093

/* The heater */
#define SHT3X_HEATER_ENABLE	0x306D
#define SHT3X_HEATER_DISABLE	0x3066

/* status register */
#define SHT3X_GET_STATUS_REGISTER	0xF32D
#define SHT3X_CLEAR_STATUS_REGISTER	0x3041
/* the bits */
#define SHT3X_ALERT_PENDING		0x8000
#define SHT3X_HEATER_STATUS		0x2000
#define SHT3X_RH_TRACKING_ALERT		0x0800
#define SHT3X_TEMP_TRACKING_ALERT	0x0400
#define SHT3X_RESET_DETECTED		0x0010
#define SHT3X_LAST_COMMAND_STATUS	0x0002
#define SHT3X_WRITE_DATA_CHECKSUM	0x0001

/* Alert mode */
/* This is not supported by the sht3xtemp driver as
   the information in the datasheet was not enough to
   get it working.  A read of the registers appears to
   function just fine, but writes do not do anything, and
   the chip does not indicate any errors occurred.
*/
#define SHT3X_READ_HIGH_ALERT_SET	0xE11F
#define SHT3X_READ_HIGH_ALERT_CLEAR	0xE114
#define SHT3X_READ_LOW_ALERT_SET	0xE102
#define SHT3X_READ_LOW_ALERT_CLEAR	0xE109
#define SHT3X_WRITE_HIGH_ALERT_SET	0x611D
#define SHT3X_WRITE_HIGH_ALERT_CLEAR	0x6116
#define SHT3X_WRITE_LOW_ALERT_SET	0x6100
#define SHT3X_WRITE_LOW_ALERT_CLEAR	0x610B

/* Other commands */
#define SHT3X_SOFT_RESET		0x30A2
/* this is not documented in the datasheet, but is present in a
 * lot of example code
 */
#define SHT3X_READ_SERIAL_NUMBER	0x3780
/* this is also not defined in the datasheet, but is present in some
 * example code.  There are, however, no examples of its use.
 */
#define SHT3X_NO_SLEEP			0x303E

#endif