A temperature sensor measures the ambient temperature in C or F degrees.

All boards come with various temperature sensors that measure ambient temperature. Some of the temperature sensors are on the main CPU chip, others come in analog form as a thermistor and some temperature sensors are included in the barometer chip.

Functions communicating with the on-board temperature sensors are defined in the multichanneltemperature.h header file.

Source Types

There are four types temperature sources providing data:




Temperature sensor on the nRF SOC

External Thermistor

Separate thermistor that can be connected to the gpio pins

Bosch Barometer

Temperature sensor from either the BMP280 or BME280 barometers

On-board Thermistor

Thermistor on the MetaWear board

The MblMwMetaWearRChannel and MblMwMetaWearRProChannel enums map the channel ids to temperature sources providing a quick way to interact with the specific temperature source if you know specifically what board you are using. The RProChannel enum can be used with all boards except the MetaWear R.

Users can also programatically check which source corresponds to each channel using the mbl_mw_multi_chnl_temp_get_source function.

channels = libmetawear.mbl_mw_multi_chnl_temp_get_num_channels(board)
# channels= [TemperatureSource.NRF_DIE, TemperatureSource.EXT_THERM, TemperatureSource.BMP280, TemperatureSource.PRESET_THERM]
for i in range(0, len(channels)):
    with self.subTest(channel=i):
        source = libmetawear.mbl_mw_multi_chnl_temp_get_source(board, i)

External Thermistor

External thermistors require additional configuration before they can produce reliable data. Call mbl_mw_multi_chnl_temp_configure_ext_thermistor to tell the MetaWear what GPIO pins the thermistor is connected to and whether it is active high or low.

We have a blog post on our project’s page explaining how to connect an external thermistor to the gpio pins, link here.

Bosch Barometer

Both the BMP280 and BME380 chips also measure ambient temperature. To read from these temperature sources, you will need to first start the Bosch barometer.

Boards that do not have a Bosch barometer, e.g. RG, C, and Detector boards, will always report 0C from this temperature source.

Reading Temperature

Temperature reads are manually triggered by calling mbl_mw_datasignal_read. The data is represented as a float and is in units of Celsius.

def data_handler(self, ctx, data):
    print("%s -> %s" % (self.device.address, parse_value(data)))

sensor_data_handler = FnVoid_VoidP_DataP(data_handler)

libmetawear.mbl_mw_multi_chnl_temp_configure_ext_thermistor(self.board, MetaWearRChannel.EXT_THERMISTOR, 0, 1, 0)
temp_signal = libmetawear.mbl_mw_multi_chnl_temp_get_temperature_data_signal(board, MetaWearRChannel.EXT_THERMISTOR)
libmetawear.mbl_mw_datasignal_subscribe(temp_signal, None, sensor_data_handler)