MClimate LoRaWAN Devices
  • Overview
  • FAQ
  • Firmware Upgrade Over The Air (FUOTA)
  • Devices
    • πŸ†•ΠœClimate 16A Dry Switch (16ADS)
      • πŸ₯³Release notes
      • πŸ› οΈHow to use
      • ⬆️MClimate 16ADS Uplink decoder
      • ⬇️MClimate 16ADS Downlink encoder
      • πŸ“–MClimate 16ADS Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Uplink types
        • Keep-alive
        • Overheating protection
        • Relay state 16ADS
        • LED indication mode
        • Network-related settings
        • Get Firmware & Hardware version
        • Restart device
    • πŸ†•ΠœClimate 16A Switch & Power Meter LoRaWAN (16ASPM)
      • πŸ₯³Release notes
      • πŸ› οΈHow to use
      • ⬆️MClimate 16ASPM Uplink decoder
      • ⬇️MClimate 16ASPM Downlink encoder
      • πŸ“–MClimate 16ASPM Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Uplink types
        • Keep-alive
        • Protections
        • Relay state 16ASPM
        • Clear accumulated energy
        • LED indication mode
        • Network-related settings
        • Get Firmware & Hardware version
        • Restart device
    • 😲MClimate Fan Coil Thermostat (FCT)
      • πŸ₯³Release notes
      • ⭐Getting started
      • ⚑Wiring Diagrams (Applications) & Operational Modes
      • ⬆️MClimate Fan Coil Thermostat Uplink decoder
      • ⬇️MClimate Fan Coil Thermostat Downlink encoder
      • πŸ“–MClimate Fan Coil Thermostat Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Keep-alive
        • ON/OFF & Target temperature
          • Valve(s) operation
          • Target temperature ranges
        • Fan Settings
          • Auto Fan - Ξ” settings
        • πŸ”“Keys lock
        • External temperature measurement
        • Power module communication status
        • Function of digital input/output (IO1 and IO2 ports)
          • Automatic changeover
          • Occupancy sensor
        • General, Display & Power recovery
          • Hiding data from the display & settings
          • Frost Protection
          • Temperature sensor errors
          • Network-related settings
            • Uplink types
          • User interface language
        • Restart device
    • ♨️MClimate Vicki LoRaWAN
      • πŸ₯³Release notes
      • ⬆️Vicki Uplink Decoder
      • ⬇️Vicki Downlink Encoder
      • πŸ“–Vicki LoRaWAN Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Uplink types
        • Keep-alive
        • Manual target temperature change
        • Operational modes & temperature control algorithms
          • Algorithm 1 - Equal directional control
          • Algorithm 2 - Proportional control
          • Algorithm 3 - Proportional Integral
        • External temperature measurement and internal temperature offset
        • Control target temperature and/or motor position and range
        • Recalibrate motor command explanation
        • Read device hardware and software version command explanation.
        • Anti-freeze functionality
        • Open window detection
        • Child lock
        • Target temperature ranges
        • Temperature units
        • Force-close & Force-attach
        • Network-related settings
        • Appendix (examples)
      • πŸ“ΊTechnical Deepdive Webinar
    • πŸ†•MClimate CO2 Display lite
      • πŸ₯³Release notes
      • ⬆️MClimate CO2 Display lite Uplink decoder
      • πŸ“–CO2 Display lite Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Uplink types
        • Keep-alive
        • CO2 measurement settings
        • Hiding data from the display
        • Child lock
        • Network-related settings & Others
        • Get Firmware & Hardware version
        • Restart device
    • MClimate CO2 Display
      • πŸ₯³Release notes
      • ⬆️MClimate CO2 Display Uplink decoder
      • πŸ“–CO2 Display Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Uplink types
        • Keep-alive
        • CO2 measurement settings
        • Hiding data from the display
        • Child lock
        • PIR (Motion sensor)
        • Network-related settings & Others
        • Get Firmware & Hardware version
    • MClimate Wireless Thermostat
      • πŸ₯³Release notes
      • ⬆️MClimate Wireless Thermostat Uplink decoder
      • ⬇️MClimate Wireless Thermostat Uplink encoder
      • πŸ“–Wireless Thermostat Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Uplink types
        • Keep-alive
        • Target Temperature & Temperature range
        • Sensor mode & hiding data from the display
        • Heating status flag
        • Child lock
        • PIR (Motion sensor)
        • Get Firmware & Hardware version
        • Network-related settings & Others
    • MClimate HT Sensor LoRaWAN
      • πŸ₯³Release notes
      • ⬆️HT Sensor Uplink Decoder
      • πŸ“–HT Sensor LoRaWAN Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Temperature and humidity compensation
        • Keep-alive
        • Read device hardware and software version command explanation.
        • Network-related settings
        • Uplink types
        • Appendix (examples)
    • MClimate CO2 Sensor and Notifier LoRaWAN
      • πŸ₯³Release notes
      • ⬆️CO2 Sensor Uplink Decoder
      • πŸ“–CO2 Sensor LoRaWAN Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Keep-alive
        • Read device hardware and software version command explanation.
        • Network-related settings
        • Uplink types
        • CO2 boundary levels
        • CO2 auto-zero value
        • CO2 auto-zero period
        • CO2 Measurement period
        • Notifications configuration
    • MClimate Open/Close Sensor LoRaWAN
      • πŸ₯³Release notes
      • ⬆️Open/Close Sensor uplink decoder
      • πŸ“–Open/Close sensor LoRaWAN communication protocol
        • Commands cheat sheet
        • Keep-alive
        • Read device hardware and software version command explanation
        • Uplink types
        • Network-related settings
        • Event notification
        • Notification Blind Time
        • LED control command explanation
        • Restart device
    • MClimate Multipurpose Button LoRaWAN
      • πŸ₯³Release notes
      • ⬆️Multipurpose Button Uplink decoder
      • πŸ“–MClimate Button LoRaWAN Device communication protocol
        • Commands cheat sheet
        • Keep-alive
        • LEDs, button press types and behaviour
        • Read device hardware and software version command explanation
        • Network-related settings
        • Uplink types
        • Button press event counters
        • LED control command explanation
        • Restart device
    • MClimate T-Valve LoRaWAN
      • πŸ₯³Release notes
      • ⬆️T-Valve Uplink Decoder
      • T-Valve LoRaWAN communication protocol
        • Commands cheat sheet
        • Uplink types
        • Keep-alive
        • Valve state control
        • Set LED behavior
        • Buzzer control
        • Emergency openings
        • Enable/disable manual valve open/close
        • Flood alarm time
        • Keep-alive period
        • Request Long data packet
        • Device allowed working voltage
        • Enable/Disable device flood sensor
        • Network related settings
        • Deactivate device (non-operational mode, save power)
    • MClimate Flood Sensor LoRaWAN
      • πŸ₯³Release notes
      • ⬆️Flood Sensor Uplink Decoder
      • πŸ“–Flood Sensor LoRaWAN communication protocol
        • Commands cheat sheet
        • Keep-alive
        • Flood event - Available configurations
        • Uplink types
        • Network-related settings
        • Read Firmware & Hardware version
        • Custom control of LED and Acoustic Buzzer
        • Read device parameters command
        • Restart device
    • MClimate AQI Sensor and Notifier LoRaWAN
      • πŸ₯³Release notes
      • AQI Sensor Uplink Decoder
      • AQI Sensor Downlink encoder
      • AQI Sensor LoRaWAN Device communication protocol
        • Communication concepts
        • Commands cheat sheet
        • Keep-alive
        • Read device hardware and software version command explanation.
        • Network-related settings
        • Uplink types
        • Device buzzer control command
        • Device LED’s control
        • Appendix (examples)
  • Others
    • Application of MClimate Vicki to One-pipe steam heating systems
    • Battery Lifetime Estimation Methodology
    • Discover Smart Buildings solutions
    • How to solve Large space heating issues
    • Device Firmware upgrade via a Field Programming Kit (FPK)
      • Vicki Firmware Upgrade
  • Integrations
    • The Things Industries / TTN V3
    • ThingPark Enterprise
    • ThingPark Community
    • Tektelic
    • Helium
    • Chirpstack
    • Loriot
    • Kerlink
    • Melita
    • MachineQ
    • Orbiwise
    • Firefly
    • B-One
    • Milesight
    • Akenza
    • Element-IoT
    • Senet
    • Wattsense
    • RAK WisGateOS2
    • Netmore
