Skip to main content

YO Leak Guard

Overview​

Description​

YO Leak Guard is a LoRaWAN device for detecting leaks of conductive liquids such as water, weak acids and weak alkaline liquids. The device has two independent leak detection channels. Each channel uses a sensing cable that triggers an alarm when liquid touches it at any point along its length. The sensing cable is connected to the device with a non-sensing lead cable, so the device can be installed away from the monitored area. The device also reports when a sensing cable is disconnected. Additionally, the device measures temperature and relative humidity inside its enclosure.

Device top viewDevice top view

Figure 1. Device top view

Device sticker placed on the right side of the device enclosure contains information about model, version, LoRaWAN region and 3 parameters important in case of device identification and configuration:

  • DEV EUI: 64-bit unique device identifier in a LoRaWAN network,
  • DEV ADDR: address required to connect via ABP activation type to LoRaWAN,
  • BLE MAC: Bluetooth physical address.
Device stickerDevice sticker

Figure 2. Device sticker

Features​

  • LoRaWAN Technology: Available in multiple versions with LoRa radio configured for various regions and ISM frequency bands (e.g., EU868, US915, AU915, AS923), it is compatible with both private and public LoRaWAN networks and supports connections via ABP (Activation by Personalization) or OTAA (Over-The-Air Activation).
  • Bluetooth Low Energy (BLE): Enables easy configuration through a user-friendly JSON data exchange format, supports firmware updates via OTA (Over-the-Air), and boasts very low energy consumption.
  • Battery-Powered: 3x AA batteries, either alkaline 1.5 V (LR6) or lithium 3.6 V featuring very low self-discharge, ensuring long-term operation without the need for an external power supply.
  • Two Independent Leak Detection Channels: Each channel has its own sensing cable, so one device can monitor two separate areas.
  • Leak Detection Along the Whole Cable: The sensing cable detects liquid at any point along its length, covering a much larger area than a single-point sensor.
  • Fast Response and Automatic Reset: The sensing cable responds to a leak in less than 1 minute and returns to normal operation once it is dry, so it can be reused after a leak.
  • Cable Disconnection Detection: The device reports when a sensing cable is not connected.
  • Low False Alarm Rate: The spiral structure of the sensing cable reduces interference and false alarms.
  • Plug-and-Play Cables: Both cables are equipped with quick-connect terminals, making installation easy.
  • Temperature and Relative Humidity: Measures temperature and relative humidity within the device enclosure, providing valuable insights into the surrounding environment.
  • IP 67 and IK08 Protection: The robust enclosure ensures the device is dust-tight and protected against water immersion up to 1 meter for 30 minutes, as well as resistant to mechanical impacts, making it suitable for harsh environments.
  • Yosensi Management Platform: Provides a web tool for device configuration, firmware updates, and infrastructure management. Enables comprehensive monitoring of transmitted data and easy device management.
  • Yosensi Mobile App: Effortlessly manage devices with features to register new ones, configure settings, perform firmware updates, view/send logs, and test LoRaWAN connectivity. Learn more in our detailed Yosensi App blog post.

Specifications​

Physical​

Dimensions of the deviceDimensions of the device

Figure 3. Dimensions of the device

Device​

AttributeDescription
DimensionsHeight: 45.15 mm
Width: 81.55 mm
Depth: 151.55 mm
ColourLight Grey
Mounting methodHorizontal
Vertical (can be screwed to the wall)
Enclosure materialPolycarbonate
Level of protectionIP67, IK08
Weight (without batteries, excl. cables)215 g
Weight (with batteries, excl. cables)270 g

Leak Sensing Cable​

AttributeDescription
Number of channels2 (independent)
Included with the cableWaterproof terminator
Cable lengthDepends on the ordered cable (standard length: 5 m)
Cable extensionMultiple sensing cables can be connected together to extend the monitored length
Cable materialConductive polyethylene + alloy conductor
Core resistance13 Ω / 100 m
ColourYellow
Cable diameter6 mm
Breaking strength60 kg
Weight43 g/m
Maximum exposure temperature85°C
Response time< 1 min
Detected liquidsConductive liquids: water, weak acids, weak alkaline liquids
Not suitable forHazardous chemicals, solvents, oil, fuel, strong acids and other corrosive liquids
Leak locationDetected anywhere along the cable (the exact position of the leak is not reported)
Detection thresholdWater covering ≥ 3 cm of the cable at a depth of ≥ 1 mm (adjustable with the ch1sensitivity / ch2sensitivity parameters)
ConnectionQuick-connect terminals on both ends

