readme.txt
1Intro
2=====
3
4This default configuration will allow you to start experimenting with
5the buildroot environment for the MacchiatoBin board based on the
6Marvell Armada 8040 SoC. Documentation for the board hardware and
7software is available on the wiki at: http://wiki.macchiatobin.net
8
9This default configuration will bring up the board and allow access
10through the serial console.
11
12How to build
13============
14
15Default configuration provides the following BSP versions:
16 - Linux v5.6.3 (mainline)
17 - U-Boot v2020.01 (mainline)
18 - ATF v1.5-18.12.2 (Marvell)
19
20To build images run the following commands:
21
22 $ make solidrun_macchiatobin_defconfig
23 $ make
24
25How to write the SD card
26========================
27
28Once the build process is finished you will have an image
29called "sdcard.img" in the output/images/ directory.
30
31Copy the bootable "sdcard.img" onto an SD card with "dd":
32
33 $ sudo dd if=output/images/sdcard.img of=/dev/sdX bs=1M conv=fsync
34 $ sudo sync
35
36How to boot the board
37=====================
38
39The MacchiatoBin board can be setup to load the bootloader from
40different sources including eMMC, SPI flash, and SD-card.
41
42On Rev 1.2 board to select boot from SD-card the DIP switches
43SW1 and SW2 should be configured as follows:
44
45SW2: 01110
46SW1: 1xxxx
47
48The upcoming Rev 1.3 board will have a single pins header J1 instead
49of the SW1/2 DIP switches. To boot from SD-card the setting of J1
50jumpers should match the DIP switches of Rev v1.2 board
51from left to right:
52
53J1: 011101xxxx
54
55Insert the micro SDcard in the MacchiatoBin board and power it up.
56The serial console is accessible at the micro-USB Type-B connector
57marked CON9. The serial line settings are 115200 8N1.
58
59U-Boot environment
60==================
61
62By default current configuration provides U-Boot that keeps environment
63in SD/eMMC. However, if needed, u-boot-fragment.config can be tweaked
64so that U-Boot will keep environment in SPI flash. On the first boot
65SPI flash may be empty or it may contain a stale environment that
66prevents proper boot. Then the following commands can be used
67to boot the board:
68
69=> ext4load mmc 1:1 0x01700000 /boot/uEnv-example.txt
70=> env import -t 0x01700000 $filesize
71=> boot
72
73The example environment from uEnv-example.txt can be written to
74SPI flash using the following commands:
75
76=> env default -f -a
77=> ext4load mmc 1:1 0x01700000 /boot/uEnv-example.txt
78=> env import -t 0x01700000 $filesize
79=> saveenv
80