Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:hw:05-sensors:iaq [2020/06/29 11:34]
jan_kozak
en:hw:05-sensors:iaq [2021/12/03 07:53] (current)
lpolcerova [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). ​ 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 concentrationred 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ě variantys tím rozdílem, že navíc obsahují komunikační rozhraní LoRaWAN. Všechny varianty obsahují rozhraní RS485 a WiFi.  +Product datasheetstechnical 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: ==== ==== Complete overview of individual variants: ====
  
Line 17: Line 17:
 //*LoRaWAN is available only for RLW-TH and RLW-THC variants// //*LoRaWAN is available only for RLW-TH and RLW-THC variants//
 </​WRAP>​ </​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 ==== ==== 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   * **the most basic** IAQ variant
   * 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>​ <​html><​span class="​kbBlueText">​Examples of use:</​span></​html>​
Line 30: Line 36:
  
 <​html><​span class="​kbBlueText">​Possible applications:</​span></​html>​ <​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   * 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   * individual use - communication through Wi-Fi with the option of web server access
Line 38: Line 44:
 ==== RW-THC ==== ==== RW-THC ====
 {{ :​cs:​hw:​05-sensors:​unipi-iaq-co2.png?​direct&​150|}} {{ :​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 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   * 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   * **does not contain** the LoRaWAN interface
Line 44: Line 50:
 <​html><​span class="​kbBlueText">​Examples of use:</​span></​html>​ <​html><​span class="​kbBlueText">​Examples of use:</​span></​html>​
   * measuring temperature and relative air humidity to provide data for HVAC regulation   * 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   * controlling indoor artificial lights according to ambient light levels
  
 <​html><​span class="​kbBlueText">​Possible applications:</​span></​html>​ <​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   * 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   * individual use - communication through Wi-Fi with the option of web server access
Line 55: Line 61:
  
 ==== RLW-TH ==== ==== 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   * 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>​ <​html><​span class="​kbBlueText">​Examples of use:</​span></​html>​
Line 66: Line 73:
  
 <​html><​span class="​kbBlueText">​Possible applications:</​span></​html>​ <​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   * 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   * 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|}} {{ :​cs:​hw:​05-sensors:​unipi-iaq-co2.png?​direct&​150|}}
   * variant featuring the **LoRaWAN** interface   * 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   *  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>​ <​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   * 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   * individual use - communication through Wi-Fi with the option of web server access
Line 91: Line 98:
  
 {{ :​files:​img_breakline.png?​nolink |}} {{ :​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 firmware 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>