Differences

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

--- en:hw:05-sensors:iaq [2020/09/09 11:33]
jan_kozak [Description of Unipi IAQ devices]
+++ en:hw:05-sensors:iaq [2021/09/06 11:23]
avsetula [Further info]
@@ Line 4: / Line 4: @@
 **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.
-<WRAP center round info 60%>
+<WRAP center round info 90%>
-Product datasheets and technical documentation for indoor air quality sensors is available [[en:files:products:05-sensors#indoor_air_quality_sensors_iaq|on this link]].
+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 36: / 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 50: / 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 73: / 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 92: / 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 98: / 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 =====
-  * [[en:files:products:05-sensors| Documentation and related files for download]]
-  * [[https://www.unipi.technology/indoor-air-quality-sensor-p299?categoryId=43| Buy at Unipi]]
+<tile>
+| en:files:products:05-sensors:iaq            | Documentation and firmaware for download  | :en:files:unipi-kb-icon-os.png         |
+| en:hw:05-sensors:iaq-eshop-redirect-hidden  | Buy at Unipi e-shop                       | :files:unipi-kb-icon-shopping-cart-outline.png  |
+</tile>