Lead Cable​

The lead cable is a non-sensing cable that connects the device to the leak sensing cable. It does not react to liquids, which allows the device to be installed outside the monitored area.

AttributeDescription
Cable lengthDepends on the ordered cable (standard length: 5 m)
Cable extensionMultiple lead cables can be connected together to increase the distance between the device and the sensing cable
FunctionNon-sensing connection between the device and the leak sensing cable
ConnectionQuick-connect terminal on the sensing cable side

Operating Conditions​

°C°F
AttributeDescription
Temperature0°C to 70°C
Humidity0 to 90%
PlacementIndoor/Outdoor use
Power supply3 x LR6 (AA) alkaline battery (3 x 1.5 V) or
3 x AA lithium battery (3 x 3.6 V)
Power consumptionMaximum: 120 mA DC (4.5 V DC, alkaline) /
120 mA DC (10.8 V DC, lithium)

Measured Values​

°C°F
ParameterMeasurement rangeAccuracy
Temperature (internal)-40°C to 125°C±0.2°C (5°C to 60°C)
Relative humidity (internal)0% to 100%±2% (20% to 80%)
Leak state (per channel)0-3 (0 - dry, 1 - leak detected, 2 - cable not detected, 3 - not calibrated)-

Leak State Reporting​

The device checks both leak detection channels every minute, independently of the measurement interval (measinterval). Temperature, relative humidity and both leak states are also sent periodically with every measurement interval.

  • State change: when the leak state of a channel changes (e.g. a leak is detected or the cable dries), the device sends the data immediately.
  • Leak detected (1): while a leak is present, the device repeats the message about every 3 minutes until the cable is dry.
  • Cable not detected (2): the sensing cable, its waterproof terminator or the lead cable is disconnected or damaged.
  • Not calibrated (3): the device has not yet measured the dry cable reference for the channel. See Calibration.

Controls and Indicators​

LED Status Indicator​

YO Leak Guard communicates its current behaviour to the user by RGBW LED placed on the top.

Diode statuses interpretation​

The LED does not indicate the leak state. Leak states are reported over LoRaWAN only.

BehaviorColourStatus
Single flashGreenGeneral: device is working correctly (power and memory).
Single flashRedGeneral: device is working incorrectly (power and memory).
LoRaWAN communication: failed to receive an acknowledgement from LoRaWAN Server within specified timeout.
Single flashWhiteLoRaWAN communication: LoRaWAN frame sent / confirmation from LoRaWAN Server after receiving the frame.
Slow flashingBlueBLE communication: connection to the device via BLE (configuration).
Rapid flashingBlueLoRaWAN communication: connecting to LoRaWAN network.

Buttons​

The YO Leak Guard features a reset button located on the PCB, labeled "Reset". To reboot the device, simply press the button briefly.

Reset buttonReset button

Figure 4. Reset button

Installation​

Package Contents​

  1. Device (without batteries).
  2. Warranty card.

Lead cables and leak sensing cables are not included with the device. Each sensing cable comes with a waterproof terminator.


Safety Precautions​

NOTE

Go to the Safety Precautions section to see important information on handling, disposal and maintenance.

Setup Overview​

The figure below shows an example setup. The device is connected to the leak sensing cable through a non-sensing lead cable, so it can be mounted outside the monitored area. Further sensing cables or lead cables can be connected in a chain, and the free end of the last sensing cable is closed with the waterproof terminator. Leak states are sent over LoRaWAN to the Yosensi Platform and can be monitored in the mobile app.

The figure also shows the typical sensing cable layouts and the recommended and not recommended ways to secure the cable (see steps 6 and 7 of the Installation Guide).

