From patchwork Mon Dec 30 08:28:19 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jagan Teki X-Patchwork-Id: 971 Return-Path: X-Original-To: linux-amarula@patchwork.amarulasolutions.com Delivered-To: linux-amarula@patchwork.amarulasolutions.com Received: from mail-pf1-f198.google.com (mail-pf1-f198.google.com [209.85.210.198]) by ganimede.amarulasolutions.com (Postfix) with ESMTPS id 3070D3F076 for ; Mon, 30 Dec 2019 09:28:51 +0100 (CET) Received: by mail-pf1-f198.google.com with SMTP id d85sf22405832pfd.4 for ; Mon, 30 Dec 2019 00:28:51 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1577694530; cv=pass; d=google.com; s=arc-20160816; b=Z4Vjv+Zro+e8N355FfNrtVPhfeoWoWHR63qLTNIRsJ0QzhpYEhjCx2NaZFMTndTfky 04H/8onfX7TH03uacPysckHVDZSm/PPZqwmEKEiSWt7VdwsKpX+2xJF1bABLXzmiufNP vLJMyDA/lmHt7ASr0YDpW4tjPVVD5Yqd9lbl4v3y2Dbp7Yp+MRUK6IEiC07DJhXOuR1b ge5yTQDZdSC3bdPDsxGdVVGZNTiM4DQcg2SuGlwK91QSYJ2z2qGMGRFCTZhaRfPN1aUx 4NSNZiZn1hz4xjBdJ79/y47SyG7CUAv0JL1JJcUTL2lVYlafNF3ngTWfGhHjB2kRx6AC ijoQ== 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=WvtMA5as4EOC2SIsa8/CMNYtIdXeFrwJViKB7F/yzX1wlmLsgPTjtpHhohXGiZKER5 UeI5VDM9jGEsPQKmOGIahcgjjJQ4xyXsuIh7Zyb3Jwyqsen+DQtbJLs3/oGsAxZNcShm rj1JX/LuMTyGKKadelKjUsx8CvqdAt8CtJbaQXal6rGvWWCofnM92fRW0zRvzlGNHDQF qj0QGymlkvdODU5k/qjdHTcu0DizZXcvvnLI1Vs3EOY43hoyg2ufbGGDCUPoSNaDSHQw txZxSiPzFT+uNeN2UCPCjwS0CRbQyBtF+tR6UAXqGe1fbQCZ8+0I/wvTA9NEPfh4OGUm Z2Ew== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=jc+QbzRQ; 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=YJVaChJj1KMIdkAONpESCxgrKTVFSxYVN3AISRrbLT9Tu4kY1nGZuRgIsmqvcSQwt5 fDju1DI8qQw8wGfEKH20vKSG9kZET9IC7u8UGgmbc5nyqRJFeLaHIiUlTRxhKYkEJod9 vUHNl7aQzz2YNqDWRpGHX3Nsw9mxwHb3nKJcY= 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=f5xeR4sZ6MyQ+igkiFRcAgo2WJk4odGcSbOJju67AW2XWGWuqQvHZbBg79QB4np0Ck coD0YkmjUA+TMZqabcjXVTwBXjPfJIkOWv2pZ12ABelhzLqEIxWKMIS/0uf3XJQVigo2 JFJUZXUsbPRHbN+2GP3gIPOB6CP0318CF0RjTgwIQ0FBSY4cprmQx2bLMu4XxcqV+HBC 6eXb1hL7cRMKtuPOuAzrFTY6y2hDct+YEwnGSCYYh3WFUfs0N7YwP6iuoH7NKLHe1Tey hSSP6AkzO/CFqieA7XyAk1YskSdt+k1eVLlXr40w51swtcO1me0RvhnNGZ5QKclunqy6 9Bvw== X-Gm-Message-State: APjAAAVIR5cfRfEkBmjH1e5MOJY/OaKMvHFKksfqzCxEUPDvuk3MCUcy WtH8tx+NSdqb5wlxNbcH9QySilBt X-Google-Smtp-Source: APXvYqwBPWzgi2cEi/rG0x00pSVInJQYIhlNL77EflbXoV0ZgOrF4eSgaa7J5IGuQS9tMF3hBVkWBA== X-Received: by 2002:a17:90a:cb8c:: with SMTP id a12mr45505177pju.71.1577694529962; Mon, 30 Dec 2019 00:28:49 -0800 (PST) X-BeenThere: linux-amarula@amarulasolutions.com Received: by 2002:aa7:84d9:: with SMTP id x25ls9770872pfn.2.gmail; Mon, 30 Dec 2019 00:28:49 -0800 (PST) X-Received: by 2002:a63:cb48:: with SMTP id m8mr72780502pgi.128.1577694529276; Mon, 30 Dec 2019 00:28:49 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1577694529; cv=none; d=google.com; s=arc-20160816; b=g/yy7a/QalptpU5Q0cyUB+iTWnYG2fCJ+xJknnKw8tfrkmMBFWdAFrvXlT2D1Qtbtc Ab/xxgncreIHRcUuf7Tkdt9pKYt/AgnOETUOPisSk8dXmnPRMGuZWkt3wHZTakO8A70g twrrtir3TdcLN9ld6l9am9oGrLc342MmJ4g70Eb24FSlpQQjpb/rDogiaSvf7bkbw/IE CdxnOrTl+3ETbDUKusLkfGWttP9dbZl/0gkP4aDG32Ij93dHnZM7YnO2SfI0zxTThw9Y sfD0C+Mo0DfpefpTGasknaw32o4RfCfpU+hhP1ZQz+uJSJDZzkm8HyxxHjxocuS1TDSj Fo7w== 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=rO/BLbZCvQs8q53uUlpBN+bt1Qp9Uo0PZ1RxtjOMHGxkXYI3DIKiktFFCwQi3Ioszn VjEHTNIWrk9C7+Ixxo7s0LrjIeh09vxv9OGKIqD2f9tqdTTCODID9BZemU3GIhOuFjxH 0Ht5NcnFgUr2aMfSOh2s5XUfVZhd9QZF7ctGaseUGrOeE5E4FsYm5j0cqeu89x2zOlSw XPj0bbT7LTiSi2BnQAa7IUgUFuNustrERs6taP8ZPGGsQoeAzYOPDauDaOMPohaIP75B i/Ty+0Koi1V1e3SpXn2wnH6+FEK/DnmykZ5aKyoE/ph2MHA8mhz3YH/7mGqNtZd6jhmb V4iQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=jc+QbzRQ; 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 o7sor44755881pfp.5.2019.12.30.00.28.49 for (Google Transport Security); Mon, 30 Dec 2019 00:28:49 -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:a63:1119:: with SMTP id g25mr70792114pgl.359.1577694528916; Mon, 30 Dec 2019 00:28:48 -0800 (PST) Received: from localhost.localdomain ([49.206.202.131]) by smtp.gmail.com with ESMTPSA id s1sm46240652pgv.87.2019.12.30.00.28.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 30 Dec 2019 00:28: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 v5 7/7] doc: boards: Add rockchip documentation Date: Mon, 30 Dec 2019 13:58:19 +0530 Message-Id: <20191230082819.30191-8-jagan@amarulasolutions.com> X-Mailer: git-send-email 2.18.0.321.gffc6fa0e3 In-Reply-To: <20191230082819.30191-1-jagan@amarulasolutions.com> References: <20191230082819.30191-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=jc+QbzRQ; 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