From patchwork Thu Jan 9 18:46:22 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jagan Teki X-Patchwork-Id: 1033 Return-Path: X-Original-To: linux-amarula@patchwork.amarulasolutions.com Delivered-To: linux-amarula@patchwork.amarulasolutions.com Received: from mail-pj1-f70.google.com (mail-pj1-f70.google.com [209.85.216.70]) by ganimede.amarulasolutions.com (Postfix) with ESMTPS id B4BCF3F042 for ; Thu, 9 Jan 2020 19:48:50 +0100 (CET) Received: by mail-pj1-f70.google.com with SMTP id dw15sf2172336pjb.2 for ; Thu, 09 Jan 2020 10:48:50 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1578595729; cv=pass; d=google.com; s=arc-20160816; b=F6Ry7rGu3oLYPuZdx/YnE4B3LpQBYLavOVZBt/v4hNLKxxGM+kSv1uNfVAIyqGdseZ i2H0dSLsN3yaXPF8RKfSQVkkrIGLKwxPe2NLhseCrbrzchzam4MmowtF4raC8/sdW/GV yCLYjTwDokS2jidt171BnjwQNUGoSAWWFdLmSDVlug2y8lsJt6Th0yzqxlNueteUM9o3 yjucEkLjClmPuE46lDoIPekLyV6cjTO5g9EOvC/pPWc8IVDBJQUa6bBiMUnO71PDntHO Zsu4skIAuxwbBjaRJQ0IX9BSiAGuPCaFCVV8OWMbn2AoUrC9+ABlh89BMy3BPs0GBczB LF/A== 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=+FR7dr0nr8D9bOwx1qLhfRzbt4t4J7ni2I1+549yC1o=; b=L9Lx7IEfaLvK99BsWe/bZoPC8D8R4t9TjV/nYHj4umBYCq/EFG+CXHQVkt+OGhLVBl Hlp33izsSt06QPU3+zc1bdUXWvzoR3WLGZqTGib0C+ji+w7+vfsxybERraAtmARCOraN XWk45Q6XHhpKml5fT+Dh5f7ZjJbWPD3H06QZA9knKFDYMH20y7EMKhc0jVs1Sk1+7Rtc e5nBUsS0WYkvOTZGu+3ZLjHKCr1FMOIohZLQhys1ZIZo+FZs6Zc+qF+7kimkwZL5zo6n yMfidLaTUjN9eQF4fZgwHcEj8FpxUzw5nwDO6NulCRoGfnmF8FL3IiIw3j17JQvImhPr 2N+A== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=QgC4yrBv; 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=+FR7dr0nr8D9bOwx1qLhfRzbt4t4J7ni2I1+549yC1o=; b=Xewc78u75EiApVIcEu0+Qn9gcUe5S03b+qaEjTvsM5Ezk5j5kLcBV5P26kjUcq39aj hyrelzdRHFyLlsIS4VgWQqumlPmCx0W6/edqlclkO7sa2gSGYbcQoU92+MeEW0oJwaj4 bMv6XPOqB0MzCEypbyq87XvDwfNPZU1/tZMl0= 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=+FR7dr0nr8D9bOwx1qLhfRzbt4t4J7ni2I1+549yC1o=; b=aGwEQv0ny8Qcx7D5EIs4FvuskaiSgPI+9hNng+Tgr4vlXZxs5FWDKKC926GtejrEXp s5E925VfyO2FZPlEK0y+PMmopI904p6tDXWF3EdG35GwAd6pGlRfKw4olxCWhNGuDcqU LvdbxUQiTutVAeeyL22yyf2tlq7WA3aRfSsaWIyPoWb1+WFAEQ+exNZLkNZdkU/XkN6t 5KcF5b/KlkQd87Nd12KJA7d3paC1ht10VEK1BIlWkg1rbN1wjVvC72TKl78t5Gw9ZvIB bgJQynyh/YAjKh9uSMCK/6MKXJ0Y+kQHHf5pXUekDdWATrkSTQ3pdEsRLODqK36Fz4ly Pmag== X-Gm-Message-State: APjAAAUICCYa/W4gIp9GRaY7nuMPUmsfHtsHV+H3hZXm4WhsAu7Hs0m3 Lo/riiZkAl5Sn4Ix1vvA5uc3735d X-Google-Smtp-Source: APXvYqxIGeQFDb6eyVdM+i9ZhW1qH3Pv4AL+frhL8sZYpAVyfWEfRbjU9+ezNpdzdFkBvU8xJnL4Qw== X-Received: by 2002:a17:902:ac90:: with SMTP id h16mr12567384plr.164.1578595729403; Thu, 09 Jan 2020 10:48:49 -0800 (PST) X-BeenThere: linux-amarula@amarulasolutions.com Received: by 2002:a63:d007:: with SMTP id z7ls792048pgf.9.gmail; Thu, 09 Jan 2020 10:48:49 -0800 (PST) X-Received: by 2002:a62:78c1:: with SMTP id t184mr12440081pfc.222.1578595728979; Thu, 09 Jan 2020 10:48:48 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1578595728; cv=none; d=google.com; s=arc-20160816; b=zIjVIShBQrumY6wcK2TXDiSxg5sBDbj3ZgzI/uC9vbr6A8nf8rIZbTMBefA97jgi0s h1Y9u5BopG6q8INT2al4XENytpxrrgLoKKZzXVAtBU6jy14b5w0/nNkj8ledLyc7stRD lOSU3l5/OsacMUiGMvw0UCkLpJWr4sF0+AHeM5fHT2Cd5eJxE7zO77WUIYk3zzJW/2Sy 2aguG0hoaUjDYRYQUrepQBobqjnRW3bQgyzi4Im+QjjO1GCWZuhcSUnaV/adn+r5HJZ5 s9iPosrETPmHmY1ENwWjuejVxmmr1JREeWCOBXyoLJG4XU4UCKugKOrI+Qzd2RaxKl7K h5qQ== 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=RV+d12yuIQSCZ/M2vOO9iyyB/0NvK5sAyrZn/RyXJus=; b=BgN6/L3le2khrY5QF0Umw8/IYfJ/7d3FN4MmxU1B3INJ05soGxkIHLOlobJXYZ31re F63/GbcVS0ONu1lSZ6/njUs86fN/0M8EXBaj20QtTCeIqO+W7DbQtAjqsAmikGYaGZAF 9tOUG4uxCZnJmVTgjyXZem1XH4O3UJthWLiY6E/kVLWO0L6xvVxJIdIIj/1Te+f5pkat w8DQ2fwiU0ua5HZSs+WjXsUxYzillvOg5JWnCFatJrTuPzg3on4mT1ignY3CGr9S6XUa x3nIIAwzfN3yvAgkF8FF5wxy9xGcwIb+FP3tN1m7YYS1DXe2DjgdkGoKRcWSpXmy3if3 fqlA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=QgC4yrBv; 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 a207sor8086788pfa.20.2020.01.09.10.48.48 for (Google Transport Security); Thu, 09 Jan 2020 10:48:48 -0800 (PST) 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:a62:342:: with SMTP id 63mr12756077pfd.19.1578595728451; Thu, 09 Jan 2020 10:48:48 -0800 (PST) Received: from localhost.localdomain ([2405:201:c809:c7d5:c4eb:be5d:1485:edee]) by smtp.gmail.com with ESMTPSA id i8sm8967306pfa.109.2020.01.09.10.48.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 09 Jan 2020 10:48:48 -0800 (PST) From: Jagan Teki To: Kever Yang , Simon Glass , Philipp Tomsich Cc: Akash Gajjar , u-boot@lists.denx.de, linux-rockchip@lists.infradead.org, linux-amarula@amarulasolutions.com, Jagan Teki , "Matwey V . Kornilov" Subject: [PATCH v7 7/7] doc: boards: Add rockchip documentation Date: Fri, 10 Jan 2020 00:16:22 +0530 Message-Id: <20200109184622.3098-8-jagan@amarulasolutions.com> X-Mailer: git-send-email 2.18.0.321.gffc6fa0e3 In-Reply-To: <20200109184622.3098-1-jagan@amarulasolutions.com> References: <20200109184622.3098-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=QgC4yrBv; 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 Reviewed-by: Kever Yang --- doc/board/rockchip/index.rst | 10 +++ doc/board/rockchip/rockchip.rst | 130 ++++++++++++++++++++++++++++++++ 2 files changed, 140 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..cd9c8d6dc4 --- /dev/null +++ b/doc/board/rockchip/rockchip.rst @@ -0,0 +1,130 @@ +.. 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 +- Add rockchip TPL image building +- Document SPI flash boot +- Describe steps for eMMC flashing +- Add missing SoC's with it boards list + +.. Jagan Teki +.. Fri Jan 10 00:08:40 IST 2020