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 -GU -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.]
[1]This output was spliced in to reflect the changes in Updaters output. Therefor, the build numbers will not align with the rest of the example.