From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kever Yang Subject: Re: [PATCH v6 6/6] doc: boards: Add rockchip documentation Date: Tue, 7 Jan 2020 16:40:35 +0800 Message-ID: References: <20200104083806.3930-1-jagan@amarulasolutions.com> <20200104083806.3930-7-jagan@amarulasolutions.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20200104083806.3930-7-jagan-dyjBcgdgk7Pe9wHmmfpqLFaTQe2KTcn/@public.gmane.org> Content-Language: en-US List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "Linux-rockchip" Errors-To: linux-rockchip-bounces+glpar-linux-rockchip=m.gmane.org-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r@public.gmane.org To: Jagan Teki , Simon Glass , Philipp Tomsich Cc: u-boot-0aAXYlwwYIKGBzrmiIFOJg@public.gmane.org, "Matwey V . Kornilov" , linux-amarula-dyjBcgdgk7Pe9wHmmfpqLFaTQe2KTcn/@public.gmane.org, Akash Gajjar , linux-rockchip-IAPFreCvJWM7uuMidbF8XUB+6BGkLq7r@public.gmane.org List-Id: linux-rockchip.vger.kernel.org Ck9uIDIwMjAvMS80IOS4i+WNiDQ6MzgsIEphZ2FuIFRla2kgd3JvdGU6Cj4gUm9ja2NoaXAgaGFz IGRvY3VtZW50YXRpb24gZmlsZSwgZG9jL1JFQURNRS5yb2NrY2hpcCBidXQKPiB3aGljaCBpcyBu b3Qgc28gcmVhZGFibGUgdG8gYWRkIG9yIHVuZGVyc3RhbmQgdGhlIGV4aXN0aW5nCj4gY29udGVu dHMuIEV2ZW4gdGhlIGZvcm1hdCB0aGF0IHN1cHBvcnQgaXMgbGVnYWN5IHJlYWRtZQo+IGluIFUt Qm9vdC4KPgo+IEFkZCByb2NrY2hpcCBzcGVjaWZpYyBkb2N1bWVudGF0aW9uIGZpbGUgdXNpbmcg bmV3IHJzdAo+IGZvcm1hdCwgd2hpY2ggZGVzY3JpYmVzIHRoZSBpbmZvcm1hdGlvbiBhYm91dCBS b2NrY2hpcAo+IHN1cHBvcnRlZCBib2FyZHMgYW5kIGl0J3MgdXNhZ2Ugc3RlcHMuCj4KPiBBZGRl ZCBtaW5pbWFsIGluZm9ybWF0aW9uIGFib3V0IHJrMzI4OCwgcmszMzI4LCByazMzNjgKPiBhbmQg cmszMzk5IGJvYXJkcyBhbmQgdXNhZ2UuIFRoaXMgd291bGQgaW5kZWVkIHVwZGF0ZWQKPiBmdXJ0 aGVyIGJhc2VkIG9uIHRoZSByZXF1aXJlbWVudHMgYW5kIHVwZGF0ZXMuCj4KPiBDYzogS2V2ZXIg WWFuZyA8a2V2ZXIueWFuZ0Byb2NrLWNoaXBzLmNvbT4KPiBDYzogTWF0d2V5IFYuIEtvcm5pbG92 IDxtYXR3ZXkua29ybmlsb3ZAZ21haWwuY29tPgo+IFNpZ25lZC1vZmYtYnk6IEphZ2FuIFRla2kg PGphZ2FuQGFtYXJ1bGFzb2x1dGlvbnMuY29tPgpSZXZpZXdlZC1ieTogS2V2ZXIgWWFuZyA8a2V2 ZXIueWFuZ0Byb2NrLWNoaXBzLmNvbT4KClRoYW5rcywKLSBLZXZlcgo+IC0tLQo+ICAgZG9jL2Jv YXJkL3JvY2tjaGlwL2luZGV4LnJzdCAgICB8ICAxMCArKysKPiAgIGRvYy9ib2FyZC9yb2NrY2hp cC9yb2NrY2hpcC5yc3QgfCAxMzAgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKPiAg IDIgZmlsZXMgY2hhbmdlZCwgMTQwIGluc2VydGlvbnMoKykKPiAgIGNyZWF0ZSBtb2RlIDEwMDY0 NCBkb2MvYm9hcmQvcm9ja2NoaXAvaW5kZXgucnN0Cj4gICBjcmVhdGUgbW9kZSAxMDA2NDQgZG9j L2JvYXJkL3JvY2tjaGlwL3JvY2tjaGlwLnJzdAo+Cj4gZGlmZiAtLWdpdCBhL2RvYy9ib2FyZC9y b2NrY2hpcC9pbmRleC5yc3QgYi9kb2MvYm9hcmQvcm9ja2NoaXAvaW5kZXgucnN0Cj4gbmV3IGZp bGUgbW9kZSAxMDA2NDQKPiBpbmRleCAwMDAwMDAwMDAwLi4wYzM3N2U5YmJiCj4gLS0tIC9kZXYv bnVsbAo+ICsrKyBiL2RvYy9ib2FyZC9yb2NrY2hpcC9pbmRleC5yc3QKPiBAQCAtMCwwICsxLDEw IEBACj4gKy4uIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wKwo+ICsuLiBDb3B5cmln aHQgKEMpIDIwMTkgSmFnYW4gVGVraSA8amFnYW5AYW1hcnVsYXNvbHV0aW9ucy5jb20+Cj4gKwo+ ICtSb2NrY2hpcAo+ICs9PT09PT09PQo+ICsKPiArLi4gdG9jdHJlZTo6Cj4gKyAgIDptYXhkZXB0 aDogMgo+ICsKPiArICAgcm9ja2NoaXAKPiBkaWZmIC0tZ2l0IGEvZG9jL2JvYXJkL3JvY2tjaGlw L3JvY2tjaGlwLnJzdCBiL2RvYy9ib2FyZC9yb2NrY2hpcC9yb2NrY2hpcC5yc3QKPiBuZXcgZmls ZSBtb2RlIDEwMDY0NAo+IGluZGV4IDAwMDAwMDAwMDAuLjZjMzRmMWFiOTkKPiAtLS0gL2Rldi9u dWxsCj4gKysrIGIvZG9jL2JvYXJkL3JvY2tjaGlwL3JvY2tjaGlwLnJzdAo+IEBAIC0wLDAgKzEs MTMwIEBACj4gKy4uIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wKwo+ICsuLiBDb3B5 cmlnaHQgKEMpIDIwMTkgSmFnYW4gVGVraSA8amFnYW5AYW1hcnVsYXNvbHV0aW9ucy5jb20+Cj4g Kwo+ICtST0NLQ0hJUAo+ICs9PT09PT09PQo+ICsKPiArQWJvdXQgdGhpcwo+ICstLS0tLS0tLS0t Cj4gKwo+ICtUaGlzIGRvY3VtZW50IGRlc2NyaWJlcyB0aGUgaW5mb3JtYXRpb24gYWJvdXQgUm9j a2NoaXAgc3VwcG9ydGVkIGJvYXJkcwo+ICthbmQgaXQncyB1c2FnZSBzdGVwcy4KPiArCj4gK1Jv Y2tjaGlwIGJvYXJkcwo+ICstLS0tLS0tLS0tLS0tLS0KPiArCj4gK1JvY2tjaGlwIGlzIFNvQyBz b2x1dGlvbnMgcHJvdmlkZXIgZm9yIHRhYmxldHMgJiBQQ3MsIHN0cmVhbWluZyBtZWRpYQo+ICtU ViBib3hlcywgQUkgYXVkaW8gJiB2aXNpb24sIElvVCBoYXJkd2FyZS4KPiArCj4gK0Egd2lkZSBy YW5nZSBvZiBSb2NrY2hpcCBTb0NzIHdpdGggYXNzb2NpYXRlZCBib2FyZHNhcmUgc3VwcG9ydGVk IGluCj4gK21haW5saW5lIFUtQm9vdC4KPiArCj4gK0xpc3Qgb2YgbWFpbmxpbmUgc3VwcG9ydGVk IHJvY2tjaGlwIGJvYXJkczoKPiArCj4gKyogcmszMjg4Cj4gKyAgICAgLSBFdmItUkszMjg4Cj4g KyAgICAgLSBGaXJlZmx5LVJLMzI4OAo+ICsgICAgIC0gbXFtYWtlciBNaVFpCj4gKyAgICAgLSBQ aHl0ZWMgUkszMjg4IFBDTS05NDcKPiArICAgICAtIFBvcE1ldGFsLVJLMzI4OAo+ICsgICAgIC0g UmFkeGEgUm9jayAyIFNxdWFyZQo+ICsgICAgIC0gVGlua2VyLVJLMzI4OAo+ICsgICAgIC0gR29v Z2xlIEplcnJ5Cj4gKyAgICAgLSBHb29nbGUgTWlja2V5Cj4gKyAgICAgLSBHb29nbGUgTWlubmll Cj4gKyAgICAgLSBHb29nbGUgU3BlZWR5Cj4gKyAgICAgLSBBbWFydWxhIFZ5YXNhLVJLMzI4OAo+ ICsqIHJrMzMyOAo+ICsgICAgIC0gUm9ja2NoaXAgUkszMzI4IEVWQgo+ICsgICAgIC0gUGluZTY0 IFJvY2s2NAo+ICsqIHJrMzM2OAo+ICsgICAgIC0gR2Vla0JveAo+ICsgICAgIC0gUFg1IEVWQgo+ ICsgICAgIC0gUm9ja2NoaXAgc2hlZXAgYm9hcmQKPiArICAgICAtIFRoZW9icm9tYSBTeXN0ZW1z IFJLMzM2OC11UTcgU29NCj4gKyogcmszMzk5Cj4gKyAgICAgLSA5NmJvYXJkcyBSSzMzOTkgRmlj dXMKPiArICAgICAtIDk2Ym9hcmRzIFJvY2s5NjAKPiArICAgICAtIEZpcmVmbHktUkszMzk5IEJv YXJkCj4gKyAgICAgLSBGaXJlZmx5IFJPQy1SSzMzOTktUEMgQm9hcmQKPiArICAgICAtIEZyaWVu ZGx5RWxlYyBOYW5vUEMtVDQKPiArICAgICAtIEZyaWVuZGx5RWxlYyBOYW5vUGkgTTQKPiArICAg ICAtIEZyaWVuZGx5QVJNIE5hbm9QaSBORU80Cj4gKyAgICAgLSBHb29nbGUgQm9iCj4gKyAgICAg LSBLaGFkYXMgRWRnZQo+ICsgICAgIC0gS2hhZGFzIEVkZ2UtQ2FwdGFpbgo+ICsgICAgIC0gS2hh ZGFzIEVkZ2UtVgo+ICsgICAgIC0gT3JhbmdlIFBpIFJLMzM5OSBCb2FyZAo+ICsgICAgIC0gUGlu ZTY0IFJvY2tQcm82NAo+ICsgICAgIC0gUmFkeGEgUk9DSyBQaSA0Cj4gKyAgICAgLSBSb2NrY2hp cCBSSzMzOTkgRXZhbHVhdGlvbiBCb2FyZAo+ICsgICAgIC0gVGhlb2Jyb21hIFN5c3RlbXMgUksz Mzk5LVE3IFNvTQo+ICsKPiArQnVpbGRpbmcKPiArLS0tLS0tLS0KPiArCj4gK1RGLUEKPiArXl5e Xgo+ICsKPiArVEYtQSB3b3VsZCByZXF1aXJlIHRvIGJ1aWxkIGZvciBBUk02NCBSb2NrY2hpcCBT b0NzIHBsYXRmb3Jtcy4KPiArCj4gK1RvIGJ1aWxkIFRGLUE6Ogo+ICsKPiArICAgICAgICBnaXQg Y2xvbmUgaHR0cHM6Ly9naXRodWIuY29tL0FSTS1zb2Z0d2FyZS9hcm0tdHJ1c3RlZC1maXJtd2Fy ZS5naXQKPiArICAgICAgICBjZCBhcm0tdHJ1c3RlZC1maXJtd2FyZQo+ICsgICAgICAgIG1ha2Ug cmVhbGNsZWFuCj4gKyAgICAgICAgbWFrZSBDUk9TU19DT01QSUxFPWFhcmNoNjQtbGludXgtZ251 LSBQTEFUPXJrMzM5OQo+ICsKPiArU3BlY2lmeSB0aGUgUExBVD0gd2l0aCBkZXNpcmVkIHJvY2tj aGlwIHBsYXRmb3JtIHRvIGJ1aWxkIFRGLUEgZm9yLgo+ICsKPiArVS1Cb290Cj4gK15eXl5eXgo+ ICsKPiArVG8gYnVpbGQgcmszMzI4IGJvYXJkczo6Cj4gKwo+ICsgICAgICAgIGV4cG9ydCBCTDMx PS9wYXRoL3RvL2FybS10cnVzdGVkLWZpcm13YXJlL3RvL2JsMzEuZWxmCj4gKyAgICAgICAgbWFr ZSBldmItcmszMzI4X2RlZmNvbmZpZwo+ICsgICAgICAgIG1ha2UKPiArCj4gK1RvIGJ1aWxkIHJr MzI4OCBib2FyZHM6Ogo+ICsKPiArICAgICAgICBtYWtlIGV2Yi1yazMyODhfZGVmY29uZmlnCj4g KyAgICAgICAgbWFrZQo+ICsKPiArVG8gYnVpbGQgcmszMzY4IGJvYXJkczo6Cj4gKwo+ICsgICAg ICAgIGV4cG9ydCBCTDMxPS9wYXRoL3RvL2FybS10cnVzdGVkLWZpcm13YXJlL3RvL2JsMzEuZWxm Cj4gKyAgICAgICAgbWFrZSBldmItcHg1X2RlZmNvbmZpZwo+ICsgICAgICAgIG1ha2UKPiArCj4g K1RvIGJ1aWxkIHJrMzM5OSBib2FyZHM6Ogo+ICsKPiArICAgICAgICBleHBvcnQgQkwzMT0vcGF0 aC90by9hcm0tdHJ1c3RlZC1maXJtd2FyZS90by9ibDMxLmVsZgo+ICsgICAgICAgIG1ha2UgZXZi LXJrMzM5OV9kZWZjb25maWcKPiArICAgICAgICBtYWtlCj4gKwo+ICtGbGFzaGluZwo+ICstLS0t LS0tLQo+ICsKPiArU0QgQ2FyZAo+ICteXl5eXl5eCj4gKwo+ICtBbGwgcm9ja2NoaXAgcGxhdGZv cm1zLCBleGNlcHQgcmszMTI4ICh3aGljaCBkb2Vzbid0IHVzZSBTUEwpIGFyZSBub3cKPiArc3Vw cG9ydGluZyBzaW5nbGUgYm9vdCBpbWFnZSB1c2luZyBiaW5tYW4gYW5kIHBhZF9jYXQuCj4gKwo+ ICtUbyB3cml0ZSBhbiBpbWFnZSB0aGF0IGJvb3RzIGZyb20gYW4gU0QgY2FyZCAoYXNzdW1lZCB0 byBiZSAvZGV2L3NkYSk6Ogo+ICsKPiArICAgICAgICBzdWRvIGRkIGlmPXUtYm9vdC1yb2NrY2hp cC5iaW4gb2Y9L2Rldi9zZGEgc2Vlaz02NAo+ICsgICAgICAgIHN5bmMKPiArCj4gK1RPRE8KPiAr LS0tLQo+ICsKPiArLSBBZGQgcm9ja2NoaXAgaWRibG9hZGVyIGltYWdlIGJ1aWxkaW5nCj4gKy0g QWRkIHJvY2tjaGlwIFRQTCBpbWFnZSBidWlsZGluZwo+ICstIERvY3VtZW50IFNQSSBmbGFzaCBi b290Cj4gKy0gRGVzY3JpYmUgc3RlcHMgZm9yIGVNTUMgZmxhc2hpbmcKPiArLSBBZGQgbWlzc2lu ZyBTb0MncyB3aXRoIGl0IGJvYXJkcyBsaXN0Cj4gKwo+ICsuLiBKYWdhbiBUZWtpIDxqYWdhbkBh bWFydWxhc29sdXRpb25zLmNvbT4KPiArLi4gU2F0IEphbiAgNCAxNDowMDo1NCBJU1QgMjAyMAoK CgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpMaW51eC1y b2NrY2hpcCBtYWlsaW5nIGxpc3QKTGludXgtcm9ja2NoaXBAbGlzdHMuaW5mcmFkZWFkLm9yZwpo dHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2xpbnV4LXJvY2tjaGlw Cg== From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kever Yang Date: Tue, 7 Jan 2020 16:40:35 +0800 Subject: [PATCH v6 6/6] doc: boards: Add rockchip documentation In-Reply-To: <20200104083806.3930-7-jagan@amarulasolutions.com> References: <20200104083806.3930-1-jagan@amarulasolutions.com> <20200104083806.3930-7-jagan@amarulasolutions.com> Message-ID: List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit To: u-boot@lists.denx.de On 2020/1/4 下午4:38, Jagan Teki wrote: > 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 Thanks, - Kever > --- > 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