btrfs-progs: bump version to 4.9
[buildroot-gz.git] / board / warp7 / readme.txt
blob47458e9b567bfdb3f4d2152eeb988b01b72a3804
1 *****************
2 Warp i.MX7S board
3 *****************
5 This file documents the Buildroot support for the Warp i.MX7S board.
7 Build
8 =====
10 First, configure Buildroot for the Warp i.MX7S board:
12   make warp7_defconfig
14 Build all components:
16   make
18 You will find in output/images/ the following files:
19   - imx7s-warp.dtb
20   - rootfs.ext4
21   - rootfs.tar
22   - sdcard.img
23   - u-boot.imx
24   - zImage
26 Flash the eMMC image
27 ====================
29 In the U-Boot prompt lauch:
31 => ums 0 mmc 0
33 This will mount the eMMC content in the host PC as a mass storage device.
35 To determine the device associated to the eMMC have a look in the
36 /proc/partitions file:
38   cat /proc/partitions
40 Buildroot prepares a bootable "sdcard.img" image in the output/images/
41 directory, ready to be dumped into the eMMC. Launch the following
42 command:
44 sudo dd if=output/images/sdcard.img of=/dev/<your-emmc-device>
46 *** WARNING! This will destroy all the eMMC content. Use it with care! ***
48 For details about the medium image layout, see the definition in
49 board/warp7/genimage.cfg.
51 How to recover from a bad eMMC image
52 ====================================
54 In case a bad U-Boot has been flashed to the eMMC and the board no
55 longer boots, it is possible to recover using the imx_usb_loader utility.
57 Put the warp7 board in USB download mode by removing the CPU board
58 from the base board then putting switch 2 in the upper position.
60 Connect a USB to serial adapter between the host PC and warp7 serial
61 USB port, and also a USB cable between the OTG warp7 port and the host
62 PC.
64 Copy u-boot.imx to the imx_usb_loader folder.
66 Load u-boot.imx via USB:
68 $ sudo ./imx_usb u-boot.imx
70 Then U-Boot should start and its messages will appear in the console program.
72 Open a terminal program such as minicom.
74 Use the default environment variables:
76 => env default -f -a
77 => saveenv
78 => ums 0 mmc 0
80 sudo dd if=output/images/sdcard.img of=/dev/<your-emmc-device>
82 Put warp7 back in eMMC boot mode by placing switch 2 in the lower position
83 and reboot the board.
85 Boot the Warp i.MX7S board
86 ==========================
88 To boot your newly created system:
89 - put a micro USB cable into the Debug USB Port and connect using a terminal
90   emulator at 115200 bps, 8n1;
91 - power on the board.
93 Using Wifi
94 ==========
96 # modprobe brcmfmac
97 # iwconfig wlan0 essid ACCESSPOINTNAME
98 # wpa_passphrase ACCESSPOINTNAME > /etc/wpa.conf
99 (enter the wifi password and press enter)
100 # wpa_supplicant -Dwext -iwlan0 -c /etc/wpa.conf &
101 # udhcpc -i wlan0
102 # ping buildroot.org
104 Enjoy!