Differences

This shows you the differences between two versions of the page.

--- en:hw:05-sensors:iaq [2020/06/29 11:34]
jan_kozak
+++ en:hw:05-sensors:iaq [2021/09/06 11:23]
avsetula [Further info]
@@ Line 1: / Line 1: @@
-====== IAQ - Interior Air Quality ======
+====== Indoor Air Quality (IAQ) ======
 The RW/RLW line of IAQ sensors is designed for **air quality measurements** in houses, schools, office buildings, restaurants, factory halls and other similar objects. All sensors are placed in a handy white plastic box (IP20 protection) designed for on-wall installation by attaching it into a suitable wiring box (such as KU68).
-**Four variants** in total are offered, featuring sensors for measuring temperature, humidity, light intensity, barometric pressure and VOC (volatile organic compound) concentration. THC variants are then equipped with **CO<sub>2</sub> concentration sensor** and colour LED indication changing colours from green (low concentration) to red (high concentration). The device thus allows for measuring **up to six quantities** in a single compact package.
+**Four variants** in total are offered, featuring sensors of temperature, humidity, light intensity, barometric pressure and VOC (volatile organic compound) concentration. **THC** models are able to **measure CO<sub>2</sub>** concentration with the indication LED changing its colour from green to red (green = low concentration, red = high concentration). On **TH** models the LED then serve for the indication of air quality index. The sensors feature **measuring of up to six quantities** in a single compact package. RLW variants have the same functionality as RW models, but additionally feature the **LoRaWAN** communication interface. All models are provided with **RS485** and **Wi-Fi** interfaces.
-/* FIXME (to patří k tomu odstavci hore)
+<WRAP center round info 90%>
-Další dvě verze produktu z řady RLW jsou stejné jako popisované první dvě varianty, s tím rozdílem, že navíc obsahují komunikační rozhraní LoRaWAN. Všechny varianty obsahují rozhraní RS485 a WiFi.
+Product datasheets, technical documentation and up-to-date firmware for indoor air quality sensors are available [[en:files:products:05-sensors:iaq|on this link]].
-*/
+</WRAP>
 ==== Complete overview of individual variants: ====
@@ Line 17: / Line 17: @@
 //*LoRaWAN is available only for RLW-TH and RLW-THC variants//
 </WRAP>
