From patchwork Sat Jan 4 08:38:06 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jagan Teki X-Patchwork-Id: 1015 Return-Path: X-Original-To: linux-amarula@patchwork.amarulasolutions.com Delivered-To: linux-amarula@patchwork.amarulasolutions.com Received: from mail-pj1-f71.google.com (mail-pj1-f71.google.com [209.85.216.71]) by ganimede.amarulasolutions.com (Postfix) with ESMTPS id E003F3F08F for ; Sat, 4 Jan 2020 09:38:43 +0100 (CET) Received: by mail-pj1-f71.google.com with SMTP id a31sf7412900pje.4 for ; Sat, 04 Jan 2020 00:38:43 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1578127122; cv=pass; d=google.com; s=arc-20160816; b=VVDn0HiHEYpbOZor2c13IjIDwTbs6gaEHaPSqfly2Tm1XtR9dC10bfrU8N36Hs9j1w s2QsaK4i8vnNbja0drI2nZ0JZxcVg1qnpU61EMiXV+HlLKQidsBpQqpBq0cn3ZqOnBoD cCSpHTyRFSQ5FyQ3wriXytx1CsU2G9hNUAf803LXJtHkbgLkH/ZNCjTayf34jBDfyXFd pVIHrvdAu5aDpJALmS5gviUN89w+KhwNeesiLGrnJ2DPo6l//rzZN4To3NZGlQtvvo+O afuYcK1tjtnhhA3J9vF6srBxz1zP0bGKqx01NXk+h2B0VQ9rmIC4UGTxQDmKrNpHKLgd fPxQ== 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=6YLf7qu0mfXa2tDL/ZoP8H7vI6BdTAcVK2YA8cH3q0w=; b=OBXIGaRRNQRS8ZcH2BHJmkEAlNFde8ETS+RgBDrItB89u1iIpMsHvrdHS6xRgoosL1 cxTEGoU3EUrXDmoX9FAZJiS9d6oPLaciEFiTF/KouP8vbEsk/muB191638yXMvUaloDN TY2pZjiUrHIEXH2s0oVClN311aMI9zuftCc8e3xijS/52LboreDwi9HZ2/K+6ZKRWvKF 30SK3T30N1Lz2kFeMyzhkML/1BvUAfGEnp/GxNxVyGGJNd9PZp2anotxTg2nF6tLZyHh bSGyeYuXl3LGZnWchHAghTb7D+1HFr/zIVnLu6bKnEuY7lqKqZ9/K7UpM0ngh8GKktPt I+OQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=NnPb4HWK; 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=6YLf7qu0mfXa2tDL/ZoP8H7vI6BdTAcVK2YA8cH3q0w=; b=LKfRIA9EU6ZTvQK5KH7o5RAbjN1DewrViccVl+Zku2lmyD/SCGu9whjpdVfN++Ec16 8bo22H6DMqwylF58KDgserpSXnsJjRnLVao3r6/kKWSuiq07sXnpx5GJHauD/hxcH6sJ b/X0U8sGdczshkvG+8QkaMkiBcFLrP0JUrySI= 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=6YLf7qu0mfXa2tDL/ZoP8H7vI6BdTAcVK2YA8cH3q0w=; b=ejSQg/ES8hCL/vpcILhXSKUOAyt5y7ocFUJ3L1ufzEccvM1tvVnR9vq0hqHCkdcokm VmQMdRNEzc1WP9fojPRsRC7nXcY09dkegHoXC5QL73xuT6ad5bJdt/V5rDMSFSKz+EsT eB7hnaG6Bo+u1fkrOK8x2ZcmHgn1n2kvKG4EvaejG66oYEGxOrSrAMiCFFRySbqWj4PX L0ddyw9m07yEJ6T19q+92bnoBn38+Cc7+I4BwNz3AViN5Vw+THmDUbsjpmF5ZhRUFsxA xJKflxPhRvG1VDQ+g32mw4waql7v+KHgiJ+4l7kFTmdU/+M5dKt3IluX7tGbNOYBbPm+ MO1g== X-Gm-Message-State: APjAAAW4rqcXmbVLREU4o1XEKgBOLc3/9ylazHLEm3IxHugcPWOksrRN SRob5if96snUrmsVeTBgyNlzQrXV X-Google-Smtp-Source: APXvYqyIYLJ5mpaasr57YhcFImEMkUAaU+/jNDFSNyLknj/Y+hEw5c/Vye0VrcG6DVkPMdmXMQkJKA== X-Received: by 2002:a63:360a:: with SMTP id d10mr98493571pga.366.1578127122613; Sat, 04 Jan 2020 00:38:42 -0800 (PST) X-BeenThere: linux-amarula@amarulasolutions.com Received: by 2002:a65:6389:: with SMTP id h9ls7382451pgv.10.gmail; Sat, 04 Jan 2020 00:38:42 -0800 (PST) X-Received: by 2002:a63:6787:: with SMTP id b129mr100655074pgc.103.1578127122032; Sat, 04 Jan 2020 00:38:42 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1578127122; cv=none; d=google.com; s=arc-20160816; b=MwmhTdtVGLmW7dErmYgZeIQoYR/MwWW3xGwjPyxO8BgWsNR1SNfA4VkLFVBmEWKUm6 12l3X5hIOjDeUB1Genn9d6mynw6mMx7eJ6p/u4h/b0s6bSWF0/i8XNcTa9ECH/i+a37/ LF12anOvdYAOu+o/tPZyEricJjyoFIgQ5bXM0HnhO3MTvZNvC9hl0+eN9etTeworHKNi KfP/FmFWduXzq74/M8BMbqy01BZ0mCghQ7w/Lz3IeLeW+TQaQiiWqxYnnkJma4AT0T6c 6Hm9//6HLjzkL0c50iN7wU/Um0A1zP+GXyIpCv0Vwcue+1YKWMG4I+ZMizauj1b+UUl+ hOEg== 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=g4cWf3FBE3zdBAFpTRzwkWLhbqmjDXkUilYmTikUnN8=; b=yV6boZ9cGesD+Nw3obxFybHkWCLicc4lQui+dj79B1Y/OVCkl7QLZZvDMa+V0E1hJG shfUfzXvAxzgtq5j93nlZyurAgiXK3D0kQ9AyE1L0ABatAitkFkdsa9nGKFCnSSO5I4t k0QjSWYs+mRUd31o3LIkHCvjS4zGSUYdnk06/Laut4cGQjUcseNR3ivn1rDUPP2/VeUv 8jbYJocwIbNKw/qIubz9h/jRVosbrnsKpVItSXsZila05f+wToYhAqu6AbdfNxd8koRN WOFNUfmh5KFKNBile/grd2Cj4jBZuvE65BFA82Scrnjuv3NWSHBAhQ/HmhEUIl80mDOq VEDQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=NnPb4HWK; 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 r6sor62051868plo.34.2020.01.04.00.38.42 for (Google Transport Security); Sat, 04 Jan 2020 00:38:42 -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:a17:902:6b83:: with SMTP id p3mr82245420plk.284.1578127121634; Sat, 04 Jan 2020 00:38:41 -0800 (PST) Received: from localhost.localdomain ([49.206.201.128]) by smtp.gmail.com with ESMTPSA id z4sm70201623pfn.42.2020.01.04.00.38.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 04 Jan 2020 00:38:41 -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 v6 6/6] doc: boards: Add rockchip documentation Date: Sat, 4 Jan 2020 14:08:06 +0530 Message-Id: <20200104083806.3930-7-jagan@amarulasolutions.com> X-Mailer: git-send-email 2.18.0.321.gffc6fa0e3 In-Reply-To: <20200104083806.3930-1-jagan@amarulasolutions.com> References: <20200104083806.3930-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=NnPb4HWK; 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..6c34f1ab99 --- /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 +.. Sat Jan 4 14:00:54 IST 2020