Contents
- I. Module Introduction
- 2. Introduction to Main Chips
- 2.1 Chip Overview
- 2.2 Pin Definition
- 2.3 Functional Block Diagram
- 2.4 Performance Parameters
- 2.5 Reference Circuit
- 2.6 Chip Configuration
- 2.7 Communication Interfaces and Related Protocols
- 2.8 PCB Routing Precautions
- III. Circuit Engineering
- 3.1 Circuit Source Engineering
- 3.2 Module Usage Instructions
- 3.3 Application Experiment
- 4. Drivers
- 5. BOM & Recommended Alternative Parts
- VI. Revision History
- VII. Relevant Materials
- 7.1 Chip Datasheet
- 7.2 PCB Silkscreen Specific Icons

I. Module Introduction
T117B-based digital temperature sensor module that adopts the high-precision digital temperature sensor solution of T117B from Minsensor, and is compatible with TI TMP117; based on the PN junction/bandgap principle and built-in with a 16-bit ADC, it can directly output temperature data.The module is equipped with an address selection circuit, LDO voltage regulator circuit, power filtering and indicator light circuit. It is powered by 3.3V and supports I²C and 1-Wire dual-protocol communication. Its temperature measurement range covers -103℃ to + 153℃, with an accuracy of ±0.5℃ in the 0~60℃ range, a resolution of up to 0.004℃, and extremely low power consumption, making it suitable for high-precision temperature measurement scenarios such as industry, medical treatment, and energy storage.
2. Introduction to Main Chips
2.1 Chip Overview

2.2 Pin Definition

T117B is a I²C interface digital temperature sensor chip from Minya Sensor, packaged in DFN6L format, with a temperature measurement range of -103℃ to + 153℃, an accuracy of ±0.5℃ in the 0℃ to + 60℃ range, a 16-bit ADC resolution of 0.004℃, featuring ultra-low power consumption, self-diagnosis and alarm functions, and is suitable for scenarios such as smart wearables, medical care, and cold chain.
2.3 Functional Block Diagram

The T117 series of chips collect temperature signals via a temperature-sensing PN junction array, which are sent to a 16-bit ADC for conversion into digital signals after differential amplification, then processed under the control of digital logic; the data can be temporarily stored in registers and written to E²PROM to achieve non-volatile storage. The chip communicates with external devices via the I²C serial interface, and integrates power management and ALERT alarm functions at the same time. Users can set the conversion frequency and alarm threshold by configuring registers to realize high-precision, low-power temperature detection and monitoring.
2.4 Performance Parameters

T117 has a supply voltage range of 1.8V to 5.5V, an operating/storage temperature range of -103°C to + 153°C, HBM mode ESD protection of ±8kV; in terms of electrical characteristics, the typical standby current in single measurement mode is 0.01μA, and the average current is only 2μA. The I²C interface supports standard logic levels, and the recommended pull-up resistance is 1~10kΩ.

Under the power supply conditions of -55℃ to + 125℃ and 1.8V to 5.5V, its E²PROM has a maximum write cycle of 40ms, a program/erase cycle count of no less than 50,000 times, and a typical data retention time of 10 years.
2.5 Reference Circuit

T117 communicates with MCU via the I²C bus;SCL and SDA lines are each externally connected to a 4.7kΩ pull-up resistor, with a supply voltage of 1.8V-5.5V; the ADDR pin is grounded to set the I²C address to 0x40, the ALERT pin is directly connected to the MCU to realize hardware triggering of the temperature alarm signal, and the entire circuit completes temperature data reading and alarm functions through the standard I²C protocol.
2.6 Chip Configuration
None.
2.7 Communication Interfaces and Related Protocols
2.7.1 Temperature Calculation

2.7.2 Registers
2.7.2.1 Instruction Register

T117 has an instruction register. The temperature measurement instruction register (address 0x04) can configure the measurement mode (single-shot / continuous / stop) and heating function, and the chip stops measurement by default;E²PROM instruction register (address 0x17) supports E²PROM read and write, soft reset and other operations to realize configuration storage and restoration.
2.7.2.2 Configuration Registers


T117 configuration register (address 0x05) allows configuration of the periodic measurement frequency (ranging from 8 times per second to once every 16 seconds, defaulting to once per second), the number of temperature measurement averaging cycles (1/8/16/32 cycles, defaulting to 32 cycles, corresponding to a conversion time of 2.2~15.3ms), and the low-power mode switch (enabled by default, the device enters low-power mode after instruction execution), so as to flexibly adjust the measurement rate, accuracy and power consumption.
2.7.2.3 Status Register

T117 status register (address 0x03) is in read-only mode, which contains information such as temperature high/low line alarm status, conversion status, E²PROM read/write status, heating status and alarm threshold configuration error indication, and can be used to query the working status of the chip.
2.7.2.4 Register List


