Skip to content

Firmware Update

In order to update the firmware of your Tap device, you need to have your Taps properly registered. See this guide to learn how to register Taps.

Once registered, you will be able to perform firmware updates with the Tap Cloud web application, within IoTize Studio or with the Command Line Interface tool

Updating the firmware is a standard lwM2M command that can be run by any incoming protocol:

  • NFC, BLE, WiFi ...
  • UART if you perform the update at the production stage,
  • MQTT for a remote operation. Updating through MQTT takes typically 30 minutes, but it can be done in background.

Note that a Tap reset will be performed after uploading the new firmware in order to take it into account.

Tap Cloud

Update directly from Tap Cloud

If your PC is BLE enabled with Windows 10 (version 10586 or higher) and Chrome, connect to the Tap via IoTize Cloud and do the following:

  1. Open the menu and click on the Firmware Update button.

  2. You are prompted to logon as admin (default password admin).

  3. Check the Serial number is your Tap. Click Next.
  4. Select where to get your firmware update from: Use Firmware Update Generator Server.
  5. Logon to your Cloud Account.
  6. Select the latest firmware version available for your product (or some other version).
  7. Click on Load to device.
  8. You can see the progression steps of the update. Expect about 5 minutes to perform a complete firmware update through BLE.
  9. Then you get a message Device is restarting, followed by a success message.

Your device is now up-to-date with the latest firmware.

Generate Firmware Update file

From your IoTize Cloud account:

  • Go to the 'Devices' page and select one of them:
  • Click on the Firmware update button and select the version by clicking on the DOWNLOAD button:

This file can be used by IoTize Studio or the Command Line Interface to perform the firmware update (See below)

IoTize Studio

Generate Firmware Update file

IoTize Studio can connect to your IoTize Cloud account and download the latest firmware update available to your Tap. If you need a specific firmware version, generate it from the Tap Cloud web app.

  • Open your project with IoTize Studio, and check the connection to your Tap. This will allow Studio to ask for the specific Firmware Update file for your current Tap
  • Click on Configuration | Generate Firmware Update File to download the latest firmware update for your Tap.If you are not logged in on IoTize Studio, you will be asked for your IoTize Cloud credentials.

You will find the file in the 'tmp' directory of the project folder.

Update from a Firmware file

  • Check the connection to the Tap you wish to update.
  • Click on Configuration | Update Tap Firmware, and select your Firmware file.
  • Check the update status in the output view of IoTize Studio.
  • Once it is done, check again the firmware version in the Tap.

CLI

For the command-line solution, follow the instructions below:

  1. After downloading the update file from either from Tap Cloud, or from Studio, if it is in a zip archive, unzip it. When dowloaded from Tap Cloud, you have to rename the 'tapnlink' file with .izsp as suffix (e.g. tapnlink.izsp).

  2. Type cmd in the Search or Run line, and press Enter.

  3. Type iotize_pgm for a complete list of available commands.
  4. Type cd pathname\directory\folder to the folder of the update file.
  5. Apply the update file:
    • In Socket, type: iotize_pgm GS,<IPAddress> U<Filename.izsp>
      For example: iotize_pgm GS,192.168.20.104 UTAP_1.1_ESP32_NFC_WIFI_BLE.izsp
    • In BLE, type: iotize_pgm GB,<BLEAddress> U<Filename.izsp>
      For example: iotize_pgm GB,C1:6A:62:78:6F:78 UTAP_1.1_ESP32_NFC_WIFI_BLE.izsp
    • In UART, type: iotize_pgm GU,<COMPortNumber> U<Filename.izsp>
      For example: iotize_pgm GU,COM4 UTAP_1.1_ESP32_NFC_WIFI_BLE.izsp

Important note

By default, the firmware update files are encrypted with a unique key associated to the specified TAP. This key is a Read Only data and it is programmed once by IoTize during manufacturing.

For production batches, it is also possible to keep a single key for a set of taps dedicated to a single application. Contact IOTIZE or your distributor if you need a single key for several TAPs. This mode will allow to broadcast a single firmware update file to several taps.