readme.txt 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495
  1. Intro
  2. =====
  3. This default configuration will allow you to start experimenting with
  4. the buildroot environment for the MacchiatoBin board based on the
  5. Marvell Armada 8040 SoC. Documentation for the board hardware and
  6. software is available on the wiki at: http://wiki.macchiatobin.net
  7. This default configuration will bring up the board and allow access
  8. through the serial console.
  9. How to build
  10. ============
  11. There are two build options: mainline support and vendor support.
  12. For the mainline BSP, we use:
  13. - Linux v4.19.2
  14. - U-Boot v2018.11
  15. For the vendor BSP, we use the sources available from Marvell Github
  16. page at https://github.com/MarvellEmbeddedProcessors, which uses:
  17. - Linux v4.4.120
  18. - U-Boot v2018.03
  19. At the moment mainline support for the board is a work in
  20. progress. Mainline kernel 4.19 enables eth2 in 1Gb (RJ45 connector J5),
  21. copper 10Gb interfaces, and automatic configuration of select SFP
  22. modules on the SFP cages. The vendor BSP enables more hardware features
  23. out of the box, but lacks support for SFP detection and automatic
  24. configuration.
  25. To use the mainline BSP run the following commands:
  26. $ make solidrun_macchiatobin_mainline_defconfig
  27. $ make
  28. To use the vendor BSP run the following commands:
  29. $ make solidrun_macchiatobin_marvell_defconfig
  30. $ make
  31. How to write the SD card
  32. ========================
  33. Once the build process is finished you will have an image
  34. called "sdcard.img" in the output/images/ directory.
  35. Copy the bootable "sdcard.img" onto an SD card with "dd":
  36. $ sudo dd if=output/images/sdcard.img of=/dev/sdX bs=1M conv=fsync
  37. $ sudo sync
  38. How to boot the board
  39. =====================
  40. The MacchiatoBin board can be setup to load the bootloader from
  41. different sources including eMMC, SPI flash, and SD-card.
  42. On Rev 1.2 board to select boot from SD-card the DIP switches
  43. SW1 and SW2 should be configured as follows:
  44. SW2: 01110
  45. SW1: 1xxxx
  46. The upcoming Rev 1.3 board will have a single pins header J1 instead
  47. of the SW1/2 DIP switches. To boot from SD-card the setting of J1
  48. jumpers should match the DIP switches of Rev v1.2 board
  49. from left to right:
  50. J1: 011101xxxx
  51. Insert the micro SDcard in the MacchiatoBin board and power it up.
  52. The serial console is accessible at the micro-USB Type-B connector
  53. marked CON9. The serial line settings are 115200 8N1.
  54. Note: the following text only applies to the vendor BSP from
  55. solidrun_macchiatobin_marvell_defconfig.
  56. By default Marvell provided U-Boot will load its environment from the
  57. SPI flash. On the first boot SPI flash may be empty or it may contain a
  58. legacy environment that prevents proper boot. Then the following
  59. commands can be used to boot the board:
  60. => ext4load mmc 1:1 0x01700000 /boot/uEnv-example.txt
  61. => env import -t 0x01700000 $filesize
  62. => boot
  63. The example environment from uEnv-example.txt can be written to
  64. SPI flash using the following commands:
  65. => env default -f -a
  66. => ext4load mmc 1:1 0x01700000 /boot/uEnv-example.txt
  67. => env import -t 0x01700000 $filesize
  68. => saveenv