...

...

• 
  

  Hide If
  special @anonymous
  Status colour Yellow title MOVED .BSP Development Guide vPD18.1.0

  
  

This Quickstart provides you with the tools and know-how to install and work with the Linux Board Support Package (BSP) for the phyBOARD-Zeta. This Quickstart shows you how to do everything from installing the appropriate tools and source, to building custom kernels, to deploying the OS, to and exercising the software and hardware. Additionally, gain access to the SOM and baseboard schematics for the phyBOARD-Zeta by registering at the following: http://phytec.com/support/registration/. 

...

• phyCORE-i.MX7 SOM
• phyBOARD-Zeta i.MX7 carrier board
• 2x 2x5 pin header to DB9 male connector
• Evaluation board PEB-EVAL-02 (optional)
• LCD Display Adapter with 7" capacitive display PEB-AV-02-TC (optional)
• WiFi/BT module PEB-WLBT-03 (optional)
• Null-Modem RS232 DB9 cable (female to female)
• AC adapter with 2-pin phoenix connector supplying 5V DC, min. 2.5A
• microSD Card for flashing and booting

...

Use the following images as a reference when connecting any compatible PHYTEC expansion boards.Image Removed

Image AddedImage Added

UART and CAN connectors

Use the following images as a reference when connecting UART and CAN 2x5 pin header to DB9 adapters

Image RemovedImage Added

Anchor
GettingStartedWithBinaryImages GettingStartedWithBinaryImages

Getting Started With Binary Images

...

Booting the Pre-Built Images

1. Download the "fsl-image-validation-imx-<Yocto Machine>.sdcard" image which will be used to format a bootable SD card. The binary images for BSP-Yocto-FSL-iMX7-PD18.1.x are available on PHYTEC's Artifactory, and images are organized by machine name.

2. Flash the SD card image to a micro SD card:

   Code Block
   sudo dd if=fsl-image-validation-imx-<Yocto Machine>.sdcard of=/dev/sd<SD partition> bs=1M && sync

   
   

   Note
   For more information on formatting an SD card, see Creating a Bootable SD Card.

   
   

3. If using the evaluation module PEB-EVAL-02, plug it into the expansion connector X16 on the carrier board.

4. If using the WiFi/BT module PEB-WLBT-03, plug it into the expansion connector header.
5. If using the LCD Display, connect the module PEB-AV-02-TC to the AV connectors X3 and X4.

6. Plug micro SD card into slot on underside of board.

7. Connect UART cable to the 5x2 pin header labelled "RS-232". This header requires an adapter as well as Null modem cable. When plugged in, the adapter cable should be oriented towards the USB and ethernet interfaces.

8. 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

9. Connect 5V power supply to the 2-pin phoenix connector. Looking into the connector, the pin on the left is positive and the one next to it is negative.

10. Press the "PWR" button (this may not be necessary if the battery has completely discharged). You will now start to see console output on your terminal window. If everything was done correctly the board should boot completely into Linux, arriving at a login prompt:
    

    NXP i.MX Release Distro 4.9.11-1.0.0 <Yocto Machine> ttymxc4

    <Yocto Machine> login: root

    
    

    
    

11. The default login account is root with an empty password.

...

cd $YOCTO_DIR 
repo init -u https://stash.phytec.com/scm/pub/manifests-phytec.git -b imx7 -m BSP-Yocto-FSL-iMX7-PD18.1.01.xml

Download the Yocto meta layers specified in the manifest file:

repo sync

Start the Build

...

Run the Yocto build directory setup. The TEMPLATECONF variable is used to set the source of the local configuration files (conf/bblayers.conf and conf/local.conf), which are located in the meta-phytec layer:

Code Block
cd $YOCTO_DIR TEMPLATECONF=$YOCTO_DIR/sources/meta-phytec/meta-phytec-fsl/conf source sources/poky/oe-init-build-env build

...

Warning
title If working with a non-kit SOM, please expand the content below for additional instructions.
Expand Non-Standard Kit SOM machine configurations are included in the Yocto layer meta-phytec-extra. To include this meta layer in the build, add it to the build/conf/bblayers.conf file: Code Block ${BSPDIR}/sources/meta-phytec/meta-phytec-fsl \ + ${BSPDIR}/sources/meta-phytec-extra \ " Not sure whether your SOM is part of a standard kit? See Release Notes Yocto Machine Config table for kit part numbers.

...

The following will start a build from scratch including installation of the toolchain as well as the bootloader, Linux kernel, and root filesystem images.

Warning
See Release Notes for supported Yocto machine configurations, and replace <Yocto Machine> below with the appropriate machine for your hardware.

Code Block
cd $YOCTO_DIR/build MACHINE=<Yocto Machine> bitbake fsl-image-validation-imx

...

Note that v4.9.11-phy<X> and v2017.03-phy<X> within the paths pertain to the release tag for the linux and u-boot sources. This matches the value of RELEASE_VER for the corresponding recipes in meta-phytec-fsl. For example, for release PD18.1.0 1 the kernel tag is v4.19.1511-phy4phy1.

• Kernel :    $YOCTO_DIR/build/tmp/work/<Yocto Machine>-poky-linux-gnueabi/linux-phytec-fsl/4.9.11+git_v4.9.11-phy<X>-r0/git/  
  • The device tree file to modify within the linux kernel source is: arch/arm/boot/dts/<Yocto Machine>.dts and its dependencies

• U-Boot: $YOCTO_DIR/build/tmp/work//<Yocto Machine>-poky-linux-gnueabi/u-boot-phytec/2017.03+git_v2017.03-phy<X>-r0/ git/ 

  • Board file is located at: board/phytec/mx7d_phyboard_zeta/mx7d_phyboard_zeta.c

• Toolchain:   $YOCTO_DIR/build/tmp/sysroots/x86_64-linux/usr/bin/arm-poky-linux-gnueabi/arm-poky-linux-gnueabi-

...

To rebuild u-boot:

Code Block
MACHINE=<Yocto Machine> bitbake u-boot-phytec -f -c compile && bitbake u-boot-phytec

To rebuild the Linux kernel:

Code Block
MACHINE=<Yocto Machine> bitbake linux-phytec-fsl -f -c compile && bitbake linux-phytec-fsl

...