Example: Reverting to a Previous Version¶
In our next example we are going to assume that we have just updated to the 2.1.5 firmware; however, for some reason we are not satisfied with how the device is behaving and we want to return back to 2.1.4. With the Updater utility this is easy to do.
Before we begin lets make sure your device is connected and has power. Refer to the Getting Started page for additional information.
Locating the previous firmware:¶
Using the ‘-B’ command we can request the available builds for a given device. Since firmware is specific to each device we must also supply the device’s serial number with the ‘-d’ parameter.
$> ./Updater -B -d 6FCBBAA4
Below you will see what was printed on my machine [1]. All we need to do is take note of the specific build number that is associated with the version we would like to revert to.
2017:05:10:18:10:05 | Updater [Version: 1.1 May 1 2017 13:59:12]
[BrainStem Release:2.3.12] [Copyright (C) 1994-2016, Acroname Inc.]
2017:05:10:18:10:05 |
Build List for device[6FCBBAA4]:
2017:05:10:18:10:06 | Build Version
2017:05:10:18:10:06 | 219607159 2.2.0
2017:05:10:18:10:06 | 111486747 2.2.1
2017:05:10:18:10:06 | 231932966 2.2.2
2017:05:10:18:10:06 | 156729307 2.2.3
2017:05:10:18:10:06 | 25628300 2.2.4
2017:05:10:18:10:06 | 250406850 2.2.5
2017:05:10:18:10:06 | 226315939 2.2.6
2017:05:10:18:10:06 | 33051391 2.2.7
2017:05:10:18:10:06 | 130872794 2.2.8
2017:05:10:18:10:06 | 131823882 2.3.0
2017:05:10:18:10:06 | 119187462 2.3.1
2017:05:10:18:10:06 | 9473450 2.3.10
2017:05:10:18:10:06 | 4719070 2.3.11
2017:05:10:18:10:06 | 5329028 2.3.12
2017:05:10:18:10:06 | 130782904 2.3.2
2017:05:10:18:10:06 | 70185126 2.3.3
2017:05:10:18:10:06 | 72872664 2.3.4
2017:05:10:18:10:06 | 8157420 2.3.5
2017:05:10:18:10:06 | 10682084 2.3.6
2017:05:10:18:10:06 | 10941901 2.3.7
2017:05:10:18:10:06 | 3196158 2.3.9
2017:05:10:18:10:06 | Completed processing: Updater [Version: 1.1 May 1 2017 13:59:12]
[BrainStem Release:2.3.12] [Copyright (C) 1994-2016, Acroname Inc.]
Applying a specific build to a device:¶
As previously explained we are hypothetically having issues with our device after updating and we want to revert to a previous version. Now that we have located the previous build number lets apply it by adding the “-b” parameter to the last command in the example before.
$> ./Updater -G -U -d 0x3797E6F8 -b 99528558
You should see something similar to the below output.
Home directory:[/Users/Mitch]
Application parameters:[Updater]
[Updater]
[-U]
[-d]
[0x3797E6F8]
[-b]
[99528558]
Updater [Version 0.2 Nov 25 2015 09:59:24] [Copyright (C) 1994-2015, Acroname Inc.]
Update using firmware file [/Users/Mitch/.acroname/updater/3797E6F8/99528558.bird].
Transferring loader to device
Transferring loader block 0, 8296 bytes
Transferred 1 blocks, 8296 total bytes
Transferring firmware to device [/Users/Mitch/.acroname/updater/3797E6F8/99528558.bird]
Transferring firmware block 0, 8296 bytes
Transferring firmware block 1, 772 bytes
Transferring firmware block 2, 48776 bytes
Transferred 3 blocks, 57844 total bytes
Completed updating firmware on device [3797E6F8]
Completed processing: Updater [Version 0.2 Nov 25 2015 09:59:24] [Copyright (C)
1994-2015, Acroname Inc.]
Confirm that you have successfully restored the old firmware:¶
Just to be safe lets confirm that we have successfully restored the old firmware. This can be done by issuing the discover command.
$> ./Updater -D
As you can see the device is now running the 2.1.4 firmware.
Home directory:[/Users/Mitch]
Application parameters:[Updater]
[Updater]
[-D]
Updater [Version 0.2 Nov 25 2015 09:59:24] [Copyright (C) 1994-2015, Acroname Inc.]
Discovering Devices [USB]:
Device Module Router Model Firmware Version
3797E6F8 02 02 04 [USBStem ] 2.1.4
Discovering Devices [TCPIP]:
Device Module Router Model Firmware Version
856C1C03 06 06 05 [EtherStem ] 2.1.1 [10.128.38.159]
Completed processing: Updater [Version 0.2 Nov 25 2015 09:59:24] [Copyright (C)
1994-2015, Acroname Inc.]