The cirros image was rebuilt against the 3.13.0-83 kernel, drivers e1000e, igbvf...
[packages/trusty/cirros-testvm.git] / cirros-testvm / src-cirros / buildroot-2015.05 / board / freescale / imx31_3stack / readme.txt
1 **************************************
2 Freescale i.MX31 PDK development board
3 **************************************
4
5 This file documents the Buildroot support for the Freescale i.MX31 PDK in "3
6 stack" configuration.
7
8 The i.MX31 Product Development Kit (or PDK) is Freescale development board [1]
9 based on the i.MX31 application processor [2].
10
11 For more details on the i.MX31 PDK board, refer to the User's Guide [3].
12
13 Build
14 =====
15
16 First, configure Buildroot for your i.MX31 PDK board:
17
18   make freescale_imx31_3stack_defconfig
19
20 Build all components:
21
22   make
23
24 You will find in ./output/images/ the following files:
25   - rootfs.cpio
26   - rootfs.cpio.gz
27   - rootfs.tar
28   - zImage
29
30 The generated zImage does include the rootfs.
31
32 Boot the PDK board
33 ==================
34
35 The i.MX31 PDK contains a RedBoot bootloader in flash, which can be used to
36 boot the newly created Buildroot images from the network.
37
38 This necessitates to setup a TFTP server first. This setup is explained for
39 example in Freescale i.MX31 PDK 1.5 Linux User's Guide [4].
40
41 Here is a sample RedBoot configuration, for proper network boot of Buildroot on
42 the i.MX31 PDK:
43
44     RedBoot> fconfig -l
45     Run script at boot: true
46     Boot script:
47     .. load -r -b 0x100000 zImage
48     .. exec -c "console=ttymxc0,115200"
49
50     Boot script timeout (1000ms resolution): 2
51     Use BOOTP for network configuration: false
52     Gateway IP address: <your gateway IP address>
53     Local IP address: <your PDK IP address>
54     Local IP address mask: 255.255.255.0
55     Default server IP address: <your TFTP server IP address>
56     Board specifics: 0
57     Console baud rate: 115200
58     Set eth0 network hardware address [MAC]: false
59     GDB connection port: 9000
60     Force console for special debug messages: false
61     Network debug at boot time: false
62
63 Adapt those settings to your network configuration by replacing the appropriate
64 network addresses where necessary.
65
66 You might want to verify that your i.MX31 PDK switches settings are the correct
67 ones for UART, power, boot mode, etc. Here is a reference switches
68 configuration:
69
70     SW4
71     1   2   3   4   5   6   7  8
72     ON off off off off off off ON
73
74     SW5 SW6 SW7 SW8 SW9 SW10
75      0   1   0   0   0    0
76
77 See the i.MX31 PDK Linux Quick Start Guide [5] for more details on the switches
78 settings.
79
80 Connect a serial terminal set to 115200n8 and power on the i.MX31 PDK board.
81 Buildroot will present a login prompt on the serial port.
82
83 Enjoy!
84
85 References
86 ==========
87
88 [1] http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=i.MX31PDK
89 [2] http://www.freescale.com/webapp/sps/site/prod_summary.jsp?code=i.MX31
90 [3] http://cache.freescale.com/files/32bit/doc/user_guide/pdk15_imx31_Hardware_UG.pdf
91 [4] http://cache.freescale.com/files/32bit/doc/support_info/IMX31_PDK15_LINUXDOCS_BUNDLE.zip, pdk15_imx31__Linux_UG.pdf
92 [5] http://www.freescale.com/files/32bit/doc/quick_ref_guide/PDK14LINUXQUICKSTART.pdf