没有合适的资源？快使用搜索试试~ 我知道了~
首页nxp的lsdk使用说明文档
LSDK is a complete Linux kit for NXP QorIQ ARM-based SoC's and the reference and evaluation boards that are available for them. It is a hybrid form of a Linux distribution because it combines the following major components to form a complete Linux system. • NXP firmware components including: • PPA, a resident EL3 privilege secure firmware for ARMv8A. • NXP peripheral firmware components for DPAA1, DPAA2, and PPFE. • NXP boot loaders. Two are offered: • U-Boot, based on denx.de plus patches. • UEFI, based on TianoCore. • NXP Linux kernel, based on kernel.org upstream plus patches. • NXP added user space components. • Ubuntu standard user space file set (user land), including compilers and cross compiler. The use of Ubuntu user land is what makes LSDK a hybrid. It is not entirely an Ubuntu distribution because it uses an NXP kernel, but it still uses Ubuntu user space files. This hybrid is possible because NXP ARM SoC's are standards-based so programs like bash and thousands of others run without being recompiled.
资源详情
资源评论
资源推荐
Layerscape Software Development Kit
18.03 Documentation
NXP Semiconductors
Document Number: LSDK
Reference Manual Rev. 18.03, 04/2018
Contents
Chapter 1 About this document...................................................................17
Chapter 2 Acronyms and abbreviations......................................................19
Chapter 3 Release notes...............................................................................24
3.1 What's New........................................................................................................................24
3.2 Components...................................................................................................................... 30
3.3 Feature Support Matrix......................................................................................................34
3.4 Supported Targets............................................................................................................. 36
3.5 Fixed, Open, and Closed Issues........................................................................................37
Chapter 4 Layerscape SDK user guide....................................................... 43
4.1 LSDK Quick Start.............................................................................................................. 43
4.1.1 Download and assemble LSDK images.............................................................................. 43
4.1.2 Deploy LSDK Images on the target board...........................................................................45
4.1.2.1 Deploy LSDK images from Linux Host.................................................................................. 45
4.1.2.2 Deploy LSDK images on board............................................................................................. 48
4.1.3 Deploy LSDK Images for secure boot on the target board.................................................. 52
4.1.3.1 Deploy LSDK images from Linux Host.................................................................................. 52
4.1.3.2 Deploy LSDK Secure images on board.................................................................................55
4.2 How to build LSDK with Flexbuild...................................................................................... 58
4.3 Advanced Use Case Instructions ......................................................................................65
4.4 Procedure to Run Secure Boot.......................................................................................... 68
4.4.1 Prepare board for Secure Boot........................................................................................... 68
4.4.2 Running secure boot on target platforms............................................................................70
4.4.3 Steps to run Chain of Trust with Confidentiality.................................................................. 71
4.5 LSDK Memory Layout....................................................................................................... 72
4.6 Board-specific Information................................................................................................. 74
4.6.1 TWR-LS1021A.................................................................................................................... 74
4.6.1.1 On-board Switch Settings...................................................................................................... 74
4.6.1.2 Clock Frequency.................................................................................................................... 74
4.6.1.3 U-Boot Environment Variables.............................................................................................. 75
4.6.1.4 Supported Boot Options........................................................................................................75
4.6.1.5 System Memory Map............................................................................................................ 75
4.6.1.6 NOR Flash (Virtual) Banks.................................................................................................... 76
4.6.1.7 Supported Reset Configuration Word (RCW) Binaries..........................................................77
4.6.1.8 FlexCAN User Manual...........................................................................................................79
4.6.2 LS1012ARDB...................................................................................................................... 83
4.6.2.1 On-board Switch Settings..................................................................................................... 84
4.6.2.2 U-Boot Environment Variables..............................................................................................84
4.6.2.3 Supported Boot Options....................................................................................................... 84
4.6.2.4 System Memory Map............................................................................................................ 84
4.6.2.5 Supported Reset Configuration Word (RCW) Binaries......................................................... 85
4.6.2.6 Flash Bank Usage................................................................................................................ 85
4.6.2.7 Basic Networking Ping Test.................................................................................................. 87
4.6.2.8 Check 'Link Up' for Serial Ethernet Interfaces...................................................................... 91
Contents
Layerscape Software Development Kit 18.03 Documentation, Rev. 18.03, 04/2018
2
NXP Semiconductors
4.6.3 LS1043ARDB......................................................................................................................92
4.6.3.1 On-board Switch Settings..................................................................................................... 92
4.6.3.2 Supported boot options.........................................................................................................92
4.6.3.3 U-Boot Environment Variables..............................................................................................92
4.6.3.4 System Memory Map............................................................................................................ 93
4.6.3.5 NOR Flash (Virtual) Banks................................................................................................... 93
4.6.3.6 Supported Reset Configuration Word (RCW) Binaries......................................................... 95
4.6.3.7 Frame Manager Microcode (FMan ucode)........................................................................... 96
4.6.4 LS1046ARDB......................................................................................................................97
4.6.4.1 On-board Switch Settings..................................................................................................... 97
4.6.4.2 Supported Boot Options....................................................................................................... 97
4.6.4.3 U-Boot Environment Variables..............................................................................................98
4.6.4.4 System Memory Map............................................................................................................ 98
4.6.4.5 QSPI Flash (Virtual) Banks...................................................................................................98
4.6.4.6 Supported Reset Configuration Word (RCW) Binaries....................................................... 100
4.6.4.7 Frame Manager Microcode (FMan ucode)..........................................................................102
4.6.5 LS1088ARDB....................................................................................................................102
4.6.5.1 On-board Switch Settings................................................................................................... 102
4.6.5.2 Supported Boot Types.........................................................................................................103
4.6.5.3 Booting................................................................................................................................103
4.6.5.4 U-Boot Environment Variables............................................................................................ 105
4.6.5.5 Supported Reset Configuration Word (RCW) Binaries....................................................... 107
4.6.5.6 Ethernet MAC Connectivity.................................................................................................108
4.6.6 LS2088ARDB....................................................................................................................108
4.6.6.1 On-board Switch Settings................................................................................................... 108
4.6.6.2 Supported Boot Options......................................................................................................110
4.6.6.3 Booting................................................................................................................................ 110
4.6.6.4 U-Boot Environment Variables.............................................................................................111
4.6.6.5 NOR Flash (Virtual) Banks.................................................................................................. 111
4.6.6.6 Supported RCW (Reset Configuration Word) Binaries........................................................113
4.6.6.7 Ethernet MAC Connectivity................................................................................................. 116
Chapter 5 Bootloaders................................................................................ 117
5.1 General boot flow............................................................................................................. 117
5.2 U-Boot.............................................................................................................................. 118
5.2.1 LSDK U-Boot uses distro boot feature.............................................................................. 118
5.3 UEFI.................................................................................................................................121
5.3.1 Introduction....................................................................................................................... 123
5.3.2 UEFI overview...................................................................................................................123
5.3.3 LSDK distro boot with UEFI.............................................................................................. 126
5.3.4 Product Execution............................................................................................................. 131
5.3.4.1 Flash Layout....................................................................................................................... 132
5.3.4.2 LS1043ARDB......................................................................................................................132
5.3.4.3 LS1046ARDB......................................................................................................................134
5.3.4.4 LS2088ARDB......................................................................................................................137
5.3.5 LSDK Distro Boot Logs..................................................................................................... 140
5.3.6 PXE Boot.......................................................................................................................... 153
5.3.6.1 Creating the PXE Boot Setup............................................................................................. 154
5.3.6.2 Installing the Kernel............................................................................................................ 155
Chapter 6 Security.......................................................................................159
6.1 Secure boot..................................................................................................................... 159
6.1.1 Hardware Pre-Boot Loader (PBL) based platforms........................................................... 159
Contents
Layerscape Software Development Kit 18.03 Documentation, Rev. 18.03, 04/2018
NXP Semiconductors
3
6.1.1.1 Introduction.......................................................................................................................... 159
6.1.1.2 Secure boot process............................................................................................................ 160
6.1.1.3 Pre-boot phase.....................................................................................................................160
6.1.1.4 ISBC phase..........................................................................................................................161
6.1.1.4.1 Flow in the ISBC code.......................................................................................... 161
6.1.1.4.2 Super Root Keys (SRKs) and signing keys........................................................... 162
6.1.1.4.3 Key revocation.......................................................................................................162
6.1.1.4.4 Alternate image support........................................................................................163
6.1.1.4.5 ESBC with CSF header........................................................................................ 163
6.1.1.5 ESBC phase........................................................................................................................ 163
6.1.1.5.1 Boot script............................................................................................................. 164
6.1.1.6 Next executable (Linux phase).............................................................................................169
6.1.1.7 Product execution.................................................................................................................169
6.1.1.7.1 Introduction............................................................................................................169
6.1.1.7.2 Chain of Trust with confidentiality.......................................................................... 170
6.1.1.7.3 ISBC Key Extension (IE)........................................................................................ 174
6.1.1.8 Troubleshooting....................................................................................................................181
6.1.1.9 CSF Header Data Structure.................................................................................................181
6.1.1.10 ISBC Validation Error Codes.............................................................................................. 191
6.1.1.11 ESBC Validation Error Codes.............................................................................................195
6.1.1.12 Trust Architecture and SFP Information............................................................................. 196
6.1.2 Service Processor (SP) Based Platforms..........................................................................197
6.1.2.1 Secure Boot Introduction..................................................................................................... 197
6.1.2.1.1 Secure Boot process.............................................................................................199
6.1.2.2 ISBC Phase.........................................................................................................................200
6.1.2.2.1 ISBC for PBI validation.........................................................................................200
6.1.2.2.2 ISBC for Boot1 (Boot Loader 1) validation............................................................201
6.1.2.3 ESBC Phase........................................................................................................................201
6.1.2.3.1 esbc_validate command.......................................................................................202
6.1.2.3.2 esbc_halt command............................................................................................. 202
6.1.2.3.3 blob enc command............................................................................................... 202
6.1.2.3.4 blob dec command............................................................................................... 202
6.1.2.3.5 Boot Script............................................................................................................203
6.1.2.4 Next executable phase........................................................................................................ 205
6.1.2.5 Product Execution................................................................................................................205
6.1.2.5.1 Introduction...........................................................................................................206
6.1.2.5.2 Chain of Trust with confidentiality.........................................................................207
6.1.2.5.3 ISBC Key Extension (IE).......................................................................................210
6.1.2.6 PBI structure........................................................................................................................226
6.1.2.7 CSF header structure definition...........................................................................................228
6.1.2.8 CSF header structure definition...........................................................................................235
6.1.2.9 Secure boot specific RCW fields......................................................................................... 241
6.1.2.10 ISBC error codes...............................................................................................................242
6.1.2.11 ESBC error codes..............................................................................................................249
6.1.2.12 Troubleshooting................................................................................................................. 251
6.1.3 Code Signing Tool............................................................................................................. 251
6.1.3.1 Key generation.................................................................................................................... 252
6.1.3.1.1 gen_keys...............................................................................................................252
6.1.3.1.2 gen_otpmk_drbg................................................................................................... 254
6.1.3.1.3 gen_drv_drbg........................................................................................................255
6.1.3.2 Header creation...................................................................................................................256
6.1.3.2.1 uni_pbi..................................................................................................................256
6.1.3.2.2 uni_pbi (create_hdr_pbi)...................................................................................... 259
6.1.3.2.3 uni_sign................................................................................................................ 265
6.1.3.2.4 uni_sign (create_hdr_isbc)................................................................................... 269
Contents
Layerscape Software Development Kit 18.03 Documentation, Rev. 18.03, 04/2018
4
NXP Semiconductors
6.1.3.2.5 uni_sign (create_hdr_esbc)..................................................................................273
6.1.3.3 Signature generation........................................................................................................... 276
6.1.3.3.1 gen_sign...............................................................................................................278
6.1.3.3.2 sign_embed..........................................................................................................279
6.2 Trusted Execution (OP-TEE)............................................................................................280
6.2.1 Introduction.......................................................................................................................280
6.2.1.1 Support Platform................................................................................................................. 280
6.2.1.2 Test Sequence.....................................................................................................................280
6.2.2 Appendix A: Loading OP-TEE OS binary......................................................................... 281
6.2.3 Appendix B: Initialization flow of OP-TEE OS...................................................................282
6.2.4 Appendix C: Runtime flow of OP-TEE.............................................................................. 283
6.3 Fuse Provisioning User Guide......................................................................................... 284
6.3.1 Introduction.......................................................................................................................284
6.3.2 Fuse Programming Scenarios...........................................................................................285
6.3.2.1 Fuse Provisioning during OEM Manufacturing....................................................................285
6.3.3 Fuse Provisioning Utility....................................................................................................286
6.3.3.1 Fuse file structure............................................................................................................... 287
6.3.3.2 Sample input file for fuse provisioning tool..........................................................................287
6.3.4 Steps to build fuse provisioning firmware image...............................................................289
6.3.5 Deploy and run fuse provisioning......................................................................................289
6.3.5.1 Enable POVDD for SFP......................................................................................................289
6.3.5.2 Deploy firmware image on board........................................................................................ 289
6.3.5.3 Run firmware image on board.............................................................................................290
6.3.6 Validation.......................................................................................................................... 290
6.3.7 Error Codes...................................................................................................................... 290
6.4 PKCS#11 and Secure Object Library ............................................................................. 293
6.4.1 Introduction.......................................................................................................................293
6.4.2 Supported APIs................................................................................................................ 295
6.4.2.1 PKCS#11 Library – libpkcs11..............................................................................................295
6.4.2.2 Secure Object Library – libsecure_obj................................................................................296
6.4.2.3 Integrating Secure Object Library with OpenSSL............................................................... 299
6.4.2.3.1 OpenSSL Engine – libeng_secure_obj................................................................299
6.4.2.3.2 Example Usage with OpenSSL........................................................................... 299
6.4.3 Board Bootup & Running applications.............................................................................. 301
6.4.3.1 Board Bootup...................................................................................................................... 301
6.4.3.2 Running applications.......................................................................................................... 302
6.4.3.2.1 sobj_app.............................................................................................................. 302
6.4.3.2.2 pkcs11_app..........................................................................................................304
6.4.3.2.3 mp_app................................................................................................................308
6.4.3.2.4 mp_verify............................................................................................................. 309
6.4.3.2.5 sobj_eng_app...................................................................................................... 309
6.4.4 Validation.......................................................................................................................... 310
6.4.5 Appendix...........................................................................................................................310
Chapter 7 Linux kernel................................................................................314
7.1 Configuring and building...................................................................................................315
7.2 Device Drivers.................................................................................................................. 319
7.2.1 Enhanced Direct Memory Access (eDMA)........................................................................ 319
7.2.2 CAAM Direct Memory Access (DMA)................................................................................321
7.2.3 Enhanced Secured Digital Host Controller (eSDHC)........................................................ 323
7.2.4 IEEE 1588......................................................................................................................... 327
7.2.5 Integrated Flash Controller (IFC)....................................................................................... 331
7.2.5.1 Integrated Flash Controller NOR Flash User Manual.......................................................... 331
7.2.5.2 Integrated Flash Controller NAND Flash User Manual........................................................336
Contents
Layerscape Software Development Kit 18.03 Documentation, Rev. 18.03, 04/2018
NXP Semiconductors
5
剩余1095页未读，继续阅读
安全验证
文档复制为VIP权益，开通VIP直接复制
信息提交成功
评论1