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
  • What is in the package
  • Connecting the FPK to Vicki via the Laptop
  • Connecting to the USB ports
  • Connecting the Vicki
  • Starting the Firmware Upgrade

Was this helpful?

  1. Others
  2. Device Firmware upgrade via a Field Programming Kit (FPK)

Vicki Firmware Upgrade

PreviousDevice Firmware upgrade via a Field Programming Kit (FPK)NextThe Things Industries / TTN V3

Last updated 3 months ago

Was this helpful?

The procedure is straightforward and will be described in text form. In addition, example videos will be included to better illustrate how to properly upgrade a Vicki via the Field Programming Kit (FPK).

What is in the package

You should have received the following devices with the FPK:

  1. A pre-configured laptop with the required software already installed and a box containing the tools.

  2. An FTDI to USB converter (small dongle with a cable attached).

  3. STM32 programmer and custom board/cable attached (white device with the ST logo in blue). Note that the orientation of the small breakout board needs to be as in the image (instructions are engraved on the components itself).

  4. A 3D printed adapter with connector receptacles that fits into the Vicki battery compartment (it is shaped like a battery set).

Connecting the FPK to Vicki via the Laptop

Connecting to the USB ports

Start by connecting the cables of both devices to 2 of the USB ports of the laptop. They are long enough to not prevent you from executing the rest of the procedure (the video reference uses an USB hub for convenience, your laptop will not need one).

Connecting the Vicki

You will notice that the ST Device has a cable with 5 wires/pins and the FTDI converted has one with 4. These are matched by the receptacles on the 3D printed adapter, there is a set of 4 and a set of 5. We have put labels for your convenience on the 3D printed adapter. In addition they need to have the right orientation, each cable has one wire market in red. You need to plug in the cables in such a way that the colored wires are in the last receptacle, facing outwards (there also red markings on the body of the device, so match red with red).

Refer to the image below if in doubt.

Once you are done you can take out the batteries from Vicki and insert the 3D printed adapter in their place. The adapter needs to be inserted a certain way for the upgrade to work properly. The pogo pins at the bottom end are what connects to the circuit board and the part needs to be inserted in such a way that they are in the battery compartment with the "+" marking.

Refer to the image below:

Everything should be properly connected now and you should be able to start the Upgrade on the Laptop.

You need to press down on the 3D printed adapter with sufficient force to make sure it makes good contact with the circuit board. The upgrade will fail otherwise.

If still in doubt, watch the video below:

Starting the Firmware Upgrade

We have made a short screen recording for your convenience on how the procedure should go.

  • Log into Windows and start the tool via the shortcut on the Desktop

The windows credentials are as follows: Username: MClimate Password: fieldkit

  • An automatic message pops up which you should close with the "OK" button.

  • Select the COM port from the drop down menu (there should be only a single COM to choose from, but incase you have another device connected it might happen there are additional ones). If you select the wrong port there will be an error as in the video below. Switch to another till you find the right one.

  • Press on the "Program" button.

  • Wait for the procedure to finalize, it should take less than 10 second, two command windows should pop up one after another. After, your result should light in Green.

It is possible the procedure fails (marked by a Result in RED). In this case disconnect and reconnect the device and Vicki and restart the Software tool, initiating the procedure anew.

We have put two videos below one for the successful case and one for the failed one for your reference

Successful Upgrade Video

Failed Upgrade Video

Connecting the field Kit to Vicki
Wrong port selection
Successful Upgrade
Failed Upgrade
FPK package
Box contents
FTDI converter
STM32 programmer
3D printed adapter
Connecting the cables to the adapter
3D part orientation