需求规格说明书 Rockchip Keybox Burning Guide V1.2 20180315
Rockchip%20Keybox%20Burning%20Guide%20V1.2-20180315
Rockchip%20Keybox%20Burning%20Guide%20V1.2-20180315
User Manual:
Open the PDF directly: View PDF .
Page Count: 9
www.rock-chips.com
Security Classification:
Most Confidential( ) Confidential( ) Internal( ) Public( √ )
Rockchip Keybox Burning Guide
(Technical Department,Product 1 Team)
Mark:
[ ] Editing
[√] Issued
Current Ver.:
V1.2
Drafted By:
ZW
Fulfill Date:
2018-03-15
Checked By:
CW, ZXZ
Completed Date:
2018-03-16
福州瑞芯微电子股份有限公司
Fuzhou Rockchips Electronics Co . , Ltd
(All rights reserved)
www.rock-chips.com
Revision History
Ver. No
Author
Revised Date
Note for Revision
Remark
V1.0
LY
2017-12-12
Initial Released
V1.1
ZW
2018-01-29
Add support for RK3328
Chip
V1.2
ZW
2018-03-15
Add support for widevine
www.rock-chips.com
2
C
Co
on
nt
te
en
nt
t
1 PREFACE ..................................................................................................... 3
1.1 APPLICABLE PRODUCTS ................................................................................. 3
1.2 APPLICABLE READERS ................................................................................... 3
2 KEYBOX GENERATION ................................................................................ 3
2.1 INTRODUCTION ........................................................................................... 3
3 KEYBOXWRITE TOOL USAGE ...................................................................... 4
3.1 KEYBOXWRITE TOOL .................................................................................... 4
4 Q&A ............................................................................................................ 5
4.1 GET THE RANDOM KEY FAILED ......................................................................... 5
4.2 KEY EXCEEDS THE ALLOCATED SPACE ................................................................ 6
4.3 WRITE KEY TO MISC PARTITION FAILED .............................................................. 7
4.4 VERIFY KEY FAILED ...................................................................................... 8
www.rock-chips.com
3
1 Preface
This document introduces keybox burning scheme on Rockchip platform,
including how to generate keybox, Rockchip KeyboxWriter Burning Tool Usage, and
common problem treatments.
1.1 Applicable Products
Chip Type
RK3126C
RK3328
RK3368
RK3399
RK3229
1.2 Applicable Readers
1. Production and Technicial personnel
2 Keybox Generation
2.1 Introduction
Rockchip rkpacker tool converts a set of keyboxes provided by Google to a ”.kdb”
file that can be burned:
rkpacker test_keybox.xml -o keybox.kdb
The first parameter:test_keybox.xml specifies the keybox data file to be
converted;
www.rock-chips.com
4
The second parameter:-o parameter specifies directory of the ouput file after
converted, if not specified, the ouput file named “result.kdb” will be generated in the
current directory.
3 KeyboxWrite Tool Usage
3.1 KeyboxWrite Tool
Note:
Key's burning position is specified by “DestPosition” parameter of config.ini file.
Burning attestation key
#DestPosition = 1:write key to misc;
Burning widevine key
#DestPosition = 2:write key to vendor storage;
#DestPosition = other value:write key to old vendor;
www.rock-chips.com
5
Use steps:
1. Click "KeyFile" button, select the keybox file.
2. Click "Run" button, it will automatically detect Loader device.
3. After the loader device is detected, select a key from the keybox file and burn
it.
4. Multiple loader devices can be connected at the same time, and be burned
parallelly
4 Q&A
4.1 Get the Random Key Failed
Reason:All keys in the Keybox file are used up.
www.rock-chips.com
6
4.2 Key Exceeds the Allocated Space
Reason:The size of the Key is over 64k.
www.rock-chips.com
7
4.3 Write key to Misc Partition Failed
Reason:The device does not answer, check whether the loader supports key
burning.
www.rock-chips.com
8
4.4 Verify Key Failed
Reason:Read key data back from the loader device and check key failed, confirm
whether the loader of the device supports keybox burning.