From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kever Yang Subject: Re: [PATCH v4 7/7] doc: boards: Add rockchip documentation Date: Sun, 10 Nov 2019 22:30:28 +0800 Message-ID: <6492a339-7d0b-607f-498a-36c1652180d9@rock-chips.com> References: <20191023195652.7158-1-jagan@amarulasolutions.com> <20191023195652.7158-8-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: <20191023195652.7158-8-jagan@amarulasolutions.com> Content-Language: en-US List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" To: Jagan Teki , Simon Glass , Philipp Tomsich Cc: u-boot@lists.denx.de, "Matwey V . Kornilov" , linux-amarula@amarulasolutions.com, linux-rockchip@lists.infradead.org List-Id: linux-rockchip.vger.kernel.org SmFnYW4sCgpPbiAyMDE5LzEwLzI0IOS4iuWNiDM6NTYsIEphZ2FuIFRla2kgd3JvdGU6Cj4gUm9j a2NoaXAgaGFzIGRvY3VtZW50YXRpb24gZmlsZSwgZG9jL1JFQURNRS5yb2NrY2hpcCBidXQKPiB3 aGljaCBpcyBub3Qgc28gcmVhZGFibGUgdG8gYWRkIG9yIHVuZGVyc3RhbmQgdGhlIGV4aXN0aW5n Cj4gY29udGVudHMuIEV2ZW4gdGhlIGZvcm1hdCB0aGF0IHN1cHBvcnQgaXMgbGVnYWN5IHJlYWRt ZQo+IGluIFUtQm9vdC4KPgo+IEFkZCByb2NrY2hpcCBzcGVjaWZpYyBkb2N1bWVudGF0aW9uIGZp bGUgdXNpbmcgbmV3IHJzdAo+IGZvcm1hdCwgd2hpY2ggZGVzY3JpYmVzIHRoZSBpbmZvcm1hdGlv biBhYm91dCBSb2NrY2hpcAo+IHN1cHBvcnRlZCBib2FyZHMgYW5kIGl0J3MgdXNhZ2Ugc3RlcHMu Cj4KPiBBZGRlZCBtaW5pbWFsIGluZm9ybWF0aW9uIGFib3V0IHJrMzI4OCwgcmszMzI4LCByazMz NjgKPiBhbmQgcmszMzk5IGJvYXJkcyBhbmQgdXNhZ2UuIFRoaXMgd291bGQgaW5kZWVkIHVwZGF0 ZWQKPiBmdXJ0aGVyIGJhc2VkIG9uIHRoZSByZXF1aXJlbWVudHMgYW5kIHVwZGF0ZXMuCgoKVGhp cyBwYXRjaCBtb3ZlIHNtYWxsIHBhcnQgb2YgY29udGVudCBmcm9tIGRvYy9SRUFETUUucm9ja2No aXAsIEkgd291bGQgCnByZWZlcgoKdG8gaGF2ZSBhIG1vcmUgY29tcGxldGUgdmVyc2lvbiBiZWZv cmUgaXQgbW92ZSB0byBuZXcgZG9jdW1lbnQuCgoKVGhhbmtzLAoKLSBLZXZlcgoKPiBDYzogS2V2 ZXIgWWFuZyA8a2V2ZXIueWFuZ0Byb2NrLWNoaXBzLmNvbT4KPiBDYzogTWF0d2V5IFYuIEtvcm5p bG92IDxtYXR3ZXkua29ybmlsb3ZAZ21haWwuY29tPgo+IFNpZ25lZC1vZmYtYnk6IEphZ2FuIFRl a2kgPGphZ2FuQGFtYXJ1bGFzb2x1dGlvbnMuY29tPgo+IC0tLQo+ICAgZG9jL2JvYXJkL3JvY2tj aGlwL2luZGV4LnJzdCAgICB8ICAxMCArKysKPiAgIGRvYy9ib2FyZC9yb2NrY2hpcC9yb2NrY2hp cC5yc3QgfCAxMjggKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysKPiAgIDIgZmlsZXMg Y2hhbmdlZCwgMTM4IGluc2VydGlvbnMoKykKPiAgIGNyZWF0ZSBtb2RlIDEwMDY0NCBkb2MvYm9h cmQvcm9ja2NoaXAvaW5kZXgucnN0Cj4gICBjcmVhdGUgbW9kZSAxMDA2NDQgZG9jL2JvYXJkL3Jv Y2tjaGlwL3JvY2tjaGlwLnJzdAo+Cj4gZGlmZiAtLWdpdCBhL2RvYy9ib2FyZC9yb2NrY2hpcC9p bmRleC5yc3QgYi9kb2MvYm9hcmQvcm9ja2NoaXAvaW5kZXgucnN0Cj4gbmV3IGZpbGUgbW9kZSAx MDA2NDQKPiBpbmRleCAwMDAwMDAwMDAwLi4wYzM3N2U5YmJiCj4gLS0tIC9kZXYvbnVsbAo+ICsr KyBiL2RvYy9ib2FyZC9yb2NrY2hpcC9pbmRleC5yc3QKPiBAQCAtMCwwICsxLDEwIEBACj4gKy4u IFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wKwo+ICsuLiBDb3B5cmlnaHQgKEMpIDIw MTkgSmFnYW4gVGVraSA8amFnYW5AYW1hcnVsYXNvbHV0aW9ucy5jb20+Cj4gKwo+ICtSb2NrY2hp cAo+ICs9PT09PT09PQo+ICsKPiArLi4gdG9jdHJlZTo6Cj4gKyAgIDptYXhkZXB0aDogMgo+ICsK PiArICAgcm9ja2NoaXAKPiBkaWZmIC0tZ2l0IGEvZG9jL2JvYXJkL3JvY2tjaGlwL3JvY2tjaGlw LnJzdCBiL2RvYy9ib2FyZC9yb2NrY2hpcC9yb2NrY2hpcC5yc3QKPiBuZXcgZmlsZSBtb2RlIDEw MDY0NAo+IGluZGV4IDAwMDAwMDAwMDAuLjYyNTE1NWU0MzIKPiAtLS0gL2Rldi9udWxsCj4gKysr IGIvZG9jL2JvYXJkL3JvY2tjaGlwL3JvY2tjaGlwLnJzdAo+IEBAIC0wLDAgKzEsMTI4IEBACj4g Ky4uIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBHUEwtMi4wKwo+ICsuLiBDb3B5cmlnaHQgKEMp IDIwMTkgSmFnYW4gVGVraSA8amFnYW5AYW1hcnVsYXNvbHV0aW9ucy5jb20+Cj4gKwo+ICtST0NL Q0hJUAo+ICs9PT09PT09PQo+ICsKPiArQWJvdXQgdGhpcwo+ICstLS0tLS0tLS0tCj4gKwo+ICtU aGlzIGRvY3VtZW50IGRlc2NyaWJlcyB0aGUgaW5mb3JtYXRpb24gYWJvdXQgUm9ja2NoaXAgc3Vw cG9ydGVkIGJvYXJkcwo+ICthbmQgaXQncyB1c2FnZSBzdGVwcy4KPiArCj4gK1JvY2tjaGlwIGJv YXJkcwo+ICstLS0tLS0tLS0tLS0tLS0KPiArCj4gK1JvY2tjaGlwIGlzIFNvQyBzb2x1dGlvbnMg cHJvdmlkZXIgZm9yIHRhYmxldHMgJiBQQ3MsIHN0cmVhbWluZyBtZWRpYQo+ICtUViBib3hlcywg QUkgYXVkaW8gJiB2aXNpb24sIElvVCBoYXJkd2FyZS4KPiArCj4gK0Egd2lkZSByYW5nZSBvZiBS b2NrY2hpcCBTb0NzIHdpdGggYXNzb2NpYXRlZCBib2FyZHNhcmUgc3VwcG9ydGVkIGluCj4gK21h aW5saW5lIFUtQm9vdC4KPiArCj4gK0xpc3Qgb2YgbWFpbmxpbmUgc3VwcG9ydGVkIHJvY2tjaGlw IGJvYXJkczoKPiArCj4gKyogcmszMjg4Cj4gKyAgICAgLSBFdmItUkszMjg4Cj4gKyAgICAgLSBG aXJlZmx5LVJLMzI4OAo+ICsgICAgIC0gbXFtYWtlciBNaVFpCj4gKyAgICAgLSBQaHl0ZWMgUksz Mjg4IFBDTS05NDcKPiArICAgICAtIFBvcE1ldGFsLVJLMzI4OAo+ICsgICAgIC0gUmFkeGEgUm9j ayAyIFNxdWFyZQo+ICsgICAgIC0gVGlua2VyLVJLMzI4OAo+ICsgICAgIC0gR29vZ2xlIEplcnJ5 Cj4gKyAgICAgLSBHb29nbGUgTWlja2V5Cj4gKyAgICAgLSBHb29nbGUgTWlubmllCj4gKyAgICAg LSBHb29nbGUgU3BlZWR5Cj4gKyAgICAgLSBBbWFydWxhIFZ5YXNhLVJLMzI4OAo+ICsqIHJrMzMy OAo+ICsgICAgIC0gUm9ja2NoaXAgUkszMzI4IEVWQgo+ICsgICAgIC0gUGluZTY0IFJvY2s2NAo+ ICsqIHJrMzM2OAo+ICsgICAgIC0gR2Vla0JveAo+ICsgICAgIC0gUFg1IEVWQgo+ICsgICAgIC0g Um9ja2NoaXAgc2hlZXAgYm9hcmQKPiArICAgICAtIFRoZW9icm9tYSBTeXN0ZW1zIFJLMzM2OC11 UTcgU29NCj4gKyogcmszMzk5Cj4gKyAgICAgLSA5NmJvYXJkcyBSSzMzOTkgRmljdXMKPiArICAg ICAtIDk2Ym9hcmRzIFJvY2s5NjAKPiArICAgICAtIEZpcmVmbHktUkszMzk5IEJvYXJkCj4gKyAg ICAgLSBGaXJlZmx5IFJPQy1SSzMzOTktUEMgQm9hcmQKPiArICAgICAtIEZyaWVuZGx5RWxlYyBO YW5vUEMtVDQKPiArICAgICAtIEZyaWVuZGx5RWxlYyBOYW5vUGkgTTQKPiArICAgICAtIEZyaWVu ZGx5QVJNIE5hbm9QaSBORU80Cj4gKyAgICAgLSBHb29nbGUgQm9iCj4gKyAgICAgLSBLaGFkYXMg RWRnZQo+ICsgICAgIC0gS2hhZGFzIEVkZ2UtQ2FwdGFpbgo+ICsgICAgIC0gS2hhZGFzIEVkZ2Ut Vgo+ICsgICAgIC0gT3JhbmdlIFBpIFJLMzM5OSBCb2FyZAo+ICsgICAgIC0gUGluZTY0IFJvY2tQ cm82NAo+ICsgICAgIC0gUmFkeGEgUk9DSyBQaSA0Cj4gKyAgICAgLSBSb2NrY2hpcCBSSzMzOTkg RXZhbHVhdGlvbiBCb2FyZAo+ICsgICAgIC0gVGhlb2Jyb21hIFN5c3RlbXMgUkszMzk5LVE3IFNv TQo+ICsKPiArQnVpbGRpbmcKPiArLS0tLS0tLS0KPiArCj4gK1RGLUEKPiArXl5eXgo+ICsKPiAr VEYtQSB3b3VsZCByZXF1aXJlIHRvIGJ1aWxkIGZvciBBUk02NCBSb2NrY2hpcCBTb0NzIHBsYXRm b3Jtcy4KPiArCj4gK1RvIGJ1aWxkIFRGLUE6Ogo+ICsKPiArICAgICAgICBnaXQgY2xvbmUgaHR0 cHM6Ly9naXRodWIuY29tL0FSTS1zb2Z0d2FyZS9hcm0tdHJ1c3RlZC1maXJtd2FyZS5naXQKPiAr ICAgICAgICBjZCBhcm0tdHJ1c3RlZC1maXJtd2FyZQo+ICsgICAgICAgIG1ha2UgcmVhbGNsZWFu Cj4gKyAgICAgICAgbWFrZSBDUk9TU19DT01QSUxFPWFhcmNoNjQtbGludXgtZ251LSBQTEFUPXJr MzM5OQo+ICsKPiArU3BlY2lmeSB0aGUgUExBVD0gd2l0aCBkZXNpcmVkIHJvY2tjaGlwIHBsYXRm b3JtIHRvIGJ1aWxkIFRGLUEgZm9yLgo+ICsKPiArVS1Cb290Cj4gK15eXl5eXgo+ICsKPiArVG8g YnVpbGQgcmszMzI4IGJvYXJkczo6Cj4gKwo+ICsgICAgICAgIGV4cG9ydCBCTDMxPS9wYXRoL3Rv L2FybS10cnVzdGVkLWZpcm13YXJlL3RvL2JsMzEuZWxmCj4gKyAgICAgICAgbWFrZSBldmItcmsz MzI4X2RlZmNvbmZpZwo+ICsgICAgICAgIG1ha2UKPiArCj4gK1RvIGJ1aWxkIHJrMzI4OCBib2Fy ZHM6Ogo+ICsKPiArICAgICAgICBtYWtlIGV2Yi1yazMyODhfZGVmY29uZmlnCj4gKyAgICAgICAg bWFrZQo+ICsKPiArVG8gYnVpbGQgcmszMzY4IGJvYXJkczo6Cj4gKwo+ICsgICAgICAgIGV4cG9y dCBCTDMxPS9wYXRoL3RvL2FybS10cnVzdGVkLWZpcm13YXJlL3RvL2JsMzEuZWxmCj4gKyAgICAg ICAgbWFrZSBldmItcHg1X2RlZmNvbmZpZwo+ICsgICAgICAgIG1ha2UKPiArCj4gK1RvIGJ1aWxk IHJrMzM5OSBib2FyZHM6Ogo+ICsKPiArICAgICAgICBleHBvcnQgQkwzMT0vcGF0aC90by9hcm0t dHJ1c3RlZC1maXJtd2FyZS90by9ibDMxLmVsZgo+ICsgICAgICAgIG1ha2UgZXZiLXJrMzM5OV9k ZWZjb25maWcKPiArICAgICAgICBtYWtlCj4gKwo+ICtGbGFzaGluZwo+ICstLS0tLS0tLQo+ICsK PiArU0QgQ2FyZAo+ICteXl5eXl5eCj4gKwo+ICtBbGwgcm9ja2NoaXAgcGxhdGZvcm1zLCBleGNl cHQgcmszMTI4ICh3aGljaCBkb2Vzbid0IHVzZSBTUEwpIGFyZSBub3cKPiArc3VwcG9ydGluZyBz aW5nbGUgYm9vdCBpbWFnZSB1c2luZyBiaW5tYW4gYW5kIHBhZF9jYXQuCj4gKwo+ICtUbyB3cml0 ZSBhbiBpbWFnZSB0aGF0IGJvb3RzIGZyb20gYW4gU0QgY2FyZCAoYXNzdW1lZCB0byBiZSAvZGV2 L3NkYSk6Ogo+ICsKPiArICAgICAgICBzdWRvIGRkIGlmPXUtYm9vdC1yb2NrY2hpcC5iaW4gb2Y9 L2Rldi9zZGEgc2Vlaz02NAo+ICsgICAgICAgIHN5bmMKPiArCj4gK1RPRE8KPiArLS0tLQo+ICsK PiArLSBBZGQgcm9ja2NoaXAgaWRibG9hZGVyIGltYWdlIGJ1aWxkaW5nCj4gKy0gRGVzY3JpYmUg c3RlcHMgZm9yIGVNTUMgZmxhc2hpbmcKPiArLSBBZGQgbWlzc2luZyBTb0MncyB3aXRoIGl0IGJv YXJkcyBsaXN0Cj4gKwo+ICsuLiBKYWdhbiBUZWtpIDxqYWdhbkBhbWFydWxhc29sdXRpb25zLmNv bT4KPiArLi4gVGh1IE9jdCAxNyAyMjozNjoxNCBJU1QgMjAxOQoKCl9fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fClUtQm9vdCBtYWlsaW5nIGxpc3QKVS1Cb290 QGxpc3RzLmRlbnguZGUKaHR0cHM6Ly9saXN0cy5kZW54LmRlL2xpc3RpbmZvL3UtYm9vdAo= From mboxrd@z Thu Jan 1 00:00:00 1970 From: Kever Yang Date: Sun, 10 Nov 2019 22:30:28 +0800 Subject: [U-Boot] [PATCH v4 7/7] doc: boards: Add rockchip documentation In-Reply-To: <20191023195652.7158-8-jagan@amarulasolutions.com> References: <20191023195652.7158-1-jagan@amarulasolutions.com> <20191023195652.7158-8-jagan@amarulasolutions.com> Message-ID: <6492a339-7d0b-607f-498a-36c1652180d9@rock-chips.com> List-Id: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 8bit To: u-boot@lists.denx.de Jagan, On 2019/10/24 上午3:56, 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. This patch move small part of content from doc/README.rockchip, I would prefer to have a more complete version before it move to new document. Thanks, - Kever > 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