U-Boot v2017(next-dev) Developer Guide
ID: RK-KF-YF-45
Release Version: 2.11.0
Date: 2021-05-13
Security Level: □Top-Secret □Secret □Internal ■Public
DISCLAIMER
THIS DOCUMENT IS PROVIDED "AS IS". ROCKCHIP ELECTRONICS CO., LTD. ("ROCKCHIP") DOES NOT PROVIDE ANY WARRANTY OF ANY KIND, EXPRESSED, IMPLIED OR OTHERWISE, WITH RESPECT TO THE ACCURACY, RELIABILITY, COMPLETENESS, MERCHANTABILITY, FITNESS FOR ANY PARTICULAR PURPOSE OR NON-INFRINGEMENT OF ANY REPRESENTATION, INFORMATION AND CONTENT IN THIS DOCUMENT. THIS DOCUMENT IS FOR REFERENCE ONLY.
THIS DOCUMENT MAY BE UPDATED OR CHANGED WITHOUT ANY NOTICE AT ANY TIME DUE TO THE UPGRADES OF THE PRODUCT OR ANY OTHER REASONS.
Trademark Statement
"Rockchip", "Rockchip", "Rockchip" shall be Rockchip's registered trademarks and owned by Rockchip.
All other registered trademarks or trademarks mentioned in this document shall be owned by their respective owners.
All rights reserved. © 2021. Rockchip Electronics Co., Ltd.
Beyond the scope of fair use, no unit or individual may excerpt or copy any part or all of the content of this document without written permission from Rockchip, and may not distribute it in any form.
Rockchip Electronics Co., Ltd.
Address: No. 18, Area A, Software Park, Tongpan Road, Fuzhou, Fujian Province
Website: www.rock-chips.com
Customer Service Tel: +86-4007-700-590
Customer Service Fax: +86-591-83951833
Customer Service Email: fae@rock-chips.com
Preface
Overview
This document mainly guides readers on how to carry out project development on the U-Boot v2017(next-dev) version.
Chip Feature Support Status
| Chip Name | Distro Boot | RKIMG Boot | SPL/TPL | Trust(SPL) | AVB |
|---|---|---|---|---|---|
| RV1108 | Y | Y | Y | N | N |
| RK3036 | Y | Y | Y | Y | N |
| RK3126C | Y | Y | Y | Y | Y |
| RK3128 | Y | Y | Y | Y | Y |
| RK3229 | Y | Y | Y | Y | Y |
| RK3288 | Y | Y | Y | Y | Y |
| RK3308 | Y | - | Y | Y | - |
| RK3326/PX30 | Y | Y | Y | Y | Y |
| RK3328 | Y | Y | Y | Y | Y |
| RK3368/PX5 | Y | Y | Y | Y | Y |
| RK3399 | Y | Y | Y | Y | Y |
| RK1808 | Y | - | Y | Y | - |
| RV1126/RV1109 | Y | Y | Y | Y | N |
| RK3566/RK3568 | Y | N | Y | Y | Y |
Intended Audience
This document (this guide) is primarily intended for the following engineers:
Technical Support Engineers
Software Development Engineers
Revision History
| Version | Author | Date | Description |
|---|---|---|---|
| V1.00 | Chen Jianhong | 2018-02-28 | Initial version |
| V1.01 | Zhu Zhizhan | 2018-06-22 | Fastboot description, OPTEE Client description |
| V1.10 | Chen Jianhong | 2018-07-23 | Improved document, updated and adjusted most chapters |
| V1.11 | Lin Dingqiang | 2018-07-26 | Improved Nand and SFC SPI Flash storage driver sections |
| V1.12 | Chen Liang | 2018-08-08 | Added HW-ID usage description |
| V1.13 | Zhang Qing | 2018-09-20 | Added CLK usage description |
| V1.20 | Chen Jianhong | 2018-11-06 | Added/updated defconfig/rktest/probe/interrupt/kernel dtb/uart/atags |
| V1.21 | Chen Jianhong | 2019-01-21 | Added dtbo/amp/dvfs wide-temperature/fdt command descriptions |
| V1.22 | Lin Ping | 2019-03-05 | Added optee client description |
| V1.23 | Chen Jianhong Zhu Zhizhan | 2019-03-25 | Added kernel cmdline description |
| V1.30 | Chen Jianhong | 2019-03-25 | Streamlined and organized the document, corrected formatting issues, improved and adjusted some chapter content |
| V1.31 | Zhu Zhizhan | 2019-04-23 | Added hardware CRYPTO description |
| V1.32 | Zhu Zhizhan | 2019-05-14 | Supplemented kernel cmdline description |
| V1.33 | Zhu Zhizhan | 2019-05-29 | Added MMC command section, AVB and A/B system descriptions, glossary |
| V1.40 | Chen Jianhong | 2019-06-20 | Added/updated: memblk/sysmem/bi dram/statcktrace/hotkey/ fdt param/run_command/distro/led/reset/ env/wdt/spl/amp/crypto/ efuse/Android compatible/io-domain/bootflow/pack image |
| V1.41 | Zhu Zhizhan | 2019-08-21 | Added secure otp description |
| V1.42 | Zhu Zhizhan | 2019-08-27 | Added storage device/MTD device descriptions |
| V1.43 | Zhu Zhizhan | 2019-10-08 | Added BCB description |
| V1.44 | Zhu Zhizhan | 2019-10-15 | Added SPL driver and function support description |
| V1.45 | Zhu Zhizhan | 2019-11-15 | Added SPL pinctrl usage description |
| V2.0.0 | Chen Jianhong | 2020-05-02 | Major version upgrade: refactored format, content, layout, etc. |
| V2.1.0 | Chen Jianhong | 2020-05-29 | Added FIT scheme |
| V2.1.1 | Lin Dingqiang | 2020-06-07 | Added open-source framework storage support description |
| V2.1.2 | Huang Tao | 2020-07-08 | Adjusted formatting |
| V2.2.0 | Wu Dachao | 2020-07-09 | Added Ethernet network support description |
| V2.3.0 | Chen Youmin | 2020-07-13 | Added TPL support description |
| V2.4.0 | Chen Jianhong | 2020-09-23 | Updated FIT and build/flash chapters |
| V2.5.0 | Zhu Zhizhan | 2020-12-28 | Updated FIT chapter |
| V2.6.0 | Zhu Zhizhan | 2020-12-30 | Added fast boot chapter |
| V2.7.0 | Lin Tao | 2021-01-25 | Added PCIe support description |
| V2.8.0 | Chen Jianhong | 2021-03-12 | Added U-Boot firmware format, memory capacity modification, AMP, RK3568 support descriptions |
| V2.9.0 | Chen Jianhong | 2021-04-13 | Updated FIT and USB drive upgrade chapters |
| V2.10.0 | Zhu Zhizhan | 2021-05-06 | Added security operation step-by-step |
| V2.11.0 | Chen Jianhong | 2021-05-13 | Added to FIT chapter: recovery.img packaging and signing, pss signing parameters |
Table of Contents
[TOC]