2.7.3 I2C Communication

The T117 series chips feature I²C commands that support functions including ROM reading, temperature measurement, temperature reading, heating control, soft reset, periodic measurement stop, read/write access to the scratch area, and mutual copying between register data and E²PROM; corresponding operations are triggered by writing commands to registers such as Temp_Cmd (0x04) and E²PROM_Cmd (0x17).

T117 sensor implements SDA / SCL pin-based I²C communication, supports the fast mode with a maximum clock rate of 1MHz; the communication starts with a START condition and ends with a STOP condition. Its slave address can be configured via the ADDR pin, providing 4 optional addresses in total to support multi-device bus expansion.

The T117 slave address can be configured via the level of the I²C slave address can be configured via the level of the ADDR pin (connecting to GND, or VDD, or SDA, or SCL corresponds to different addresses respectively), and its read/write communication follows the standard I²C timing sequence: for a read operation, the write address + register address must be sent first, then switch to the read address via a repeated start to read data; for a write operation, the write address, register address and data are sent in sequence, and the slave's ACK response is required during the whole process.

The T117 series I²C bus supports Standard-mode (up to 400kHz) and Fast-mode Plus (up to 1000kHz), and specifies timing parameters such as the high and low levels of SCL, start/stop signals, and data setup/hold; after the master reads the temperature data, it can verify the transmission correctness by reading the Crc_temp register.
2.8 PCB Routing Precautions
None.
III. Circuit Engineering
3.1 Circuit Source Engineering
ProPrj_Digital Temperature Sensor Module Based on T117B_v1.0.0_2026-05-12.epro2 2.8 MB
Digital Temperature Sensor Module Based on T117B-V1.0.0.rar 3.2 MB
3.2 Module Usage Instructions
The schematic diagram of this module is shown below:
SCH_Schematic1_Digital Temperature Sensor Module Based on T117B_v1.0.0_2026-05-12.pdf 2.2 MB

This module provides an IIC communication interface: it supports standard I2C communication rates, allows flexible configuration of the ADDR pin to set the I2C address, is compatible with 3.3V logic levels, and can stably transmit the high-precision digital temperature data collected by T117B. With a temperature measurement range covering -103°C to + 153°C, it is suitable for high-precision temperature measurement scenarios in industries such as industrial manufacturing, medical care, and energy storage, providing the system with reliable data interaction capabilities for ultra-wide temperature range and low-power temperature sensing.
3.3 Application Experiment
Here, we use the GraftPort-RP2040 development board for testing, and the T117B-based digital temperature sensor module communicates with the main controller via the I2C interface.
Here, we first use the HY2.0-4P cable to connect the module to the GraftPort-RP2040 development board's I2C0 interface:
The module connections are shown in the following table:
Development Board Pins | Module Pins | Description |
Pin 4 |
|
|
Pin 5 |
|
|
Here, we need to search for the relevant driver packages on uPyPI: https://upypi.net/zh/

Enter t117b_driver to search, and the following will be displayed:

Click to copy the local installation command:

