/Reprogram-TEE-on-Qualcomm-devices

Guide to reprogram the TEE on Qualcomm devices to fix lost attestation keys

The UnlicenseUnlicense

Reprogram TEE on Qualcomm devices

Guide to reprogram the TEE on Qualcomm devices to fix lost attestation keys.

Why?

If you are here it is because your phone has lost the TEE attestation keys, possibly due to flashing the persist partition of your phone.

If opening Key Attestation Demo does not give you any error, do NOT follow this guide.

This guide will NOT provide instructions for passing Strong verdict.

WARNINGS:

  • Your data will be lost, so backup your phone data first.
  • The original keys that your phone may include in the TEE will be lost.
  • I am not responsible for any other problems that may arise, these instructions are made on a POCO X3 Pro (vayu) and work perfectly, they may not work as they should on other phones.
  • You won't pass Strong verdict even with stock ROM and locked bootloader due Google banned this keybox.

You will need:

  • A working brain.
  • A working computer.
  • An unlocked bootloader.
  • A valid keybox.xml file, you can use this one in the repo (BANNED).
  • The engineering ROM for your device.
  • BASIC KNOWLEDGE OF LINUX.

Instructions:

  1. Flash engineering ROM.
  2. Phone must be connected to PC, then execute this commands IN ORDER:

adb root

adb disable-verity

adb reboot

adb root

adb remount

adb shell

mkdir -p /data/nativetest64/qti_keymaster_tests/

exit

adb push keybox.xml /data/nativetest64/qti_keymaster_tests/

adb shell

cd /data/nativetest64/qti_keymaster_tests/

Now you can use:

LD_LIBRARY_PATH=/vendor/lib64/hw KmInstallKeybox {KEYBOX FILE} {KEYBOX DEVICE ID} {ATTEST PROPS?}

For StrongBox devices:

LD_LIBRARY_PATH=/vendor/lib64/hw KmInstallKeybox {KEYBOX FILE} {KEYBOX DEVICE ID} {ATTEST PROPS?} {KEYBOX FILE} {KEYBOX DEVICE ID} {ATTEST PROPS?}

{KEYBOX FILE}: Should be "keybox.xml"

{KEYBOX DEVICE ID}: Open keybox file and search for "DeviceID", repo keybox uses "X705F100000000"

{ATTEST PROPS?}: Boolean, should be true/false, I recommend setting it as true always. If it gives any error use false.

So, for the keybox in the repo you must run:

LD_LIBRARY_PATH=/vendor/lib64/hw KmInstallKeybox keybox.xml X705F100000000 true

If your device has StrongBox:

LD_LIBRARY_PATH=/vendor/lib64/hw KmInstallKeybox keybox.xml X705F100000000 true keybox.xml X705F100000000 true