Open main menu


Affinity Firmware Recovery

This procedure should only be used under instruction from Güralp staff.
This procedure erases the file-system of the Affinity. All configuration will be lost and the unit will need to be reconfigured afterwards. If possible, please ensure that you have downloaded a configuration save-file To obtain a configuration save-file using the web interface, select the Configuration → Save/Restore menu item. In the resulting page, click the Download copy button next to the last Automatic backup or, if none are present, click the Back up current configuration button to create a new configuration file and then download it.

To obtain a configuration save-file from the command line, log in and enter the command config-backup --backup file-name
This will create a file file-name which you can then download.

If neither of these methods work (perhaps because a file-system has been remounted read-only), try using scp -p to copy all files from /var/lib/ and then keep the most recent.
before proceeding.
This procedure relies on network access to an upgrade server. Please ensure that you have access to any relevant information about your network before proceeding. In particular, if you do not use DHCP, you will need to know a valid IP address to use and the addresses of the network's default router and DNS server.
This procedure applies to Affinity digitisers only.

Affinity Firmware Recovery

This procedure re-formats the file-systems and reloads the operating system. The system serial number and calibration values for the internal ADCs are retained but all other configuration is lost. This procedure should only be used when other recovery avenues have been exhausted. In case of any doubt, please stop and contact for advice.


Equipment required:

Physical access to the Affinity will be required.

Your choice of Terminal Emulator

Specify your terminal emulator in order to see emulator-specific instructions throughout this document:

Preparing the user-programmable function keys

The procedure requires some text to be entered very quickly. The simplest way to achieve this is to configure the user-programmable function keys in the terminal emulator to generate the required strings. To do this:

Identifying the COM port

If your PC/laptop has a serial port, it should be labelled as COM1 or COM2. If you are using a USB-to-serial adaptor, you need to identify which COM port is allocated to it. To to this:

Configuring the emulator

If you are using a USB-to-serial adaptor, ensure that it is plugged in.

Booting into the service environment

Apply power to the Affinity. Around 15 lines of output will appear almost immediately, as shown below, ending with the line Enter enable string to access bootloader:

OK-1 OK-2 Booting with TI UBL Device OPP (300MHz, 1.2V) U-Boot 2013.07-00008-g34e445c-dirty (Jan 26 2015 - 14:56:42) I2C: ready DRAM: 128 MiB NAND: 1024 MiB MMC: davinci: 0 SF: Detected M25P64 with page size 64 KiB, total 8 MiB In: serial Out: serial Err: serial Net: DaVinci-EMAC Enter enable string to access bootloader

As soon as you see this, key f2. This will automatically type the correct "enable string", although it will not be echoed to the screen.

Wait half a second and then key f3. Wait another half second and then key f4. These two keystrokes send commands which configure the boot-loader and then instruct the Affinity to boot in service mode.

The Affinity will generate some output as it boots, ending with:

Enter enable string to access bootloader => setenv bootargs "quiet service" => run nor_boot SF: Detected M25P64 with page size 64 KiB, total 8 MiB SF: 7340032 bytes @ 0x100000 Read: OK ## Booting kernel from Legacy Image at c0700000 ... Image Name: Linux-3.10.0cmg-das+ Image Type: ARM Linux Kernel Image (uncompressed) Data Size: 5595816 Bytes = 5.3 MiB Load Address: c0008000 Entry Point: c0008000 Verifying Checksum ... OK Loading Kernel Image ... OK Starting kernel ... Uncompressing Linux... done, booting the kernel. [ 1.039886] serial8250 serial8250.0: unable to register port at index 0 (IO0 MEM1c42000 IRQ25): -22 Service mode. Press enter to log in.
The error message serial8250.0: unable to register port at index 0 is expected and is not a problem.

Immediately key enter and the system will print the service prompt:

service / #
If you are returned to the prompt Enter enable string to access bootloader, repeat the f2, f3, f4 sequence. If you are repeatedly returned to this prompt, stop and contact for advice.
If you do not see this output, power-cycle the Affinity and try again. The most common problem is not reacting quickly enough to the prompts.

Set up networking

The procedure requires access to the public Internet, so we need first to enable networking in the service environment. It is necessary to configure both the software loop-back adaptor, lo, and the physical adaptor, eth0.

To configure the loop-back adaptor, enter the following commands:

ip address add dev lo ip link set lo up ip route add via

The required configuration for eth0 depends on whether you use DHCP on your local network or not.

Set system date

The date must be set to something sensible because, otherwise, files will have incorrect modification times and this will cause various malfunctions. Enter the command date to check the system's idea of the current date. If the date shown as output is not correct, enter the command

date mmddHHMMYYYY


The date and time should be entered in UTC, regardless of your current time zone.


Perform the reformat

Now run the following commands:

wget sh

This will reformat the root, usr and var partitions and perform a preliminary reload of the Platinum operating system. When the script is complete, it will print the following banner:

=================================================== === Please power-cycle the Affinity to continue === ===================================================

Power-cycle the Affinity and allow it to boot. This will take longer than normal and there will be some unusual error messages, which can be ignored. Wait until you see the message System setup complete and then log in using the user-name root and password .

Once logged in, enter the commands

upgrade --force-factory-settings reboot

Allow the Affinity to boot again. This will, again, take longer than normal. Wait until you see the message System setup complete and log in again using the same credentials as last time.

Once logged in, using either the web interface or the command line, change the root password to something secure. From the web interface, visit Change password from the User: root menu.

If you prefer the command line, use the command passwd and follow the prompts.

Do not connect the unit to the Internet without first changing the root password. Strong passwords are essential for Internet-connected systems.

You can now proceed to load your saved configuration or, if you do not have a saved configuration, reconfigure the Affinity manually as required.

This concludes the procedure.

In case of any problems, please contact .