Powered by GitBook
On this page
  • Set Open/Close state short cycle
  • Set Open/Close state extended cycle
  • Single time limited valve state change
  • General valve state control

Was this helpful?

  1. Devices
  2. MClimate T-Valve LoRaWAN
  3. T-Valve LoRaWAN communication protocol

Valve state control

Set Open/Close state short cycle

This command sets up the valve so it alternates between its two states (open/close) for a certain time interval. The whole process is cyclical, meaning it can go indefinitely depending on how it is set up or the valve can move from one state to the other and remain in it.

This command is mainly useful for Firmware Version ≀ 1.4 where the extended cycle command below is not available.

The command explanation is in the table below.

Byte index

Hex value - Meaning

0

01 – The command code.

1

XX – time the valve will be opened for in minutes

2

XX – time the valve will be closed for in minutes

Example command: 0x010203

02[HEX] = 02[DEC] -> the valve will be opened for 2 minutes

03[HEX] = 03[DEC] -> the valve will be closed for 3 minutes

At this point it will open again for 2 minutes, close for 3 after, etc.

Example command: 0x010200

02[HEX] = 02[DEC] -> the valve will be opened for 2 minutes

00[HEX] = 00[DEC] -> the valve will be closed for 0 minutes (never closed)

In this case the command will keep the valve permanently open until another command instructs it to close.

