This Quickstart provides you with the tools and know-how to install and work with the Linux Yocto Board Support Package (BSP) for the phyFLEX-i.MX6 platform. This Quickstart shows you how to do everything from installing the appropriate tools and source, to building custom kernels, to deploying the OS, to exercising the software and hardware.
Please refer to the phyFLEX-i.MX6 Hardware Manual for specific information on board-level features such as jumper configuration, memory mapping and pin layout for the phyFLEX-i.MX6 System on Module (SOM) and baseboard. Additionally, gain access to the SOM, mapper board, and baseboard schematics for the phyFLEX-i.MX6 by registering at the following: http://phytec.com/support/registration/.
The following system requirements are necessary to successfully complete this Quickstart. Deviations from these requirements may suffice, or may have other workarounds.
The following are supported:- Prime View PM070WL4 LVDS (LCD-017-070W)
- Ubuntu 12.04 LTS 64-bit recommended. Other distributions will likely work, please note that some setup information as well as OS-specific commands and paths may differ.- If using a virtual machine, VMWare Workstation, VMWare Player, and VirtualBox are all viable solutions.
- If you do not have SD card access under Linux then formatting, copying the bootloader, and mounting the root file system on an SD card will not be possible.
This section is designed to get the board up-and-running with pre-built images.
Use the following as a reference for the connector interfaces on the phyFLEX-i.MX6 that will be used in this Quickstart
The section was designed to show you how to boot the phyFLEX-i.MX6 with the pre-built demo images.
1. Insert a bootable SD card into the SD0 (X57) slot on the baseboard. Since the default boot mode for the PD14.1.0_EA1 release loads the kernel and root filesystem from SD card, a bootable SD card with zImage, zImage-imx6q-phytec-pbab01.dtb, and fsl-image-multimedia-imx6q-pbab01.tar.bz2extracted on the SD card is required. Instructions for creating an SD card are provided in the Creating a Bootable SD card section of the Quickstart.
2. If you ordered a PHYTEC Display such as the LCD-017-070W, plug this into the LCD power and data connectors at X65. Alternatively for a display option you can connect a DVI cable from a monitor to the connector X40 on the carrier board. Additional setup is required to use DVI as the main display, see Display Settings section of the Quickstart for additional instructions.
3. Connect the kit supplied serial cable from a free serial port on your host PC to the DB9 connector X51 on the carrier board. This is the UART0 communication channel with the i.MX6 at RS-232 levels.
4. Connect the kit supplied Ethernet cable from the Ethernet connector X28 on the carrier board to your network hub, router, or switch. If you do not have an Ethernet connection you can postpone this step, Linux will boot without the need for Ethernet connectivity but having the connection will significantly reduce your boot time.
5. Start your favorite terminal software (such as Minicom or TeraTerm) on your host PC and configure it for 115200 baud, 8 data bits, no parity, and 1 stop bit (8n1) with no handshake.
6. Plug the kit supplied 12 V power adapter into the power connector X12 on the carrier board. You will instantly see power LEDs VCC12IN, VCC12, VCC5_X, VCC5, and VCC3V3 on the carrier board as well as D1 on the SOM light up solid green. You will also start to see console output on your terminal window. If everything was done correctly the board should boot completely into Linux, arriving at a root@imx6q-pbab01 prompt. The default login account is root with an empty password. Note that the first time the board is booted it will takes a little while for the SSH server to generate new keys. Subsequent boots should be faster.
Not seeing any output on the console?
The following notes assume a Ubuntu 12.04 64-bit build machine.
Yocto development requires certain packages to be installed. Run the following commands to ensure you have the packages installed:
sudo apt-get install sed wget cvs subversion git-core coreutils \ unzip texi2html texinfo gcc-multilib libsdl1.2-dev docbook-utils gawk \ python-pysqlite2 diffstat help2man make gcc build-essential \ g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev \ mercurial autoconf automake groff libtool xterm curl
The above is the recommended package installation for phyFLEX-i.MX6 development on a Ubuntu 12.04 LTS Linux distribution. For a breakdown of the packages as well as a list of packages required for other Linux distributions, see the "Required Packages for the Host Development System" section in the Yocto Project Reference Manual: http://www.yoctoproject.org/docs/1.6/ref-manual/ref-manual.html#required-packages-for-the-host-development-system
Verify that the preferred shell for your Host PC is bash and not dash:
sudo dpkg-reconfigure dash # Respond "No" to the prompt asking "Install dash as /bin/sh?"
Download and install the repo tool. This tool is used to obtain Yocto source from Git.
cd /opt sudo mkdir bin # /opt/ directory has root permission, change the permissions so your user account can access this folder. In the following replace <user> with your specific username sudo chown –R <user>: bin cd bin curl http://commondatastorage.googleapis.com/git-repo-downloads/repo > ./repo #add directory that contains repo to your path chmod a+x repo
Add the repo directory in your PATH, using export from the command line or permanently by including it in .bashrc:
PATH=/opt/bin/:$PATH
The following steps describe the setup for TFTP, NFS, and Samba servers. Server setup is not required for working with the phyFLEX-i.MX6, however they will significantly reduce time and are highly recommended during the building and development phase.
TFTP is a "trivial" file transfer protocol used to transfer individual files across a network. Setting up a TFTP server on your Linux Host PC will allow you to exchange files with the target board. Some examples where this will be advantageous include:
Install the TFTP server on your Host PC:
sudo apt-get install tftpd-hpa
Specify a folder where the files will reside on your Host PC by replacing the folder path for TFTP_DIRECTORY with whatever folder you wish to use as your TFTP file storage location, or leave the folder as the default.
sudo gedit /etc/default/tftpd-hpa # /etc/default/tftpd-hpa TFTP_USERNAME="tftp" TFTP_DIRECTORY="/var/lib/tftpboot" TFTP_ADDRESS="0.0.0.0:69" TFTP_OPTIONS="--secure"
If you made any changes to the settings of the TFTP server, you need to restart it for them to take effect.
sudo restart tftpd-hpa
If you would like to grant every user on the system permission to place files in the TFTP directory, use the following command, replacing <TFTP_DIRECTORY> with your chosen location.
sudo chmod ugo+rwx <TFTP_DIRECTORY>
Files in the <TFTP_DIRECTORY> on your Host PC can now be accessed from another machine on the same network such as the target board by simply using the IP address of the Host PC. Take note of this IP address, in a typical wired connection this will be inet addr listed under eth0.
ifconfig
A network filesystem (NFS) server gives other systems the ability to mount a filesystem stored on the Host PC and exported over the network. Setting up an NFS server on your Linux Host PC gives you access to the target boards root filesystem which will allow you to quickly test applications and evaluate different filesystem setups for the target board. That is, the root filesystem for the phyFLEX-i.MX6 SOM will actually be located on the remote host Linux machine. This enables easy access and modifications to the root filesystem during development.
Install the NFS server on your Host PC:
sudo apt-get install nfs-kernel-server
Exported filesystems are designated in the "/etc/exports" file and allow you to choose both the directory to be exported and many settings for accessing the exports. Below is an example for exporting a folder called "nfs_export-ex" located in a user's home directory.
sudo gedit /etc/exports # /etc/exports /home/<user>/nfs_export-ex *(rw,sync,no_root_squash,no_subtree_check)
The options (rw, sync, no_root_squash, no_subtree_check) for this folder are essential in setting up the NFS export correctly. For more information on additional options, refer to the man page for 'exports'.
rw enables
read and write access when the directory is mounted
sync
tells the file-system to handle local access calls before remote access
no_root_squash
allows root access when mounting the file-system
no_subtree_check
reduces the number of checks the server must make to ensure that an exported sub-directory is within an exported tree and also enables access to root files in conjunction with no_root_squash
After modifying this file, in order to mount the directories as an NFS, you must force the NFS server to export all of the directories listed in "/etc/exports".
sudo /usr/sbin/exportfs -va
Samba servers are an excellent way to access a Linux file-system on a Windows machine via a network connection. Using a Samba server, it is quick and easy to transfer files between systems.
To install a Samba server, use the following command:
sudo apt-get install samba
Before the Samba share can be mounted on another machine it's necessary to modify the configuration file to allow write access and access to home directories. Start by editing the "/etc/samba/smb.conf" file.
sudo gedit /etc/samba/smb.conf
Inside this file there are four specific things that need to be uncommented (remove the ';' at the beginning of the line) to enable the sharing of home folders and write access. Below is the section that must be modified:
#======================= Share Definitions ======================= # Un-comment the following (and tweak the other settings below to suit) # to enable the default home directory shares. This will share each # user's home directory as \\server\username ;[homes] ; comment = Home Directories ; browseable = yes # By default, the home directories are exported read-only. Change the # next parameter to 'no' if you want to be able to write to them. ; read only = no
The outcomes after the changes are made follow:
#======================= Share Definitions ======================= # Un-comment the following (and tweak the other settings below to suit) # to enable the default home directory shares. This will share each # user's home directory as \\server\username [homes] comment = Home Directories browseable = yes # By default, the home directories are exported read-only. Change the # next parameter to 'no' if you want to be able to write to them. read only = no
It might also be necessary to change the workgroup line to match the workgroup for your machine.
To apply the changes, the next step is to restart all Samba-related processes.
sudo restart smbd sudo restart nmbd
Lastly, each user needs to have a password enabled to be able to use the Samba server. There are no rules for this password. The simplest method for choosing this password is to make it the same as the UNIX user's password, but it is not a requirement. After typing in the command below, you will be prompted to enter the password for the specified user.
sudo smbpasswd -a <user>
As mentioned in the configuration file, the samba share can be connected by accessing "\\<host machine ip>\\<user>" by either mounting a network share or using Windows explorer to navigate to it.
Create a directory which will house your BSP development. In this example the BSP directory is /opt/PHYTEC_BSPs/. This is not a requirement and if another location is preferred (ex. ~/PHYTEC_BSPs) feel free to modify. We recommend using /opt over your HOME directory to avoid errors attributed to ~ syntax as well as the sudo requirement for the root filesystem and automation package building. We also recommend creating a package download directory (yocto_dl) separate from the yocto tree (yocto_fsl), as it makes resetting the build environment easier and subsequent build times much faster.
sudo mkdir /opt/PHYTEC_BSPs cd /opt/ # /opt/ directory has root permission, change the permissions so your user account can access this folder. In the following replace <user> with your specific username sudo chown –R <user>: PHYTEC_BSPs cd PHYTEC_BSPs mkdir yocto_fsl mkdir yocto_dl cd yocto_fsl export YOCTO_DIR=`pwd`
At this point you will now be able to navigate to the Yocto directory using the $YOCTO_DIR environment variable.
cd $YOCTO_DIR repo init -u https://github.com/Freescale/fsl-community-bsp-platform -b daisy
<remote fetch="git://git.phytec.com/" name="phytec"/> <project remote="phytec" name="meta-phytec" path="sources/meta-phytec" revision="refs/tags/phyFLEX-i.MX6-PD14.1.0_ea1"/>
cd $YOCTO_DIR repo sync
BBLAYERS += " ${BSPDIR}/sources/meta-phytec "
cd $YOCTO_DIR MACHINE=imx6q-pbab01 source setup-environment build
BB_NUMBER_THREADS = '3' PARALLEL_MAKE = '-j 3' DL_DIR ?= "/opt/PHYTEC_BSPs/yocto_dl"
You can determine the number of processors available on your Linux machine with the following command:
grep "cpu cores" /proc/cpuinfo | wc -l
The setup is complete and you now have everything to complete a build. The following will start a build from scratch including installation of the toolchain as well as barebox, Linux, and root filesystem images.
cd $YOCTO_DIR/build MACHINE=imx6q-pbab01 bitbake --continue fsl-image-multimedia
If the package fetch fails, you will need to manually download the linuxptp IEEE 1588 stack to $DL_DIR (http://sourceforge.net/projects/linuxptp/files/). Once you've downloaded the archive (e.g. linuxptp-1.3.tgz), you will need to create a "done" file so fetch doesn't delete the file and try to refetch it:
cd yocto_dl touch linuxptp-1.3.tgz.doneAnother issue that may happen is ncurses5.9 won't be built in time for a different package in the build (says libpanelw.so is missing). Forcing the reinstall of the base ncurses package unsticks this: bitbake ncurses -f -c install.
All images generated by bitbake are deployed to $YOCTO_DIR/build/tmp/deploy/images/imx6q-pbab01:
The build time will vary depending on the package selection and Host performance. Beyond the initial build, after making modifications to the BSP, a full build is not required. Use the following as a reference to take advantage of optimized build options and reduce the build time.
To rebuild Barebox:
bitbake barebox -f -c compile ; bitbake barebox
To rebuild the Linux kernel:
bitbake linux-imx -f -c compile ; bitbake linux-imx
The process requires an SD card reader operational under Linux to format and access the Linux partition of the card. If you do not have SD card access under Linux then copying the bootloader and mounting the root filesystem on SD/MMC card will not be possible.
If using a SD/MMC card that has already been formatted skip to the appropriate steps below -- Step 5 if the Linux kernel is changing or Step 7 if the root filesystem is the only change and continue the steps from there.
1. Determine the SD card device name
ls /dev/sd*
2. Unmount all partitions of the SD card, using the SD card device name from Step 1:
umount /dev/sd[b|c|d|e]*
3. Make two partitions on the SD card using fdisk from the Linux kernel, specifying the SD card device name from Step 1:
sudo fdisk /dev/[b|c|d|e] Command (m for help): o Building a new DOS disklabel with disk identifier 0x2fe3ef94. Changes will remain in memory only, until you decide to write them. After that, of course, the previous content won't be recoverable.
Command (m for help): n
Partition type:
p primary (0 primary, 0 extended, 4 free)
e extended
Select (default p): p
Partition number (1-4, default 1): 1
First sector (2048-7626751, default 2048): 17432
Last sector, +sectors or +size{K,M,G} (17432-7626751, default 7626751): 1267432
Command (m for help): t
Partition number (1-4): 1
Hex code (type L to list codes): C
Changed system type of partition 1 to c (W95 FAT32 (LBA))
Command (m for help): n
Partition type:
p primary (1 primary, 0 extended, 3 free)
e extended
Select (default p): p
Partition number (1-4, default 2): 2
First sector (2048-7626751, default 2048): 1267433
Last sector, +sectors or +size{K,M,G} (1267433-7626751, default 7626751):
Using default value 7626751
Command (m for help): t
Partition number (1-4): 2
Hex code (type L to list codes): 83
Command (m for help): w The partition table has been altered! Calling ioctl() to re-read partition table. WARNING: If you have created or modified any DOS 6.x partitions, please see the fdisk manual page for additional information. Syncing disks.
sudo mkfs.vfat /dev/sd[b|c|d|e]1 -F 32 -n boot sudo mkfs.ext3 /dev/sd[b|c|d|e]2 -L rootfs
4. Mount all partitions
Kernel
5. If modifying the Linux kernel, remove the existing zImage and zImage-imx6q-phytec-pbab01.dtb files:
rm -rf /media/boot/*
6. Load the new Linux kernel and device tree binary to the SD Card:
cp zImage /media/boot; sync cp zImage-imx6q-phytec-pbab01.dtb /media/boot; sync
Root Filesystem
7. If modifying the root filesystem, remove the existing:
sudo rm -rf /media/rootfs/*
8. Load the new filesystem to the SD Card:
sudo tar -jxf fsl-image-multimedia-imx6q-pbab01.tar.bz2 -C /media/rootfs/; sync
9. Unmount each partition before copying the bootloader or removing the SD Card:
umount /media/boot /media/rootfs
Bootloader
10. Use the dd command to copy barebox-image to the SD Card:
dd if= barebox-imx6q-pbab01.imx of=/dev/sd[b|c|d|e] bs=512 skip=2 seek=2
11. Use the dd command to copy the barebox default environment to the SD Card:
dd if=barebox_default_env of=/dev/sd[b|c|d|e] bs=512 seek=4096
Additionally, if you plan on using the SD/MMC card to flash images, copy the files to the /boot partition. Since the /boot partition is FAT32 file copying can be handled using a Windows machine and a Linux machine is not required.
The default boot mode for the PD14.1.0_EA1 Yocto BSP is the following:
The bootloader, one of the key software components included in the BSP, completes the required hardware initializations to download and run operating system images. The boot mode, selected from the S3 dipswitch on the Carrier Board, determines the location of the primary bootloader. Set the S3 switches correspondingly:
SPI NOR (default)
S3-1 ONS3-2, S3-3, S3-4 OFF
SD Card
S3-1, S3-2 ONS3-3, S3-4 OFF
After application of power, approximately three seconds are allotted for the user to hit any key which will halt autoboot and enter Barebox.
help is a useful tool in Barebox to show available commands and usage.
Use the Barebox configuration files to modify environment variables, select boot settings, and setup networking parameters.
The following changes to the Barebox environment are required to work with the Yocto images:
edit env/init/general #Modify global.boot.default to use sd-ext3: global.boot.default=sd-ext3
edit env/boot/sd-ext3 #Modify the following lines global.bootm.image="/mnt/mmc/zImage" global.bootm.oftree="/mnt/mmc/zImage-imx6q-phytec-pbab01.dtb"
You can check the targets network settings by running the following:
devinfo eth0
The ethaddr variable is the MAC id of the target. This is a pre-programmed value which is read from the EEPROM and matches the sticker on the SOM. To modify any of the network settings, type:
edit /env/network/eth0
You should see something similar to the following, modify the variables to specify your network configuration for ETH0:
ipaddr=###.###.###.### netmask=###.###.###.### gateway=###.###.###.### serverip=###.###.###.###
A dedicated IP address for the SOM. This is crucial if TFTP will be used for updating the device's images at any point.
Netmask for the network: typically 255.255.255.0. This is only necessary if the TFTP directory is located on another network.
Gateway IP for the network. This is only necessary if the TFTP directory is located on another network.
IP address of the host or another machine. serverip corresponds to where the TFTP directory, if it exists, is located.
Display either via LCD or DVI/HDMI is supported in the Barebox display script.
edit /env/video/display
The primary display output (/dev/fb0) is selected by prim_out. To use the PHYTEC display connector as your primary output, set prim_out to lbd. Additionally, in the "Displays" section, be sure to uncomment the LCD selected out of the five supported and place a '#' at the beginning of the line for the remaining to comment them out. For example, the file should resemble the following if the 7" Primeview display with resistive touch and adapter board, Primeview-PM070WL4 (LCD-017-070W) screen is to be used on the target device:
# Set prim out put (hdmi/ldb) prim_out=ldb #Displays #display=Primeview-PD050VL1 #display=Primeview-PD035VL1 #display=Primeview-PD104SLF display=Primeview-PM070WL4 #display=ETM0700G0DH6
To use HDMI/DVI as your primary output, set prim_out to hdmi.
# Set prim out put (hdmi/ldb) prim_out=hdmi
Additionally, to set the HDMI resolution edit the display bootargs:
edit env/display/bootargs-display
Replace the HDMI specific line global.linux.bootargs.dyn.display="video=mxcfb1:$display prim_hdmi=yes" with the following replacing <xres>x<yres>@<frequency> with your custom resolution. For example, global.linux.bootargs.dyn.display="video=mxcfb0:1600x900M@60 video=mxcfb1:$display fbmem=25M,5M prim_hdmi=yes" successfully worked to display on a 16:10 monitor at a resolution of 1680x1050 (VESA resolution).
global.linux.bootargs.dyn.display="video=mxcfb0:<xres>x<yres>@<frequency> video=mxcfb1:$display fbmem=25M,5M prim_hdmi=yes"
From any of the Barebox scripts, return to the Barebox prompt by pressing CTL+D to apply changes or CTL+C to cancel. To retain changes, at the Barebox prompt save the environment.
saveenv
The target can be booted from on-board media or from a development host via network. In our standard configuration, the PD14.1.0_EA1 BSP release loads the kernel and root filesystem from SD card. This process requires a properly formatted SD card which can be prepared using the instructions in the Creating a Bootable SD card section of the Quickstart.
The other method is to provide needed components via network. In this case the development host is connected to the phyFLEX-i.MX6 with a serial cable and via Ethernet; the embedded board boots into the bootloader, then issues a TFTP request on the network and boots the kernel from the TFTP server on the host. Then, after decompressing the kernel into RAM and starting it, the kernel mounts its root filesystem via the NFS server on the host. This method is especially useful for development purposes as it provides a quick turnaround while testing the kernel and root filesystem.
Stand-Alone NAND Boot
To use the target stand-alone, the kernel and root filesystem have to be made persistent in the on-board media of the phyFLEX-i.MX6. Due to UBIFS format issues, the root filesystem can not be flashed to NAND and the feature is currently not supported in the PD14.1.0_EA1 Yocto BSP. This support is expected to be added in the next BSP release.
Remote Boot
The network-remote boot variant is intended to be used during development because of the frequent need to rebuild the Linux kernel and root filesystem. Reflashing the newest kernel and root file system to the SOM after every new build would be very cumbersome and time consuming, by using TFTP and NFS you can accelerate the development process. All that is needed is an Ethernet connection and a network aware bootloader which can fetch the kernel from a TFTP server.
Restart the board and stop autoboot by pressing m. You'll get a menu:
Welcome to Barebox
1: Boot: Kernel:nand;rootfs:nand
2: Boot: network (Kernel:tftp;rootf:nfs)
3: Boot: MMC (ext3)
4: Settings
5: Shell
6: Reset
From this menu you can select the interface in which to boot from. Press 2 and then the enter key.
The net boot entry can also be run from the Barebox shell:
boot net
Stand-Alone SD/MMC card Boot
The SD/MMC card boot variant is an alternative stand-alone boot option. All that is needed is a properly formatted (see the Creating a Bootable SD card section of the Quickstart) SD/MMC card
Restart the board and stop autoboot by pressing m. You'll get a menu:
Welcome to Barebox
1: Boot: Kernel:nand;rootfs:nand
2: Boot: network (Kernel:tftp;rootf:nfs)
3: Boot: MMC (ext3)
4: Settings
5: Shell
6: Reset
From this menu you can select the interface in which to boot from. Press 3 and then the enter key.
The SD/MMC card boot entry can also be run from the Barebox shell:
boot sd-ext3
Custom Boot
You may have custom boot requirements that are not covered by the three available boot files (nand, net, sd-ext3). If this is the case you can create your own custom boot entry specifying the kernel and root filesystem location.
edit /env/boot/custom
#!/bin/sh
if [ "$1" = menu ]; then
boot-menu-add-entry "$0" "Kernel:<kernel_loc>;rootfs:<rootfs_loc>"
exit
fi
global.bootm.image="<kernel_loc_bootm.image>"
#global.bootm.oftree="/env/oftree"
global.bootm.oftree="none"
<div style="color:red"><nfs_root_path></div>
bootargs-ip
bootargs-cam
bootargs-display
global.linux.bootargs.dyn.root="<rootfs_loc_dyn.root>"
Specifies the location of the Linux kernel to be printed in the Barebox menu. Replace this with one of the following:nand - To boot the Linux kernel from NANDtftp - To boot the Linux kernel via TFTPext3 - To boot the Linux kernel from the SD/MMC card
Specifies the location of the root filesystem to be printed in the Barebox menu. Replace this with one of the following:nand - To mount the root filesystem from NAND Flashtftp - To mount the root filesystem via NFSext3 - To mount the root filesystem from the SD/MCC card
Specifies the location of the Linux kernel image/dev/nand0.kernel.bb - To boot the Linux kernel from NAND${path}/linuximage - To boot the Linux kernel via TFTP/mnt/mmc/linuximage - To boot the Linux kernel from SD/MMC card
Specifies the location of the root filesystemroot=ubi0:root ubi.mtd=5 rootfstype=ubifs - To mount the root filesystem from NANDroot=/dev/nfs nfsroot=$nfsroot,v3,tcp - To mount the root filesystem via NFSroot=/dev/mmcblk0p2 rootfstype=ext3 rootwait - To mount the root filesystem from SD/MMC card
Only required if mounting the root filesystem from NFS. Replace with the following:nfsroot="/home/${global.user}/nfsroot/${global.hostname}"
Once complete with file modifications exit the editor using CTRL+D. Save the environment:
saveenv
Restart the board and stop autoboot by pressing m. You'll see the original menu but with an additional boot entry. The following example shows an added boot entry that boots the kernel from TFTP and mounts the root filesystem from NAND Flash.
Welcome to Barebox
1: Boot: Kernel:nand;rootfs:nand
2: Boot: Kernel:tftp;rootfs:nand
3: Boot: network (Kernel:tftp;rootf:nfs)
4: Boot: MMC (ext3)
5: Settings
6: Shell
7: Reset
To run your custom boot entry, press the corresponding number and then the enter key. In the example above, to boot the kernel from TFTP and mount the root filesystem from NAND Flash press 3 and then the enter key.
The custom boot entry can also be run from the Barebox shell:
boot custom
Default Boot
The phyFLEX-i.MX6 is configured by default to boot the kernel and mount the root filesystem from flash. This default setting can be changed by modifying the global.boot.default environment variable.
edit /env/config
Find the boot entries section, uncomment the global.boot.default variable and set to the desired boot source. This variable can be set to any of the entries in /env/boot. For example to set the default boot configuration to net, global.boot.default should be set in the following way:
global.boot.default=net
Exit the editor by CTRL+D and save the environment (saveenv). On a reset or power cycle the new default boot source will take affect. Similarly it will be used in the Barebox shell when executing the following:
boot
The phyFLEX-i.MX6 Rapid Development Kit is delivered with a pre-flashed bootloader. The following instructions for flashing images from TFTP or SD card will be useful if you want to:
The images to be flashed will need to be copied to the exported TFTP directory or the /boot partition of a properly formatted SD card as described in the Creating a Bootable SD card section of the Quickstart.
After making all required connections, power on the board and enter Barebox:
If flashing from TFTP, additional setup to configure the Barebox environment variables to meet your network environment and development host settings is required. The current network settings can be checked by executing the following:
devinfo
If you need to change you network configuration, type:
edit /env/network/eth0
Edit the settings as described in the Network Configuration section of the Quickstart. Save the environment and reboot the board, this will automount your tftp server at boot to /mnt/tftp.
If you would like to upgrade, have custom Barebox requirements, or are interested in seeing the version you built in action, follow the steps below:
It should be copied to your TFTP exported directory or the /boot partition of the SD card depending on your chosen flashing procedure.
Be sure that the barebox-imx6q-pbab01.imx file has the correct RAM size for your version of the phyFLEX-i.MX6 SOM. This is configured as part of the build settings.
Method: TFTP
cp /mnt/tftp/barebox-imx6q-pbab01.imx .
Method: SD/MMC
cp /mnt/mmc/barebox-imx6q-pbab01.imx .
erase /dev/m25p0.barebox cp barebox-imx6q-pbab01.imx /dev/m25p0.barebox
If something goes wrong and you don’t have a bootloader anymore on your module you need to boot from an SD card into Barebox (set DIP-switch S3 to ON-ON-OFF-OFF) and then do the flashing. See the Creating a Bootable SD card section of the Quickstart section of this Quickstart for a description of how to create a bootable SD card.