===== ===== {{ :enginko_logo_colori_exe.jpg?nolink&200 }} ===== EGK-LW20W00 Operating Manual ===== === Important safety information === {{:warning.png?80 }}Read this manual before attempting to install the device! Failure to observe recommendations included in this manual may be dangerous or cause a violation of the law. The manufacturer will not be held responsible for any loss or damage resulting from not following the instructions of this operating manual. * Do not dismantle or modify in any way. * The device is not intended to be used as a reference sensor, and Angel4Future Srl will not be held liable for any damage which may result from inaccurate readings. * Avoid mechanical stress * Do not use any detergent or alcohol to clean the device. * Risk of explosion if the battery is replaced with an incorrect type. * Risk of explosion if the battery pack is subjected to a short circuit. * Risk of explosion if the battery is burned or placed near high heat sources. * Risk of explosion if batteries are crushed, punctured or cut. * Do not expose batteries to contact with liquid substances. === Disposal information for users === {{:wiki:manual_mcf-lw12co2e:1200px-weee_symbol_vectors.svg.png?50 }}**Pursuant to and in accordance with Article 14 of the Directive 2012/19/EU of the European Parliament on waste electrical and electronic equipment (WEEE), and pursuant to and in accordance with Article 20 of the Directive 2013/56/EU of the European Parliament on batteries and accumulators and waste batteries. ** The barred symbol of the rubbish bin shown on the equipment indicates that, at the end of its useful life, the product must be collected separately from other waste. Please note that the lithium batteries must be removed from the equipment before it is given as waste and disposed separately. To remove the batteries refer to the specifications in the user manual. For additional information and how to carry out disposal, please contact the certified disposal service providers. ===== 1. Description ===== The EGK-LW20W00 is a battery powered sensor intended for waste level measurement up to 1.5 meters. The device sends collected data over the LoRaWAN® network. {{ :wiki:manual_egk-lw20w00:egk-lw20w00.jpg?200 |}} ===== 2. Overview ===== ==== 2.1 Technical data ==== * CPU ARM Cortex M4 * Class A LoRaWAN® 1.0.2 , EU868 * OTAA/ABP activation * Level range 165 ÷ 1500mm, resolution 1mm, accuracy TBD * Field of View: ±15° * Non contact level detection up to 1.5mt * Internal temperature measurement (+/- 1°C typ, +/- 2°C max). * Embedded antenna * Magnetic start-up * Time interval based or thresholds based uplink * Embedded accelerometer for tilt status * Primary battery with no harmful substances, replacement possible * Pole or surface mount * 5 years life time with SF12 and max Tx power, 48 Uplinks messages per day * Transmission @ 868 MHZ, 14dBm max. * BLE 5.0 interface for configuration, data reading and FW upgrade * Remote configuration * Storage temperature -30°C ÷ +80°C * Working temperature -30°C ÷ +65°C * Dimensions: 64.5×58.5x39mm * Protection grade: IP67 * Weight: 90g ==== 2.2 Installation ==== To ensure correct operation and reliable and consistent level measurements, install the EGK-LW20W00 sensor on the lid interior. Screws are provided. The device must be placed where the LoRaWAN® signal coverage is good (SF = 7 optimal, SF = 12 weak). The device measures the distance to the closest target on its field of view. It works with different waste materials like organic, glass, paper, plastic, residual waste. The measure is performed periodically according to parameter Period [min]. {{ :wiki:manual_egk-lw20w00:lid1.jpg?600 }} Alternatively, the sensor can be mounted to overfill detection on the side of the lid: {{ :wiki:manual_egk-lw20w00:side1.jpg?600 }} In this case, level parameters need to be modified. __**Custom brackets available on request.**__ === 2.2.1 Bin lid or side mount === For mounting onto the lid or side of the bin, use the provided screws and spacers: {{ :wiki:manual_egk-lw20w00:bin_mount.jpg }} == 2.2.1.1 Lid mount examples == {{ :wiki:manual_egk-lw20w00:120l-a.jpg?direct&800 }} {{ :wiki:manual_egk-lw20w00:660l.jpg?direct&800 }} === 2.2.2 Wall mount === For mounting onto wall, use the __optional__ wall mount bracket **EGK-RAWALL**: {{ :wiki:manual_egk-lw20l00:wall_mount.jpg }} {{ :wiki:manual_egk-lw20w00:egk-rawall.jpg?direct&600 }} === 2.2.3 Pole mount === For installation on poles, pillars or posts use the included bracket and fasteners: {{ :wiki:manual_egk-lw20l00:pole_mount_1.jpg }} === 2.2.4 LoRa Tool === To deploy the sensor, download the latest __**LoRa Tool**__ Android App to setup LoRaWAN® credentials and other preferences : [[https://play.google.com/store/apps/details?id=com.mcf88.loratool.client&hl=en&gl=US|{{:wiki:manual_mcf-lw12co2e:lora_tool.jpg?nolink&100|lora_tool.jpg}}]] === 2.2.5 Connection === Enable the Bluetooth on the smartphobne and open the App: {{ :wiki:manual_egk-lw20l00:bt_scan.jpeg?400 }} once the sensors list appears (as BLE MAC address), select the sensor you need to configure: {{ :wiki:manual_egk-lw20l00:bt_mac.jpg?400 }} and read it: {{ :wiki:manual_egk-lw20l00:bt_read.jpg?400 }} ==== 2.3 Power ON/OFF ==== The sensor is shipped completely off to prevent battery consumption during storage. It is therefore necessary to carry out a first power-on prior to commissioning. To power on the sensor: lay the magnet at the bottom of the provided tool into the area shown in the figure: {{ :wiki:manual_egk-lw20w00:on_mag.jpg }} Successful power on is signaled by the flashing of the 2 LEDs. In case of long period of inactivity, if necessary, is possible to shut-off again the sensor to prevent battery consumption, via downlink or with LoRa Tool App: {{ :wiki:manual_egk-lw20l00:bt_off.jpg?400 }} ==== 2.4 System leds ==== [[:wiki:manual_egk-lw20l00:egk-lw20w00_led.jpg?id=manual_egk-lw20w00&media=wiki:manual_egk-lw20l00:egk-lw20w00_led.jpg|{{ :wiki:manual_egk-lw20l00:egk-lw20w00_led.jpg?400 }}]] |LoRaWAN® not configured| {{:wiki:manual_mcf-lw12co2e:gfrf_rev0.jpg?80}} |Slow flashing| |Joining| {{:wiki:manual_mcf-lw12co2e:gf_ev0.jpg?40}} |Quick flashing| |Sending| {{:wiki:manual_mcf-lw12co2e:gf_ev0.jpg?40}} |Quick flashing| ==== 2.5 Battery ==== This sensor contains lithium battery, which must be disposed of separately. EGK-LW20W00 is provided with a battery pack: ^Code ^Description| |EGK-1S2PCR| 4800mAh battery pack | __Replacement battery only available from Angel4Future.__\\ This is the estimated battery life (in **years**) in the worst conditions: | ^10min reading ^15min reading ^30min reading | ^SF12 | 2 | 3 | 5 | ^SF7 | 4 | 5 | 8 | === 2.5.1 Battery replacement === * remove the front panel of the sensor with a small screwdriver: {{ :wiki:manual_egk-lw20l00:batt0.jpg?nolink&400 }} * remve the PCB batteries pack from the main board (PCB board is secured with two small screws): {{ :wiki:manual_egk-lw20l00:batt2.jpg?nolink&400 }} {{ :wiki:manual_egk-lw20l00:batt3.jpg?nolink&400 }} * Place the new PCB batteries pack and put them in place with the screws: {{ :wiki:manual_egk-lw20l00:batt1.jpg?nolink&400 }} * Place the front panel and fix it with the 4 screws. __After the batteries replacement, internal counters need to be resetted.__ {{ :wiki:manual_mcf-lw12terwp:batt_res.jpg?400 }} To perform the operation, you need a unique reset code that must be requested to Angel4Future (please provide the DevEUI of the sensor when you ask for that code): {{ :wiki:manual_mcf-lw12co2e:battery_res_0.jpg?400 }} At the end of the procedure the battery level displays 100%. ==== 2.6 Firmware update ==== Download the latest firmwares available on the smartphone: {{ :wiki:manual_egk-lw20w00:update_firmwares.jpg?direct&400 }} Upload it with LoraTool App: {{ :wiki:manual_egk-lw20l00:bt_fw.jpg?400 }} ===== 3. Measures ===== On each reading of the sensor by LoraTool, the measured distance is shown on the main page: {{ :wiki:manual_egk-lw20w00:egk-lw20w20_dist.jpg?400 }} The temperature value is measured inside the sensor. Once provisioned on a LoRaWAN® network, the device sends the distance, temperature, filling level & timestamp to the server via uplink. ==== 3.1 Level settings ==== Level measurements are carried out according to few parameter settings. A target over the defined range cannot be detected. Read and write of parameters can be done using LoRaTool App. They have a default value and can be modified to be tailored on the specific use case. Meaning of parameters is related to following diagram. The "REFERENCE" (distance=0mm) is the top surface of the sensor: {{ :wiki:manual_egk-lw20w00:distances.jpg?300 }} === 3.1.1 Start [mm] === Starting point of the measurement (in mm from "REFERENCE" point). Values can be set from 140 to 1360: {{ :wiki:manual_egk-lw20w00:start_1.jpg?400 |start_1.jpg}} __Default: 150__ A target within the "Start [mm]" distance will result at a “Start” distance. The "Start [mm]" value is also related to other level parameters. Contact Angel4Future in case of assistance. === 3.1.2 End [mm] === Range of measure (in mm, from "Reference" point). Values can be set from 0 to 2000: {{ :wiki:manual_egk-lw20w00:end_1.jpg?400 |end_1.jpg}} __Default: 1010__ The END value can be inferred from a physical measurement of obtained from the sensor itself using the function "Calculate Floor" {{ :wiki:manual_egk-lw20w00:end_1.jpg?400 |Floor_1.jpg}} __After executing this function, perform a new reading and validate the value obtained.__ === 3.1.3 Power === Power setting for target detection. Values can be set from 1 to 5: {{ :wiki:manual_egk-lw20w00:power_1.jpg?400 |power_1.jpg}} __Default: 2__ === 3.1.4 Sort === Sorting type. Values can be set from 0 to 3: {{ :wiki:manual_egk-lw20w00:sort_1.jpg?400 |sort_1.jpg}} __Default: 0__ === 3.1.5 Avg === Number of samples for each measure Values can be set from 1 to 100: {{ :wiki:manual_egk-lw20w00:avg_1.jpg?400 |avg_1.jpg}} __Default: 10__ === 3.1.6 Algorithm === {{ :wiki:manual_egk-lw20w00:alg_1.jpg?400 |alg_1.jpg}} __Default: Standard__ === 3.1.7 Threshold type === Values can be set from 0 to 2: {{ :wiki:manual_egk-lw20w00:thr_1.jpg?400 |thr_1.jpg}} __Default: 2__ ==== 3.2 Input ==== The input status represents the status of the accelerometer (Input = 1 start of accererometer event start, input = 0 end of accelerometer event). ===== 4 LoRaWAN network ===== The sensor is compliant with LoRaWAN® specification 1.0.2. {{ :wiki:manual_mcf-lw12co2e:activation2_0.jpg?400 }} ==== 4.1 Activation ==== The device supports the following activations on a LoRaWAN® network: - **NONE**: sensor not activated - **OTAA**: the JoinEUI and the AppKey not setted, must be written to the device; - **OTAA MCF88**: Over the air activation, fixed keys: JoinEUI = 904e915000000001, AppKey on request; - **OTAA ENGINKO**: Over the air activation, fixed keys: JoinEUI = 904e915000000001, AppKey on request; - **ABP**: requires writing to the device of NwkSkey, AppSkey, DevAddr. {{ :wiki:manual_mcf-lw12co2e:activation1_0.jpg?400 }} The device exits factory activated with **OTAA ENGINKO** mode. On request devices can be shipped aleady activated. Note: in **OTAA** AppKey is write only, in reading the field will always be empty, even if set. ---- === Time sync === {{:warning.png?50}} Normally sensor asks for a time sync at every power on (uplink starting with 01) or once a week. If no or wrong reply received it will retry after 1 week. If not handled in the right way can cause a unnecessary battery consumption. Please check chapter 2.1 [[:data_frame_format|DATA FRAME FORMAT]]. ==== 4.2 Other settings ==== {{ :wiki:manual_mcf-lw12co2e:activation3_0.jpg?400 |activation3_0.jpg}} **Network settings**: please keep "Any" settings. Change it only if Objenious network is used (default_ any). **Network type**: LoRa syncword can be setted as "private"(0x12) instead "public" (0x34), but __the NS must be setted accordingly__ (default: public). **Band**: select the right LoRaWAN ® band settings accodingly to country requirements. {{ :wiki:manual_egk-lw20l00:bt_set1.jpg?400 |bt_set1.jpg}} **DST**: set to change DST (default: none). **No time sync**: set to disable time synchronization request (default: enabled). **UnConfirmed**: set for unconfirmed uplinks (default: confirmed uplink). **Led OFF**: set to disable the led. **Single join/day**: set for to allow only one join per day (default: multiple join allowed). **Period**: time interval between two measures (in minutes). **Clock timed**: set to sincronize the reading with the internal clock. **Accelerometer**: set to enable asynchronous measure in case of shaking. After the first accelerometer event, the device will not send any message for 3 minutes after the last accelerometer event: {{ :wiki:manual_egk-lw20w00:accelerometer.jpg?nolink&800 |}} ===== 5 Passwords ===== The device can be protected by passwords, to avoid unauthorized persons to read data or modify parameters. As default passwords are equal to 0. Allowed values range from 0 to 999999999 (only numbers). To change the passwords, set the new values with the LoRa Tool App: {{ :wiki:manual_mcf-lw12co2e:password1_0.jpg?400 }} Once the passwords are setted, to gain access from LoRa Tool to the sensor, open the App: {{ :wiki:manual_egk-lw20l00:bt_scan.jpeg?400 }} and set the right values before reading from the device: {{ :wiki:manual_mcf-lw12co2e:password2_0.jpg?400 }} To bring back the sensor to factory default and reset the passwords, a reset code must be requested to Angel4Future (please provide the DevEUI of the sensor when you ask for that code). ===== 6 Configuration file ===== WIth LoRa Tool App is possible to configure the device using an XML file, instead to manually adjust the parameters (for details about the file format please ask to Angel4Future). This is very useful especially in case of multiple devices configuration. With "Save" button an XML file with the actual configuration of the sensor will be generated. This is useful to store or clone the configuration, or to send it to Angel4Future's support if needed. {{ :wiki:manual_mcf-lw12co2e:files_rev0.jpg?400 }} ==== 6.1 Multi devices configuration ==== WIth LoRa Tool App is possible to configure many devices in an easy way. For multi-configuration is needed at least one XML file with the parameters to set. Settings on this file will be applied to all the sensors. With an additional XLS file is possible to load different LoRa configuration parameters (Activation Type, AppKey, AppEUI, NetKey, DevAddress, Band, Private option) for each sensor, based on DevEUI. When the sensor is approached, if one parameter is different from files, the APP will ask you if you want to overwrite. XLS is prevailing on the XML, so if both files are enabled, if the DevEUI of the device matches one of the DevEUIs in the XLS file, LoRa parameters will be setted from this one. These configuration can be done in the in the Settings: * Enable or disable the use of the general configuration by file; * Enable or disable the use of the specific configuration by file; * Verify the passwords; * Writing the passwords. {{ :wiki:manual_mcf-lw12co2e:multiple_rev0.jpg?400 }} For details on files format please ask to Angel4Future. ===== 7 LoRaWEB Tool ===== Angel4Future provides free **LoRaWEB** online tool, where for each sensor it is possible to find documentation, javascript examples for parsing, downlink generator and uplink decoder: [[https://iot.mcf88.cloud/LoRaWeb/#/configuration|LoRaWEB Tool]] (iot.mcf88.cloud/LoRaWeb) {{ :wiki:manual_mcf-lw12co2e:lt1_0.jpg?600 }} {{ :wiki:manual_mcf-lw12co2e:lt2_0.jpg?600 }} ===== 8 Payload ===== For payload descriptions, uplinks and downlinks format and available commands please refer to this document: [[:data_frame_format|DATA FRAME FORMAT]] ===== 9 Ordering code ===== ^ Ordering Code ^ Description ^ | EGK-LW20W00 | LoRaWAN® waste level sensor | | EGK-LW20W10 | LoRaWAN® waste level sensor with external antenna | | EGK-RAWALL | Wall mount bracket | ===== 10 Declaration of conformity ===== Declarations of conformity are available from Angel4Future by sending a request email to sensor@enginko.com. ===== 11 Contacts ===== **Angel4Future S.r.l.** \\ Via San Sabino 21 - 70042 MOLA DI BARI (BA) , ITALY \\ T : +39 080 532 1796 \\ E : info@angel4future.com \\ W: enginko.com \\ ---- Document rev. 5 ----