需求规格说明书 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

Download
Open PDF In Browser	View PDF

www.rock-chips.com

Security Classification:
Most Confidential(

) Confidential(

) Internal(

)

Public( √

Rockchip Keybox Burning Guide
（Technical Department，Product 1 Team）
Mark：

Current Ver.：

V1.2

[ ] Editing

Drafted By：

ZW

[√] Issued

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

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

Remark

www.rock-chips.com

Content
1

2

PREFACE ..................................................................................................... 3
1.1

APPLICABLE PRODUCTS ................................................................................. 3

1.2

APPLICABLE READERS ................................................................................... 3

KEYBOX GENERATION ................................................................................ 3
2.1

3

KEYBOXWRITE TOOL USAGE ...................................................................... 4
3.1

4

INTRODUCTION ........................................................................................... 3

KEYBOXWRITE TOOL .................................................................................... 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

2

www.rock-chips.com

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;

3

www.rock-chips.com

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;

4

www.rock-chips.com

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.

5

www.rock-chips.com

4.2 Key Exceeds the Allocated Space

Reason:The size of the Key is over 64k.

6

www.rock-chips.com

4.3 Write key to Misc Partition Failed

Reason:The device does not answer, check whether the loader supports key
burning.

7

www.rock-chips.com

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.

8



---

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.7
Linearized                      : No
Page Count                      : 9
Language                        : zh-CN
Tagged PDF                      : Yes
XMP Toolkit                     : 3.1-701
Producer                        : Microsoft® Word 2016
Title                           : 需求规格说明书
Creator                         : user
Creator Tool                    : Microsoft® Word 2016
Create Date                     : 2018:03:16 16:46:48+08:00
Modify Date                     : 2018:03:16 16:46:48+08:00
Document ID                     : uuid:401CC9F8-5A80-4C37-91F0-93F0D72282E1
Instance ID                     : uuid:401CC9F8-5A80-4C37-91F0-93F0D72282E1
Author                          : user

EXIF Metadata provided by EXIF.tools