==== Preface ====

The following instructions describe how to prepare and generate the project and writing an image via flashloader with MCUXpresso Secure Provisioning tool.
<callout type="info" icon="true">
In this guide, we assume that the repository with examples was either built in advance or downloaded from [[https://github.com/tq-systems/MBa117xL.SW.MCU.BSP/tree/main/examples|GitHub]].
The instructions on this page refer to the TQMa117xL repository and ancillary tools listed in the following table:
</callout>
<grid>
<col sm="6">
^  Tool  ^  Version  ^
^ GitHub Repository |  [[https://github.com/tq-systems/MBa117xL.SW.MCU.BSP | MBa117xL.SW.MCU.BSP]]  |
^ [[https://code.visualstudio.com/Download|VS-Code]] |  Version 1.88.1  |
^ [[https://www.nxp.com/design/design-center/software/development-software/mcuxpresso-software-and-tools-/mcuxpresso-integrated-development-environment-ide:MCUXpresso-IDE|MCUXpresso Secure Provisioning]]  |  Version 8.0  |
^ [[https://www.nxp.com/design/design-center/software/development-software/mcuxpresso-software-and-tools-/mcuxpresso-config-tools-pins-clocks-and-peripherals:MCUXpresso-Config-Tools|MCUXpresso Config Tools]]  |  Version 15.1  |
</col>
</grid>

==== Booting from flash ====

<panel type="primary" title="Writing the examples">
<div>
<panel type="default" title="STEP 1 - Rebuilding the image">
<grid>
<col sm="6">
{{ :en:arm:step_1.webp |}}
</col>
<col sm="6">
To be able to write the Image with the MCU Secure Provisioning Tool the project has to be rebuilt with the option:
<code>DXIP_BOOT_HEADER_ENABLE=0</code>
</col>
</grid>
</panel>

<panel type="default" title="STEP 2 - Generating the dcd.bin">
<grid>
<col sm="6">
{{ :en:arm:tqma117xl:step_2.webp |}}
</col>
<col sm="6">
This step is to generate a **dcd.bin** file of your current hardware configuration. Start the **MCUXpresso Config Tool** and open the** MBa117xL.SW.PQ.mex** pinmuxing file from your project.\\
\\
By default this file is located in **examples/board** in the project. Afterwards you need to select the **Device Configuration** tab from the menu icons. Select **binary as output format** in the DCD window and update the the code. The dcd.bin file should now be saved in the board folder.
</col>
</grid>
</panel>

<panel type="default" title="STEP 3 - Building">
After rebuilding the project with disabled **XIP boot header** and building the **dcd.bin** file from your muxing configuration, the **MCUXpresso Secure Provisioning** tool can be started.\\
Within the **MCUXpresso Secure Provisioning** tool main window select **FlexSPI NOR – simplified** to setup the **NOR flash** properly. Setup the **NOR Flash** in the **Boot Memory Configuration** window.\\
\\
Afterwards the image for flashing can be built by clicking the **Build image** button. \\
</panel>

<panel type="default" title="STEP 3 - Building">
**Please ensure that the corresponding DIP Switches are configured for Serial Downloader mode.**
<div>
<panel type="primary" title="Serial Downloader">

<col sm="3">
<WRAP centeralign>
[size=150%]**S3**[/size]
{{ :en:dip_4_0000.png?nolink&150 |}}
</WRAP>
</col>

<col sm="3">
<WRAP centeralign>
[size=150%]**S4**[/size]
{{ :en:dip_4_0000.png?nolink&150 |}}
</WRAP>
</col>

<col sm="3">
<WRAP centeralign>
[size=150%]**S5**[/size]
{{ :en:dip_4_0000.png?nolink&150 |}}
</WRAP>
</col>

<col sm="3">
<WRAP centeralign>
[size=150%]**S6**[/size]
{{ :en:dip_4_1011.png?nolink&150 |}}
</WRAP>
</col>

</panel>
Setup the target Hardware connection properly (USB or UART1). If UART1 is used for flashing the corresponding COM Port and a **baudrate of 115200** has to be configured. \\
\\
Next, select the **write image** tab, start the flashloader and finally write the image. \\
\\
After successfully writing the image, set the DIP Switches to **internal boot** and perform a powercycle.
\\
<panel type="primary" title="Internal Boot">

<col sm="3">
<WRAP centeralign>
[size=150%]**S3**[/size]
{{ :en:dip_4_0000.png?nolink&150 |}}
</WRAP>
</col>

<col sm="3">
<WRAP centeralign>
[size=150%]**S4**[/size]
{{ :en:dip_4_0000.png?nolink&150 |}}
</WRAP>
</col>

<col sm="3">
<WRAP centeralign>
[size=150%]**S5**[/size]
{{ :en:dip_4_0000.png?nolink&150 |}}
</WRAP>
</col>

<col sm="3">
<WRAP centeralign>
[size=150%]**S6**[/size]
{{ :en:dip_4_0111.png?nolink&150 |}}
</WRAP>
</col>

</panel>
</div>
</panel>

</div>
</panel>