Re: [PATCH] Documentation: add mips boards files

[Sascha Hauer <s.hauer@pengutronix.de>]

On Sat, Jun 28, 2014 at 08:29:19PM +0400, Antony Pavlov wrote:
> Signed-off-by: Antony Pavlov <antonynpavlov@gmail.com>
> ---
>  Documentation/boards/mips.rst               |  9 ++++
>  Documentation/boards/mips/dlink-dir-320.rst | 44 +++++++++++++++++++
>  Documentation/boards/mips/loongson_ls1b.rst | 56 ++++++++++++++++++++++++
>  Documentation/boards/mips/qemu-malta.rst    | 19 ++++++++
>  Documentation/boards/mips/ritmix-rzx50.rst  | 62 ++++++++++++++++++++++++++
>  Documentation/boards/mips/tplink-mr3020.rst | 67 +++++++++++++++++++++++++++++
>  6 files changed, 257 insertions(+)

Applied, thanks

Sascha

> 
> diff --git a/Documentation/boards/mips.rst b/Documentation/boards/mips.rst
> new file mode 100644
> index 0000000..4bac35f
> --- /dev/null
> +++ b/Documentation/boards/mips.rst
> @@ -0,0 +1,9 @@
> +MIPS
> +====
> +
> +.. toctree::
> +  :glob:
> +  :numbered:
> +  :maxdepth: 1
> +
> +  mips/*
> diff --git a/Documentation/boards/mips/dlink-dir-320.rst b/Documentation/boards/mips/dlink-dir-320.rst
> new file mode 100644
> index 0000000..74d11ff
> --- /dev/null
> +++ b/Documentation/boards/mips/dlink-dir-320.rst
> @@ -0,0 +1,44 @@
> +D-Link DIR-320
> +==============
> +
> +The D-Link DIR-320 wireless router has
> +
> +  * BCM5354 SoC;
> +  * 32 MiB SDRAM;
> +  * 4 MiB NOR type Flash Memory;
> +  * RS232 serial interface (LV-TTL levels on board!);
> +  * 1xUSB interface;
> +  * 4 + 1 ethernet interfaces;
> +  * 802.11b/g (WiFi) interface;
> +  * JTAG interface;
> +  * 5 LEDs;
> +  * 2 buttons.
> +
> +The router uses CFE as firmware.
> +
> +Running barebox
> +---------------
> +
> +Barebox can be started from CFE using tftp.
> +You must setup tftp-server on host 192.168.0.1.
> +Put your barebox.bin to tftp-server directory
> +(usual /tftpboot or /srv/tftp).
> +Connect your DIR-320 to your tftp-server network via
> +one of four <LAN> sockets.
> +
> +Next, setup network on DIR-320 and run barebox.bin, e.g.::
> +
> +  CFE> ifconfig eth0 -addr=192.168.0.99
> +  CFE> boot -tftp -addr=a0800000 -raw 192.168.0.1:barebox.bin
> +
> +
> +Links
> +-----
> +
> +  * http://www.dlink.com.au/products/?pid=768
> +  * http://wiki.openwrt.org/toh/d-link/dir-320
> +
> +CFE links:
> +
> +  * http://www.broadcom.com/support/communications_processors/downloads.php#cfe
> +  * http://www.linux-mips.org/wiki/CFE
> diff --git a/Documentation/boards/mips/loongson_ls1b.rst b/Documentation/boards/mips/loongson_ls1b.rst
> new file mode 100644
> index 0000000..a833a86
> --- /dev/null
> +++ b/Documentation/boards/mips/loongson_ls1b.rst
> @@ -0,0 +1,56 @@
> +Loongson LS1B
> +=============
> +
> +The LS1B is a development board made by Loongson Technology Corp. Ltd.
> +
> +The board has
> +
> +  * Loongson LS1B SoC 250 MHz;
> +  * 64 MiB SDRAM;
> +  * 512 KiB SPI boot ROM;
> +  * 128M x 8 Bit NAND Flash Memory;
> +  * 2 x RS232 serial interfaces (DB9 connectors);
> +  * 2 x Ethernet interfaces;
> +  * 4 x USB interfaces;
> +  * microSD card slot;
> +  * LCD display (480x272);
> +  * audio controller;
> +  * beeper;
> +  * buttons;
> +  * EJTAG 10-pin connector.
> +
> +The board uses PMON2000 as bootloader.
> +
> +Running barebox
> +---------------
> +
> +  1. Connect to the boards's UART2;
> +
> +  2. Turn board's power on;
> +
> +  3. Wait ``Press <Enter> to execute loading image`` prompt and press the space key.
> +
> +  4. Build barebox and upload ``zbarebox.bin`` via Ymodem to the board:
> +
> +.. code-block:: none
> +
> +    PMON> ymodem base=0xa0200000
> +
> +..
> +
> +  5. Run barebox
> +
> +.. code-block:: none
> +
> +    PMON> g -e 0xa0200000
> +
> +..
> +
> +Links
> +-----
> +
> +  * http://en.wikipedia.org/wiki/Loongson
> +  * http://www.linux-mips.org/wiki/Loongson
> +  * https://github.com/loongson-gz
> +  * http://www.linux-mips.org/wiki/PMON_2000
> +  * http://www.opsycon.se/PMON2000/Main
> diff --git a/Documentation/boards/mips/qemu-malta.rst b/Documentation/boards/mips/qemu-malta.rst
> new file mode 100644
> index 0000000..be89ae3
> --- /dev/null
> +++ b/Documentation/boards/mips/qemu-malta.rst
> @@ -0,0 +1,19 @@
> +QEMU Malta
> +==========
> +
> +QEMU run string::
> +
> +  qemu-system-mips -nodefaults -M malta -m 256 \
> +      -nographic -serial stdio -monitor null \
> +      -bios barebox-flash-image
> +
> +Also you can use GXemul::
> +
> +  gxemul -Q -x -e maltabe -M 256 0xbfc00000:barebox-flash-image
> +
> +Links
> +-----
> +
> +  * http://www.linux-mips.org/wiki/Mips_Malta
> +  * http://www.qemu.org/
> +  * http://gxemul.sourceforge.net/
> diff --git a/Documentation/boards/mips/ritmix-rzx50.rst b/Documentation/boards/mips/ritmix-rzx50.rst
> new file mode 100644
> index 0000000..a51fe3f
> --- /dev/null
> +++ b/Documentation/boards/mips/ritmix-rzx50.rst
> @@ -0,0 +1,62 @@
> +Ritmix RZX-50
> +=============
> +
> +Ritmix RZX-50 is a portable game console for the Russian market.
> +
> +The portable game console has
> +
> +  * Ingenic JZ4755 SoC;
> +  * 64 MiB SDRAM;
> +  * 4 GiB microSDHC card / 4 GiB NAND type Flash Memory (internal boot device);
> +  * RS232 serial interface (LV-TTL levels on the board!);
> +  * LCD display (480x272);
> +  * Video out interface;
> +  * 1xUSB interface;
> +  * buttons.
> +
> +The game console uses U-Boot 1.1.6 as bootloader.
> +
> +Running barebox
> +---------------
> +
> +  1. Connect to the game console's UART
> +     (see. http://a320.emulate.su/2012/01/19/uart-na-ritmix-rzx-50/);
> +
> +  2. Unblock U-Boot console
> +     (see. http://a320.emulate.su/2012/01/25/rzx-50-dostup-k-konsoli-u-boot/);
> +     Please note that U-Boot's Zmodem support does not work;
> +
> +  3. Boot Ritmix linux and login;
> +
> +  4. Build barebox and upload ``barebox.bin`` via Zmodem to the board:
> +
> +.. code-block:: none
> +
> +    # cd /tmp
> +    # rz
> +
> +..
> +
> +  5. Write barebox to onboard flash:
> +
> +.. code-block:: none
> +
> +    # dd if=barebox.bin of=/dev/mmcblk0 seek=1048576 bs=1 count=262144
> +
> +..
> +
> +  6. Reboot RZX-50, next in U-Boot console start barebox:
> +
> +.. code-block:: none
> +
> +  CETUS # msc read 0xa0800000 0x100000 0x40000; g a0800000
> +
> +..
> +
> +
> +Links
> +-----
> +
> +  * http://www.ritmixrussia.ru/products/252/entertainment/game/rzx-50
> +  * ftp://ftp.ingenic.cn/2soc/4755/JZ4755_ds.pdf
> +  * ftp://ftp.ingenic.cn/3sw/01linux/01loader/u-boot/u-boot-1.1.6-jz-20110719-r1728-add-jz4770.patch.bz2
> diff --git a/Documentation/boards/mips/tplink-mr3020.rst b/Documentation/boards/mips/tplink-mr3020.rst
> new file mode 100644
> index 0000000..c9e092c
> --- /dev/null
> +++ b/Documentation/boards/mips/tplink-mr3020.rst
> @@ -0,0 +1,67 @@
> +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.
> +
> +The ``mktplinkfw`` utility can be obtained from openwrt, e.g.::
> +
> +  $ 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::
> +
> +  $ lzma -c -k barebox.bin > barebox.lzma
> +  $ ./FW/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.::
> +
> +  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/
> -- 
> 1.9.2
> 
> 

-- 
Pengutronix e.K.                           |                             |
Industrial Linux Solutions                 | http://www.pengutronix.de/  |
Peiner Str. 6-8, 31137 Hildesheim, Germany | Phone: +49-5121-206917-0    |
Amtsgericht Hildesheim, HRA 2686           | Fax:   +49-5121-206917-5555 |

_______________________________________________
barebox mailing list
barebox@lists.infradead.org
http://lists.infradead.org/mailman/listinfo/barebox