readme.txt 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175
  1. This document explains how to set up a basic Buildroot system on
  2. various Atmel/Microchip boards. Additional details can also be found
  3. on the Linux4SAM website: http://www.linux4sam.org
  4. This guide covers the following configurations:
  5. - at91sam9g45m10ek_defconfig
  6. - at91sam9rlek_defconfig
  7. - at91sam9x5ek_defconfig (at91sam9g15, at91sam9g25, at91sam9x25,
  8. at91sam9g35 and at91sam9x35)
  9. - atmel_sama5d3xek_defconfig (sama5d31, sama5d33, sama5d34, sama5d35,
  10. sama5d36)
  11. - atmel_sama5d3_xplained_defconfig
  12. - atmel_sama5d3_xplained_dev_defconfig
  13. - atmel_sama5d3_xplained_mmc_defconfig
  14. - atmel_sama5d3_xplained_mmc_dev_defconfig
  15. - atmel_sama5d4_xplained_defconfig
  16. - atmel_sama5d4_xplained_dev_defconfig
  17. - atmel_sama5d4_xplained_mmc_defconfig
  18. - atmel_sama5d4_xplained_mmc_dev_defconfig
  19. - atmel_sama5d2_xplained_mmc_defconfig
  20. - atmel_sama5d2_xplained_mmc_dev_defconfig
  21. - microchip_sama5d27_wlsom1_ek_mmc_defconfig
  22. - microchip_sama5d27_wlsom1_ek_mmc_dev_defconfig
  23. These configurations will use AT91Bootstrap, u-boot and a linux kernel from
  24. the git trees maintained by Atmel.
  25. The configurations labeled as 'dev' provide a development rootfs with tools to
  26. tests the features of the SoC:
  27. - ALSA tools to test audio
  28. - FFMPEG to record video from the ISI/ISC
  29. - I2C, SPI, CAN, etc. tools
  30. - modetest for LCD screens, HDMI
  31. - Wilc1000/Wilc3000 firmware for the Atmel Wireless sdio module
  32. - SSH for convenience
  33. - GDB/GDB server for debug
  34. Configuring and building Buildroot
  35. ==================================
  36. For the Xplained/Evaluation Kit boards, the Buildroot configuration is
  37. provided to boot from an SD card. Those configurations are labeled as
  38. 'mmc'. In this case, after building Buildroot, follow the instructions
  39. in the "Preparing the SD card" section.
  40. For the other configurations listed above, the Buildroot configuration
  41. assumes the system will be flashed on NAND. In this case, after
  42. building Buildroot, follow the instructions in the "Flashing the NAND
  43. using SAM-BA" section below.
  44. To configure and build Buildroot, run:
  45. make <board>_defconfig
  46. make
  47. Flashing the NAND using SAM-BA
  48. ==============================
  49. Flashing the board
  50. ------------------
  51. Connect the board:
  52. o at91sam9g45m10ek: DBGU: J10, USB sam-ba: J14
  53. o at91sam9rlek: DBGU: J19, USB sam-ba: J21
  54. o at91sam9x5ek: DBGU: J11, USB sam-ba: J20
  55. o sama5d3xek: DBGU: J14, USB sam-ba: J20
  56. o sama5d3 Xplained: DBGU: J23, USB sam-ba: J6
  57. o sama5d4ek: DBGU: J22 or J24, USB sam-ba: J1
  58. o sama5d4 Xplained: DBGU: J1, USB sam-ba: J11
  59. Start the board in RomBOOT:
  60. o at91sam9g45m10ek:
  61. 1. open JP8, JP10 and JP12
  62. 2. start the board
  63. 3. close JP8, JP10 and JP12
  64. o at91sam9rlek:
  65. 1. J11 on 1-2 (BMS=1), open J12 and J13
  66. 2. start the board
  67. 3. close J12 and J13
  68. o at91sam9x5ek:
  69. 1. open JP9 and:
  70. - Cogent: open *NCS jumper
  71. - Embest: open SW1
  72. - Ronetix: open J1 and J2
  73. 2. start the board
  74. 3. close JP9 and:
  75. - Cogent: close *NCS jumper
  76. - Embest: close SW1 (ON position)
  77. - Ronetix: close J1 and J2
  78. o sama5d3xek:
  79. 1. start the board
  80. 2. push BP4 and BP1
  81. 3. release BP1
  82. 4. release BP4
  83. o sama5d3 Xplained:
  84. 1. open JP5 (NANDCS) and JP6 (SPICS)
  85. 2. start the board
  86. 3. close JP5 ans JP6
  87. o sama5d4ek:
  88. 1. start the board
  89. 2. push BP3 and BP4
  90. 3. release BP4
  91. 4. release BP3
  92. o sama5d4 Xplained:
  93. 1. close JP7 (BOOT_DIS)
  94. 2. start the board
  95. 3. open JP7
  96. "RomBOOT" should appear on your console (this should be ttyUSBx or ttyACMx)
  97. Now locate the USB sam-ba interface it should be ttyACMx, usually ttyACM0
  98. dmesg on your machine should give:
  99. usb 1-2.1.4: New USB device found, idVendor=03eb, idProduct=6124
  100. usb 1-2.1.4: New USB device strings: Mfr=0, Product=0, SerialNumber=0
  101. cdc_acm 1-2.1.4:1.0: ttyACM0: USB ACM device
  102. Look for idVendor=03eb, idProduct=6124, this is the interface you want to use.
  103. You can then flash the board using the provided flasher.sh script in board/atmel:
  104. board/atmel/flasher.sh <builddir_path> <interface> <board>
  105. For example, for an out of tree build made in
  106. /tmp/atmel_sama5d3_xplained/ for the sama5d3 Xplained, you would use:
  107. board/atmel/flasher.sh /tmp/atmel_sama5d3_xplained/ /dev/ttyACM0 sama5d3_xplained
  108. Reboot, the system should boot up to the buildroot login invite.
  109. Preparing the SD card
  110. =====================
  111. An image named sdcard.img is automatically generated. With this image,
  112. you no longer have to care about the creation of the partition and
  113. copying files to the SD card.
  114. You need at least a 1GB SD card. All the data on the SD card will be
  115. lost. To copy the image on the SD card:
  116. /!\ Caution be sure to do it on the right mmcblk device /!\
  117. dd if=output/images/sdcard.img of=/dev/mmcblk0
  118. Insert your SD card in your Xplained/Evaluation Kit board, and
  119. enjoy. The default U-Boot environment will load properly the kernel
  120. and Device Tree blob from the first partition of the SD card, so
  121. everything works automatically.
  122. By default a 16MB FAT partition is created. It contains at91bootstrap,
  123. u-boot, the kernel image and all dtb variants for your board. The dtb
  124. used is the basic one:
  125. U-Boot> print
  126. [...]
  127. bootcmd=fatload mmc 1:1 0x21000000 at91-sama5d2_xplained.dtb; fatload mmc 1:1 0x22000000 zImage; bootz 0x22000000 - 0x21000000
  128. [...]
  129. If you want to use a variant such as the _pda7 one, you will have to
  130. update your u-boot environment:
  131. U-Boot> setenv bootcmd 'fatload mmc 1:1 0x21000000 at91-sama5d2_xplained_pda7.dtb; fatload mmc 1:1 0x22000000 zImage; bootz 0x22000000 - 0x21000000'
  132. U-Boot> save
  133. Saving Environment to FAT...
  134. writing uboot.env
  135. done
  136. A 512MB ext4 partition is also created to store the rootfs generated.
  137. If you want to customize the size of the partitions and their content,
  138. take a look at the the genimage.cfg file in the board directory.