Example setup and sensing cable layoutsExample setup and sensing cable layouts

Figure 5. Example setup and sensing cable layouts (click to enlarge)

Installation Guide​

  1. Unscrew the device: remove 4 screws from the enclosure.
Unscrewing the device top coverUnscrewing the device top cover

Figure 6. Unscrewing the device top cover

  1. Pass the lead cable through the cable gland.
    Inside the device, connect the two wires of the lead cable to the CH1+ and CH1- terminals of the green push-in connector. If you use the second channel, connect its lead cable to CH2+ and CH2-, passing it through the second cable gland.
    Push each wire firmly into its terminal until it is held in place. No tools are needed.
Lead cable passing through the cable gland instructionsLead cable passing through the cable gland instructions

Figure 7. Lead cable passing through the cable gland instructions

Lead cable connected to channel 1Lead cable connected to channel 1

Figure 8. Lead cable connected to channel 1

  1. Connect the leak sensing cable to the quick-connect terminal at the end of the lead cable. To extend the monitored length, connect further sensing cables to the end of the first one. Fit the waterproof terminator to the free end of the last sensing cable.
CAUTION

Connect the sensing cable with its waterproof terminator, and make sure the cable is clean and dry, before inserting the batteries. The device measures the dry cable reference right after start-up (see Calibration).

  1. Place three AA batteries (LR6 1.5 V alkaline or 3.6 V lithium) in the device according to the polarity indicated on the battery holder.
Battery placement instructionsBattery placement instructions

Figure 9. Battery placement instructions

  1. Assemble the device and screw it back together.

  2. Lay the leak sensing cable flat on the floor in the area to be monitored. Depending on the needs, the cable can be laid out in several ways (see Figure 5):

    • Full area coverage: the cable is laid in a serpentine pattern across the whole floor area.
    • Perimeter coverage: the cable runs along the edges of the room or area.
    • Equipment coverage: the cable is laid around or underneath equipment that may leak (e.g. air conditioning units, pumps, tanks, water heaters).
  3. Secure the leak sensing cable (see Figure 5):

    • Recommended: use dedicated cable clips, secure the cable with cable ties, or suspend it along pipes.
    • Not recommended: do not fix the cable with glue, do not bind it with metal, and do not place it directly under air conditioning vents, as this may cause false alarms or damage the cable.
    • Lay the cable flat and tight to the surface. When running it around pipes, do not twist or bunch it up.
    • Keep the cable away from foot traffic, sharp objects and heavy items that could roll or drop onto it.
    • Keep the cable away from air conditioning outlets and damp places, and keep the cable connectors out of water, to avoid false alarms.
  4. Install the device away from metal objects and other obstacles for the best LoRaWAN signal.

TIP

After a leak, the sensing cable returns to normal operation automatically once it is dry. Make sure the cable is clean and dry, and that the leak state is back to 0 (dry), before putting it back into operation.

Cleaning the Sensing Cable​

To clean the sensing cable, disconnect it from the lead cable, wipe it with alcohol or soapy water, and hang it up to dry completely before connecting it again.

Calibration​

Each leak detection channel needs a reference measurement of its dry cable. The device takes it automatically after start-up for every channel that is not calibrated yet. The calibration takes about 25 seconds, during which the cable must stay dry and must not be moved.

  • If the cable is wet, not connected, or the readings are unstable, the calibration is not saved. The device retries it with every measurement interval and reports leak state 3 (not calibrated) in the meantime.
  • When the calibration is done, the ch1calibration / ch2calibration parameter changes to done.
  • Calibrate the channel again whenever you change its cable setup (e.g. connect a different or additional sensing cable or lead cable): set ch1calibration / ch2calibration to start.

Configuration​

Configurable Parameters​

A few parameters must be set before sending data to the gateway. The default firmware is configured in OTAA mode with predefined deveui, appkey (OTAA) and appskey, nwkskey (ABP).

Configuration of the device is stored in a JSON file divided into the following sections:

  • info (generic, read only): information about the device,
  • general (generic): general device settings,
  • lorawan (generic): configuration data for LoRaWAN connection,
  • ble (generic): Bluetooth settings,
  • device (dynamic): individual configuration for a specific device (this section’s structure differs for each device),

