diff mbox series

[v9,12/12] doc: boards: add Cubieboard7 documentation

Message ID 1585725575-8050-13-git-send-email-amittomer25@gmail.com
State Superseded
Headers show
Series Actions S700 SoC support | expand

Commit Message

Amit Tomer April 1, 2020, 7:19 a.m. UTC
This adds build and flash steps for Actions S700
based Cubieboard7 board.

Signed-off-by: Amit Singh Tomar <amittomer25 at gmail.com>
---
Changes since v8:
        * No changes.
Changes since v7:
        * No changes.
Changes since v6:
        * No changes.
Changes since v5:
        * No changes.
Changes since v4:
        * No changes.
Changes since v3:
        * Convert plain text documentation to reStructuredText format.
Changes since v2:
        * No Change.
Changes since v1:
        * No Change.
---
 doc/board/actions/cubieboard7.rst | 115 ++++++++++++++++++++++++++++++++++++++
 doc/board/actions/index.rst       |  10 ++++
 doc/board/index.rst               |   1 +
 3 files changed, 126 insertions(+)
 create mode 100644 doc/board/actions/cubieboard7.rst
 create mode 100644 doc/board/actions/index.rst

Comments

Manivannan Sadhasivam April 5, 2020, 7:21 a.m. UTC | #1
On Wed, Apr 01, 2020 at 12:49:35PM +0530, Amit Singh Tomar wrote:
> This adds build and flash steps for Actions S700
> based Cubieboard7 board.
> 
> Signed-off-by: Amit Singh Tomar <amittomer25 at gmail.com>
> ---
> Changes since v8:
>         * No changes.
> Changes since v7:
>         * No changes.
> Changes since v6:
>         * No changes.
> Changes since v5:
>         * No changes.
> Changes since v4:
>         * No changes.
> Changes since v3:
>         * Convert plain text documentation to reStructuredText format.
> Changes since v2:
>         * No Change.
> Changes since v1:
>         * No Change.
> ---
>  doc/board/actions/cubieboard7.rst | 115 ++++++++++++++++++++++++++++++++++++++
>  doc/board/actions/index.rst       |  10 ++++
>  doc/board/index.rst               |   1 +
>  3 files changed, 126 insertions(+)
>  create mode 100644 doc/board/actions/cubieboard7.rst
>  create mode 100644 doc/board/actions/index.rst
> 
> diff --git a/doc/board/actions/cubieboard7.rst b/doc/board/actions/cubieboard7.rst
> new file mode 100644
> index 0000000..ce39e6b
> --- /dev/null
> +++ b/doc/board/actions/cubieboard7.rst
> @@ -0,0 +1,115 @@
> +.. SPDX-License-Identifier: GPL-2.0+
> +.. Copyright (C) 2020 Amit Singh Tomar <amittomer25 at gmail.com>
> +
> +ACTIONS
> +========

I don't think ACTIONS heading is needed here. Change it to Cubieboard7 instead.