Import the module driver library code via the mip tool. Below are the usage commands for the mpremote tool:
mpremote mip install https://upypi.net/pkgs/t117b_driver/1.0.0Import the MicroPython driver code for the T117B-based digital temperature sensor module, then copy the following main.py code into our project:
# Python env : MicroPython v1.23.0
# -*- coding: utf-8 -*-
# @Time : 2026/05/26 12:00
# @Author : hogeiha
# @File : main.py
# @Description : Code for testing the T117B temperature sensor driver class
# @License : MIT
# ======================================== Import Modules =========================================
from machine import I2C, Pin
from t117b import T117
import time
# ======================================== Global Variables ============================================
# T117B target I2C address (ADDR pin connected to VDD)
DEVICE_ADDR = [0x40,0x41,0x42,0x43]
# ROM ID register base address (used for device identification)
REG_ROM_ID = 0x18
# Print interval (ms)
PRINT_INTERVAL = 500
# Alert high-temperature threshold (℃)
ALERT_TH = 30.0
# Alert low-temperature threshold (℃)
ALERT_TL = 10.0
# ======================================== Functions ============================================
def scan_i2c(i2c: I2C) -> int:
"""Scan the I2C bus and return the target device address"""
# Scan all devices on the bus
devices = i2c.scan()
if not devices:
raise RuntimeError("No I2C device found on bus")
print("I2C devices found: %s" % [hex(d) for d in devices])
# Look for the target address
for addr in devices:
if addr in DEVICE_ADDR:
print("Target device found at 0x%02X" % addr)
return addr
raise RuntimeError("Device not found at expected address 0x%02X" % DEVICE_ADDR)
def read_rom_id(i2c: I2C, addr: int) -> None:
"""Read the ROM ID register and print it (T117B has no standard WHO_AM_I, printed for reference only)"""
try:
rom_id = i2c.readfrom_mem(addr, REG_ROM_ID, 4)
print("ROM ID: %s" % [hex(b) for b in rom_id])
except OSError as e:
print("ROM ID read failed: %s" % str(e))
def test_basic_read(sensor: T117) -> None:
"""Test basic temperature reading"""
temp = sensor.get_temp()
status = sensor.get_status()
print("Temperature: %s C Status: %s" % (temp, status))
def test_boundary_params(sensor: T117) -> None:
"""Test boundary parameters: extreme threshold configuration"""
# Extreme high-temperature threshold 130℃, extreme low-temperature threshold -100℃
sensor.set_alert_thresholds(130.0, -100.0)
print("Boundary thresholds set: TH=130.0, TL=-100.0")
# Restore normal thresholds
sensor.set_alert_thresholds(ALERT_TH, ALERT_TL)
print("Thresholds restored: TH=%s, TL=%s" % (ALERT_TH, ALERT_TL))
def test_invalid_params(sensor: T117) -> None:
"""Test invalid parameters: verify that ValueError is raised correctly"""
# Test invalid thresholds with th <= tl
try:
sensor.set_alert_thresholds(10.0, 30.0)
print("ERROR: Expected ValueError not raised")
except ValueError as e:
print("ValueError raised as expected: %s" % str(e))
# Test invalid avg value
try:
sensor.set_avg(99)
print("ERROR: Expected ValueError not raised")
except ValueError as e:
print("ValueError raised as expected: %s" % str(e))
# Test invalid mps value
try:
sensor.set_mps(8)
print("ERROR: Expected ValueError not raised")
except ValueError as e:
print("ValueError raised as expected: %s" % str(e))
# ======================================== Custom Classes ============================================
# ======================================== Initialization ==========================================
time.sleep(3)
print("FreakStudio: Using T117B temperature sensor ...")
# Initialize I2C bus
i2c = I2C(0, scl=Pin(5), sda=Pin(4), freq=400000)
# Scan and verify the device
driver_addr=scan_i2c(i2c)
read_rom_id(i2c, driver_addr)
# Instantiate the sensor driver
sensor = T117(i2c=i2c, addr=driver_addr)
# Configure alert: triggers when temperature exceeds ALERT_TH or falls below ALERT_TL
sensor.enable_alerts(th_temp=ALERT_TH, tl_temp=ALERT_TL,
mps=T117.MPS_2_1, avg=T117.AVG_8)
print("Alert configured: TH=%s C, TL=%s C" % (ALERT_TH, ALERT_TL))
# Run parameter validation tests (executed only once at initialization)
test_boundary_params(sensor)
test_invalid_params(sensor)
# Record the last print time
last_print_time = time.ticks_ms()
# ======================================== Main Program ===========================================
try:
while True:
current_time = time.ticks_ms()
# Read temperature and alert status at the print interval
if time.ticks_diff(current_time, last_print_time) >= PRINT_INTERVAL:
test_basic_read(sensor)
last_print_time = current_time
time.sleep_ms(10)
except KeyboardInterrupt:
print("Program interrupted by user")
except OSError as e:
print("Hardware communication error: %s" % str(e))
except Exception as e:
print("Unknown error: %s" % str(e))
finally:
print("Cleaning up resources...")
sensor.deinit()
del sensor
print("Program exited")Burn the code, open the terminal, and the output is as follows:

T117B temperature sensor I2C communication and initialization are normal, and the function verification is complete:
- The basic temperature data is stable, with readings ranging from 29.91°C to 30.58°C, fluctuating slightly with the environment;
- Threshold configuration and parameter verification (e. g.
th_temp > tl_temp,avg/mpsrange) all trigger error prompts as expected; - Alarm status (
low_alert/high_alert/alert_err) all being 0 indicates that the current temperature has not triggered the high or low temperature threshold, and the operating status is stable.
4. Drivers
t117b_driver-1.0.0.zip 12 KB
5. BOM & Recommended Alternative Parts
BOM_Digital Temperature Sensor Module Based on T117B_v1.0.0.xlsx 12 KB
ModAcc_Digital Temperature Sensor Module Based on T117B_v1.0.0.xlsx 10 KB
VI. Revision History
Document Version | Date of Modification | Modifier | Revised Content |
v1.0 | 2026-05-12 | Ling Gaoxing | Initialize Document |
VII. Relevant Materials
7.1 Chip Datasheet
T117B.pdf 1.3 MB
7.2 PCB Silkscreen Specific Icons
