Update the firmware

When new features are developed or bugs are fixed we will release new versions of the SCK firmware.

Info

If you already configured your kit on the smartcitizen platform you will need the token that the platform gave you during the onboarding process, to recover it from your kit:

  1. Click your kit button until the kit is in setup mode, the led should be red.
  2. Connecto to the kit with your mobile device as you did during the onboarding process.
  3. Write down the token of your kit.

After updating the firmware follow this same steps to input the token and wifi credentials, after this your kit will be publishing on the same registered device than before.

A note about versions

✅ The guide below applies to both, SCK 2.0 and SCK2.1.

Updating your kit is very simple

  • Connect your kit with a micro USB cable to your computer.
  • Double click the reset button of your SCK, the SCK led should turn green and a new drive called SCK-20 should appear on your computer file browser.
  • Inside the SCK-20 drive you should see some files, double click the INDEX.HTM file and our github releases page will open in your browser. Download the new firmware called SAM_firmware_XXX.uf2 and save it to your computer.

Tip

You can backup your current firmware version just saving the file called CURRENT.UF2.

  • Simply drag the firmware file you downloaded over the SCK-20 drive, your kit led will blink in green and after some seconds it will reset and start with the new version.

  • If your Wi-Fi module needs a firmware update when you connect to your kit to setup the network you will see a screen that will ask for the new file. You can find it in our github releases page, look for the file called ESP_firmware_XXX.bin. If you don't see it, check in a previous release (some releases don't include Wi-Fi firmware).

  • After the update you just done, you can configure your kit as a new device following the onboarding process or use your previous token as explained before.

Obtain your firmware version remotely (advanced)

If you are an advance user managing a big deployment of devices you can obtain remotely the version of all the Kits you have registered by looking at the hardware_info property of each of your devices using the platform API /v0/devices/. When your Kit is in Wi-Fi mode, it publishes the information daily.

"hardware_info": {
    "id": "DFD098A750515157382E3120FF101D12",
    "mac": "B6:E6:2D:66:47:6D",
    "time": "2020-04-14T03:00:24Z",
    "esp_bd": "",
    "hw_ver": "2.1",
    "sam_bd": "2019-11-27T12:49:13Z",
    "esp_ver": "",
    "sam_ver": "0.9.6-4e90c77"
}

More info in the platform API documentation.