InfiniTime/doc/gettingStarted/updating-software.md

# Updating InfiniTime

If you just want to flash or upgrade InfiniTime on your PineTime, this page is for you! If you want more information about the software and the update procedure, check out [this](/doc/gettingStarted/about-software.md) page.

## Checking the version of InfiniTime

You can check the InfiniTime version by first swiping right on the watchface to open quick settings, tapping the cogwheel to open settings, swipe up until you find an entry named "About" and tap on it.

![InfiniTime 1.0 version](version-1.0.jpg)

PineTimes shipped after June 2021 will ship with the latest version of [the bootloader](https://github.com/JF002/pinetime-mcuboot-bootloader/releases/tag/1.0.0) and [recovery firmware](https://github.com/InfiniTimeOrg/InfiniTime/releases/tag/0.14.1)

The bootloader is run right before booting into InfiniTime. It is easily recognizable with its white pine cone that is progressively drawn in green. It also displays its own version on the bottom (1.0.0 as of now).

![Bootloader 1.0](bootloader-1.0.jpg)

## Updating with companion apps

To update your PineTime, you can use one of the [compatible companion applications](/README.md#companion-apps).

The updating process differs slightly on every companion app, so you'll need to familiarize yourself with the companion app of your choice.

All releases of InfiniTime are available on the [release page of the GitHub repo](https://github.com/InfiniTimeOrg/InfiniTime/releases) under assets.

To update the firmware, you need to download the DFU of the firmware version that you'd like to install, for example `pinetime-mcuboot-app-dfu-1.6.0.zip`, and flash it with your companion app.

We have prepared instructions for flashing InfiniTime with Gadgetbridge and NRFConnect.

 - [Updating with Gadgetbridge](/doc/gettingStarted/ota-gadgetbridge.md)
 - [Updating with NRFConnect](/doc/gettingStarted/ota-nrfconnect.md)

## Firmware validation

Firmware updates must be manually validated. If the firmware isn't validated and the watch resets, the watch will revert to the previous firmware. This is a safety feature to prevent bricking your device with faulty firmware.

You can validate your updated firmware on InfiniTime >= 1.0 by following this simple procedure:

 - From the watchface, swipe **right** to display the *quick settings menu*
 - Open settings by tapping the cogwheel on the bottom right
 - Swipe up until you find an entry named **Firmware** and tap on it
 - If the firmware is not validated yet, you can either validate the running firmware, or reset and revert to the previous firmware version
Split updating and about software. Remove big Contributing section from README 2021-11-14 13:23:12 +00:00			`# Updating InfiniTime`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
Split updating and about software. Remove big Contributing section from README 2021-11-14 13:23:12 +00:00			`If you just want to flash or upgrade InfiniTime on your PineTime, this page is for you! If you want more information about the software and the update procedure, check out [this](/doc/gettingStarted/about-software.md) page.`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
Split updating and about software. Remove big Contributing section from README 2021-11-14 13:23:12 +00:00			`## Checking the version of InfiniTime`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
			`You can check the InfiniTime version by first swiping right on the watchface to open quick settings, tapping the cogwheel to open settings, swipe up until you find an entry named "About" and tap on it.`

			`![InfiniTime 1.0 version](version-1.0.jpg)`

Split updating and about software. Remove big Contributing section from README 2021-11-14 13:23:12 +00:00			`PineTimes shipped after June 2021 will ship with the latest version of [the bootloader](https://github.com/JF002/pinetime-mcuboot-bootloader/releases/tag/1.0.0) and [recovery firmware](https://github.com/InfiniTimeOrg/InfiniTime/releases/tag/0.14.1)`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
Split updating and about software. Remove big Contributing section from README 2021-11-14 13:23:12 +00:00			`The bootloader is run right before booting into InfiniTime. It is easily recognizable with its white pine cone that is progressively drawn in green. It also displays its own version on the bottom (1.0.0 as of now).`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
			`![Bootloader 1.0](bootloader-1.0.jpg)`

Split updating and about software. Remove big Contributing section from README 2021-11-14 13:23:12 +00:00			`## Updating with companion apps`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
Link to companion apps 2021-11-08 15:42:42 +00:00			`To update your PineTime, you can use one of the [compatible companion applications](/README.md#companion-apps).`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
Update updating instructions 2021-11-07 17:38:54 +00:00			`The updating process differs slightly on every companion app, so you'll need to familiarize yourself with the companion app of your choice.`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
Summarize updating-softare 2021-11-08 15:37:25 +00:00			`All releases of InfiniTime are available on the [release page of the GitHub repo](https://github.com/InfiniTimeOrg/InfiniTime/releases) under assets.`
Update updating instructions 2021-11-07 17:38:54 +00:00
			To update the firmware, you need to download the DFU of the firmware version that you'd like to install, for example `pinetime-mcuboot-app-dfu-1.6.0.zip`, and flash it with your companion app.

			`We have prepared instructions for flashing InfiniTime with Gadgetbridge and NRFConnect.`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
			`- [Updating with Gadgetbridge](/doc/gettingStarted/ota-gadgetbridge.md)`
			`- [Updating with NRFConnect](/doc/gettingStarted/ota-nrfconnect.md)`

Split updating and about software. Remove big Contributing section from README 2021-11-14 13:23:12 +00:00			`## Firmware validation`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
Summarize updating-softare 2021-11-08 15:37:25 +00:00			`Firmware updates must be manually validated. If the firmware isn't validated and the watch resets, the watch will revert to the previous firmware. This is a safety feature to prevent bricking your device with faulty firmware.`
Documentation cleanup and reorganization 2021-11-06 12:38:11 +00:00
			`You can validate your updated firmware on InfiniTime >= 1.0 by following this simple procedure:`

			`- From the watchface, swipe right to display the quick settings menu`
			`- Open settings by tapping the cogwheel on the bottom right`
			`- Swipe up until you find an entry named Firmware and tap on it`
Summarize updating-softare 2021-11-08 15:37:25 +00:00			`- If the firmware is not validated yet, you can either validate the running firmware, or reset and revert to the previous firmware version`