summaryrefslogtreecommitdiffstats
path: root/Documentation/boards/mips/tplink-mr3020.rst
blob: 99101c337d2ebeedc1d4e64cf9e95cde0955cf2b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
TP-LINK MR3020
==============

The TP-LINK MR3020 wireless router has

  * Atheros ar9331 SoC;
  * 32 MiB SDRAM;
  * 4 MiB NOR type SPI Flash Memory;
  * RS232 serial interface (LV-TTL levels on board!);
  * 1 USB interface;
  * 1 Ethernet interfaces;
  * 802.11b/g/n (WiFi) interface;
  * LEDs & buttons.

The router uses U-Boot 1.1.4 as firmware.

Running barebox
---------------

Barebox can be started from U-Boot using tftp.
But you have to encode barebox image in a very special way.

First obtain ``lzma`` and ``mktplinkfw`` utilities.

The ``lzma`` utility can be obtained in Debian/Ubuntu
distro by installing lzma package
(lzma from xz-utils package is unusable).

The ``mktplinkfw`` utility can be obtained from openwrt, e.g.:

.. code-block:: sh

  $ OWRTPREF=https://raw.githubusercontent.com/mirrors/openwrt/master
  $ curl -OL $OWRTPREF/tools/firmware-utils/src/mktplinkfw.c \
          -OL $OWRTPREF/tools/firmware-utils/src/md5.c \
          -OL $OWRTPREF/tools/firmware-utils/src/md5.h
  $ cc -o mktplinkfw mktplinkfw.c md5.c

To convert your barebox.bin to U-Boot-loadable image (``6F01A8C0.img``)
use this command sequence:

.. code-block:: sh

  $ lzma -c -k barebox-flash-image > barebox.lzma
  $ ./mktplinkfw -c -H 0x07200103 -W 1 -N TL-WR720N-v3 \
      -s -F 4Mlzma -k barebox.lzma -o 6F01A8C0.img

You must setup tftp-server on host 192.168.0.1.
Put your ``6F01A8C0.img`` to tftp-server directory
(usual ``/tftpboot`` or ``/srv/tftp``).

Connect your board to your tftp-server network via Ethernet.

Next, setup network on MR3020 and run ``6F01A8C0.img``, e.g.:

.. code-block:: console

  hornet> set ipaddr 192.168.0.2
  hornet> set serverip 192.168.0.1
  hornet> tftpboot 0x81000000 6F01A8C0.img
  hornet> bootm 0x81000000


Links
-----

  * http://www.tp-link.com/en/products/details/?model=TL-MR3020
  * http://wiki.openwrt.org/toh/tp-link/tl-mr3020
  * https://wikidevi.com/wiki/TP-LINK_TL-MR3020

See also

  * http://www.eeboard.com/wp-content/uploads/downloads/2013/08/AR9331.pdf
  * http://squonk42.github.io/TL-WR703N/