readme.txt 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. **************************************************
  2. Xilinx Kria SOM Starter Kits - ZynqMP SoC
  3. **************************************************
  4. This document describes the Buildroot support for the Kria KD240,
  5. KR260 and KV260 starter kits by Xilinx, based on Kria SOM including the
  6. Zynq UltraScale+ MPSoC (aka ZynqMP). It has been tested with
  7. the KD240, KR260 and KV260 production boards.
  8. Evaluation board features can be found here with the links below.
  9. KD240:
  10. https://www.xilinx.com/products/som/kria/kd240-drives-starter-kit.html
  11. KR260:
  12. https://www.xilinx.com/products/som/kria/kr260-robotics-starter-kit.html
  13. KV260:
  14. https://www.xilinx.com/products/som/kria/kv260-vision-starter-kit.html
  15. How to build it
  16. ===============
  17. Configure Buildroot: (use the command for the specific board)
  18. $ make zynqmp_kria_kd240_defconfig
  19. $ make zynqmp_kria_kr260_defconfig
  20. $ make zynqmp_kria_kv260_defconfig
  21. Compile everything and build the rootfs image:
  22. $ make
  23. Result of the build
  24. -------------------
  25. After building, you should get a tree like this:
  26. output/images/
  27. +-- atf-uboot.ub
  28. +-- bl31.bin
  29. +-- boot.bin
  30. +-- boot.vfat
  31. +-- Image
  32. +-- rootfs.ext2
  33. +-- rootfs.ext4 -> rootfs.ext2
  34. +-- sdcard.img
  35. +-- system.dtb -> smk-k26-revA-sck-kv-g-revB.dtb
  36. +-- u-boot.itb
  37. `-- smk-k26-revA-sck-kv-g-revB.dtb
  38. How to write the SD card
  39. ========================
  40. WARNING! This will destroy all the card content. Use with care!
  41. The sdcard.img file is a complete bootable image ready to be written
  42. on the boot medium. To install it, simply copy the image to an SD
  43. card:
  44. # dd if=output/images/sdcard.img of=/dev/sdX
  45. Where 'sdX' is the device node of the SD.
  46. Eject the SD card, insert it in the board, and power it up.
  47. How to write boot.bin and u-boot.itb to QSPI boot flash
  48. =======================================================
  49. The Kria SOMs are preconfigured to boot initially from QSPI.
  50. This makes these boards different from other ZynqMP boards
  51. in that the boot.bin and u-boot.itb files need to be flashed
  52. into the QSPI boot flash such that U-Boot can then load all
  53. of the remaining images from the SD card.
  54. In addition, the Kria Starter Kits QSPI comes pre-flashed with
  55. a utility designed to make updating the QSPI flash memory
  56. easier.
  57. Instructions for using these utilities to update the files
  58. in QSPI flash can be found on the wiki link below.
  59. https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/1641152513/Kria+K26+SOM#Boot-Firmware-Updates
  60. Additionally, it is possible to use u-boot for updating the
  61. QSPI with new boot.bin and u-boot.itb images with the u-boot
  62. commands below.
  63. KV260 Flashing Instructions:
  64. Flashing u-boot.itb:
  65. $ sf probe
  66. $ fatload mmc 1 0x1000000 u-boot.itb
  67. $ sf erase 0xf80000 +$filesize
  68. $ sf write 0x1000000 0xf80000 $filesize
  69. Flashing boot.bin:
  70. $ sf probe
  71. $ fatload mmc 1 0x1000000 boot.bin
  72. $ sf erase 0x200000 +$filesize
  73. $ sf write 0x1000000 0x200000 $filesize
  74. KD240 / KR260 Flashing Instructions:
  75. Flashing u-boot.itb:
  76. $ usb start
  77. $ sf probe
  78. $ fatload usb 0 0x1000000 u-boot.itb
  79. $ sf erase 0xf80000 +$filesize
  80. $ sf write 0x1000000 0xf80000 $filesize
  81. Flashing boot.bin:
  82. $ usb start
  83. $ sf probe
  84. $ fatload usb 0 0x1000000 boot.bin
  85. $ sf erase 0x200000 +$filesize
  86. $ sf write 0x1000000 0x200000 $filesize
  87. It is possible to boot the Buildroot generated SD card image without
  88. updating the QSPI boot.bin image, so this is an optional step.