ym88659208ym87991671
sensor_temp | Documentation SmartMarket
Skip to main content

sensor_temp

Temperature & humidity sensor.

Device functions available

The device may have all the following functions or just some of them. For example, if a sensor cannot indicate the battery charge level, there is no need to include the battery_percentage function in its model description.

The online function is mandatory for the sensor. Also, at least one of the following functions must also be described: humidity, temperature. For example, if you are describing a temperature sensor, you must list the online and temperature functions for it, while there no need to specify the humidity function.

If you are describing a temperature and humidity sensor, be sure to list all three functions: online, humidity, temperature.

FunctionMandatory?Description
air_pressureBarometric pressure
battery_low_powerWhether the batter is charged or not
battery_percentageBattery charge level
humidity✔︎Humidity. This function is mandatory for humidity sensors and temperature and humidity sensors. For temperature sensors that do not measure humidity, there is no need to indicate it
online✔︎Device availability: offline or online
sensor_sensitiveThe level of sensor sensitivity
signal_strengthThe strength of the signal
temp_unit_viewTemperature scale, in which the sensor displays real-time temperature information on its screen in °C or °F. Use the function only for sensors with a screen that can display the temperature in different temperature scales
temperature✔︎Temperature. This function is mandatory for temperature sensors and temperature and humidity sensors. For humidity sensors that do not measure temperature, there is no need to indicate it

Sample description of a temperature and humidity sensor model

The model is described in accordance with the model structure. The sample describes a temperature and humidity sensor that can report temperature, humidity and atmospheric pressure. The sensor also indicates the signal strength, the battery charge level and whether the battery is discharged; it also has a sensitivity setting. The sensor is equipped with a screen and can show temperature in °C and °F.

{
"id": "QWERTY124",
"manufacturer": "Xiaqara",
"model": "SM1123456789",
"hw_version": "3.1",
"sw_version": "5.6",
"description": "Xiaqara smart temperature and humidity sensor",
"category": "sensor_temp",
"features": [
"online",
"humidity",
"temperature",
"air_pressure",
"battery_low_power",
"battery_percentage",
"sensor_sensitive",
"signal_strength",
"temp_unit_view",
]
}

Temperature and humidity sensor sample description

The model is described in accordance with the device structure. In the sample there is no description of the sensor model, therefore we believe that the models are described in a separate file and it is sufficient to specify only the model ID (in this case, QWERTY124).

The parent_id specified for the sensor is the identifier of the hub through which the sensor is connected to the smart home.

{
"id": "ABCD_004",
"parent_id": "A_002",
"name": "My temperature and humidity sensor",
"default_name": "Smart temperature and humidity sensor",
"nicknames": [
"Microclimate sensor",
"Temperature sensor",
],
"home": "My home",
"room": "Living room",
"model_id": "QWERTY124",
"hw_version": "3.1",
"sw_version": "5.6"
}