Sample configuration file for the YO Leak Guard device.

{
"info": {
"devmodel": "LNLG",
"fwver": "1.0.0",
"loraradio": "SX1261",
"lorawanver": "1.0.2",
"loraregion": "EU868",
"blemacaddr": "0123456789ab"
},
"general": {
"rtcstate": "disable",
"periodicreboot": 14
},
"lorawan": {
"subband": 1,
"retrycnt": 1,
"nwktype": "public",
"acttype": "otaa",
"otaa": {
"deveui": "0123456789abcdef",
"appeui": "fedcba9876543210",
"appkey": "000102030405060708090a0b0c0d0e0f",
"trials": 3
},
"abp": {
"devaddr": "01234567",
"nwkskey": "0123456789abcdef0123456789abcdef",
"appskey": "000102030405060708090a0b0c0d0e0f"
}
},
"ble": {
"power": 0,
"interval": 1600
},
"device": {
"measinterval": 3600,
"ch1sensitivity": 6,
"ch2sensitivity": 6,
"ch1calibration": "done",
"ch2calibration": "done"
}
}

OTAA & ABP​

OTAAABP
Device EUIDevice Address
Application EUINetwork Session Key
Application KeyApplication Session Key
Number of Trials

Generic Parameters​

Parameters​

Device Parameters​

NameDescriptionPossible ValuesDefault ValueRead/Write
measintervalMeasuring and sending interval LoRa [s]601-9999993600R/W
ch1sensitivityLeak detection sensitivity of channel 1 (10 - the most sensitive)1-106R/W
ch2sensitivityLeak detection sensitivity of channel 2 (10 - the most sensitive)1-106R/W
ch1calibrationDry cable reference measurement of channel 1"start", "done""start"R/W
ch2calibrationDry cable reference measurement of channel 2"start", "done""start"R/W
  1. OTAA minimum 60 [s], ABP minimum 120 [s]

Parameters description

  • rtcstate: used for enabling/disabling the real-time clock (RTC) inside the device. The RTC is used for timestamping the measurements.
  • periodicreboot: number of days of continuous operation after which the device reboots preventively (0-60, 0 - disabled, default 14).
  • nwktype: used for setting the device in public or private network type.
  • acttype: used for setting the device in ABP or OTAA mode.
  • deveui, … , appskey: predefined addresses and keys, these parameters are generated using multiple IDs specific to the particular MCU and are unique for each device. They can be changed if needed.
  • interval: determines the interval of sending broadcast packets, used to connect to every BLE receiver around the device.
  • subband: used for setting the communication frequency sub-band in LoRaWAN.
  • retrycnt: number of retries to send a LoRa packet if the acknowledgement is not received from the LoRaWAN server.
  • measinterval: measurement interval [s] between sending LoRa packets. Leak states are checked every minute regardless of this value, see Leak State Reporting.
  • ch1sensitivity, ch2sensitivity: leak detection sensitivity of the channel. A higher value triggers the alarm with less liquid on the cable.
  • ch1calibration, ch2calibration: set to start to measure the dry cable reference of the channel again. The device changes the value to done after a successful calibration, see Calibration.

You can remotely adjust certain parameters by sending a downlink message through our platform. Simply navigate to the "COMMANDS" section for the selected device.

Update Measurement Interval​

It is possible to change the measurement interval (measinterval) by using downlink. Information about changing the parameter will be sent from the server via the gateway.

Example of Downlink Message:

  • Prefix: 0x03
  • Measurement Index: 0x00
  • Data (up to 4 bytes in hex): 0258

Sample Downlink: 0x03000258 - Sets a measurement interval of 600 seconds (10 minutes).


Payload Decoder​

If you want to connect to your own server, it is necessary to decode the specific payload for each device. To accomplish this, a payload decoder is required, which can be downloaded using the following link: Payload decoder. You can also use our integrated Payload Decoder here. Extended documentation of the protocol can be found in the Payload description on our website.