Dragonwing IQ-9075 development platform
=========================================

Trusted Firmware-A (TF-A) platform port for Lemans SoC based EVK platform also
known as IQ-9075 as the marketing name. For details about IQ-9075 platform,
refer to this
`link <https://www.qualcomm.com/internet-of-things/products/iq9-series/iq-9075>`__

Boot flow
-------------

Similar to :ref:`Dragonwing RB3 Gen 2 development platform`.

How to build
------------

Steps to build TF-A BL2 and FIP payload::

	$ make CROSS_COMPILE=aarch64-none-elf- PLAT=lemans_evk SPD=opteed \
            QTISECLIB_PATH=<qtiseclib-path> BL32=<path-to-optee-bin> \
            BL33=<path-to-os-bootloader-bin> fip all

        $ ./tools/qti/generate_fip_elf.sh build/lemans_evk/release/fip.bin \
            0xaf000000

QTISECLIB for lemans is still work under progress, the current port allows to
boot OP-TEE OS.

Note that the bl2.elf generated here is required to be signed as TZ image with
QTI signing involved. Also, the fip.elf generated above is signed using
`qtestsign <https://github.com/msm8916-mainline/qtestsign>`__ which just puts
the OEM test signature to allow it to work on devices in non-secure mode. In
secure mode, it is required to be signed using
`sectools v2 <https://docs.qualcomm.com/bundle/publicresource/topics/80-70020-11/tools.html>`__

How to flash
------------

Generate a Yocto BSP image for iq-9075-evk following instructions from meta-qcom
`here <https://github.com/qualcomm-linux/meta-qcom?tab=readme-ov-file#quick-build>`__

It will generate a tar ball in the build folder for iq-9075-evk something like:
`qcom-multimedia-image-iq-9075-evk.rootfs.qcomflash.tar.gz`. Untar it and replace
`tz.mbn` with `bl2.mbn` and `uefi.elf` with `fip.elf` that you have generated by
yourself.

Then flash the board following the meta-qcom instructions
`here <https://github.com/qualcomm-linux/meta-qcom?tab=readme-ov-file#flash-images>`__

Boot Trace
-------------

Boot logs on lemans_evk::

        Format: Log Type - Time(microsec) - Message - Optional Info
        Log Type: B - Since Boot(Power On Reset),  D - Delta,  S - Statistic
        S - QC_IMAGE_VERSION_STRING=BOOT.MXF.1.0.c1-00430-KODIAKLA-1
        S - IMAGE_VARIANT_STRING=SocLeMansLAA
        S - OEM_IMAGE_VERSION_STRING=258af405f4c7
        <snip-XBL-logs>
        NOTICE:  BL2: v2.14.0(release):v2.13.0-1873-g0c07fd50a
        NOTICE:  BL2: Built : 17:52:29, Feb 17 2026
        NOTICE:  BL2: Booting BL31
        NOTICE:  BL31: v2.14.0(release):v2.13.0-1873-g0c07fd50a
        NOTICE:  BL31: Built : 17:52:29, Feb 17 2026
        ERROR:   Please use QTISECLIB_PATH while building TF-A
        ERROR:   Please refer docs/plat/qti/* for more details.
        I/TC:
        I/TC: OP-TEE version: 4.9.0-1-gc6cb871cc (gcc version 11.4.0 (Ubuntu 11.4.0-1ubuntu1~22.04)) #1 Tue Feb 17 12:22:27 UTC 2026 aarch64
        I/TC: WARNING: This OP-TEE configuration might be insecure!
        I/TC: WARNING: Please check https://optee.readthedocs.io/en/latest/architecture/porting_guidelines.html
        I/TC: Primary CPU initializing
        I/TC: Platform Qualcomm: Flavor lemans
        I/TC: Primary CPU switching to normal world boot
        PANIC at PC : 0x000000001c200d70