Homebridge Json Thermometer

This is a fork of the http-json-thermometer by Jakubkuba9000 that allows:

• complex json objects to be parsed
• minimum and maximum values per thermostat to filter out noisy default values like occasional 999°C from DS18B20 sensors on a Shelly Uni

Installation

1. Install Homebridge.
2. Install this plugin: npm install -g homebridge-json-thermometer or through Homebridge UI by clicking the INSTALL buttton.
3. Update your config.json file by clicking the SETTINGS button through Homebridge UI or manually. See the explanations and samples below.

Configuration

Configuration example

{
  "platform": "HttpJsonThermometer",
  "thermometers": [ {
    "thermometerName": "Terrarium thermometer",
    "httpRoute": "http://ipaddress/status/",
    "updateInterval": 60,
    "jsonPath": "temp",
    "calibration": 0.16,
    "minValue": -900,
    "maxValue": 900,
    "manufacturer": "Default-Manufacturer",
    "model": "Default-Model",
    "serial": "Default-Serial"
    } ]
}

Examples

For a simple json object, defining the first property name is enough.

{
  "tC": 22.94,                // path is "tC"
  "tF": 73.29                 // path is "tF"
}

For complex json objects, the js dot notation can be used as path:

{
  "ext_temperature": {
    "0": {
      "tC": 22.94,                // path is "ext_temperature[0].tC"
      "tF": 73.29                 // path is "ext_temperature[0].tF"
    }
  }
}

Core

| Key | Description | Default | | --- | --- | --- | | platform | Must be HttpJsonThermometer | HttpJsonThermometer | | thermometerName | This will be the name of your thermometer that appears in the Home app. This must be unique. | Terrarium thermometer | | httpRoute | This must be a path to a JSON format that looks like this, for example:{  "temp": "24.88", "temp2": "24.06", "temp3": "23.75"} | http://ipaddress/status/ | | updateInterval | Interval after which the values are updated. | 60 | | jsonPath | This must be the path of the response value in a JSON response.In the case above it could be temp or temp2 or temp3. | temp |

Additional options

| Key | Description | Default | | --- | --- | --- | | calibration | Only if you need to calibrate your thermometer. It will increase or decrease the value. For example if you need to decrease by 0,05 then -0,05 and if you need to increase by 0.6 then 0.60 |0.00| | manufacturer | Manufacturer of your thermometer. | Default-Manufacturer | | model | Thermometer model. | Default-Model | | serial | Serial number of your thermometer. | Default-Serial |

More thermometers

You can also have more than one thermometer. Simply click the button ADD TO THERMOMETERS in UI or add it manually like this:

{
	"platform": "HttpJsonThermometer",
	"thermometers": [
		{
			"thermometerName": "Terrarium thermometer",
			"httpRoute": "http://ipaddress/status/",
			"updateInterval": 60,
			"jsonPath": "temp",
			"calibration": 0.16,
			"manufacturer": "Default-Manufacturer",
			"model": "Default-Model",
			"serial": "Default-Serial"
		},
		{
			"thermometerName": "Kitchen thermometer",
			"httpRoute": "http://yourdomain.com/temp/",
			"updateInterval": 15,
			"jsonPath": "t1",
			"manufacturer": "yourdomain.com",
			"model": "WIFI_USB",
			"serial": "S3r14lNumb3r"
		},
		{
			"thermometerName": "Bathroom thermometer",
			"httpRoute": "http://192.168.1.155/temperature/",
			"updateInterval": 120,
			"jsonPath": "temperature"
		}
	]
}

HomeKit limitations

Unfortunately, HomeKit has the limitation that it rounds values to 0.5 °C. This can be solved by downloading the free Eve app or another similar app. These applications usually show a value accurate to one decimal place.

Credits

• http-json-thermometer by Jakubkuba9000
• Getting Started with Homebridge Plugin Development
• Homebridge API
• homebridge-http-thermometer
• homebridge-plugin-template