> +
> +About this
> +----------
> +
> +This document describes build and flash steps for Actions S700 SoC based Cubieboard7
> +board.
> +
> +Cubieboard7 initial configuration
> +---------------------------------
> +
> +Default Cubieboard7 comes with pre-installed Android where U-Boot is configured with
> +a bootdelay of 0, entering a prompt by pressing keys does not seem to work.
> +
> +Though, one can enter ADFU mode and flash debian image(from host machine) where
> +getting into u-boot prompt is easy.
> +
> +Enter ADFU Mode
> +----------------
> +
> +Before write the firmware, let the development board entering the ADFU mode: insert
> +one end of the USB cable to the PC, press and hold the ADFU button, and then connect
> +the other end of the USB cable to the Mini USB port of the development board, release
> +the ADFU button, after connecting it will enter the ADFU mode.
> +
> +Check whether entered ADFU Mode
> +--------------------------------
> +
> +The user needs to run the following command on the PC side to check if the ADFU
> +device is detected. ID realted to "Actions Semiconductor Co., Ltd"  means that
> +the PC side has been correctly detected ADFU device, the development board
> +also enter into the ADFU mode.
> +
> +.. code-block:: none
> +
> +   $ lsusb
> +   Bus 001 Device 005: ID 04f2:b2eb Chicony Electronics Co., Ltd
> +   Bus 001 Device 004: ID 0a5c:21e6 Broadcom Corp. BCM20702 Bluetooth 4.0 [ThinkPad]
> +   Bus 001 Device 003: ID 046d:c534 Logitech, Inc. Unifying Receiver
> +   Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
> +   Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
> +   Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
> +   Bus 003 Device 013: ID 10d6:10d6 Actions Semiconductor Co., Ltd
> +   Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
> +
> +Flashing debian image
> +---------------------
> +
> +.. code-block:: none
> +
> +   $ sudo ./ActionsFWU.py --fw=debian-stretch-desktop-cb7-emmc-v2.0.fw
> +   ActionsFWU.py	: 1.0.150828.0830
> +   libScript.so    : 2.3.150825.0951
> +   libFileSystem.so: 2.3.150825.0952
> +   libProduction.so: 2.3.150915.1527
> +   =====burn all partition====
> +   FW_VER: 3.10.37.180608
> +   3% DOWNLOAD ADFUDEC ...
> +   5% DOWNLOAD BOOT PARA ...
> +   7% SWITCH ADFUDEC ...
> +   12% DOWNLOAD BL31 ...
> +   13% DOWNLOAD BL32 ...
> +   15% DOWNLOAD VMLINUX ...
> +   20% DOWNLOAD INITRD ...
> +   24% DOWNLOAD FDT ...
> +   27% DOWNLOAD ADFUS ...
> +   30% SWITCH ADFUS ...
> +   32% DOWNLOAD MBR ...
> +   35% DOWNLOAD PARTITIONS ...
> +   WRITE_MBRC_PARTITION
> +   35% write p0 size = 2048 : ok
> +   WRITE_BOOT_PARTITION
> +   35% write p1 size = 2048 : ok
> +   WRITE_MISC_PARTITION
> +   36% write p2 size = 98304 : ok
> +   WRITE_SYSTEM_PARTITION
> +   94% write p3 size = 4608000 : ok
> +   FORMAT_SWAP_PARTITION
> +   94% write p4 size = 20480 : ok
> +   95% TRANSFER OVER ...
> +   Firmware upgrade successfully!
> +
> +Debian image can be downloaded from here[1].
> +
> +Once debian image is flashed, one can get into u-boot prompt by pressing any key and from
> +there run ums command(make sure, usb cable is connected between host and target):
> +
> +.. code-block:: none
> +
> +   owl> ums 0 mmc 1
> +
> +Above command would mount debian image partition on host machine.
> +
> +Building U-BOOT proper image
> +----------------------------
> +
> +.. code-block:: none
> +
> +   $ make clean
> +   $ export CROSS_COMPILE=aarch64-linux-gnu-
> +   $ make ARCH=arm cubieboard7_defconfig
> +   $ make -j16
> +   $ mkimage -A arm -T firmware -C none -O u-boot -a 0x11000000 -e 0x11000000 -d u-boot-dtb.bin u-boot-dtb.img  >/dev/null

Don't we get this image using `make u-boot-dtb.img` command?

Thanks,
Mani

> +
> +u-boot-dtb.img can now be flashed to debian image partition mounted on host machine.
> +
> +.. code-block:: none
> +
> +   $ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1024 seek=3072
> +
> +[1]: https://pan.baidu.com/s/1uawPr0Jao2HgWFLZCLzHAg#list/path=%2FCubieBoard_Download%2FBoard%2FCubieBoard7%2F%E6%96%B9%E7%B3%96%E6%96%B9%E6%A1%88%E5%BC%80%E5%8F%91%E8%B5%84%E6%96%99%2FImage%2FDebian%2FV2.1-test&parentPath=%2F
> diff --git a/doc/board/actions/index.rst b/doc/board/actions/index.rst
> new file mode 100644
> index 0000000..c596879
> --- /dev/null
> +++ b/doc/board/actions/index.rst
> @@ -0,0 +1,10 @@
> +.. SPDX-License-Identifier: GPL-2.0+
> +.. Copyright (C) 2020 Amit Singh Tomar <amittomer25 at gmail.com>
> +
> +Actions
> +========
> +
> +.. toctree::
> +   :maxdepth: 2
> +
> +   cubieboard7
> diff --git a/doc/board/index.rst b/doc/board/index.rst
> index 51a2ae6..01b233f 100644
> --- a/doc/board/index.rst
> +++ b/doc/board/index.rst
> @@ -6,6 +6,7 @@ Board-specific doc
>  .. toctree::
>     :maxdepth: 2
>  
> +   actions/index
>     AndesTech/index
>     atmel/index
>     coreboot/index
> -- 
> 2.7.4
>
diff mbox series

Patch