+<WRAP center round info 100%>
+For more information about possible applications of Unipi IAQ sensors with LoRa interface, visit [[https://www.unipi.technology/case_study/integration-of-an-iot-indoor-air-quality-sensor-with-lora-communication-364|Integration of an IoT indoor air quality sensor with LoRa communication]] case study.
+</WRAP>
 ==== RW-TH ====
-{{ :en:hw:05-sensors:unipi-iaq.png?direct&150|}}
+{{ :cs:hw:05-sensors:unipi-iaq-co2.png?direct&150|}}
   * **the most basic** IAQ variant
   * features sensors for measuring temperature, relative air humidity, light intensity, barometric pressure and VOC concentration
-  * **does not contain** CO<sub>2</sub> sensor, LED indication and LoRaWAN interface
+  * LED indication of air quality index
+  * **does not contain** CO<sub>2</sub> sensor and LoRaWAN interface
 <html><span class="kbBlueText">Examples of use:</span></html>
@@ Line 30: / Line 36: @@
 <html><span class="kbBlueText">Possible applications:</span></html>
-  * when used with Unipi PLCs: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
+  * when used with Unipi units: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
   * usage within a third-party system through RS485 or Wi-Fi interface using a suitable communication protocol
   * individual use - communication through Wi-Fi with the option of web server access
@@ Line 38: / Line 44: @@
 ==== RW-THC ====
 {{ :cs:hw:05-sensors:unipi-iaq-co2.png?direct&150|}}
-  * variant featuring a **CO<sub>2</sub> sensor** and LED indication of interior air quality
+  * integrated **CO<sub>2</sub> sensor** and a LED indication of CO<sub>2</sub> concentration
   * features sensors for measuring temperature, relative air humidity, light intensity, barometric pressure, VOC concentration and CO<sub>2</sub> concentration
   * **does not contain** the LoRaWAN interface
@@ Line 44: / Line 50: @@
 <html><span class="kbBlueText">Examples of use:</span></html>
   * measuring temperature and relative air humidity to provide data for HVAC regulation
-  * using internal air quality data (enhanced by CO<sub>2</sub> concentration measurements) for regulation of ventilation and air recovery
+  * using internal air quality data (enhanced by CO<sub>2</sub> concentration measurements) for the regulation of ventilation and air recovery
   * controlling indoor artificial lights according to ambient light levels
 <html><span class="kbBlueText">Possible applications:</span></html>
-  * when used with Unipi PLCs: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
+  * when used with Unipi units: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
   * usage within a third-party system through RS485 or Wi-Fi interface using a suitable communication protocol
   * individual use - communication through Wi-Fi with the option of web server access
@@ Line 55: / Line 61: @@
 ==== RLW-TH ====
-{{ :cs:hw:05-sensors:unipi-iaq.png?direct&150|}}
+{{ :cs:hw:05-sensors:unipi-iaq-co2.png?direct&150|}}
   * variant featuring **LoRaWAN** interface
-  *  features sensors for measuring temperature, relative air humidity, light intensity, barometric pressure and VOC concentration
+  * features sensors for measuring temperature, relative air humidity, light intensity, barometric pressure and VOC concentration
-  * **does not contain** CO<sub>2</sub> sensor, LED indication and LoRaWAN interface
+  * LED indication of air quality index
+  * **does not contain** CO<sub>2</sub> sensor and LoRaWAN interface
 <html><span class="kbBlueText">Examples of use:</span></html>
@@ Line 66: / Line 73: @@
 <html><span class="kbBlueText">Possible applications:</span></html>
-  * when used with Unipi PLCs: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
+  * when used with Unipi units: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
   * usage within a third-party system through RS485 or Wi-Fi interface using a suitable communication protocol
   * individual use - communication through Wi-Fi with the option of web server access
@@ Line 76: / Line 83: @@
 {{ :cs:hw:05-sensors:unipi-iaq-co2.png?direct&150|}}
   * variant featuring the **LoRaWAN** interface
-  * integrated **CO<sub>2</sub> sensor** and a LED indication of air quality
+  * integrated **CO<sub>2</sub> sensor** and a LED indication of CO<sub>2</sub> concentration
   *  features sensors for measuring temperature, relative air humidity, light intensity, barometric pressure, VOC concentration and CO<sub>2</sub> concentration
@@ Line 85: / Line 92: @@
 <html><span class="kbBlueText">Possible applications:</span></html>
-  * when used with Unipi PLCs: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
+  * when used with Unipi units: an element of **MaR systems** using the **Modbus RTU/TCP** protocol
   * usage within a third-party system through RS485 or Wi-Fi interface using a suitable communication protocol
   * individual use - communication through Wi-Fi with the option of web server access
@@ Line 91: / Line 98: @@
 {{ :files:img_breakline.png?nolink |}}
+===== LoRa frame decoder code =====
+Example of binary payload decoder. Function names are in accordance with ''The Things Network''.
+<code>
+function getBit(number, bitPosition) {
+  return (number & (1 << bitPosition)) === 0 ? 0 : 1;
+}
+function Decoder(bytes, port) {
+  // Decode an uplink message from a buffer
+  // (array) of bytes to an object of fields.
+  var decoded = {};
+  if (getBit(bytes[0],0)) {
+    decoded.temperature = ((bytes[2] << 8) | bytes[1]) / 100 - 100;
+    decoded.relative_humidity = bytes[3] / 2.5;
+  }
+  if (getBit(bytes[0],1)) decoded.pressure = ((bytes[5] << 8) | bytes[4]) / 100 + 800;
+  if (getBit(bytes[0],2)) {
+    decoded.voc_index = ((bytes[7] << 8) | bytes[6]) & 0x01FF;
+    decoded.voc_accuracy = ((bytes[7] << 8) | bytes[6]) >> 9 & 0x0003;
+  }
+  if (getBit(bytes[0],3)) decoded.ambient_light = Math.exp(bytes[8] / 20) - 1;
+  if (getBit(bytes[0],4)) decoded.co2 = ((bytes[10] << 8) | bytes[9]);
+  if (getBit(bytes[0],5)) {
+    decoded.pm10 = (((bytes[13] << 16) | (bytes[12] << 8) | bytes[11]) >> 12) & 0x000FFF / 4;
+    decoded.pm2_5 = ((bytes[13] << 16) | (bytes[12] << 8) | bytes[11]) & 0x000FFF / 4;
+  }
+  if (getBit(bytes[0],6)) {
+    decoded.noise_duration = (bytes[14] / 2);
+    decoded.noise_intensity = (bytes[15] / 5) + 25;
+  }
+  return decoded;
+}
+</code>
+===== Further info =====
-/* FIXME
+<tile>
-  * link to e-shop: [[https://www.unipi.technology/1-wire-teplotni-senzor-p63|odkaz]]
+| en:files:products:05-sensors:iaq            | Documentation and firmaware for download  | :en:files:unipi-kb-icon-os.png         |
-  * additional info about the sensors is available in the [[en:automation:02-glossary:iaq-hidden|IAQ article]]
+| en:hw:05-sensors:iaq-eshop-redirect-hidden  | Buy at Unipi e-shop                       | :files:unipi-kb-icon-shopping-cart-outline.png  |
-*/
+</tile>