puf_v3#
Overview#
The PUF Example project is a demonstration program that uses the KSDK software implement secure key storage using PUF software driver.
Usual use consists of these steps:
Enroll: The controller retrieves the Startup Data (SD) from the memory (SRAM), derives a digital fingerprint, generates the corresponding Activation Code (AC) and sends it to the storage system. Perform this step only once for each device. There is a control register that can block further enrollment. This control register is write only and is reset on a power-on reset.
Start: The AC generated during the enroll operation and the SD are used to reconstruct the digital fingerprint. It is done after every power-up and reset.
Generate Key: The controller generates an unique key and combines it with the digital fingerprint to output a key code. Each time a Generate Key operation is executed a new unique key is generated.
Set Key: The digital fingerprint generated during the Enroll/Start operations and the key provided by the Client Design (CD) are used to generate a Key Code. This KC can be stored externally. Perform this operation only once for each key.
Get Key: The digital fingerprint generated during the Start operation and the KC generated during a Set Key operation are used to retrieve a stored key. Perform this operation every time a key is needed.
Supported Boards#
FRDM-MCXN236
Hardware requirements
Type-C USB cable
FRDM-MCXN236 board
Personal Computer
Board settings
Prepare the Demo
Connect a USB cable between the host PC and the MCU-Link USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
When the demo runs successfully, the log would be seen on the MCU-Link terminal like:
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestStart:PASS
1510003:TestDeriveDeviceKey:PASS
1510004:TestRandomWrapUnwrap:PASS
1510005:TestUserKeyWrapUnwrap:PASS
1510006:TestStop:PASS
###### 1510007:TestZeroize:PASS
8 Tests 0 Failures 0 Ignored
OK
FRDM-MCXN947
Hardware requirements
Type-C USB cable
FRDM-MCXN947 board
Personal Computer
Board settings
Prepare the Demo
Connect a USB cable between the host PC and the MCU-Link USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
When the demo runs successfully, the log would be seen on the MCU-Link terminal like:
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestStart:PASS
1510003:TestDeriveDeviceKey:PASS
1510004:TestRandomWrapUnwrap:PASS
1510005:TestUserKeyWrapUnwrap:PASS
1510006:TestStop:PASS
###### 1510007:TestZeroize:PASS
8 Tests 0 Failures 0 Ignored
OK
FRDM-MCXN947T
Hardware requirements
Type-C USB cable
FRDM-MCXN947T board
Personal Computer
Board settings
Prepare the Demo
Connect a USB cable between the host PC and the MCU-Link USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
When the demo runs successfully, the log would be seen on the MCU-Link terminal like:
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestStart:PASS
1510003:TestDeriveDeviceKey:PASS
1510004:TestRandomWrapUnwrap:PASS
1510005:TestUserKeyWrapUnwrap:PASS
1510006:TestStop:PASS
###### 1510007:TestZeroize:PASS
8 Tests 0 Failures 0 Ignored
OK
LPCXpresso55S36
Hardware requirements
Mini/micro USB cable
LPCXpresso55S36 board
Personal Computer
Prepare the Demo
Connect a micro USB cable between the PC host and the CMSIS DAP USB port (J1) on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
The log below shows the output of the PUF driver example in the terminal window (the key value will vary):
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestStart:PASS
1510003:TestDeriveDeviceKey:PASS
1510004:TestRandomWrapUnwrap:PASS
1510005:TestUserKeyWrapUnwrap:PASS
1510006:TestStop:PASS
###### 1510007:TestZeroize:PASS
8 Tests 0 Failures 0 Ignored
OK
MCX-N5XX-EVK
Hardware requirements
Mini/micro USB cable
MCX-N5XX-EVK board
Personal Computer
Board settings
No special settings are required.
Prepare the Demo
Connect a USB cable between the host PC and the MCU-Link USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
When the demo runs successfully, the log would be seen on the MCU-Link terminal like:
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestStart:PASS
1510003:TestDeriveDeviceKey:PASS
1510004:TestRandomWrapUnwrap:PASS
1510005:TestUserKeyWrapUnwrap:PASS
1510006:TestStop:PASS
###### 1510007:TestZeroize:PASS
8 Tests 0 Failures 0 Ignored
OK
MCX-N9XX-EVK
Hardware requirements
Mini/micro USB cable
MCX-N9XX-EVK board
Personal Computer
Board settings
Prepare the Demo
Connect a USB cable between the host PC and the MCU-Link USB port on the target board.
Open a serial terminal with the following settings:
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
When the demo runs successfully, the log would be seen on the MCU-Link terminal like:
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestStart:PASS
1510003:TestDeriveDeviceKey:PASS
1510004:TestRandomWrapUnwrap:PASS
1510005:TestUserKeyWrapUnwrap:PASS
1510006:TestStop:PASS
###### 1510007:TestZeroize:PASS
8 Tests 0 Failures 0 Ignored
OK
MIMXRT700-EVK
Hardware requirements
Micro USB cable
MIMXRT700-EVK board
Personal Computer
Board settings
Prepare the Demo
Connect a micro USB cable between the PC host and the CMSIS DAP USB port on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
When the demo runs successfully, the terminal displays similar information like the following:
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestEnroll:PASS
1510003:TestStartAfterEnroll:PASS
1510004:TestDeriveDeviceKey:PASS
1510005:TestRandomWrapUnwrap:PASS
1510006:TestUserKeyWrapUnwrap:PASS
1510007:TestStop:PASS
###### 1510008:TestZeroize:PASS
9 Tests 0 Failures 0 Ignored
FRDM-IMXRT700
Hardware requirements
Type-C USB cable
FRDM-IMXRT700 board
Personal Computer
Board settings
Prepare the Demo
Connect a USB cable between the PC host and the CMSIS DAP USB port on the board
Open a serial terminal with the following settings (See Appendix A in Getting started guide for description how to determine serial port number):
115200 baud rate
8 data bits
No parity
One stop bit
No flow control
Download the program to the target board.
Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.
Running the demo
When the demo runs successfully, the terminal displays similar information like the following:
PUFv3 driver example
1510000:TestSelftest:PASS
1510001:TestGenerateRandomData:PASS
1510002:TestEnroll:PASS
1510003:TestStartAfterEnroll:PASS
1510004:TestDeriveDeviceKey:PASS
1510005:TestRandomWrapUnwrap:PASS
1510006:TestUserKeyWrapUnwrap:PASS
1510007:TestStop:PASS
###### 1510008:TestZeroize:PASS
9 Tests 0 Failures 0 Ignored