Example command: 0x010003

00[HEX] = 00[DEC] -> the valve will be opened for 0 minutes (never opened)

03[HEX] = 03[DEC] -> the valve will be closed for 3 minutes

In this case the command will keep the valve permanently closed until another command instructs it to open.

Set Open/Close state extended cycle

This command is similar to the 01 command above, however it support extended timings. These timings are also reported in the device long keep-alive data. When some of the timings parameter is greater or equal to 255, it's reported as 255 in the long keep-alive data.

We recommend using this command for Firmware Versions β‰₯1.5 as it has the same functionality as the 01 command however it offers extended timings.

The command explanation is in the table below.

Byte index

Hex value - Meaning

0

0D – The command code.

1

XX – valve open time in minutes, bits 15:8

2

XX – valve open time in minutes, bits 7:0

3

XX - valve close time in minutes, bits 15:8

4

XX - valve close time in minutes, bits 7:0

Value of 0 for the open/close time isn't accepted by the device.

Example command: 0x0D012C2760

012C[HEX] = 300[DEC] = 300 minutes = 5 hours -> the valve will be opened for 5 hours

2760[HEX] = 10 080[DEC] = 10 080 minutes = 7 days-> the valve will be closed for 7 days

So, the valve will open for 5 hours after seven days have elapsed, indefinitely

The command explanation is in the table below.

Byte index

Hex value - Meaning

0

0E – The command code.

1

XX – valve open time in minutes, bits 15:8

2

XX – valve open time in minutes, bits 7:0

3

XX - valve close time in minutes, bits 15:8

4

XX - valve close time in minutes, bits 7:0

Example response: 0x0E012C2760

012C[HEX] = 300[DEC] = 300 minutes = 5 hours -> the valve will be opened for 5 hours

2760[HEX] = 10 080[DEC] = 10 080 minutes = 7 days-> the valve will be closed for 7 days

So, the valve will open for 5 hours after seven days have elapsed, indefinitely

Single time limited valve state change

This command is used to change the valve state for a defined time and leave it at the opposite after.

If you have used any of the commands above to cyclically open/close the valve, running this one will stop the cycle.

The command explanation is in the table below.

Byte index

Hex value - Meaning

0

14 – The command code.

1

XX – valve action: 0 - to close the valve for the defined time and open it after, 1 or bigger value - to open the valve for the defined time and close it after

2

XX – time duration in minutes, bits 15:8

3

XX - time duration in minutes, bits 7:0

Example command: 0x1401000A

01[HEX] = 1[DEC] opens the valve for 000A[HEX] = 10[DEC] = 10 minutes and leaves it closed after

Example command: 0x14000258

00[HEX] = 0[DEC] closes the valve for 0258[HEX] = 600[DEC] = 600 minutes = 6 hours and leaves it open after

General valve state control

Server send that command to simply open or close the valve forever.

If you have used any of the commands above to cyclically open/close the valve, running this one will stop the cycle.

The command explanation is in the table below.

Byte index

Hex value - Meaning

0

0C – The command code.

1

XX – the valve state to change to, 00[HEX] - close the valve, 01[HEX] open the valve

Any value for the command parameter greater than 01[HEX] opens the valve.

Example command: 0x0C00 -> Close the valve

Example command: 0x0C01 -> Open the valve

PreviousKeep-aliveNextSet LED behavior

Last updated 8 months ago

Was this helpful?