diff --git a/doc/board/actions/cubieboard7.rst b/doc/board/actions/cubieboard7.rst
new file mode 100644
index 0000000..ce39e6b
--- /dev/null
+++ b/doc/board/actions/cubieboard7.rst
@@ -0,0 +1,115 @@ 
+.. SPDX-License-Identifier: GPL-2.0+
+.. Copyright (C) 2020 Amit Singh Tomar <amittomer25 at gmail.com>
+
+ACTIONS
+========
+
+About this
+----------
+
+This document describes build and flash steps for Actions S700 SoC based Cubieboard7
+board.
+
+Cubieboard7 initial configuration
+---------------------------------
+
+Default Cubieboard7 comes with pre-installed Android where U-Boot is configured with
+a bootdelay of 0, entering a prompt by pressing keys does not seem to work.
+
+Though, one can enter ADFU mode and flash debian image(from host machine) where
+getting into u-boot prompt is easy.
+
+Enter ADFU Mode
+----------------
+
+Before write the firmware, let the development board entering the ADFU mode: insert
+one end of the USB cable to the PC, press and hold the ADFU button, and then connect
+the other end of the USB cable to the Mini USB port of the development board, release
+the ADFU button, after connecting it will enter the ADFU mode.
+
+Check whether entered ADFU Mode
+--------------------------------
+
+The user needs to run the following command on the PC side to check if the ADFU
+device is detected. ID realted to "Actions Semiconductor Co., Ltd"  means that
+the PC side has been correctly detected ADFU device, the development board
+also enter into the ADFU mode.
+
+.. code-block:: none
+
+   $ lsusb
+   Bus 001 Device 005: ID 04f2:b2eb Chicony Electronics Co., Ltd
+   Bus 001 Device 004: ID 0a5c:21e6 Broadcom Corp. BCM20702 Bluetooth 4.0 [ThinkPad]
+   Bus 001 Device 003: ID 046d:c534 Logitech, Inc. Unifying Receiver
+   Bus 001 Device 002: ID 8087:0024 Intel Corp. Integrated Rate Matching Hub
+   Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+   Bus 004 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
+   Bus 003 Device 013: ID 10d6:10d6 Actions Semiconductor Co., Ltd
+   Bus 003 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
+
+Flashing debian image
+---------------------
+
+.. code-block:: none
+
+   $ sudo ./ActionsFWU.py --fw=debian-stretch-desktop-cb7-emmc-v2.0.fw
+   ActionsFWU.py	: 1.0.150828.0830
+   libScript.so    : 2.3.150825.0951
+   libFileSystem.so: 2.3.150825.0952
+   libProduction.so: 2.3.150915.1527
+   =====burn all partition====
+   FW_VER: 3.10.37.180608
+   3% DOWNLOAD ADFUDEC ...
+   5% DOWNLOAD BOOT PARA ...
+   7% SWITCH ADFUDEC ...
+   12% DOWNLOAD BL31 ...
+   13% DOWNLOAD BL32 ...
+   15% DOWNLOAD VMLINUX ...
+   20% DOWNLOAD INITRD ...
+   24% DOWNLOAD FDT ...
+   27% DOWNLOAD ADFUS ...
+   30% SWITCH ADFUS ...
+   32% DOWNLOAD MBR ...
+   35% DOWNLOAD PARTITIONS ...
+   WRITE_MBRC_PARTITION
+   35% write p0 size = 2048 : ok
+   WRITE_BOOT_PARTITION
+   35% write p1 size = 2048 : ok
+   WRITE_MISC_PARTITION
+   36% write p2 size = 98304 : ok
+   WRITE_SYSTEM_PARTITION
+   94% write p3 size = 4608000 : ok
+   FORMAT_SWAP_PARTITION
+   94% write p4 size = 20480 : ok
+   95% TRANSFER OVER ...
+   Firmware upgrade successfully!
+
+Debian image can be downloaded from here[1].
+
+Once debian image is flashed, one can get into u-boot prompt by pressing any key and from
+there run ums command(make sure, usb cable is connected between host and target):
+
+.. code-block:: none
+
+   owl> ums 0 mmc 1
+
+Above command would mount debian image partition on host machine.
+
+Building U-BOOT proper image
+----------------------------
+
+.. code-block:: none
+
+   $ make clean
+   $ export CROSS_COMPILE=aarch64-linux-gnu-
+   $ make ARCH=arm cubieboard7_defconfig
+   $ make -j16
+   $ mkimage -A arm -T firmware -C none -O u-boot -a 0x11000000 -e 0x11000000 -d u-boot-dtb.bin u-boot-dtb.img  >/dev/null
+
+u-boot-dtb.img can now be flashed to debian image partition mounted on host machine.
+
+.. code-block:: none
+
+   $ sudo dd if=u-boot-dtb.img of=/dev/sdb bs=1024 seek=3072
+
+[1]: https://pan.baidu.com/s/1uawPr0Jao2HgWFLZCLzHAg#list/path=%2FCubieBoard_Download%2FBoard%2FCubieBoard7%2F%E6%96%B9%E7%B3%96%E6%96%B9%E6%A1%88%E5%BC%80%E5%8F%91%E8%B5%84%E6%96%99%2FImage%2FDebian%2FV2.1-test&parentPath=%2F
diff --git a/doc/board/actions/index.rst b/doc/board/actions/index.rst
new file mode 100644
index 0000000..c596879
--- /dev/null
+++ b/doc/board/actions/index.rst
@@ -0,0 +1,10 @@ 
+.. SPDX-License-Identifier: GPL-2.0+
+.. Copyright (C) 2020 Amit Singh Tomar <amittomer25 at gmail.com>
+
+Actions
+========
+
+.. toctree::
+   :maxdepth: 2
+
+   cubieboard7
diff --git a/doc/board/index.rst b/doc/board/index.rst
index 51a2ae6..01b233f 100644
--- a/doc/board/index.rst
+++ b/doc/board/index.rst
@@ -6,6 +6,7 @@  Board-specific doc
 .. toctree::
    :maxdepth: 2
 
+   actions/index
    AndesTech/index
    atmel/index
    coreboot/index