1. Connecting your board to a host machine.

2. Installing software on the host machine for developing and debugging embedded applications for your microcontroller board.

3. Cross compiling a FreeRTOS demo application to a binary image.

4. Loading the application binary image to your board, and then running the application.

To set up the MicroZed board

1. Connect your computer to the USB-UART port on your MicroZed board.

2. Connect your computer to the JTAG Access port on your MicroZed board.

3. Connect a router or internet-connected Ethernet port to the Ethernet and USB-Host port on your MicroZed board.

To download the XSDK

1. Go to the Software Development Kit Standalone WebInstall Client download page.

2. Choose the option appropriate for your operating system.

3. You are directed to a Xilinx sign-in page.

   If you have an account with Xilinx, enter your sign-in credentials and then chooseSign in.

   If you do not have an account, chooseCreate your account. After you register, you should receive an email with a link to activate your Xilinx account.

4. On theName and Address Verification page, enter your information and then chooseNext. The download should be ready to start.

5. Save theXilinx_SDK_version_os file.

To install the XSDK

1. Open theXilinx_SDK_version_os file.

2. InSelect Edition to Install, chooseXilinx Software Development Kit (XSDK) and then chooseNext.

3. On the following page of the installation wizard, underInstallation Options, selectInstall Cable Drivers and then chooseNext.

To subscribe to the MQTT topic with the AWS IoT MQTT client

1. Sign in to theAWS IoT console.

2. In the navigation pane, chooseTest, then chooseMQTT test client to open the MQTT client.

3. InSubscription topic, enteryour-thing-name/example/topic, and then chooseSubscribe to topic.

1. Launch the XSDK IDE with the workspace directory set tofreertos/projects/xilinx/microzed/xsdk.

2. Close the welcome page. From the menu, chooseProject, and then clearBuild Automatically.

3. From the menu, chooseFile, and then chooseImport.

4. On theSelect page, expandGeneral, chooseExisting Projects into Workspace, and then chooseNext.

5. On theImport Projects page, chooseSelect root directory, and then enter the root directory of your demo project:freertos/projects/xilinx/microzed/xsdk/aws_demos. To browse for the directory, chooseBrowse.

   After you specify a root directory, the projects in that directory appear on theImport Projects page. All available projects are selected by default.

   Note

   If you see a warning at the top of theImport Projects page ("Some projects cannot be imported because they already exist in the workspace.") you can ignore it.

6. With all of the projects selected, chooseFinish.

7. If you don't see theaws_bsp,fsbl, andMicroZed_hw_platform_0 projects in the projects pane, repeat the previous steps starting from #3 but with the root directory set tofreertos/vendors/xilinx, and importaws_bsp,fsbl, andMicroZed_hw_platform_0.

8. From the menu, chooseWindow, and then choosePreferences.

9. In the navigation pane, expandRun/Debug, chooseString Substitution, and then chooseNew.

10. InNew String Substitution Variable, forName, enterAFR_ROOT. ForValue, enter the root path of thefreertos/projects/xilinx/microzed/xsdk/aws_demos. ChooseOK, and then chooseOK to save the variable and closePreferences.

1. In the XSDK IDE, from the menu, chooseProject, and then chooseClean.

2. InClean, leave the options at their default values, and then chooseOK. XSDK cleans and builds all of the projects, and then generates.elf files.

   Note

   To build all projects without cleaning them, chooseProject, and then chooseBuild All.

   To build individual projects, select the project you want to build, chooseProject, and then chooseBuild Project.

1. In the XSDK IDE, right-clickaws_demos, and then chooseCreate Boot Image.

2. InCreate Boot Image, chooseCreate new BIF file.

3. Next toOutput BIF file path, chooseBrowse, and then chooseaws_demos.bif located at<freertos>/vendors/xilinx/microzed/aws_demos/aws_demos.bif.

4. ChooseAdd.

5. OnAdd new boot image partition, next toFile path, chooseBrowse, and then choosefsbl.elf, located atvendors/xilinx/fsbl/Debug/fsbl.elf.

6. For thePartition type, choosebootloader, and then chooseOK.

7. OnCreate Boot Image, chooseCreate Image. OnOverride Files, chooseOK to overwrite the existingaws_demos.bif and generate theBOOT.bin file atprojects/xilinx/microzed/xsdk/aws_demos/BOOT.bin.

1. Set your MicroZed board's boot mode jumpers to the JTAG boot mode.

   

2. Insert your MicroSD card into the MicroSD card slot located directly under the USB-UART port.

   Note

   Before you debug, be sure to back up any content that you have on the MicroSD card.

   Your board should look similar to the following:

   

3. In the XSDK IDE, right-clickaws_demos, chooseDebug As, and then choose1 Launch on System Hardware (System Debugger).

4. When the debugger stops at the breakpoint inmain(), from the menu, chooseRun, and then chooseResume.

   Note

   The first time you run the application, a new certificate-key pair is imported into non-volatile memory. For subsequent runs, you can comment outvDevModeKeyProvisioning() in themain.c file before you rebuild the images and theBOOT.bin file. This prevents the copying of the certificates and key to storage on every run.

Format the MicroSD card that is provided with the Xilinx MicroZed Industrial IoT Kit.

1. Copy theBOOT.bin file to the MicroSD card.

2. Insert the card into the MicroSD card slot directly under the USB-UART port.

3. Set the MicroZed boot mode jumpers to SD boot mode.

   

4. Press the RST button to reset the device and start booting the application. You can also unplug the USB-UART cable from the USB-UART port, and then reinsert the cable.

1. Set your MicroZed board's boot mode jumpers to the JTAG boot mode.

   

2. Verify that your computer is connected to the USB-UART and JTAG Access ports. The green Power Good LED light should be illuminated.

3. In the XSDK IDE, from the menu, chooseXilinx, and then chooseProgram Flash.

4. InProgram Flash Memory, the hardware platform should be filled in automatically. ForConnection, choose your MicroZed hardware server to connect your board with your host computer.

   Note

   If you are using the Xilinx Smart Lync JTAG cable, you must create a hardware server in XSDK IDE. ChooseNew, and then define your server.

5. InImage File, enter the directory path to yourBOOT.bin image file. ChooseBrowse to browse for the file instead.

6. InOffset, enter0x0.

7. InFSBL File, enter the directory path to yourfsbl.elf file. ChooseBrowse to browse for the file instead.

8. ChooseProgram to program your board.

9. After the QSPI programming is complete, remove the USB-UART cable to power off the board.

10. Set your MicroZed board's boot mode jumpers to the QSPI boot mode.

11. Insert your card into the MicroSD card slot located directly under the USB-UART port.

    Note

    Be sure to back up any content that you have on the MicroSD card.

12. Press the RST button to reset the device and start booting the application. You can also unplug the USB-UART cable from the USB-UART port, and then reinsert the cable.