From patchwork Wed Oct 23 19:56:52 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jagan Teki X-Patchwork-Id: 879 Return-Path: X-Original-To: linux-amarula@patchwork.amarulasolutions.com Delivered-To: linux-amarula@patchwork.amarulasolutions.com Received: from mail-pg1-f200.google.com (mail-pg1-f200.google.com [209.85.215.200]) by ganimede.amarulasolutions.com (Postfix) with ESMTPS id 066D03F08B for ; Wed, 23 Oct 2019 21:57:35 +0200 (CEST) Received: by mail-pg1-f200.google.com with SMTP id w22sf7767325pgj.18 for ; Wed, 23 Oct 2019 12:57:34 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1571860653; cv=pass; d=google.com; s=arc-20160816; b=jR8Dki4cZc00oct0/XOupPRgNwzW4A3697uk0xYnFES2be9poDAsQ8kc5k5lHiax4V oMOznIt7tpa5NGHfQKpNk3X6+okvVSaPbgkuxn5fUlvGgAkvLicscJOmTEW9K9cR622V n3zKE+0xFY3M9EbDJZrBuKnweRANSQ6IpMjfim4kwsLzZ1NbNywdm9N3H47VGQVCDd8A WOkjbsof5SNtqd+gk1ayZBVS1D+6vmGAg1xeicHluKEqcPlc8W8VcVKk8czKFYASem4O zcVlMDT2e9Jd7SoPUin7sSLtWO3hvpznzBGK8AuXA8tprcmSatlK6OijjII9G4su9Xgr REog== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-archive:list-help:list-post:list-id :mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=t9GS4+GTkc6L4IU/szcxXH7KOGqO+BDxZaIQkjRCbDE=; b=Za2LW8jZ3sUbBy2MPqpw34MShg713R9UJHind7gDCYoQKKFsZsWWJIHifxf2jPPeGh SIqPBgeSmsi8AvJbRrw/crkPoX9PuMMvdCPyJzCu6DH42EZvNNBsnWjasUIeCM3ypUOc JINFxNu7CQSb+23m6YT2zS6aHyaBa/RV7Laza56qTLzM5qpBr4+Lm0hAOPPTPC3YZRx7 kBbWFtkE8LZFGYXQZtBawUKq/ye64SUQj2dHXFQ0hypHCtm96tgYy0y0EddNx/1KVEZ1 ciBjrIeLy/Dp29VWLxjcTj/aB84a4VqZC05Yd3yvxiOhBcXSf93pni0LNhrj11DMwiSd gxiQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=bY+O+beJ; spf=pass (google.com: domain of jagan@amarulasolutions.com designates 209.85.220.65 as permitted sender) smtp.mailfrom=jagan@amarulasolutions.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amarulasolutions.com; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-unsubscribe; bh=t9GS4+GTkc6L4IU/szcxXH7KOGqO+BDxZaIQkjRCbDE=; b=UGPHFHmTCIs9u4T12GPxq9ocVcwSiIBsUDnXyDw4dD0QrYHORKXvm+2oMqU+/Z4IDA tHKzqVcEXFulTsuD5nuWLBSmCEGd5NwPlLF0Wja93o1xfoStnsCy/9tf0wa4eHgJ4n2p CAijqigSQ+t8SHEST3fPfasyjdUG4IbdJMeJY= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-unsubscribe; bh=t9GS4+GTkc6L4IU/szcxXH7KOGqO+BDxZaIQkjRCbDE=; b=oTpatEiKz2v1C6XoNaiOtSHImnWwUBKv3fxOJV4B90st2bxuAeev5x0PN1bWkimtUh oQCbababMqVEtYULD39gfmBOnimQ2bZ5RjoZBHdAWRmrfYbnwM2SVPYX7ki7Bu7VgLcT /zwZzs5C+iGxyLrk1AhEdYgEL1Msi+Nm/WAhHJuN2lMB32d+CE6dAi45Lls+KRVUoo2G cPcQfpCzYyN3s1o6XZ8fH+4ilWDBzbNXcpjJsYgswDNsCwl0OIQGZ5H9NIX4W4JKYkhb u/r4fk2ylcKbKe3Mtg4mcRffeBILvDbemi93N1ExjeLKXgGDIxa3LFsFrQwJH2wctmiA ggkw== X-Gm-Message-State: APjAAAXczC4zNNkNu8HDLaj4+p3LzVyRlMwQV6WumEZMrNPXmUGbN5MA xFXgf8bGwMFrT5s+GN+ASM1OraBg X-Google-Smtp-Source: APXvYqzoR0LKUPWktsTTT0V5bvC9N3hmqMFMtA2zB5RpfqKjx5AhJhUqAR6oxSSYla/BPqnBnXOzTQ== X-Received: by 2002:a17:90a:fd83:: with SMTP id cx3mr2174623pjb.64.1571860653772; Wed, 23 Oct 2019 12:57:33 -0700 (PDT) X-BeenThere: linux-amarula@amarulasolutions.com Received: by 2002:a17:902:d216:: with SMTP id t22ls998552ply.4.gmail; Wed, 23 Oct 2019 12:57:33 -0700 (PDT) X-Received: by 2002:a17:902:7448:: with SMTP id e8mr3053098plt.149.1571860653240; Wed, 23 Oct 2019 12:57:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1571860653; cv=none; d=google.com; s=arc-20160816; b=aWF8j7Q5sK3tE3aTqyPxCLZQsArkNlBbJ3kz4ZXQtKs7EIN0VfPbZNFRO2F2p4H1KD JmwviwpWLfXXu3kiXxUV5O31S/2hZuYcssJ1+KxaYO9co0ZVodaRU8OZgeo66iqGcOHY HPcDKu9gQkbJ39PDsC81cyetukKAWnlDb0tmuGJjmjgVb0dc2YNctgZkl5VNsg2FAnG4 wZij16YWFVF8KWHvob46b8kFuBXwM/vPFKou3ttX8xsT8Yp2Y4zr4wcQxJlHqisCEN7a PckhJBdC9hAyPrnRvmGHxSdcn0iWIf4io6jkUW3mbvpfyPmcY8wSebbmzYeFPALSeJsz ZuFQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=cH1Kgx4pxWjY/ylyr5O0lvoO8yHz8X1lY8R/7tMQV9M=; b=0hKHD3Bcd5WuASbXUjd74CKeUTMXQ+h9zACX4zAFRQ4POnI8giXX6KJEistuakUbC5 qBWE8VldffAR8IqECNDaWVqIshmucCwsWrg4iOSZsq0bT78OqPJLG2PJ2tzuMm8rVuea NxHIQc/BZLrEVPFr2ix6UJ8jLx06bOXb8SpuprHWGne6BHJKEoZRTr6Q6nBJVvSWyZV/ EEAm6e0c6jEJ8AnbamO2Vc5djreSIWqtCM1vRrhgqFNClL/avZxgsj44YhfROLJUhU2W 1ErQCPZfiOyQsy+88Iwb2F172uNrg59R+wlIAjby8jrOKfN635kCcmEuOwEI7hOwjMgn /3WQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=bY+O+beJ; spf=pass (google.com: domain of jagan@amarulasolutions.com designates 209.85.220.65 as permitted sender) smtp.mailfrom=jagan@amarulasolutions.com Received: from mail-sor-f65.google.com (mail-sor-f65.google.com. [209.85.220.65]) by mx.google.com with SMTPS id 98sor12185664plc.56.2019.10.23.12.57.33 for (Google Transport Security); Wed, 23 Oct 2019 12:57:33 -0700 (PDT) Received-SPF: pass (google.com: domain of jagan@amarulasolutions.com designates 209.85.220.65 as permitted sender) client-ip=209.85.220.65; X-Received: by 2002:a17:902:6ac8:: with SMTP id i8mr11067329plt.164.1571860652779; Wed, 23 Oct 2019 12:57:32 -0700 (PDT) Received: from localhost.localdomain ([115.97.180.31]) by smtp.gmail.com with ESMTPSA id o185sm31499280pfg.136.2019.10.23.12.57.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 23 Oct 2019 12:57:32 -0700 (PDT) From: Jagan Teki To: Kever Yang , Simon Glass , Philipp Tomsich Cc: u-boot@lists.denx.de, linux-rockchip@lists.infradead.org, linux-amarula@amarulasolutions.com, Jagan Teki , "Matwey V . Kornilov" Subject: [PATCH v4 7/7] doc: boards: Add rockchip documentation Date: Thu, 24 Oct 2019 01:26:52 +0530 Message-Id: <20191023195652.7158-8-jagan@amarulasolutions.com> X-Mailer: git-send-email 2.18.0.321.gffc6fa0e3 In-Reply-To: <20191023195652.7158-1-jagan@amarulasolutions.com> References: <20191023195652.7158-1-jagan@amarulasolutions.com> MIME-Version: 1.0 X-Original-Sender: jagan@amarulasolutions.com X-Original-Authentication-Results: mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=bY+O+beJ; spf=pass (google.com: domain of jagan@amarulasolutions.com designates 209.85.220.65 as permitted sender) smtp.mailfrom=jagan@amarulasolutions.com Content-Type: text/plain; charset="UTF-8" Precedence: list Mailing-list: list linux-amarula@amarulasolutions.com; contact linux-amarula+owners@amarulasolutions.com List-ID: X-Spam-Checked-In-Group: linux-amarula@amarulasolutions.com X-Google-Group-Id: 476853432473 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Rockchip has documentation file, doc/README.rockchip but which is not so readable to add or understand the existing contents. Even the format that support is legacy readme in U-Boot. Add rockchip specific documentation file using new rst format, which describes the information about Rockchip supported boards and it's usage steps. Added minimal information about rk3288, rk3328, rk3368 and rk3399 boards and usage. This would indeed updated further based on the requirements and updates. Cc: Kever Yang Cc: Matwey V. Kornilov Signed-off-by: Jagan Teki --- doc/board/rockchip/index.rst | 10 +++ doc/board/rockchip/rockchip.rst | 128 ++++++++++++++++++++++++++++++++ 2 files changed, 138 insertions(+) create mode 100644 doc/board/rockchip/index.rst create mode 100644 doc/board/rockchip/rockchip.rst diff --git a/doc/board/rockchip/index.rst b/doc/board/rockchip/index.rst new file mode 100644 index 0000000000..0c377e9bbb --- /dev/null +++ b/doc/board/rockchip/index.rst @@ -0,0 +1,10 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. Copyright (C) 2019 Jagan Teki + +Rockchip +======== + +.. toctree:: + :maxdepth: 2 + + rockchip diff --git a/doc/board/rockchip/rockchip.rst b/doc/board/rockchip/rockchip.rst new file mode 100644 index 0000000000..625155e432 --- /dev/null +++ b/doc/board/rockchip/rockchip.rst @@ -0,0 +1,128 @@ +.. SPDX-License-Identifier: GPL-2.0+ +.. Copyright (C) 2019 Jagan Teki + +ROCKCHIP +======== + +About this +---------- + +This document describes the information about Rockchip supported boards +and it's usage steps. + +Rockchip boards +--------------- + +Rockchip is SoC solutions provider for tablets & PCs, streaming media +TV boxes, AI audio & vision, IoT hardware. + +A wide range of Rockchip SoCs with associated boardsare supported in +mainline U-Boot. + +List of mainline supported rockchip boards: + +* rk3288 + - Evb-RK3288 + - Firefly-RK3288 + - mqmaker MiQi + - Phytec RK3288 PCM-947 + - PopMetal-RK3288 + - Radxa Rock 2 Square + - Tinker-RK3288 + - Google Jerry + - Google Mickey + - Google Minnie + - Google Speedy + - Amarula Vyasa-RK3288 +* rk3328 + - Rockchip RK3328 EVB + - Pine64 Rock64 +* rk3368 + - GeekBox + - PX5 EVB + - Rockchip sheep board + - Theobroma Systems RK3368-uQ7 SoM +* rk3399 + - 96boards RK3399 Ficus + - 96boards Rock960 + - Firefly-RK3399 Board + - Firefly ROC-RK3399-PC Board + - FriendlyElec NanoPC-T4 + - FriendlyElec NanoPi M4 + - FriendlyARM NanoPi NEO4 + - Google Bob + - Khadas Edge + - Khadas Edge-Captain + - Khadas Edge-V + - Orange Pi RK3399 Board + - Pine64 RockPro64 + - Radxa ROCK Pi 4 + - Rockchip RK3399 Evaluation Board + - Theobroma Systems RK3399-Q7 SoM + +Building +-------- + +TF-A +^^^^ + +TF-A would require to build for ARM64 Rockchip SoCs platforms. + +To build TF-A:: + + git clone https://github.com/ARM-software/arm-trusted-firmware.git + cd arm-trusted-firmware + make realclean + make CROSS_COMPILE=aarch64-linux-gnu- PLAT=rk3399 + +Specify the PLAT= with desired rockchip platform to build TF-A for. + +U-Boot +^^^^^^ + +To build rk3328 boards:: + + export BL31=/path/to/arm-trusted-firmware/to/bl31.elf + make evb-rk3328_defconfig + make + +To build rk3288 boards:: + + make evb-rk3288_defconfig + make + +To build rk3368 boards:: + + export BL31=/path/to/arm-trusted-firmware/to/bl31.elf + make evb-px5_defconfig + make + +To build rk3399 boards:: + + export BL31=/path/to/arm-trusted-firmware/to/bl31.elf + make evb-rk3399_defconfig + make + +Flashing +-------- + +SD Card +^^^^^^^ + +All rockchip platforms, except rk3128 (which doesn't use SPL) are now +supporting single boot image using binman and pad_cat. + +To write an image that boots from an SD card (assumed to be /dev/sda):: + + sudo dd if=u-boot-rockchip.bin of=/dev/sda seek=64 + sync + +TODO +---- + +- Add rockchip idbloader image building +- Describe steps for eMMC flashing +- Add missing SoC's with it boards list + +.. Jagan Teki +.. Thu Oct 17 22:36:14 IST 2019