flashing and debricking

Domino Pi is designed for you to play with OpenWrt and embedded systems. Before you continue to change your firmware, read the Working with serial section first.

Firmware compatibilities

Domino is compatible with some common OpenWrt firmwares for the Atheros 9331 SoC, including the firmware for GL-AR150, Carambola2 and Dragino. Due to size and configuration of the bootloader, Domino cannot boot firmware for TP-Link 703n, 720n without changing the bootloader.

Flashing firmware using the WebUI

We encourage you to flash your firmware using the WebUI provided. When viewing in "System" page, you will see the UI for you to upgrade/flash your firmware. System

If you want to upload your firmware in your disk, just click "Choose File" and upload the firmware. After upload you will be prompted with an option to "keep settings" or not. Then click "UPGRADE" to upgrade your firmware. You can also upgrade your firmware by clicking the "Download" button next to "Newest version".

System

ATTENTION: In firmware version 1.0 and 1.1, there is a bug for Chrome. Please use Firefox or IE for upgrading your firmware.

Flashing using uboot WebUI

In case you accediently brick your Domino firmware, you can debrick using uboot. You don't have to use serial if you want to use the uboot WebUI.

Step 1: Connection

Connect an Ethernet cable from your computer to Domino directly. Set your computer's IP address to 192.168.1.2 manually. If you are using a Dual-Ethernet tile board, only connect one Ethernet cable to your Domino kit.

uboot

Step 2: Activate the uboot WebUI

Press and hold the reset button while powering on your Domino. You will see the Blue LED for Wireless flashing. After it flashes 5 times, the WAN led will light up. Now release your finger. The WAN LED will flash quite quickly for some times.

Step 3: Flash firmware

Now use a web broser and go to http://192.168.1.1. You will then have the uboot WebUI as below.

uboot

Now choose your firmware and click "Update firmware". Wait about 3 minutes to allow your board to reset and boot.

ATTENTION: DON'T turn off the power during this process.

ATTENTION: Uboot wont check the validity of the firmware. Even if you flashed a wrong firmware, it will still write it to flash.

Flashing using uboot console

If your firmware still cannot boot up, try this advanced option. To use uboot console, please refer to Working with serial first.

ATTENTION: It is better to use a separate USB-UART adapter to use the uboot console. uboot boots very quickly, so you might not have time to enter the uboot console if you are using an integrated USB-UART bridge. Some systems, especially Windows, are slow to load the correct driver for you.

Enter the uboot console

In your serial term, press anykey when uboot boot and stop it in its console. Some version of uboot will ask your to type gl to enter the console.

uboot

Uboot environment variables

Type printenv to display the environment variables. Don't modify these variables if you are not sure what you are doing.

environment variables

Set up a tftp server

You need to set up a tftp server. In Windows, we recommend tftpd32 or tftpd64 according to your system architecture. Download them from junin.net.

In Linux, we recommend tftpd-hpa. Just search google for a guide to use this tool.

Update using the stored procedure

You can update your firmware or uboot very simply using the procedure stored as environment variables.

To update the firmware, name your firmware file as openwrt-domino.bin and put it in your tftp server. Then run run lf. Just wait until this process finish.

To update the uboot, name your uboot as uboot_for_domino.bin and run run lu to change the uboot itself.

ATTENTION: Changing uboot can be very dangerous. Do this at your own risk.

Update using uboot command

You can also update the firmware and everything else using the uboot command.

To update the firmware, use the following command. Replace with your own filename for your firmware.

tftp 0x81000000 openwrt-domino.bin
erase 0x9f050000 +$filesize
cp.b 0x81000000 0x9f050000 $filesize

To update the uboot, use the following command. Replace the filename as your real name.

tftp 0x81000000 uboot_for_domino.bin
erase 0x9f000000 0x40000
cp.b 0x81000000 0x9f000000 0x40000

ATTENTION: Changing uboot can be very dangerous. Do this at your own risk.

Debrick using SPI tile board

Please refer to JTAG/SPI tile board for debricking.