uRADMonitor Air Quality Sensors

[alexbk66]

Ver 4.0.1.29 (BETA) - added initial support for uRADMonitor Air Quality Sensors.

Some values may be missing. Also units conversion (to imperial) needs check.

[alexbk66]

Configuration

Plugin supports both Server (cloud) and Local (WiFi) API.

1. Select "Uradmonitor" provider

Note: Latitude and Longitude are not currently used and can be ignored

For Local (WiFi) connection:

2. Only sensor IP address is required:



For Server (Remote) connection:

2. User ID (X-User-id) and API key (X-User-hash) should be obtained from https://www.uradmonitor.com/dashboard/ (API tab)
3. After entering the correct User ID and API key and clicking "Save" - the list of your sensors will be populated
4. Select the sensor you want to use for the particular Location
5. "Maximum data age (sec)" used to ignore stale data if sensor is not responding.

[alexbk66]

9/28/2021 05:18:26
AK Weather
Warning
[7774] UradMonitor Remote: Cannot deserialize the current JSON object (e.g. {"name":"value"}) into type 'System.Collections.Generic.List`1[HSPI_AKWeather.Providers.uRADMonitor+Readings]' because the type requires a JSON array (e.g. [1,2,3]) to deserialize correctly. To fix this error either change the JSON to a JSON array (e.g. [1,2,3]) or change the deserialized type so that it is a normal .NET type (e.g. not a primitive type like integer, not a collection type like an array or List) that can be deserialized from a JSON object. JsonObjectAttribute can also be added to the type to force it to deserialize from a JSON object. Path 'success', line 1, position 11.

This happens when there's no data, the API is inconsistent, when there's data it returns JSON array, but if there's no data within specified interval - it returns just {"success": []}

The API docs say that it should return "empty array", but above JSON is not an array.

I'll see how I can handle both cases.

[alexbk66]

brientim it looks like your sensor was last online 4/09/2021 9:26:48 - that's why there's no recent data

[EDIT]

If you set "Maximum data age (sec)" in Location settings to 2100000 - you get data for 04 Sep 09:26

[brientim]

brientim it looks like your sensor was last online 4/09/2021 9:26:48 - that's why there's no recent data

[EDIT]

If you set "Maximum data age (sec)" in Location settings to 2100000 - you get data for 04 Sep 09:26

Hello Alex,

You were correct and a single incorrect firewall rule was the underpinning root cause. Fixed and all working as designed.

Regards
Tim

[alexbk66]

Hi Tim, do you know what battery reading is? It's reading 382.13 - is it something like 3.82 V?

[alexbk66]

Also brientim , there's a lot of "average" readings (according to docs it's 24Hrs average) - do you think any of these are of any interest?

[Info]: [9317] uRADMonitor Tim: (uRADMonitor) id: 8200000C
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) timefirst: 6/09/2016 22:58:08
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) timelast: 28/09/2021 17:24:26
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) timelocal: 6420
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) latitude: -37.xxx
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) longitude: 144.xxx
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) altitude: 25.84
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) speed: 0
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) city: Hoppers Crossing
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) country: AU
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) placement: 1
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) versionsw: 126
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) versionhw: 103
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) status: 1
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) mobile: 0
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) detector: SI29BG
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) factor: 0.01
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) note:
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) picture:
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) aqi: 1
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_timelocal: 5790
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_temperature: 25.7
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_pressure: 101007
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_humidity: 39.02
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_pm25: 1
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_voc: 2093860
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_co2: 395
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_ch2o: 27
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_cpm: 20
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_voltage: 382.13
[Info]: [9317] uRADMonitor Tim: (uRADMonitor) avg_duty: 232

[brientim]

Also brientim , there's a lot of "average" readings (according to docs it's 24Hrs average) - do you think any of these are of any interest?

Hi Alex,

No I’m of the opinion that is not required as it cannot be effectively used for any purpose in Homeseer.

Tim

[alexbk66]

Only "status" - online/offline may be of use

[brientim]

Only "status" - online/offline may be of use

Agreed, given what you brought to my attention today, I can set notifications.

[alexbk66]

One more question, it doesn't give the index itself (AQI) - what do you do about it?

[brientim]

In this nature of devices, I do not think you need to do anything further, you have already added the ability to monitor and report AQI and people will become familiar over time

[alexbk66]

So the Server API is pretty much done. I asked Radu if he can send me the sensor for developing Local API.

I have also reply from PurpleAir (for Server API access) as well, so will implement it as well.

[alexbk66]

Ver 4.0.1.30 - Added Formaldehyde (ch2o) device; fixed receiving empty data or error response

[alexbk66]

Ver 4.0.1.48 - Added Local API

Note: update configuration instructions above post #2